<!-- Converted to DocBook/SGML by Kevin Conder -->
<section id="mult">
  <title>Multiple File Score</title>
 
  <section>
    <title>Description</title>
    <para>
      Using the score in more than one file.
    </para>
  </section>
 
  <section>
    <title>Syntax</title>
    <synopsis><command>&num;include</command> <quote>filename</quote></synopsis>
  </section>
 
  <section>
    <title>Performance</title>
    <para>
      It is sometimes convenient to have the score in more than one file. This use is supported by the <emphasis>&num;include</emphasis> facility which is part of the macro system.  A line containing the text

      <indexterm id="IndexIncludeScore"><primary>&num;include</primary><secondary>score</secondary></indexterm>
      <indexterm id="IndexMultiFileScore"><primary>multiple file scores</primary></indexterm>

      <informalexample>
        <programlisting>
<emphasis>&num;include</emphasis> &quot;filename&quot;
        </programlisting>
      </informalexample>

      where the character <emphasis>&quot;</emphasis> can be replaced by any suitable character.  For most uses the double quote symbol will probably be the most convenient. The file name can include a full path.
    </para>

    <para>
      This takes input from the named file until it ends, when input reverts to the previous input.  There is currently a limit of 20 on the depth of included files and macros.
    </para>

    <para>
      A suggested use of <emphasis>&num;include</emphasis> would be to define a set of macros which are part of the composer's style.  It could also be used to provide repeated sections.

      <informalexample>
        <programlisting>
s
#include :section1:
;; Repeat that
s
#include :section1:
        </programlisting>
      </informalexample>
    </para>

    <para>
      Alternative methods of doing repeats, use the <link linkend="r"><citetitle>r statement</citetitle></link>, <link linkend="m"><citetitle>m statement</citetitle></link>, and <link linkend="n"><citetitle>n statement</citetitle></link>.
    </para>
  </section>
 
  <section>
    <title>Credits</title>
    <para>Author: &namejohn;</para>
    <para>University of Bath/Codemist Ltd.</para>
    <para>Bath, UK</para>
    <para>April, 1998 (New in Csound version 3.48)</para>
    <para>Thanks to &nameluis; for pointing out the incorrect syntax in multiple file include statement.</para>
  </section>
</section>
