home *** CD-ROM | disk | FTP | other *** search
/ Shareware 1 2 the Maxx / sw_1.zip / sw_1 / EDITORS / PBREAK.ZIP / PBREAK.DOC < prev    next >
Text File  |  1992-07-28  |  6KB  |  124 lines
  1. PBREAK 2.0 -- (C) 1992 Dickson Computing, Ltd. (07/28/92)
  2.               Written by John Dickson and Hugh McManus.
  3.               Page breaking/formatting utility for text files.
  4.  
  5. Usage: PBREAK INFILE.EXT OUTFILE.EXT /? /D /R /Hn /Lnn /F /S /T='TITLE TEXT'
  6.  
  7.      OPTION   DEFAULTS             FUNCTION
  8.          /?   (NO ) -- This Command help message is displayed
  9.          /D   (OFF) -- Use DOUBLE spacing for OUTFILE.EXT (NOTE: if INFILE.EXT
  10.                        is double spaced, OUTFILE.EXT will be quadruple
  11.                        spaced)
  12.          /R   (OFF) -- Place 80 column ruler at Top of Form
  13.          /Hn  (OFF) -- Repeat n line header from page 1
  14.          /Lnn (54 ) -- Use nn lines per page in OUTFILE
  15.          /F   (OFF) -- Place "From:  INFILE.EXT" in header
  16.          /S   (OFF) -- Place double line (====) Separator between header and
  17.                        body of file
  18.     /T='TITLE TEXT' -- TITLE to be used in header of OUTFILE.EXT
  19.  
  20.  
  21. PBREAK is designed to be placed in the same directory as your DOS files (or
  22. any other directory which is on your command search PATH).  Then execute
  23. PBREAK in the directory which contains your text file.  The output file 
  24. should also be created in the current directory, as PBREAK 2.0 doesn't
  25. allow long pathnames.  PBREAK can currently handle text files with 512 
  26. columns, and should only be limited by free disk space as to length of 
  27. the file.  An example INFILE.EXT is included for you to play with.
  28.  
  29. Lets look at the command switches in more detail:
  30.  
  31.          /D   (OFF) -- Use DOUBLE spacing for OUTFILE.EXT (NOTE: if INFILE.EXT
  32.                        is double spaced, OUTFILE.EXT will be quadruple
  33.                        spaced)
  34.  
  35.     This switch will cause a single spaced input file to be double spaced
  36.     in the output file.  Thus if you also use /L60 you will only get 30
  37.     lines of text on a page.
  38.  
  39.  
  40.          /R   (OFF) -- Place 80 column ruler at Top of Form
  41.  
  42.     This switch causes an 80 column ruler with a dividing line to be
  43.     placed immediately above the text.  The ruler looks like this:
  44.  
  45.      1       2         3           4     5       6         7           8
  46. 12345678901234567890123456789012345678901234567890123456789012345678901234567890
  47. ---------+---------+---------+---------+---------+---------+---------+---------+
  48.  
  49.  
  50.          /Hn  (OFF) -- Repeat n line header from page 1
  51.  
  52.     This switch causes a header to be placed at the top of each page,
  53.     consisting of whatever is in the top 'n' lines in the INFILE.EXT.
  54.     This makes it real easy to add a header to a report or any other
  55.     file by simply going into your favorite text editor and typing
  56.     what you want in the header and using PBREAK with /H1 for a one
  57.     line header.  (NOTE:  Headers are limited to nine lines.)
  58.  
  59.  
  60.          /Lnn (54 ) -- Use nn lines per page in OUTFILE
  61.  
  62.     This switch sets the number of lines on a given page, this includes
  63.     additional lines created by PBREAK's other switches.  The number of
  64.     lines can be set up to 99 lines per page.  PBREAK uses 54 lines per
  65.     page as its default so that when you want to print, you can adjust 
  66.     your printer such that the first line will be an inch from the top
  67.     and you will have a 1 inch top and bottom margin.  (As far as left 
  68.     and right margins, they have to be in your INFILE.EXT.)
  69.  
  70.  
  71.          /F   (OFF) -- Place "From:  INFILE.EXT" in header
  72.  
  73.     This switch includes the INFILE.EXT filename in the header, because
  74.     you need to know this sometimes for future reference.
  75.  
  76.  
  77.          /S   (OFF) -- Place double line (====) Separator between header and
  78.                        body of file
  79.  
  80.     This switch adds a double line separator between your header and your
  81.     text, which makes for cleaner output in some situations.  (You will
  82.     probably not want to use /S with /R.)
  83.  
  84.  
  85.          /T="TITLE TEXT" -- TITLE to be used in header of OUTFILE.EXT
  86.  
  87.     This switch includes any text found between the first " and the 
  88.     second " and places it on the first line of each page.  (NOTE:  
  89.     All text found between the quotes is converted to upper case.)
  90.  
  91. The print order of all of the switches used is as follows:
  92.  
  93.                           THIS IS PBREAK'S TEST TITLE
  94. From:  INFILE.EXT
  95. HEADER line #1 HEADER line #1 HEADER line #1 HEADER line #1 HEADER line #1
  96. HEADER line #2 HEADER line #2 HEADER line #2 HEADER line #2 HEADER line #2
  97. HEADER line #3 HEADER line #3 HEADER line #3 HEADER line #3 HEADER line #3
  98.          1         2         3         4         5         6         7         8
  99. 12345678901234567890123456789012345678901234567890123456789012345678901234567890
  100. ---------+---------+---------+---------+---------+---------+---------+---------+
  101. ================================================================================
  102. body line # ?? body line # ?? body line # ?? body line # ?? body line # ??
  103.  
  104. body line # ?? body line # ?? body line # ?? body line # ?? body line # ??
  105.  
  106.  
  107. PRINTING A FORMATTED FILE:
  108.  
  109. Simply type the following DOS command after you set up your printer to print:
  110.  
  111.     COPY OUTFILE.EXT PRN (or LPT1, LPT2, or LPT3 depending upon whether
  112.                           you have more than 1 printer or printer ports)
  113.  
  114. If you find PBREAK easy and convenient to use, a registration of $5 would be
  115. appreciated.  If you send $10 or more you will receive, when available, the 
  116. next version of the PBREAK program.  Please state the version & release date
  117. of the software that you currently have.  Please feel free to distribute the
  118. unmodified PBREAK.ZIP to others.  See ORDER.FRM for details.
  119.  
  120. Send check or money order to:  Dickson Computing, Ltd.
  121.                                411 Gravois Drive
  122.                                Shreveport, LA  71106
  123.  
  124.