*********************************************************************
*                             2UP                                    *
**********************************************************************
*                  COPYRIGHT 1983 EUGENE H. MALLORY                  *
**********************************************************************
PROGRAM:
    2UP - Format text into one or more columns.

USAGE:
    2UP [<fid [-Nn] [-Cn] [-Ln] [-Mn] [-W] [-Sn] [-H] [>fid]

FUNCTION:
    This is a pure filter which formats text into one or more columns.
    It has several parameters which can be set on the command line.
    
    -Ln sets the page length. Default is 66. Maximum is 88.
    
    -Mn sets the left margin width.  It is normally zero.
    
    -Cn sets the column width after the left margin. Defaults to
        divide 80 columns evenly.
    
    -Nn Sets the number of columns from 1 to 99.  2 is default.
    
    -Sn Sets the spacing between columns. Default is zero.
    
    -W waits at the begining of each page. This is only useful
    when paging material to the screen.  A CR releases the wait.
    
    -H displays the available options.
    
EXAMPLE:
    LS *.* |2UP -L22 -W -L5  	 	  {Shows file names nicely.}
    2UP <FILE.TXT -M10 -C28 -S4 <FILE.TXT {Nice vertical 2 column print}
    2UP <FILE.TXT -M10 -N1 >FILE.TXT      {Puts a margin on text.}

COMMENTS:
    Lines with backspaces or cr will not work properly with this
    program.  It counts the number of characters without regard for
    non-printing characters.
    
    Output generated by a text formatter or by page works well with 
    this as long as underlining, bolding or other overstrike
    actions are not done.

    Maximum column width is 132 characters.
    
        Command Line                       
___________________________________  
                                  |  
                                  |  
                                  |  
                                  | OPTIONS
                                  |                  
                    ______________V______________    
 Standard Input     |                           |   Standard Output
     TEXT           |                           |   MULTI-COLUMN TEXT
------------------->|          2UP              |----------------------->
                    |                           |
                    |                           |
                    |___________________________|
