home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 19 Printer / 19-Printer.zip / CPRT102.ZIP / CPRT.DOC < prev    next >
Text File  |  1992-04-23  |  28KB  |  694 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                             #####  ####   ####  #######
  21.                            #       #   #  #   #    #
  22.                            #       #   #  #   #    #
  23.                            #       ####   ####     #
  24.                            #       #      #  #     #
  25.                             #####  #      #   #    #
  26.                           ============================
  27.                             Users Guide and Reference
  28.  
  29.  
  30.  
  31.  
  32.          ---------------------------------------------------------------
  33.                             A C code printing system
  34.                           for IBM compatable computers
  35.                               and most any printer
  36.          ---------------------------------------------------------------
  37.  
  38.  
  39.                                     Shareware
  40.  
  41.                                        by
  42.  
  43.                                  Harry K. Malsch
  44.  
  45.  
  46.  
  47.  
  48.                                   Version  1.02
  49.                                    MARCH 1992
  50.  
  51.  
  52.  
  53.                              Support via EXEC-PC BBS
  54.  
  55.  
  56.  
  57.  
  58.         
  59.                                 Table of Contents
  60.         
  61.         
  62.         Features....................................................1
  63.         
  64.         Introduction to CPRT........................................2
  65.         
  66.         Quick Start.................................................3
  67.         
  68.         Defaults....................................................3
  69.         
  70.         Options.....................................................4
  71.         
  72.         Environment Usage...........................................5
  73.         
  74.         Printer Configuration File..................................6
  75.         
  76.         Key Words...................................................8
  77.         
  78.         Future Plans................................................9
  79.         
  80.         Disclaimer..................................................9
  81.         
  82.         Licensing Agreement and Share Ware philosophy...............10
  83.  
  84.         Order Form..................................................11
  85.  
  86.  
  87.  
  88.         CPRT Operators manual                                Page 1
  89.         ---------------------------------------------------------------
  90.  
  91.  
  92.  
  93.  
  94.         Features:
  95.         =========
  96.  
  97.              First of all you must know CPRT does not reformat C code as
  98.              some pretty-print programs!
  99.  
  100.              CPRT can be used as a general purpose print utility, but was
  101.              designed for printing C source code and especially for
  102.              larger C code projects.
  103.  
  104.  
  105.              CPRT's most notable features:
  106.  
  107.                   *    Designate file to print from com-
  108.                        mand line or file list.
  109.  
  110.                   *    Track file dates and compare date
  111.                        to determine if listing needs to be
  112.                        updated.
  113.  
  114.                   *    User configurable printer configu-
  115.                        ration gives the ability to print
  116.                        to most any printer.
  117.  
  118.                   *    Print to file.
  119.  
  120.                   *    Highlights comments in C source
  121.                        code.
  122.  
  123.                   *    Numbers files for easy reference.
  124.  
  125.                   *    Runs in DOS or OS/2.
  126.  
  127.                   *    Can be called from Microsoft C's
  128.                        Programmers Workbench.
  129.  
  130.                   *    Adjustable margins in
  131.                        characters/line or inches.
  132.  
  133.                   *    Prints Headers & Footers.
  134.  
  135.                   *    Adjustable tab length.
  136.  
  137.                   *    Supports the following WordStar
  138.                        control codes:
  139.                             ^B for bold print toggle.
  140.                             ^D for double print toggle.
  141.                             ^Y for italics print toggle.
  142.                             ^S for underscore toggle.
  143.  
  144.         CPRT Operators manual                                Page 2
  145.         ---------------------------------------------------------------
  146.  
  147.  
  148.  
  149.         Introduction to CPRT
  150.         ====================
  151.  
  152.         I had a shareware print utility which had some nice feathures,
  153.         like the ability to add headers & footers and add line numbers to
  154.         my listings.  But it was missing something.  I had the following
  155.         problems.
  156.  
  157.         Problem 1)
  158.                   Most of the projects I work on are made up of several C
  159.                   source files.  I find the need to update my listings of
  160.                   these files many times during development.  The problem
  161.                   is keeping track of which files have changed and need
  162.                   to be re-printed, and which ones haven't changed since
  163.                   the last printing.  Normally this can take a lot of
  164.                   time to check file dates and printing individual files.
  165.  
  166.         Problem 2)
  167.                   The print utility I was using for printing had some
  168.                   nice features for controlling the pitch, line length,
  169.                   and margins.  However when setting character pitch, I
  170.                   also had to change the line length and the margin
  171.                   settings to keep them where I wanted them.  If I could
  172.                   set the line length in inches instead of number-of-
  173.                   characters (like a word processor), the character pitch
  174.                   setting would be independent of margins and line
  175.                   length.  The same goes for lines-per-inch and page
  176.                   length.
  177.  
  178.         Problem 3)
  179.                   The print utility I was using was DOS only.  Which
  180.                   meant I had to wait for it to complete printing before
  181.                   I could do anything else.  I really hated that!
  182.  
  183.         Problem 4)
  184.                   This really wasn't a problem but I thought it would be
  185.                   nice if the comments would be highlighted in some way.
  186.  
  187.         So I began writing my own print utility with the features I
  188.         needed and some I thought others could use.
  189.  
  190.         One of the most unique features of CPRT is its ability to create
  191.         and use log files.  The log file is simply a text file containing
  192.         a list of file names and their date & times.  The log file can be
  193.         created with any text editor.  You do not have to enter the file
  194.         date & time.  These we be added automatically the first time CPRT
  195.         uses the log file.  Another way to create the log file is to use
  196.         the following command at the command line:
  197.  
  198.         CPRT *.c /lf:<logfilename>
  199.  
  200.         If <logfilename> doesn't exist it will be created and contain all
  201.  
  202.         CPRT Operators manual                                Page 3
  203.         ---------------------------------------------------------------
  204.  
  205.  
  206.  
  207.         the C file names & dates found in the current directory.
  208.  
  209.         Print orientation commands can be set in either number-of-charac-
  210.         ters or inches.  The switch /lm:10  sets a left margin to 10
  211.         characters.  The switch /lm:1i set the left margin to 1 inch.  At
  212.         10CPI both switches do the same thing, however at 12CPI the
  213.         results differ.
  214.  
  215.         Highlighting comments is done by specifying the /hc switch.  CPRT
  216.         will highlight both the standard '/*...*/' comment and comments
  217.         designated by '//' to end of the line.
  218.  
  219.  
  220.  
  221.         Quick Start
  222.         ===========
  223.  
  224.         Some of the more popular printer configurations have been includ-
  225.         ed.  Copy the one that best fits your needs to CPRT.CFG.  Now you
  226.         can use CPRT simply by typing CPRT <filename>. By default CPRT
  227.         prints to the PRN device.  Typing CPRT<cr> displays the correct
  228.         usage and the list of options.  The options list is a text file
  229.         called CPRT.USG.  If certain options don't apply to your printer
  230.         you can edit this file to give you the correct help information.
  231.         In order for CPRT to find this file you must either be in the
  232.         same directory as CPRT.USG or it must be in your path.
  233.  
  234.         Defaults
  235.         ========
  236.  
  237.         Unless you specify otherwise the default settings are:
  238.         Tab length     = 8 characters
  239.         Left Margin    = 0
  240.         Line length    = 8"
  241.         Top Margin     = 0.333" (2 line at 6lpi)
  242.         Bottom margin  = 0.5"
  243.         Page Length    = 11"
  244.         Print Device   = PRN:
  245.  
  246.         Printer configuration file    = CPRT.CFG
  247.         Options help file             = CPRT.USG
  248.  
  249.         If CPRT.EXE is renamed it will expect its associated files to be
  250.         renamed also.  In other words if CPRT.EXE is renamed to PRT.EXE,
  251.         than PRT.EXE will, by default, look for PRT.CFG and PRT.USG.  It
  252.         will not look for CPRT.CFG & CPRT.USG.
  253.  
  254.         TIP: CPRT can be copied to a different name for different print-
  255.              ers, which will use different printer configuration files.
  256.  
  257.         CPRT Operators manual                                Page 4
  258.         ---------------------------------------------------------------
  259.  
  260.  
  261.  
  262.         Options
  263.         =======
  264.  
  265.         To select what and where to print.
  266.           /D:[()=MM-DD-YY] Print according to date.
  267.                       Note: () must be used instead of <> since <> are
  268.                        DOS redirect symbols.
  269.                       /D:)10-31-91  prints files dated after Oct. 31, 91
  270.                       /D:=12-25-91  prints files dated on Dec. 25, 91
  271.                       /D:(1/1/92    prints files dated before Jan. 1, 92
  272.  
  273.           /PF:filenameAlternate printer configuration file.
  274.                       Default = CPRT.CFG.
  275.  
  276.           /PD:filenameAlternate print device.
  277.                       To redirect output.  Can be LPT<n>, COM<n>,
  278.                        <filename>.
  279.                       /PD:COM1  prints to COM1 port.
  280.  
  281.           /F:logfile  Print files listed in this log file.
  282.                       Format: CPRT /F:filename [options]
  283.                       This is the only command option that can be used
  284.                        in place of a filespec to print!
  285.                       Log file is updated when printing is completed.
  286.  
  287.           /LF:logfile Log file.
  288.                       Format: CPRT <filename> /lf:<logfile>
  289.                       Checks if <filename> is in <logfile>.  If not, the
  290.                        <filename> is printed and added to the <logfile>.
  291.                        Otherwise the dates are compared and only changed
  292.                        files are printed.  Then the <logfile> is updated
  293.                        as needed.
  294.  
  295.         Functions which are set at beginning of print job only.
  296.  
  297.           /S6         Lines per inch. (Default)
  298.           /S8         Lines per inch.
  299.  
  300.           /CP         Compressed print.
  301.  
  302.           /10 \
  303.           /12  \
  304.           /15   ---   Set characters per inch
  305.           /17  /      (Printer must be capable of this)
  306.           /20 /
  307.  
  308.           /Fn         Font #.  (n = 1-9)
  309.           /DB         Double Strike mode.  (Entire file)
  310.  
  311.         CPRT Operators manual                                Page 5
  312.         ---------------------------------------------------------------
  313.  
  314.  
  315.  
  316.         Functions which are checked & set at each page.
  317.  
  318.           /HD         Header.
  319.                       Contains file name, file date, and page number.
  320.           /FT         Footer.
  321.                       Contains file name, file date, and page number.
  322.           If both headers & footers are specified then the header will
  323.           contain file name and file date while the footer contains the
  324.           page number.
  325.  
  326.           /TM:n       * Top margin in lines or inches.
  327.           /BM:n       * Bottom margin in lines or inches.
  328.           /PL:n       * Page length in lines or inches.
  329.  
  330.         Functions which are checked & set at beginning of each line.
  331.  
  332.           /LL:n       * Line length in characters or inches.
  333.                       *
  334.           /LM:n         Left margin in character or inches.
  335.           /N          Number lines.  This will increase the line length.
  336.  
  337.         Functions which are checked & set at each character.
  338.  
  339.           /TL         Tab length in characters.
  340.           /HC         Highlight comments.  The type of highlighting used
  341.                        is defined in the printer configuration file.
  342.  
  343.           /WS         Translate the following WordStar print commands.
  344.  
  345.                       ^B Bold print
  346.                       ^D Double print
  347.                       ^Y Italics
  348.                       ^S Underscore
  349.  
  350.  
  351.         Environment Usage
  352.         ================
  353.  
  354.              Default settings can be put in to the environment using the
  355.              following format:
  356.  
  357.              SET CPRT=/tm:1i /bm:1i /lm:.75i
  358.  
  359.              This line would set default margins for CPRT.EXE.  Command
  360.              line switches will override the environment settings.
  361.              However there is no way to override certain switches such as
  362.              /hd, /ft, /n, etc. since these do not have any values passed
  363.              with them.
  364.         --------------------
  365.  
  366.         *  To  specify inches end the option with the letter 'i',  as  in
  367.         /ll:8i.
  368.  
  369.         CPRT Operators manual                                Page 6
  370.         ---------------------------------------------------------------
  371.  
  372.  
  373.  
  374.              If you rename CPRT.EXE the environment variable name must
  375.              also change to correspond to the program name.
  376.  
  377.              TIP: By coping CPRT.EXE to another name, multiple default
  378.                   environment settings can be used.  For instance: Copy
  379.                   CPRT.EXE to PRT.EXE and use the following to set the
  380.                   environment variable:
  381.  
  382.                   SET CPRT /n /hc /hd /lm:.5i
  383.                   SET PRT /lm:.5i /hd /ft
  384.  
  385.                   Now CPRT has default settings for printing C source
  386.                   code.  While PRT can be used as a general purpose print
  387.                   program.
  388.  
  389.  
  390.         Printer Configuration File
  391.         ==========================
  392.  
  393.         Most shareware print programs are specifically for one or two
  394.         printers.  The reason for this is that the control codes which
  395.         set the different printer features vary from printer to printer.
  396.         CPRT allows the end user to change the printer configuration to
  397.         match which ever printer they have.  CPRT's printer configuration
  398.         file can be edited to define the control codes of your printer.
  399.  
  400.         When started, CPRT always checks for the printer configuration
  401.         file in the current directory.  It then searches the path as
  402.         defined in the environment.  This printer configuration file
  403.         contains control codes to activate the different features of your
  404.         printer.
  405.  
  406.         Control codes can be defined in decimal, hex or ascii.
  407.  
  408.         The default printer configuration file read by CPRT is named
  409.         CPRT.CFG.  CPRT supports environments where multiple printers are
  410.         connected to your computer, and even allows you to specify dyna-
  411.         mic printer configuration when you have printers connected to
  412.         your computer using switch boxes.  No matter what printer is
  413.         attached you can still get the same results with CPRT.  Use the
  414.         /PF: command to specify different printer configuration files to
  415.         CPRT.
  416.  
  417.         The printer configuration file is a standard text file that may
  418.         be edited by any text editor.  I've provided a few common printer
  419.         configuration files along with CPRT. All you need to do is copy
  420.         one to your disk, and give it the correct name.  A description is
  421.         included at the beginning of each file.  You can use the DOS type
  422.         command to view the printer configuration files.
  423.  
  424.         Copy the existing printer configuration file for the printer that
  425.         resembles your printer closest.  Then edit that file for your
  426.  
  427.         CPRT Operators manual                                Page 7
  428.         ---------------------------------------------------------------
  429.  
  430.  
  431.  
  432.         printers characteristics.
  433.  
  434.         Each definition begins with a keyword identifier followed by
  435.         printer codes to be sent to the printer when the related feature
  436.         is activated.
  437.  
  438.         Printer codes are specified as decimal numbers, hex numbers, or
  439.         ascii characters.  These numbers are the same numbers defined in
  440.         your printer manual.
  441.  
  442.         The following rules must be followed when creating a printer
  443.         configuration file:
  444.  
  445.         Comments must be the last thing on a line and start with an *
  446.         Control codes must be separated by spaces.
  447.         Codes in decimal must end with a 'd'.  e.i. 27d 72d
  448.         Codes in Hex must end with a 'h'.      e.i. 1Bh 48h
  449.         Ascii is assumed.                      e.i. ^[  H
  450.         '^' indicates the following character is a control character.
  451.              ^[ = Esc.
  452.  
  453.         In order to use an * as part of a printer control code, specify
  454.         the character in decimal (42d) or hex (2Ah).
  455.  
  456.  
  457.         Decimal numbers must be 2 characters followed by a 'd', as in 27d
  458.         or 07d.
  459.  
  460.         Hex numbers must be 2 characters followed by a 'h', as in 1Bh or
  461.         07h.  (Not case sensitive).
  462.  
  463.         Ascii codes are straight forward. Just enter the character.
  464.         Control characters are proceeded by a '^'.
  465.  
  466.          +-------------- Ascii definition
  467.          |    +--------- Decimal definition
  468.          |    |     +--- Hex definition
  469.          |    |     |
  470.         ^[ = 27d = 1Bh.
  471.  
  472.         Note: 1)  The '/',and  '^' characters are researved in ascii
  473.                   notation.  Use hex notation when these characters are
  474.                   needed.
  475.  
  476.               2)  A 0d or 0h is invalid.  Although many printers specifiy
  477.                   this character, I've found that an assci 0 also works.
  478.                   The only exception to this was in the IBM industial
  479.                   graphics printer.                         ~~~~~~~~~
  480.                   This printer is no longer being manufactured.
  481.  
  482.         CPRT Operators manual                                Page 8
  483.         ---------------------------------------------------------------
  484.  
  485.  
  486.  
  487.         Key Words
  488.         =========
  489.  
  490.         Destination         *    Defines the print destination, as in
  491.                                  LPT1, COM1, etc..  Therefore you can
  492.                                  have multiple printer configuration
  493.                                  files for printers on different ports.
  494.                                  CPRT will automatically direct output to
  495.                                  the correct port.
  496.         Init                *    Codes sent before printing begins.
  497.         Restore             *    Codes sent when printing is complete to
  498.                                  restore the printer to default settings
  499.         DoubleStrikeOn      *    Code to activate double strike print.
  500.         DoubleStrikeOff     *    Code to de-activate double strike print.
  501.         CompressedOn        *    Code to activate compressed print.
  502.         CompressedOff       *    Code to de-activate compressed print.
  503.         10CPI               *    Code to change to 10 CPI pitch.
  504.         12CPI               *    Code to change to 12 CPI pitch.
  505.         15CPI               *    Code to change to 15 CPI pitch.
  506.         17CPI               *    Code to change to 17 CPI pitch.
  507.         20CPI               *    Code to change to 20 CPI pitch.
  508.         6LPI                *    Code to change to 6 LPI.
  509.         8LPI                *    Code to change to 8 LPI.
  510.         BoldOn              *    Code to activate Bold print
  511.         BoldOff             *    Code to de-activate Bold print
  512.         ItalicOn            *    Code to activate italics print
  513.         ItalicOff           *    Code to de-activate italics print
  514.         UnderscoreOn        *    Code to activate underscore print
  515.         UnderscoreOff       *    Code to de-activate underscore print
  516.         HighlightOn         *    Code to start highlighting of comments
  517.         HighlightOff        *    Code to end highlighting of comments
  518.         Font1               *    Code to change to Font 1
  519.         Font2               *    Code to change to Font 2
  520.         Font3               *    Code to change to Font 3
  521.         Font4               *    Code to change to Font 4
  522.         Font5               *    Code to change to Font 5
  523.         Font6               *    Code to change to Font 6
  524.         Font7               *    Code to change to Font 7
  525.         Font8               *    Code to change to Font 8
  526.         Font9               *    Code to change to Font 9
  527.         Nlq                 *    Code to activate near letter quality
  528.                                  mode.  Sent prior to font code.
  529.         Draft               *    Code to activate draft mode. Not used at
  530.                                  this time.
  531.  
  532.         CPRT Operators manual                                Page 9
  533.         ---------------------------------------------------------------
  534.  
  535.  
  536.  
  537.         Future Plans
  538.         ============
  539.  
  540.         I've got a few thoughts on how to improve CPRT in the future.
  541.         Here are few that I am sure will make it in to the next release.
  542.  
  543.              1)   Modify DESTINATION key word in printer configuration
  544.                   file.  Add port setup information if destination is a
  545.                   COM port.  This will set baud rate, stop bit, data bits
  546.                   and parity.
  547.  
  548.              2)   Postscript support:  I have an immediate need for this
  549.                   option.  So it is high on my list of requirements.
  550.  
  551.              3)   "As is" command line switch (/AS).  To print file
  552.                   without any formatting.  Can be used to print README
  553.                   files which already have margins, headers, etc..
  554.  
  555.              4)   Add default setup options in printer configuration
  556.                   file.
  557.  
  558.              5)   Allow the initialzation string in the printer configu-
  559.                   ration file to be a file name.  The specified file
  560.                   would be sent to the printer before printing begins.
  561.  
  562.              6)   More printer definition file.  Since I only have a
  563.                   limit number of printers at my access I appreciate any
  564.                   input with this.
  565.  
  566.              7)   ???  I could use more input here.  Regardless if you
  567.                   plan to register your copy, please send me any ideas on
  568.                   improving this program.
  569.  
  570.  
  571.         Disclaimer
  572.         ==========
  573.  
  574.         The CPRT program and all accompanying documentation are provided
  575.         on an "AS IS" basis.  This means that Harry K. Malsch does not
  576.         warrant, guarantee, or make any other representations regarding
  577.         the use, or results of use, of CPRT or the documentation in terms
  578.         of accuracy, reliability, correctness, currentness, or otherwise.
  579.         Harry K. Malsch will not be held responsible for any direct,
  580.         indirect, incidental, or consequential damages including damages
  581.         for loss of business profits, business interruption, loss of
  582.         business information, or otherwise arising from the use or in-
  583.         ability to use CPRT, even if Harry K. Malsch has been advised of
  584.         the possibility of such damages.  The use of this product is on
  585.         an "AT YOUR OWN RISK" basis.
  586.  
  587.         CPRT Operators manual                                Page 10
  588.         ---------------------------------------------------------------
  589.  
  590.  
  591.  
  592.         Licensing Agreement and Share Ware philosophy
  593.         =============================================
  594.  
  595.         The CPRT program is provided for evaluation use under the Share-
  596.         ware concept.  What this means is that you are granted permission
  597.         to use this program for a reasonable period after which you are
  598.         required to register your copy using the Licensing document.
  599.         There is no formal definition of what is implied by "a reasonable
  600.         period" but if you find that you are relying on this product,
  601.         then you SHOULD register.
  602.  
  603.         This will allow for continued support and maintenance of the
  604.         program and will help to encourage that more quality software be
  605.         made available through this channel.   I ask all corporate and
  606.         government users of this utility register their copies.
  607.  
  608.         To simply register the program, $20 is requested.  For $25 I'll
  609.         send an update copy of CPRT as soon as it is available.  In ether
  610.         case I'll send out notifications when the new release is avail-
  611.         able.
  612.  
  613.         If you've downloaded this program after 1992 and can't find a
  614.         later copy than ver 1.02, you can request the current version by
  615.         mail or through EXEC-PC BBS, (414) 789-4210
  616.  
  617.         Mail on EXEC-PC should be sent to HARRY MALSCH.
  618.  
  619.         Address registration requests to:
  620.  
  621.              Harry K. Malsch
  622.              W165 S7391 Bellview Dr.
  623.              Muskego, WI 53150
  624.  
  625.         Following this section is a form that may be used to register
  626.         CPRT.
  627.  
  628.         You are encouraged to distribute CPRT to electronic bulletin
  629.         boards (BBS's), and to your friends and associates as long as all
  630.         files remain unchanged and packaged in the same form as it was
  631.         received.
  632.  
  633.         You are not allowed to profit from the distrubution of CPRT
  634.         without writen permission from the author, Harry K. Malsch.
  635.  
  636.  
  637.         HELP SUPPORT THE SHAREWARE CONCEPT.
  638.  
  639.                        Registered CPRT 1.02 Order Form
  640.         ---------------------------------------------------------------
  641.  
  642.  
  643.  
  644.  
  645.         --------------------------------------------------------------------
  646.         --------------------------------------------------------------------
  647.         QTY                    Description                        US Dollars
  648.         --------------------------------------------------------------------
  649.         ____ CPRT print utility w/special C code formats .............$20.00
  650.              DOS & OS/2 version.
  651.  
  652.         ____ For advance purchase of the next release, add ...........$ 5.00
  653.  
  654.         ____ Shipping/Handling for orders outside USA, add ...........$ 5.00
  655.  
  656.                                  Total amount of my order is:      $________
  657.  
  658.                                  Check or money Order (US FUNDS)!
  659.  
  660.                   Disk Size (circle one)?    5 1/4     3 1/2
  661.  
  662.         ===================================================================
  663.  
  664.         Name: __________________________________________________
  665.  
  666.         Company: _______________________________________________
  667.  
  668.         Address: _______________________________________________
  669.  
  670.                  _______________________________________________
  671.  
  672.         City: ________________________  State: ________  Zip: __________
  673.  
  674.  
  675.         I learned about CPRT from: ____________________________________
  676.  
  677.         Suggestions & requests: _______________________________________
  678.  
  679.         _______________________________________________________________
  680.  
  681.         _______________________________________________________________
  682.  
  683.         _______________________________________________________________
  684.  
  685.         _______________________________________________________________
  686.  
  687.         Make check payable to Harry K. Malsch
  688.                               W165 S7391 Bellview Dr.
  689.                               Muskego, WI 53150
  690.  
  691.         IF YOU HAVE CREATED A PRINTER CONFIGURATION FILE FOR A PRINTER OTHER
  692.         THAN THE ONES INCLUDED.  PLEASE SEND ME A COPY.  IT MAY BE INCLUDE
  693.         WITH THE NEXT RELEASE.
  694.