Imported Upstream version 5.12~dfsg

4 files changed, 21 insertions, 4 deletions

diff --git a/command/flags.xml b/command/flags.xml
index 5261792..c307914 100644
--- a/command/flags.xml
+++ b/command/flags.xml
@@ -155,7 +155,7 @@
           <term>-d<indexterm id="IndexMinusLowerD"><primary>-d</primary></indexterm>, --nodisplays<indexterm id="IndexMinusNodisplays"><primary>--nodisplays</primary></indexterm></term>
           <listitem>
             <para>
-              Suppress all displays.
+              Suppress all displays. See <link linkend="FlagsCatMinusUpperO"><citetitle>-O</citetitle></link> if you want to save the log to a file.
             </para>
           </listitem>
         </varlistentry>
@@ -374,6 +374,9 @@
             <para>
               The name <emphasis>devaudio</emphasis> or <emphasis>adc</emphasis> will request sound from the host audio input device. It is possible to select a device number by appending an integer value in the range 0 to 1023, or a device name separated by a : character (e.g. -iadc3, -iadc:hw:1,1). It depends on the host audio interface whether a device number or a name should be used. In the first case, an out of range number usually results in an error and listing the valid device numbers.
             </para>
+            <para>
+              The audio coming in using <emphasis>-i</emphasis> can be received using opcodes like <link linkend="inch"><citetitle>inch</citetitle></link>.
+            </para>
           </listitem>
         </varlistentry>
 
@@ -540,7 +543,7 @@
           <term>-M DEVICE<indexterm id="IndexMinusUpperM"><primary>-M</primary></indexterm>, --midi-device=DEVICE<indexterm id="IndexMinusMididevice"><primary>--midi-device</primary></indexterm></term>
           <listitem>
             <para>
-              Read MIDI events from device <emphasis>DEVICE</emphasis>. If using ALSA MIDI (-+rtmidi=alsa), devices are selected by name and not number. So, you need to use an option like -M hw:CARD,DEVICE where CARD and DEVICE are the card and device numbers (e.g. -M hw:1,0). In the case of PortMidi and MME, DEVICE should be a number, and if it is out of range, an error occurs and the valid device numbers are printed.
+                Read MIDI events from device <emphasis>DEVICE</emphasis>. If using ALSA MIDI (-+rtmidi=alsa), devices are selected by name and not number. So, you need to use an option like -M hw:CARD,DEVICE where CARD and DEVICE are the card and device numbers (e.g. -M hw:1,0). In the case of PortMidi and MME, DEVICE should be a number, and if it is out of range, an error occurs and the valid device numbers are printed.When using PortMidi, you can use '-Ma' to enable all devices. This is also convenient when you don't have devices as it will not generate an error.
             </para>
           </listitem>
         </varlistentry>
diff --git a/command/flagscategory.xml b/command/flagscategory.xml
index 4de67df..1513112 100644
--- a/command/flagscategory.xml
+++ b/command/flagscategory.xml
@@ -119,6 +119,9 @@
         <para>
           The name <emphasis>devaudio</emphasis> or <emphasis>adc</emphasis> will request sound from the host audio input device. It is possible to select a device number by appending an integer value in the range 0 to 1023, or a device name separated by a : character. It depends on the host audio interface whether a device number or a name should be used. In the first case, an out of range number usually results in an error and listing the valid device numbers.
         </para>
+        <para>
+            The audio coming in using <emphasis>-i</emphasis> can be received using opcodes like <link linkend="inch"><citetitle>inch</citetitle></link>.
+        </para>
       </listitem>
     </varlistentry>
 
@@ -460,7 +463,7 @@ csound5:output2             (playback right)</screen>
       <term>-M DEVICE<indexterm id="IndexCatMinusUpperM"><primary>-M</primary></indexterm>, --midi-device=DEVICE<indexterm id="IndexCatMinusMididevice"><primary>--midi-device</primary></indexterm></term>
       <listitem>
         <para>
-          Read MIDI events from device <emphasis>DEVICE</emphasis>. If using ALSA MIDI (<link linkend="FlagsCatMinusPlusRtmidi"><citetitle>-+rtmidi</citetitle></link>=alsa), devices are selected by name and not number. So, you need to use an option like -M hw:CARD,DEVICE where CARD and DEVICE are the card and device numbers (e.g. -M hw:1,0). In the case of PortMidi and MME, DEVICE should be a number, and if it is out of range, an error occurs and the valid device numbers are printed.
+          Read MIDI events from device <emphasis>DEVICE</emphasis>. If using ALSA MIDI (<link linkend="FlagsCatMinusPlusRtmidi"><citetitle>-+rtmidi</citetitle></link>=alsa), devices are selected by name and not number. So, you need to use an option like -M hw:CARD,DEVICE where CARD and DEVICE are the card and device numbers (e.g. -M hw:1,0). In the case of PortMidi and MME, DEVICE should be a number, and if it is out of range, an error occurs and the valid device numbers are printed. When using PortMidi, you can use '-Ma' to enable all devices. This is also convenient when you don't have devices as it will not generate an error.
         </para>
       </listitem>
     </varlistentry>
@@ -581,7 +584,7 @@ csound5:output2             (playback right)</screen>
       <term>-d<indexterm id="IndexCatMinusLowerD"><primary>-d</primary></indexterm>, --nodisplays<indexterm id="IndexCatMinusNodisplays"><primary>--nodisplays</primary></indexterm></term>
       <listitem>
         <para>
-          Suppress all displays.
+          Suppress all displays. See <link linkend="FlagsCatMinusUpperO"><citetitle>-O</citetitle></link> if you want to save the log to a file.
         </para>
       </listitem>
     </varlistentry>
diff --git a/command/flagscategoryXO.xml b/command/flagscategoryXO.xml
index dd4a9db..3e9598d 100644
--- a/command/flagscategoryXO.xml
+++ b/command/flagscategoryXO.xml
@@ -131,6 +131,9 @@
         <para>
           The name <emphasis>devaudio</emphasis> or <emphasis>adc</emphasis> will request sound from the host audio input device. It is possible to select a device number by appending an integer value in the range 0 to 1023, or a device name separated by a : character. It depends on the host audio interface whether a device number or a name should be used. In the first case, an out of range number usually results in an error and listing the valid device numbers.
         </para>
+        <para>
+            The audio coming in using <emphasis>-i</emphasis> can be received using opcodes like <link linkend="inch"><citetitle>inch</citetitle></link>.
+        </para>
       </listitem>
     </varlistentry>
 
diff --git a/command/unifile.xml b/command/unifile.xml
index 3414a82..141dfb5 100644
--- a/command/unifile.xml
+++ b/command/unifile.xml
@@ -44,6 +44,14 @@
     <para>
       Csound score statements are put in the Score Element. The statements and syntax in this section are identical to the Csound <link linkend="ScoreTop"><citetitle>score file</citetitle></link>, and have the same requirements. The Score Element is delimited by the start tag <emphasis>&lt;CsScore&gt; </emphasis>and the end tag <emphasis>&lt;/CsScore&gt;.</emphasis>
     </para>
+    <para>
+      As an alternative Csound score statements can also be generated by an external
+      program using the CsScore scheme with an attribute bin. The lines upto the closing
+      tag <emphasis>&lt;/CsScore&gt;</emphasis> are copied to a file
+      and the external program named is called with that file name and
+      the destination score file.  The external program should create a
+      standard Csound score.
+    </para>
 
     <bridgehead>Optional Elements</bridgehead>