Imported Upstream version 5.09+cvs20081203

3 files changed, 79 insertions, 7 deletions

diff --git a/preface/copy.xml b/preface/copy.xml
index 66404ec..2c081dc 100644
--- a/preface/copy.xml
+++ b/preface/copy.xml
@@ -2,7 +2,7 @@
 <section id="PrefaceCopy">
   <title>Copyright Notice</title>
   <para>
-    This version of the Csound Manual ("The Canonical Csound Manual") is released under the <ulink url="http://www.gnu.org/licenses/fdl.txt">GNU Free Documentation Licence</ulink>. Below are listed for historical reasons previous copyrights and requests for credit from previous authors.
+    This version of the Csound Manual ("The Canonical Csound Manual") is released under the <ulink url="http://www.gnu.org/licenses/fdl.txt">GNU Free Documentation Licence</ulink>. Below are listed, for historical purposes, previous copyrights and requests for credit from previous authors.
   </para>
   <simplesect id="ManualLicense">
     <title>Previous copyright notices</title>
@@ -13,7 +13,7 @@
       Developed by <emphasis>&namebarry;</emphasis> at the Experimental Music Studio, Media Laboratory, M.I.T., Cambridge, Massachusetts, with partial support from the System Development Foundation and from National Science Foundation Grant # IRI-8704665.
     </para>
   </simplesect>
-  <simplesect id="ManualLicense">
+  <simplesect>
     <title>Manual</title>
     <para>
       Copyright (c) 2003 by &namekevin; for modifications made to the Public Csound Reference Manual.
diff --git a/preface/gettingstarted.xml b/preface/gettingstarted.xml
index 7c0a65c..272f485 100644
--- a/preface/gettingstarted.xml
+++ b/preface/gettingstarted.xml
@@ -9,7 +9,7 @@
   </para>
   <bridgehead>Running</bridgehead>
   <para>
-    Csound can be run in different ways. Since Csound is a command line program (DOS in Windows terms), just clicking on the csound executable will have no effect. Csound must be called either from a terminal (or DOS prompt), or from a front-end. To use Csound from the command line, you must open a <emphasis>Terminal</emphasis> (DOS prompt on Windows). Using Csound from the command line can be hard if you've never used the terminal, so you may want to try to use one of the front-ends included with your distribution. A <link linkend="OviewFrontEnds"><citetitle>front-end</citetitle></link> is a graphical program that assists running Csound and can usually help edit csound files.
+    Csound can be run in different ways. Since Csound is a command line program (DOS in Windows terms), just clicking on the csound executable will have no effect. Csound must be called either from a terminal (or DOS prompt), or from a front-end. To use Csound from the command line, you must open a <emphasis>Terminal</emphasis> (Command Prompt or DOS Prompt on Windows). Using Csound from the command line can be difficult if you've never used the terminal, so you may want to try to use one of the front-ends included with your distribution. A <link linkend="OviewFrontEnds"><citetitle>front-end</citetitle></link> is a graphical program that assists running Csound and can usually help edit csound files.
   </para>
   <para>
     Both in the case of front-ends as well as execution from the command line, Csound needs two things:
@@ -44,11 +44,11 @@ csound oscil.csd</screen>
   <para>
     The example files are configured to run in realtime by default, so you should have heard a 2 second sine wave.
   </para>
-  <bridgehead>Writing your own csd files</bridgehead>
+  <bridgehead>Writing your own .csd files</bridgehead>
   <para>A <emphasis>.csd</emphasis> file looks like this (this file is <ulink url="examples/oscils.csd"><citetitle>oscils.csd</citetitle></ulink>):</para>
 <xi:include href="examples-xml/oscils.csd.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
   <para>
-    Csound's <link linkend="CommandUnifile"><citetitle>.csd</citetitle></link> files contain 3 main sections contained within <emphasis>&lt;CsSynthesizer&gt;</emphasis> and <emphasis>&lt;/CsSynthesizer&gt;</emphasis> tags:
+    Csound's <link linkend="CommandUnifile"><citetitle>.csd</citetitle></link> files have 3 main sections between the <emphasis>&lt;CsSynthesizer&gt;</emphasis> and <emphasis>&lt;/CsSynthesizer&gt;</emphasis> tags:
     <itemizedlist>
       <listitem>
         <simpara><emphasis>CsOptions</emphasis> - Includes the <link linkend="CommandFlagsCategory"><citetitle>Command Line flags</citetitle></link> specific to this particular file. These options can also be set using the <link linkend="CommandUnifileParFile"><citetitle>.csoundrc</citetitle></link> file or directly in the <link linkend="CommandDesc"><citetitle>command line</citetitle></link>. Some frontends also provide ways to specify global or local options.
diff --git a/preface/whatsnew.xml b/preface/whatsnew.xml
index 2e115c4..7f17b25 100644
--- a/preface/whatsnew.xml
+++ b/preface/whatsnew.xml
@@ -74,19 +74,50 @@
             <listitem>
               <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>
+            </listitem>
+            <listitem>
+              <simpara>New Chua's oscillator model: <link linkend="chuap"><citetitle>chuap</citetitle></link> by Michael Gogins.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>New <link linkend="linearalgebraopcodes"><citetitle>Linear Algebra</citetitle></link> opcodes by Michael Gogins. Standard Linear algebra over real and complex vectors and matrices: elementwise arithmetic, norms, transpose and conjugate, inner products, matrix inverse, LU decomposition, QR decomposition, and QR-based eigenvalue decomposition. Includes copying vectors to and from a-rate signals, function tables, and f-signals.</simpara>
+            </listitem>
+            <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>
           </itemizedlist>
         </para>
       </listitem>
       <listitem>
         <para>
-          New functionality
+          New functionality:
           <itemizedlist>
             <listitem>
               <simpara>
+                The <emphasis>vbap</emphasis> family of opcodes (<link linkend="vbap4"><citetitle>vbap4</citetitle></link>, <link linkend="vbap8"><citetitle>vbap8</citetitle></link>, <link linkend="vbap16"><citetitle>vbap16</citetitle></link> and <link linkend="vbapz"><citetitle>vbapz</citetitle></link>) now accept k-rate variables for all their input arguments.
               </simpara>
             </listitem>
             <listitem>
               <simpara>
+                New pulseaudio I/O module on Linux.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                New optional <emphasis>ienv</emphasis> parameter to generate envelopes for the soundfont opcodes: <link linkend="sfplay"><citetitle>sfplay</citetitle></link>,  <link linkend="sfplay3"><citetitle>sfplay3</citetitle></link>,  <link linkend="sfplaym"><citetitle>sfplaym</citetitle></link> and  <link linkend="sfplay3m"><citetitle>sfplay3m</citetitle></link>.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Added 'skip normalisation argument'  to "tanh" named GEN routine. (See <link linkend="ScoreGenRef"><citetitle>Named GEN Routines</citetitle></link>)
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Added scheduler priority option on alsa.
               </simpara>
             </listitem>
           </itemizedlist>
@@ -97,10 +128,42 @@
           <itemizedlist>
             <listitem>
               <simpara>
+                Allow scientific notation (as was in csound4!) in <link linkend="GEN23"><citetitle>GEN23</citetitle></link>.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Fixed bug in FLTK initialization. Should make FLTK usage more stable.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Error on /* */ comments in orchestra fixed.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                <link linkend="poscil"><citetitle>poscil</citetitle></link> no longer overwrites frequency if variable is shared.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                <link linkend="printk"><citetitle>printk</citetitle></link> and <link linkend="printks"><citetitle>printks</citetitle></link> check that opcode is initialised.
               </simpara>
             </listitem>
             <listitem>
               <simpara>
+                Deprecate <link linkend="soundout"><citetitle>soundout</citetitle></link> and <link linkend="soundouts"><citetitle>soundouts</citetitle></link> in favour of <link linkend="fout"><citetitle>fout</citetitle></link>.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Fixed <link linkend="space"><citetitle>space</citetitle></link> opcode to accept non-pow-2 (deferred) tables.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Fixed <link linkend="pvsmorph"><citetitle>pvsmorph</citetitle></link> bug.
               </simpara>
             </listitem>
           </itemizedlist>
@@ -112,18 +175,27 @@
           <itemizedlist>
             <listitem>
               <simpara>
+                New parser has #include and argumentless macros.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Less casting between floats and doubles in float version.
               </simpara>
             </listitem>
             <listitem>
               <simpara>
+                Includes experimental multicore support.
               </simpara>
             </listitem>
             <listitem>
               <simpara>
+                <link linkend="buzz"><citetitle>buzz</citetitle></link> opcode rewritten.
               </simpara>
             </listitem>
             <listitem>
               <simpara>
+                Many other internal changes and small bug fixes.
               </simpara>
             </listitem>
           </itemizedlist>
@@ -178,7 +250,7 @@
             </listitem>
             <listitem>
               <simpara>
-                New "no-carry" operator (!) for score language that prevents implicit carrying of p-fields in i-statements.
+                New "no-carry" operator (<link linkend="ScoreCarry"><citetitle>!</citetitle></link> ) for score language that prevents implicit carrying of p-fields in i-statements.
               </simpara>
             </listitem>
             <listitem>