<-- previous page Table of Contents Index next page -->
The "include" statement can be used to include the contents of one file
inside another.
include "filename"
If the filename cannot be found as is, and it is not an absolute path, and if the environment variable MUPPATH is set, Mup will search for the file in each directory listed in MUPPATH. On Unix systems, the directories are separated by colons. On systems with DOS-like file naming conventions, they are separated by semicolons. The MUPPATH may be useful if, for example, you have a number of "boilerplate" files that you want to include in lots of songs. You can put them in some directory and set MUPPATH to list that directory; then any Mup files you have can refer to them. If a file by the name given is not found, and that name does not already have a .mup or .MUP suffix, the MUPPATH is searched again with suffix added. On systems where file names are case sensitive, .mup takes precedence over .MUP. If the file is not found in MUPPATH, then the directory of the "including" file is searched.