home *** CD-ROM | disk | FTP | other *** search
/ Share Gallery 1 / share_gal_1.zip / share_gal_1 / UT / UT183.ZIP / P4PS.DOC < prev    next >
Text File  |  1991-08-17  |  107KB  |  3,235 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                  PPPPP        44  44       PPPPP          SSS  
  21.                  PPPPPP       44  44       PPPPPP        SSSSS 
  22.                  PP   PP      44  44       PP   PP      SS   SS
  23.                  PP   PP      44  44       PP   PP      SS     
  24.                  PP   PP      44  44       PP   PP      SS     
  25.                  PPPPPP       4444444      PPPPPP        SSSSS 
  26.                  PPPPP        4444444      PPPPP         SSSSS 
  27.                  PP               44       PP                SS
  28.                  PP               44       PP                SS
  29.                  PP               44       PP           SS   SS
  30.                  PP               44       PP            SSSSS 
  31.                  PP               44       PP             SSS  
  32.  
  33.  
  34.                              "Print for PostScript"
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                           Version 2.00  of  August 1991
  42.  
  43.  
  44.                           Robert K. Blaine / ECONO-SOFT
  45.                                  P.O. Box 181030
  46.                               Austin, TX 78718-1030
  47.                             512-832-1675, 800-367-7590
  48.  
  49.  
  50.                             CompuServe   [73267,1664]
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                               DISCLAIMER OF WARRANTY
  74.  
  75.        THIS SOFTWARE AND MANUAL ARE SOLD "AS IS" AND WITHOUT WARRANTIES AS
  76.        TO PERFORMANCE OF MERCHANTABILITY OR ANY  OTHER  WARRANTIES WHETHER
  77.        EXPRESSED OR IMPLIED.  IN NO EVENT SHALL ECONO-SOFT  OR  ROBERT  K.
  78.        BLAINE  BE  HELD  LIABLE  FOR  ANY  LOSS  OF  PROFIT  OR ANY  OTHER
  79.        COMMERCIAL DAMAGE RESULTING FROM THE USE OR MISUSE OF THIS PRODUCT,
  80.        INCLUDING BUT NOT LIMITED TO SPECIAL, INCIDENTAL,  CONSEQUENTIAL OR
  81.        OTHER DAMAGES.
  82.  
  83.        BECAUSE OF THE  VARIOUS  HARDWARE  AND  SOFTWARE  ENVIRONMENTS INTO
  84.        WHICH  THIS  PROGRAM  MAY  BE  PUT,  NO  WARRANTY  OF FITNESS FOR A
  85.        PARTICULAR PURPOSE IS OFFERED. THE USER MUST ASSUME THE ENTIRE RISK
  86.        OF USING THE PROGRAM.  ANY LIABILITY OF THE SELLER WILL  BE LIMITED
  87.        EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE.
  88.  
  89.  
  90.        Throughout this document,  references  are  made  to  the following
  91.        trademarks and copyrights:
  92.  
  93.            o  Ami  Pro  and  Lotus  Manuscript  are  trademarks  of  Lotus
  94.               Development Corporation.
  95.                                     TM
  96.            o  DX, DIRECTORY EXTENDED  , and P4PS are trademarks  of Robert
  97.               K. Blaine/ECONO-SOFT.
  98.  
  99.            o  GEM is a trademark of Digital Research, Inc.
  100.  
  101.            o  IBM  and  PC-DOS are trademarks  of  International  Business
  102.               Machines Corporation.
  103.  
  104.            o  LaserZ is a copyright of DMP Software.
  105.  
  106.            o  MS-DOS, MicroSoft Windows, and MicroSoft Word are trademarks
  107.               of MicroSoft Corporation.
  108.  
  109.            o  PostScript is a trademark of Adobe Systems Incorporated.
  110.  
  111.            o  Sprint is a trademark of Borland International, Inc.
  112.  
  113.            o  Ventura Publisher is a trademark of Ventura Software, Inc.
  114.  
  115.            o  WordStar   is  a   trademark   of   MicroPro   International
  116.               Corporation.
  117.  
  118.            o  WordPerfect is a trademark of WordPerfect Corporation.
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144.  
  145.                             C O N T E N T S
  146.  
  147.  
  148.           1.0  Introduction  . . . . . . . . . . . . . . . . . . . . . . 1
  149.              1.1  Feature Summary  . . . . . . . . . . . . . . . . . . . 1
  150.              1.2  Installation . . . . . . . . . . . . . . . . . . . . . 3
  151.              1.3  Printing the Documentation . . . . . . . . . . . . . . 4
  152.              1.4  The ShareWare Concept -- P4PS IS NOT FREE! . . . . . . 5
  153.              1.5  General Syntax . . . . . . . . . . . . . . . . . . . . 6
  154.              1.6  File Specifications  . . . . . . . . . . . . . . . . . 7
  155.              1.7  Switch Specifications  . . . . . . . . . . . . . . . . 7
  156.              1.8  System Requirements  . . . . . . . . . . . . . . . . . 8
  157.           2.0  Handling PostScript Input Files . . . . . . . . . . . . . 9
  158.              2.1  P4PS and Ami Pro v1.2 and v2.0 . . . . . . . . . . .  10
  159.              2.2  P4PS and Lotus Manuscript R2 . . . . . . . . . . . .  10
  160.              2.3  P4PS and MicroSoft Windows . . . . . . . . . . . . .  10
  161.              2.4  P4PS and MicroSoft Word  . . . . . . . . . . . . . .  11
  162.              2.5  P4PS and Sprint v1.0 . . . . . . . . . . . . . . . .  11
  163.              2.6  P4PS and Ventura Publisher v2.0  . . . . . . . . . .  11
  164.              2.7  P4PS and WordPerfect v5.0 and v5.1 . . . . . . . . .  12
  165.              2.8  P4PS and WordStar v5.5 . . . . . . . . . . . . . . .  12
  166.           3.0  File Handling Options . . . . . . . . . . . . . . . . .  13
  167.              3.1  /Booklet -- Automatic Booklet Generation . . . . . .  13
  168.              3.2  /Copies -- Multiple Copies of Each File  . . . . . .  14
  169.              3.3  /FOnt -- Specify Which Font to Use . . . . . . . . .  14
  170.              3.4  /Mode -- PostScript vs. ASCII  . . . . . . . . . . .  14
  171.              3.5  Moving the Table of Contents . . . . . . . . . . . .  15
  172.              3.6  /Pages -- Specify a Page Range . . . . . . . . . . .  17
  173.              3.7  /UCopies -- Uncollated Copies of Each Page . . . . .  17
  174.           4.0  Output Control Options  . . . . . . . . . . . . . . . .  18
  175.              4.1  /Feed -- Paper Handling Options  . . . . . . . . . .  18
  176.              4.2  /Output -- Where to Send the Output  . . . . . . . .  19
  177.           5.0  Formatting Options  . . . . . . . . . . . . . . . . . .  20
  178.              5.1  /ACross -- Layout Virtual Pages Across the Sheet . .  20
  179.              5.2  /BORder -- Selecting the Border Style  . . . . . . .  20
  180.              5.3  /COlumns -- Specify Characters Per Line  . . . . . .  20
  181.              5.4  Headings -- Displaying Page Headings . . . . . . . .  20
  182.                 5.4.1  Header Macros . . . . . . . . . . . . . . . . .  21
  183.                 5.4.2  /PHeader -- Physical Page Heading . . . . . . .  22
  184.                 5.4.3  /VHeader -- Virtual Page Heading  . . . . . . .  22
  185.                 5.4.4  Date/Time -- Controlling the Date/Time Format .  23
  186.              5.5  /Npages -- Virtual Pages Per Page  . . . . . . . . .  24
  187.              5.6  /NUmber -- Print Line Numbers  . . . . . . . . . . .  25
  188.              5.7  /ORient -- Landscape or Portrait . . . . . . . . . .  25
  189.              5.8  /PAPer -- Select Paper Style . . . . . . . . . . . .  26
  190.              5.9  /PMargins -- Specify the Physical Page Margins . . .  26
  191.              5.10  /SPread -- Specify Page Spread  . . . . . . . . . .  26
  192.              5.11  /TAbsize -- Setting Tab Expansion Size  . . . . . .  27
  193.  
  194.  
  195.                                         i
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.              5.12  /Truncate -- Truncate or Wrap Long Lines  . . . . .  27
  206.           6.0  Customization . . . . . . . . . . . . . . . . . . . . .  28
  207.              6.1  /CLone -- Cloning Options Into P4PS.EXE  . . . . . .  28
  208.              6.2  DOS SET Command  . . . . . . . . . . . . . . . . . .  28
  209.           7.0  Using P4PS  . . . . . . . . . . . . . . . . . . . . . .  30
  210.                                     TM
  211.              7.1  DIRECTORY EXTENDED   and P4PS  . . . . . . . . . . .  30
  212.                                          TM
  213.                 7.1.1  DIRECTORY EXTENDED   -- Feature Summary . . . .  31
  214.              7.2  /TImeout -- Setting Printer Timeouts . . . . . . . .  33
  215.              7.3  /NETaccess -- Handling Network Conflicts . . . . . .  34
  216.              7.4  Usage Tips . . . . . . . . . . . . . . . . . . . . .  34
  217.              7.5  Future Enhancements  . . . . . . . . . . . . . . . .  35
  218.  
  219.        Appendix A.  Quick Reference                                     37
  220.  
  221.        Appendix B.  Registration Form                                   41
  222.  
  223.        Index                                                            43
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                        ii
  262.  
  263.  
  264.  
  265.  
  266.  
  267.        Version 2.00                                                   P4PS
  268.  
  269.  
  270.  
  271.  
  272.  
  273.        1.0  Introduction
  274.  
  275.  
  276.        Print for PostScript (P4PS) is a program designed  to  maximize the
  277.        use  of  your  PostScript  printer.  Whether  you  print  booklets,
  278.        manuals, spreadsheets, long program listings, or small  text files,
  279.        P4PS will help you  save  money,  expedite  your task, and conserve
  280.        paper!
  281.  
  282.        If  you are a publisher or author  who  produces  printed  manuals,
  283.        manuscripts,  booklets,  or  newsletters,  P4PS can accommodate the
  284.        task  with  Automatic  Booklet  Generation! This task traditionally
  285.        involves laying out pages manually -- side-by-side --  so  that the
  286.        last even page is next to the first odd page,  the  second odd page
  287.        is next  to the second-to-last even page, etc.; then photo-reducing
  288.        them to produce the 2-up  (side-by-side)  copy  master.  P4PS saves
  289.        this  costly,  time-consuming,  and  error-prone step producing the
  290.        properly collated, copy master directly.
  291.  
  292.        P4PS will save you paper (and money) when printing large amounts of
  293.        text by printing anywhere from one to 64 virtual pages on each side
  294.        of a physical  sheet  of  paper  -- in either Landscape or Portrait
  295.        orientation. Each page is  printed  with  an  attractive (optional)
  296.        drop shadow effect.  Obviously,  when  you  get up to 64 images per
  297.        sheet, the output is not very readable, but  it  does  give  you an
  298.        excellent preview of the  page  layout of a document. The output is
  299.        very readable up through 8 images per sheet.
  300.  
  301.        P4PS can handle pure ASCII  files and PostScript files generated by
  302.        many  popular  word  processors   and   other   applications.  More
  303.        applications are being added constantly. If P4PS does not currently
  304.        work  with  PostScript  generated  by   your   word   processor  or
  305.        application, contact ECONO-SOFT.
  306.  
  307.        When  P4PS  processes  PostScript input files, the page image is an
  308.        exact reproduction  of  the  PostScript  input  --  simply rotated,
  309.        scaled, and repositioned on the  page.  When  handling  ASCII input
  310.        files, P4PS selects  an  11.7  point  (a  "point" is one 72nd of an
  311.        inch), fixed pitch Courier font  which normally yields 66 lines per
  312.        page  at  80  characters  per  line.  Although  a  12 point font is
  313.        normally thought of  as  standard, most PostScript printers are not
  314.        capable  of  printing  right up to the edge of the page. Add P4PS's
  315.        (optional) drop shadow border and a 12 point font is too large.
  316.  
  317.  
  318.  
  319.             1.1  Feature Summary
  320.  
  321.                 o  Prints multiple pure ASCII  or  PostScript  files  to a
  322.                    PostScript  printer with an attractive (optional)  drop
  323.                    shadow.
  324.  
  325.  
  326.  
  327.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT              Page 1
  328.  
  329.  
  330.  
  331.  
  332.  
  333.        P4PS                                                   Version 2.00
  334.  
  335.  
  336.  
  337.                 o  Automatic  Booklet  Generation!   2-up  (side-by-side),
  338.                    properly  collated,  1  or  2  sided  output  ready  to
  339.                    staple/bind into booklets.
  340.  
  341.                 o  Prints  anywhere  from  one  to  64  virtual  pages per
  342.                    physical  sheet  of  paper  in  Landscape  or  Portrait
  343.                    orientation.
  344.  
  345.                 o  Handles  up  to  255  columns  per  line  -- great  for
  346.                    spreadsheets.
  347.  
  348.                 o  Control physical and  virtual page headers using macros
  349.                    to  determine  exactly  what  information  is  printed;
  350.                    determine the exact format of date displays.
  351.  
  352.                 o  Output to any DOS device or file specification.
  353.  
  354.                 o  Print multiple copies of each file.
  355.  
  356.                 o  Select a range of pages instead of the entire document.
  357.  
  358.                 o  Select continuous or manual, one or two pass printing.
  359.  
  360.                 o  Layout virtual pages across or down the physical page.
  361.  
  362.                 o  Specify physical page margins  and  the  spread between
  363.                    virtual pages.
  364.  
  365.                 o  Specify  what to do when a file  is  interlocked  on  a
  366.                    network  --  including  waiting   for   it   to  become
  367.                    available.
  368.  
  369.                 o  With ASCII files, you can truncate instead of wrap long
  370.                    lines, print  optional line numbers to the left of each
  371.                    line, and select tab sizes.
  372.  
  373.                 o  Self-cloning  --  allows  you  to write default options
  374.                    directly  into  P4PS.EXE  --  creating  any  number  of
  375.                    customized versions.
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.        Page 2                                         1.1  Feature Summary
  394.  
  395.  
  396.  
  397.  
  398.  
  399.        Version 2.00                                                   P4PS
  400.  
  401.  
  402.  
  403.             1.2  Installation
  404.  
  405.             The following files are part of the P4PS package:
  406.  
  407.                 P4PS.EXE                 => The program itself.
  408.  
  409.                 P4PS.DOC                 => This document in ASCII form.
  410.  
  411.                 P4PS_REG.EXE             => A program to "register"
  412.                                             P4PS.EXE.
  413.  
  414.                 READ.ME                  => Last minute information.
  415.  
  416.                 ORDER.FRM                => A convenient order form.
  417.  
  418.                 LICENSE.FRM              => Information on site licenses
  419.                                             and sample form.
  420.  
  421.             Installing the non-registered  P4PS  is simple: copy it to any
  422.             directory along your DOS PATH.
  423.  
  424.             A non-registered P4PS.EXE will periodically display a reminder
  425.             message requesting registration. This message is driven off of
  426.             a random number generator and should  appear  approximately 5%
  427.             of the time  (your  mileage  may  vary).  The  message  may be
  428.             cleared  by  hitting  a  key.  After  60  seconds,  P4PS  will
  429.             automatically continue --  allowing unattended use during your
  430.             evaluation.
  431.  
  432.             As shipped from ECONO-SOFT, P4PS.EXE is  not  registered. This
  433.             is  so  you  may  pass  copies  around  to  your  friends  and
  434.             associates. The P4PS_REG.EXE program is used to  copy P4PS.EXE
  435.             to another disk/directory and register the copied  program. If
  436.             you received a  disk  from  ECONO-SOFT,  P4PS_REG.EXE  will be
  437.             pre-registered with your name  and  will  copy and insert your
  438.             name  in  P4PS.EXE.  If you downloaded the P4PS package from a
  439.             bulletin board, P4PS_REG.EXE will not be pre-registered.
  440.  
  441.             If you register with ECONO-SOFT by phone or through electronic
  442.             mail,  you will receive your customer  number  and  an  encode
  443.             number directly. P4PS_REG.EXE will then  be  able  to register
  444.             your copy using these numbers. Regardless of how you register,
  445.             once you've registered, a distribution disk and manual will be
  446.             mailed to you containing a pre-registered P4PS_REG.EXE.
  447.  
  448.             See section 6 for complete information on customizing P4PS.
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT              Page 3
  460.  
  461.  
  462.  
  463.  
  464.  
  465.        P4PS                                                   Version 2.00
  466.  
  467.  
  468.  
  469.             1.3  Printing the Documentation
  470.  
  471.             The best way to get  introduced  to  P4PS,  is  to  see  it in
  472.             action! To print  this  document  as  a booklet in 2 passes on
  473.             your PostScript printer, enter the command:
  474.  
  475.                  p4ps p4ps.doc /booklet /feed:2pass
  476.  
  477.             or, if your printer is not on the Standard DOS  Printer Device
  478.             (PRN),  specify  the  device  on  the  "/Output"  switch.  For
  479.             example, if your PostScript printer is on COM1, enter:
  480.  
  481.                  p4ps /o:com1 p4ps.doc /b /f:2p
  482.  
  483.             When  the  first  pass  is  complete, P4PS will prompt you  to
  484.             reinsert the paper  so  that  it  can print the other side. On
  485.             most PostScript Laser  printers  -- where the output comes out
  486.             of the top bin upside down -- this involves rotating the paper
  487.             180 degrees (front edge to back) and not flipping them over as
  488.             you place the paper back in the paper tray.  If  your  printer
  489.             has a flat paper  path  -- where the output probably comes out
  490.             of the back face up, use "/Feed:2PFlat" instead. In this case,
  491.             do not rotate the paper as you reinsert it;  simply  flip  the
  492.             stack side-to-side:
  493.  
  494.                  p4ps /o:com1 p4ps.doc /b /f:2pf
  495.  
  496.             Please  make  sure  you've waited for all  pages  to  complete
  497.             printing!  P4PS  indicates  how  many  pages  you   should  be
  498.             reloading in the prompt to reload. On many  laser  printers, a
  499.             light  will  double  blink or a "wait" indicator will light to
  500.             tell you when  the  printer is awaiting more input. Sometimes,
  501.             with very complicated  PostScript  pages,  it  may  take 30-60
  502.             seconds  for  that last page to come  out.  Also,  it  is  not
  503.             uncommon with slower PostScript printers,  to  get  Device Not
  504.             Ready errors -- just hit 'R' for retry.
  505.  
  506.             Alternatively, If you'd like to  save paper and not print this
  507.             document  in booklet form, use the  "/Npages"  switch  with  a
  508.             value anywhere from one to 64  in  powers  of two (1, 2, 4, 8,
  509.             16, 32, or 64). For example, to print the document 8 pages per
  510.             sheet in a landscape mode, use:
  511.  
  512.                  p4ps /np:8 p4ps.doc
  513.  
  514.             The default  for  "/NPages"  is  4.  If  you'd like to print 4
  515.             images per sheet in 2 passes:
  516.  
  517.                  p4ps /f:2p p4ps.doc
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.        Page 4                              1.3  Printing the Documentation
  526.  
  527.  
  528.  
  529.  
  530.  
  531.        Version 2.00                                                   P4PS
  532.  
  533.  
  534.  
  535.             Note that  this document, as supplied on diskette, contains no
  536.             PostScript language elements. This is to allow you to print it
  537.             on any printer. The printed manual is generated from this same
  538.             document as a PostScript file and processed by  P4PS.  You may
  539.             print this document on any printer with:
  540.  
  541.                  print p4ps.doc
  542.  
  543.                  - or -
  544.  
  545.                  copy p4ps.doc prn
  546.  
  547.  
  548.  
  549.             1.4  The ShareWare Concept -- P4PS IS NOT FREE!
  550.  
  551.             P4PS is ShareWare and, as such, is dependent  on  user support
  552.             for ongoing development.  Please support the ShareWare concept
  553.             by registering and  paying  for software that you find useful.
  554.             Please observe a  two  week evaluation period after which time
  555.             you should register or  discontinue  use  of P4PS. Whether you
  556.             find  use  for  P4PS or not, please pass it on to your friends
  557.             and associates.
  558.  
  559.             The disk file, ORDER.FRM, or Appendix B of this manual  may be
  560.             used for  registration and ordering. A 15% discount is offered
  561.             when  ordering two or more ECONO-SOFT  products  at  the  same
  562.             time. Please address all registrations and correspondence to:
  563.  
  564.                  ECONO-SOFT                        CompuServe [73267,1664]
  565.                  P.O. Box 181030       InterNet: 73267.1664@CompuServe.COM
  566.                  Austin, TX 78718-1030          512-832-1675, 800-367-7590
  567.  
  568.                  Registration:           $49.95 (includes printed manual).
  569.                  Postage:        $10 on international orders (free in US).
  570.                  Texas residents:                 Please add 8% sales tax.
  571.                  MasterCard and Visa accepted; include expiration date.
  572.  
  573.             ECONO-SOFT has  a 30-day, no questions asked, return policy so
  574.             you may try a fully registered version at no risk.
  575.  
  576.             See the file LICENSE.FRM for a sample site license agreement.
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT              Page 5
  592.  
  593.  
  594.  
  595.  
  596.  
  597.        P4PS                                                   Version 2.00
  598.  
  599.  
  600.  
  601.                _______                        ECONO-SOFT  is  a  member of
  602.           ____|__     |               (tm)    the Association of Shareware
  603.        --|       |    |-------------------    Professionals   (ASP).   ASP
  604.          |   ____|__  |  Association of       wants to make sure that  the
  605.          |  |       |_|  Shareware            shareware   principle  works
  606.          |__|   o   |    Professionals        for you. If  you  are unable
  607.        -----|   |   |---------------------    to   resolve  a   shareware-
  608.             |___|___|    MEMBER               related  problem  with    an
  609.                                               ASP   member  by  contacting
  610.             the  member  directly,  ASP  may  be  able  to help.  The  ASP
  611.             Ombudsman  can  help  you resolve a dispute or problem with an
  612.             ASP  member,  but  does  not  provide  technical  support  for
  613.             members' products. Please  write  to the ASP Ombudsman at P.O.
  614.             Box 5786, Bellevue, WA 98006 or send a CompuServe mail message
  615.             to ASP Ombudsman [70007,3536].
  616.  
  617.  
  618.  
  619.             1.5  General Syntax
  620.  
  621.             P4PS's command format complies with the original  DOS standard
  622.             -- i.e. the standard that DOS was modeled  after.  The problem
  623.             in the PC  community  is  that  everyone has a better idea for
  624.             program  syntax so there really are  no  standards.  The  P4PS
  625.             syntax conforms to that used  by all DOS utilities. The format
  626.             is  shown  below  and  then  explained.  Items  within  square
  627.             brackets  are  optional,  items  within  curly  braces  may be
  628.             repeated any number of times,  and  a  vertical  bar indicates
  629.             that you should pick one of the options separated by the bar:
  630.  
  631.                  P4PS [/switch {/switch}] [filespec {filespec}]
  632.  
  633.             The syntax for a switch designation is as follows:
  634.  
  635.                  switch ::= /name[-|:[-]value[:value]|=[-]value[:value]]
  636.  
  637.             Now what does that  mean  to the average user? There are three
  638.             major parts to the command line. The first is  the  name  (and
  639.             possibly the drive and path)  where DOS should load P4PS from.
  640.             The second part consists  of  option  selections and the third
  641.             part consists of file  specifications.  Option  selections are
  642.             done via switches.
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.        Page 6              1.4  The ShareWare Concept -- P4PS IS NOT FREE!
  658.  
  659.  
  660.  
  661.  
  662.  
  663.        Version 2.00                                                   P4PS
  664.  
  665.  
  666.  
  667.             1.6  File Specifications
  668.  
  669.             The  file  specifications   conform  to  normal  DOS  wildcard
  670.             conventions.  There may be multiple file specifications.  (See
  671.             section 7.1  for hints on using P4PS with ECONO-SOFT's popular
  672.             command-oriented   directory   and   file  manager,  DIRECTORY
  673.                     TM
  674.             EXTENDED  ). For example, to print  all  "*.H"  and  all "*.C"
  675.             files:
  676.  
  677.                  p4ps *.h *.c
  678.  
  679.             The special file name,  "STDIN",  may be used to cause P4PS to
  680.             read from DOS STDIN  thus  allowing  piping  another program's
  681.             output to P4PS as in:
  682.  
  683.                  myprog | p4ps stdin
  684.  
  685.             If  P4PS  has to prescan your file,  the  file  must  be  disk
  686.             resident -- this includes booklet and  2-pass  processing, and
  687.             all PostScript input files.
  688.  
  689.             Throughout this document,  switch  names  are  shown  in mixed
  690.             upper/lower case. The portion  in  upper  case  represents the
  691.             minimum abbreviation. For example, the "/CLone" switch  may be
  692.             given as "/CLONE", "/CLO", and  "/CL", but not "/C" since that
  693.             is a valid abbreviation for the "/Copies" switch.
  694.  
  695.  
  696.             1.7  Switch Specifications
  697.  
  698.             Switches may be specified either  after  the  command  name or
  699.             after the file  specification.  There  may  be  spaces between
  700.             switches, after the command name, and between a switch and the
  701.             file specification. There may  not  be  any spaces between the
  702.             '/' that starts  the  switch,  the  name of the switch, or any
  703.             values associated with that switch.
  704.  
  705.             In general a switch is either on or off, and  may  have one or
  706.             two values associated with it. Let's use "SW" as the name of a
  707.             sample switch. The notation "/SW" will turn the switch on, and
  708.             "/SW-" will  turn the switch off. "/SW:value" supplies a value
  709.             to the switch and  "/SW:value:value"  supplies  two  values. A
  710.             switch value may be  a  single  character  option, a string, a
  711.             number, a keyword, or a  complete  file  specification. String
  712.             values are enclosed in either  single  or  double  quotes. For
  713.             each switch discussed  in  this  documentation,  the  types of
  714.             values  and  their  defaults  are  given. The '=' may be  used
  715.             instead of ':' to assign values to a switch as  in "/SW=value"
  716.             or "/SW=value:value" (this  format  is not possible on the DOS
  717.             SET Command -- see section 6).
  718.  
  719.  
  720.  
  721.  
  722.  
  723.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT              Page 7
  724.  
  725.  
  726.  
  727.  
  728.  
  729.        P4PS                                                   Version 2.00
  730.  
  731.  
  732.  
  733.             DOS limits the length of a command line to 127  characters. If
  734.             you need more room to enter your commands to P4PS,  simply end
  735.             the  current  line  with a comma (','); P4PS will then solicit
  736.             continuation  lines. P4PS limits the total file  specification
  737.             pattern and the total switch specification  to  255 characters
  738.             each -- of course, they can be intermixed.
  739.  
  740.  
  741.  
  742.             1.8  System Requirements
  743.  
  744.                 o  Any IBM PC family or PS/2 or compatible.
  745.  
  746.                 o  About  70k  above  that used by DOS  and  any  resident
  747.                    software.
  748.  
  749.                 o  Any DOS compatible monitor.
  750.  
  751.                 o  An Adobe PostScript compatible  output  device  -- does
  752.                    not have to be physically connected to the PC.
  753.  
  754.                 o  MS/PC-DOS 2.x, 3.x, 4.x, or 5.x.
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.        Page 8                                     1.8  System Requirements
  790.  
  791.  
  792.  
  793.  
  794.  
  795.        Version 2.00                                                   P4PS
  796.  
  797.  
  798.  
  799.  
  800.  
  801.        2.0  Handling PostScript Input Files
  802.  
  803.  
  804.        P4PS is capable of  handling  any  pure  ASCII files and PostScript
  805.        input  files  generated  by  many  popular   word   processors  and
  806.        applications. A little explanation  of  PostScript  is  probably in
  807.        order.  PostScript  is  a page definition language. Files sent to a
  808.        PostScript device are actually programs written in  PostScript. The
  809.        language is very powerful and extremely flexible.
  810.  
  811.        Adobe designed  PostScript with the idea that other programs should
  812.        be  able to manipulate a PostScript  program  to  achieve  specific
  813.        results. To  this end, Adobe specified a commenting convention that
  814.        should be followed in design and layout of a PostScript program.
  815.  
  816.        If all word processors  and  applications  followed  the commenting
  817.        convention,  P4PS  would  probably  work  with all of them with  no
  818.        modification.  Alas, many applications outputing PostScript do  not
  819.        follow the  commenting conventions. Because of this, in many cases,
  820.        P4PS has to  be  customized  to  recognize the page boundaries in a
  821.        particular application's flavor of PostScript.
  822.  
  823.        It  is ECONO-SOFT's desire to support  all  major  applications  --
  824.        several are supported in  this  release. We will be adding more and
  825.        more constantly. If P4PS does  not  work  with  your applications's
  826.        PostScript output, please follow these steps:
  827.  
  828.           1.  In the case of a word processor, isolate a small (5-20 page)
  829.               document  that  contains  nonsensitive data and, preferably,
  830.               contains a  table  of  contents.  With  non-word  processing
  831.               applications,  a  one  or  two  page  document  may be  more
  832.               appropriate.
  833.  
  834.           2.  Have your application print to  a  disk  file  in PostScript
  835.               format (consult your application's manual for information on
  836.               how to do this).
  837.  
  838.           3.  Send this file to ECONO-SOFT on a diskette or via CompuServe
  839.               (binary) electronic mail (see section 1.4 for  our address).
  840.               ECONO-SOFT   can   handle   5.25''/360KB,  3.5''/720KB,  and
  841.               3.5''/1.44KB  diskettes.  Be  sure  to  include  your  name,
  842.               address,  phone   number,   electronic   mail   address  (if
  843.               applicable), and customer number (if known).
  844.  
  845.           4.  We will make P4PS work with your application and send  you a
  846.               complimentary upgrade or, if not possible  for  some reason,
  847.               offer you a refund.
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT              Page 9
  856.  
  857.  
  858.  
  859.  
  860.  
  861.        P4PS                                                   Version 2.00
  862.  
  863.  
  864.  
  865.        The following sections discuss the currently supported applications
  866.        and any  special considerations. Check the READ.ME file for further
  867.        developments.  (For complete  information  on  booklet  generation,
  868.        table of  contents movement, and file recognition see sections 3.1,
  869.        3.5, and 3.4 respectively.)
  870.  
  871.  
  872.  
  873.             2.1  P4PS and Ami Pro v1.2 and v2.0
  874.  
  875.             Ami Pro uses MicroSoft Windows 3.0's PostScript Printer Driver
  876.             (PSCRIPT)   v3.4  which  conforms  to  the  Adobe   commenting
  877.             conventions. Use:
  878.  
  879.                  p4ps mydoc.prn /booklet
  880.  
  881.             For non-booklet processing, omit the "/Booklet" switch.
  882.  
  883.             Ami Pro prints the table of contents (TOC) at the beginning of
  884.             the document. An option will be added to P4PS very  shortly to
  885.             correctly move this TOC.
  886.  
  887.  
  888.  
  889.             2.2  P4PS and Lotus Manuscript R2
  890.  
  891.             Lotus  Manuscript  generates  Adobe-conformant  comments   and
  892.             identifies the table  of  contents  (TOC)  with  comments that
  893.             contain the word "Contents".  To  generate  a booklet and move
  894.             the TOC to page 3 in the final document, output  your document
  895.             to disk and use (see section 3.5 for  complete  information on
  896.             moving the TOC):
  897.  
  898.                  p4ps mydoc.prn /tocfr:contents /tocto:3 /booklet
  899.  
  900.             For  non-booklet  processing,  omit  the  "/Booklet"  and  TOC
  901.             switches.
  902.  
  903.  
  904.  
  905.             2.3  P4PS and MicroSoft Windows
  906.  
  907.             Although not yet  verified,  P4PS should have no problems with
  908.             any documents generated by MicroSoft Windows v3.0's PostScript
  909.             Printer Driver (PSCRIPT) v3.4 -- this should include MicroSoft
  910.             Word for Windows.
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.        Page 10                         2.1  P4PS and Ami Pro v1.2 and v2.0
  922.  
  923.  
  924.  
  925.  
  926.  
  927.        Version 2.00                                                   P4PS
  928.  
  929.  
  930.  
  931.             2.4  P4PS and MicroSoft Word
  932.  
  933.             Although not yet  verified,  P4PS should have no problems with
  934.             MicroSoft  Word  for  Windows  and,  if  recent   versions  of
  935.             MicroSoft  Word  (non-windows)  use  a similar printer driver,
  936.             they should  work as well. MicroSoft Word v3.0 definitely does
  937.             not conform to the Adobe  commenting  conventions  and  is not
  938.             currently supported.
  939.  
  940.  
  941.  
  942.             2.5  P4PS and Sprint v1.0
  943.  
  944.             Sprint generates comments that  generally  conform  to Adobe's
  945.             convention. The only thing lacking  is a good way to determine
  946.             the start of the table of contents (TOC). To move  the Sprint-
  947.             generated  TOC   to  page  3  in  the  final  document,  print
  948.             PostScript to disk and use:
  949.  
  950.                  p4ps /tocfr:1 /tocto:3 mydoc.prn /booklet
  951.  
  952.             For non-booklet processing, omit the "/Booklet" switch.
  953.  
  954.             Sprint  places the TOC at the end of  the  document  and  only
  955.             generates the exact number of  pages needed to display the TOC
  956.             (see section  3.5 for complete TOC information). It is usually
  957.             desirable to force the TOC to  be  an even number of pages and
  958.             P4PS will generate a  blank  page  if  needed. However, if you
  959.             would prefer that  blank  page to have the appropriate headers
  960.             and footers, a simple  change  to  Sprint's  STANDARD.FMT file
  961.             will facilitate this. Locate and  change  the  "TOC"  macro to
  962.             contain the phrase:
  963.  
  964.                  beforeexit "@if(page&1,"@newpage")"
  965.  
  966.             making the complete macro look something like:
  967.  
  968.                       @Define(TOC, before, justify no, margins .5in,
  969.                          beforeexit "@if(page&1,"@newpage")", initialize "
  970.                          @string(pfo="@=@ref(page,template'%i')", pfe=pfo,
  971.                          pff=pfo)@string(pho="", phe=pho, phf=pho)
  972.                          @string(sectiontitle="Contents",
  973.                          chaptertitle=sectiontitle)
  974.                          @BigCenteredHead(Contents)@TabSet(3,6,9,12)")
  975.  
  976.  
  977.  
  978.             2.6  P4PS and Ventura Publisher v2.0
  979.  
  980.             Ventura Publisher does not conform to Adobe's conventions, but
  981.             P4PS  can handle its output. In some  cases,  the  image  size
  982.             within the virtual page is not correct and the /VPScale switch
  983.             may be used to adjust the output. Table  of  contents movement
  984.             is not currently supported:
  985.  
  986.  
  987.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 11
  988.  
  989.  
  990.  
  991.  
  992.  
  993.        P4PS                                                   Version 2.00
  994.  
  995.  
  996.  
  997.                  p4ps mydoc.prn /booklet
  998.  
  999.             For non-booklet processing, omit the "/Booklet" switch.
  1000.  
  1001.             If you need to adjust the image area,  specify  the percentage
  1002.             of  shrinkage or growth as integral  values  on  the  /VPScale
  1003.             switch. For instance, to  increase  the  width  (x) by 10% and
  1004.             decrease the height (y) by 10%, use:
  1005.  
  1006.                  p4ps mydoc.prn /vps:110:90
  1007.  
  1008.             Since  Ventura  uses  the  GEM  PostScript  driver,  P4PS will
  1009.             probably work with any GEM application.
  1010.  
  1011.  
  1012.  
  1013.             2.7  P4PS and WordPerfect v5.0 and v5.1
  1014.  
  1015.             WordPerfect's  output  is  almost  completely devoid of Adobe-
  1016.             recommended comments. This posed quite a  challenge  for P4PS.
  1017.             We are happy to report that we are able to support WordPerfect
  1018.             v5.0 and 5.1 -- although P4PS will not automatically recognize
  1019.             v5.0's  output.  Table  of  contents  (TOC)  movement  is  not
  1020.             supported but is not necessary  since  WordPerfect  places the
  1021.             TOC where you indicate. For v5.0, use:
  1022.  
  1023.                  p4ps /booklet /mode:wp5 mydoc.prn
  1024.  
  1025.             For non-booklet processing, omit the "/Booklet" switch.
  1026.  
  1027.             For v5.1, you can omit the "/Mode" switch (see section 3.4).
  1028.  
  1029.  
  1030.  
  1031.             2.8  P4PS and WordStar v5.5
  1032.  
  1033.             WordStar  generates  comments that differ  slightly  from  the
  1034.             Adobe convention. Table  of  contents  movement  has  not been
  1035.             verified. Versions other than 5.5 may work too,  but  have not
  1036.             been tested. Print your document to disk and use:
  1037.  
  1038.                  p4ps /booklet mydoc.prn
  1039.  
  1040.             For non-booklet processing, omit the "/Booklet" switch.
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.        Page 12                        2.6  P4PS and Ventura Publisher v2.0
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.        Version 2.00                                                   P4PS
  1060.  
  1061.  
  1062.  
  1063.  
  1064.  
  1065.        3.0  File Handling Options
  1066.  
  1067.  
  1068.  
  1069.             3.1  /Booklet -- Automatic Booklet Generation
  1070.  
  1071.             One of P4PS's  major  features is the ability to automatically
  1072.             generate booklets. This requires prescanning the input file to
  1073.             determine the file's page  boundaries.  The  input file may be
  1074.             pure ASCII or PostScript generated by a supported application.
  1075.             (See section  3.5 for information on moving a document's table
  1076.             of contents.)
  1077.  
  1078.             In order to print a booklet,  2  pages  per side of a sheet of
  1079.             paper, in the proper order so that they may be copied, folded,
  1080.             and stapled or bound into a booklet, it is necessary  to print
  1081.             the last even page next to the first odd page, the  second odd
  1082.             page next  to the second-to-last  even page, the third-to-last
  1083.             even page next  to  the  third  odd page, etc. For example, if
  1084.             your document had 8 pages, P4PS would print them as:
  1085.  
  1086.                            8..............................1
  1087.                            2..............................7
  1088.                            6..............................3
  1089.                            4..............................5
  1090.  
  1091.             If printing in one pass, the odd pages will come  out oriented
  1092.             180 degrees opposite the even pages. This is so  they  can  be
  1093.             copied back to back and page  1  will be opposite page 2, etc.
  1094.             Single pass processing  is  probably preferable if you will be
  1095.             taking the output to a copying business -- they will prefer it
  1096.             that way.
  1097.  
  1098.             Two-pass processing (see section 4.1) is more  convenient when
  1099.             outputing a proof booklet or  just a few copies. This produces
  1100.             a usable, finished product ready to be stapled.
  1101.  
  1102.             Specifying /Booklet always sets the  number  of  virtual pages
  1103.             per page to 2  ("/Npage:2")  and  turns  off the physical page
  1104.             headings ("/PHeader-").
  1105.  
  1106.             Booklet processing has three  options.  The  most  flexible is
  1107.             "/Booklet:Custom"  which  makes  no  further  assumptions  and
  1108.             allows you to customize P4PS's other options.
  1109.  
  1110.             "/Booklet:Fullpage"  (default)  sets  the physical margins and
  1111.             spread to 0 ("/PMargins:0:0" and "/SPread:0:0"), and turns off
  1112.             the  border  and  virtual  page  heading  ("/BORder:None"  and
  1113.             "/VHeader-"). This maximizes the use  of  the  page  and works
  1114.             well with PostScript input files or ASCII input files that are
  1115.             formatted with margins.
  1116.  
  1117.  
  1118.  
  1119.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 13
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.        P4PS                                                   Version 2.00
  1126.  
  1127.  
  1128.  
  1129.             The  third  option,  "/Booklet:Dropshadow", maintains the drop
  1130.             shadow effect while  increasing  the  spread  between  the two
  1131.             images    and    decreasing    the   physical   page   margins
  1132.             ("/SPread:54:0"  and  "/PMargins:27:46").  This  option  works
  1133.             better with ASCII input files -- especially if they are a full
  1134.             80 columns per line or 66 lines per page..
  1135.  
  1136.  
  1137.  
  1138.             3.2  /Copies -- Multiple Copies of Each File
  1139.  
  1140.             Use the "/Copies" switch  to  specify  multiple copies of each
  1141.             file. The default is one copy of each file:
  1142.  
  1143.                 p4ps /cop:3 *.pas        => print 3 copies of all "*.PAS"
  1144.                                             files.
  1145.  
  1146.                 p4ps /c:10 announce.txt  => print 10 copies of an
  1147.                                             announcement.
  1148.  
  1149.             Note: If you don't require the copies to  be  output collated,
  1150.             the /UCopies switch will be much faster (see section 3.7).
  1151.  
  1152.  
  1153.  
  1154.             3.3  /FOnt -- Specify Which Font to Use
  1155.  
  1156.             P4PS selects a Courier fixed-pitch font when  processing ASCII
  1157.             input files. The /FOnt switch allows you to specify which font
  1158.             to use. It is  recommended  that you select a fixed pitch font
  1159.             so  that  tabs  and  line  widths will appear correct. To  use
  1160.             Times-Roman:
  1161.  
  1162.                  p4ps myfile /fo:Times-Roman
  1163.  
  1164.             Note:  With  most PostScript printers,  the  upper/lower  case
  1165.             capitalization of the font name  must  match  the  loaded name
  1166.             exactly.
  1167.  
  1168.  
  1169.  
  1170.             3.4  /Mode -- PostScript vs. ASCII
  1171.  
  1172.             P4PS will  usually make the correct assumption about whether a
  1173.             file is PostScript or ASCII and this switch  should  rarely be
  1174.             needed. Adobe PostScript files  are  supposed  to begin with a
  1175.             comment line identifying them as PostScript.  For  example, if
  1176.             the file is compatible  with  PostScript  v3.0, the first line
  1177.             should be:
  1178.  
  1179.                  %!PS-Adobe-3.0
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.        Page 14                3.2  /Copies -- Multiple Copies of Each File
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.        Version 2.00                                                   P4PS
  1192.  
  1193.  
  1194.  
  1195.             P4PS  automatically recognizes these files as PostScript.  The
  1196.             /Mode switch may be used to  override  P4PS's auto-recognition
  1197.             if desired:
  1198.  
  1199.                 /Mode:AScii              => treat the file as ASCII;
  1200.                                             useful in printing the actual
  1201.                                             PostScript program without
  1202.                                             interpretation.
  1203.  
  1204.                 /Mode:Vp2                => file generated by Ventura
  1205.                                             Publisher v2.0 -- may work for
  1206.                                             any GEM document.
  1207.  
  1208.                 /Mode:Wp5                => file generated by WordPerfect
  1209.                                             v5.0 or 5.1; required for
  1210.                                             v5.0.
  1211.  
  1212.                 /Mode:Ps                 => file is PostScript.
  1213.  
  1214.                 /Mode:Automatic          => automatic recognition
  1215.                                             (default).
  1216.  
  1217.             Note: P4PS determines that a  file  was  generated  by Ventura
  1218.             Publisher if it finds the comment "%%Creator: GEM"  within the
  1219.             first 10 lines of the file. If this comment is missing, you'll
  1220.             have to use  "/Mode:Vp2". Similarly, WordPerfect v5.1's second
  1221.             line is "/wpdict begin".  If  this  is  missing, P4PS will not
  1222.             auto-recognize  WordPerfect.  (WordPerfect v5.0  doesn't  even
  1223.             have a "%!PS" comment at the beginning of the file -- which is
  1224.             why the "/Mode:Wp5" is required for v5.0.)
  1225.  
  1226.  
  1227.  
  1228.             3.5  Moving the Table of Contents
  1229.  
  1230.             Many word processors that  produce  a  table of contents (TOC)
  1231.             output  these  tables  at  the  end of the document. P4PS  has
  1232.             facilities  to move the TOC to  an  appropriate  location.  In
  1233.             order to move the TOC, P4PS must be able to identify  the page
  1234.             breaks in your application's PostScript output. TOC processing
  1235.             is not implemented on ASCII input files.
  1236.  
  1237.             Most  applications that follow Adobe's commenting  conventions
  1238.             start  the TOC with a specific  comment.  For  example,  Lotus
  1239.             Manuscript R2, starts each page  within its TOC with a comment
  1240.             similar to:
  1241.  
  1242.                  %%Page: Contents-1 10
  1243.  
  1244.             This would indicate  the  first  page  of the TOC and the 10th
  1245.             page in the overall document.  This  is  100%  conformant with
  1246.             Adobe's conventions.
  1247.  
  1248.  
  1249.  
  1250.  
  1251.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 15
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.        P4PS                                                   Version 2.00
  1258.  
  1259.  
  1260.  
  1261.             As another example, Borland's Sprint  is  not  this  slick. It
  1262.             simply outputs single page  numbers  and  these  numbers start
  1263.             over at 1 at the beginning of the  TOC  --  actually  they can
  1264.             start over at 1 a number of times:
  1265.  
  1266.                  %%Page: 1
  1267.  
  1268.             P4PS has two switches to locate and move the TOC. The /TOCFrom
  1269.             switch is  used  to  indicate  what  text  to look for. If the
  1270.             argument to /TOCFrom is purely numeric, the last occurrence of
  1271.             this  argument is located. This accommodates Borland's  Sprint
  1272.             and allows you to locate the last occurrence of a specifically
  1273.             numbered page:
  1274.  
  1275.                  p4ps ... /tocf:1
  1276.  
  1277.             If   the  argument  to  /TOCFrom  contains  any   alphanumeric
  1278.             characters, the first occurrence of a page  comment containing
  1279.             that  text  is  located   (upper   and   lower  case  are  not
  1280.             significant). With Lotus Manuscript, you would use:
  1281.  
  1282.                  p4ps ... /tocf:contents
  1283.  
  1284.             Enclose the text in quotes if spaces are significant:
  1285.  
  1286.                  p4ps ... /tocf:'the TOC starts here!'
  1287.  
  1288.             The second TOC parameter, /TOCTo tells P4PS where to place the
  1289.             TOC.  If you would like the TOC placed  after  the  first  two
  1290.             pages -- i.e. make it page 3 -- use:
  1291.  
  1292.                  p4ps ... /tocto:3
  1293.  
  1294.             Both of these switches must be used if P4PS  should  move  the
  1295.             TOC.
  1296.  
  1297.             Most publishers want  every  chapter or major section to start
  1298.             on  an odd page boundary. When P4PS moves  the  TOC,  it  will
  1299.             insert  a blank page, if necessary, to  insure  that  the  TOC
  1300.             occupies an even number of pages. It is usually desirable that
  1301.             all chapters or major sections  start on an odd page boundary;
  1302.             this should insure that that relationship is maintained.
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.        Page 16                           3.5  Moving the Table of Contents
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.        Version 2.00                                                   P4PS
  1324.  
  1325.  
  1326.  
  1327.             3.6  /Pages -- Specify a Page Range
  1328.  
  1329.             Normally,  P4PS  prints  all   pages   in   a  file.  Use  the
  1330.             "/Pages:n:m" to limit the output  to pages between "n" and "m"
  1331.             inclusive. If "m" has  a  value of 0, P4PS will continue until
  1332.             the end of file:
  1333.  
  1334.                 p4ps /pages:4:10 myfile  => print pages 4 through 10 only.
  1335.  
  1336.                 p4ps /p:20:0 myfile      => print pages 20 through the end
  1337.                                             of the file.
  1338.  
  1339.  
  1340.  
  1341.             3.7  /UCopies -- Uncollated Copies of Each Page
  1342.  
  1343.             Use  the  "/UCopies" switch to  specify  multiple,  uncollated
  1344.             copies of each page. This is significantly faster than /Copies
  1345.             because the output  is  transmitted to your printer only once.
  1346.             The default is one copy of each page:
  1347.  
  1348.                 p4ps /ucop:3 *.pas       => print all "*.PAS" files, 3
  1349.                                             pages at a time.
  1350.  
  1351.                 p4ps /uc:10 announce.txt => print 10 copies of an
  1352.                                             announcement.
  1353.  
  1354.  
  1355.  
  1356.  
  1357.  
  1358.  
  1359.  
  1360.  
  1361.  
  1362.  
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.  
  1369.  
  1370.  
  1371.  
  1372.  
  1373.  
  1374.  
  1375.  
  1376.  
  1377.  
  1378.  
  1379.  
  1380.  
  1381.  
  1382.  
  1383.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 17
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.        P4PS                                                   Version 2.00
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.        4.0  Output Control Options
  1396.  
  1397.  
  1398.  
  1399.             4.1  /Feed -- Paper Handling Options
  1400.  
  1401.             The  /Feed  switch  is  used  to  control  paper handling.  By
  1402.             default,  P4PS  will  continuously  feed paper printing single
  1403.             sides of each page.
  1404.  
  1405.                 /Feed:Continuous         => continuous paper feeding
  1406.                                             (default).
  1407.  
  1408.                 /Feed:Manual             => totally manually operation;
  1409.                                             P4PS will pause the printer
  1410.                                             between each sheet -- no on-
  1411.                                             screen pause is evident.
  1412.  
  1413.                 /Feed:2pass              => P4PS prints the back sides of
  1414.                                             all pages in reverse order;
  1415.                                             pauses for you to reinsert the
  1416.                                             paper; and then prints the
  1417.                                             front sides in normal order
  1418.                                             (see section 7.4 if your
  1419.                                             printer has trouble printing
  1420.                                             both sides). This option is
  1421.                                             designed for top output bins.
  1422.  
  1423.                 /Feed:2PFlat             => Similar to "2pass" except
  1424.                                             designed for a flat paper
  1425.                                             path.
  1426.  
  1427.                 /Feed:Both               => pauses after every other sheet
  1428.                                             to allow each page to be
  1429.                                             turned over.
  1430.  
  1431.                 /Feed:BOTHFile           => similar to "Both" except that
  1432.                                             a physical page is started for
  1433.                                             each new file.
  1434.  
  1435.             2-Pass printing may take a  little  experimenting.  Most laser
  1436.             printers output sheets of paper in the top bin face down. When
  1437.             P4PS pauses and says  "reload  paper and hit a key", you would
  1438.             take printed output from the top bin, rotate it 180 degrees so
  1439.             the front edge now points rearward, and place it in your paper
  1440.             bin on top of the remaining blank sheets of paper. Do not flip
  1441.             the paper as you insert it.
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.        Page 18                                 4.0  Output Control Options
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.        Version 2.00                                                   P4PS
  1456.  
  1457.  
  1458.  
  1459.             If your printer  does  not  output  top bin face down, you may
  1460.             have another option (a  rear  door?)  that  does come out face
  1461.             down. If your output comes out face up, use the "/Feed:2PFlat"
  1462.             option  and  do  not rotate the output  when  reinserting  it;
  1463.             instead flip the stack side-to-stack.
  1464.  
  1465.             For example:
  1466.  
  1467.                 p4ps /f:2p myfile        => print myfile using 2 passes to
  1468.                                             a top bin where output comes
  1469.                                             out upside down.
  1470.  
  1471.                 p4ps /f:2pf myfile       => print myfile using 2 passes to
  1472.                                             a back bin where output comes
  1473.                                             out upside up.
  1474.  
  1475.  
  1476.  
  1477.             4.2  /Output -- Where to Send the Output
  1478.  
  1479.             Normally, P4PS outputs to PRN. The /Output switch  is  used to
  1480.             specify  an  alternate output device  or  file  specification.
  1481.             Examples:
  1482.  
  1483.                 p4ps /output:lpt2        => output to printer on LPT2.
  1484.  
  1485.                 p4ps /out:com1           => output to printer on COM1.
  1486.  
  1487.                 p4ps /o:p4ps.txt         => output to a disk file.
  1488.  
  1489.             Note that if output is directed to a printer on a  serial port
  1490.             (COMx:), the port should have been previously  initialized via
  1491.             a DOS MODE command or a custom initialization program supplied
  1492.             with your printer.  See  your printer's manual for proper port
  1493.             setup. (See section 7.4 if you use a print spooler.)
  1494.  
  1495.             This is an option that you'll probably want to  set  once  and
  1496.             /CLone into P4PS.EXE -- see section 6.1.
  1497.  
  1498.             If your PostScript printer is not physically connected to your
  1499.             PC, you can use this option to output to a  file  on a floppy,
  1500.             take the floppy to  another  PC, and copy it to the PostScript
  1501.             printer on that machine:
  1502.  
  1503.                  p4ps /o:a:p4ps.txt myfile
  1504.                  ...
  1505.                  copy a:p4ps.txt prn
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 19
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.        P4PS                                                   Version 2.00
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.        5.0  Formatting Options
  1528.  
  1529.  
  1530.  
  1531.             5.1  /ACross -- Layout Virtual Pages Across the Sheet
  1532.  
  1533.             Normally P4PS lays  out  virtual pages down the physical page.
  1534.             Use /ACross to layout the pages across instead.
  1535.  
  1536.  
  1537.  
  1538.             5.2  /BORder -- Selecting the Border Style
  1539.  
  1540.             Normally, P4PS prints a dropshadow border around  each virtual
  1541.             page of text. Use the /BORder switch to change this:
  1542.  
  1543.                 /BORder:None             => do not print a border.
  1544.  
  1545.                 /BORder:Box              => print a simple box only.
  1546.  
  1547.                 /BORder:Dropshadow       => the default drop shadow
  1548.                                             border.
  1549.  
  1550.  
  1551.  
  1552.             5.3  /COlumns -- Specify Characters Per Line
  1553.  
  1554.             The /COlumns switch  may  be  used  to  change  the  number of
  1555.             columns per line -- up to  255  (default is 80). Note that the
  1556.             number of lines per page will change to fill the page.
  1557.  
  1558.             To print  a spreadsheet sideways in landscape mode, print your
  1559.             spreadsheet to disk as an ASCII file and then issue:
  1560.  
  1561.                  p4ps /np:1 /orient:land /col:255 myspread.txt
  1562.                       -or-
  1563.                  p4ps /pm:20:30/np:1/ph-/vh-/b:n/or:l/col:255 spread.txt
  1564.  
  1565.             This option only works with ASCII input files.
  1566.  
  1567.  
  1568.  
  1569.             5.4  Headings -- Displaying Page Headings
  1570.  
  1571.             P4PS supplies  two switches to allow you to customize headings
  1572.             to be printed across the  top of each physical page (/PHeader)
  1573.             and across the top  of  each  virtual page (/VHeader). Virtual
  1574.             page headings are printed in a  Courier-Bold  fixed-pitch font
  1575.             (scaled  down  from  11.7  points  in  single-page  mode)  and
  1576.             physical page headers are printed in  a  14-point Courier-Bold
  1577.             fixed-pitch font. The /FOnt  switch  does  not affect the font
  1578.             used in these headings.
  1579.  
  1580.  
  1581.        Page 20                                     5.0  Formatting Options
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.        Version 2.00                                                   P4PS
  1588.  
  1589.  
  1590.  
  1591.             Both of these switches use a macro language  to  describe what
  1592.             should be printed. Most of the macro variables  relate  to the
  1593.             current file being printed. Date/time macros have  a powerful,
  1594.             optional format specifier which is described in section 5.4.4.
  1595.  
  1596.             5.4.1  Header Macros
  1597.  
  1598.             The following macro variables are recognized in headings:
  1599.  
  1600.                 @FSpec@                  => the entire file specification.
  1601.  
  1602.                 @FName@                  => the file's name portion only.
  1603.  
  1604.                 @FExt@                   => the file's extension only.
  1605.  
  1606.                 @FPath@                  => the file's path only.
  1607.  
  1608.                 @FDate[:fmt]@            => the file's date/time of last
  1609.                                             modification (see section
  1610.                                             5.4.4 for a description of the
  1611.                                             optional "fmt").
  1612.  
  1613.                 @PPage@                  => the physical page number.
  1614.  
  1615.                 @PTotal@the total number of physical pages (requires
  1616.             prescanning).                =>
  1617.  
  1618.                 @VPage@                  => the virtual page number.
  1619.  
  1620.                 @VTotal@the total number of virtual pages (requires
  1621.             prescanning).                =>
  1622.  
  1623.                 @Now[:fmt]@              => the current date/time (see
  1624.                                             section 5.4.4).
  1625.  
  1626.                 @@                       => actually prints an "@".
  1627.  
  1628.                 @_@                      => inserts an "equal number of
  1629.                                             spaces" to fill the line; may
  1630.                                             be used multiple times to
  1631.                                             center, space fill, or right
  1632.                                             justify portions of the
  1633.                                             headings.
  1634.  
  1635.             The @PPage@ and @PTotal@  macros  return  zero (0) if /Booklet
  1636.             processing  is being performed; @PTotal@ and @VTotal@  require
  1637.             prescanning   to  determine  the  totals  --  prescanning   is
  1638.             performed on all  PostScript  files and ASCII files if booklet
  1639.             or 2-pass processing is selected.
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 21
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.        P4PS                                                   Version 2.00
  1654.  
  1655.  
  1656.  
  1657.             5.4.2  /PHeader -- Physical Page Heading
  1658.  
  1659.             This option selects the format  of  the  physical  page header
  1660.             printed in  a  14-point  Courier-Bold  fixed-pitch  font.  The
  1661.             default header is "@FSpec@@_@@FDate@"  which  prints  the full
  1662.             file specification on the  left  and  the file's last modified
  1663.             date/time on the right.
  1664.  
  1665.             This results in a header that might look like:
  1666.  
  1667.                  "C:\PATH\MYFILE.EXT                   90-Oct-14 14:00:33"
  1668.  
  1669.             Examples:
  1670.  
  1671.                 p4ps /ph:'@_@@fname@@_@' myfile
  1672.                                          => prints the current file name
  1673.                                             centered on the page.
  1674.  
  1675.                 p4ps /ph'Project X@_@@now@'myfile
  1676.                                          => prints "Project X" on the left
  1677.                                             and the current date/time on
  1678.                                             the right.
  1679.  
  1680.                 p4ps /ph-                => do not print a physical page
  1681.                                             header.
  1682.  
  1683.  
  1684.             5.4.3  /VHeader -- Virtual Page Heading
  1685.  
  1686.             This  option selects the format of  the  virtual  page  header
  1687.             printed in a Courier-Bold fixed-pitch font  (scaled  from 11.7
  1688.             points in  full-page mode). This header prints within the page
  1689.             outline. The default header is "File: @FSpec@@_@Page: @VPage@"
  1690.             which prints  the full file specification on the left prefaced
  1691.             by the word "File: " and the virtual page number on  the right
  1692.             prefaced by "Page: ".
  1693.  
  1694.             This results in a header that might look like:
  1695.  
  1696.                  "File: C:\PATH\MYFILE.EXT                        Page: 3"
  1697.  
  1698.             Examples:
  1699.  
  1700.                 p4ps /vh:'@fname@@_@@fdate@' myfile
  1701.                                          => print the file name on the
  1702.                                             left and the file date on the
  1703.                                             right.
  1704.  
  1705.                 p4ps /vh- myfile         => do not print a virtual page
  1706.                                             header.
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.        Page 22                      5.4  /PHeader -- Physical Page Heading
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.        Version 2.00                                                   P4PS
  1720.  
  1721.  
  1722.  
  1723.             5.4.4  Date/Time -- Controlling the Date/Time Format
  1724.  
  1725.             P4PS allows great flexibility in determining  the  format that
  1726.             dates and times are printed in. Both the "@Now@" and "@FSpec@"
  1727.             macros allow an optional  parameter  specifying  the date/time
  1728.             format.  The  following  substitutions  are made (assuming the
  1729.             current date/time is February 5, 1991 at 23:14:10):
  1730.  
  1731.                 yy                       => 2 digit year (91).
  1732.  
  1733.                 yyyy                     => 4 digit year (1991).
  1734.  
  1735.                 mm                       => 2 digit month (02).
  1736.  
  1737.                 dd                       => 2 digit date (05).
  1738.  
  1739.                 hh                       => 2 digit hour (11 or 23 -- see
  1740.                                             below).
  1741.  
  1742.                 mi                       => 2 digit minute (14).
  1743.  
  1744.                 ss                       => 2 digit seconds (10).
  1745.  
  1746.                 month                    => Full month name (february).
  1747.  
  1748.                 mon                      => 3 letter month name (feb).
  1749.  
  1750.                 doweek                   => Full name of the day of the
  1751.                                             week (tuesday).
  1752.  
  1753.                 dow                      => 3 letter day of week (tue).
  1754.  
  1755.                 pm                       => Am/Pm indicator -- results in
  1756.                                             "am" or "pm".
  1757.  
  1758.                 p                        => Am/Pm indicator -- results in
  1759.                                             "a" or "p".
  1760.  
  1761.             All two digit formats  (except  "yy")  will suppress a leading
  1762.             zero if the format is capitalized -- i.e.  "mm"  produces "02"
  1763.             and "MM" produces " 2".
  1764.  
  1765.             If "month", "mon", "doweek", or  "dow"  is  fully capitalized,
  1766.             the resultant name is fully  capitalized;  if  only  the first
  1767.             letter  is  capitalized,  the   resultant   first   letter  is
  1768.             capitalized; if  they are completely lower case, the result is
  1769.             completely lower case.
  1770.  
  1771.             If an AM/PM indicator is present, a 12-hour format is used for
  1772.             "hh"  and  the  AM/PM will be replaced  with  the  appropriate
  1773.             letters. The "a", "p", "am", or "pm" is  capitalized  to agree
  1774.             with the indicator.
  1775.  
  1776.  
  1777.  
  1778.  
  1779.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 23
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.        P4PS                                                   Version 2.00
  1786.  
  1787.  
  1788.  
  1789.             The default format is  "yy-Mon-dd hh:mi"  which  produces "91-
  1790.             Feb-05 23:14".
  1791.  
  1792.             Format examples:
  1793.  
  1794.                 Doweek, Month Dd, yyyy   => "Tuesday, February  5, 1991".
  1795.  
  1796.                 Mon Dd, yyyy Hh:mipm     => "Feb  5, 1991 11:14pm".
  1797.  
  1798.                 Dow, Mm/dd/yy Hh:mi:ss   => "Tue, 2/05/91 23:14:10".
  1799.  
  1800.                 Dd-mm-yy at hhmi         => " 5-02-91 at 2314".
  1801.  
  1802.             Example of use on /PHeader:
  1803.  
  1804.                 p4ps /ph:'@fspec@@_@@now:Mm/dd/yy:hhmi@' myfile
  1805.                                          => print the full file
  1806.                                             specification on the left and
  1807.                                             today's date (' 2/05/91:2314')
  1808.                                             on the right.
  1809.  
  1810.  
  1811.  
  1812.             5.5  /Npages -- Virtual Pages Per Page
  1813.  
  1814.             Use the /Npages switch to  specify the number of virtual pages
  1815.             to print on each physical side of paper. The default  value is
  1816.             4, but this switch may be set  to  any  power  of  two  from 1
  1817.             through 64. Values over  8  are not readable but are useful in
  1818.             determining the general layout of a document:
  1819.  
  1820.                 p4ps /np:2 myfile        => print 2 virtual pages per
  1821.                                             sheet.
  1822.  
  1823.                 p4ps /np:64 mydoc        => print 64 virtual pages per
  1824.                                             sheet.
  1825.  
  1826.  
  1827.  
  1828.  
  1829.  
  1830.  
  1831.  
  1832.  
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.        Page 24          5.4  Date/Time -- Controlling the Date/Time Format
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.        Version 2.00                                                   P4PS
  1852.  
  1853.  
  1854.  
  1855.             5.6  /NUmber -- Print Line Numbers
  1856.  
  1857.             Often it is convenient to number each line of a  printed file.
  1858.             You may specify the width of the line number field as  a value
  1859.             to  the  /NUmber  switch. This value  defaults  to  3  if  not
  1860.             specified. If the  line  number field requires more width than
  1861.             that specified by the  width  given,  the  field automatically
  1862.             expands as needed:
  1863.  
  1864.                 /NUmber                  => print line numbers in a 3-
  1865.                                             column width.
  1866.  
  1867.                 /NUmber:5                => print line numbers in a 5-
  1868.                                             column width.
  1869.  
  1870.                 /NUmber-                 => turn line numbers off if
  1871.                                             previously turned on or cloned
  1872.                                             into P4PS.EXE.
  1873.  
  1874.             This option only works with ASCII input files.
  1875.  
  1876.  
  1877.  
  1878.             5.7  /ORient -- Landscape or Portrait
  1879.  
  1880.             P4PS  normally  selects  landscape  or   portrait  orientation
  1881.             automatically to best maintain the aspect ratio of the virtual
  1882.             page. You can override this selection with the /ORient switch:
  1883.  
  1884.                 /ORient:Automatic        => P4PS selects Portrait mode for
  1885.                                             1, 4, 16, and 64 virtual pages
  1886.                                             per sheet; and Landscape mode
  1887.                                             for 2, 8, and 32. (This is the
  1888.                                             default and is useful if the
  1889.                                             setting has been changed via
  1890.                                             DOS SET or /CLone.)
  1891.  
  1892.                 /ORient:Portrait         => portrait (upright) printing.
  1893.  
  1894.                 /ORient:Landscape        => landscape (sideways) printing.
  1895.  
  1896.             For example:
  1897.  
  1898.                 p4ps /np:1 /orient:land  => /np:1 would normally print in
  1899.                                             portrait mode.
  1900.  
  1901.                 p4ps /np:2 /or:p         => /np:2 would normally print in
  1902.                                             landscape mode.
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 25
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.        P4PS                                                   Version 2.00
  1918.  
  1919.  
  1920.  
  1921.             5.8  /PAPer -- Select Paper Style
  1922.  
  1923.             Use  the /PAPer switch to select the type  of  paper  in  your
  1924.             printer. Valid options are:
  1925.  
  1926.                 /PAPer:Letter            => 8.5'' x 11'' (default).
  1927.  
  1928.                 /PAPer:LEGal             => 8.5'' x 14''.
  1929.  
  1930.                 /PAPer:Double            => 11'' x 17''.
  1931.  
  1932.                 /PAPer:Half              => 5.5'' x 8.5''.
  1933.  
  1934.                 /PAPer:A4                => 21 x 29.7 cm (8.3'' x 11.7'').
  1935.  
  1936.                 /PAPer:B4                => 17.6 x 25 cm (6.9'' x 9.8'').
  1937.  
  1938.             This option will be fully implemented shortly.
  1939.  
  1940.  
  1941.  
  1942.             5.9  /PMargins -- Specify the Physical Page Margins
  1943.  
  1944.             You can specify the physical page margins, in points (72nds of
  1945.             an inch) by use of  the /PMargins switch. Note that increasing
  1946.             these values too much may result in some text being  lost. The
  1947.             default values, 46 points  in  each  dimension,  provide about
  1948.             2/3s of an inch all around the printed images. Note  that most
  1949.             PostScript printers will not allow you to print  right  to the
  1950.             edge  of  the  paper, so don't try to set these  values  to  0
  1951.             unless  your  input  already  has  margins.  Borders  and  the
  1952.             physical header  may be partially or completely clipped off if
  1953.             these margins are too small.
  1954.  
  1955.             For example:
  1956.  
  1957.                 p4ps /pm:20:30/np:1/bord:none/ph-/vh-
  1958.                                          => maximum paper utilization.
  1959.  
  1960.                 p4ps /pmarg:108:108      => 1.5" borders all around.
  1961.  
  1962.  
  1963.  
  1964.             5.10  /SPread -- Specify Page Spread
  1965.  
  1966.             Normally, P4PS determines the amount of space to allow between
  1967.             virtual page images by  dividing  32  by  the number of images
  1968.             being printed.  Use the /SPread switch to override and specify
  1969.             the number of points (72nds of an inch) between page images:
  1970.  
  1971.                 p4ps /sp:12:24           => 1/6" laterally and 1/3"
  1972.                                             horizontally.
  1973.  
  1974.  
  1975.  
  1976.  
  1977.        Page 26                           5.8  /PAPer -- Select Paper Style
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.        Version 2.00                                                   P4PS
  1984.  
  1985.  
  1986.  
  1987.             5.11  /TAbsize -- Setting Tab Expansion Size
  1988.  
  1989.             Use /TAbsize to set the   column boundaries for tab expansion.
  1990.             By default, P4PS expands tabs to 8-column boundaries:
  1991.  
  1992.                 p4ps /tab:4 myfile.c     => expand tabs to 4-column
  1993.                                             boundaries.
  1994.  
  1995.             This option only works with ASCII input files.
  1996.  
  1997.  
  1998.  
  1999.             5.12  /Truncate -- Truncate or Wrap Long Lines
  2000.  
  2001.             By default, P4PS wraps long lines and prints a "+" in the left
  2002.             margin to indicate a continuation  line.  Use  the "/Truncate"
  2003.             switch to truncate long  lines  instead -- in which case a "+"
  2004.             is printed in the right margin. If "/Truncate" has been cloned
  2005.             into P4PS.EXE (see section 6.1), you may revert to wrapping by
  2006.             using "/Truncate-":
  2007.  
  2008.                 p4ps /t myfile           => truncate long lines.
  2009.  
  2010.                 p4ps /t- myfile          => wrap long lines (default).
  2011.  
  2012.             This option only works with ASCII input files.
  2013.  
  2014.  
  2015.  
  2016.  
  2017.  
  2018.  
  2019.  
  2020.  
  2021.  
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 27
  2044.  
  2045.  
  2046.  
  2047.  
  2048.  
  2049.        P4PS                                                   Version 2.00
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.        6.0  Customization
  2056.  
  2057.  
  2058.  
  2059.             6.1  /CLone -- Cloning Options Into P4PS.EXE
  2060.  
  2061.             You may decide there are certain options you want set  all the
  2062.             time.  The most notable of these will  be  "/Output"  if  your
  2063.             printer is not on the DOS PRN device.
  2064.  
  2065.             Use  the  /CLone  switch to write these  options  directly  to
  2066.             P4PS.EXE. You must be in the same directory  as  P4PS.EXE when
  2067.             using the /CLone option. When  P4PS is invoked with /CLone, it
  2068.             will  not process any files; it  simply  modifies  itself  and
  2069.             exits.
  2070.  
  2071.             The /CLone switch is  only  available  after P4PS.EXE has been
  2072.             registered:
  2073.  
  2074.                 p4ps /o:lpt2 /number /cl => write the output device and
  2075.                                             line numbering options to
  2076.                                             P4PS.EXE.
  2077.  
  2078.             It is possible  to  create  multiple,  customized  versions of
  2079.             P4PS.EXE using  /CLone.  For  example,  to  create  a version,
  2080.             called "FULLPS.EXE", that prints 1 virtual page/sheet  with no
  2081.             borders, no headers, and smaller margins than  normal, execute
  2082.             the following sequence on a copy of P4PS.EXE:
  2083.  
  2084.                  copy \other\copy\p4ps.exe .
  2085.                  p4ps /pmarg:20:30/npage:1/ph-/vh-/border:none /clone
  2086.                  rename p4ps.exe fullps.exe
  2087.  
  2088.             Note that cloning is cumulative. The only way to start  with a
  2089.             default set of parameters, is to go back  to  the distribution
  2090.             copy -- or  reset  everything manually. Once cloned, P4PS will
  2091.             indicate that it has been customized.
  2092.  
  2093.  
  2094.  
  2095.             6.2  DOS SET Command
  2096.  
  2097.             Alternatively,  P4PS  will  also  read an environment variable
  2098.             named P4PS to  determine  default settings. The same result as
  2099.             the  /CLone example above could be  achieved  by  placing  the
  2100.             following command in your AUTOEXEC.BAT:
  2101.  
  2102.                  set p4ps=/o:lpt2 /number
  2103.  
  2104.  
  2105.  
  2106.  
  2107.  
  2108.  
  2109.        Page 28                                          6.0  Customization
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.        Version 2.00                                                   P4PS
  2116.  
  2117.  
  2118.  
  2119.             Options specified on the  DOS  SET  Command may be temporarily
  2120.             ignored by starting a switch with a double  slash.  The double
  2121.             slash will not affect options cloned into P4PS.EXE:
  2122.  
  2123.                 p4ps //trunc myfile      => ignore the DOS SET Command.
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.  
  2139.  
  2140.  
  2141.  
  2142.  
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.  
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 29
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.        P4PS                                                   Version 2.00
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.        7.0  Using P4PS
  2188.  
  2189.  
  2190.                                    TM
  2191.             7.1  DIRECTORY EXTENDED   and P4PS
  2192.  
  2193.             P4PS  works  very well with  ECONO-SOFT's  powerful,  command-
  2194.             oriented, directory  and  file  management  utility, DIRECTORY
  2195.                     TM
  2196.             EXTENDED  .
  2197.  
  2198.             DX allows you to perform a verified print, delete-after-print,
  2199.             or print in a specified sorting order:
  2200.  
  2201.                 dx *.c /run:'p4ps $s'
  2202.                                          => call P4PS for each "*.c" file
  2203.                                             in the current directory,
  2204.                                             requesting verification first.
  2205.  
  2206.                 dx *.* /run:'p4ps $s'/v-
  2207.                                          => call P4PS for all files in the
  2208.                                             current directory without
  2209.                                             verification.
  2210.  
  2211.                 dx \proga\*.pas /sort:d-n /run:'p4ps $s /booklet' /del
  2212.                                          => call P4PS in booklet mode for
  2213.                                             each "*.pas" file in the
  2214.                                             "\proga" directory; the calls
  2215.                                             to P4PS are sorted by
  2216.                                             descending date and ascending
  2217.                                             name; DX requests verification
  2218.                                             first before calling P4PS and
  2219.                                             then again to delete after
  2220.                                             print.
  2221.  
  2222.             DX has a very powerful file matching engine.  You  can specify
  2223.             multiple  inclusion patterns (separated by "+") and  exclusion
  2224.             patterns (separated by ";").  Each  pattern  looks  similar to
  2225.             DOS' wildcards but  allows  you to place characters before and
  2226.             after  the "*" and have multiple "*"s  in  each  pattern.  For
  2227.             example, the  following  command  will  select  all  filenames
  2228.             ending in "10" with an extension of ".h" or ".c" and all files
  2229.             starting with an "n"  and  ending in "10" with an extension of
  2230.             ".txt". Files starting with "f" or having an  "x"  anywhere in
  2231.             their   names   will   be   excluded.  Files  like  "abc10.h",
  2232.             "proj10.c",  and  "notes-10.txt"  would match while "file10.c"
  2233.             and "projx-10.h"  would not match. DX will run P4PS repeatedly
  2234.             passing each file one-by-one:
  2235.  
  2236.                  dx *10.h + *10.c + n*10.txt ; f* ; *x* /run:'p4ps $s'
  2237.  
  2238.  
  2239.  
  2240.  
  2241.        Page 30                                             7.0  Using P4PS
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.        Version 2.00                                                   P4PS
  2248.  
  2249.  
  2250.  
  2251.             You  can  further  qualify files based on  size  or  date/time
  2252.             ranges. The following command will select all  "proj*.*" files
  2253.             modified between January 2, 1990 at 6pm and March  14  of  the
  2254.             current year as long as their file sizes fall between  100 and
  2255.             10000 bytes, sort the list by name and extension ("/sort:ne"),
  2256.             and  call  P4PS  to print two  copies  of  each  file  without
  2257.             verification:
  2258.  
  2259.                  dx proj*.* /since:2-jan-90:1800 /before:14-mar
  2260.                       /size:100:10000 /sort:ne /v- /run:'p4ps $n /cop:2'
  2261.  
  2262.                                      TM
  2263.             7.1.1  DIRECTORY EXTENDED   -- Feature Summary
  2264.  
  2265.                 o  Full path  and  hard  disk  support  including  logical
  2266.                    drives.
  2267.  
  2268.                 o  A  very  powerful  and  flexible  file-matching  engine
  2269.                    allowing multiple wildcards  and  additional characters
  2270.                    following and between the wildcard characters:
  2271.  
  2272.                        dx *test      => matches files ending in "TEST"
  2273.                                         like "FILETEST", "XTEST", and
  2274.                                         "TEST".
  2275.  
  2276.                        dx a*b        => files starting with "A" and ending
  2277.                                         with "B".
  2278.  
  2279.                        dx f*1*x.*x   => files starting with "F", having
  2280.                                         "1" anywhere in their names,
  2281.                                         ending with "X", and having an
  2282.                                         extension ending in "X" like
  2283.                                         "F1AX.X" or "FILL1_XX.AXX".
  2284.  
  2285.                        dx *te??      => any file ending in four characters
  2286.                                         of which "TE" is the fourth-to-
  2287.                                         last and third-to-last characters
  2288.                                         like "TEST" and "FILETEMP".
  2289.  
  2290.                 o  Multiple file specifications can be  given  --  both as
  2291.                    inclusion and exclusion patterns:
  2292.  
  2293.                        dx .bas+.pas;*t
  2294.                              => will match files with extensions of ".BAS"
  2295.                                 and ".PAS" only if their names do not end
  2296.                                 with a "T".
  2297.  
  2298.                        dx *t*+my*e;.pas
  2299.                              => all files that have a "t" anywhere in
  2300.                                 their names; AND all files that start with
  2301.                                 "my" and end with "e"; UNLESS they have an
  2302.                                 extension of ".PAS" -- "MYFILE.EXT",
  2303.                                 "TEST", and "XTY.C" would match while
  2304.                                 "TEST.PAS" would not match.
  2305.  
  2306.  
  2307.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 31
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.        P4PS                                                   Version 2.00
  2314.  
  2315.  
  2316.  
  2317.                 o  DX can  search  all  directories,  list  all  directory
  2318.                    names, and test  whether  a  set  of files can fit on a
  2319.                    different disk.
  2320.  
  2321.                 o  DX can search any and  all  Compressed  Files  (CFs) --
  2322.                    ARC, LBRs, LZHs, PAKs, PKAs,  ZIPs  and  ZOOs  -- using
  2323.                    full pattern matching; compare files within  one  CF to
  2324.                    normal DOS files or files  in  another  CF;  rename and
  2325.                    change the date/time of files within some CFs.
  2326.  
  2327.                 o  MOVE, COPY, COMPARE, DELETE,  and  RENAME  files across
  2328.                    disks and  directories.  APPEND  files  to pre-existing
  2329.                    files.  Change file  attributes  and  date/time  stamp.
  2330.                    Automatically "Go Bak" to a previous .BAK file. Move or
  2331.                    copy  entire  directory  trees and subtrees maintaining
  2332.                    the directory structure.
  2333.  
  2334.                 o  Security conscience? DX can wipe  the  data  in  a file
  2335.                    before  deleting it... no unerase/undelete program  can
  2336.                    recover data that  has  been  wiped.  (DX  has multiple
  2337.                    wiping  options  including  the Department of Defense's
  2338.                    DoD  5220.22-M  specification.)  DX  can  also  produce
  2339.                    either a 16-bit Cyclic Redundancy Check (CRC), a 32-bit
  2340.                    CRC,  or  a  simple  checksum  of your files  for  data
  2341.                    integrity checking -- useful in detecting Trojan horses
  2342.                    or verifying files transferred electronically!
  2343.  
  2344.                 o  FULL NETWORK SUPPORT!  Including the ability to report,
  2345.                    set, and clear the "Network Share"  file  attribute. DX
  2346.                    has the option to wait for a file that's interlocked on
  2347.                    another network node.
  2348.  
  2349.                 o  You  can  specify  exactly  which  file  attributes  to
  2350.                    display. See  any  hidden  or  system  files  or hidden
  2351.                    directories.
  2352.  
  2353.                 o  You can select files within (or outside of) a specified
  2354.                    range of file sizes and/or dates/times.
  2355.  
  2356.                 o  Have  you  ever  received a new disk and wanted to know
  2357.                    immediately  what commands  are  available?  An  option
  2358.                    displays all ".COM", ".EXE", and ".BAT" files.
  2359.  
  2360.                 o  DX can  sort  files  by  any  combination  of filename,
  2361.                    extension,  size,  date/time,  or  file  attributes  --
  2362.                    ascending  or descending. Sort files within  Compressed
  2363.                    Files (ARC, ZIP, etc.). The sorted output may be across
  2364.                    the screen (or printer) or columnar.
  2365.  
  2366.                 o  All of DX's special processing  may  be  verified  on a
  2367.                    file-by-file    basis     (default)     or    performed
  2368.                    automatically.
  2369.  
  2370.  
  2371.  
  2372.  
  2373.                                                      TM
  2374.        Page 32                7.1  DIRECTORY EXTENDED   -- Feature Summary
  2375.  
  2376.  
  2377.  
  2378.  
  2379.        Version 2.00                                                   P4PS
  2380.  
  2381.  
  2382.  
  2383.                 o  You can carry all of  the  extensive  pattern  and file
  2384.                    matching  capabilities  into   ANY  TASK  you  need  to
  2385.                    perform. DX can  RUN  an  external  utility  or command
  2386.                    synonym against all files  selected  or  generate (and,
  2387.                    optionally, internally  execute)  DOS  batch  files for
  2388.                    you.  Couple  this  with  the  ability  to  search  all
  2389.                    Compressed Files  and  you  can  build  batch  files to
  2390.                    process your  entire hard disk. (DX can swap itself out
  2391.                    to give your applications maximum available memory.)
  2392.  
  2393.                 o  DX has an extensive set of output formatting options --
  2394.                    including colors, printer formatting, "UPPER",  "lower"
  2395.                    or "Initial Caps" cases,  12  or  24 hour time formats,
  2396.                    and screen width, height, and screen-handling options.
  2397.  
  2398.                 o  DX is fully customizable -- set  your  favorite options
  2399.                    once and they will always be used.
  2400.  
  2401.                 o  Make decisions in batch files based  on  the ERRORLEVEL
  2402.                    set  by DX -- i.e. if files or  disks  exist  or  don't
  2403.                    exist; if  files  compare;  if  a  copy,  move, rename,
  2404.                    delete, etc. was successful or not.
  2405.  
  2406.  
  2407.  
  2408.             7.2  /TImeout -- Setting Printer Timeouts
  2409.  
  2410.             Most PostScript  output  devices  support  three  timeouts  --
  2411.             jobtimeout,  waittimeout,  and   manualfeedtimeout.   The  job
  2412.             timeout is of no concern to  P4PS  -- it determines how long a
  2413.             single job may execute. The default value, 0, is infinite. The
  2414.             wait timeout specifies how  long  the  printer should wait for
  2415.             input if input is delayed for any reason. On slower  PCs, P4PS
  2416.             may spend some time prescanning  your file and may exceed this
  2417.             timeout  value.  In  addition,  when  using  "/Feed:2pass"  or
  2418.             "/Feed:2PFlat" printing, you must reinsert the paper and hit a
  2419.             key within this wait timeout value. The manual feed timeout is
  2420.             used  when selecting  "/Feed:Both"  or  "/Feed:BOTHFile".  The
  2421.             normal PostScript default is 60 and  30  seconds respectively.
  2422.             P4PS changes the default timeout to 180 and 60 seconds  (3 and
  2423.             1 minute respectively) and  is  probably  sufficient  for most
  2424.             uses. You can  change  these  timeouts  --  or  turn  them off
  2425.             altogether -- by using the /TImeout switch:
  2426.  
  2427.                 /timeout:240:240         => set both values to 4 minutes.
  2428.  
  2429.                 /time:0:60               => turn the wait timeout off; set
  2430.                                             the manual feed timeout to 1
  2431.                                             minute.
  2432.  
  2433.                 /ti:0:0                  => turn both timeouts off.
  2434.  
  2435.  
  2436.  
  2437.  
  2438.  
  2439.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 33
  2440.  
  2441.  
  2442.  
  2443.  
  2444.  
  2445.        P4PS                                                   Version 2.00
  2446.  
  2447.  
  2448.  
  2449.             7.3  /NETaccess -- Handling Network Conflicts
  2450.  
  2451.             The /NETaccess switch may be used to determine  how  P4PS will
  2452.             handle a Local Area Network conflict  ("Sharing  Violation" or
  2453.             "Lock Violation"):
  2454.  
  2455.                 o  The  default (/NET:Criterr) puts the standard  flashing
  2456.                    critical error message at the  top  of  the  screen and
  2457.                    allows  you  to  select  'A'bort, 'R'etry, 'I'gnore, or
  2458.                    'F'ail.  In addition, selecting 'W'ait switches to  the
  2459.                    /NET:Wait mode.
  2460.  
  2461.                 o  Selecting /NET:Fail will not give a flashing message at
  2462.                    all,  the critical  error  handler  will  automatically
  2463.                    return a fail to P4PS resulting in an appropriate error
  2464.                    message.
  2465.  
  2466.                 o  Selecting /NET:Wait, you'll get a flashing message that
  2467.                    includes "waiting for network access". In  a  couple of
  2468.                    seconds, the  message  will  disappear  and  P4PS  will
  2469.                    automatically initiate a retry. If  the  file  is still
  2470.                    not  available, the flashing message returns. When  the
  2471.                    message is blinking  on-screen, you can answer 'A'bort,
  2472.                    'I'gnore, or  'F'ail  yourself  (if  you  get  tired of
  2473.                    waiting).
  2474.  
  2475.                 /NETaccess:Criterr       => default error handler.
  2476.  
  2477.                 /NETacc:Fail             => automatic fail.
  2478.  
  2479.                 /NET:Wait                => wait for file.
  2480.  
  2481.  
  2482.  
  2483.             7.4  Usage Tips
  2484.  
  2485.                 o  If you use a print spooler, like DMP Software's LaserZ,
  2486.                    please consult the  spooler's manual for information on
  2487.                    initializing the printer port. If you  use  LazerZ, you
  2488.                    should temporarily disable it prior to running  P4PS by
  2489.                    issuing the  command "LZ /PS-" and reenable it with "LZ
  2490.                    /PS" after running P4PS."
  2491.  
  2492.                 o  Some PostScript printers have difficulty  printing both
  2493.                    sides of a page -- occasionally crinkling the page when
  2494.                    the second  side is printed. To avoid this problem, use
  2495.                    a heavier paper. Strathmore's Legacy 24 pound paper has
  2496.                    a smooth finish on both sides and works  very  well for
  2497.                    printing both sides.
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.        Page 34               7.3  /NETaccess -- Handling Network Conflicts
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.        Version 2.00                                                   P4PS
  2512.  
  2513.  
  2514.  
  2515.             7.5  Future Enhancements
  2516.  
  2517.             Features under future consideration include:
  2518.  
  2519.                 o  4-fold pamphlet processing -- like a greeting card.
  2520.  
  2521.                 o  EPSON  emulation and support for extended IBM  Graphics
  2522.                    characters (would allow line drawing).
  2523.  
  2524.                 o  Signature processing -- to allow printing a  portion of
  2525.                    a booklet.
  2526.  
  2527.                 o  Paper selection options to handle other paper  sizes --
  2528.                    A4, Legal, etc.
  2529.  
  2530.             You can influence the development of P4PS by:
  2531.  
  2532.                1.  Registering and supporting P4PS.
  2533.  
  2534.                2.  Sending in your suggestions and feature requests.
  2535.  
  2536.  
  2537.  
  2538.  
  2539.  
  2540.  
  2541.  
  2542.  
  2543.  
  2544.  
  2545.  
  2546.  
  2547.  
  2548.  
  2549.  
  2550.  
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 35
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.        P4PS                                                   Version 2.00
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.  
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.  
  2590.  
  2591.  
  2592.  
  2593.  
  2594.  
  2595.  
  2596.  
  2597.  
  2598.  
  2599.  
  2600.  
  2601.  
  2602.  
  2603.  
  2604.  
  2605.  
  2606.  
  2607.  
  2608.  
  2609.  
  2610.  
  2611.  
  2612.  
  2613.  
  2614.  
  2615.  
  2616.  
  2617.  
  2618.  
  2619.  
  2620.  
  2621.  
  2622.  
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.  
  2634.  
  2635.  
  2636.  
  2637.        Page 36                                    7.5  Future Enhancements
  2638.  
  2639.  
  2640.  
  2641.  
  2642.  
  2643.        Version 2.00                                                   P4PS
  2644.  
  2645.  
  2646.  
  2647.  
  2648.  
  2649.        Appendix A.  Quick Reference
  2650.  
  2651.  
  2652.        Options:
  2653.            /ACross                  => layout virtual pages across instead
  2654.                                        of down the page.
  2655.  
  2656.            /Booklet:keyword         => turns on booklet processing;
  2657.                                        select: "Custom", "Fullpage"
  2658.                                        (default), or "Dropshadow".
  2659.  
  2660.            /BORder:keyword          => specify the border: "None", "Box",
  2661.                                        or "Dropshadow" (default).
  2662.  
  2663.            /CLone                   => clone current options into P4PS.EXE
  2664.                                        (must be registered).
  2665.  
  2666.            /COlumns                 => specify number of columns per line
  2667.                                        (default is 80).
  2668.  
  2669.            /Copies:n                => number of collated copies of each
  2670.                                        file.
  2671.  
  2672.            /Feed:keyword            => paper handling: "Continuous"
  2673.                                        (default), "Manual", "2pass",
  2674.                                        "2PFlat", "Both", or "BOTHFile".
  2675.  
  2676.            /FOnt:Name               => specify a font other than Courier.
  2677.  
  2678.            /Help                    => display help screens.
  2679.  
  2680.            /Mode:keyword            => select file processing mode:
  2681.                                        "Automatic" (default), "AScii",
  2682.                                        "Ps", "Wp5", or "Vp2".
  2683.  
  2684.            /NETaccess:keyword       => network conflict handling:
  2685.                                        "Criterr", "Wait", or "Fail".
  2686.  
  2687.            /Npages:n                => specify the number of virtual pages
  2688.                                        per physical page to be printed.
  2689.  
  2690.            /NUmber:n                => print line numbers using a field
  2691.                                        width of "n" ("n" defaults to 3).
  2692.  
  2693.            /ORient:keyword          => specify "Landscape", "Portrait", or
  2694.                                        "Automatic" (default).
  2695.  
  2696.            /Output:spec             => output to device or filespec.
  2697.  
  2698.            /Pages:n:m               => limit output to pages "n" through
  2699.                                        "m".
  2700.  
  2701.  
  2702.  
  2703.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 37
  2704.  
  2705.  
  2706.  
  2707.  
  2708.  
  2709.        P4PS                                                   Version 2.00
  2710.  
  2711.  
  2712.  
  2713.            /PAPer:type              => select paper type: "Letter"
  2714.                                        (default), "LEGal", "Double",
  2715.                                        "Half", "A4", "B5".
  2716.  
  2717.            /PHeader:'header'        => specify the physical page header.
  2718.  
  2719.            /PMargins:x:y            => specify the physical page margins
  2720.                                        in 1/72nds of an inch
  2721.                                        (default=46:46).
  2722.  
  2723.            /SPread:x:y              => specify the space in 1/72nds of an
  2724.                                        inch between pages (default is
  2725.                                        based on /Pages).
  2726.  
  2727.            /TAbsize:n               => specify the tab size (default=8).
  2728.  
  2729.            /TImeout:w:m             => specify the "wait" and "manualfeed"
  2730.                                        timeouts (default=180:60).
  2731.  
  2732.            /TOCFrom:text            => specify "text" to locate the
  2733.                                        beginning of the Table of Contents.
  2734.  
  2735.            /TOCTo:n                 => specify the page number for
  2736.                                        placement of the TOC.
  2737.  
  2738.            /Truncate                => truncate long lines.
  2739.  
  2740.            /UCopies:n               => number of uncollated copies.
  2741.  
  2742.            /VHeader:'header'        => specify the virtual page header.
  2743.  
  2744.            /VPScale:x:y             => allows scaling a Ventura Publisher
  2745.                                        image.
  2746.  
  2747.  
  2748.  
  2749.  
  2750.  
  2751.  
  2752.  
  2753.  
  2754.  
  2755.  
  2756.  
  2757.  
  2758.  
  2759.  
  2760.  
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.        Page 38             Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.        Version 2.00                                                   P4PS
  2776.  
  2777.  
  2778.  
  2779.        Header Macro Variables (for use with /PHeader and /VHeader):
  2780.            @FSpec@                  => the entire file specification.
  2781.  
  2782.            @FName@                  => the file's name portion only.
  2783.  
  2784.            @FExt@                   => the file's extension only.
  2785.  
  2786.            @FPath@                  => the file's path only.
  2787.  
  2788.            @FDate[:fmt]@            => the file's date/time of last
  2789.                                        modification (see section 5.4.4 for
  2790.                                        a description of "fmt").
  2791.  
  2792.            @PPage@                  => the physical page number.
  2793.  
  2794.            @PTotal@                 => the total number of physical pages
  2795.                                        (requires prescanning).
  2796.  
  2797.            @VPage@                  => the virtual page number.
  2798.  
  2799.            @VTotal@                 => the total number of virtual pages
  2800.                                        (requires prescanning).
  2801.  
  2802.            @Now[:fmt]@              => the current date/time (see section
  2803.                                        5.4.4).
  2804.  
  2805.            @@                       => actually prints an "@".
  2806.  
  2807.            @_@                      => inserts an "equal number of spaces"
  2808.                                        to fill the line; may be used
  2809.                                        multiple times to center or space
  2810.                                        fill headings.
  2811.  
  2812.  
  2813.  
  2814.  
  2815.  
  2816.  
  2817.  
  2818.  
  2819.  
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.  
  2826.  
  2827.  
  2828.  
  2829.  
  2830.  
  2831.  
  2832.  
  2833.  
  2834.  
  2835.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 39
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.        P4PS                                                   Version 2.00
  2842.  
  2843.  
  2844.  
  2845.        Date/Time Format (for use on @FDate@ and @Now@ Header Macros):
  2846.            yy                       => 2 digit year (91).
  2847.  
  2848.            yyyy                     => 4 digit year (1991).
  2849.  
  2850.            mm                       => 2 digit month (02).
  2851.  
  2852.            dd                       => 2 digit date (05).
  2853.  
  2854.            hh                       => 2 digit hour (23).
  2855.  
  2856.            mi                       => 2 digit minute (14).
  2857.  
  2858.            ss                       => 2 digit seconds (10).
  2859.  
  2860.            month                    => Full month name (february).
  2861.  
  2862.            mon                      => 3 letter month name (feb).
  2863.  
  2864.            doweek                   => Full name of the day of the week
  2865.                                        (tuesday).
  2866.  
  2867.            dow                      => 3 letter day of week (tue).
  2868.  
  2869.            pm                       => Am/Pm indicator -- results in "am"
  2870.                                        or "pm".
  2871.  
  2872.            p                        => Am/Pm indicator -- results in "a"
  2873.                                        or "p".
  2874.  
  2875.        All two digit formats (except "yy") will suppress a leading zero if
  2876.        the  format  is  capitalized  --  i.e. "mm" produces "02" and  "MM"
  2877.        produces " 2".
  2878.  
  2879.        If "month", "mon", "doweek", or  "dow"  is  fully  capitalized, the
  2880.        resultant  name  is  fully capitalized; if only the first letter is
  2881.        capitalized, the resultant first letter is capitalized.
  2882.  
  2883.        If an AM/PM indicator is present, a 12-hour format is used for "hh"
  2884.        and  the  AM/PM  will be replaced with the appropriate letters. The
  2885.        "a", "p", "am", or "pm" is capitalized to agree with the indicator.
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.        Page 40             Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.        Version 2.00                                                   P4PS
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.        Appendix B.  Registration Form
  2914.  
  2915.  
  2916.        If  you  find  P4PS useful, please send your registration fee. This
  2917.        payment  is  the  only  incentive  to continue to  produce  quality
  2918.        software at affordable prices. Please support the ShareWare concept
  2919.        and send a registration fee  of $49.95 (includes a printed manual).
  2920.        Also,  whether  you  use P4PS or  not,  please  pass  P4PS.EXE  and
  2921.        P4PS.DOC  on  to  as  many  people or bulletin boards as  possible.
  2922.        Dealer inquiries welcome. See the file ORDER.FRM for a 15% discount
  2923.        when ordering two or  more  ECONO-SOFT  products  at the same time.
  2924.        Corporate licenses available -- see  the  file  LICENSE.FRM. ECONO-
  2925.        SOFT offers a 30 day, no questions asked, money-back guarantee.
  2926.  
  2927.        Name:      __________________________________  Date: ____/____/____
  2928.  
  2929.        Address:   ________________________________________________________
  2930.  
  2931.                   ________________________________________________________
  2932.  
  2933.        City:      __________________________________________  State: _____
  2934.  
  2935.        Country:   ___________________________  Zip/Postal Code: __________
  2936.  
  2937.        Phone:     _______________________  E-Mail: _______________________
  2938.  
  2939.        Version:   ________  My Copy From: ________________________________
  2940.  
  2941.        I  am  enclosing  $______  ($49.95  minimum -- includes  a  printed
  2942.        manual) to help support P4PS. Texas residents please  add  8% sales
  2943.        tax. International orders, please add $10 in US funds.
  2944.  
  2945.        Please charge my credit card as indicated:
  2946.  
  2947.        Master Card or Visa # _____________________________ Exp ___/___/___
  2948.  
  2949.        Signature  ________________________________________________________
  2950.  
  2951.        Please address all orders and correspondence to:
  2952.  
  2953.                ECONO-SOFT                          CompuServe [73267,1664]
  2954.                P.O. Box 181030         InterNet: 73267.1664@CompuServe.COM
  2955.                Austin, TX 78718-1030            512-832-1675, 800-367-7590
  2956.  
  2957.        Please give any comments you can think of about P4PS. What  are its
  2958.        best features?  Do you have any suggestions for future development?
  2959.        (use the back if necessary)
  2960.  
  2961.  
  2962.  
  2963.  
  2964.  
  2965.  
  2966.  
  2967.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 41
  2968.  
  2969.  
  2970.  
  2971.  
  2972.  
  2973.        P4PS                                                   Version 2.00
  2974.  
  2975.  
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.  
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002.  
  3003.  
  3004.  
  3005.  
  3006.  
  3007.  
  3008.  
  3009.  
  3010.  
  3011.  
  3012.  
  3013.  
  3014.  
  3015.  
  3016.  
  3017.  
  3018.  
  3019.  
  3020.  
  3021.  
  3022.  
  3023.  
  3024.  
  3025.  
  3026.  
  3027.  
  3028.  
  3029.  
  3030.  
  3031.  
  3032.  
  3033.        Page 42             Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT
  3034.  
  3035.  
  3036.  
  3037.  
  3038.  
  3039.        Version 2.00                                                   P4PS
  3040.  
  3041.  
  3042.  
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.  
  3049.                                  Index
  3050.  
  3051.  
  3052.               /ACross 20                   border selection 20
  3053.               /Booklet 13                  Both 18
  3054.               /BORder 20                   both sides 34
  3055.               /CLone 28                    BOTHFile 18
  3056.               /COlumns 20                  bound 13
  3057.               /Copies 14                   box 20
  3058.               /Feed 18
  3059.               /FOnt 14                     C
  3060.               /Mode 15                     cloning 28
  3061.               /NETaccess 34                columns 20
  3062.               /Npage 13                    command format 6
  3063.               /Npages 24                   CompuServe 5
  3064.               /NUmber 25                   configuration See:
  3065.               /ORient 25                      customization
  3066.               /Output 19                   Continuous 18
  3067.               /Pages 17                    Courier 1, 14
  3068.               /PAPer 26                    crinkling 34
  3069.               2pass 18                     Criterr 34
  3070.               2PFlat 18                    critical error 34
  3071.               /PHeader 13, 20, 22          Custom 13
  3072.               /PMargins 13, 14, 26         customizing 28
  3073.               /SPread 13, 14, 26
  3074.               /TAbsize 27                  D
  3075.               /TImeout 33                  dates 23
  3076.               /TOCFrom 16                  defaults See:
  3077.               /TOCTo 16                       customization
  3078.               /Truncate 27                 Directory eXtended 31
  3079.               /UCopies 17                                    TM
  3080.               /VHeader 13, 20, 22          DIRECTORY EXTENDED   30
  3081.               /VPScale 11                  DOS MODE command 19
  3082.                                            DOS SET Command 7, 29
  3083.               A                            Double 26
  3084.               A4 26                        drop shadow 20
  3085.               Ami Pro 10                   Dropshadow 14
  3086.               ASCII 9, 14, 15              DX 30, 31
  3087.               ASP 6
  3088.               Association of Shareware     E
  3089.                  Professionals 6           environment variable 28
  3090.               Automatic 15
  3091.                                            F
  3092.               B                            Fail 34
  3093.               B4 26                        FDate 21
  3094.               booklet 4, 13                feature summary 1
  3095.               BORder 13                    Feature Summary - DX 31
  3096.               border 20                    FExt 21
  3097.  
  3098.  
  3099.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 43
  3100.  
  3101.  
  3102.  
  3103.  
  3104.  
  3105.        P4PS                                                   Version 2.00
  3106.  
  3107.  
  3108.  
  3109.               fixed pitch 1                P
  3110.               fixed-pitch 14               P4PS_REG.EXE 3
  3111.               FName 21                     page headings 20
  3112.               font 1, 14                   page range 17
  3113.               FPath 21                     paper 34
  3114.               FSpec 21                     paper handling 18
  3115.               Fullpage 13                  piping 7
  3116.                                            point 1
  3117.               G                            points 26
  3118.               GEM 12                       portrait 25
  3119.                                            PostScript 9, 14
  3120.               H                            PPage 21
  3121.               Half 26                      prescanning 13
  3122.               headings 20                  print spooler 34
  3123.                                            PRN 19, 28
  3124.               I                            Ps 15
  3125.               installation 3               PSCRIPT 10
  3126.               InterNet 5                   PTotal 21
  3127.  
  3128.               J                            R
  3129.               jobtimeout 33                READ.ME 3
  3130.                                            registering 5
  3131.               L
  3132.               landscape 25                 S
  3133.               LaserZ 34                    serial port 19
  3134.               LEGal 26                     ShareWare 5
  3135.               Letter 26                    sharing violation 34
  3136.               LICENSE.FRM 3                site licenses 3
  3137.               line numbers 25              smooth finish 34
  3138.               line width 20                Sprint 11
  3139.               lock violation 34            STANDARD.FMT 11
  3140.               Lotus Manuscript 10          stapled 13
  3141.  
  3142.               M                            T
  3143.               macro language 21            table of contents 15
  3144.               Manual 18                    timeout 33
  3145.               manualfeedtimeout 33         times 23
  3146.               margins 26                   TOC 15
  3147.               MicroSoft Windows 10         truncate 27
  3148.               MicroSoft Word 11
  3149.               MicroSoft Word for           U
  3150.                  Windows 10, 11            uncollated copies 17
  3151.               multiple copies 14
  3152.                                            V
  3153.               N                            Ventura Publisher 11
  3154.               network conflicts 34         Vp2 15
  3155.               Now 21                       VPage 21
  3156.                                            VTotal 21
  3157.               O
  3158.               ORDER.FRM 3                  W
  3159.               orientation 25               Wait 34
  3160.               output device 19             waittimeout 33
  3161.                                            wildcard 7
  3162.                                            WordPerfect 12
  3163.  
  3164.  
  3165.        Page 44             Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.        Version 2.00                                                   P4PS
  3172.  
  3173.  
  3174.  
  3175.               WordStar 12                  wrap 27
  3176.               Wp5 15
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.  
  3184.  
  3185.  
  3186.  
  3187.  
  3188.  
  3189.  
  3190.  
  3191.  
  3192.  
  3193.  
  3194.  
  3195.  
  3196.  
  3197.  
  3198.  
  3199.  
  3200.  
  3201.  
  3202.  
  3203.  
  3204.  
  3205.  
  3206.  
  3207.  
  3208.  
  3209.  
  3210.  
  3211.  
  3212.  
  3213.  
  3214.  
  3215.  
  3216.  
  3217.  
  3218.  
  3219.  
  3220.  
  3221.  
  3222.  
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.  
  3229.  
  3230.  
  3231.        Copyright (C) 1991, Robert K. Blaine/ECONO-SOFT             Page 45
  3232.  
  3233.  
  3234.  
  3235.