<!-- Converted to DocBook/SGML by Kevin Conder -->
<refentry id="s">
  <refmeta>
    <refentrytitle>s Statement</refentrytitle>
  </refmeta>
 
  <refnamediv>
    <refname>s</refname>
    <refpurpose>
      Marks the end of a section.
      <indexterm id="IndexSStatement"><primary>s statement</primary></indexterm>
    </refpurpose>
  </refnamediv>
 
  <refsect1>
    <title>Description</title>
    <para>
      The <emphasis>s statement</emphasis> marks the end of a section.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Syntax</title>
    <synopsis><command>s</command> anything</synopsis>
  </refsect1>
 
  <refsect1>
    <title>Initialization</title>
    <para>
      All p-fields are ignored.
    </para>
  </refsect1>
 
  <refsect1>
    <title>Performance</title>
    <para>
      Sorting of the <link linkend="i"><citetitle>i statement</citetitle></link>, <link linkend="f"><citetitle>f statement</citetitle></link> and <link linkend="a"><citetitle>a statement</citetitle></link> by action time is done section by section.
    </para>

    <para>
      Time warping for the <link linkend="t"><citetitle>t statement</citetitle></link> is done section by section.
    </para>

    <para>
      All action times within a section are relative to its beginning. A section statement establishes a new relative time of 0, but has no other reinitializing effects (e.g. stored function tables are preserved across section boundaries).
    </para>

    <para>
      A section is considered complete when all action times and finite durations have been satisfied (i.e., the &quot;length&quot; of a section is determined by the last occurring action or turn-off). A section can be extended by the use of an <link linkend="f"><citetitle>f0 statement</citetitle></link>.
    </para>

    <para>
      A section ending automatically invokes a Purge of inactive instrument and data spaces.
    </para>

    <note>
      <title>Note</title>
      <para>
        <itemizedlist>
          <listitem>
            <para>
              Since score statements are processed section by section, the amount of memory required depends on the maximum number of score statements in a section. Memory allocation is dynamic, and the user will be informed as extra memory blocks are requested during score processing.
            </para>
          </listitem>

          <listitem>
            <para>
              For the end of the final section of a score, the <emphasis>s statement</emphasis> is optional; the <link linkend="e"><citetitle>e statement</citetitle></link> may be used instead.
            </para>
          </listitem>
        </itemizedlist>
    </para>
    </note>
  </refsect1>
</refentry>
