lamf — Apollo

2.0; lamf (laminate_file), revision 2.0, 81/07/01
LAMF (LAMINATE_FILE) -- Laminate files.
usage: LAMF [pathname ...] [-S string ]


FORMAT

  LAMF [pathname... ] [-S string]


  LAMF laminates the named files to standard output.  That is, it concatenates
  the first lines of all input files, sequentially, and writes the result to
  standard output; and so on for the next input lines.  If the files contain
  different numbers of lines, null lines are used for the missing lines in the
  shorter files.

  Note:  To insert a NEWLINE character between lines, use the escape sequence,
         @n, as a string argument.  (See Example 4, below.)


ARGUMENT

  pathname
  (optional)       Specify name(s) of file(s) to be laminated to standard
                   output.  Multiple pathnames are permitted, separated by
                   blanks.
                   Default if omitted: read standard input for input lines.
                   Use a hyphen (-) to specify standard input in a list of
                   file names.


OPTION

  -S string        Specify a string of text to be placed in each output line at
                   the point it appears in the command argument list.  'String'
                   may not exceed 300 characters.  Strings containing embedded
                   spaces must be in quotes  (" ").


EXAMPLES

  1. $ lamf mary fred              Laminate files "mary" and "fred" and
                                    write results to standard output.

  2. $ lamf jan - george           Laminate lines from "jan", standard
                                    input, and "george", in that order.

  3. $ lamf -S "A line from Mary: " mary -S ", and from Fred: " fred

          would produce:

     A line from Mary: first line from mary, and from Fred: first line from fred

     Note that the text strings inserted are not bound in any way to the
     position of the pathname arguments: you may place strings wherever
     you please.  Those strings that contain literal blanks must be
     enclosed in quotes, as above.


     Escape sequences are valid in string arguments.  For example:

  4. $ lamf mary -S @n fred        Insert a NEWLINE character between each line
                                   from mary and fred.
Museum
