New upstream version 6.08.0~dfsg

1 files changed, 423 insertions, 0 deletions

diff --git a/preface/whatsnew.xml b/preface/whatsnew.xml
index e1a9f3d..9c6ac90 100644
--- a/preface/whatsnew.xml
+++ b/preface/whatsnew.xml
@@ -66,6 +66,429 @@
     </itemizedlist>
   </para>-->
 
+  <bridgehead>Release Notes for Csound 6.08 (2016 November)</bridgehead>
+  <para>
+    As usual there are a number of opcode fixes and improvements, but the major
+    changes are in the language structures. First the score language has all-new
+    treatment of macros and preprocessing, bringing it in line with those of the
+    orchestra. The parsing of the orchestra has had a number of fixes as
+    outlined below.
+  </para>
+  <para>
+    A major, and not totally compatible change as been made in reading and
+    writing array elements. The rate of the index now often determines the
+    time of processing; check the entry below under Orchestra. This simplifies
+    much code and seems to capture expectations; the earlier ad hoc code had
+    many anomalies.
+  </para>
+  <para>
+    Also as usual there are a number of new opcodes and internal fixes to
+    memory leaks and more robust code.
+  </para>
+  <para>
+    <itemizedlist>
+      <listitem>
+        <para>New opcodes:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                <link linkend="dct"><citetitle>dct</citetitle></link>: Discrete
+                Cosine Transform of a sample array (type-II DCT).
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                <link linkend="getftargs"><citetitle>getftargs</citetitle></link>:
+                copy arguments of a gen to an S-variable.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara><link linkend="mfb"><citetitle>mfb</citetitle></link>:
+                implements a mel-frequency filterbank for an array of input
+                magnitudes.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>New Gen and Macros:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                <link linkend="GENquadbezier"><citetitle>quadbezier</citetitle></link>:
+                generating Bezier curves in a table.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Orchestra:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                The character ¬ is now correctly treated as a variant of ~ for
+                bitwise not.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>Lexing bug which could corrupt strings fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Ensure no newlines in string-lexing.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Small improvement in reported line numbers.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Better checking of macro syntax.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Improved parsing of setting of labels.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Added error handling for unmatched brackets for UDO arg
+                specification.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>Check that #included file is not a directory.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Deeply nested macro calls better policed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                For years Csound has fixed the pitch of A4 at 440Hz. Now this
+                can be set in the header using the new r-variable A4, and also
+                read with that variable.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>Floating point values can use e or E for exponent.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Array access semantics have been clarified:
+                <itemizedlist>
+                  <listitem>
+                    <simpara>
+                      i[i] => reading at i-time and perf-time, writing at i-time only.
+                    </simpara>
+                  </listitem>
+                  <listitem>
+                    <simpara>
+                      i[k] => reading at perf-time, writing yields a runtime error.
+                    </simpara>
+                  </listitem>
+                  <listitem>
+                    <simpara>
+                      k[i], k[k] => reading at perf-time, writing at perf-time.
+                    </simpara>
+                  </listitem>
+                  <listitem>
+                    <simpara>
+                      a[i], a[k] => reading at perf-time, writing at perf-time.
+                    </simpara>
+                  </listitem>
+                  <listitem>
+                    <simpara>
+                      other (S[], f[]) => reading and writing according to index
+                      type (i,k).
+                    </simpara>
+                  </listitem>
+                </itemizedlist>
+                In particular, i(k[i]) will continue not to work, as before,
+                but the new operator i(k[],i) is provided to cover this case.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                xout validation no longer fails when constants are given.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Score:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                New code to handle macros and other preprocessor commands.
+                Brings it into line with orchestra code.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                New score opcode C introduced as a way of switching automatic
+                carry off (C 0) or on (default) (C 1).
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Options:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                The tempo setting can now be a floating point value (previously
+                fixed to integer).
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                New option --version prints version information and exits.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Modified Opcodes and Gens:
+          <itemizedlist>
+            <listitem>
+              <simpara>Problems in centroid fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Better treatment of rounding in printks.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>OSC extended to include multicast.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Faust opcodes brought up to date with faust.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>oscil1 and oscili can take a negative duration.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>fout opcode documentation clarified.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Release time in mxadsr fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                centroid opcode extended to take array inputs in addition.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                ptable opcodes are now identical to table family.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>ftgen now as array input option.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>subinstr can now have string arguments.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                the i() format is extended to work on k-rate arrays with the
+                first argument being an array, followed by the indices.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Utilities:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                pvlook now always prints explicit analysis window name.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Frontends:
+          <itemizedlist>
+            <listitem>
+              <simpara>
+                HTML5
+                <itemizedlist>
+                  <listitem>
+                    <simpara>
+                      csound.node: Implemented for Linux, minor API fix.
+                    </simpara>
+                  </listitem>
+                  <listitem>
+                    <simpara>
+                      pnacl: Added compileCsdText method to csound object.
+                    </simpara>
+                  </listitem>
+                </itemizedlist>
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>General Usage:
+          <itemizedlist>
+            <listitem>
+              <simpara>Checking of valid macro names improved.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>#undef fixed.</simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Bugs Fixed:
+          <itemizedlist>
+            <listitem>
+              <simpara>Fixes to prints in format use.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>jitter2 reworked to make it more like the manual.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                oscbank has had multiple fixes and now works as advertised.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>bformdec1 with arrays and type 4 fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Bug in pvsceps fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                In various formatted print opcodes extra trash characters might
+                appear -- fixed.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Assigning variables with --sample-accurate could give unexpected
+                results; this is believed fixed now.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                padsynth square profile fix, and opcode prints less depending
+                on warn level.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>gen31 fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>gen41 fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Bug in sensekey fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>A number of issues in centroid fixed.</simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>System changes:
+          <itemizedlist>
+            <listitem>
+              <simpara>New score lexing and preprocessor.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>MAC line endings now work again.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                System information messages (system sampling rate, etc) are now
+                directed to stdout.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>rtjack reworked to deal with names and numbers.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                The version printing now includes the commit as so the
+                developers know which patches have been applied.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>API:
+          <itemizedlist>
+            <listitem>
+              <simpara>API version now 4.0.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Now supports named gens.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>fterror now in API.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>API functions SetOutput and GetOutputFormat fixed.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>Many API functions now use const where appropriate.</simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                Messages can now be directed to stdout from the API by using
+                CSOUNDMSG_STDOUT attribute.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                New Lisp CFFI and FFI interfaces tested with Steel Bank Common
+                Lisp (64 bit CPU architecture), runs in separate thread.
+              </simpara>
+            </listitem>
+            <listitem>
+              <simpara>
+                ctcsound.py, a new FFI interface for Python was introduced in
+                version 6.07. It is now the recommanded interface for Python,
+                csnd6.py being deprecated.
+              </simpara>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+      <listitem>
+        <para>Platform Specific:
+          <itemizedlist>
+            <listitem>
+              <simpara>Android.</simpara>
+              <itemizedlist>
+                <listitem>
+                  <simpara>Multichannel input and output allowed.</simpara>
+                </listitem>
+              </itemizedlist>
+            </listitem>
+            <listitem>
+              <simpara>Windows.</simpara>
+              <itemizedlist>
+                <listitem>
+                  <simpara>
+                    csound64.lib import library added to Windows installer.
+                  </simpara>
+                </listitem>
+              </itemizedlist>
+            </listitem>
+          </itemizedlist>
+        </para>
+      </listitem>
+    </itemizedlist>
+  </para>
+
   <bridgehead>Release Notes for Csound 6.07 (2016 March)</bridgehead>
   <para>
     A large number of bug fixes, some quite major, some internal are