;
                                    OE.COM                                    

             Size (recs) CRC   Version    Author/Latest Issue      Disk
               2k (13)   0294  1.4        Gene Pizzetta 8/89       Z3COM6

  1- Syntax/Options  2- Usage  3- Notes  4- Examples of Use                   

   O/E (Odd/Even) prints  the  odd- or  even-numbered  pages  of  NewWord  and 
WordStar files on the  CP/M  LST device.   It  runs  under ZCPR3  only  and is 
configured for Epson FX printer drivers.   Although not tested, OE should also 
work  with MX and RX drivers.   It probably will  not  work  with  LQ  drivers 
without modification.
:1

    Syntax   OE {dir:}<fn.ft> /<option>

   An input filename is required.   If a DIR or DU specification is not given, 
the current drive/user is assumed.    An option is  also required and  must be 
either "O" for printing odd-numbered pages  or "E" for printing  even-numbered 
pages.

   "OE //" or even  just "OE"  alone,  will cause  a brief help message  to be 
displayed.

   Once printing is started, it can be stopped (aborted) by  pressing any key.  
Since the keyboard is checked everytime a character is sent to the printer, it
stops very quickly.
:2
 Usage - 1/5 

CREATING A FILE TO PRINT:   The file that OE prints must be in its  final form 
and must contain all the needed printer escape codes.   There are two possible
ways to save the document in a disk file with all the printer codes.

With WordStar 4 it's very  easy.   You can redirect printer output  to  a disk 
file from within the program.   When WordStar requests  the name of  a printer 
driver to use, enter the name of the driver, followed by a ">" and the name of
the disk file you want the printer output directed to.  For example,
     FX85>TEST.PRN
will use the Epson FX-85 printer driver and direct  its output to  a disk file 
named TEST.PRN.   No output will go  to the  printer,  but the  disk file will 
contain everything that would ordinarily be sent to  the printer.   If you are 
going to  use  your  default  printer driver,  you can  simply  enter  the re-
direction command at the print driver prompt:
     >TEST.PRN
 Usage - 2/5 

   The second method of saving printer output to  a disk file (the only method 
for NewWord or earlier versions of WordStar) requires the use of a redirection 
utility, such CP/M Plus's PUT.COM.  To use PUT.COM, before calling WordStar or
NewWord to print the document, enter the following command:
     PUT PRINTER {OUTPUT TO} FILE {d:}<fn.ft> [NO FILTER]
After invoking PUT as above, call WordStar or NewWord and send the file to the
printer in a normal way.   It will be redirected to the disk file given in the 
PUT command line.

   Under ZCPR3 you can  use the  input/output  package  (IOP) RECORDER,  which 
operates in much the same manner as PUT.COM.
 Usage - 3/5 

FORMFEEDS:   In order for OE to work, pages in the document must be delineated 
by formfeeds, so you must answer "Y" to the formfeeds question before printing
begins.   You can  also make  using formfeeds  the  default  with  NWINSTAL or 
WSCHANGE.

BATCH OPERATIONS:  About half the time there are  more odd-numbered pages than 
even-numbered  ones.   With earlier versions of  OE you had  to print the odd-
numbered pages first to ensure you would not run out of paper before finishing
the second  side.   For the same  reason you  couldn't print the even-numbered 
pages from a SUBMIT file.  With this version OE sends the same number of pages
for each run, merely adding an extra formfeed if there are fewer even-numbered
pages.   That means you can  print either side of  the paper first and you can 
use SUBMIT to print several documents at once.   You can even print both sides 
from the same SUBMIT file  by putting in  a WAIT command  (if you have such  a 
utility) at the  end of the printing of one  side,  so you  can turn the paper 
over.
 Usage - 4/5 

BOLDFACE ESCAPE CODES:   There is  a  small problem with these printer drivers 
when  a page ends in  boldface and the next page  begins with  boldface.   The 
driver does not re-send the  boldface escade code at the beginning of the next 
page.   If you use both  headers and footers in boldface,  like I commonly do, 
the header on page 2  will not  be in bold.   This also  applies  to  boldface 
paragraphs that continue to the next page without the use of a header.   There 
is a simple solution, however:  enter ^P^O (a binding space) followed  by ^P^H
(a backspace) into the  header before ^P^B (boldface).   If you do  that,  the 
driver thinks it had to print  a non-bold  character and  the  boldface escape 
code will be sent again.  Here is an example header:
     .he                                        ^O^H^BThis is a Header^B
This doesn't affect the header any other way,  since it  merely prints a space 
and then backs up a space.  If you don't ordinarily use headers, you could use
a null header that consisted of  nothing  but  a  binding  space and backspace 
surrounded  by ^PB's,  thus  solving the  problem  of boldface  paragraphs (or 
double-struck or italic ones) that continue from a previous page.
 Usage - 5/5 

OELQ:  There is an additional problem with the FX-85 driver,  which ordinarily
prints in near-letter-quality mode.   The NLQ code is sent to the printer only
at the beginning of the document, unless it  has some reason to send it again.
The even-numbered pages would not be printed in NLQ mode unless OE re-sent the
NLQ code before sending the even pages,  so there is  a special version of OE,
OELQ that does just that.  (The version produced is controlled by an equate in
the source code).
:3
 OE Notes - 1/2 

   a. OE uses the formfeeds (^L) in the source file to toggle between printing
      and skipping pages.   It must also watch for the CP/M  end-of-file (^Z).  
      Life is not quite so simple,  though, because many of the printer escape 
      codes also contain ^L and ^Z.   OE keeps track of whether it's reading a 
      printer escape  code or not, so it  can  ignore ^L's and ^Z's  in  those 
      strings.  For that reason it is highly printer specific.
 OE Notes - 2/2 

   b. Vs 1.0 updates (June 21, 1987) 
      -- first release for NewWord Epson FX-80 printer driver.

   c. Vs 1.1 updates (October 12, 1987) 
      -- added additional trapping code for the  WordStar Epson  FX-85 printer 
         driver.   Added optional sending of Near-Letter-Quality code sequence
         at beginning of each run.

   d. Vs 1.2 updates (January 11, 1988) 
      -- added SUBMIT compatibility by  having OE ensure that  the same number
         of pages are sent, whether printing odd- or even-numbered pages.

   e. Vs 1.3 updates (October 14, 1988) 
      -- modified to remove CP/M Plus dependencies.

   f. Vs 1.4 updates (August 18, 1989) 
      -- added DU support, TCAP support, and "//" to call up help screen.  CCP
         is now preserved.   Code was modified  to use SYSLIB routines,  OE is 
         now ZCPR3 specific.
:4
 Examples of Use 

   a. "A0>oe b:sample.prn /o" 

      - sends the file SAMPLE.PRN on drive B user 0 to the printer,  
        printing only odd-numbered pages.