home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / BEEHIVE / ZSUS / Z3HELP-3.LBR / O.LBR / OE.HZP / OE.HLP
Text File  |  2000-06-30  |  7KB  |  141 lines
  1. ;
  2.                                     OE.COM                                    
  3.  
  4.              Size (recs) CRC   Version    Author/Latest Issue      Disk
  5.                2k (13)   0294  1.4        Gene Pizzetta 8/89       Z3COM6
  6.  
  7.   1- Syntax/Options  2- Usage  3- Notes  4- Examples of Use                   
  8.  
  9.    O/E (Odd/Even) prints  the  odd- or  even-numbered  pages  of  NewWord  and 
  10. WordStar files on the  CP/M  LST device.   It  runs  under ZCPR3  only  and is 
  11. configured for Epson FX printer drivers.   Although not tested, OE should also 
  12. work  with MX and RX drivers.   It probably will  not  work  with  LQ  drivers 
  13. without modification.
  14. :1
  15.  
  16.     Syntax   OE {dir:}<fn.ft> /<option>
  17.  
  18.    An input filename is required.   If a DIR or DU specification is not given, 
  19. the current drive/user is assumed.    An option is  also required and  must be 
  20. either "O" for printing odd-numbered pages  or "E" for printing  even-numbered 
  21. pages.
  22.  
  23.    "OE //" or even  just "OE"  alone,  will cause  a brief help message  to be 
  24. displayed.
  25.  
  26.    Once printing is started, it can be stopped (aborted) by  pressing any key.  
  27. Since the keyboard is checked everytime a character is sent to the printer, it
  28. stops very quickly.
  29. :2
  30.  Usage - 1/5 
  31.  
  32. CREATING A FILE TO PRINT:   The file that OE prints must be in its  final form 
  33. and must contain all the needed printer escape codes.   There are two possible
  34. ways to save the document in a disk file with all the printer codes.
  35.  
  36. With WordStar 4 it's very  easy.   You can redirect printer output  to  a disk 
  37. file from within the program.   When WordStar requests  the name of  a printer 
  38. driver to use, enter the name of the driver, followed by a ">" and the name of
  39. the disk file you want the printer output directed to.  For example,
  40.      FX85>TEST.PRN
  41. will use the Epson FX-85 printer driver and direct  its output to  a disk file 
  42. named TEST.PRN.   No output will go  to the  printer,  but the  disk file will 
  43. contain everything that would ordinarily be sent to  the printer.   If you are 
  44. going to  use  your  default  printer driver,  you can  simply  enter  the re-
  45. direction command at the print driver prompt:
  46.      >TEST.PRN
  47.  Usage - 2/5 
  48.  
  49.    The second method of saving printer output to  a disk file (the only method 
  50. for NewWord or earlier versions of WordStar) requires the use of a redirection 
  51. utility, such CP/M Plus's PUT.COM.  To use PUT.COM, before calling WordStar or
  52. NewWord to print the document, enter the following command:
  53.      PUT PRINTER {OUTPUT TO} FILE {d:}<fn.ft> [NO FILTER]
  54. After invoking PUT as above, call WordStar or NewWord and send the file to the
  55. printer in a normal way.   It will be redirected to the disk file given in the 
  56. PUT command line.
  57.  
  58.    Under ZCPR3 you can  use the  input/output  package  (IOP) RECORDER,  which 
  59. operates in much the same manner as PUT.COM.
  60.  Usage - 3/5 
  61.  
  62. FORMFEEDS:   In order for OE to work, pages in the document must be delineated 
  63. by formfeeds, so you must answer "Y" to the formfeeds question before printing
  64. begins.   You can  also make  using formfeeds  the  default  with  NWINSTAL or 
  65. WSCHANGE.
  66.  
  67. BATCH OPERATIONS:  About half the time there are  more odd-numbered pages than 
  68. even-numbered  ones.   With earlier versions of  OE you had  to print the odd-
  69. numbered pages first to ensure you would not run out of paper before finishing
  70. the second  side.   For the same  reason you  couldn't print the even-numbered 
  71. pages from a SUBMIT file.  With this version OE sends the same number of pages
  72. for each run, merely adding an extra formfeed if there are fewer even-numbered
  73. pages.   That means you can  print either side of  the paper first and you can 
  74. use SUBMIT to print several documents at once.   You can even print both sides 
  75. from the same SUBMIT file  by putting in  a WAIT command  (if you have such  a 
  76. utility) at the  end of the printing of one  side,  so you  can turn the paper 
  77. over.
  78.  Usage - 4/5 
  79.  
  80. BOLDFACE ESCAPE CODES:   There is  a  small problem with these printer drivers 
  81. when  a page ends in  boldface and the next page  begins with  boldface.   The 
  82. driver does not re-send the  boldface escade code at the beginning of the next 
  83. page.   If you use both  headers and footers in boldface,  like I commonly do, 
  84. the header on page 2  will not  be in bold.   This also  applies  to  boldface 
  85. paragraphs that continue to the next page without the use of a header.   There 
  86. is a simple solution, however:  enter ^P^O (a binding space) followed  by ^P^H
  87. (a backspace) into the  header before ^P^B (boldface).   If you do  that,  the 
  88. driver thinks it had to print  a non-bold  character and  the  boldface escape 
  89. code will be sent again.  Here is an example header:
  90.      .he                                        ^O^H^BThis is a Header^B
  91. This doesn't affect the header any other way,  since it  merely prints a space 
  92. and then backs up a space.  If you don't ordinarily use headers, you could use
  93. a null header that consisted of  nothing  but  a  binding  space and backspace 
  94. surrounded  by ^PB's,  thus  solving the  problem  of boldface  paragraphs (or 
  95. double-struck or italic ones) that continue from a previous page.
  96.  Usage - 5/5 
  97.  
  98. OELQ:  There is an additional problem with the FX-85 driver,  which ordinarily
  99. prints in near-letter-quality mode.   The NLQ code is sent to the printer only
  100. at the beginning of the document, unless it  has some reason to send it again.
  101. The even-numbered pages would not be printed in NLQ mode unless OE re-sent the
  102. NLQ code before sending the even pages,  so there is  a special version of OE,
  103. OELQ that does just that.  (The version produced is controlled by an equate in
  104. the source code).
  105. :3
  106.  OE Notes - 1/2 
  107.  
  108.    a. OE uses the formfeeds (^L) in the source file to toggle between printing
  109.       and skipping pages.   It must also watch for the CP/M  end-of-file (^Z).  
  110.       Life is not quite so simple,  though, because many of the printer escape 
  111.       codes also contain ^L and ^Z.   OE keeps track of whether it's reading a 
  112.       printer escape  code or not, so it  can  ignore ^L's and ^Z's  in  those 
  113.       strings.  For that reason it is highly printer specific.
  114.  OE Notes - 2/2 
  115.  
  116.    b. Vs 1.0 updates (June 21, 1987) 
  117.       -- first release for NewWord Epson FX-80 printer driver.
  118.  
  119.    c. Vs 1.1 updates (October 12, 1987) 
  120.       -- added additional trapping code for the  WordStar Epson  FX-85 printer 
  121.          driver.   Added optional sending of Near-Letter-Quality code sequence
  122.          at beginning of each run.
  123.  
  124.    d. Vs 1.2 updates (January 11, 1988) 
  125.       -- added SUBMIT compatibility by  having OE ensure that  the same number
  126.          of pages are sent, whether printing odd- or even-numbered pages.
  127.  
  128.    e. Vs 1.3 updates (October 14, 1988) 
  129.       -- modified to remove CP/M Plus dependencies.
  130.  
  131.    f. Vs 1.4 updates (August 18, 1989) 
  132.       -- added DU support, TCAP support, and "//" to call up help screen.  CCP
  133.          is now preserved.   Code was modified  to use SYSLIB routines,  OE is 
  134.          now ZCPR3 specific.
  135. :4
  136.  Examples of Use 
  137.  
  138.    a. "A0>oe b:sample.prn /o" 
  139.  
  140.       - sends the file SAMPLE.PRN on drive B user 0 to the printer,  
  141.         printing only odd-numbered pages.