Changes between Version 33 and Version 34 of HowTo


Ignore:
Timestamp:
Dec 11, 2010, 2:25:57 PM (14 years ago)
Author:
Alex Taylor
Comment:

More formatting improvements & clarifications

Legend:

Unmodified
Added
Removed
Modified
  • HowTo

    v33 v34  
    1 '''
    2 == A CUPS and eCS (OS/2) How To ==
    3 '''
    4 
    5 Revision 1 14/08/2008[[BR]]
     1= A CUPS and eCS (OS/2) How To =
     2
    63
    74Author: Peter Brown[[BR]]
    85email: losepete@ntlworld.com[[BR]]
    96
    10 Revisions to filenames 29/12/2008 - Paul Smedley
    11 
    12 Revisions to USB section 29/03/2009 - Paul Smedley
    13 
    14 Revisions to the list of required software and brief description of software sections 11/04/2009 - Ed Durrant[[BR]]
    15 Additional details about using USB interface and visual instructions around set up of CUPS web admin printer install  12/04/2009 - Ed Durrant[[BR]]
    16 Additional visual instructions around set up of OS/2 printer object to use CUPS attached printer 13/04/2009 - Ed Durrant[[BR]]
    17 Changes to the desktop printer object setup based on the later versions of the files for clarification 10/07/2009 - Ed Durrant[[BR]]
    18 
    19 Various formatting improvements and clarifications 2010-11-08 Alex Taylor[[BR]]
     7||Revision 1||14/08/2008||Peter Brown||
     8||Revisions to filenames||29/12/2008||Paul Smedley||
     9||Revisions to USB section||29/03/2009||Paul Smedley||
     10||Revisions to the list of required software and brief description of software sections||11/04/2009||Ed Durrant||
     11||Additional details about using USB interface and visual instructions around set up of CUPS web admin printer install||12/04/2009||Ed Durrant||
     12||Additional visual instructions around set up of OS/2 printer object to use CUPS attached printer||13/04/2009||Ed Durrant||
     13||Changes to the desktop printer object setup based on the later versions of the files for clarification||10/07/2009||Ed Durrant||
     14||Various formatting improvements and clarifications||2010-11-08||Alex Taylor||
     15||Formatting improvements and clarifications, continued||2010-12-11||Alex Taylor||
    2016
    2117[[BR]]
     
    3026
    3127== CONTENTS ==
    32 [[BR]]
    33 
    3428
    3529'''Brief Preamble'''
     
    5953[[BR]]
    6054[[BR]]
    61 [[BR]]
    62 
    63 
    64 
    65 
    66 
    67 '''
    68 Brief Preamble'''
     55
     56
     57
     58== Brief Preamble ==
    6959
    7060
     
    7666[[BR]]
    7767[[BR]]
    78 [[BR]]
    79 
    80 
    81 
    82 
    83 
    84 
    85 '''Why install CUPS? - and what is it?'''
     68
     69
     70
     71== Why install CUPS? - and what is it? ==
    8672
    8773
    8874[http://www.cups.org/ Common Unix Printing System] answers the "what is it?" bit.  It's a generic framework for printer driver packages.  You install CUPS plus a driver package that supports your printer, and if all goes well you can print. :-)  See the CupsFaq for more information on how it works specifically.
    8975
    90 ''What does it support?'' - Support for actual printers is handled by the individual driver packages. 
    91  * List of supported printers under !GutenPrint: http://gutenprint.sourceforge.net/p_Supported_Printers.php  (!GutenPrint is the biggest and most commonly-used driver package)
     76'''What does it support?''' - Support for actual printers is handled by the individual driver packages. 
     77 * List of supported printers under Gutenprint: http://gutenprint.sourceforge.net/p_Supported_Printers.php  (Gutenprint is the biggest and most commonly-used driver package)
    9278 * List of supported printers under Splix: http://splix.ap2c.org/  (Splix supports some Samsung and Xerox printers)
    9379 * List of supported printers under HPLIP: http://hplipopensource.com/hplip-web/supported_devices/index.html  (HPLIP supports various Hewlett-Packard printers)
    9480
    95 ''Why install CUPS?'' - Simply because it is capable of supporting a lot of modern printers and is being continually updated to support more. The old OS/2 printer drivers are not that good with new printers. If you are lucky enough to find a driver that works with your modern printer, those drivers will not be updated to take advantage of all the features whereas the CUPS driver will.
     81'''Why install CUPS?''' - Simply because it is capable of supporting a lot of modern printers and is being continually updated to support more. The old OS/2 printer drivers are not that good with new printers. If you are lucky enough to find a driver that works with your modern printer, those drivers will not be updated to take advantage of all the features whereas the CUPS driver will.
    9682
    9783CUPS can provide drivers for more current printers - and should provide many extra capabilities missing from the OS/2 drivers.
     
    10086[[BR]]
    10187[[BR]]
    102 [[BR]]
    103 
    104 
    105 
    106 
    107 '''List of required software'''
     88
     89
     90
     91== List of required software ==
    10892
    10993The CUPS port is available at http://svn.netlabs.org/ecups/wiki/CupsPort - you can download in WPI format (all packages) or as individual ZIP files.  If you download the individual files, remember that you need the following packages.
    11094
    111 ''Always required:''
     95'''Always required:'''
    11296
    11397 * CUPS OS/2 binary
     
    116100
    117101 * At least one of the following driver packages (choose the one which supports your printer):
    118   * !GutenPrint (many printers)
     102  * Gutenprint (many printers)
    119103  * Splix (!Samsung/Xerox printers) - also requires custom GCC runtime: http://smedley.info/gcc432.zip
    120104  * HPLIP
    121105
    122  * eCUPS port driver (CUPS.PDR)
    123 
    124  * eCups (ECUPS.DRV), CUPS-specific !PostScript printer driver
     106 * eCups port driver (CUPS.PDR)
     107
     108 * eCups print driver (ECUPS.DRV), CUPS-specific !PostScript printer driver
    125109
    126110 * Libc files required for CUPS - ftp://ftp.netlabs.org/pub/gcc/libc-0.6.3-csd3.zip (you may have these already, especially if you are running eComStation)
    127111
    128 ''May be required''
     112'''May be required'''
    129113
    130114 * USB helper driver (required for USB printing only) - http://en.ecomstation.ru/projects/usbtools/download/usbcalls-20060807.zip (again, you may have this already if you use a recent version of eCS)
     
    139123[[BR]]
    140124[[BR]]
    141 [[BR]]
    142 
    143 
    144 
    145 
    146 
    147 
    148 '''Brief description of the software packages'''
     125
     126
     127
     128
     129== Brief description of the software packages ==
    149130
    150131CUPS consists of several packages that work together to provide emulated !PostScript printing on raster printers.  The core components on all platforms are the CUPS daemon, !GhostScript, and the driver packages (Gutenprint, Splix, HPLIP etc.).
     
    174155[[BR]]
    175156[[BR]]
    176 [[BR]]
    177 
    178 
    179 
    180 
    181 
    182 '''Installation'''
    183 
    184 
    185 Put the PRNDRV.EXE file somewhere that you can find it; I put it into J:\Programs\Utils\PrnDrv
    186 
    187 The libc0*.dll and GCC*.dll files should be put into a directory specified within the libpath either \ecs\dll or \os2\dll are good choices.
    188 
    189 The basic CUPS Install consists of unzipping the packages in the root directory of a drive (doesn't have to be the boot drive):
    190 
    191   * Ghostscript needs to be unzipped into \gs - so that you end up with for example, x:\gs\gs8.64 (some zip packages contain the \gs upper directory, some don't so make sure you end up with the correct directory structure).
    192 
    193   * cups-1.3.10*.zip needs to be unzipped into ROOT creating the \CUPS directory
    194 
    195   * gutenprint*.zip needs to be unzipped into ROOT creating the \Gutenprint directory and adding some files to the \CUPS directory
    196 
    197 
    198 At the end of this process, you should have 3 new directories of the root directory of your chosen drive: \cups, \gutenprint and \gs
    199 
    200 
    201 Have a read of the \cups\readme.os2 before proceeding to get an idea of what you are going to do; especially if attempting to setup a USB printer.
     157
     158
     159
     160== Installation ==
     161
     162There is now a !WarpIN package available (see the CupsPort page) but it is still somewhat experimental, and may not contain the latest versions.  The instructions below assume you are installing manually, i.e. from zipfiles.
     163
     164 * The basic CUPS install (using Gutenprint) consists of unzipping the packages in the root directory of a drive (doesn't have to be the boot drive):
     165
     166   * !GhostScript needs to be unzipped into `\gs` - so that you end up with for example, `x:\gs\gs8.70` (some zip packages contain the `\gs` upper directory, some don't - so make sure you end up with the correct directory structure).
     167
     168    * `cups-*.zip` needs to be unzipped into the '''root''' directory, thereby creating the `\cups` directory
     169
     170    * `gutenprint*.zip` needs to be unzipped into the '''root''' directory, which will create the `\gutenprint` directory as well as add some required files to the `\cups` directory.
     171
     172  At the end of this process, you should have 3 new directories of the root directory of your chosen drive:
     173{{{
     174\cups
     175\gutenprint
     176\gs
     177}}}
     178
     179 * Have a read of the \cups\readme.os2 before proceeding to get an idea of what you are going to do; especially if attempting to setup a USB printer.
     180
     181 * If installing PRNDRV.EXE, put this file somewhere that you can find it; I put it into `J:\Programs\Utils\PrnDrv`
     182
     183 * The `libc0*.dll` and `GCC*.dll` files should be put into a directory specified within the LIBPATH - either `\ecs\dll` or `\os2\dll` are good choices.
    202184
    203185
    204186'''Other files can be unzipped now or later as they are required as follows:'''
    205187
    206 The eCUPS printer driver should be put into a directory under \OS2\DLL - my suggestion is \OS2\DLL\CUPS - you will then point the printer install dialog at this directory during the install process.
    207 
    208 The eCUPS printer port driver - copy cupslpr.exe into \tcpip\bin and cups.pdr into \os2\dll
    209 
    210 The Splix package in place of the gutenprint package if you are installing one of the Splix supported Samsung or Xerox printers (this how-to doesn't cover Splix usage yet).
    211 
    212 [[BR]]
    213 [[BR]]
    214 [[BR]]
    215 
    216 
    217 
    218 
    219 '''Configuration of CUPS Printer'''
     188 * The eCups printer driver can be put into a directory of your choice.  You will then point the printer install dialog at this directory during the install process; OS/2 will then automatically copy the files to `\OS2\DLL\ECUPS' (which it will create if necessary).
     189
     190 * The eCups printer port driver - copy `cupslpr.exe` into `\tcpip\bin` and `cups.pdr` into `\os2\dll`
     191
     192The Splix package should be installed in place of the Gutenprint package if you are installing one of the Splix-supported Samsung or Xerox printers; ditto for HPLIP.  '''Note:''' This how-to doesn't cover Splix or HPLIP usage yet.
     193
     194[[BR]]
     195[[BR]]
     196
     197
     198
     199
     200== Configuration of CUPS Printer ==
    220201[[BR]]
    221202[[BR]]
     
    455436[[BR]]
    456437
     438
    457439'''Step by step visual OS2 printer object setup for a CUPS attached printer'''
    458440