home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume12 / psf2 / part05 / Readme.Unix < prev   
Encoding:
Text File  |  1990-05-19  |  11.1 KB  |  300 lines
  1.                    P S F     I N S T A L L A T I O N   (AT&T Unix 3.2.2)
  2.                    =================================
  3.  
  4.    If you are using Xenix 2.3.x, you should be reading the file
  5.    
  6.            Readme.Xenix
  7.  
  8.    If yow wish to do a manual installation, read the file:
  9.  
  10.         Readme.Install
  11.  
  12.    The installation script "Install.unix" and Makefile are correctly
  13.    configured install psf correctly on AT&T Unix 3.2.2 (System V/386) by
  14.    default. The script builds a printer model, updates the model
  15.    directory, and (optionally) adds a printer definition to the FACE
  16.    printer database.
  17.  
  18.    The psf scripts and binaries (by default) are placed in
  19.    /usr/local/bin. If this directory does not exist, it should be
  20.    created. If you wish to use a different directory for the psf
  21.    binaries and scripts, edit the Makefile to reflect the desired
  22.    BINDIR.
  23.  
  24.    Now build the binaries with "make all".
  25.    
  26.    If your printer is not specified in the ./defs/*.def files (i.e. when
  27.    you run your install process and the "list of available printers"
  28.    does not specify your particular printer), then select the nearest
  29.    approximation or read the "Readme.Install" file (in particular, point
  30.    4) to help you set up a printer definition for your printer.
  31.  
  32.    If you are using a serial printer, examine the "stty" command to set
  33.    port characteristics in psfunix.LP (which is the prototype for the
  34.    printer model "psf")
  35.  
  36.    Iff FACE is installed (AT&T Unix 3.2.2), the installation script
  37.    "Install.unix" can add a printer description into the printer
  38.    database file to describe a postscript printer.  The data base
  39.    file is:
  40.         /usr/vmsys/admin/PS/PORTSET/database
  41.  
  42.    If you DO wish to have this file update, use the -f option on the
  43.    Install.unix script. This allows the use FACE for most of the printer
  44.    installation.
  45.  
  46.    Without the -f option, the database is not updated.
  47.    
  48.    AT&T Unix users will also have to use lpadmin to select the
  49.    postscript printer model (FACE does not allow selection of
  50.    the printer model).
  51.  
  52.  
  53.    PSF is installed (as root) with the command:
  54.    
  55.            # Install.unix [-f]
  56.    
  57.    where:  -f  = add Postscript-PSF printer type to the FACE database
  58.                  (AT&T Unix 3.2.2 only)  This should NOT be specified
  59.                  if lpadmin is to be used for printer installation.
  60.  
  61.  
  62.  
  63. 1. SELECT PRINTER TYPE
  64. ^^^^^^^^^^^^^^^^^^^^^^
  65.    Root priviliges are probably necessary to allow the creation of
  66.    various files.  The installation options are presented:
  67.  
  68.         1. Select printer type,  make printer model files
  69.     2. Move psf binaries and scripts to $BINDIR
  70.     3. Move psf files to $SPOOLDIR
  71.     4. Install man pages in $MANDIR
  72.     5. Print man pages
  73.     6. Remove psf software and files from binary and spool directories
  74.  
  75.      ===> Select an option or enter q to quit: 1
  76.    
  77.    First select option 1: to select the postscript printer. After
  78.    configuration, the various psf files remain in the current directory
  79.    and are NOT copied to any of the binary or spooling files.
  80.  
  81.    The printer type list is presented as follows:
  82.  
  83.                          SELECT PRINTER TYPE
  84.  
  85.  1: Apple LaserWriter v23.0             2: Apple LaserWriter Plus v38.0       
  86.  3: Apple LaserWriter Plus v42.2        4: AST TurboLaser/PS v47.0            
  87.  5: Agfa-Compugraphic 9400P v49.3       6: Dataproducts LZR-2665 v47.0        
  88.  7: Dataproducts LZR 1260 v47.0         8: IBM 4216-020 v47.0                 
  89.  9: IBM 4216-030 v50.5                 10: Linotronic 100 v38.0               
  90. 11: Linotronic 100 v42.5               12: Linotronic 200 v47.1               
  91. 13: Linotronic 200 v49.3               14: Linotronic 300 v47.0               
  92. 15: Linotronic 300 v47.1               16: Linotronic 300 v49.3               
  93. 17: Linotronic 500 v49.3               18: Apple LaserWriter II NT v47.0      
  94. 19: Apple LaserWriter II NTX v47.0     20: NEC LC-890 v47.0 (corrected)       
  95. 21: NEC LC-890 v47.0                   22: QMS-PS 810 v47.0                   
  96. 23: QMS-PS 800 v46.1                   24: QMS-PS 800 Plus v46.1              
  97. 25: QMS ColorScript 100 v49.3          26: Qume ScripTEN v47.0                
  98. 27: Schlumberger 5232 Color PostScript Printer v50.3
  99. 28: TI OmniLaser 2108 v45.0            29: TI Omnilaser 2115 v47.0            
  100. 30: Varityper 4200B-P v49.3            31: Varityper 4300P v49.3              
  101. 32: Varityper VT-600P v48.0            33: Varityper VT-600W v48.0            
  102. ==> Select printer by number (q = quit, r = refresh display): 
  103.  
  104.    After the printer type is selected, you are asked to specify the
  105.    default paper size that psf will assume unless otherwise instructed:
  106.  
  107.     Select default page size:
  108.       1: Letter
  109.       2: Legal
  110.       3: A4
  111.       4: B5
  112.      ==> Select page size by number (q = quit, r = refresh display): 
  113.  
  114.    (The list of page sizes is dependent upon the selected printer type.
  115.    As a result, the list may differ from the above sample)
  116.  
  117.  
  118. 2. BINARY/SCRIPT INSTALLATION
  119. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  120.    Install the scripts and binaries in the target directory with option 2:
  121.  
  122.         1. Select printer type,  make printer model files
  123.     2. Move psf binaries and scripts to $BINDIR
  124.     3. Move psf files to $SPOOLDIR
  125.     4. Install man pages in $MANDIR
  126.     5. Print man pages
  127.     6. Remove psf software and files from binary and spool directories
  128.  
  129.      ===> Select an option or enter q to quit: 2
  130.  
  131.    By default, the destination binary and script directory is
  132.    /usr/local/bin. Another directory (such as /usr/lbin/bin, etc) may be
  133.    used. The only requirement is that the various users of PSF are
  134.    pathed to the specified directory.
  135.  
  136.        Install PSF Binaries and 
  137.            scripts in which directory [/usr/local/bin]? 
  138.  
  139.    The various binaries, scripts and printer defintion files are then
  140.    copied to the appropriate target directories.  LP model and printer
  141.    scripts are not copied.
  142.  
  143.  
  144. 3. INSTALL LP SPOOLER SCRIPTS
  145. ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  146.    If you intend to use psf as part of the lp back-end spooling system,
  147.    then install the lp spooler scripts.
  148.  
  149.    If you do NOT wish to install the lp back-end, then you may quit the
  150.    installation process. The psf filters are manually activated (refer
  151.    to the psf documentation file psf.1 and Readme.Install).
  152.  
  153.    If various printer spooling directories and files are correctly set
  154.    up, the psf model and interface files may be installed in the spool
  155.    directory by selecting option 3:
  156.  
  157.         1. Select printer type,  make printer model files
  158.     2. Move psf binaries and scripts to $BINDIR
  159.     3. Move psf files to $SPOOLDIR
  160.     4. Install man pages in $MANDIR
  161.     5. Print man pages
  162.     6. Remove psf software and files from binary and spool directories
  163.  
  164.      ===> Select an option or enter q to quit: 3
  165.  
  166.    After the spooler scripts are installed, activate the printer. If you
  167.    are using AT&T unix 3.2, you will probably use FACE (if installed) or
  168.    LPADMIN to complete the printer installation.
  169.  
  170.    Read the notes in "Configure Printer" below.
  171.  
  172.  
  173. CONFIGURE PRINTER
  174. ^^^^^^^^^^^^^^^^^
  175.    The printer model that must be used to print with psf is
  176.    automatically created by Install.unix in file:
  177.    
  178.        /usr/spool/lp/model/psf
  179.    
  180.    Printer installation may be done with either lpadmin or with FACE. If
  181.    you install the printer with lpadmin, be sure to specify the "-m psf"
  182.    option to select the psf printer model. E.g.:
  183.  
  184.        /usr/lib/lpadmin -p printer -v /dev/lp -m psf -o nobanner
  185.    
  186.    If you install with FACE, you should configure the "Postscript-PSF"
  187.    printer. Subsequently, modify the printer model to "psf" since FACE
  188.    cannot select a printer model other than "standard". I.e., use
  189.    lpadmin with a command similar to:
  190.  
  191.     /usr/lib/lpadmin -p printer -m psf -o nobanner
  192.  
  193.  
  194. 4. PRINTING MAN PAGES
  195. ^^^^^^^^^^^^^^^^^^^^^
  196.    Optionally, you can continue with the installation if the man pages
  197.    by selecting options 4/5 from:
  198.  
  199.         1. Select printer type,  make printer model files
  200.     2. Move psf binaries and scripts to $BINDIR
  201.     3. Move psf files to $SPOOLDIR
  202.     4. Install man pages in $MANDIR
  203.     5. Print man pages
  204.     6. Remove psf software and files from binary and spool directories
  205.  
  206.      ===> Select an option or enter q to quit:
  207.  
  208.    If your system has on-line man pages then the man-page installation
  209.    (option 4) may be used.
  210.  
  211.    The man pages may be printed on the postscript printer by selection
  212.    of option 5. The installation script prints the man-pages from the
  213.    pre-formatted *.doc files if /usr/man directory cannot be found.
  214.  
  215.  
  216.  
  217. AFTER INSTALLATION
  218. ^^^^^^^^^^^^^^^^^^
  219.    Edit the file "Testfile" with sed (as below). This file is an example
  220.    of how escape seqeuences can be imbedded in a text file to allow
  221.    direct font control within a text editor (See psf.1 for details).
  222.  
  223.    The "Testfile" should contain many ^E characters (octal \005).  Since
  224.    mail system may change the ^E character into the text string "005"
  225.    You will have to edit the testfile and replace all "005" strings with
  226.    true ctrl-E character.
  227.  
  228.    One easy way to correct this is with sed:
  229.  
  230.     sed 's@005@<CTRL-E>@g' Testfile > example
  231.                    +------+
  232.                     actually type the CTRL-E character
  233.                     to generate the octal charcter \005
  234.  
  235.     After editing, do the following:
  236.     
  237.         psf example | lp
  238.     
  239.     to see how font control can work in a text file.
  240.  
  241. LP (spooler) OPTIONS
  242. ^^^^^^^^^^^^^^^^^^^^
  243.    The provided printer model (/usr/spool/lp/model/psf and it's
  244.    associated prototype file psfunix.LP) allows the use of the "-o" to
  245.    pass options to psf. Two additional banner page options may be passed
  246.    to the printer script:
  247.  
  248.     banner        = print banner page
  249.     nobanner    = do not print banner page
  250.  
  251.    For example:
  252.  
  253.     lp -o"nobanner -4xh" my.text.file
  254.     lp -o"banner" another.file
  255.  
  256.    The psf printer model examines the printer configuration file in:
  257.  
  258.     /usr/spool/lp/admins/lp/printers/<printer name>/configuration
  259.  
  260.    to determine if banners are required. The first line of this script
  261.    normally contains one of the following (and can be set by lpadmin):
  262.  
  263.     Banner: on:Always
  264.     Banner: on
  265.  
  266.    An additional option is recognized (and cannt be set by lpadmin: it
  267.    must be manually edited into the configuration file):
  268.  
  269.     Banner: off
  270.  
  271.    "Banner: on:Always" forces banners to be printed, even if the user
  272.    specified "nobanner".
  273.  
  274.    "Banner: on" prints a banner page unless the user specifies "nobanner". 
  275.    If "nobanner" is provided, then the banner is not printed.
  276.  
  277.    "Banner: off" will not print the banner page unless the user 
  278.    provides "banner", in which case the banner page is printed.
  279.  
  280.  
  281. PSF notes.
  282. ^^^^^^^^^^
  283.    The printer definitions in ~psf/defs are derived from the Adobe
  284.    ".ppd" files. These are available from the Adobe file server via
  285.    email. The programme "table" is used to translate the ".ppd" files
  286.    into ".def" printer definition files used by psf.
  287.  
  288.    If the user's printer is not in the list of available printers, a
  289.    suitable .def definition must be manually constructed (see file
  290.    "sample.def" as a guide).
  291.  
  292.  
  293. PROBLEMS:
  294.   
  295.    The adobe .ppd files not not necessarily describe the "true"
  296.    printable area of the printers. For example, the printable area of a
  297.    NEC LC890 printer is different than described in the nec_470.ppd
  298.    file. I do not know which .ppd files are "accurate" or "inaccurate"!
  299.    See the Readme.Install file (in particular, point 4).
  300.