home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume12 / psf2 / part03 / Readme.Install < prev    next >
Encoding:
Text File  |  1990-05-19  |  6.8 KB  |  211 lines
  1.                P S F     I N S T A L L A T I O N     (manual)
  2.                =================================
  3.                         and other notes
  4.  
  5.    If you are using Xenix 2.3.x, you shoud be reading the file
  6.    
  7.            Readme.Xenix
  8.  
  9.    and use:    Install.xenix
  10.  
  11.    If yow are using AT&T Unix 3.2.2, you should be reading the file
  12.  
  13.         Readme.Unix
  14.  
  15.    and use:    Install.unix
  16.  
  17.    If your are using a different system or wish to manually install psf,
  18.    you are reading the correct file. (you might also wish to read
  19.    Readme.Unix to get some additional information..)
  20.  
  21.  
  22.  
  23. MANUAL INSTALLATION
  24. ^^^^^^^^^^^^^^^^^^^
  25.  
  26. 1. Edit the Makefile to reflect the binary target directory for the psf
  27.    system.
  28.  
  29. 2. Psf requires a "printer definition file" named "psfprint.def" that
  30.    describes the postscript printer. The file name is compiled into
  31.    various psf modules. Edit the Makefile to provide the desired file
  32.    path/name.
  33.  
  34. 3. Compile all sources with "make all".
  35.  
  36. 4. Generate a "printer definition file".  This is done by the
  37.    command:
  38.            selectdef defs/*.def
  39.    
  40.    "selectdef" will access all of printer definitions in the defs/
  41.    directory and copy your selected printer definition into the current
  42.    directory with a name of "psfprint.def" (or different name if you
  43.    changed it in (2) above). The copy operation could be done manually
  44.    - however you will not get a "psizes.ps" programme generated.
  45.  
  46.    Selectdef also generates a postscript programme file "psizes.ps" that
  47.    will print out the actual imageable area recorded in the printer roms
  48.    for each page size known to your printer. The psizes.ps file should
  49.    be sent to the printer with:
  50.    
  51.            cat psizes.ps | lp
  52.        or
  53.            cat psizes.ps > /dev/lp
  54.    
  55.    The resulting figures can be used to modify the psfprint.def file to
  56.    accurately define your printer's imageable area.
  57.  
  58.    Even though the various defs/*.def files are derived from the Adobe
  59.    .ppd files, the .ppd files for the printers do not necessarily
  60.    reflect the accurate imageable areas actually implemented by the
  61.    printer manufacturer. For example, the NEC__470.ppd file provided by
  62.    Adobe does not describe the imageable area that is actually in my
  63.    LC890. Thus, psizes.ps is a handy way to determine your
  64.    exact printer imageable area.
  65.  
  66.    If your printer is not known in the various defs/*.def files, then
  67.    choose the closest approximation.  
  68.    
  69.    If that is not good enough, you should modify the postscript
  70.    programme at the end of this Readme file (or use the psizes.ps
  71.    generated for the "closest approximation") to reflect the various
  72.    paper sizes supported by your printer. Send the resulting programme
  73.    to the printer, and construct a psfprint.def file based upon it's
  74.    results. Use the "sample.def" file as a starting point to generate
  75.    your .def file.
  76.  
  77. 5. Copy the desired psf binaries and scripts to the binary directory
  78.    (as per the Makefile definition).  Probably "selectdef" and "table"
  79.    should NOT be copied.  (or use "make all").
  80.  
  81.    If you are not using Letter size paper as your standard, you may need
  82.    to make some modifications to the scripts as described in (11) below.
  83.  
  84. 6. Copy the "psfprint.def" printer definition file to the target file 
  85.    (as per the Makefile definition).  (also copied with "make all").
  86.  
  87. 7. If you intend to run psf as part of the print spooler, then copy
  88.    "psfsample.LP" to another file. Edit this new file to configure the
  89.    printer model. 
  90.    
  91.    If you have a serial printer, examine the stty command to ensure
  92.    correct port configuration.
  93.    
  94.    Install the printer model as needed for your printer system. If your
  95.    spooler allows passing of printer options with the "-o" option, then
  96.    you could use (for example):
  97.  
  98.         lp -o"-4xh" this.file that.file
  99.         
  100.    The "-4xh" options are passed by lp to psf to print the files "4-up"
  101.    on a page, with file name headers (h) and dividing lines between
  102.    quandrants (x). Any set of options may be enclosed between the
  103.    quotation marks.
  104.  
  105.  
  106. 8. If you do not intend to run psf as part of the spooler, you
  107.    are finished.  psf is then used as a print filter manually.
  108.    
  109.    For example:
  110.  
  111.         psf this.file | lp
  112.    
  113.            man -b vi | pnf -i | psf -2 | lp
  114.  
  115. 9. Install the man pages.  E.g.:   cp *.1 /usr/man/man.1
  116.  
  117. 10. Print the man pages:     E.g.:   psnroff -man *.1
  118.     or, if nroff is not avaliable:   psf -2l 66 *.doc | lp
  119.  
  120. 11. Make any option changes to the various psf commands
  121.     in scripts.  For example:
  122.     
  123.     psman:        change the man chapters as per your man directories
  124.                   (the distribution psman assumes Xenix directories)
  125.     psnroff:      change the psf options (by default, the output
  126.                   default is for two-up printing).
  127.     psmbox:       change default psf printing characteristics.
  128.     psbanner.c:   this routine prints banner pages.  you may
  129.                   wish to change the layout of banner pages.
  130.  
  131.    If European paper sizes are used (A4, B5, etc), then the "-l nn" for
  132.    psf or the "-r nn -l nn" option to pnf may need to be specified.
  133.  
  134. 12. Edit the file "Testfile":  this file, (after editing) is an example
  135.     of how escape seqeuences can be imbedded in a text file to allow
  136.     direct font control within a text editor (See psf.1 for details).
  137.  
  138.    The "Testfile" should contain many ^E characters (octal \005).  Since
  139.    mail/news system may change the ^E character into the text string "005"
  140.    You will have to edit the Testfile and replace all "005" strings with
  141.    true ctrl-E character.
  142.  
  143.    One easy way to correct this is with sed:
  144.  
  145.     sed 's@005@<CTRL-E>@g' Testfile > newtest
  146.                    +------+
  147.                     actually type the CTRL-E character
  148.                     to generate the octal charcter \005
  149.  
  150.     After editing, do the following:
  151.     
  152.         psf newtest | lp
  153.     
  154.     to see how font control can work in a text file.
  155.  
  156. =========================================================================        
  157.  
  158.    You can modify the following postscript programme (quickly now, rush
  159.    out and buy some postscript manuals....) to print out (on paper) the
  160.    imageable area of the various paper sizes. Normally, this file is
  161.    generated by "selectdef" and is named psizes.ps.
  162.  
  163.  
  164. %!
  165. /getsize {
  166.     clippath
  167.     pathbbox
  168. } def
  169. /sendsize {
  170.     /ury exch def
  171.     /urx exch def
  172.     /lly exch def
  173.     /llx exch def
  174.     /str 64 string def
  175.     show
  176.     (  ) show
  177.     llx    ceiling cvi str cvs show
  178.     (  ) show
  179.     lly    ceiling cvi str cvs show
  180.     (  ) show
  181.     urx    floor cvi str cvs show
  182.     (  ) show
  183.     ury    floor cvi str cvs show
  184. } def
  185. /pg save def
  186. newpath
  187. b5
  188. (B5: 516 729) getsize
  189. a4
  190. (A4: 595 842) getsize
  191. legal
  192. (Legal: 612 1008) getsize
  193. letter
  194. (Letter: 612 792) getsize
  195. statusdict begin lettertray end
  196. /Courier findfont 12 scalefont setfont
  197. 50 600 moveto
  198. (Imageable area) show
  199. 50 585 moveto
  200. (NEC LC-890 v47.0 \(corrected\)) show
  201. 50 565 moveto
  202. sendsize
  203. 50 550 moveto
  204. sendsize
  205. 50 535 moveto
  206. sendsize
  207. 50 520 moveto
  208. sendsize
  209. showpage 
  210. pg restore
  211.