Changeset 2216c969

Timestamp:

06/14/2012 12:45:50 PM (12 years ago)

Author:

Andrew Benton <andy@…>

Branches:

10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 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:

77b4c621

Parents:

b3bb56b

Message:

create the ffmpeg html docs

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

Location:

multimedia/videoutils

Files:

• ffmpeg.xml (modified) (4 diffs)
• mplayer.xml (modified) (1 diff)

multimedia/videoutils/ffmpeg.xml

@@ -127 +127 @@
     </para>
 
-<screen><userinput>mkdir build &amp;&amp;
-cd    build &amp;&amp;
-../configure --prefix=/usr --enable-gpl \
-       --enable-shared --disable-static &amp;&amp;
+<screen><userinput>./configure --prefix=/usr --enable-gpl \
+      --enable-shared --disable-static &amp;&amp;
 make</userinput></screen>
+
+    <para>To convert the docs to html use the following commands:</para>
+
+<screen><userinput>cd doc &amp;&amp;
+sed -i '/@top/d;/ignore$/d' *.texi &amp;&amp;
+sed -i '/@include avoptions/d' avtools-common-opts.texi &amp;&amp;
+for DOC in *.texi
+do makeinfo --html --no-split -o ${DOC%texi}html ${DOC}
+done &amp;&amp;
+cd ..</userinput></screen>
+
+    <para>
+      If you have <xref linkend="doxygen"/> installed and wish to create the API
+      documentation (takes about 150 MB of space), issue the command
+      <command>doxygen</command>.
+    </para>
+
+    <para>This package does not come with a test suite.</para>
+
+    <para>Now, as the <systemitem class="username">root</systemitem>
+    user:</para>
+
+<screen role="root"><userinput>make install &amp;&amp;
+mkdir /usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
+cp doc/*.html doc/*.txt /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
 
     <para>
@@ -141 +164 @@
       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>
-
-<screen><userinput>gcc ../tools/qt-faststart.c -o qt-faststart</userinput></screen>
-
-    <para>
-      If you have <xref linkend="doxygen"/> installed and wish to create the API
-      documentation (takes about 150 MB of space), issue the command
-      <command>doxygen</command>.
-    </para>
-
-    <para>This package does not come with a test suite.</para>
-
-    <para>Now, as the <systemitem class="username">root</systemitem>
-    user:</para>
-
-<screen role="root"><userinput>make install &amp;&amp;
-mkdir /usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
-cp ../doc/*.html /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
+      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>
@@ -169 +177 @@
 <screen role="root"><userinput>mkdir /usr/share/doc/ffmpeg-&ffmpeg-version;/api &amp;&amp;
 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>
@@ -206 +201 @@
       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>

multimedia/videoutils/mplayer.xml

@@ -287 +287 @@
 <screen role="root"><userinput>tar -xvf ../&mplayer-skin;.tar.xz \
     -C /usr/share/mplayer/skins &amp;&amp;
-ln -sfv &mplayer-skin; /usr/share/mplayer/skins/default</userinput></screen>
+ln -sfv clearplayer /usr/share/mplayer/skins/default</userinput></screen>
     </sect3>
   </sect2>