From: Kyle Robbertze <paddatrapper@debian.org>
Date: Tue, 12 Jul 2022 18:21:43 +0200
Subject: Remove docs related to non-free optional dependencies

---
 docs/glasscoder.xml.in | 313 +------------------------------------------------
 1 file changed, 6 insertions(+), 307 deletions(-)

diff --git a/docs/glasscoder.xml.in b/docs/glasscoder.xml.in
index ccd8468..e1d271c 100644
--- a/docs/glasscoder.xml.in
+++ b/docs/glasscoder.xml.in
@@ -123,20 +123,6 @@
 	    </varlistentry>
 	  </variablelist>
 	</blockquote> <!-- remap='RE' -->
-	<blockquote remap='RS'>
-	  <variablelist remap='TP'>
-	    <varlistentry>
-	      <term>
-		<userinput>ASIHPI</userinput>
-	      </term>
-	      <listitem>
-		<para>
-		  AudioScience HPI.
-		</para>
-	      </listitem>
-	    </varlistentry>
-	  </variablelist>
-	</blockquote> <!-- remap='RE' -->
 	<blockquote remap='RS'>
 	  <variablelist remap='TP'>
 	    <varlistentry>
@@ -178,20 +164,6 @@
 	  <userinput>VORBIS</userinput>.  Valid	<replaceable>fmt</replaceable>
 	  values are:
 	</para>
-	<blockquote remap='RS'>
-	  <variablelist remap='TP'>
-	    <varlistentry>
-	      <term>
-		<userinput>AACP</userinput>
-	      </term>
-	      <listitem>
-		<para>
-		  MPEG-4 Advanced Audio Coding &quot;Plus&quot; (High Efficiency Profile)
-		</para>
-	      </listitem>
-	    </varlistentry>
-	  </variablelist>
-	</blockquote> <!-- remap='RE' -->
 	<blockquote remap='RS'>
 	  <variablelist remap='TP'>
 	    <varlistentry>
@@ -878,285 +850,6 @@ Password=&lt;password&gt;
     </listitem>
   </varlistentry>
 
-  <varlistentry>
-    <term>
-      <emphasis remap='B'>AudioScience HPI</emphasis> 
-      (<option>--audio-device=</option><userinput>=ASIHPI</userinput>)
-    </term>
-    <listitem>
-      <variablelist>
-	<varlistentry>
-	  <term>
-	    <option>--asihpi-adapter-index=</option><replaceable>index</replaceable>
-	  </term>
-	  <listitem>
-	    <para>
-	      The index number of the audio adapter to use.
-	    </para>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term>
-	    <option>--asihpi-input-index=</option><replaceable>index</replaceable>
-	  </term>
-	  <listitem>
-	    <para>
-	      The number of the input audio stream to use on the specified adapter.
-	    </para>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term>
-	    <option>--asihpi-input-gain=</option><replaceable>gain</replaceable>
-	  </term>
-	  <listitem>
-	    <para>
-	      The gain to apply to the input audio on the specified adapter in
-	      dB. Valid values are <userinput>-100</userinput> to
-	      <userinput>+20</userinput> inclusive.  Default value is
-	      <userinput>0</userinput>.
-	    </para>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term>
-	    <option>--asihpi-channel_mode=</option><replaceable>mode</replaceable>
-	  </term>
-	  <listitem>
-	    <para>
-	      The channel mode for the input audio on the specified adapter.
-	      The default value is <userinput>NORMAL</userinput>. Valid values
-	      are:
-	    </para>
-	    <blockquote remap='RS'>
-	      <variablelist remap='TP'>
-		<varlistentry>
-		  <term>
-		    <userinput>NORMAL</userinput>
-		  </term>
-		  <listitem>
-		    <para>
-		      Left signal goes to left channel, right signal goes to
-		      right channel.
-		    </para>
-		  </listitem>
-		</varlistentry>
-		<varlistentry>
-		  <term>
-		    <userinput>SWAP</userinput>
-		  </term>
-		  <listitem>
-		    <para>
-		    Left signal goes to right channel, right signal goes to
-		    left channel.
-		    </para>
-		  </listitem>
-		</varlistentry>
-		<varlistentry>
-		  <term>
-		    <userinput>LEFT</userinput>
-		  </term>
-		  <listitem>
-		    <para>
-		      Left signal goes to both left and right channels.
-		    </para>
-		  </listitem>
-		</varlistentry>
-		<varlistentry>
-		  <term>
-		    <userinput>RIGHT</userinput>
-		  </term>
-		  <listitem>
-		    <para>
-		      Right signal goes to both left and right channels.
-		    </para>
-		  </listitem>
-		</varlistentry>
-	      </variablelist>
-	    </blockquote> <!-- remap='RE' -->
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term>
-	  <option>--asihpi-input-source=</option><replaceable>src-node</replaceable>
-	  </term>
-	  <listitem>
-	    <para>
-	      The input source to use on the specified adapter.  See the
-	      <emphasis remap='B'>HPI Source Nodes</emphasis> section below
-	      for the list of valid <replaceable>src-node</replaceable>
-	      values. The default value is <userinput>LINEIN</userinput>.
-	    </para>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term>
-	    <option>--asihpi-input-type=</option><replaceable>src-node</replaceable>
-	  </term>
-	  <listitem>
-	    <para>
-	      The input type to use on the specified adapter.  See the
-	      <emphasis remap='B'>HPI Source Nodes</emphasis> section below
-	      for the list of valid <replaceable>src-node</replaceable>
-	      values. The default value is <userinput>LINEIN</userinput>.
-	    </para>
-	  </listitem>
-	</varlistentry>
-	<varlistentry>
-	  <term>
-	    <emphasis remap='B'>HPI Source Nodes</emphasis>
-	  </term>
-	  <listitem>
-	    <para>
-	      The following values can used for the
-	      <option>--asihpi-input-source</option> and
-	      <option>--asihpi-input-type</option> options above:
-	    </para>
-	    <variablelist remap='TP'>
-	      <varlistentry>
-		<term>
-		  <userinput>NONE</userinput>
-		</term>
-		<term>
-		  <userinput>OSTREAM</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Internal output stream
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>LINEIN</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Generic input signal
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>AESEBU</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    AES3 digital input
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>TUNER</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Tuner
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>RF</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    RF input
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>CLOCK</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Clock source
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>BITSTREAM</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Raw bitstream
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>MIC</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Microphone
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>COBRANET</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    CobraNet
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>ANALOG</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Analog input
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>ADAPTER</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Adapter
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>RTP</userinput>
-		</term>
-		<term>
-		  <userinput>INTERNAL</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    Device internal
-		  </para>
-		</listitem>
-	      </varlistentry>
-	      <varlistentry>
-		<term>
-		  <userinput>AVB</userinput>
-		</term>
-		<listitem>
-		  <para>
-		    AVB input
-		  </para>
-		</listitem>
-	      </varlistentry>
-	    </variablelist>      
-	  </listitem>
-	</varlistentry>
-      </variablelist>
-    </listitem>
-  </varlistentry>
-
-
   <varlistentry>
     <term>
       <emphasis remap='B'>Direct File Streaming</emphasis>
@@ -1658,6 +1351,12 @@ Password=&lt;password&gt;
 </refsect2>
 </refsect1>
 
+<refsect1 id='notes'><title>Notes</title>
+<para>
+  The Debian version of GlassCoder does not support the MPEG-4 HE-AAC+ encoding, as it is non-free. The AudioScience HPI source device is excluded for the same reason.
+</para>
+</refsect1>
+
 <refsect1 id='bugs'><title>Bugs</title>
 <para>
   Never use the <option>--server-auth</option> option; it allows credentials to