Users may define up to three macro locations, called user libraries. In many
cases, such as when the user is selecting a macro to play, the user selects
both the specific user location and macro name. But there are a few cases,
listed below, where all of the user libraries are searched, looking for the
given macro name. In these cases, the user libraries will be searched in their
then-current order, and the first macro name match that is found will be used.
Because the order of the user libraries can change, it is important in these
situations that the macro name be unique across all of the user libraries,
to ensure that the correct macro is found.
Below is a list of the situations in which a macro name is searched across
all of the user locations:
A key is pressed which has been assigned to run a macro located in a user
library. When the user initially assigns the key to a macro, the key binding
is to the
macro name in a user location, but not to the specific directory path of
the user library. Therefore, when the user subsequently presses the assigned
key,
all user locations are searched for the given macro name.
A toolbar button
is clicked, which is configured to run a macro located in a user library.
Like the key binding in #1 above, the toolbar button is associated with a
macro
name in a user location, but not to a specific user location path. Therefore,
when the user clicks the button, all user locations will be searched for
the given macro name.
A poppad button is clicked which has been assigned to run a macro in a
user library. This situation is identical to the key assignment case in #1
above,
and all
user locations will be searched for the given macro name.
A session is launched
which is configured to autostart a macro. This situation is slightly different
than the three described above, in that all macro locations are searched,
not just the user locations. When an autostart macro is configured, only
the macro
name is configured. So when it is time to run the macro, there is no associated location
information, and so all locations are searched. See Auto-Start options for
more information.
