home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / r / rptp35.zip / RPTP.DOC < prev    next >
Text File  |  1992-08-02  |  13KB  |  303 lines
  1.  
  2.  ╔══════════════════════════════════════════════════════════════════════════╗
  3.  ║                                                                          ║
  4.  ║                                 ISoft D&M                                ║
  5.  ║                                 POB. 5517                                ║
  6.  ║                           Coralville IA 52241                            ║
  7.  ║                                   U.S.A                                  ║
  8.  ║                                                                          ║
  9.  ╚══════════════════════════════════════════════════════════════════════════╝ 
  10.  
  11. *******************************************************************************
  12. *                                    RPTP                                     *
  13. * Ron's Print To Printer program, RPTP V3.5, Aug. 1992.                       *
  14. * Last update : Aug. 02, 1992.                                                *
  15. *******************************************************************************
  16.  
  17.  
  18.                  PAGE 5 - Date XX/YY/ZZ File FFNNBBVV.EEE
  19.  
  20.                                          ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓
  21.                                         ▓                 ▓
  22.        ░░░░░░░░░░░                      ▓ ░░░░░░░░░░░░░░  ▓
  23.        ░▒▒▒▒▒▒▒▒▒▒░                     ▓  ▒▒▒▒▒▒░▒▒▒▒▒▒▒ ▓
  24.        ░▒▓▓▓▓▓▓▓▓▓░▒                     ▓       ░▒       ▓ ░░░░░░░░
  25.        ░▒▓        ░▒▓                     ▓▓▓▓▓▓ ░▒ ▓▓▓▓▓▓  ░▒▒▒▒▒▒▒░
  26.         ░░░░░░░░ ░ ▒▓     ░░░░░░░░             ▓ ░▒ ▓       ░▒███████░
  27.        ░ ▒▒▒▒▒▒▒░ ▒ ▓     ░▒▒▒▒▒▒▒░            ▓ ░▒ ▓       ░▒▓      ░▒
  28.        ░▒▓▓▓▓▓▓▓▓░ ▓      ░▒       ░           ▓ ░▒ ▓       ░▒▓     ░ ▒█
  29.        ░▒▓        ░       ░▒       ░▒          ▓ ░▒ ▓       ░░░░░░░░ ▒ █
  30.        ░▒▓        ░▒      ░▒      ░ ▒          ▓ ░▒ ▓ o     ░▒▒▒▒▒▒▒▒ █
  31.         ▒▓         ▒▓     ░░░░░░░░ ▒           ▓  ▒ ▓       ░▒████████
  32.          ▓ on's     ▓     ░▒▒▒▒▒▒▒▒             ▓   ▓       ░▒█
  33.                           ░▒                     ▓▓▓         ▒█ rinter
  34.                           ░▒                                  █
  35.                            ▒ rint
  36.                           ▓ ▓▓▓▓▓▓▓
  37.                            ▓
  38.  
  39.                  PAGE 5 - Date XX/YY/ZZ File FFNNBBVV.EEE
  40.  
  41. File List
  42. ---------
  43.  
  44.  This package contains the following files :
  45.  
  46.  RPTP.EXE       - RPTP program executable.
  47.  RPTPF.EXE      - RPTP front end program.
  48.  RPTP.DOC       - This file.
  49.  RPTP.REG       - Registration File.
  50.  PROGRAMS.TXT   - ISoft D&M shareware products description.
  51.  RPTP.PRT       - Sample Printer Definitions.
  52.  
  53. Why Register
  54. ------------
  55.  
  56.   RPTP is a shareware product, if you find this product valuable, 
  57.  please register it. This section describes the reasones you should register.
  58.  
  59.   By registering you will receive a printed manual, with many examples, a 
  60.  diskette with the latest RPTP version, and the complete source code for RPTP, 
  61.  and - you will help us to create the next version of RPTP - that will include 
  62.  even more features then the features that are currently available!, 
  63.  we might even add YOUR enhancment requests!
  64.  
  65. Whats New
  66. ---------
  67.  
  68.   Version 3.5 added the fron-end RPTPF program, that uses a pop-up window to
  69.  allow the user to choose RPTP parameters. The RPTPF program features 
  70.  mouse support, on-line help, and more.
  71.  
  72.   Version 3.4 fixed a bug in multiple input files processing.
  73.  
  74.   Version 3.3 added the /? help page parameter. From this version RPTP is
  75.  distributed by ISoft D&M, P.O.B 5517, Coralville IA 52241, U.S.A. 
  76.  
  77.   Version 3.2 added the /TS parameter to support printer termination string.
  78.  
  79.   Version 3.1 added the /SU parameter to specify printer setup string.
  80.  
  81.   Version 3.0 supports printer control codes using the /AP+ parameter, 
  82.  Please refer to the "Printer Usage" section in this document for printer
  83.  control commands. Also added the /PFnnn and /EPc parameters which are
  84.  related to printer formatting support. These switches are described in 
  85.  the "Printer Usage" section in this document, as well.
  86.  
  87.   From Version 2.0 multiple files can be printed in one document using the
  88.  /IC switch, with a command file as input, Please refer to the 
  89.  "Using Command File" section in this document for the command file
  90.  syntax.
  91.  
  92.   Version 1.5 added the /W+, /W- switches. With /W+ lines longer then the 
  93.  columns specified will be wraped around, with /W- they will be truncated.
  94.  
  95.   From version 1.5 the /XF and /XH flags are defaulted to + (TRUE), instead
  96.  of - (FALSE), that was the standard up to that version.
  97.  
  98.   Version 1.4 added the /U+, /U- switches. With /U+ a form feed character
  99.  is sent after the footer, with /U- text lines are sent until the end of page.
  100.  
  101.   Version 1.3 added the /N+, /N- switches, to display line numbers at the left
  102.  of each text line printed.
  103.  
  104.   Version 1.2 Added the -PSsss and -PEeee switches to choose the start and
  105.  end pages to be printed. (This feature is helpfull if you have a paper
  106.  jam during one of the printing sessions, and you do not want to print
  107.  the entire document again).
  108.  
  109. Introduction
  110. ------------
  111.  
  112.   Have you ever tried to print a program listing to a continous paper printer ?
  113.  of course you did, every programmer does. What did you think about these lines
  114.  that disappeared between the pages, didn't you wish you could skip a few
  115.  pages before and after each page break ?, and what about a small header or
  116.  a footer with the program's name and date ?, well.. that would be nice, 
  117.  wouldn't it ?, and what if the program is built of several files, you want
  118.  to print using the same numbering system ?, well .., and what about some
  119.  printer control help, ..
  120.  
  121.   I hoped, for a long time, to have such a small helpful program as RPTP is,
  122.  but, because I could not find one I could use, I had to write RPTP myself.
  123.  
  124. Usage
  125. -----
  126.   At the command line type RPTP and press Enter to receive a help screen, that
  127.  lists the program's command line format, and options.
  128.  
  129.        RPTP V3.5, ISoft D&M, P.O.B 5517, CORALVILLE IA 52241, U.S.A
  130. usage: RPTP [e-options] input-file [e-options] [output-file] [e-options] 
  131. e-options:   @optfile - file of options 
  132.              options  - options displayed below 
  133. options: /Lxxx  /Cyyy   - xxx lines/yyy cols. per page 
  134.          /SH    /SF     - standard header/footer 
  135.          /U+    /U-     - use/do not use form feed character 
  136.          /H-    /H+hhh  - no header/use hhh as header 
  137.          /F-    /F+fff  - no footer/use fff as footer 
  138.          /W+    /W-     - wrap/do not wrap lines 
  139.          /XH+   /XH-    - center/do not center header 
  140.          /XF+   /XF-    - center/do not center footer 
  141.          /PSsss /PEeee  - start at page sss, end at page eee 
  142.          /N+    /N-     - print/do not print line numbers 
  143.          /IF    /IC     - input file/command file 
  144.          /AP+   /AP-    - allow/do not allow printer commands 
  145.          /EPc   /TS     - escape printer code=c/printer termination string sss
  146.          /PFnnn /SUsss  - printer file nnn/printer setup string sss
  147.          /?             - display help
  148.  
  149. Notice - in option files, place each option in a line by itself.
  150.  
  151.  
  152.  
  153.  
  154.  Notice - if the /IC switch is given the input to the RPTP program is   
  155.           taken from a command file, with the file given as input-file
  156.           used as the command file. Please refer to the "Using Command File"
  157.           section. 
  158.  
  159.  By default RPTP assumes a simple input file (/IF switch), and the input-file          
  160.  given is used as the input source to the program.
  161.  
  162.   An alternate way to operate RPTP is by using the RPTPF front-end program,
  163.  at the command line type RPTPF, and fill the fields displayed, to activate
  164.  the RPTP program. After filling the fields select 'Ok' to activate and 
  165.  terminate, 'Cancel' to terminate, and 'Send Job' to activate and stay in
  166.  the RPTPF panel.
  167.  
  168. Using Command File 
  169. ------------------
  170.  
  171.    With Version 2.0 RPTP allows the user to merge multiple text files into 
  172.   one printed document. If you specify the /IC switch on the command line
  173.   the input-file given on the command line is considered to be a command
  174.   file that have the following syntax :
  175.  
  176.    Every line serves as one command to be processed by RPTP.  
  177.  
  178.    If the line contains the NEWPAGE command the output report performs a    
  179.    new page break, and starts printing the next file specified on the
  180.    top of the next page.
  181.  
  182.    Any other line command is considered to be a file name to be printed. 
  183.  
  184.  An example :   
  185.  
  186.   When I want to print the RPTP program and documantation for my own use
  187.   I use a command file named RPTP.MLT which has the following structure :
  188.  
  189. RPTP.PAS  
  190. NEWPAGE
  191. BASICREP.PAS
  192. NEWPAGE
  193. RPTP.DOC
  194.  
  195.   using the following command :
  196.  
  197.   C:\> rptp rptp.mlt /ic  
  198.  
  199.   The output from this command is a printed document that contains both the  
  200.  RPTP program, a report unit used to create the program, and this file.
  201.  
  202. Printer Usage
  203. -------------
  204.  
  205.   From Version 3.0 RPTP can perform printer formatting processing using the
  206.  /AP+ parameter switch. by default /AP- is assumed, and no printer command 
  207.  support is available, if /AP+ is given on the command line, or option file, 
  208.  RPTP replaces any printer escape code found with the appropriate printer 
  209.  setup string. The printer escape code is defined by 2 characters in the text 
  210.  source file, The first one is the printer escape character which can be set 
  211.  using the /EPc command, (The default is character ascii 251 which can be 
  212.  entered using the ALT-251 combination from the keypad. The second character 
  213.  in the printer escape code is the printer setup identifier using the 
  214.  following values :
  215.  
  216.    underLineStart    =   'U'
  217.    underLineEnd      =   'u'
  218.    boldStart         =   'B'
  219.    boldEnd           =   'b'
  220.    user1             =   '1'
  221.    user2             =   '2'
  222.    user3             =   '3'
  223.    user4             =   '4'
  224.    user5             =   '5'
  225.    user6             =   '6'
  226.    user7             =   '7'
  227.    user8             =   '8'
  228.    user9             =   '9'
  229.    user0             =   '0'
  230.    resetPrinter      =   '@'
  231.    proportional      =   'P'
  232.    fixedSpacing      =   'p'
  233.    ItalicStart       =   'I'
  234.    italicEnd         =   'i'
  235.    uprightStart      =   'G' { same as italicEnd on HP laserJet IIIp }
  236.    condensedStart     =  'C'
  237.    condensedEnd      =   'c' { same as upright on HP laserJet IIIp }
  238.    expandedStart     =   'E'
  239.    expandedEnd       =   'e' { same as upright on HP laserJet IIIp }
  240.    outLineStart      =   'O'
  241.    inLineStart       =   'N'
  242.    shadowedStart     =   'S'
  243.    outLineShadowed   =   'o'
  244.  
  245.   By default the printer commands are replaced by HP laserJet IIIp setup   
  246.  strings, however, setup strings for different printers can be desinged and
  247.  using the /PFnnn switch on the command line. If you want to create your
  248.  own printer specific configuration file use the supplied RPTP.PRT template
  249.  file and overwrite the printer codes starting from position 20 (col. 20) 
  250.  in the file with the appropriate codes. My own configuration file is
  251.  used only to define that user0 command will set the PC-8 HP font, and that
  252.  user1 will select the Roman8 font. My configuration file has the following
  253.  structure :
  254.    
  255. user1              (8U
  256. user0              (10U
  257.  
  258.   It is important that the printer setup codes  will start in col. 20, and
  259.  will not have any trailing spaces after them!.
  260.  
  261. Warranty
  262. --------
  263.  
  264.   There is no warranty what so ever, The program is supplied as is,
  265.  The distributer (ISoft D&M), or the author (Loewy Ron), are not,
  266.  and will not be responsible for any damages, lost profits, 
  267.  or inconveniences caused by the use, or inability to use this program. 
  268.  The use of the program is at your own risk. 
  269.  By using (or attempting to use) the program you agree to this.
  270.  
  271. General
  272. -------
  273.  
  274.   RPTP is distributed by ISoft D&M, P.O.B. 5517 CORALVILLE IA 52241, U.S.A.
  275.   
  276.   RPTP is (c) copyrighted by Loewy Ron, 1991, 92.
  277.  
  278.   RPTP is a shareware program, please register your copy. 
  279.   To register your copy of RPTP please refer to the supplied
  280.   RPTP.REG file. 
  281.  
  282.   Other programs distributed by ISoft D&M are described in the supplied  
  283.   PROGRAMS.TXT file.
  284.  
  285. Contact
  286. -------
  287.  
  288.   Please contact :
  289.  
  290.   ISoft D&M,  
  291.   P.O.B 5517
  292.   Coralville IA 52241,
  293.   U.S.A
  294.  
  295. Credits
  296. -------
  297.  
  298.   RPTP was written using Turbo-Pascal V6.0, a copyright of Borland International.
  299.  
  300.   HP and HP laserJet IIIp are trademarks of Hewlett Packard. 
  301.  
  302.   RPTPF was created using WTGEN V1.0 - A CASE Tool generator by Loewy Ron.
  303.