<-- 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"

causes input to be read from the specified filename. When the end of that file is reached, reading of input resumes from the original file after the include statement.

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.

   <-- previous page    Table of Contents    Index    next page -->