Syntax



MACLIB


[ Macro-SET-Name | NONE ]


Operands


Macro-SET-Name

The name of a SET symbol containing the filename string, or NONE to remove any existing value(s)


Description


The MACLIB command will setup an alternate Macro folder to be used in place of the normal \Documents\MACROS\ folder.

The specified folder(s) will be used when editing files using the current Profile.


The MACLIB support also allows you to specify multiple folders as search cadidates for the macro. And because the MACLIB value can thus be quite long, it would be very difficult to enter the value correctly as an operand on the command line. Therefore the MACLIB command expects only the name of a SET symbol. The full SET symbol name is MACLIB.name


To enter the needed SET variable, do the following:


    1. Enter the primary command SET.  SPFLite will open a (SETEdit) session containing any current SET variables.


    1. Add a new line containing, for example:

MACLIB.MYNAME = C:\MyStuff\MyMacros\|C:\Users\Me\Documents\SPFLite\MACROS\

If you want the standard MACROS folder to remain available, it must also be specified in the entry, as is done in the above example.


    1. Enter the primary command END. The SET variables will be saved


The MYNAME above is your choice, it must match the Macro-SET-Name you entered on the MACLIB command. The example above adds the normal MACROS folder after the new user folder, but there is no requirement to do so. You may enter any folder(s) you desire.


When entering multiple MACLIB paths, separate them with a "|" character.


NOTE: If the SET variable (MACLIB.myname) does not exist, you will receive a warning message from the MACLIB command. You should immediately create the SET entry. If the SET entry is never created, then when any macro is attempted, the search for it will only use the standard MACROS folder.


Dynamic Maclib Specification


Creating the SET entry as described above is mandatory. If you prefer to NOT use MACLIB to set a Profile to switch libraries, you can dynamically request a different maclib by prefixing the macro name with the SET name.


e.g.  AA:macname      where AA is the MACLIB.AA entry in the SET table, and macname is the macro name.


 Note: If MACLIB is specified in the Profile, and the dynamic prefix is also used, the dynamic specification takes precedence.