Imported Upstream version 5.12~dfsg

3 files changed, 325 insertions, 6 deletions

diff --git a/preface/history.xml b/preface/history.xml
index 060ca13..ede2901 100644
--- a/preface/history.xml
+++ b/preface/history.xml
@@ -48,7 +48,7 @@
         <row><entry>Matt Ingalls </entry></row>
         <row><entry>Richard Karpen </entry></row>
         <row><entry>&nameanthony;</entry></row>
-        <row><entry>Victor Lazzarini  </entry></row>
+        <row><entry>&namevictor;  </entry></row>
         <row><entry>Allan Lee</entry></row>
         <row><entry>David Macintyre </entry></row>
         <row><entry>&namegabriel;</entry></row>
diff --git a/preface/historyXO.xml b/preface/historyXO.xml
index 38e1f17..4270999 100644
--- a/preface/historyXO.xml
+++ b/preface/historyXO.xml
@@ -47,7 +47,7 @@
         <row><entry>Matt Ingalls </entry></row>
         <row><entry>Richard Karpen </entry></row>
         <row><entry>&nameanthony;</entry></row>
-        <row><entry>Victor Lazzarini  </entry></row>
+        <row><entry>&namevictor;  </entry></row>
         <row><entry>Allan Lee</entry></row>
         <row><entry>David Macintyre </entry></row>
         <row><entry>&namegabriel;</entry></row>
diff --git a/preface/whatsnew.xml b/preface/whatsnew.xml
index 9b333ce..6445ccd 100644
--- a/preface/whatsnew.xml
+++ b/preface/whatsnew.xml
@@ -1,6 +1,5 @@
 <section id="PrefaceWhatsNew"><title>What's new in Csound &csoundversion;</title>
-<!--     <bridgehead>New in Version 5.XX ()</bridgehead> -->
-<!--  <para>
+<!--     <bridgehead>New in Version 5.XX ()</bridgehead> --><!--  <para>
     <itemizedlist>
       <listitem>
         <para>New opcodes:
@@ -65,6 +64,326 @@
       </listitem>
     </itemizedlist>
   </para>-->
+ <bridgehead>New in Version 5.12 (January 2010)</bridgehead>
+ <para>
+   <itemizedlist>
+     <listitem>
+       <para>New opcodes:
+         <itemizedlist>
+           <listitem>
+             <simpara>
+	       <link linkend="transegr"><citetitle>transegr</citetitle></link>
+               is a version of
+               the <link linkend="transeg"><citetitle>transeg</citetitle></link>
+               opcode which has a release section which is triggered
+               by midi,
+               a <link linkend="turnoff2"><citetitle>turnoff2</citetitle></link>
+               opcode or a negative instrument
+               number <link linkend="i"><citetitle>i score event</citetitle></link>.
+	     </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       <link linkend="ftgenonce"><citetitle>ftgenonce</citetitle></link>
+               generates a function table from within an instrument
+               definition, without duplication of data.
+	     </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       The new <link linkend="SignalFlowGraphOpcodes"><citetitle>Signal
+		   Flow opcodes </citetitle></link> enable the usage of
+               signal flow graphs in Csound.
+	     </simpara>
+           </listitem>
+           <listitem>
+             <simpara><link linkend="passign"><citetitle>passign</citetitle></link>
+             allows quick initialization of i-rate variables from p-fields</simpara>
+           </listitem>
+           <listitem>
+             <simpara><link linkend="crossfm"><citetitle>crossfm</citetitle></link>
+             implements crossed fm synthesis.</simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       <link linkend="loopxseg"><citetitle>loopxseg</citetitle></link>
+               is
+               like <link linkend="loopseg"><citetitle>loopseg</citetitle></link>
+               but with exponential envelope.
+	     </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       <link linkend="looptseg"><citetitle>looptseg</citetitle></link>
+               is like <link linkend="loopseg"><citetitle>loopseg</citetitle></link>
+               but with a flexible envelope like <link linkend="transeg"><citetitle>transeg</citetitle></link> 
+	     </simpara>
+           </listitem>
+         </itemizedlist>
+       </para>
+     </listitem>
+     <listitem>
+       <para>Bug fixes and improvements:
+         <itemizedlist>
+           <listitem>
+             <simpara>    
+	       <link linkend="pvshift"><citetitle>pvshift</citetitle></link> would overwrite in double mode.
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       <link linkend="pan2"><citetitle>pan2</citetitle></link> case 3 fixed.
+             </simpara>
+           </listitem>
+  <!--           <listitem>-->
+ <!--             <simpara> -->
+<!-- 	       <link linkend="gettempo"><citetitle>gettempo</citetitle></link> now works. -->
+<!--              </simpara> -->
+  <!--          </listitem> -->
+           <listitem>
+             <simpara>
+	       <link linkend="clockon"><citetitle>clockon</citetitle></link>
+	       and  <link linkend="clockoff"><citetitle>clockoff</citetitle></link>
+	       now work again.
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       <link linkend="cross2"><citetitle>cross2</citetitle></link> and <link linkend="interp"><citetitle>interp</citetitle></link> could have divided by zero
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       linecount for error messages no longer includes text
+	       from <link linkend="CommandUnifileParFile"><citetitle>.csoundrc</citetitle></link>
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       <link linkend="p5gconnect"><citetitle>p5gconnect</citetitle></link>
+	       changed to use a separate thread to avoid timeout problem.
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       <link linkend="transeg"><citetitle>transeg</citetitle></link> checks argument count.
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       <link linkend="sfload"><citetitle>sfload</citetitle></link>
+               used to be limited to 10 sound fonts and was not policed.
+               Now open-ended.
+             </simpara>
+           </listitem>
+         </itemizedlist>
+       </para>
+     </listitem>
+     <listitem>
+       <para>
+         Internal Changes:
+         <itemizedlist>
+           <listitem>
+             <simpara>
+	       \&quot; allowed as an escape in orchestral strings
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       New parser fixed on optional arguments
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       Better checking of <link linkend="f"><citetitle>f</citetitle></link> statement with negative number
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       Soundfonts only initialise pitches array once, in the
+	       soundfont opcodes.
+             </simpara>
+           </listitem>
+           <listitem>
+             <simpara>
+	       Usual collection of gratuitous minor changes, layout and comments
+             </simpara>
+           </listitem>
+         </itemizedlist>
+       </para>
+     </listitem>
+   </itemizedlist>
+ </para>
+  <bridgehead>New in Version 5.11 (June 2009)</bridgehead>
+  <para>
+    <itemizedlist>
+      <listitem>
+        <para>New opcodes:
+          <itemizedlist>
+            <listitem>
+              <simpara><link linkend="mp3in"><citetitle>mp3in</citetitle></link>
+              allows reading of mp3 files directly in the orchestra.</simpara>
+            </listitem>
+            <listitem>
+              <simpara><link linkend="wiiconnect"><citetitle></citetitle>wiiconnect</link>, <link linkend="wiidata"><citetitle></citetitle>wiidata</link>, <link linkend="wiisend"><citetitle></citetitle>wiisend</link>, <link linkend="wiirange"><citetitle></citetitle>wiirange</link> opcodes by john ffitch to recieve and send data to a wiimote controller.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>New opcodes to receive data directly from a p5glove by john ffitch <link linkend="p5gdata"><citetitle>p5gdata</citetitle></link></simpara>
+            </listitem>
+            <listitem>
+              <simpara><link linkend="tabsum"><citetitle>tabsum</citetitle></link> sums sections of ftables</simpara>
+            </listitem>
+            <listitem>
+              <simpara><link linkend="MixerSetLevel_i"><citetitle>MixerSetLevel_i</citetitle></link> an init-time only version of <link linkend="MixerSetLevel"><citetitle>MixerSetLevel</citetitle></link></simpara>
+            </listitem>
+             <listitem>
+              <simpara><link linkend="doppler"><citetitle>doppler</citetitle></link>
+              implements a simulation of the doppler effect.</simpara>
+            </listitem>
+             <listitem>
+              <simpara><link linkend="filebit"><citetitle>filebit</citetitle></link> reports the file depth of a file.</simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          New functionality
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                New panning type for <link linkend="pan2"><citetitle></citetitle>pan2</link> opcode
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                New csd score tag &lt;CsExScore&gt;.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                New -Ma option for ALSA RT MIDI module which listens to all devices.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>There is a gen49 to read mp3 files
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Added rounding bin code to <link linkend="pvscale"><citetitle>pvscale</citetitle></link>
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+              Added non-power-of-2 table support for <link linkend="ftload"><citetitle>ftload</citetitle></link> and <link linkend="ftsave"><citetitle>ftsave</citetitle></link>
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+              GEN23 totally rewritten to be more consistent in what constitutes
+       a separator and comments. (Still no /* */ comments)
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Bug fixes and improvements:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                New examples for pvs opcodes by Joachim Heintz: <link linkend="pvsarp"><citetitle></citetitle>pvsarp</link>, <link linkend="pvscent"><citetitle></citetitle>pvscent</link>, <link linkend="pvsbandp"><citetitle></citetitle>pvsbandp</link>, <link linkend="pvsbandr"><citetitle></citetitle>pvsbandr</link>, <link linkend="pvsbufread"><citetitle></citetitle>pvsbufread</link>,  <link linkend="pvsadsyn"><citetitle></citetitle>pvsadsyn</link>,  <link linkend="pvsynth"><citetitle></citetitle>pvsynth</link>,  <link linkend="pvsblur"><citetitle></citetitle>pvsblur</link>,  <link linkend="pvscale"><citetitle></citetitle>pvscale</link>,  <link linkend="pvscross"><citetitle></citetitle>pvscross</link>,  <link linkend="pvsfilter"><citetitle></citetitle>pvsfilter</link>,  <link linkend="pvsfreeze"><citetitle></citetitle>pvsfreeze</link>,  <link linkend="pvshift"><citetitle></citetitle>pvshift</link>,  <link linkend="pvsmaska"><citetitle></citetitle>pvsmaska</link>,  <link linkend="pvsmorph"><citetitle></citetitle>pvsmorph</link>
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>Use of automatic numbering of ftables reuses table numbers
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara><link linkend="seed"><citetitle></citetitle>seed</link> with positive argument was wrong
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara><link linkend="sprintf"><citetitle></citetitle>sprintf</link> with an empty string printed wrong data
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara><link linkend="mute"><citetitle></citetitle>mute</link> now works with both numeric and named instruments
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>Small fixes in <link linkend="diskin"><citetitle></citetitle>diskin</link>, and in <link linkend="tablexkt"><citetitle></citetitle>tablexkt</link>
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Internal Changes:
+          <itemizedlist>
+            <listitem>
+              <simpara>SConstruct now builds completely independent shared libraries
+       for Python, Lua, and Java wrappers.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>New Parser almost usable
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara> Redrawing of graphs fixed so that only selected ones get redrawn.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>RT-alsa more forgiving on near sample rates
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>It is possible to have the score generated by an external program
+         rather than using standard score format using
+         &lt;CScore bin="translater"&gt; to call the program translater on the
+         score data
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>lpc_export fixed
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>Removed limit on macro names length
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>PMAX, the number of arguments to a score event has been reduced
+    by 2, and an overflow system introduced so GENs can have
+    arbitrary numbers of arguments.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>Increased API version to 2.1.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>    New API function pointer ldmemfile2withCB() which is
+       a version of ldmemfile() allowing a callback to be set and called
+       exactly once to process the MEMFIL buffer after it is loaded.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>csound->floatsize set; zero in earlier versions
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>GetChannelLock added
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+    </itemizedlist>
+  </para>
   <bridgehead>New in Version 5.10 (December 2008)</bridgehead>
   <para>
     <itemizedlist>
@@ -178,7 +497,7 @@
               <simpara>New <link linkend="vosim"><citetitle>vosim</citetitle></link> opcode by Rasmus Ekman which recreates the historic VOSIM (VOcal SIMulator) technique.</simpara>
             </listitem>
             <listitem>
-              <simpara>New <link linkend="dcblock2"><citetitle>dcblock2</citetitle></link> opcode by Victor Lazzarini.</simpara>
+              <simpara>New <link linkend="dcblock2"><citetitle>dcblock2</citetitle></link> opcode by &namevictor;.</simpara>
             </listitem>
             <listitem>
               <simpara>New Chua's oscillator model: <link linkend="chuap"><citetitle>chuap</citetitle></link> by Michael Gogins.</simpara>
@@ -189,7 +508,7 @@
             <listitem>
               <simpara>New ambisonic opcodes: <link linkend="bformdec1"><citetitle>bformdec1</citetitle></link> and <link linkend="bformenc1"><citetitle>bformenc1</citetitle></link>. These opcodes deprecate the older <link linkend="bformdec"><citetitle>bformdec</citetitle></link> and <link linkend="bformenc"><citetitle>bformenc</citetitle></link>.</simpara>
             </listitem>
-            <listitem>New Score control opcodes by Victor Lazzarini: <simpara><link linkend="rewindscore"><citetitle>rewindscore</citetitle></link> and <link linkend="setscorepos"><citetitle>setscorepos</citetitle></link>.</simpara>
+            <listitem>New Score control opcodes by &namevictor;: <simpara><link linkend="rewindscore"><citetitle>rewindscore</citetitle></link> and <link linkend="setscorepos"><citetitle>setscorepos</citetitle></link>.</simpara>
             </listitem>
           </itemizedlist>
         </para>