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