1 SPCOPY
!
The SPCOPY command is used to copy or print a file, performing one (or both)
of the two following transformations:

 1. Convert all non-printing special characters to printed representations;
    for example, the ASCII control character ESCAPE prints as "<ESC>".

 2. Divide the output file into pages, and optionally print a one-line page
    heading at the top of each page, giving the file name, page number, and,
    optionally, the date.

The syntax of the SPCOPY command is:

	$ SPCOPY  [qualifier(s)]  input_file(s),...  output_specification

At least one qualifier must be specified.

2 Parameters
!
The first parameter to SPCOPY is the name(s) of the file(s) to be copied.
A comma-separated list of files may be specified; filenames may contain
wildcards.  If more than one file is specified, the output will be one
file containing the appended contents of all input files.

The second parameter to SPCOPY can be either:

 1. A file name.  Example:  $  SPCOPY /SPECIAL  *.COM  COMS.TXT

 2. An LQP or PRINT command:  $ SPCOPY /SPECIAL  *.COM  PRINT /COPIES=2
			      $ SPCOPY /HEADERS  *.COM  LQP /NOPUNCH

    If an LQP or PRINT command is used, SPCOPY copies the input file(s)
    to a temporary file, named "000-SPCOPY.TMP", which gets deleted
    after being printed.
!
2 Qualifiers
/HEADERS

  /HEADERS
  /HEADERS=DATE

  If /HEADERS is specified, SPCOPY divides the output into pages, and
  places a page heading at the top of each page.  By default, the pages
  are 58 lines long; this can be changed by using the /PAGE qualifier.

  The heading is always 80 columns wide.  It shows the file name and the
  page number (1,2,...).  If the file name is too long, it is truncated
  to fit.

  If /HEADERS=DATE is specified, the heading also shows the current date
  and time.  Note that this leaves fewer columns for the file name.

/PAGE

  /PAGE
  /PAGE=n

  If /PAGE is specified, SPCOPY divides the output into pages, by placing
  form-feed characters at intervals in the file.  By default, the pages
  are 58 lines long; the desired page size can be specified as an integer
  value on the /PAGE qualifier.  Values from 12 to 300 are accepted.

/SPECIAL

  /SPECIAL
  /SPECIAL=TABS

  If /SPECIAL is used, then all non-printable ASCII control characters are
  converted into printable representations.  For example, form-feeds are
  shown as "<FF>", and bell characters are shown as "<BEL>".

  TAB characters are not converted unless /SPECIAL=TABS is specified, in
  which case tabs are shown as "<HT>" (Horizontal Tab).

  If this conversion causes a line to become over 132 columns wide, the
  line will be truncated, and a diagnostic will be issued when SPCOPY
  finishes.

/VERSION

  If /VERSION is specified, no other qualifiers, and no parameters,
  can be specified on the SPCOPY command line.  SPCOPY will display
  its version number and exit.
