home *** CD-ROM | disk | FTP | other *** search
/ Current Shareware 1994 January / SHAR194.ISO / textutil / pgnat101.zip / PAGINATE.DOC < prev    next >
Text File  |  1993-10-22  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                                     PAGINATE
  7.                      Free DOS utility: text file paginator
  8.                         Version 1.01 - October 22, 1993
  9.                                     (c) 1993
  10.                                        by
  11.                              David Daniel Anderson
  12.                                    Reign Ware
  13.  
  14.  
  15.  
  16.  
  17.  
  18. PAGINATE prepares text files for printing by placing formfeeds (ASCII 12),
  19. also called page breaks, at user specified intervals.
  20.  
  21. Usage:   PAGINATE /i<infile> /o<outfile> /l##[:##] (lines per odd/even page)
  22. Example: PAGINATE /iNOTPAGED.TXT /oPAGED.TXT /l55
  23.  
  24. PAGINATE takes exactly three parameters on the command line. ALL ARE MANDATORY.
  25. The order is not significant, but the switch character ("/") and the first
  26. letter ("i" or "o" or "l") of each are.  The above example should be most
  27. helpful in understanding how to use this program.
  28.  
  29. Using the example above as a base, substitute the name of whatever file you
  30. want to paginate for NOTPAGED.TXT, and a currently *non-existent* file name
  31. for PAGED.TXT (since the program refuses to overwrite any existing file).
  32. PAGED.TXT will be identical to NOTPAGED.TXT except that a formfeed will be
  33. inserted at the interval specified after the "/l" parameter.  If "/l60" is
  34. specified, every page will have 60 lines (until the last, which will have
  35. the remainder).  If "/l0" is specified, a formfeed will be inserted at the
  36. beginning of the first line (literally, after "0" lines), and the rest of
  37. the file will be unaltered.  (Wildcards are not allowed.)
  38.  
  39. You can specify a different number of lines for odd and even pages by appending
  40. to the lines per page (/l##) parameter a colon (:) followed by another number.
  41. For instance, to get 50 lines on odd pages and 55 on even pages, simply specify
  42. "/l50:55" (without the quotes.)
  43.  
  44. A formfeed or pagebreak is accomplished by inserting the ASCII char. 12 into
  45. the document, which is represented by the intl. symbol for the female gender.
  46.  
  47. The files need not be in the current directory.  The maximum value of
  48. lines per page is 65535 (hardly a very useful page length anyway).
  49.  
  50. Finally, in case you are wondering I have chosen to have the formfeed placed
  51. at the beginning of a line instead of at the end, or even inserting an entire
  52. new line, it is based on how a printer interprets text.  At the end of every
  53. text line is a linefeed and carriage return (EOL), which prints as an *extra*
  54. blank line if there is also a formfeed at the "end" of the line or on a "blank"
  55. line. In order for the formfeed to act simply as a formfeed, and not add a
  56. line as well, it MUST precede the first character of the first line of text.
  57.  
  58. {------------------------------------------------------------------------------
  59.  
  60.                                 REVISION HISTORY
  61.  
  62. v1.00  : 1993/07/14.  First public release.  DDA
  63. v1.01  : 1993/10/22.  Now removes existing page breaks automatically.  DDA
  64.  
  65. ------------------------------------------------------------------------------}
  66.  
  67.