/*
HEADER:CUG236;
TITLE:Multi-Column Output Stacker Documentation;
DATE:05/23/87;
FILENAME:2UP.DOC;
SEE-ALSO:2UP.C;
AUTHORS:Eugene H. Mallory;
*/

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

USAGE:
2UP [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.

-H displays the available options.

EXAMPLE:
LS *.* |2UP -L22 -L5 {Shows file names nicely.}
2UP 2UP 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 |----------------------->
| |
| |
|___________________________|