| 1 | CUPSWIZ - CUPS printer-creation wizard
|
|---|
| 2 | Version 0.95
|
|---|
| 3 |
|
|---|
| 4 |
|
|---|
| 5 | REQUIREMENTS
|
|---|
| 6 |
|
|---|
| 7 | CUPS (that is, a full, functioning CUPS server) must be installed and
|
|---|
| 8 | running, either on the same computer or a remote server on your network.
|
|---|
| 9 |
|
|---|
| 10 | At least one of the following CUPS-compatible OS/2 printer presentation
|
|---|
| 11 | ("PrinterPak") drivers must be installed:
|
|---|
| 12 | - ECUPS.DRV (eCups driver for Gutenprint and other filter packages)
|
|---|
| 13 | - ECUPS-HP.DRV (eCups driver for HPLIP)
|
|---|
| 14 | - PSPRINT.DRV (Enhanced OS/2 Postscript driver replacement)
|
|---|
| 15 |
|
|---|
| 16 | CUPS.PDR (the eCups port driver) must be installed. In addition, it
|
|---|
| 17 | should have a bldlevel of 1.03 (February 2011) or later. (With earlier
|
|---|
| 18 | versions, you will be required to restart the WPS after creating a
|
|---|
| 19 | printer.)
|
|---|
| 20 |
|
|---|
| 21 | (If you installed CUPS on your system from WarpIN packages, all of the
|
|---|
| 22 | above requirements should be fulfilled.)
|
|---|
| 23 |
|
|---|
| 24 | Other required files (all included out of the box with eComStation;
|
|---|
| 25 | other versions of OS/2 may or may not have them installed):
|
|---|
| 26 | - RINSTPRN.EXE (OS/2 printer CID installer, usually located in \OS2)
|
|---|
| 27 | - VROBJ.DLL (VX-REXX standard runtime; must be in the LIBPATH)
|
|---|
| 28 | - GZIP.EXE (GNU gzip; must be on the PATH)
|
|---|
| 29 |
|
|---|
| 30 |
|
|---|
| 31 | INSTALLATION
|
|---|
| 32 |
|
|---|
| 33 | 1. Place CUPSWIZ.EXE into a suitable directory.
|
|---|
| 34 | 2. Place CUPSPORT.EXE either in the same directory as CUPSWIZ.EXE, or else
|
|---|
| 35 | in a directory on the PATH.
|
|---|
| 36 |
|
|---|
| 37 |
|
|---|
| 38 | USAGE
|
|---|
| 39 |
|
|---|
| 40 | cupswiz [ <path-to-cups> | /R ]
|
|---|
| 41 |
|
|---|
| 42 | Where <path-to-cups> is the location of the top-level directory in which
|
|---|
| 43 | CUPS is installed on your system (if you are using a local CUPS server).
|
|---|
| 44 | This can be omitted if CUPSWIZ.EXE resides on the same drive as CUPS, or
|
|---|
| 45 | if OS2.INI defines the CUPS path in the key "eCups" -> "CUPS". If CUPS
|
|---|
| 46 | cannot be located, a warning popup will be displayed and the program will
|
|---|
| 47 | proceed as though the /R option was used.
|
|---|
| 48 |
|
|---|
| 49 | The /R option indicates that a WPS printer object is to be created for an
|
|---|
| 50 | already-existing printer queue on a remote CUPS server. In this case, CUPS
|
|---|
| 51 | does not need to be installed locally, but you will need to provide a CUPS-
|
|---|
| 52 | specific PPD file for the printer in question.
|
|---|
| 53 |
|
|---|
| 54 | Only one of the above parameters can be specified.
|
|---|
| 55 |
|
|---|
| 56 | You may wish to create a program object which calls CUPSWIZ.EXE with the
|
|---|
| 57 | appropriate parameter.
|
|---|
| 58 |
|
|---|
| 59 |
|
|---|
| 60 | LIMITATIONS & KNOWN PROBLEMS
|
|---|
| 61 |
|
|---|
| 62 | - There is no way to go 'back' in the wizard; if you need to go back and
|
|---|
| 63 | change a previous selection, you must cancel and start over.
|
|---|
| 64 | - The program has only been tested with Gutenprint, HPLIP, and (to a limited
|
|---|
| 65 | extent) foomatic-rip based printers. Other drivers packages such as SpliX
|
|---|
| 66 | or foo2qpdl may work but this is not guaranteed.
|
|---|
| 67 | - If your %TMP% directory has spaces in the pathname, the program will almost
|
|---|
| 68 | certainly fail to work properly. The same applies to your %LOGFILES%
|
|---|
| 69 | directory.
|
|---|
| 70 | - The CUPS printer is always created with default job options. If you want
|
|---|
| 71 | to change them, you will have to do so from the CUPS administration GUI.
|
|---|
| 72 | - This program is currently available in English only.
|
|---|
| 73 | - There is no help or documentation.
|
|---|
| 74 | - There may well be undiscovered bugs; please report any you find.
|
|---|
| 75 |
|
|---|
| 76 | Contact: Alex Taylor (alex at altsan dot org)
|
|---|
