home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / txtutl / manprep.arc / MANPREP.DOC < prev    next >
Text File  |  1987-12-14  |  3KB  |  79 lines
  1.  
  2.  
  3.  
  4.       MANPREP usage:
  5.                   
  6.                manprep [input file] [output file] [-l<n> | -l <n>]
  7.       
  8.       MANPREP converts a text file formatted for a "generic" printer
  9.       to a file formatted for on-line viewing.  I call the program
  10.       MANPREP in honor of the micro-MAN program written by David L. Rick.
  11.       
  12.       Most public domain programs are accompanied by a documentation
  13.       file.  This file is often formatted to print with proper
  14.       page spacing on a generic 66 line/page printer.  Blank lines
  15.       are used to format the document.  Although convenient for
  16.       printing, these blank lines are a nuisance when viewing
  17.       the documentation on-line.  Another common problem is the
  18.       use of backspaces to force overprinting.
  19.       
  20.       MANPREP reads the input file (or stdin), checks each line
  21.       for printable characters, and passes at most -l<n> (default
  22.       2) adjacent blank lines to the output file (or stdout).
  23.       MANPREP checks for backspace characters (ASCII 8) and if
  24.       found removes all backspaces and the character preceding
  25.       each one.
  26.  
  27.       MANPREP does not perform any magic with file names.  Specifying
  28.       no output file defaults to stdout (the console in most
  29.       cases).  Specifying the same input and output files
  30.       generates an error message.  You must manage all the
  31.       deleting, copying, and/or renaming of files.  A batch file
  32.       to automate the process might be:
  33.       
  34.          manprep %1.doc %1.vid 
  35.          if errorlevel 1 goto abort
  36.          del %1.doc
  37.          ren %1.vid %1.doc
  38.          :abort
  39.          
  40.       or, to save the old version with the extension "prn" :
  41.       
  42.          manprep %1.doc %1.vid 
  43.          if errorlevel 1 goto abort
  44.          ren %1.doc ren %1.prn
  45.          ren %1.vid %1.doc
  46.          :abort
  47.          
  48.       I often use the default output, stdout, to check the
  49.       results before creating an output file.  If things
  50.       look ok, just hit ^C to abort MANPREP and reissue
  51.       the command with the desired output file.
  52.       
  53. Author:
  54.  
  55.       Francis X. Guidry
  56.       2044 Mallard Drive
  57.       Walnut Creek, CA 94596
  58.  
  59. Licensing:
  60.  
  61.       Copyright 1987 Francis X. Guidry
  62.       All Rights Reserved
  63.  
  64.       Licensed for any use except distribution for profit.
  65.       
  66.       You use this program at your own risk.
  67.       
  68.       No warranty is expressed or implied.  The author accepts
  69.       no liability for any loss or damage due to use of this
  70.       program.
  71.  
  72. Revision history:
  73.       
  74.       1.1   -  14 December 1987  -  Add backspace filter,
  75.             remove special handling for form feed.
  76.             
  77.       1.0   -  25 November 1987  -  Original release.
  78.  
  79.