# macro topic name and path file
# for the string_macros module
#
# pathname of macro file     Title string
# ----------------------     ------------
/usr/avs/runtime/hosts       This is macro 1
/tmp/xxx                     Here is another one
/fred                        The last one is a little longer

  Name: "string_macros"
  Type: (Input) (Subroutine) 
  Language: C
  Author: Ian_Curington, Advanced Visual Systems, Inc. 
  Output: string port, multi-line
  Parameters:
          Topic file browser ( configures the macro menu )  (string)
          Macro Choice browser list (for selecting a macro) (string)

  Description:
  ------------
  This module provides a string macro facility for annotated choice
  lists anywhere strings are used in an AVS network.
  The module reads a configuration macro list file,
  sets up a choice list of macros,
  then puts the contents of the macro file at the output port.

  Module-----------> Topic File ---------->Macro File 1
                            |------------->Macro File 2
                            |------------->Macro File 3
                            .....etc...

  The file format of the Topic File is clear ASCII text,
  blank lines or "#" comment lines are ignored,
  each line has a filename with path, followed by words describing the macro.
  An example is shown below:

# pathname of macro file     Title string
# ----------------------     ------------
/usr/avs/runtime/avsrc       This is macro 1
/tmp/xxx                     Here is another one
/fred/ginger                 The last one is a little longer

The contents of the macro file itself shoule be clear text,
can be one line or many lines, and is not interpreted.