1 MCL
 Multi-Column Lister

 MCL will reformat an ASCII file into a document with multiple columns
 on a page.  To enable MCL, enter the following at the DCL prompt:

     $ SET COMMAND CES_SHARE:MCL

 The format of an MCL command is:

     $ MCL input_file [/qualifiers...]
2 Input_file
 For the best results, the lines in the input file should be no longer
 than  the output column width.  Using a text formatter such as RUNOFF
 is an easy way to to produce an input  file  with  lines  of  uniform
 length.   MCL  uses  the following formula to determine output column
 width:

               (page_width - right_shift - 3 * (num_of_columns - 1))
   col_width = -----------------------------------------------------
                                  num_of_columns
2 Qualifiers
/COLUMNS

  /COLUMNS=n

  This qualifer specifies the number of output columns per page.   The
  number  requested must be in the range 1 through 9.  Lines which are
  too wide for the column will be wrapped or  truncated  according  to
  the setting of the /WRAP qualifier.  The default is /COLUMNS=2
/FF

  /FF=COLUMN (default)
  /FF=PAGE
  /NOFF

  This qualifier specifies the  type  of  action  MCL  takes  when  it
  encounters  an  embedded formfeed character.  If the formfeed is the
  first character in the input line:

      /FF=COLUMN instructs MCL to start a new column
      /FF=PAGE   instructs MCL to start a new page

  /NOFF indicates that all formfeeds  should  be  ignored.   Formfeeds
  that  do  not appear at the beginning of the line are ignored in any
  case.  MCL recognizes files written with FORTRAN  carriage  control,
  and will process the '1', '0', and blank characters correctly.
/FOOTER

  /FOOTER="text"

  This qualifier allows the user to specify a text  string  that  will
  appear on the bottom of every page.
/FTAB_EXPAND

  /[NO]FTAB_EXPAND

  If this qualifier is specified, tab characters  in  the  input  file
  will  be  expanded  according  to  the  manner  in which the Fortran
  compiler would interpret them; otherwise,  tab  characters  will  be
  expanded  to  the  standard  8-column  tab  step.   The  default  is
  /NOFTAB_EXPAND.
/HEADER

  /HEADER="text"
  /NOHEADER

  This qualifier allows the user to change the default MCL header line
  that  appears on every output page.  /NOHEADER eliminates the header
  line completely.
/LENGTH

  /LENGTH=n

  This qualifier specifies the number of output lines  per  page.   By
  default, MCL uses the value returned by LIB$LP_LINES minus 6.
/LOWER_CASE

  /[NO]LOWER_CASE

  If this qualifier is present, MCL converts all text  to  lower  case
  before writing it to the output file, /NOLOWER_CASE is the default.
/OUTPUT

  /OUTPUT=output_file_spec

  The output file may be named explicitly by means of this  qualifier.
  By  default,  MCL  uses  the input file name with the file extension
  .MCL.
/PAUSE

  /[NO]PAUSE

  If this qualifier is present, MCL will wait for the RETURN key to be
  pressed after writing each page of output.  This qualifier is useful
  when the terminal is specified as the output file.
/RIGHT

  /RIGHT=n

  This qualifier is used to shift the output text to the  right  by  N
  columns.   This  can  be  used  to allow space for punching holes in
  documents that will be stored in 3-ring binders.   /RIGHT  does  not
  change  the  overall  width  of  the output file, but will cause the
  width of the columns to shrink instead.  The default is /RIGHT=0
/SEPARATOR

  /SEPARATOR="char"

  This qualifier allows  the  user  to  change  the  column  separator
  character.  The default is /SEPARATOR="|".
/UPPER_CASE

  /[NO]UPPER_CASE

  If this qualifier is present, MCL converts all text  to  upper  case
  before writing it to the output file, /NOUPPER_CASE is the default.
/WIDTH

  /WIDTH=width

  This qualifier specifies the width of the output page (default=132).
/WRAP

  /[NO]WRAP

  If this qualifier is specified, a line which exceeds the page  width
  on  the  output  files will be continued on the following line.  The
  continuation line is flagged with  the  characters  "-->".   /NOWRAP
  causes a long line to be truncated on output.  /WRAP is the default.
