chiark / gitweb /
Merge branch 'arkkra' into shiny
[mup] / mup / docs / uguide / include.html
CommitLineData
69695f33
MW
1<HTML>
2<HEAD><TITLE>
3Mup include files
4</TITLE></HEAD>
5<BODY>
6<P>
7&nbsp;&nbsp;&nbsp;<A HREF="ifclause.html">&lt;-- previous page</A>
8
9&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="fontfile.html">next page --&gt;</A>
10</P>
11
12<H2>
13Include
14</H2>
15<P>
16The &quot;include&quot; statement can be used to include the contents of one file
17inside another.
18<BR><PRE>
19<B>include &quot;</B><I>filename</I><B>&quot;</B>
20</PRE><BR>
21causes input to be read from the specified <I>filename</I>. When the end
22of that file is reached, reading of input resumes from the original file
23after the include statement.
24</P>
25<P>
26If the <I>filename</I> cannot be found as is, and it is not an absolute
27path, and if the environment variable MUPPATH is set, Mup will search
28for the file in each directory listed in MUPPATH. On Unix systems, the
29directories are separated by colons. On systems with DOS-like file naming
30conventions, they are separated by semicolons.
31The MUPPATH may be useful if, for example, you have a number of &quot;boilerplate&quot;
32files that you want to include in lots of songs. You can put them in
33some directory and set MUPPATH to list that directory, then any Mup
34files you have can refer to them.
35</P>
36<HR><P>
37&nbsp;&nbsp;&nbsp;<A HREF="ifclause.html">&lt;-- previous page</A>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="index.html">Table of Contents</A>&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="fontfile.html">next page --&gt;</A>
38</P>
39</BODY></HTML>