Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

1.1;macro, revision 1.1, 81/07/01
MACRO -- Expand macro definitions.
usage:  MACRO [-0] [pathname ...]


FORMAT

  MACRO [-0] [pathname ...]


  MACRO  is a general-purpose macro processor.  MACRO reads the files and writes
  to standard output a new file with the macro definitions deleted and the macro
  references expanded.

  Macros  permit  the  definition  of  symbolic  constants  so  that  subsequent
  occurrences of the constant are replaced by the defining string of characters.
  The general form of a macro definition is

            define(name,replacement text)

  All  subsequent  occurrences  of  "name"  in  the  file  will  be  replaced by
  "replacement text".  The placement of blanks in  definitions  is  significant;
  they  should only appear in the replacement text where desired.  Uppercase and
  lowercase letters are also significant.  The replacement text may be more than
  one line  long.    However,  when  an  entire  macro  definition  is  followed
  immediately  by a newline, the newline is discarded.  This prevents extraneous
  blank lines from appearing in the output.

  Macros  with  arguments  may  also  be  specified.    Any  occurrence  in  the
  replacement  text of "$n", where n is between 1 and 9, will be replaced by the
  nth argument when the macro is actually called.

  For complete details about the MACRO command, see the "DOMAIN  System  Command
  Reference Manual."


ARGUMENTS

  pathname
  (optional)          Specify file containing macro definitions to be processed.
                     Multiple pathnames are permitted.

                     Default if omitted:  read standard input


OPTIONS

  -0                 (Zero, not letter O) Remove one level of brackets in  macro
                     calls  prior  to  processing.  Normally, brackets appearing
                     outside any macro  calls  (level  zero  brackets)  are  NOT
                     removed.

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