New upstream version 6.12.0~dfsg

6 files changed, 44 insertions, 16 deletions

diff --git a/scoregens/gen01.xml b/scoregens/gen01.xml
index b805ea5..496f4d3 100644
--- a/scoregens/gen01.xml
+++ b/scoregens/gen01.xml
@@ -43,18 +43,18 @@
     </para>

 

     <para>

-      <emphasis>format</emphasis> -- for raw files specifies the audio

-      data-file format: 

+   <emphasis>format</emphasis> -- if positive it is ignored, but if

+      negative specifies the audio format of a raw file.

         <literallayout>

-        1 - 8-bit signed character

-        2 - 8-bit A-law bytes

-        3 - 8-bit U-law bytes

-        4 - 16-bit short integers

-        5 - 32-bit long integers

-        6 - 32-bit floats

-        7 - 8-bit unsigned character

-        8 - 24-bit integers

-        9 - 64-bit doubles</literallayout>

+        -1 - 8-bit signed character

+        -2 - 8-bit A-law bytes

+        -3 - 8-bit U-law bytes

+        -4 - 16-bit short integers

+        -5 - 32-bit long integers

+        -6 - 32-bit floats

+        -7 - 8-bit unsigned character

+        -8 - 24-bit integers

+        -9 - 64-bit doubles</literallayout>

     </para>

     <note><para>This list is not the same as in <link

     linkend="diskin"><citetitle>diskin2</citetitle></link></para></note>

@@ -151,7 +151,7 @@
     <title>Credits</title>

     <para>September 2003. Thanks goes to Dr. Richard Boulanger for

     pointing out the references to the AIFF file format.</para>

-    <para>Revised in v6.11 to clarify status of headers and raw files,

+    <para>Revised in v6.11 and v6.12 to clarify status of headers and raw files,

     and to add three more sample formats.</para>

   </refsect1>

 </refentry>

diff --git a/scoregens/gen02.xml b/scoregens/gen02.xml
index 282403f..2cfa9bd 100644
--- a/scoregens/gen02.xml
+++ b/scoregens/gen02.xml
@@ -27,17 +27,28 @@
   <refsect1>

     <title>Initialization</title>

     <para>

-      <emphasis>size</emphasis> -- number of points in the table. Must be a power of 2 or a power-of-2 plus 1 (see <link linkend="f"><citetitle>f statement</citetitle></link>). The maximum tablesize is 16777216 (2<superscript>24</superscript>) points.

+      <emphasis>size</emphasis> -- number of points in the table.

+      <!-- Must be a power of 2 or a power-of-2 plus 1 (see <link -->

+      <!-- linkend="f"><citetitle>f statement</citetitle></link>). -->

+      The maximum tablesize is 16777216

+      (2<superscript>24</superscript>) points.

+      The value may be given as zero, in which case the number of values

+      decides the table length.

     </para>

 

     <para>

-      <emphasis>v1, v2, v3,</emphasis> etc. -- values to be copied directly into the table space. The number of values is limited by the compile-time variable <emphasis>PMAX</emphasis>, which controls the maximum pfields (currently 1000). The values copied may include the table guard point; any table locations not filled will contain zeros.

+      <emphasis>v1, v2, v3,</emphasis> etc. -- values to be copied

+      directly into the table space.

+      <!-- The number of values is limited by the compile-time variable -->

+      <!-- <emphasis>PMAX</emphasis>, which controls the maximum pfields -->

+      <!-- (currently 1000). -->

+      The values copied may include the table guard point; any table locations not filled will contain zeros.

     </para>

 

     <note>

       <title>Note</title>

       <para>

-        If p4 (the GEN routine number is positive, the table will be

+        If p4 (the GEN routine number) is positive, the table will be

         post-normalized (rescaled to a maximum absolute value of 1 after

         generation). A negative p4 will cause rescaling to be skipped. You will

         usually want to use -2 with this GEN function, so that your values are

@@ -115,6 +126,8 @@
 

   <refsect1>

     <title>Credits</title>

-    <para>December 2002. Thanks to &namerasmus;, corrected the limit of the <emphasis>PMAX</emphasis> variable.</para>

+    <para>December 2002. Thanks to &namerasmus;, corrected the limit

+    of the <emphasis>PMAX</emphasis> variable.</para>

+    <para>Use of length zero new in version 6.12</para>

   </refsect1>

 </refentry>

diff --git a/scoregens/gen31.xml b/scoregens/gen31.xml
index 620aec8..b52511b 100644
--- a/scoregens/gen31.xml
+++ b/scoregens/gen31.xml
@@ -52,6 +52,18 @@
   </refsect1>
 
   <refsect1>
+    <title>Examples</title>
+    <para>
+      Here is an example of the GEN31 routine. It uses the files <ulink url="examples/gen31.csd"><citetitle>gen31.csd</citetitle></ulink>.
+      <example>
+        <title>Example of the GEN31 routine.</title>
+        <para>See the sections <link linkend="UsingRealTime"><citetitle>Real-time Audio</citetitle></link> and <link linkend="CommandFlags"><citetitle>Command Line Flags</citetitle></link> for more information on using command line flags.</para>
+        <xi:include href="examples-xml/gen31.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
+      </example>
+    </para>
+  </refsect1>
+  
+  <refsect1>
     <title>Credits</title>
     <para>Author: &nameistvan;</para>
     <para>New in version 4.15</para>
diff --git a/scoregens/genfarey.xml b/scoregens/genfarey.xml
index 644ff1a..c83f1f4 100644
--- a/scoregens/genfarey.xml
+++ b/scoregens/genfarey.xml
@@ -14,6 +14,7 @@
   
   <refsect1>
     <title>Description</title>
+    <para>Plugin gen in fareygen.</para>
     <para>
       A Farey Sequence F<subscript>n</subscript> of order n is a list of fractions in their lowest terms between 0 and 1 and in ascending order. Their denominators do not exceed n. 
       This means a fraction a/b belongs to F<subscript>n</subscript> if 0 &le; a &le; b &le; n.
diff --git a/scoregens/genpadsynth.xml b/scoregens/genpadsynth.xml
index 1824037..bb86ef2 100644
--- a/scoregens/genpadsynth.xml
+++ b/scoregens/genpadsynth.xml
@@ -14,6 +14,7 @@
 
   <refsect1>
     <title>Description</title>
+    <para>Plugin gen in padsynth.</para>
     <para>
 Paul Octavian Nasca's "padsynth algorithm" adds bandwidth to each partial of a
 periodic weaveform. This bandwidth is heard as color, movement, and additional
diff --git a/scoregens/genquadbezier.xml b/scoregens/genquadbezier.xml
index e7bc69f..7cf1595 100644
--- a/scoregens/genquadbezier.xml
+++ b/scoregens/genquadbezier.xml
@@ -14,6 +14,7 @@
 
   <refsect1>
     <title>Description</title>
+    <para>Plugin gen in quadbezier.</para>
     <para>
       This subroutine creates an ftable from segments constructed by
       paths traced by the quadratic Bézier function.