Changeset 15 for trunk/gui


Ignore:
Timestamp:
Oct 9, 2012, 2:12:29 AM (13 years ago)
Author:
Alex Taylor
Message:

Updated README for release.

File:
1 edited

Legend:

Unmodified
Added
Removed

  • trunk/gui/printer/cupswiz/readme.1st

    r14 r15  
    1 CUPSWIZ - prototype CUPS printer-creation wizard
     1CUPSWIZ - CUPS printer-creation wizard
    22Version 0.95
    33
    4 Make sure cupsport.exe is either in the current directory or in the PATH.
    54
    6 Usage: cupswiz <path-to-cups>
    7 (e.g. "cupswiz f:\cups")
     5REQUIREMENTS
    86
    9 <path-to-cups> can be omitted if cupswiz.exe is on the same drive as CUPS, or
    10 if OS2.INI defines the CUPS path in the key "eCups" -> "CUPS".
     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.
    119
    12 Requirements:
    13  - CUPS, including ECUPS.DRV and CUPS.PDR, must be installed and working.
    14    The CUPS daemon must be running. 
    15  - CUPS.PDR should have a bldlevel of 1.03 (February 2011) or later.  If not,
    16    the created WPS printer object will not work properly until you reboot
    17    (possibly restarting the WPS will also work, but I'm not sure about that).
    18  - GNU gzip.exe must be installed (somewhere on the PATH).
    19  - RINSTPRN.EXE (included with OS/2 MCP/ACP & eComStation, not sure about
    20    earlier versions) must also be somewhere on the PATH.
    21  - VROBJ.DLL (included in eComStation or available on Hobbes) is required.
     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)
    2215
    23 Current limitations:
    24  - The CUPS printer is always created with default job options.
    25  - There is no way to go 'back'; if you need to go back and change a previous
    26    selection, you must cancel and start over.
    27  - The program has only been tested with Gutenprint, HPLIP, and (to a limited
    28    extent) foomatic-rip based printers.  Other drivers packages such as SpliX
    29    or foo2qpdl may work but this is not guaranteed.
    30  - If your %TMP% directory has spaces in the pathname, the program will almost
    31    certainly fail to work properly.  The same applies to your %LOGFILES%
    32    directory.
    33  - No internationalization support (yet).
    34  - No help or documentation.
    35  - Probably still has bugs due to my limited testing capabilities.
     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)
    3629
    3730
     31INSTALLATION
     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
     38USAGE
     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
     60LIMITATIONS & 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
    3876Contact: Alex Taylor (alex at altsan dot org)
Note: See TracChangeset for help on using the changeset viewer.