New upstream version 6.09.0~dfsg

4 files changed, 92 insertions, 6 deletions

diff --git a/scoregens/d.xml b/scoregens/d.xml
new file mode 100644
index 0000000..dddb25d
--- /dev/null
+++ b/scoregens/d.xml
@@ -0,0 +1,79 @@
+
+<refentry id="d">
+      <indexterm id="IndexDStatement"><primary>d statement</primary></indexterm>
+      <indexterm id="IndexDenoteStatement"><primary>denote statement</primary></indexterm>
+  <refmeta>
+    <refentrytitle>d Statement (De Note Statement)</refentrytitle>
+  </refmeta>
+
+  <refnamediv>
+    <refname>d</refname>
+    <refpurpose>
+      removes an active instrument at a specific time.
+    </refpurpose>
+  </refnamediv>
+
+  <refsect1>
+    <title>Description</title>
+    <para>
+      This statement calls for an instrument that has been held
+      to be removed at a specific time. 
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>Syntax</title>
+    <synopsis><command>i</command>  p1  p2  p3  p4</synopsis>
+  </refsect1>
+
+  <refsect1>
+    <title>Initialization</title>
+    <para>
+      <emphasis>p1</emphasis> -- Instrument number. An optional
+      fractional part can provide an additional tag for specifying
+      ties between particular notes of consecutive clusters.
+    </para>
+
+    <para>
+      <emphasis>p2</emphasis> -- Starting time in arbitrary units called beats.
+    </para>
+
+    <para>
+      <emphasis>p3</emphasis> -- ignored but required.  Usually zero.
+    </para>
+  </refsect1>
+ 
+  <refsect1>
+    <title>Performance</title>
+    <para>
+      Beats are evaluated as seconds, unless there is a <link linkend="t"><citetitle>t statement</citetitle></link> in this score section or a <link linkend="FlagsMinusLowerT"><citetitle>-t flag</citetitle></link> in the command-line.
+    </para>
+
+    <para>
+       Action times are relative to the beginning of a section ( see <link linkend="s"><citetitle>s statement</citetitle></link>), which is assigned time 0.
+    </para>
+
+    <para>
+      Note statements within a section may be placed in any order. Before being sent to an orchestra, unordered score statements must first be processed by Sorter, which will reorder them by ascending p2 value. Notes with the same p2 value will be ordered by ascending p1; if the same p1, then by ascending p3.
+    </para>
+  </refsect1>
+  
+  <refsect1>
+    <title>Examples</title>
+    <para>
+      Here is an example of the d statement. It uses the file <ulink url="examples/d_statement.csd"><citetitle>d_statement.csd</citetitle></ulink>.
+      <example>
+        <title>Example of the d statement.</title>
+        <xi:include href="examples-xml/d_statement.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+      </example>
+    </para>
+  </refsect1>
+
+  <refsect1>
+    <title>Credits</title>
+    <para>
+      Author: John ffitch, new in version 6.09.
+    </para>
+  </refsect1>
+</refentry>
+
diff --git a/scoregens/e.xml b/scoregens/e.xml
index c428af6..c75662f 100644
--- a/scoregens/e.xml
+++ b/scoregens/e.xml
@@ -21,13 +21,13 @@
  
   <refsect1>
     <title>Syntax</title>
-    <synopsis><command>e</command> [time]</synopsis>
+    <synopsis><command>e</command> [0 time]</synopsis>
   </refsect1>
  
   <refsect1>
     <title>Performance</title>
     <para>
-      The first p-field <emphasis>time</emphasis> is optional and if present determines the end time (length in beats) of the final section of the score.  This time must be after the end of the last event otherwise it will have no effect. "Always on" instruments will end at the given time. Extending the section in this way is useful to avoid prematurely cutting off reverb tails or other effects.
+      The second p-field <emphasis>time</emphasis> is optional and if present determines the end time (length in beats) of the final section of the score.  This time must be after the end of the last event otherwise it will have no effect. "Always on" instruments will end at the given time. Extending the section in this way is useful to avoid prematurely cutting off reverb tails or other effects.
     </para>
 
     <refsect2>
diff --git a/scoregens/i.xml b/scoregens/i.xml
index 52ff501..5d96018 100644
--- a/scoregens/i.xml
+++ b/scoregens/i.xml
@@ -29,7 +29,13 @@
   <refsect1>
     <title>Initialization</title>
     <para>
-      <emphasis>p1</emphasis> -- Instrument number, usually a non-negative integer. An optional fractional part can provide an additional tag for specifying ties between particular notes of consecutive clusters. A negative p1 (including tag) can be used to turn off a particular <quote>held</quote> note.
+      <emphasis>p1</emphasis> -- Instrument number, usually a
+      non-negative integer. An optional fractional part can provide an
+      additional tag for specifying ties between particular notes of
+      consecutive clusters. A negative p1 (including tag) can be used
+      to turn off a particular <quote>held</quote> note.  In the case
+      of a named instrument it can be negated by having a `-' as the first
+      character of the string.
     </para>
 
     <para>
diff --git a/scoregens/top.xml b/scoregens/top.xml
index 5046a94..bf9f784 100644
--- a/scoregens/top.xml
+++ b/scoregens/top.xml
@@ -67,6 +67,7 @@
     &scoregensa;
     &scoregensb;
     &scoregensC;
+    &scoregensd;
     &scoregense;
     &scoregensf;
     &scoregensi;
@@ -154,6 +155,9 @@
       <simpara><link linkend="GEN28"><citetitle>GEN28</citetitle></link> -  Reads a text file which contains a time-tagged trajectory.</simpara>
       </listitem>
       <listitem>
+      <simpara><link linkend="GEN43"><citetitle>GEN43</citetitle></link> - Loads a PVOCEX file containing a PV analysis.</simpara>
+      </listitem>
+      <listitem>
       <simpara><link linkend="GEN49"><citetitle>GEN49</citetitle></link>
       -  Transfers data from an MP3 soundfile into a function table.</simpara>
       </listitem>
@@ -201,9 +205,6 @@
       <listitem>
       <simpara><link linkend="GEN42"><citetitle>GEN42</citetitle></link> - Generates a random distribution of discrete ranges of values.</simpara>
       </listitem>
-      <listitem>
-      <simpara><link linkend="GEN43"><citetitle>GEN43</citetitle></link> - Loads a PVOCEX file containing a PV analysis.</simpara>
-      </listitem>
     </itemizedlist>
 
     <bridgehead>