GPR

This program provides a graphical front-end to the libppd library, enabling
users to configure printer-specific options for a particular job based upon
a printer's PPD file.

This program is a work in progress. As such, there are many features that
have not been implemented or are in much need of refinement.

PROGRAM USE 

To run gpr, simply type 'gpr' at the command-line. The file to print can
also be specified at the command-line as in 'gpr myfile.ps'.

When gpr is started, a GUI is presented to the user. If a file has not been
specified on the command line, the user must choose the file to print from
the file browser. The destination printer must then be selected from the
menu (assuming that printers have been properly configured and are listed in
the /etc/printcap file). 

Upon selecting a printer, gpr checks to see is a default PPD file is
specified in the 'postscript.cfg' file in the printer's spool directory. If
not, the user must select a PPD file with the file browser. In either case,
the user must then initialize the PPD file from within gpr.

After PPD initialization, the user may set up any installable options
through the "Printer Configuration" option. Job specific options are
selected from the "Common Options" and "Advanced Options" tabs. Once all
options are specified, the job may be sent by pressing the "Print" button.

Users may also save frequently used groups of settings (up to 20 in all) by
setting all applicable options, typing a name in the 'Save Settings' entry
box, and pressing the 'Save Settings' button. To retrieve old settings, 
select the previously saved settings by name from the pull-down menu in the
'Saved Settings' section of the 'Main' tab. (Note that the name of the chosen
saved settings group does not remain in the pull-down menu.)


GENERAL NOTES

- PPD files must end with a lower-case ".ppd" extension rather than an
upper-case ".PPD" extension.

- When running gpr from the command-line, users may wish to pipe the input 
file through a2ps. Simply typing 'a2ps filename' will automatically pipe the
output to lpr. If the lpr wrapper script is installed, users will not need to
explicitly pipe the output to gpr.


APPLICATION NOTES

Netscape 4.x:
In order to print from Netscape, simply enter 'gpr' as the "Print Command" in
the Netscape print dialog. If the "lpr_wrapper" script is employed, the 'lpr'
command will work as well.

Adobe Acrobat 4.0:
To print from Acrobat, enter 'gpr' as the print command. Even if the 
"lpr-wrapper" script is installed, you must still use 'gpr' instead of 'lpr'.

Applixware 4.4.2:
In order to print from Applix, you must first change the default printer preferences. To do so, follow these steps:

1. Under the '*' menu on any Applix window, choose 'Applixware Preferences..."
2. Select 'Printing'
3. Under 'Select a Preference and Set Its Value in the Box below', scroll-down
   and select 'Set the Print Shell Command'
4. In the entry box labeled 'Value', type 'gpr -P'
5. Press 'Apply'

To print a document simply click the print icon or select 'Print...' from the
file menu.

WordPerfect 8.0:
In order to print from WordPerfect via gpr, you must use the wrapper script.
Some configuration is also required. Follow the steps below:

1. From the 'File' menu choose 'Print'
2. Under 'Current Printer' click the 'Select' button
3. Click the 'Printer Create/Edit' button to create a new printer
4. Click 'Add' to install a new driver
5. Select a driver from the list of 'Available Printer Drivers'. If your
   printer is not in the list, select the 'Passthru PostScript' driver.
   If you are unable to print through gpr with this driver, try one of the
   other PostScript drivers in the list. A good place to start is with one
   of the PostScript drivers for one of HP's printers such as the 'HP LaserJet
   4Si PostScript' or 'HP LaserJet 5Si PostScript'. CLick the 'OK' button.
6. Click the 'Setup' button on 'Printer Create/Edit' dialog
7. Click the 'Destination' button from the 'Printer Setup' dialog.
8. Choose the appropriate destination printer from the list and click 'OK'.
9. Click 'OK' on all screens until you return to the main 'Print' dialog.
10.Click 'OK' to send the print file to gpr.

Note that you will need to repeat the process for every destination printer
you wish to setup.

StarOffice 5.1:
In order to print from StarOffice via gpr, you must use the wrapper script.
A minimal amount of configuration is also required. Follow the steps below:

1. Run 'SP Admin'
2. Check to see if there is a 'Generic Printer' on the default queue, which 
   should be 'lpr'
3. If no printer is installed, choose 'Generic Printer' from the list of
   'Existing Printer Drivers' and click the 'Add new printer' button. 
   Alternatively, if your printer is included in the list of drivers, you may
   choose this driver.
4. Select your printer in the list of 'Installed Printers' and click the 
   'Connect' button. Verify that the default queue is set to 'lpr'. If not,
   change the queue to 'lpr'.
5. You may now print from any StarOffice application by choosing the 'Print'
   command. There is no need to set any of the printer options from the 
   StarOffice print dialog as you will have a chance to set all printer-
   specific features from gpr.



