(c) 1998 - 2000  M. Kroeker     HP2XX release 3.3.2                 00/02/12
(c) 1992 - 1994  H. Werntges    HP2XX release 3.2.x                 94/02/14
                                ===================

Files in ./sources:
-----------------------

README       This file

makefile     This should normally be a copy of (or symbolic link to)
	     the appropriate Makefile for your platform from ../makes, 
	     or an appropriately edited copy of ../makes/generic.mak
	     As distributed, it is what i use myself on Linux.
bresnham.c   Implementation of Bresenham algorithm (for line rasterization)
murphy.c     Implementation of Alan Murphys (IBM) thick line algorithm 
chardraw.c   Code for drawing ASCII characters
getopt.c     from GNU getopt, slightly modified -- don't re-distribute!
getopt1.c    from GNU getopt -- don't re-distribute, use original!
hp2xx.c      High-level routines for hp2xx
hpgl.c       HP-GL parser etc.
no_prev.c    A dummy previewer
picbuf.c     Code for raster ops (vector-to-internal-bitmap)
std_main.c   Traditional command line interface including "main()"
clip.c       Auxiliary routines for clipping (IW command)
pendef.c     Pen colour / width routines
to_amiga.c   AMIGA previewer
to_atari.c   ATARI previewer
to_dj_gr.c   DOS full-screen (S)VGA previewer, based on DJ Delorie's gr lib
to_emf.c     Previewer, printout and EMF converter for MS Windows
to_eps.c     Output converter for EPS (Encapsulated PostScript)
to_escp2.c   Output converter for Epson ESC/P2 format as used in the Stylus
to_ilbm.c    AMIGA only: IFF-InterLeave BitMap converter
to_img.c     Output converter for IMF (DR's Image format)
to_vec.c     Output converter for several vector formats (Metafont,DXF,SVG...)
to_os2.c     OS/2 full-screen previewer (only b/w); uses to_vga.c in DOS mode
to_pac.c     Output converter for ATARI PAC format (unsupported)
to_pbm.c     Output converter for PBM (Portable BitMap) format
to_pcl.c     Output converter for HP PCL Level 3 (and some Deskjet extras)
to_pcx.c     Output converter for Paintbrush PCX format 
to_pdf.c     Output converter for Portable Document format (requires libpdf)
to_pic.c     Output converter for ATARI PIC format (unsupported)
to_pm.c      OS/2 PM previewer 
to_rgip.c    Output converter for Uniplex RGIP vector format
to_sunvw.c   SunView previewer (unsupported -- outdated)
to_uis.c     VAX-VMS UIS previewer
to_vga.c     DOS full-screen VGA previewer
to_x11.c     X11 previewer
to_png.c     Output converter for PNG format (requires libpng and libz)
png.c	     Support functions for to_png.c
to_fig.c     Output converter for FIG (XFig) format
to_tif.c     Output converter for TIFF format (requires libtiff)

bresnham.h   Contains a basic struct -- needed by almost all C sources
murphy.h     Function declarations for thick line algorithm
chardraw.h   Header for character drawing.
charset0.h   Definition of built-in font 0 , ANSI ASCII 
charset1.h   Definition of built-in font 1 , 9825 character set
charset2.h   Definition of built-in font 2 , French/German 
charset3.h   Definition of built-in font 3 , Scandinavian 
charset4.h   Definition of built-in font 4 , Spanish/Latin American 
charset5.h   Definition of built-in font 5 , Special Symbols 
charset6.h   Definition of built-in font 6 , JIS ASCII
charset7.h   Definition of built-in font 7 , HP-Roman Extensions
font173.h    Definition of built-in PS Math font
font205.h    Definition of built-in Ventura Math font
getopt.h     from GNU getopt -- don't re-distribute, use original!
hp2xx.h      Central to almost all C sources
pendef.h     Function declarations and typedefs for pen
iff.h        AMIGA only: for IFF-InterLeave BitMap converter
ilbm.h       AMIGA only: for IFF-InterLeave BitMap converter
x11.h        Some X11 extras
clip.h       Some declarations for clip.c



NOTE about unsupported formats (HWW - these are even less supported now, MK):
------------------------------

  o  to_dj_gr.c  works fine on 386 and 486 CPUs, but I'd rather replace it
                 by code both applicable to DOS and OS/2, and that will be
                 emx.

  o  to_pic.c    The PIC format was mainly used by ATARI programs like
                 Signum. I consider it outdated. Try to work with IMG.

  o  to_pac.c    Similar to PIC (compressed version of PIC), used e. g.
                 by STaD.



For installation, get a suitable makefile from ../makes and follow
intructions in ../makes/README.

For details of operation, see ../doc/hp2xxinf.tex (hp2xx.texinfo).

Optionally test hp2xx with HP-GL files provided in ../hp-tests.
E. g., run

            % hp2xx -h100 -w100 ../hp-tests/ascii.hp

(This should result in a graphical display of the available
 character set 0.)


Enjoy!