
		       How to install Genscript


1. Configure genscript to your system.  Genscript uses GNU's autoconf
   package to figure out some system (unix) dependant features, so 
   configuration is fully automated: run `configure' command in the
   top level directory of genscript.

   You can specify different installation prefixes during
   installation, the default prefix is `/usr/local'.  For example:
   install genscript to your private tmp directory: 

	$ ./configure --prefix=$HOME/tmp

   Now genscript gets installed to directory `$HOME/tmp/bin/'. 

2. Compile genscript.  This should be easy, just say `make' in the top
   level directory.  

   Genscript's makefiles use the VPATH feature that is found from the
   modern make utilities (like GNU make).  If your make do not support
   VPATH, then you must copy all c-files from the compat-directory to
   the top level directory: `cp compat/*.c .'. 

3. Install genscript.  Also easy, say `make install' in the top level
   directory.  This command installs genscript, mkafmmap, man pages,
   AFM files and library files to your system.  You can also install
   genscript in parts; Makefile contains following install targets:
	
	install		install everything
	install.bin	install executables genscript and mkafmmap
	install.man	install manual pages
	install.afm	install AFM files

   Note! you are not able to use genscript before it is installed.  If
   you want to test genscript privately before the "real"
   installation, you must install genscript to a private directory.
   The easies way to do this is to specify an appropriate installation
   prefix during the configuration step.

4. Check out the global configuration file `genscript.cfg' from the
   directory <prefix>/lib/genscript.  You might want to change
   following things:

     - paper size  

       As a default genscript uses A4 paper.  To change default paper
       to be for example `Letter', edit following line in the config
       file: 

         # Default output media.
	 DefaultMedia: A4

	 => DefaultMedia: Letter

     - default output device

       As a default (without any explicit options) genscript spools
       its output to the printer command.  If you want to send outputs
       to stdout, edit following line:

	 # Where output goes as a default.
	 DefaultOutputMethod: printer

	 => DefaultOutputMethod: stdout

     - printer command 

       Genscript's default printer command is `lpr'.  To change it to 
       be for example `lp', edit following line:

	 # Printer spooler command name.
	 Spooler: lpr

	 => Spooler: lp

       On SystemV machines, you might also want to change printer
       queue name switch from `-P' to something else:
        
	 # The spooler command switch to select the printer queue.
	 QueueParam: -P

	 => QueueParam: -d

5. Print.
