chiark - git - mdw - mup/blob - mup/docs/uguide/include.html

   1 <HTML>
   2 <HEAD><TITLE>
   3 Mup 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>
  13 Include
  14 </H2>
  15 <P>
  16 The &quot;include&quot; statement can be used to include the contents of one file
  17 inside another.
  18 <BR><PRE>
  19 <B>include &quot;</B><I>filename</I><B>&quot;</B>
  20 </PRE><BR>
  21 causes input to be read from the specified <I>filename</I>. When the end
  22 of that file is reached, reading of input resumes from the original file
  23 after the include statement.
  24 </P>
  25 <P>
  26 If the <I>filename</I> cannot be found as is, and it is not an absolute
  27 path, and if the environment variable MUPPATH is set, Mup will search
  28 for the file in each directory listed in MUPPATH. On Unix systems, the
  29 directories are separated by colons. On systems with DOS-like file naming
  30 conventions, they are separated by semicolons.
  31 The MUPPATH may be useful if, for example, you have a number of &quot;boilerplate&quot;
  32 files that you want to include in lots of songs. You can put them in
  33 some directory and set MUPPATH to list that directory, then any Mup
  34 files 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>