<!-- Converted to DocBook/SGML by Kevin Conder -->
<chapter id="CommandTop">
  <title>The Csound Command</title>

  <para>
    <emphasis>Csound</emphasis> is a command for passing anorchestra file andscore file to Csound to generate a soundfile. The score file can be in one of many different formats, according to user preference. Translation, sorting, and formatting into orchestra-readable numeric text is handled by various preprocessors; all or part of the score is then sent on to the orchestra. Orchestra performance is influenced by command flags, which set the level of displays and console reports, specify I/0 filenames and sample formats, and declare the nature of real-time sensing and control.
  </para>

  <section id="CommandOrder">
    <title>Order of Precedence</title>

    <para>
      With some recent additions to Csound, there are now three places (and in some cases four) where options for Csound performance may be set. They are processed in the following order:

      <orderedlist>
        <listitem><para>Csound's own defaults</para></listitem>
        <listitem><para>.csoundrc file</para></listitem>
        <listitem><para>Csound command line</para></listitem>
        <listitem><para>&lt;CsOptions&gt; tag in a .csd file</para></listitem>
        <listitem><para>Orchestra header (for sr, kr, ksmps, nchnls)</para></listitem>
      </orderedlist>
    </para>

    <para>
       The last assignment of an option will override any earlier ones.
    </para>
  </section>

  &commanddesc;
  &commandflags;
  &commandunifile;
  &commandpreproc;

</chapter>
