[blfs-book] r10327 - trunk/BOOK/multimedia/videoutils

andy at linuxfromscratch.org andy at linuxfromscratch.org
Thu Jun 14 05:46:00 PDT 2012


Author: andy
Date: 2012-06-14 06:45:50 -0600 (Thu, 14 Jun 2012)
New Revision: 10327

Modified:
   trunk/BOOK/multimedia/videoutils/ffmpeg.xml
   trunk/BOOK/multimedia/videoutils/mplayer.xml
Log:
create the ffmpeg html docs

Modified: trunk/BOOK/multimedia/videoutils/ffmpeg.xml
===================================================================
--- trunk/BOOK/multimedia/videoutils/ffmpeg.xml	2012-06-13 12:23:48 UTC (rev 10326)
+++ trunk/BOOK/multimedia/videoutils/ffmpeg.xml	2012-06-14 12:45:50 UTC (rev 10327)
@@ -126,24 +126,19 @@
       commands:
     </para>
 
-<screen><userinput>mkdir build &&
-cd    build &&
-../configure --prefix=/usr --enable-gpl \
-       --enable-shared --disable-static &&
+<screen><userinput>./configure --prefix=/usr --enable-gpl \
+      --enable-shared --disable-static &&
 make</userinput></screen>
 
-    <para>
-      The <application>FFmpeg</application> source contains a tool called
-      <command>qt-faststart</command> that can modify QuickTime formatted movies
-      (mov or mp4) so that the header information is located at the beginning of
-      the file instead of the end. This allows video players to begin playing
-      the content before the entire file has been downloaded. An example of
-      where this is useful for preparing videos before uploading them to
-      YouTube. If need <command>qt-faststart</command>, you can compile it with
-      gcc:
-    </para>
+    <para>To convert the docs to html use the following commands:</para>
 
-<screen><userinput>gcc ../tools/qt-faststart.c -o qt-faststart</userinput></screen>
+<screen><userinput>cd doc &&
+sed -i '/@top/d;/ignore$/d' *.texi &&
+sed -i '/@include avoptions/d' avtools-common-opts.texi &&
+for DOC in *.texi
+do makeinfo --html --no-split -o ${DOC%texi}html ${DOC}
+done &&
+cd ..</userinput></screen>
 
     <para>
       If you have <xref linkend="doxygen"/> installed and wish to create the API
@@ -158,9 +153,22 @@
 
 <screen role="root"><userinput>make install &&
 mkdir /usr/share/doc/ffmpeg-&ffmpeg-version; &&
-cp ../doc/*.html /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
+cp doc/*.html doc/*.txt /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
 
     <para>
+      The <application>FFmpeg</application> source contains a tool called
+      <command>qt-faststart</command> that can modify QuickTime formatted movies
+      (mov or mp4) so that the header information is located at the beginning of
+      the file instead of the end. This allows video players to begin playing
+      the content before the entire file has been downloaded. An example of
+      where this is useful for preparing videos before uploading them to
+      YouTube. If need <command>qt-faststart</command>, you can compile it with
+      gcc. As the <systemitem class="username">root</systemitem> user:
+    </para>
+
+<screen><userinput>gcc ../tools/qt-faststart.c -o /usr/bin/qt-faststart</userinput></screen>
+
+    <para>
       If you used <command>doxygen</command> to create the API documentation,
       install it by issuing the following commands as the
       <systemitem class="username">root</systemitem> user:
@@ -168,25 +176,12 @@
 
 <screen role="root"><userinput>mkdir /usr/share/doc/ffmpeg-&ffmpeg-version;/api &&
 cp -v doxy/* /usr/share/doc/ffmpeg-&ffmpeg-version;/api</userinput></screen>
-
-    <para>
-      If you compiled <command>qt-faststart</command> install it as the
-      <systemitem class="username">root</systemitem> user:
-    </para>
-
-<screen role="root"><userinput>cp qt-faststart /usr/bin</userinput></screen>
   </sect2>
 
   <sect2 role="commands">
     <title>Command Explanations</title>
 
     <para>
-      <command>mkdir build</command> and <command>cd build</command>: This
-      ensures that we compile the <application>FFmpeg</application> object
-      files in a separate directory to the source files.
-    </para>
-
-    <para>
       <option>--enable-gpl</option>: This switch enables the use of GPL code and
       permits support for postprocessing, swscale and many other features.
     </para>
@@ -205,17 +200,24 @@
       almost every codec you could think of. The only reason to enable a
       specific codec (and make <application>FFmpeg</application> link to the
       prerequisite shared library installed on your system) is to make ffmpeg
-      compile an <emphasis>encoder</emphasis> for that codec. Encoding video is
-      a specialist job. If that is what you want to do with
-      <command>ffmpeg</command>, study the output of <command>configure
-      --help</command>. Remember, the dependencies all install their own
-      encoders (that may produce better results than
-      <application>FFmpeg</application>). <application>FFmpeg</application> is
-      an excellent collection of decoders. If you just want to use
-      <application>FFmpeg</application> to watch video or listen to music (via
-      other applications like <application>Gstreamer</application> or Xine) then
-      you will not benefit from linking FFmpeg to another library.
+      compile an <emphasis>encoder</emphasis> for that codec.
+      <application>FFmpeg</application> is an excellent collection of decoders.
+      If you just want to use <application>FFmpeg</application> to watch video
+      or listen to music (via other applications like
+      <application>Gstreamer</application> or Xine) then you will not benefit
+      from linking FFmpeg to another library.
     </para>
+
+    <para>
+      <command>sed -i '/@top/d;/ignore$/d' *.texi</command> and
+      <command>sed -i '/@include avoptions/d' avtools-common-opts.texi</command>:
+      these seds work around problems with the .texi files.
+    </para>
+
+    <para>
+      <command>makeinfo --html --no-split -o ${DOC%texi}html ${DOC}</command>:
+      this converts the .texi files into html.
+    </para>
   </sect2>
 
   <sect2 role="configuration">

Modified: trunk/BOOK/multimedia/videoutils/mplayer.xml
===================================================================
--- trunk/BOOK/multimedia/videoutils/mplayer.xml	2012-06-13 12:23:48 UTC (rev 10326)
+++ trunk/BOOK/multimedia/videoutils/mplayer.xml	2012-06-14 12:45:50 UTC (rev 10327)
@@ -286,7 +286,7 @@
 
 <screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.xz \
     -C /usr/share/mplayer/skins &&
-ln -sfv &mplayer-skin; /usr/share/mplayer/skins/default</userinput></screen>
+ln -sfv clearplayer /usr/share/mplayer/skins/default</userinput></screen>
     </sect3>
   </sect2>
 




More information about the blfs-book mailing list