executes the given file name as a macro.
If the optional filename argument is not specified, the file
requester is opened, and you are prompted to select a file. (You can
inhibit the file requester opening by using the
command; see NoFileReq.)
If you escape from the file requester, you can input the file name on the command line.
Note that macros whose names do not conflict with a command can be called
ne is required to perform a command
it cannot find in its internal tables, it will look for a macro by that
name in the current directory. If this search also fails,
ne looks in
~/.ne and finally in the macros subdirectory of
global directory (defined when
ne was built, or in a place specified by
NE_GLOBAL_DIR environment variable) for a macro file by that name.
Warning: the first time a macro is executed it is cached
into a hash table and is kept forever in memory unless the
UnloadMacros command is issued; see UnloadMacros. The next time a
macro with the same file name is invoked, the cached list is searched for it
before accessing the file using a case insensitive string comparison. That is,
if you call
~/foobar/macro, a subsequent call for
MaCrO will use the cached version of
Note that the cache table is global to
ne and not specific to any single
document. This greatly improves efficiency when macros are used repeatedly.