home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / GRAPHICS / PSCRIPT / PCPS702.ZIP / PCPS.DOC < prev    next >
Encoding:
Text File  |  1992-04-22  |  15.3 KB  |  357 lines

  1.                                 PCPS.EXE                            Version 7.02
  2.                                 --------          Copyright (c) 1992 MicroSource
  3.  
  4. 1. INTRODUCTION
  5. ---------------
  6.  
  7. PCPS is an executable program designed to run under MS-DOS or PC-DOS
  8. version 2.1 upwards.  The program will read in a normal DOS text file and
  9. produce POSTSCRIPT* output that can be directly printed on a POSTSCRIPT*
  10. compatible printer, in particular, the Apple Laserwriter.
  11.  
  12. 2. LICENSE
  13. ----------
  14.  
  15. Please read the file LICENSE.DOC for licensing information.
  16.  
  17.  
  18. 3. DESCRIPTION
  19. --------------
  20.  
  21. When executed, PCPS reads in one or more text files, converts them to
  22. POSTSCRIPT* and the outputs them either directly to a printer or optionally
  23. to a disk file.  Banner, orientation, fonts, font sizes, line handling, output
  24. format, output path and line numbering options may be specified.
  25.  
  26.  
  27. 4. USEAGE AND ARGUMENTS
  28. -----------------------
  29.  
  30. The format of the command is as follows:
  31.  
  32. PCPS [-args] file1 file2.....filen
  33.  
  34. If no arguments are specified the following defaults are true:
  35.  
  36.  1. Default output is to the second printer ie. LPT2
  37.  2. Default output page order is normal ie. first page first (this is for
  38.     laser printers that do sort the pages out for you.)
  39.  3. Default is non-gaudy banner ON ie. a banner containing the file name,
  40.     creation date and time and the POSTSCRIPT* page number will be printed
  41.     in bold at the top of each page.
  42.  4. Default font is Courier.
  43.  5. Default font sizes are: Portrait and 1 col Landscape - 10 point.
  44.                                          2 col Landscape - 7 point.
  45.  6. Default orientation is Portrait.
  46.  7. Default is to wrap long lines.
  47.  8. Default is to pass tab characters through as they are.
  48.  9. Default is to do page sorting in memory if there is enough free memory
  49.     for the operation
  50. 10. Default is no line numbers.
  51. 11. Default is not to delete input file after processing.
  52. 12. Default is for continuous paper feed (ie. Not Manual Feed)
  53.  
  54. 5. ARGUMENTS
  55. ------------
  56.  
  57.    -l           =>  List available font codes.  This should be used by itself
  58.                      (ie. PCPC -L) as anything else on the line will be ignored.
  59.   
  60.    -b           =>  Banner OFF (ie. Do not print a banner on each page).
  61.  
  62. *  -b-          =>  Enable Banner.
  63.  
  64. 5. ARGUMENTS (cont)
  65. ------------
  66.  
  67.    -c           =>  Truncate (Cut) lines longer than the maximum number of
  68.                      characters allowed for the current mode.
  69.  
  70. *  -c-          =>  Wrap long lines
  71.  
  72.    -dl          =>  Delete the input file after successful processing.  USE
  73.                      WITH CAUTION!  PCPS considers that if it receives no
  74.                      errors when processing the file, then it is printed.  On
  75.                      a network, however, the print job might get lost!
  76.  
  77. *  -dl-         =>  Do NOT delete the input file.
  78.  
  79.    -dm          =>  Switch off memory sorting - useful if, for some reason,
  80.                      PCPS reports a memory allocation error whilst processing
  81.                      your document.
  82.  
  83. *  -dm-         =>  Enable memory sorting
  84.  
  85.    -dr          =>  Enable draft mode whereby the word "DRAFT" is printed
  86.                      in grey on each page appearing to be behind the text.
  87.  
  88. *  -dr-         =>  Disable draft mode.
  89.  
  90.  -f<code><size> =>  Code of font to use followed by optional font size.
  91.                      Refer to section 7 or -l argument for a description of
  92.                      font codes.  The font size must be specified after the
  93.                      font code(if present) or if you wish just to alter the
  94.                      size and not the default font, -f<size> will be accepted.
  95.  
  96. *  -f-          =>  Use Courier font at the default point size for that mode.
  97.  
  98.    -g           =>  Print a gaudy banner at the top of the page containing
  99.                      the file last-modified date and time, the file name and
  100.                      the page number.  This argument is meaningless if "-b"
  101.                      (banner off) is specified.
  102.  
  103. *  -g-          =>  Use non-gaudy banner if banner is enabled.
  104.  
  105.    -i           =>  Inverse page order (ie. Output the last page first).
  106.  
  107. *  -i-          =>  Normal page order.
  108.  
  109.    -m           =>  Manual paper feed at printer - useful if you wish to use
  110.                      different paper than what is loaded into the paper tray.
  111.  
  112.    -m1          =>  Manual paper feed for the first page only - useful if the
  113.                      first page needs to be printed on letter head.
  114.  
  115. *  -m-          =>  Disable either manual feed mode.
  116.  
  117.    -o<path>     =>  Instead of output to LPT2, output to <path> where <path>
  118.                      can be the pathname of a file (eg. \bin\example.ps) or
  119.                      the name of another printer (eg. LPT1).
  120.                      **NB** This argument replaces "-p" from previous versions
  121.  
  122. *  -o-          =>  Use the default output file LPT2.
  123.  
  124. 5. ARGUMENTS (cont)
  125. ------------
  126.  
  127.    -p<path>     =>  Printer Preparation file pathname - the contents of this
  128.                      file are sent to the output file prior to the POSTSCRIPT*
  129.                      output of PCPS.  (See Section 6)
  130.  
  131.    -p-          =>  Do not use any Printer Preparation File (See Section 6)
  132.  
  133.    -q           =>  Quiet mode - no fancy information is displayed.  For each
  134.                      file processed, only the number of pages output is
  135.                      displayed.
  136.  
  137. *  -q-          =>  Noisy(?) mode with lots of information on the screen.
  138.  
  139.    -r           =>  Rotate the print 90 degrees (Landscape mode).  This mode
  140.                      allows lines up to 132 characters before it wraps or
  141.                      truncates.
  142.  
  143. *  -r-          =>  Use portrait orientation.
  144.  
  145.    -2           =>  Rotate the print 90 degrees and print in two columns with
  146.                      the smaller 7 point print.  This is a good mode to
  147.                      economize on paper.
  148.  
  149. *  -2-          =>  Use single column portrait orientation.
  150.  
  151.    -t[n]        =>  Expand tabs to tabstops.  If just -t is specified, tabs will
  152.                      be expanded to tabstops every 8 columns.  If a number (n)
  153.                      follows the -t, tabs will be expanded to tabstops every
  154.                      n columns.
  155.  
  156. *  -t-          =>  Pass through tabs untouched.
  157.  
  158.    -u[n]        =>  Unlimited (almost) line length or specify number of chars -
  159.                      PCPS, as a default, calculates a maximum line length based
  160.                      on the font size and paper orientation.  This calculation
  161.                      is performed assuming COURIER font (the only
  162.                      non-proportional font) and so is inaccurate when applied to
  163.                      other fonts.  The usual result of this is that it
  164.                      under-calculates how many characters will fit on the line.
  165.                      This switch is useful if you wish to over-ride the
  166.                      calculated line length.  The maximum line length will be
  167.                      set to 32767 chars or to "n" chars if specified.
  168.  
  169. *  -u-          =>  Use default calculated maximum line length.
  170.  
  171.    -#[n]        =>  Print line numbers.  If just -# specified, the line numbers
  172.                      default to 4 digits.  If a number (n) follows the -#, the
  173.                      line numbers will be set to that many digits (max 6).  If
  174.                      the line number count increases to greater than the current
  175.                      number of digits can handle, the digits will automatically
  176.                      be increased to compensate for this situation.
  177.  
  178. *  -#-          =>  Do NOT print line numbers.
  179.  
  180. All arguments indicated by "*" are the defaults for PCPS.
  181.  
  182. 5. ARGUMENTS (cont)
  183. ------------
  184.  
  185. Wild cards are permitted to be used for the input text files and more than
  186. one file may be specified.  The maximum number of characters per line is
  187. automatically calculated by PCPS based on the font Courier and the font
  188. size specified at invocation.  For example: if a font size of 48 is specified
  189. and the mode is portrait, PCPS decides that it can fit 18 characters on each
  190. line which works out well for the font Courier.  The spacing may vary to some
  191. extent with other fonts.  PCPS will wrap a line of text from an input file
  192. that is longer than the maximum number of characters unless -c (Cut) is
  193. specified.
  194.  
  195. 6. PCPS FILE AND SCREEN SUPPORT
  196. -------------------------------
  197.  
  198. PCPS now supports two optional files as follows:
  199.  
  200.        PCPS.CFG
  201.        --------
  202.  
  203.        This file can be used to store default arguments.  The arguments should
  204.        be entered into the file using the same syntax as the command line.  The
  205.        arguments can, however, be spread over as many lines within the file as
  206.        desired.
  207.        PCPS will look for this file under the current directory and, if it
  208.        doesn't find it there, will look inside the directory that PCPS was
  209.        executed from.  If not there, PCPS will check for the environment
  210.        variable PCPSCFG and look at the path that this variable points to.
  211.        This enables the user to have many different defaults in different
  212.        directories and a master if so desired.  The use of the environment
  213.        variable is intended for network users who load PCPS from a server but
  214.        wish to have a local PCPS.CFG file.
  215.        The arguments are read and processed from this file sequentially before
  216.        the command line arguments are processed and so are overidden by command
  217.        line arguments (apart from "-l").  Eg.  If "-b" is contained in the
  218.        PCPS.CFG but you wish to have a banner printed, you may include the
  219.        argument "-b-" on the command line.
  220.  
  221.  
  222.        PCPS.PPF
  223.        --------
  224.  
  225.        For those situations where it is desirable or necessary to first send
  226.        some preparation data to the printer before outputting the postscript
  227.        provided by PCPS, the user may place such data into a file of this name.
  228.        PCPS will look for this file in the same manner as for PCPS.CFG (ie. the
  229.        current directory first, the directory from which PCPS originated and
  230.        then the environment variable PCPSPPF).
  231.        If the user wishes to specify a PPF file other than the defaults as
  232.        above, the argument "-p<path>" is provided for this purpose.
  233.        In the circumstances where the user does not want ANY existing PPF file
  234.        sent to the output file, the "-p-" argument may be specified.
  235.  
  236. PCPS also supports different screen sizes (lines per screen) for long displays
  237. such as the fontcode list and the help screen.  The screen lines are read from
  238. the system area of memory and PCPS will automatically provide a "[more]"
  239. prompt at the end of each screen.  The user need only press the "q" key to quit
  240. or press any other key to have the next screen displayed.
  241.  
  242. 7. FONTS
  243. --------
  244.  
  245. The Apple Laserwriter has many fonts built into it and any of these pre-
  246. defined fonts are available for use with PCPS.  Listed below are the fonts
  247. and the code for each that can be used with the -f argument within PCPS:
  248.  
  249.    FontCode        Font
  250.    --------        ----
  251.  
  252.    AGB             AvantGarde-Book
  253.    AGBO            AvantGarde-BookOblique
  254.    AGD             AvanteGarde-Demi
  255.    AGDO            AvantGarde-DemiOblique
  256.    BD              Bookman-Demi
  257.    BDI             Bookman-DemiItalic
  258.    BL              Bookman-Light
  259.    BLI             Bookman-LightItalic
  260.    C               Courier
  261.    CB              Courier-Bold
  262.    CBO             Courier-BoldOblique
  263.    CO              Courier-Oblique
  264.    H               Helvetica
  265.    HB              Helvetica-Bold
  266.    HBO             Helvetica-BoldOblique
  267.    HN              Helvetica-Narrow
  268.    HNB             Helvetica-Narrow-Bold
  269.    HNBO            Helvetica-Narrow-BoldOblique
  270.    HNO             Helvetica-Narrow-Oblique
  271.    HO              Helvetica-Oblique
  272.    NCSB            NewCenturySchlbk-Bold
  273.    NCSBI           NewCenturySchlbk-BoldItalic
  274.    NCSI            NewCenturySchlbk-Italic
  275.    NCSR            NewCenturySchlbk-Roman
  276.    PB              Palatino-Bold
  277.    PBI             Palatino-BoldItalic
  278.    PI              Palatino-Italic
  279.    PR              Palatino-Roman
  280.    S               Symbol
  281.    TB              Times-Bold
  282.    TBI             Times-BoldItalic
  283.    TI              Times-Italic
  284.    TR              Times-Roman
  285.    ZCMI            ZapfChancery-MediumItalic
  286.    ZD              ZapfDingbats
  287.  
  288. PCPS now supports all of the european characters in all text fonts.
  289. (Eg. 0x80 through 0xa8)
  290.  
  291. 8. HELP
  292. -------
  293.  
  294. A quick help screen is available within PCPS and it is activated by typing
  295. in either of the following commands:
  296.  
  297.  
  298. PCPS<cr>
  299.  
  300. PCPS ?<cr>
  301.  
  302. 9. EXAMPLES OF USE
  303. ------------------
  304.  
  305. PCPS -l<cr>                      List all available fonts and their codes.
  306.  
  307. PCPS -dl -g HELP.DOC<cr>         This will read the file "HELP.DOC", convert
  308.                                  it to POSTSCRIPT*, put a gaudy banner at the
  309.                                  top of each page and output it to LPT2 in
  310.                                  normal page order, then delete HELP.DOC.
  311.  
  312. PCPS -i -b -m HELP.DOC<cr>       This will read the file "HELP.DOC", convert
  313.                                  it to POSTSCRIPT* and output it to LPT2 with
  314.                                  the pages in inverse order with no banner and
  315.                                  put the printer in manual feed mode such that
  316.                                  the user will have to feed the pages manually.
  317.  
  318. PCPS -b -oHELP.PS HELP.DOC<cr>   This will read the file "HELP.DOC", convert
  319.                                  it to POSTSCRIPT* and output it to a file
  320.                                  called "HELP.PS" in normal order with no
  321.                                  banner.
  322.  
  323. PCPS -i -f7 \UTILS\*.DOC<cr>     This will read all of the files under the
  324.                                  "UTILS" directory with an extension of
  325.                                  ".DOC", convert them to POSTSCRIPT* and
  326.                                  output them in inverse page order with a font
  327.                                  size of 7 to LPT2.  Each .DOC file will be
  328.                                  processed one at a time.
  329.  
  330. PCPS -# -2 -fhn -u85 *.C *.H<cr> This will read all of the files in the
  331.                                  current directory with extensions of .C and
  332.                                  .H, and output them to LPT2: in landscape
  333.                                  mode with two columns, in the font Helvetica-
  334.                                  Narrow with 4 digit line numbers and will wrap
  335.                                  any line >85 characters.
  336.  
  337. PCPS -p- -od:\temp\out.doc *.doc This will read all of the files in the current
  338.                                  directory with extensions of .DOC and output
  339.                                  them to the file D:\TEMP\OUT.DOC in normal
  340.                                  portrait orientation and all PPF files will be
  341.                                  ignored.
  342.  
  343. 10. FUTURE
  344. ----------
  345.  
  346. Enhancements are planned for the future - for these I ask you to be patient.
  347.                                                         Paul Carapetis.
  348.  
  349. 11. SUPPORT
  350. -----------
  351.  
  352. If you have problems with or find bugs in PCPS, please contact:
  353.  
  354.         Paul Carapetis:  Internet: pjc@melb.bull.oz.au
  355.  
  356. * POSTSCRIPT is a trademark of Adobe Systems Incorporated.
  357.