Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

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.)


ARGUMENTS

  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.


OPTIONS

  -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 A: " a -S ", and from B: " b

        would produce:

     A line from A: first line from a, and from B: first line from b

  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, thus inter-
                                     leaving the lines from the two files.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026