home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 September / Simtel20_Sept92.cdr / msdos / laser / jet2up.arc / README.DOC < prev   
Text File  |  1989-07-06  |  10KB  |  236 lines
  1.                                                                 July 6, 1989
  2.  
  3.                            2UP (Version 2.13)
  4.  
  5.           (C) Copyright 1989 by TaxWare, PO Box 2014, Provo, UT  84601
  6.                All rights reserved
  7.  
  8.  
  9.     2UP is a program used to print text files in landscape orientation on 
  10. HP LaserJet (and compatible) printers.  Other than your computer and printer,
  11. nothing else is needed to use 2UP.  The program's flexibility is evident in the
  12. options listed below.
  13.  
  14. The syntax of 2UP is:
  15.  
  16.     2UP [option option ...] fileSpec1 [fileSpec2 ... ]
  17.  
  18. In its simplest form, 2UP is used like this:
  19.  
  20.     2UP fileSpec
  21.  
  22. where fileSpec is the name of the ASCII text file you want to print.
  23.  
  24. In other words, if you needed to print out this file (README.DOC) using 2UP,
  25. you would type in the following command:
  26.  
  27.     2UP README.DOC
  28.  
  29. This would print the file README.DOC using all of the default settings.  That 
  30. is, the file would be printed in 2-column format to printer LPT1, the first
  31. parallel printer, 66 lines of text per column, margins every 4th column,
  32. wrapping long lines of text, but not indenting wrapped lines, and printing on
  33. only one side of each sheet of paper.
  34.  
  35. Listed below are the options that will allow you to override the default
  36. settings.
  37.  
  38. Options:
  39.  
  40. /C    Number of Columns.  2UP allows you to print from one to five columns
  41.     on each side of paper.  If you do not use this option, the file will 
  42.     be printed in 2 columns.  The following command will print the file 
  43.     PHONE.LST in 4-column format.
  44.  
  45.         2UP /C4 PHONE.LST
  46.  
  47. /D    Duplex Printing.  This option only applies to HP Series IID and compat-
  48.     ible printers.  If you do not use this option, printing will be done
  49.     on one side of the paper only (simplex printing).  If you do use this
  50.     option on a printer that does not support duplex printing, the option
  51.     is ignored.  The following command will print the file MANUAL.DOC using
  52.     both sides of each sheet of paper and with horizontal binding.
  53.  
  54.         2UP /D1 MANUAL.DOC
  55.  
  56. /F    Redirect Output.  This option allows you to redirect your output to a
  57.     DOS file, usually to be printed later using the DOS PRINT or COPY
  58.     command.  Any valid file path without wildcards (*,?) may be specified.
  59.     Errors will occur if you do not have proper rights to create and write
  60.     the file, or if the disk to contain the file becomes full.  Also,
  61.     to provide safety measures, if you specify a file that already exists,
  62.     you will be prompted whether you wish overwrite the file.  This option
  63.     will not work with the /P option.  An error will occur.  The following 
  64.     command will redirect the output from the file README.DOC to another 
  65.     file README.PRT on the disk in the A: drive.
  66.  
  67.         2UP /FA:README.PRT README.DOC
  68.  
  69.     Later, the file can be printed to your laser printer in one of the 
  70.     following ways:
  71.  
  72.         PRINT A:README.PRT
  73.         COPY /B A:README.PRT LPT1
  74.     
  75. /I    Wrapped Line Indentation.  This option allows you to specify the number
  76.     of spaces to indent wrapped lines, if any.  The following command will
  77.     print the file STORY.BOK, indenting wrapped lines 10 spaces.
  78.  
  79.         2UP /I10 STORY.BOK
  80.  
  81. /L    Lines Per Column.  This option allows you to specify the maximum number
  82.     of lines that will be printed in each column.  This option is useful
  83.     when printing text files contiaining a fixed number of lines of text
  84.     per record.  This way, information that should stay together will not
  85.     spill into the next column.  For example, to print the file PHONE.LST,
  86.     which has 8 lines of information per record, and to keep all info for
  87.     each record together, you would use the /L option with a multiple of 8
  88.     that is less than 66 (64, 56, 48...).
  89.  
  90.         2UP /L64 PHONE.LST
  91.  
  92. /M    Set Margins.  This option allows you to set the margins to every nth 
  93.     column.  This option allows you to format program source files (such as
  94.     C programs) that use marginal tabs, just as you see when in your text
  95.     editor.  The /M option cannot be used in conjunction with the /T option,
  96.     which is used to expand tabs a specified number of spaces.  The 
  97.     following command will print the file CHESS.PAS, with margins set to
  98.     every 4th column (5, 9, 13,...).
  99.  
  100.         2UP /M4 CHESS.PAS
  101.  
  102. /N    Disable Text Wrapping.  This option allows you to "chop off" the text
  103.     from the lines that would otherwise wrap-around to the next line.  If
  104.     this option is used in conjunction with the /I option, the /I option
  105.     is ignored.  This option can be useful when the /L option is used to
  106.     keep records grouped together, and if there is a possibility that lines
  107.     might be longer than the width of the column.  The following command
  108.     will disable long lines of text in the file ADDRESS.LST from wrapping 
  109.     to the next line.
  110.  
  111.         2UP /N ADDRESS.LST
  112.  
  113. /O    Overwrite Output File.  Normally, if the file specified by the /F option
  114.     exists, you are be prompted to verify overwriting the file.  This option
  115.     causes the file, if it already exists, to be overwritten automatically.
  116.     If the /F option is not used, this option is ignored.  The following
  117.     command causes the redirected output file DAILY.PRT to be automatically
  118.     overwritten, if it already exists.
  119.  
  120.         2UP /FDAILY.PRT /O DAILY.LOG
  121.  
  122. /P    Parallel Printer Port.  This option allows you to print to a parallel 
  123.     printer other than LPT1.  The printers supported are LPT1, LPT2 and 
  124.     LPT3.  If your printer has a serial (COM) interface, use the DOS MODE
  125.     command to allow you to use the printer as a parallel printer.  The 
  126.     following command will print the file READ.ME to printer LPT2.
  127.  
  128.         2UP /P2 READ.ME
  129.  
  130. /T    Spaces Per Tab.  This option allows you to specify the number of spaces
  131.     to expand each tab in the file.  The maximum number of spaces per tab
  132.     is 10.  The following command will print the file MYMANUAL.DOC,
  133.     converting any tabs to 8 spaces.
  134.  
  135.         2UP /T8 MYMANUAL.DOC
  136.  
  137.  
  138. File Specifications:
  139.  
  140.     After any options, you may list as many files as you want on the
  141.     command line.  Wildcards (*,?) are supported.  For example,
  142.  
  143.         2UP C:\TODAY.LOG d:basprogs\*.bas d:c_progs\*.c 05??89.LOG
  144.  
  145.     will print
  146.     o    a file called TODAY.LOG located at the root of the C: drive,
  147.     o    all files ending with the .BAS extension in the BASPROGS 
  148.         subdirectory of the D: drive,
  149.     o    all files ending with the .C extension in the C_PROGS 
  150.         subdirectory of the D: drive, and
  151.     o    any files that match the pattern 05??89.LOG in the current
  152.         directory, where ?? can be any two legal filename characters.
  153.  
  154. Combining Options:
  155.  
  156. Except where noted, options may be combined.  The option letters do not need to
  157. be upper case.  For example, the following command will print the files
  158. MANUAL1.DOC and MANUAL2.DOC in 3-column format, 60 lines of text per column, on
  159. the 2nd parallel printer, and indenting wrapped lines 8 spaces.
  160.  
  161.         2UP /p2 /c3 /l60 /i8 manual1.doc manual2.doc
  162.  
  163. Also, note that the options can be listed in any order, but must all be listed
  164. before the first fileSpec.
  165.  
  166.  
  167. If you need help using 2UP, simply type 2UP without anything else and the 
  168. following screen will appear:
  169.  
  170. 2UP Version 2.13  (reg'd to ???????????????)
  171. (C) Copyright TaxWare 1989.  All Rights Reserved.
  172. 2UP - For Printing Text Files In Landscape Orientation On HP LaserJet Printers
  173.  
  174. Usage: 2UP [option option ...] fileSpec1 [fileSpec2 ... ]
  175. The following options are available:
  176.    /Cn set columns of text per page to n (1 - 5); default is 2.
  177.    /Dn use duplex printing (applicable printers only);
  178.       n = binding mode: 0 for vertical, and 1 for horizontal.
  179.    /Ffilename send output to filename; cannot be used if /P is used.
  180.    /In indent wrapped lines n spaces; default is 0; ignored if /N is used.
  181.    /Ln set lines of text per page to n (40 - 66); default is 66.
  182.    /N cut off lines that would otherwise continue (wrap) to the next line.
  183.    /O overwrite /Ffilename, if it exists; ignored if /F is NOT used.
  184.    /Pn set LPT printer port number to n (1 - 3); default is 1.
  185.    /Tn expand tabs to n spaces (1 - 10); not valid with /M option.
  186.    /Mn set margins to every nth column (1 - 10); default is 4.
  187.  
  188. If you find 2UP to be a useful utility, a registration fee of $20 is requested.
  189. Once registered, you will receive the most recent version of the software and
  190. continued upgrade information.  Also, as a bonus, you will receive a version of
  191. 2UP featuring a forms-based interface and recallable options.  Please include
  192. the version of 2UP that you are using and to whom it is registered.
  193.                 Send to:  TaxWare, PO Box 2014, Provo, UT 84601
  194.  
  195. Reports of perceived bugs or suggestions for improvements are also appreciated.
  196.  
  197.                         Copyright Notice and Disclaimer
  198.  
  199.      2UP is a copyrighted program.  However, no fee is charged for the
  200. non-commercial use of this program by individuals.
  201.  
  202.      2UP may be copied and distributed to others provided that all of
  203. these conditions are met:
  204.  
  205.     (1) The files containing the program (2UP.EXE) and this document 
  206.         (README.DOC) are distributed together, as a single package.
  207.  
  208.     (2) No alterations are made to the contents of either file.
  209.  
  210.     (3) No fee, payment, service charge, or voluntary donation is requested 
  211.         or accepted.
  212.  
  213.      The operation of 2UP is not warranted in any way, nor will TaxWare be
  214. responsible for damages or losses that may result from its use.
  215.  
  216. TaxWare
  217. PO Box 2014
  218. Provo, UT  84601
  219.  
  220. Revision History
  221.  
  222. Version 2.11 (May 02, 1989) was the first version released as shareware.
  223.  
  224. Version 2.12 (June 06, 1989)
  225.     fixed a bug that would cause the printer/computer to hang when
  226.     printing files in 4 or 5 column format, where a fourth or fifth
  227.     column had relatively few lines of text.  Sometimes this bug would
  228.     cause strange things to be printed on the information line (file 
  229.     name, date, time & page #).
  230.  
  231. Version 2.13 (July 06, 1989)
  232.     added marginal tabs and clarified "spaces per tab" to be tab expansion.
  233.     fixed a bug that would cause pages to contain fewer lines than expected
  234.     because of lines being cut-off (/N option) still be counted as printed
  235.     lines.
  236.