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