Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ macro — Apollo

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 onto the 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