home *** CD-ROM | disk | FTP | other *** search
/ Black Box 4 / BlackBox.cdr / laser / xprt40.arj / XPRT.TXT < prev   
Text File  |  1992-05-14  |  11KB  |  294 lines
  1.                                  XPRT
  2.  
  3. XPRT formats text for output to the HP LaserJet Family, and compatible
  4. laser printers. Some of XPRT's features are:
  5.  
  6. 1. Graybar toggle - Provides shading of alternating lines of text to
  7.    help delineate lines of source code.
  8.  
  9. 2. Smart word wrap - Will wrap at a whitespace if possible. Maintains
  10.    text indentation (source code structure).
  11.  
  12. 3. Port Selection - Allow selection of LPT1, LPT2, LPT3, or a file
  13.    for output. If file is chosen, it can later be typed or copied to
  14.    the printer.
  15.  
  16. 4. Miniature Type - Allows combining subscript, superscript, and
  17.    compressed print. This lets you cram lots more on a page.
  18.  
  19. 5. Menu or Command Line - Command line operation allows XPRT to be
  20.    called from another program for hands-off operation.
  21.  
  22. 6. Page heading that includes file name, date, and page number. An
  23.    alternate heading also provides the FILE date and time. Page
  24.    headings may also be turned off.
  25.  
  26. 6. The current configuration of XPRT may be saved as the default.
  27.    Selecting 'S' from the menu establishes new default settings.
  28.  
  29.    ------------------------------------------------------------------
  30.                                   Note
  31.    vvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvvv
  32.  
  33.    For use on a Local Area Network... if XPRT.EXE is write-protected
  34.    for any reason, XPRT.CFG will be created in the current directory.
  35.    When XPRT starts, it will attempt to open XPRT.CFG for default
  36.    setup information. If the .CFG file cannot be opened, XRPT will
  37.    use it's internal setup data.
  38.  
  39.    If XPRT.EXE is not write-protected, the setup data will be saved 
  40.    to the executable file. XPRT.CFG will not be created.
  41.  
  42.    ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  43.    ------------------------------------------------------------------
  44.  
  45. 7. If the resulting printout is 10 pages or more, XPRT will beep
  46.    upon completion. This is to prevent you from having to watch
  47.    the monitor for long periods of time.
  48.  
  49. 8. Support for legal size paper.
  50.  
  51. 9. Once registered, one need only download later versions to upgrade.
  52.    There is no charge for upgrades unless mailing a disk is required.
  53.    This will cost $5.00.
  54.  
  55. XPRT will check for a printer connected to the port if an LPT is 
  56. selected. It cannot, however, determine it the printer is LaserJet
  57. compatible. It must assume that the operator knows. This is
  58. unavoidable as the LaserJet provides no means of identification
  59. via software.
  60.  
  61. Oh-by-the-way... The LaserJet II does not provide ELITE type without
  62. one of several font cartridges. If ELITE is selected but not
  63. available, the printer will default to COMPRESSED print. This does
  64. not apply to the LaserJet III.
  65.  
  66. If you experience problems viewing XPRT with a monochrome monitor,
  67. set an environment variable MONITOR equal to MONO in your autoexec.bat
  68. file.
  69.    i.e.    set MONITOR=MONO
  70.  
  71. Command line switches can all be jammed together or separated by 
  72. whitespace.
  73.  
  74.   Syntax: XPRT <filename> [switches]
  75.  
  76.    Where: filename = Name of text file to be printed, path included.
  77.           switches = Optional formatting switches (see below).
  78.  
  79.   Command line switches:
  80.  
  81.   A    = Compressed print.
  82.   B    = Elite print (if supported.)
  83.   C    = Pica print.
  84.   D    = Miniature print.
  85.   L    = Landscape (letter size.)
  86.   M    = Landscape (legal size.)
  87.   M    = Portrait (letter size.)
  88.   O    = Portrait (legal size.)
  89.   F    = Respond to embedded formfeed character.
  90.   Y    = Ignore embedded formfeed character.
  91.   Gnnn = Shade alternating lines of text.
  92.          Where nnn is the width of the shading.
  93.  
  94.          The command line:
  95.  
  96.             XPRT somefile.txt G3 
  97.  
  98.          Will shade alternating sets of three lines.
  99.  
  100.             XPRT somefile.txt G100
  101.  
  102.          Will shade the entire page.
  103.  
  104.   Hn   = Page heading select.
  105.          If n is 0 - No heading is printed.
  106.          If n is 1 - The heading contains the file name, page number,
  107.                      and the current date/time.
  108.          If n is 2 - The file date/time is added to the heading also.
  109.  
  110.   Inn  = Indent left margin nn spaces. Max is 25.
  111.   Tnn  = Expand tabs to nn spaces. Max is 25.
  112.   Pn   = Printer port selection.
  113.          If n is 1 - Print to LPT1
  114.          If n is 2 - Print to LPT2
  115.          If n is 3 - Print to LPT3
  116.          If n is 4 - Print to FILE
  117.  
  118.          The command line:
  119.  
  120.              XPRT somefile.txt p4
  121.  
  122.          Will produce an output file named 'filename.XPR' in the current
  123.          directory. If this file already exists, it will be overwritten
  124.          without warning.
  125.  
  126. XPRT /r  will allow the user to enter the serial number that is assigned
  127.          upon registration.
  128.  
  129. Initial Defaults: Pica, Portrait, Embedded formfeed on, Gray Bar Off,
  130. Page Header One, Indent 5, Port LPT1, 4 Spaces/Tab.
  131.  
  132. Typing XPRT with no <filename> will display a list of options.
  133.  
  134. Typing XPRT with a <filename> will bring up the XPRT options menu.
  135.  
  136. Typing XPRT with a <filename> and [switches] will go directly to 
  137. printing.
  138.  
  139. The author may be reached via:
  140.  
  141.       Mail - Paul R. Bearden
  142.              North Texas Computer Solutions
  143.              Box 822 / 312 N. Illinois Street
  144.              Celina, TX     75009
  145.  
  146.      Phone - (214) 382-3244
  147.  
  148. Compuserve - 72117, 510.
  149.  
  150.     C Echo - I try to stay up to date on C Echo messages. A note here
  151.              should reach me.
  152.  
  153.  
  154.  /*****************************************************\
  155.  * This is for Polytron Version Control System 
  156.  *
  157.  * $Author:   Paul R. Bearden  $
  158.  * $Logfile:   C:/old_log/xprt.c_v  $
  159.  * $Revision:   4.0  $
  160.  * $Date:   14 May 1992 08:02:54  $
  161.  *
  162.  * $Log:   C:/old_log/xprt.c_v  $
  163.  * 
  164.  *    Rev 4.0   14 May 1992 08:02:54   Paul R. Bearden
  165.  * Added room for a few more characters/line in landscape-legal.
  166.  * 
  167.  *    Rev 3.9   25 Mar 1992 09:23:40   Paul R. Bearden
  168.  * Fixed graybar problem... was not printing last graybar on the page.
  169.  * 
  170.  *    Rev 3.8   25 Feb 1992 11:34:20   Paul R. Bearden
  171.  * 1. Changed default screen, 'S' is NOT a command line switch.
  172.  * 2. Converted back to Microsoft C 6.0... The QEMM errors stopped
  173.  *    when I stopped using Borland C++ 3.0.
  174.  * 
  175.  *    Rev 3.7b  16 Feb 1992 16:28:26   Paul R. Bearden
  176.  * Fixed problem of crashing under QEMM.
  177.  *
  178.  *    Rev 3.7a  08 Feb 1992 07:07:22   Paul R. Bearden
  179.  * Fixed Imbedded Form Feed Toggle.
  180.  *
  181.  *    Rev 3.7   05 Feb 1992 08:22:12   Paul R. Bearden
  182.  * 1. Changed 'Elite' print to 7 lpi.
  183.  * 2. Added support for legal size paper.
  184.  * 3. Improved LAN support with XPRT.CFG file. If write access is
  185.  *    denied to XPRT.EXE, the configuration information will be
  186.  *    saved to XPRT.CFG in the current directory.
  187.  * 
  188.  *    Rev 3.6   13 Dec 1991 17:26:14   Paul R. Bearden
  189.  * 1. Fixed bugs in command line interface.
  190.  * 2. Added registration instructions to default screen.
  191.  * 3. Fixed 'special keys' in EscPressed ().
  192.  * 4. Changed GoRegister () to delete registration number if an
  193.  *    invalid number is entered.
  194.  * 
  195.  *    Rev 3.5   26 Nov 1991 14:32:18   PBEARDEN
  196.  * 1. Moved registration information to the last 'About' screen.
  197.  * 2. Removed the need for FINDIT.EXE
  198.  * 3. Fixed a minor bug in 'Header Two'.
  199.  * 
  200.  *    Rev 3.4   21 Nov 1991 15:34:46   PBEARDEN
  201.  * 1. More mouse support.
  202.  * 2. Added option for different page headings.
  203.  * 3. Added option to select number of grayed lines.
  204.  * 4. Allow user to enter registration number.
  205.  * 
  206.  *    Rev 3.3   21 Oct 1991 15:13:48   PBEARDEN
  207.  * Added mouse support to 'About' screens.
  208.  * 
  209.  *    Rev 3.2   21 Oct 1991  8:50:08   PBEARDEN
  210.  * Added a registration price list to the 'About' screens.
  211.  * 
  212.  *    Rev 3.1   11 Oct 1991  6:56:56   PBEARDEN
  213.  * Removed reference to legal size paper in the help screens.
  214.  * 
  215.  *    Rev 3.0   27 Aug 1991 10:07:18   PBEARDEN
  216.  * 1. Added 'Save Setup' selection.
  217.  * 2. Minor tweaks to embedded page break handling code.
  218.  * 3. Beep when finished printing (if 10 pages or more.)
  219.  * 4. Print correct number of lines when printing w/o headers.
  220.  * 5. Add more 'About' screens. Added 'ESC' to break out of them.
  221.  * 6. Changed default 'Print to' file for batch printing.
  222.  * 
  223.  *    Rev 2.9   12 Aug 1991 19:00:50   PBEARDEN
  224.  * Added 'About...' selection to menu.
  225.  * 
  226.  *    Rev 2.8   08 Aug 1991 14:03:32   PBEARDEN
  227.  * Minor tweaks.
  228.  * 
  229.  *    Rev 2.7   31 Jul 1991 13:12:12   PBEARDEN
  230.  * 1. Don't send a formfeed if it is on the first line of a page.
  231.  * 2. Minor fix to wordwrap.
  232.  * 
  233.  *    Rev 2.6   29 Jul 1991  9:57:38   PBEARDEN
  234.  * Fixed some uninitialized variables that PC-Lint found.
  235.  * 
  236.  *    Rev 2.5   11 Jul 1991 17:42:28   PBEARDEN
  237.  * Command line (batch) operation will now exit after printing without
  238.  * displaying the copyright message or waiting for a keypress.
  239.  * 
  240.  *    Rev 2.4   04 Jul 1991 10:04:24   PBEARDEN
  241.  * Fixed a bug in the command line Header Toggle.
  242.  * 
  243.  *    Rev 2.3   04 Jul 1991  9:25:58   PBEARDEN
  244.  * Changed default Spaces/Tab from 5 to 4.
  245.  * 
  246.  *    Rev 2.2   02 Jul 1991 13:04:38   PBEARDEN
  247.  * 1. Added page header toggle.
  248.  * 2. Added space/tab selection.
  249.  * 
  250.  *    Rev 2.1   29 Jun 1991 18:42:32   PBEARDEN
  251.  * 1. Removed lots of redundant code.
  252.  * 2. Renamed CountLines () to CountPages ().
  253.  * 3. Added GetLine ().
  254.  * 4. Removed path from the filename in the page heading.
  255.  * 
  256.  *    Rev 2.0   19 Jun 1991 13:48:08   PBEARDEN
  257.  * 1. Display name of file to print at top of menu.
  258.  * 2. Provide means for entering a file name for Print-to-File.
  259.  * 3. Warn if Print-to-File file name already exists.
  260.  * 4. Don't display copyright message on registered copies.
  261.  * 
  262.  *    Rev 1.8   14 Jun 1991  6:46:30   PBEARDEN
  263.  * A few minor tweaks.
  264.  * 
  265.  *    Rev 1.7   13 Jun 1991 16:59:52   PBEARDEN
  266.  * Fixed a bug in the embedded page break handling.
  267.  * Added 'Printing page ...' message.
  268.  * 
  269.  *    Rev 1.6   12 Jun 1991 18:10:26   PBEARDEN
  270.  * Broke into several logical functions... finally.
  271.  * 
  272.  *    Rev 1.5   05 Jun 1991 13:23:18   PBEARDEN
  273.  * Squashed a few bugs in the blank line handling stuff.
  274.  * 
  275.  *    Rev 1.4   04 Jun 1991 18:59:48   PBEARDEN
  276.  * Throw away (don't print) blank lines at the end of a file.
  277.  * 
  278.  *    Rev 1.3   28 May 1991 13:37:06   PBEARDEN
  279.  * Added default instructions.
  280.  * Improved batch mode (command line switches).
  281.  * Allow 2 digit indent value.
  282.  * 
  283.  *    Rev 1.2   24 May 1991 11:48:54   PBEARDEN
  284.  * Added printer toggle for LPT1, LPT2, and LPT3.
  285.  * 
  286.  *    Rev 1.1   20 May 1991 13:22:54   PBEARDEN
  287.  * Fixed push/pop problem. Not enough pops.
  288.  * 
  289.  *    Rev 1.0   01 Mar 1991  8:59:56   PBEARDEN
  290.  * Initial revision.
  291.  * 
  292.  \*****************************************************/
  293.  
  294.