Changeset 402da65 for multimedia/libdriv/faac.xml

Timestamp:

01/21/2008 03:56:41 PM (16 years ago)

Author:

Randy McMurchy <randy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal

Children:

718ef79

Parents:

5af33308

Message:

Minor tweaks to the FAAC and FAAD2 instructions

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7175 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:

• multimedia/libdriv/faac.xml (modified) (12 diffs)

multimedia/libdriv/faac.xml

@@ -10 +10 @@
   <!ENTITY faac-size          "392 KB">
   <!ENTITY faac-buildsize     "33 MB">
-  <!ENTITY faac-time          "0.55 SBU">
+  <!ENTITY faac-time          "0.6 SBU">
 ]>
 
@@ -32 +32 @@
     <para><application>FAAC</application> is an encoder for a lossy sound
     compression scheme specified in MPEG-2 Part 7 and MPEG-4 Part 3 standards
-    and known as Advanced Audio Coding (AAC). Such encoder is useful for
+    and known as Advanced Audio Coding (AAC). This encoder is useful for
     producing files that can be played back on iPod. Moreover, iPod does not
     understand other sound compression schemes in video files.</para>
@@ -82 +82 @@
 make</userinput></screen>
 
-    <para>This package does not come with a test suite. However, one can test
-    its basic functionality with a sample WAV file. Encode the file:</para>
+    <para>This package does not come with a test suite. However, basic
+    functionality can be tested by encoding a sample WAV file (the sample
+    file is installed by the <xref linkend="alsa-utils"/> package:</para>
     
 <screen><userinput>./frontend/faac -o Front_Left.mp4 /usr/share/sounds/alsa/Front_Left.wav</userinput></screen>
 
-    <para>Then, decode the result with <xref linkend="faad2"/> and play back
-    the decoded file:</para>
+    <para>Then, decode the result using the <command>faad</command> program
+    from the <xref linkend="faad2"/> package and play back the decoded file
+    (requires the <command>aplay</command> program from the
+    <xref linkend="alsa-utils"/> package:</para>
 
 <screen><userinput>faad Front_Left.mp4
@@ -94 +97 @@
 
     <para><command>aplay</command> should identify the file as
-    "Signed 16 bit Little Endian, Rate 48000 Hz, Stereo", and you should hear
-    the words "front left".</para>
+    <quote>Signed 16 bit Little Endian, Rate 48000 Hz, Stereo</quote>, and you
+    should hear the words <quote>front left</quote>.</para>
 
     <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
@@ -107 +110 @@
 
     <para><command>./bootstrap</command>: This command runs GNU Autotools
-    and produces the <command>configure</command> script and some other files
-    that drive the further build.</para>
-
-<!-- Note to editors: remove this sed if the new release re-enables the
+    to create the <command>configure</command> script and other required
+    build files.</para>
+
+    <!-- Note to editors: remove this sed if the new release re-enables the
      option (look for "#if 0" near "case OBJTYPE_FLAG:", this is line
      697 in frontend/main.c as of FAAC-1.26) or fixes the documentation
@@ -118 +121 @@
     for the <option>--obj-type</option> parameter from the
     <command>faac --long-help</command> command output. This parameter
-    is disabled in FAAC-&faac-version; anyway due to sound quality issues
+    is already disabled in FAAC-&faac-version; due to sound quality issues
     with object types other than <quote>Low Complexity</quote>.</para>
 
@@ -128 +131 @@
     by <xref linkend="faad2"/>, even if compiled with DRM support).
     Don't use it.</para>
+
   </sect2>
 
@@ -134 +138 @@
 
     <para>The quality of <application>FAAC</application> is not up
-    to par with the currently best AAC encoders available. Also, it supports
-    only AAC, but not High Efficiency AAC (also known as aacPlus), which provides
-    better quality at low bitrates by means of using the
+    to par with the best AAC encoders currently available. Also, it only
+    supports AAC and not High Efficiency AAC (also known as aacPlus), which
+    provides better quality at low bitrates by means of using the
     <quote>spectral band replication</quote> technology. There are the
     following alternative programs for producing AAC and HE-AAC streams:</para>
@@ -143 +147 @@
       <listitem>
         <para><ulink url="http://www.nero.com/eng/nero-aac-codec.html">Nero AAC Codec</ulink>:
-        available only in the binary form, a command-line AAC and HE-AAC encoder
-        for Linux is in the same archive as the Windows application.</para>
-      </listitem>
-      <listitem>
-        <para><ulink url="http://www.3gpp.org/ftp/Specs/html-info/26410.htm">3GPP Enhanced aacPlus general audio codec</ulink>:
+        available only in the binary form, the command-line AAC and HE-AAC encoders
+        for Linux are in the same archive as the Windows application.</para>
+      </listitem>
+      <listitem>
+        <para><ulink url="http://www.3gpp.org/ftp/Specs/html-info/26410.htm">3GPP
+        Enhanced aacPlus general audio codec</ulink>:
         available in the source form, can encode only HE-AAC up to 48 kbps
         out of the box, but the maximum bitrate can be changed by editing
@@ -166 +171 @@
       <segtitle>Installed Program</segtitle>
       <segtitle>Installed Libraries</segtitle>
+      <segtitle>Installed Directories</segtitle>
 
       <seglistitem>
         <seg>faac</seg>
         <seg>libfaac.{so,a} and libmp4v2.{so,a}</seg>
+        <seg>None</seg>
       </seglistitem>
     </segmentedlist>
@@ -191 +198 @@
         <term><filename class='libraryfile'>libfaac.{so,a}</filename></term>
         <listitem>
-          <para>this library contains functions for encoding AAC streams.</para>
+          <para>contains functions for encoding AAC streams.</para>
           <indexterm zone="faac libfaac">
             <primary sortas="c-libfaac">libfaac.{so,a}</primary>
@@ -201 +208 @@
         <term><filename class='libraryfile'>libmp4v2.{so,a}</filename></term>
         <listitem>
-          <para>this library contains functions for creating and manipulating MP4 files.</para>
+          <para>contains functions for creating and manipulating MP4 files.</para>
           <indexterm zone="faac libmp4v2">
             <primary sortas="c-libmp4v2">libmp4v2.{so,a}</primary>