Imported Upstream version 5.08

7 files changed, 657 insertions, 0 deletions

diff --git a/preface/acknowledgements.xml b/preface/acknowledgements.xml
new file mode 100644
index 0000000..5fc361f
--- /dev/null
+++ b/preface/acknowledgements.xml
@@ -0,0 +1,65 @@
+
+<section id="PrefaceAcknowledgements">
+  <title>Acknowledgements</title>
+
+  <para> In addition to the core code developed by &namebarry; at M.I.T., a
+  large part of the Csound code was modified, developed and extended by an
+  independent group of programmers, composers and scientists. Copyright to this
+  code is held by the respective authors: </para>
+
+  <table frame="none" colsep="0">
+    <title>Contributors</title>
+    <tgroup cols="1">
+      <tbody>
+
+<row><entry>Mike Berry </entry></row>
+<row><entry>Eli Breder </entry></row>
+<row><entry>Andr&eacute;s Cabrera</entry></row>
+<row><entry>Michael Casey </entry></row>
+<row><entry>Michael Clark </entry></row>
+<row><entry>Perry Cook </entry></row>
+<row><entry>Sean Costello </entry></row>
+<row><entry>Richard Dobson </entry></row>
+<row><entry>Mark Dolson </entry></row>
+<row><entry>Rasmus Ekman </entry></row>
+<row><entry>Dan Ellis </entry></row>
+<row><entry>Tom Erbe </entry></row>
+<row><entry>John ffitch </entry></row>
+<row><entry>Bill Gardner </entry></row>
+<row><entry>Michael Gogins </entry></row>
+<row><entry>Matt Ingalls </entry></row>
+<row><entry>Richard Karpen </entry></row>
+<row><entry>Anthony Kozar </entry></row>
+<row><entry>Victor Lazzarini  </entry></row>
+<row><entry>Allan Lee</entry></row>
+<row><entry>David Macintyre </entry></row>
+<row><entry>Gabriel Maldonado  </entry></row>
+<row><entry>Max Mathews </entry></row>
+<row><entry>Hans Mikelson </entry></row>
+<row><entry>Peter Neub&auml;cker </entry></row>
+<row><entry>Peter Nix </entry></row>
+<row><entry>Jean Pich&eacute;</entry></row>
+<row><entry>Ville Pulkki </entry></row>
+<row><entry>Maurizio Umberto Puxeddu </entry></row>
+<row><entry>John Ramsdell </entry></row>
+<row><entry>Marc Resibois </entry></row>
+<row><entry>Rob Shaw </entry></row>
+<row><entry>Paris Smaragdis </entry></row>
+<row><entry>Greg Sullivan </entry></row>
+<row><entry>Istvan Varga </entry></row>
+<row><entry>Bill Verplank </entry></row>
+<row><entry>Robin Whittle </entry></row>
+<row><entry>Steven Yi </entry></row>
+
+      </tbody>
+    </tgroup>
+  </table>  
+  
+  <para> The official manual was compiled from the canonical Csound Manual
+  sources maintained by &namejohn;, Richard Boulanger, Jean Pich&eacute;, Peter
+  Nix, and &namedavid;. The Alternative Csound Reference Manual was maintained by
+  &namekevin;. The Canonical Csound Reference Manual is maintained by the 
+  Csound community.
+  </para> 
+  
+</section>
diff --git a/preface/copy.xml b/preface/copy.xml
new file mode 100644
index 0000000..95131db
--- /dev/null
+++ b/preface/copy.xml
@@ -0,0 +1,82 @@
+
+<section id="PrefaceCopy">
+  <title>Copyright Notice</title>
+  <para>
+    Copyright (c) 1986, 1992 by the Massachusetts Institute of Technology. All rights reserved.
+  </para>
+  <para>
+    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 id="ManualLicense">
+    <title>Manual</title>
+    <para>
+      Copyright (c) 2003 by &namekevin; for modifications made to the Public Csound Reference Manual.
+    </para>
+    <para>
+      Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of this license is available in the <ulink url="examples/fdl.txt">examples sub-directory</ulink> or at: <ulink url="http://www.gnu.org/licenses/fdl.txt">www.gnu.org/licenses/fdl.txt</ulink>.
+    </para>
+    <para>
+      This Csound language documentation in this manual is derived from
+      Kevin Conder's <emphasis>Alternative Csound Reference
+        Manual</emphasis>, which in turn is derived from the <emphasis>Public
+        Csound Reference Manual</emphasis>.
+    </para>
+    <para>
+      Copyright 2004-2005 by Michael Gogins for modifications made to the
+      <emphasis>Alternative Csound Reference Manual</emphasis>.
+    </para>
+    <para>
+      This legal notice is from the <emphasis>Public Csound Reference Manual</emphasis>: <quote>The original Hypertext Edition of the MIT Csound Manual was prepared for the World Wide Web by <emphasis>Peter J. Nix</emphasis> of the Department of Music at the University of Leeds and <emphasis>Jean Pich&eacute;</emphasis> of the Facult&eacute; de musique de l'Universit&eacute; de Montr&eacute;al. A Print Edition, in Adobe Acrobat format, was then maintained by <emphasis>&namedavid;</emphasis>. The editors fully acknowledge the rights of the authors of the original documentation and programs, as set out above, and further request that this notice appear wherever this material is held.</quote>
+    </para>
+    <para>
+      The Public Csound Reference Manual's last known network location was <ulink url="http://www.lakewoodsound.com/csound/hypertext/manual.htm">http://www.lakewoodsound.com/csound/hypertext/manual.htm</ulink>.
+    </para>
+    <para>
+      The Alternative Csound Reference Manual's network location, for both the Transparent and Opaque copies, is <ulink url="http://kevindumpscore.com/download.html#csound-manual">http://kevindumpscore.com/download.html#csound-manual</ulink>.
+    </para>
+    <para>
+      The Csound and CsoundAC Manual's network location is <ulink url="http://sourceforge.net/projects/csound">http://sourceforge.net/projects/csound</ulink>.
+    </para>
+  </simplesect>
+  <simplesect>
+    <title>Csound and CsoundAC</title>
+    <para>
+      Csound is copyright 1991-2008 by Barry Vercoe, John ffitch and others.  </para>
+    <para>
+      CsoundAC is copyright 2001-2008 by Michael Gogins.
+    </para>
+    <para>
+      Csound and CsoundAC (formerly CsoundVST) are free software; you can redistribute them
+      and/or modify them under the terms of the GNU Lesser General Public
+      License as published by the Free Software Foundation; either version
+      2.1 of the License, or (at your option) any later version.
+    </para>
+    <para>
+      Csound and CsoundAC are distributed in the hope that they will be
+      useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
+      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+      Lesser General Public License for more details.
+    </para>
+    <para>
+      You should have received a copy of the GNU Lesser General Public
+      License along with Csound and CsoundAC; if not, write to the Free
+      Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
+      02111-1307 USA.
+    </para>
+  </simplesect>
+  <simplesect id="VSTSDKLicense">
+    <title>Virtual Synthesis Technology</title>
+    <para>
+      Virtual Synthesis Technology (VST) PlugIn interface technology by
+      Steinberg Soft- und Hardware GmbH.
+    </para>
+<!--    <para>
+      CsoundVST source code contains modified versions of source code files
+      from the VST SDK distributed by Steinberg. <emphasis>These files are to be
+        used only for building CsoundVST</emphasis>. You are <emphasis>not</emphasis> licensed to use
+      these files for any other purpose. If you make a derived product based
+      on CsoundVST or the modified VST source files herein, you <emphasis>must</emphasis>
+      apply to Steinberg for your own license to use the VST SDK.
+    </para>-->
+  </simplesect>
+</section>
diff --git a/preface/gettingstarted.xml b/preface/gettingstarted.xml
new file mode 100644
index 0000000..7c0a65c
--- /dev/null
+++ b/preface/gettingstarted.xml
@@ -0,0 +1,74 @@
+<section id="PrefaceGettingStarted">
+  <title>Getting Started with Csound</title>
+  <bridgehead>Downloading</bridgehead>
+  <para>
+    In case you don't already have Csound (or have an older version) download the appropriate Csound version for your platform from the <ulink url="http://sourceforge.net/project/showfiles.php?group_id=81968&amp;package_id=120482"><citetitle>Sourceforge Csound5 Download Page</citetitle></ulink>. Installers for Windows have '.exe' extension and for Mac '.dmg' or '.tar.gz'. If the installer's filename ends in '-d' it means the installer has been built with <emphasis>double</emphasis> precision (64-bit) which provides higher quality output than the ordinary <emphasis>float</emphasis> precision (32-bit), which provides quicker output. You can also download the sources and build them, but this requires more expertise (See the section <link linkend="BuildingCsound"><citetitle>Building Csound</citetitle></link>).
+  </para>
+  <para>
+    It's also useful to  download the most recent version of this manual, which you will also find there.
+  </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.
+  </para>
+  <para>
+    Both in the case of front-ends as well as execution from the command line, Csound needs two things:
+    <itemizedlist>
+      <listitem>
+        <simpara>A Csound file ('.csd' or possibly an '.orc' and a '.sco' file)</simpara>
+      </listitem>
+      <listitem>
+        <simpara>A list of command line flags (or configuration options) that configure execution. They determine things like output filename and format, whether real-time audio and MIDI are enabled, which soundcard to use, the buffer size, the amount of messages printed, etc. These options can be included in the '.csd' file itself, so for the examples included in this manual <emphasis>you shouldn't need to worry about them</emphasis>. The complete and very long list of available command flags can be found <link linkend="CommandFlags"><citetitle>here</citetitle></link>, but you might want to have a look there later...</simpara>
+      </listitem>
+    </itemizedlist>
+    See the section <link linkend="Configuring"><citetitle>Configuring</citetitle></link> if Csound is giving you trouble.
+  </para>
+  <para>
+    This documentation includes many '.csd' files which you can try out, and which should work directly from the command line or from any frontend. A simple example is <ulink url="examples/oscil.csd"><citetitle>oscil.csd</citetitle></ulink> that can be found in the <emphasis>examples</emphasis> folder of this documentation. Your front-end should allow you to choose the file, and it should have a 'play' or 'render' button.
+  </para>
+  <note>
+    <title>Note for MacCsound users</title>
+    <simpara>You might need to remove all the lines from the command options slot in order for the manual examples to work.</simpara>
+  </note>
+  <para>
+    You can also try the manual examples from the command line by navigating to the examples directory of the manual using something like this on Windows (assuming the manual is located at c:\Program Files\Csound\manual\):
+    <screen>
+cd "c:\Program Files\Csound\manual\examples"</screen>
+    or something like:
+    <screen>
+cd /manualdirectory/manual/examples</screen>
+    for the Mac or linux terminals and then typing:
+    <screen>
+csound oscil.csd</screen>
+  </para>
+  <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>
+  <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:
+    <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.
+        </simpara>
+      </listitem>
+      <listitem>
+        <simpara>
+          <emphasis>CsInstruments</emphasis> - Contains the instruments or processes available in the file. Instruments are defined using the <link linkend="instr"><citetitle>instr</citetitle></link> and <link linkend="endin"><citetitle>endin</citetitle></link> opcodes. The <emphasis>CsInstruments</emphasis> section also contains the <link linkend="OrchHeader"><citetitle>Orchestra Header</citetitle></link> which defines things like <link linkend="sr"><citetitle>sample rate</citetitle></link>, the <link linkend="ksmps"><citetitle>number of  samples in a control period</citetitle></link> and the <link linkend="nchnls"><citetitle>number of output channels</citetitle></link>.
+        </simpara>
+      </listitem>
+      <listitem>
+        <simpara>
+          <emphasis>CsScore</emphasis> - Contains the 'notes' to be played optionally the definition of f-tables. Notes are created using the <link linkend="i"><citetitle>i statement</citetitle></link>, and f-tables are created using the <link linkend="f"><citetitle>f statement</citetitle></link>. There are several other <link linkend="ScoreStatements"><citetitle>score statements</citetitle></link> available.
+        </simpara>
+      </listitem>
+    </itemizedlist>
+    Note that anything after a semicolon (;) until the end of the line is a comment, and is ignored by csound.
+  </para>
+  <para>
+    You can write csd files in any plain text editor like notepad or textedit. Just be sure to save the file as plain text (not rich text). Many <link linkend="OviewFrontEnds"><citetitle>frontends</citetitle></link> include advanced editing capabilities with syntax highlighting and completion.
+  </para>
+  <para>You can find an in depth tutorial on getting started with Csound written by Michael Gogins <ulink url="http://csound.sourceforge.net/tutorial.pdf">here</ulink>.</para>
+</section>
diff --git a/preface/history.xml b/preface/history.xml
new file mode 100644
index 0000000..8d05007
--- /dev/null
+++ b/preface/history.xml
@@ -0,0 +1,23 @@
+
+<section id="PrefaceHistory">
+  <title>History of the Canonical Csound Reference Manual</title>
+
+  <para>This manual is a product of the Csound community. The current version of
+  the manual is based on the Alternative Csound Reference Manual, developed by
+  &namekevin; using <ulink
+  url="http://www.docbook.org/"><citetitle>DocBook/SGML</citetitle></ulink>.
+  This was in itself based on the Official Csound Reference Manual still located at: <ulink
+  url="http://www.lakewoodsound.com/csound/hypertext/manual.htm">
+  <citetitle>http://www.lakewoodsound.com/csound</citetitle></ulink>),
+  which was maintained by &namedavid;.</para>
+  
+  <para>In the winter of 2004, the manual was converted to DocBook/XML by &namesteven; 
+  to allow for more people to be able to compile and maintain the manual. The 
+  manual continues to be a community run project that depends on the contributions
+  of developers and users to help refine the coverage and accuracy of its contents. 
+  All contributions are welcome and appreciated.</para>
+  
+  <para>
+    Written by &namesteven;, January 2005.
+  </para>
+</section>
diff --git a/preface/preface.xml b/preface/preface.xml
new file mode 100644
index 0000000..111e19b
--- /dev/null
+++ b/preface/preface.xml
@@ -0,0 +1,38 @@
+
+<section id="PrefacePreface">
+  <sectioninfo>
+    <author>
+      <firstname>Barry</firstname>
+      <surname>Vercoe</surname>
+      <affiliation>
+        <orgname>MIT Media Lab</orgname>
+      </affiliation>
+    </author>
+  </sectioninfo>
+
+  <title>Preface to the Csound Manual</title>
+
+  <para>
+    Realizing music by digital computer involves synthesizing audio signals with discrete points or samples representative of continuous waveforms. There are many ways to do this, each affording a different manner of control. Direct synthesis generates waveforms by sampling a stored function representing a single cycle; additive synthesis generates the many partials of a complex tone, each with its own loudness envelope; subtractive synthesis begins with a complex tone and filters it. Non-linear synthesis uses frequency modulation and waveshaping to give simple signals complex characteristics, while sampling and storage of a natural sound allows it to be used at will.
+  </para>
+
+  <para>
+    Since comprehensive moment-by-moment specification of sound can be tedious, control is gained in two ways: 1) from the instruments in an orchestra, and 2) from the events within a score. An orchestra is really a computer program that can produce sound, while a score is a body of data which that program can react to. Whether a rise-time characteristic is a fixed constant in an instrument, or a variable of each note in the score, depends on how the user wants to control it.
+  </para>
+
+  <para>
+    The instruments in a Csound orchestra (see <link linkend="OrchTop"><citetitle>Syntax of the Orchestra</citetitle></link>)  are defined in a simple syntax that invokes complex audio processing routines. A score (see <link linkend="ScoreTop"><citetitle>The Standard Numeric Score</citetitle></link>) passed to this orchestra contains numerically coded pitch and control information, in standard numeric score format. Although many users are content with this format, higher level score processing languages are often convenient.
+  </para>
+
+  <para>
+    The programs making up the Csound system have a long history of development, beginning with the Music 4 program written at Bell Telephone Laboratories in the early 1960's by Max Mathews. That initiated the stored table concept and much of the terminology that has since enabled computer music researchers to communicate. Valuable additions were made at Princeton by the late Godfrey Winham in Music 4B; my own Music 360 (1968) was very indebted to his work. With Music 11 (1973) I took a different tack: the two distinct networks of control and audio signal processing stemmed from my intensive involvement in the preceding years in hardware synthesizer concepts and design. This division has been retained in Csound.
+  </para>
+
+  <para>
+    Because it is written entirely in C, Csound is easily installed on any machine running Unix or C. At MIT it runs on VAX/DECstations under Ultrix 4.2, on SUNs under OS 4.1, SGI's under 5.0, on IBM PC's under DOS 6.2 and Windows 3.1, and on the Apple Macintosh under ThinkC 5.0. With this single language for defining the audio signal processing, and portable audio formats like AIFF and WAV, users can move easily from machine to machine.
+  </para>
+
+  <para>
+    The 1991 version added phase vocoder, FOF, and spectral data types. 1992 saw MIDI converter and control units, enabling Csound to be run from MIDI score-files and external keyboards. In 1994 the sound analysis programs (lpc, pvoc) were integrated into the main load module, enabling all Csound processing to be run from a single executable, and Cscore could pass scores directly to the orchestra for iterative performance. The 1995 release introduced an expanded MIDI set with MIDI-based linseg, butterworth filters, granular synthesis, and an improved spectral-based pitch tracker. Of special importance was the addition of run-time event generating tools (Cscore and MIDI) allowing run-time sensing and response setups that enable interactive composition and experiment. It appeared that real-time software synthesis was now showing some real promise.
+  </para>
+</section>
diff --git a/preface/top.xml b/preface/top.xml
new file mode 100644
index 0000000..33abf31
--- /dev/null
+++ b/preface/top.xml
@@ -0,0 +1,16 @@
+
+<preface id="PrefaceTop">
+  <title>Preface</title>
+
+  &pfacepreface;
+  &pfaceacknowledgements;
+  <!--  &pfacename;
+  &pfacescope;
+  &pfacecsoundav; -->
+  &pfacehistory;
+<!--  &csound5licenses;-->
+  &pfacecopy;
+  &pfacegettingstarted;
+  &pfacewhatsnew;
+
+</preface>
diff --git a/preface/whatsnew.xml b/preface/whatsnew.xml
new file mode 100644
index 0000000..a0e270d
--- /dev/null
+++ b/preface/whatsnew.xml
@@ -0,0 +1,359 @@
+<section id="PrefaceWhatsNew"><title>What's new in Csound &csoundversion;</title>
+<!--  <bridgehead>New in Version 5.XX ()</bridgehead>
+  <para>
+    <itemizedlist>
+      <listitem>
+        <para>New opcodes:
+          <itemizedlist>
+            <listitem>
+              <link linkend=""><citetitle></citetitle></link>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          New functionality
+          <itemizedlist>
+            <listitem>
+              <simpara>
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Bug fixes and improvements:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Internal Changes:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+    </itemizedlist>
+  </para>-->
+<!--   <bridgehead>New in Version 5.08 (February 2008)</bridgehead> -->
+  <para>
+    <itemizedlist>
+      <listitem>
+        <para>New opcodes:
+          <itemizedlist>
+            <listitem>
+              <link linkend="imagecreate"><citetitle>imagecreate</citetitle></link>,
+              <link linkend="imagesize"><citetitle>imagesize</citetitle></link>,
+              <link linkend="imagegetpixel"><citetitle>imagegetpixel</citetitle></link>,
+              <link linkend="imagesetpixel"><citetitle>imagesetpixel</citetitle></link>,
+              <link linkend="imagesave"><citetitle>imagesave</citetitle></link>,
+              <link linkend="imageload"><citetitle>imageload</citetitle></link> and
+              <link linkend="imagefree"><citetitle>imagefree</citetitle></link>: New image file processing opcodes by Cesare Marilungo to read/write png images from Csound.
+            </listitem>
+            <listitem><link linkend="pvsbandp"><citetitle>pvsbandp</citetitle></link> and <link linkend="pvsbandr"><citetitle>pvsbandr</citetitle></link> by John ffitch, which perform band-pass and band-reject filtering in the spectral domain on a pvs signal.</listitem>
+            <listitem>New waveshaping opcodes: <link linkend="powershape"><citetitle>powershape</citetitle></link>,
+              <link linkend="polynomial"><citetitle>polynomial</citetitle></link>, 
+              <link linkend="chebyshevpoly"><citetitle>chebyshevpoly</citetitle></link>,
+              <link linkend="pdclip"><citetitle>pdclip</citetitle></link>,
+              <link linkend="pdhalf"><citetitle>pdhalf</citetitle></link>,
+              <link linkend="pdhalfy"><citetitle>pdhalfy</citetitle></link>, and
+              <link linkend="syncphasor"><citetitle>syncphasor</citetitle></link></listitem>
+            <listitem>New jack transport control opcode: <link linkend="jacktransport"><citetitle>jacktransport</citetitle></link></listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      Improvements:
+
+      <listitem>
+        <para>
+          New functionality
+          <itemizedlist>
+            <listitem>
+              <simpara>Added <link linkend="FlagsMinusCsdLineNums"><citetitle>--csd-line-nums=</citetitle></link> command line option to select mode for error line reporting.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                New "no-carry" operator (!) for score language that prevents implicit carrying of p-fields in i-statements.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Added <link linkend="FlagsMinusSyntaxCheckOnly"><citetitle>--syntax-check-only</citetitle></link> commandline flag (exclusive with <link linkend="FlagsMinusUpperI"><citetitle>--i-only</citetitle></link>)
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                <emphasis>&lt;CsLicence&gt;</emphasis> tag for <link linkend="CommandUnifileDescription"><citetitle>CSDs</citetitle></link>. <emphasis>&lt;CsLicense&gt;</emphasis> is accepted as an alternative to <emphasis>&lt;CsLicence&gt;</emphasis>.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Bug fixes and improvements:
+          <itemizedlist>
+            <listitem>
+              Changed order of outputs for <link linkend="hilbert"><citetitle>hilbert</citetitle></link>. This change breaks compatibility with previous versions, but fixes the opcode and now works as documented.
+            </listitem>
+            <listitem>
+              Messages about loading opcode plugins modified so can be suppressed with message level flag.
+            </listitem>
+            <listitem>
+              <simpara>Major changes to score error reporting; now accurately reports the line numbers for the chain of inputs for most errors.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Corrected <link linkend="pan2"><citetitle>pan2</citetitle></link> so it agrees with documentation.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                <link linkend="CommandUnifileDescription"><citetitle>&lt;CsVersion&gt;</citetitle></link> tag works again according to the manual.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Fixed the { and } score looping statements. Added missing documentation for them and ~, &amp;, |, and # operators in score expressions.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                <link linkend="hilbert"><citetitle>hilbert</citetitle></link> had its outputs reversed, now correct. Manual example updated.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Internal Changes:
+          <itemizedlist>
+            <listitem>
+              <simpara>Change to gettext localisation; French and Columbian-Spanish translations available.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Internal changes to <link linkend="partikkel"><citetitle>partikkel</citetitle></link>, interpolation of waveform read and windowing, allowing more precise pitch synchronous granular synthesis. Updated examples for <link linkend="partikkel"><citetitle>partikkel</citetitle></link>.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                <link linkend="pvscale"><citetitle>pvscale</citetitle></link>: Improved algorithm for SDFT case so no ampltitude variation.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+    </itemizedlist>
+  </para>
+  <bridgehead>New in Version 5.07 (October 2007)</bridgehead>
+    <para>
+      <itemizedlist>
+        <listitem>
+          <para>New opcodes:
+            <itemizedlist>
+              <listitem>
+                <simpara><link linkend="pan2"><citetitle>pan2</citetitle></link>: a stereo panning opcode</simpara>
+              </listitem>
+              <listitem>
+                <simpara><link linkend="cpsmidinn"><citetitle>cpsmidinn</citetitle></link>, <link linkend="pchmidinn"><citetitle>pchmidinn</citetitle></link>, <link linkend="octmidinn"><citetitle>octmidinn</citetitle></link>: converters for MIDI note numbers</simpara>
+              </listitem>
+              <listitem>
+                <simpara><link linkend="fluidSetInterpMethod"><citetitle>fluidSetInterpMethod</citetitle></link>: interpolation in fluid sound fonts</simpara>
+              </listitem>
+              <listitem>
+                <simpara><link linkend="sflooper"><citetitle>sflooper</citetitle></link>: a soundfont version of <link linkend="flooper2"><citetitle>flooper2</citetitle></link></simpara>
+              </listitem>
+              <listitem>
+                <simpara><link linkend="pvsbuffer"><citetitle>pvsbuffer</citetitle></link> and <link linkend="pvsbufread"><citetitle>pvsbufread</citetitle></link>: buffering/reading of fsigs for delays/timescale changes.</simpara>
+              </listitem>
+            </itemizedlist>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            New functionality
+            <itemizedlist>
+              <listitem>
+                <para>SDFT - the Sliding Discrete Fourier Transform -- added seamlessly to <link linkend="pvsanal"><citetitle>pvsanal</citetitle></link>, etc opcodes if the overlap is less than the ksmps or less than 10. Some pvsXXX opcodes extended to take a-rate parameters when sliding.
+                </para>
+              </listitem>
+              <listitem>
+                <para>New feature (<link linkend="FlagsCatMinusUpperO"><citetitle>-O null</citetitle></link> / <link linkend="FlagsCatMinusUpperO"><citetitle>--logfile=null</citetitle></link>) that disables all messages and printing to the console.
+                </para>
+              </listitem>
+            </itemizedlist>
+          </para>
+        </listitem>
+        <listitem>
+          <para>Bug fixes and improvements:
+            <itemizedlist>
+              <listitem>
+                <simpara><link linkend="partikkel"><citetitle>partikkel</citetitle></link> -- particle synthesis had an inadvertent bug, now fixed.</simpara>
+              </listitem>
+              <listitem>
+                <simpara>Closing of MIDI input on Windows(MM) failed; now fixed</simpara>
+              </listitem>
+              <listitem>
+                <simpara><link linkend="fluidEngine"><citetitle>fluidEngine</citetitle></link> opcode now takes optional number of channels (range 16-256, default to 256) and polyphony (range 16-4096, default to 4096) to use.</simpara>
+              </listitem>
+              <listitem>
+                <simpara><link linkend="UtilityAtsa"><citetitle>atsa</citetitle></link> utility safer when given silence.</simpara>
+              </listitem>
+              <listitem>
+                <simpara><link linkend="ATSaddnz"><citetitle>ATSaddnz</citetitle></link>: improved checking.</simpara>
+              </listitem>
+              <listitem>
+                <simpara>Ambisonics (<link linkend="bformdec"><citetitle>bformdec</citetitle></link>, <link linkend="bformenc"><citetitle>bformenc</citetitle></link>) has more options for controlled opposites.</simpara>
+              </listitem>
+              <listitem>
+                <simpara>Bug in <link linkend="turnoff2"><citetitle>turnoff2</citetitle></link> fixed.</simpara>
+              </listitem>
+              <listitem>
+                <simpara><link linkend="het_export"><citetitle>het_export</citetitle></link>: invalid check caused export to fail.</simpara>
+              </listitem>
+            </itemizedlist>
+          </para>
+        </listitem>
+        <listitem>
+          <para>
+            Internal Changes:
+            <itemizedlist>
+              <listitem>
+                <simpara>Improved Windows installer.</simpara>
+              </listitem>
+              <listitem>
+                <simpara>CsoundVST replaced by CsoundAC, that does not depend on the VST SDK headers.</simpara>
+              </listitem>
+              <listitem>
+                <simpara>Less messages in Windows(MM) startup.</simpara>
+              </listitem>
+              <listitem>
+                <simpara>P argument type added (k-rate defaults to 1) for opcode in and out types.</simpara>
+              </listitem>
+            </itemizedlist>
+          </para>
+        </listitem>
+      </itemizedlist>
+    </para>
+  <bridgehead>New in Version 5.06 (June 2007)</bridgehead>
+  <para>
+    <itemizedlist>
+      <listitem>
+        <para>New granular opcodes:
+          <link linkend="partikkel"><citetitle>partikkel</citetitle></link>,
+          <link linkend="partikkelsync"><citetitle>partikkelsync</citetitle></link> and
+          <link linkend="diskgrain"><citetitle>diskgrain</citetitle></link>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>New opcode for event dispatch:
+          <link linkend="scoreline"><citetitle>scoreline</citetitle></link>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Many new opcodes from Gabriel Maldonado's CsoundAV:
+          <link linkend="hvs1"><citetitle>hvs1</citetitle></link>,
+          <link linkend="hvs2"><citetitle>hvs2</citetitle></link>,
+          <link linkend="hvs3"><citetitle>hvs3</citetitle></link>,
+          <link linkend="vphaseseg"><citetitle>vphaseseg</citetitle></link>,
+          <link linkend="inrg"><citetitle>inrg</citetitle></link>,
+          <link linkend="outrg"><citetitle>outrg</citetitle></link>,
+          <link linkend="lposcila"><citetitle>lposcila</citetitle></link>,
+          <link linkend="lposcilsa"><citetitle>lposcilsa</citetitle></link>,
+          <link linkend="lposcilsa2"><citetitle>lposcilsa2</citetitle></link>,
+          <link linkend="tabmorph"><citetitle>tabmorph</citetitle></link>,
+          <link linkend="tabmorpha"><citetitle>tabmorpha</citetitle></link>,
+          <link linkend="tabmorphi"><citetitle>tabmorphi</citetitle></link>,
+          <link linkend="tabmorphak"><citetitle>tabmorphak</citetitle></link>,
+          <link linkend="trandom"><citetitle>trandom</citetitle></link>,
+          <link linkend="vtable1k"><citetitle>vtable1k</citetitle></link>,
+          <link linkend="slider8table"><citetitle>slider8table</citetitle></link>,
+          <link linkend="slider16table"><citetitle>slider16table</citetitle></link>,
+          <link linkend="slider32table"><citetitle>slider32table</citetitle></link>,
+          <link linkend="slider64table"><citetitle>slider64table</citetitle></link>,
+          <link linkend="slider8tablef"><citetitle>slider8tablef</citetitle></link>,
+          <link linkend="slider16tablef"><citetitle>slider16tablef</citetitle></link>,
+          <link linkend="slider32tablef"><citetitle>slider32tablef</citetitle></link>,
+          <link linkend="slider64tablef"><citetitle>slider64tablef</citetitle></link>,
+          <link linkend="sliderKawai"><citetitle>sliderKawai</citetitle></link>
+          and the a-rate version of
+          <link linkend="ctrl7"><citetitle>ctrl7</citetitle></link>.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          Also from CsoundAV, many new FLTK widget opcodes: 
+          <link linkend="FLkeyIn"><citetitle>FLkeyIn</citetitle></link>,
+          <link linkend="FLslidBnk2"><citetitle>FLslidBnk2</citetitle></link>,
+          <link linkend="FLvslidBnk"><citetitle>FLvslidBnk</citetitle></link>,
+          <link linkend="FLvslidBnk2"><citetitle>FLvslidBnk2</citetitle></link>,
+          <link linkend="FLmouse"><citetitle>FLmouse</citetitle></link>,
+          <link linkend="FLxyin"><citetitle>FLxyin</citetitle></link>,
+          <link linkend="FLhvsBox"><citetitle>FLhvsBox</citetitle></link>,
+          <link linkend="FLslidBnkSet"><citetitle>FLslidBnkSet</citetitle></link>,
+          <link linkend="FLslidBnkSetk"><citetitle>FLslidBnkSetk</citetitle></link>,
+          <link linkend="FLslidBnk2Set"><citetitle>FLslidBnk2Set</citetitle></link>,
+          <link linkend="FLslidBnk2Setk"><citetitle>FLslidBnk2Setk</citetitle></link>,
+          <link linkend="FLslidBnkGetHandle"><citetitle>FLslidBnkGetHandle</citetitle></link>,
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          New pvs opcodes:
+          <link linkend="pvsdiskin"><citetitle>pvsdiskin</citetitle></link>,
+          <link linkend="pvsmorph"><citetitle>pvsmorph</citetitle></link>,
+        </para>
+      </listitem>
+      <listitem>
+        <para><link linkend="eqfil"><citetitle>eqfil</citetitle></link>
+        </para>
+      </listitem>
+      <listitem>
+        <para>New command line options (<link linkend="FlagsCatMinusLowerMW"><citetitle>--m-warnings</citetitle></link>)to control messages
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          csladspa: a CSD to LADSPA plugin kit.
+        </para>
+      </listitem>
+      <listitem>
+        <para>
+          And many bug fixes including (but not limited to): fixed k-rate version of <link linkend="system"><citetitle>system</citetitle></link>; fixed scaling problems of <link linkend="vrandh"><citetitle>vrandh</citetitle></link> and <link linkend="vrandi"><citetitle>vrandi</citetitle></link>; fixed ocasional failure of <link linkend="turnoff"><citetitle>turnoff</citetitle></link>; fixed  <link linkend="tempest"><citetitle></citetitle></link> OS X bug; fixed <link linkend="ATScross"><citetitle>ATScross</citetitle></link> and fixed <link linkend="modulus"><citetitle>mod</citetitle></link>.
+        </para>
+        <para>Csound5GUI now works properly on all platforms and csoundapi~ (pd object) has been updated.
+        </para>
+      </listitem>
+    </itemizedlist>
+  </para>
+</section>