home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / GRAPHICS / PSCRIPT / PCPS533.ZIP / PCPS.DOC next >
Encoding:
Text File  |  1991-11-08  |  10.7 KB  |  247 lines
  1.  
  2.                                 PCPS.EXE                      Version 5.33
  3.                                 --------
  4.  
  5. 1. INTRODUCTION
  6. ---------------
  7.  
  8. PCPS is an executable program designed to run under MS-DOS or PC-DOS
  9. version 2.1 upwards.  The program will read in a normal DOS text file and
  10. produce POSTSCRIPT* output that can be directly printed on a POSTSCRIPT*
  11. compatible printer, in particular, the Apple Laserwriter.
  12.  
  13.  
  14. 2. DESCRIPTION
  15. --------------
  16.  
  17. When executed, PCPS reads in one or more text files, converts them to
  18. POSTSCRIPT* and the outputs them either directly to a printer or optionally
  19. to a disk file.  Banner, orientation, fonts, font sizes, line handling, output
  20. format, output path and line numbering options may be specified.
  21.  
  22.  
  23. 3. USAGE AND ARGUMENTS
  24. ----------------------
  25.  
  26. The format of the command is as follows:
  27.  
  28. PCPS [-args] file1 file2.....filen
  29.  
  30. If no arguments are specified the following defaults are true:
  31.  
  32.  1. Default output is to the second printer ie. LPT2
  33.  2. Default output page order is normal ie. first page first (this is for
  34.     laser printers that do sort the pages out for you.)
  35.  3. Default is non-gaudy banner ON ie. a banner containing the file name,
  36.     creation date and time and the POSTSCRIPT* page number will be printed
  37.     in bold at the top of each page.
  38.  4. Default font is Courier.
  39.  5. Default font sizes are: Portrait and 1 col Landscape - 10 point.
  40.                                          2 col Landscape - 7 point.
  41.  6. Default orientation is Portrait.
  42.  7. Default is to wrap long lines.
  43.  8. Default is to pass tab characters through as they are.
  44.  9. Default is to do page sorting in memory if there is enough free memory
  45.     for the operation
  46. 10. Default is no line numbers.
  47. 11. Default is not to delete input file after processing.
  48. 12. Default is for continuous paper feed (ie. Not Manual Feed)
  49.  
  50. 4. ARGUMENTS
  51. ------------
  52.  
  53.    -l           =>  List available font codes.  This should be used by itself
  54.                      (ie. PCPC -L) as anything else on the line will be ignored.
  55.   
  56.    -b           =>  Banner OFF (ie. Do not print a banner on each page).
  57.  
  58.    -c           =>  Truncate (Cut) lines longer than the maximum number of
  59.                      characters allowed for the current mode.
  60.  
  61. 4. ARGUMENTS (cont)
  62. ------------
  63.  
  64.    -dl          =>  Delete the input file after successful processing.  USE
  65.                      WITH CAUTION!  PCPS considers that if it receives no
  66.                      errors when processing the file, then it is printed.  On
  67.                      a network, however, the print job might get lost!
  68.  
  69.    -dm          =>  Switch off memory sorting - useful if, for some reason,
  70.                      PCPS reports a memory allocation error whilst processing
  71.                      your document.
  72.  
  73.  -f<code><size> =>  Code of font to use followed by optional font size.
  74.                      Refer to section 5 or -l argument for a description of
  75.                      font codes.  The font size must be specified after the
  76.                      font code(if present) or if you wish just to alter the
  77.                      size and not the default font, -f<size> will be accepted.
  78.  
  79.    -g           =>  Print a gaudy banner at the top of the page containing
  80.                      the file last-modified date and time, the file name and
  81.                      the page number.  This argument is meaningless if "-b"
  82.                      (banner off) is specified.
  83.  
  84.    -i           =>  Inverse page order (ie. Output the last page first).
  85.  
  86.    -m           =>  Manual paper feed at printer - useful if you wish to use
  87.                      different paper than what is loaded into the paper tray.
  88.  
  89.    -m1          =>  Manual paper feed for the first page only - useful if the
  90.                      first page needs to be printed on letter head.
  91.  
  92.    -p<path>     =>  Instead of output to LPT2, output to <path> where <path>
  93.                      can be the pathname of a file (eg. \bin\example.ps) or
  94.                      the name of another printer (eg. LPT1).
  95.  
  96.    -q           =>  Quiet mode - no fancy information is displayed.  For each
  97.                      file processed, only the number of pages output is
  98.                      displayed.
  99.  
  100.    -r           =>  Rotate the print 90 degrees (Landscape mode).  This mode
  101.                      allows lines up to 132 characters before it wraps or
  102.                      truncates.
  103.  
  104.    -2           =>  Rotate the print 90 degrees and print in two columns with
  105.                      the smaller 7 point print.  This is a good mode to
  106.                      economize on paper.
  107.  
  108.    -t[n]        =>  Expand tabs to tabstops.  If just -t is specified, tabs will
  109.                      be expanded to tabstops every 8 columns.  If a number (n)
  110.                      follows the -t, tabs will be expanded to tabstops every
  111.                      n columns.
  112.  
  113.    -u           =>  Unlimited (almost) line length - PCPS, as a default,
  114.                      calculates a maximum line length based on the font size
  115.                      and paper orientation.  This calculation is performed
  116.                      assuming COURIER font (the only non-proportional font)
  117.                      and so is inaccurate when applied to other fonts.  The
  118.                      usual result of this is that it under-calculates how many
  119.                      characters will fit on the line.  This switch is useful
  120.                      if you wish to over-ride this feature.
  121.  
  122.    -#[n]        =>  Print line numbers.  If just -# specified, the line numbers
  123.                      default to 4 digits.  If a number (n) follows the -#, the
  124.                      line numbers will be set to that many digits (max 6).  If
  125.                      the line number count increases to greater than the current
  126.                      number of digits can handle, the digits will automatically
  127.                      be increased to compensate for this situation.
  128.  
  129. Wild cards are permitted to be used for the input text files and more than
  130. one file may be specified.  The maximum number of characters per line is
  131. automatically calculated by PCPS based on the font Courier and the font
  132. size specified at invocation.  For example: if a font size of 48 is specified
  133. and the mode is portrait, PCPS decides that it can fit 18 characters on each
  134. line which works out well for the font Courier.  The spacing may vary to some
  135. extent with other fonts.  PCPS will wrap a line of text from an input file
  136. that is longer than the maximum number of characters unless -c (Cut) is
  137. specified.
  138.  
  139. 5. FONTS
  140. --------
  141.  
  142. The Apple Laserwriter has many fonts built into it and any of these pre-
  143. defined fonts are available for use with PCPS.  Listed below are the fonts
  144. and the code for each that can be used with the -f argument within PCPS:
  145.  
  146.    FontCode        Font
  147.    --------        ----
  148.  
  149.    AGB             AvantGarde-Book
  150.    AGBO            AvantGarde-BookOblique
  151.    AGD             AvanteGarde-Demi
  152.    AGDO            AvantGarde-DemiOblique
  153.    BD              Bookman-Demi
  154.    BDI             Bookman-DemiItalic
  155.    BL              Bookman-Light
  156.    BLI             Bookman-LightItalic
  157.    C               Courier
  158.    CB              Courier-Bold
  159.    CBO             Courier-BoldOblique
  160.    CO              Courier-Oblique
  161.    H               Helvetica
  162.    HB              Helvetica-Bold
  163.    HBO             Helvetica-BoldOblique
  164.    HN              Helvetica-Narrow
  165.    HNB             Helvetica-Narrow-Bold
  166.    HNBO            Helvetica-Narrow-BoldOblique
  167.    HNO             Helvetica-Narrow-Oblique
  168.    HO              Helvetica-Oblique
  169.    NCSB            NewCenturySchlbk-Bold
  170.    NCSBI           NewCenturySchlbk-BoldItalic
  171.    NCSI            NewCenturySchlbk-Italic
  172.    NCSR            NewCenturySchlbk-Roman
  173.    PB              Palatino-Bold
  174.    PBI             Palatino-BoldItalic
  175.    PI              Palatino-Italic
  176.    PR              Palatino-Roman
  177.    S               Symbol
  178.    TB              Times-Bold
  179.    TBI             Times-BoldItalic
  180.    TI              Times-Italic
  181.    TR              Times-Roman
  182.    ZCMI            ZapfChancery-MediumItalic
  183.    ZD              ZapfDingbats
  184.  
  185.  
  186. 6. HELP
  187. -------
  188.  
  189. A quick help screen is available within PCPS and it is activated by typing
  190. in either of the following commands or if you enter an invalid argument:
  191.  
  192. PCPS<cr>
  193. PCPS ?<cr>
  194.  
  195. 7. EXAMPLES OF USE
  196. ------------------
  197.  
  198. PCPS -l<cr>                      List all available fonts and their codes.
  199.  
  200. PCPS -dl -g HELP.DOC<cr>         This will read the file "HELP.DOC", convert
  201.                                  it to POSTSCRIPT*, put a gaudy banner at the
  202.                                  top of each page and output it to LPT2 in
  203.                                  normal page order, then delete HELP.DOC.
  204.  
  205. PCPS -i -b -m HELP.DOC<cr>       This will read the file "HELP.DOC", convert
  206.                                  it to POSTSCRIPT* and output it to LPT2 with
  207.                                  the pages in inverse order with no banner and
  208.                                  put the printer in manual feed mode such that
  209.                                  the user will have to feed the pages manually.
  210.  
  211. PCPS -b -pHELP.PS HELP.DOC<cr>   This will read the file "HELP.DOC", convert
  212.                                  it to POSTSCRIPT* and output it to a file
  213.                                  called "HELP.PS" in normal order with no
  214.                                  banner.
  215.  
  216. PCPS -i -f7 \UTILS\*.DOC<cr>     This will read all of the files under the
  217.                                  "UTILS" directory with an extension of
  218.                                  ".DOC", convert them to POSTSCRIPT* and
  219.                                  output them in inverse page order with a font
  220.                                  size of 7 to LPT2.  Each .DOC file will be
  221.                                  processed one at a time.
  222.  
  223. PCPS -# -2 -fhn *.C *.H<cr>      This will read all of the files in the
  224.                                  current directory with extensions of .C and
  225.                                  .H, and output them to LPT2: in landscape
  226.                                  mode with two columns, in the font Helvetica-
  227.                                  Narrow with 4 digit line numbers.
  228. 8. FUTURE
  229. ---------
  230.  
  231. Most features that I had planned to include in PCPS are now present in this
  232. version (5.33), however, I am open to input on any enhancements but cannot
  233. give any guarantees as to completion date of the enhanced routine.
  234.  
  235.                                                         Paul Carapetis.
  236. 9. SUPPORT
  237. ----------
  238.  
  239. Now you're asking a bit much for an in-house ditty!  If you have problems
  240. or find bugs in PCPS, contact:
  241.  
  242.         Paul Carapetis   MDC Facilities and Support, Melbourne X944
  243.  
  244.  
  245.  
  246. * POSTSCRIPT is a trademark of Adobe Systems Incorporated.
  247.