home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource4 / 236_01 / 2up.doc < prev    next >
Encoding:
Text File  |  1989-06-07  |  2.6 KB  |  68 lines
  1. /*
  2.     HEADER:        CUG236;
  3.     TITLE:        Multi-Column Output Stacker Documentation;
  4.     DATE:        05/23/87;
  5.     FILENAME:    2UP.DOC;
  6.     SEE-ALSO:    2UP.C;
  7.     AUTHORS:    Eugene H. Mallory;
  8. */
  9.  
  10. *********************************************************************
  11. *                             2UP                                    *
  12. **********************************************************************
  13. *                  COPYRIGHT 1983 EUGENE H. MALLORY                  *
  14. **********************************************************************
  15. PROGRAM:
  16.     2UP - Format text into one or more columns.
  17.  
  18. USAGE:
  19.     2UP [<fid [-Nn] [-Cn] [-Ln] [-Mn] [-Sn] [-H] [>fid]
  20.  
  21. FUNCTION:
  22.     This is a pure filter which formats text into one or more columns.
  23.     It has several parameters which can be set on the command line.
  24.     
  25.     -Ln sets the page length. Default is 66. Maximum is 88.
  26.     
  27.     -Mn sets the left margin width.  It is normally zero.
  28.     
  29.     -Cn sets the column width after the left margin. Defaults to
  30.         divide 80 columns evenly.
  31.     
  32.     -Nn Sets the number of columns from 1 to 99.  2 is default.
  33.     
  34.     -Sn Sets the spacing between columns. Default is zero.
  35.     
  36.     -H displays the available options.
  37.     
  38. EXAMPLE:
  39.     LS *.* |2UP -L22 -L5             {Shows file names nicely.}
  40.     2UP <FILE.TXT -M10 -C28 -S4 <FILE.TXT {Nice vertical 2 column print}
  41.     2UP <FILE.TXT -M10 -N1 >FILE.TXT      {Puts a margin on text.}
  42.  
  43. COMMENTS:
  44.     Lines with backspaces or cr will not work properly with this
  45.     program.  It counts the number of characters without regard for
  46.     non-printing characters.
  47.     
  48.     Output generated by a text formatter or by page works well with 
  49.     this as long as underlining, bolding or other overstrike
  50.     actions are not done.
  51.  
  52.     Maximum column width is 132 characters.
  53.     
  54.         Command Line                       
  55. ___________________________________  
  56.                                   |  
  57.                                   |  
  58.                                   |  
  59.                                   | OPTIONS
  60.                                   |                  
  61.                     ______________V______________    
  62.  Standard Input     |                           |   Standard Output
  63.      TEXT           |                           |   MULTI-COLUMN TEXT
  64. ------------------->|          2UP              |----------------------->
  65.                     |                           |
  66.                     |                           |
  67.                     |___________________________|
  68.