Ignore:
Timestamp:
08/01/2015 04:26:22 AM (9 years ago)
Author:
Douglas R. Reno <renodr@…>
Branches:
systemd-13485
Children:
ad6910d
Parents:
4a83293
Message:

Import back into SVN from Github

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/branches/systemd@16309 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • multimedia/videoutils/ffmpeg.xml

    r4a83293 rac38e9dc  
    77  <!ENTITY ffmpeg-download-http "http://ffmpeg.org/releases/ffmpeg-&ffmpeg-version;.tar.bz2">
    88  <!ENTITY ffmpeg-download-ftp  " ">
    9   <!ENTITY ffmpeg-md5sum        "a77ca736bbc68d83b3ea77246d22ae8c">
    10   <!ENTITY ffmpeg-size          "9.1 MB">
    11   <!ENTITY ffmpeg-buildsize     "131.6 MB (additional 416 MB for docs and 2289 MB to run the FATE tests)">
    12   <!ENTITY ffmpeg-time          "2.8 SBU, using parallelism=2  (additional 1.1 SBU for docs and 4.2 SBU to run the FATE tests, after sample files are downloaded)">
     9  <!ENTITY ffmpeg-md5sum        "f159c6d7eed8546b23e1a17325cbf1f8">
     10  <!ENTITY ffmpeg-size          "7.8 MB">
     11  <!ENTITY ffmpeg-buildsize     "135 MB (additional 1.0 GB to build and install Doxygen, PDF and Postscript documentation)">
     12  <!ENTITY ffmpeg-time          "3.7 SBU">
    1313]>
    1414
    … …  
    4242    </para>
    4343
    44     &lfs76_checked;
     44    &lfs77_checked;
    4545
    4646    <bridgehead renderas="sect3">Package Information</bridgehead>
    … …  
    8383    <para role="recommended">
    8484      <xref linkend="fdk-aac"/>,
     85      <xref linkend="freetype2"/>,
    8586      <xref linkend="lame"/>,
    8687      <xref linkend="libass"/>,
    … …  
    8889      <xref linkend="libvorbis"/>,
    8990      <xref linkend="libvpx"/>,
    90       <xref linkend="yasm"/>, and
    91       <xref linkend="x264"/>
     91      <xref linkend="opus"/>,
     92      <xref linkend="x264"/>, and
     93      <xref linkend="yasm"/>
    9294    </para>
    9395
    … …  
    9597    <para>
    9698      <xref linkend="alsa-lib"/>,
    97       <xref linkend="libva"/>,
    98       <xref linkend="libvdpau"/> (with the corresponding driver package),
    99       <xref linkend="sdl"/>, and
    100       <xref linkend="x-window-system"/>,
     99      <xref linkend="libva"/> (with the corresponding driver package),
     100      <xref linkend="libvdpau"/> (with the corresponding driver package), and
     101      <xref linkend="sdl"/>
    101102    </para>
    102103
    … …  
    104105    <para role="optional">
    105106      <xref linkend="faac"/>,
    106       <xref linkend="freetype2"/>,
     107      <xref linkend="fribidi"/>,
    107108      <xref linkend="fontconfig"/>,
    108       <xref linkend="gnutls"/>,
     109      <xref linkend="libcdio"/> (to identify and play CDs),
    109110      <xref linkend="libwebp"/>,
    110111      <xref linkend="openjpeg"/>,
    111       <xref linkend="openssl"/>,
    112       <xref linkend="opus"/>,
     112      <xref linkend="openssl"/> or
     113      <xref linkend="gnutls"/>,
    113114      <xref linkend="pulseaudio"/>,
     115      <xref linkend="samba"/>,
    114116      <xref linkend="speex"/>,
     117      <xref linkend="texlive"/> (or <xref linkend="tl-installer"/>) for PDF and PS documentation,
     118      <xref linkend="v4l-utils"/>,
    115119      <xref linkend="xvid"/>,
     120      <xref linkend="x-window-system"/>,
    116121      <ulink url="http://www.speech.cs.cmu.edu/flite/">Flite</ulink>,
    117122      <ulink url="https://files.dyne.org/frei0r/snapshots/">frei0r</ulink>,
    … …  
    121126      <ulink url="http://www.videolan.org/developers/libbluray.html">libbluray</ulink>,
    122127      <ulink url="http://caca.zoy.org/">libcaca</ulink>,
    123       <ulink url="http://ftp.gnu.org/pub/gnu/libcdio/">libcdio</ulink>,
    124128      <ulink url="http://www.celt-codec.org/">libcelt</ulink>,
    125129      <ulink url="http://sourceforge.net/projects/libdc1394">libdc1394</ulink>,
     130      <ulink url="https://www.videolan.org/developers/libdca.html">libdca</ulink>,
    126131      <ulink url="https://ieee1394.wiki.kernel.org/index.php/Libraries">libiec61883</ulink>,
    127132      <ulink url="https://github.com/dekkers/libilbc">libilbc</ulink>,
    … …  
    137142      <ulink url="http://www.nongnu.org/texi2html">texi2html</ulink> (to build HTML documentation),
    138143      <ulink url="http://www.twolame.org/">TwoLAME</ulink>,
    139       <ulink url="http://linuxtv.org/downloads/v4l-utils/">Video4Linux</ulink>,
    140       <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-aacenc/">vo-aaenc</ulink>,
    141       <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-amrwbenc/">vo-amrwbenc</ulink>,
    142       <ulink url="http://xavs.sourceforge.net/">libxavs</ulink> (SVN checkout),
    143       <ulink url="http://kcat.strangesoft.net/openal-releases/">OpenAL</ulink>, and
    144       <ulink url="http://www.videolan.org/developers/x265.html">x265 (H.265/MPEG-H HEVC)</ulink>
     144      <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-aacenc">vo-aaenc</ulink>,
     145      <ulink url="http://sourceforge.net/projects/opencore-amr/files/vo-amrwbenc">vo-amrwbenc</ulink>,
     146      <ulink url="https://bitbucket.org/multicoreware/x265/">x265</ulink>, and
     147      <ulink url="http://zapping.sourceforge.net/ZVBI/">ZVBI</ulink>
    145148    </para>
    146149
    … …  
    168171            --enable-libass      \
    169172            --enable-libfdk-aac  \
     173            --enable-libfreetype \
    170174            --enable-libmp3lame  \
     175            --enable-libopus     \
    171176            --enable-libtheora   \
    172177            --enable-libvorbis   \
    … …  
    179184
    180185    <para>
    181       HTML documentation was built in the previous step. If  you have
    182       <xref linkend="texlive"/> installed and wish to build PDF and
    183       Postscript versions of the documentation, issue the following commands:
    184     </para>
    185 
    186 <screen><userinput>sed -i '$s/$/\n\n@bye/' doc/{git-howto,nut,fate}.texi             &amp;&amp;
    187 sed -i '/machine:i386/ s/\\/@backslashchar{}/g' doc/platform.texi &amp;&amp;
    188 
    189 pushd doc &amp;&amp;
    190 for DOCNAME in `basename -s .html *.html`
     186      If you have <xref linkend="texlive"/> installed and want to build
     187      PDF and Postscript documentation, issue the following commands:
     188    </para>
     189
     190<screen><userinput>pushd doc &amp;&amp;
     191for DOCNAME in $(basename -s .html *.html)
    191192do
    192193    texi2pdf -b $DOCNAME.texi &amp;&amp;
    193194    texi2dvi -b $DOCNAME.texi &amp;&amp;
    194     dvips -o    $DOCNAME.ps   \
    195                 $DOCNAME.dvi
    196 done                          &amp;&amp;
    197 popd                          &amp;&amp;
     195    dvips -o    $DOCNAME.ps $DOCNAME.dvi
     196done &amp;&amp;
     197popd &amp;&amp;
    198198unset DOCNAME</userinput></screen>
    199199
    200200    <para>
    201       If you have <xref linkend="doxygen"/> installed and wish to create the API
    202       documentation (takes about 350 MB of space), issue the command
    203       <command>doxygen doc/Doxyfile</command>.
    204     </para>
    205 
    206     <para>
    207       The fate-suite tests include comparisons with installed files, and should
    208       not be run before the package is installed. Therefore, if you desire to
    209       run them, instructions are given further below.
     201      If you have <xref linkend="doxygen"/> installed and want to build
     202      the API documentation, issue: <command>doxygen doc/Doxyfile</command>.
     203    </para>
     204
     205    <para>
     206      To test the results, issue <command>make RUNNING_FATE= check</command>.
    210207    </para>
    211208
    … …  
    215212
    216213<screen role="root"><userinput>make install &amp;&amp;
    217 install -v -m755    tools/qt-faststart /usr/bin &amp;&amp;
    218 install -v -m644    doc/*.txt \
    219                     /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
    220 
    221     <para>
    222       If PDF and Postscript documentations were built, issue the following
    223       commands, as the <systemitem class="username">root</systemitem> user, to
    224       install them:
    225     </para>
    226 
    227 <screen role="root"><userinput>install -v -m644 doc/*.pdf \
    228                  /usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
    229 install -v -m644 doc/*.ps  \
    230                  /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
    231 
    232     <para>
    233       If you used <command>doxygen</command> to create the API documentation,
    234       install it (another 300 MB of space) by issuing the following commands
     214install -v -m755 tools/qt-faststart /usr/bin &amp;&amp;
     215install -v -m644 doc/*.txt /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
     216
     217    <para>
     218      If the PDF and Postscript documentation was built, run the following
     219      commands as the <systemitem class="username">root</systemitem> user
     220      to install it:
     221    </para>
     222
     223<screen role="root"><userinput>install -v -m644 doc/*.pdf /usr/share/doc/ffmpeg-&ffmpeg-version; &amp;&amp;
     224install -v -m644 doc/*.ps  /usr/share/doc/ffmpeg-&ffmpeg-version;</userinput></screen>
     225
     226    <para>
     227      If you used <command>doxygen</command> to build the API documentation,
     228      you can install it by running the following commands
    235229      as the <systemitem class="username">root</systemitem> user:
    236230    </para>
    237231
    238 <screen role="root"><userinput>install -v -m755 -d /usr/share/doc/ffmpeg-&ffmpeg-version;/api                       &amp;&amp;
    239 cp -vr doc/doxy/html/* /usr/share/doc/ffmpeg-&ffmpeg-version;/api                    &amp;&amp;
    240 find /usr/share/doc/ffmpeg-&ffmpeg-version;/api -type f -exec chmod -c 0644 "{}" ";" &amp;&amp;
    241 find /usr/share/doc/ffmpeg-&ffmpeg-version;/api -type d -exec chmod -c 0755 "{}" ";"</userinput></screen>
    242 
    243     <para>
    244       To properly test the installation you must have <xref linkend="rsync"/>
    245       installed and follow the instructions for the <ulink
    246       url="http://www.ffmpeg.org/fate.html"> FFmpeg Automated Testing
    247       Environment</ulink> (FATE). First, about 879 MB of sample files used to
    248       run FATE are downloaded with the command:
    249     </para>
    250 
    251 <screen><userinput>make fate-rsync SAMPLES=fate-suite/</userinput></screen>
    252 
    253     <para>
    254       The <filename class="directory">fate-suite</filename> directory is
    255       created and the files are downloaded there. That command actually runs
    256       <command>rsync -vrltLW --timeout=60 --contimeout=60
    257       rsync://fate-suite.ffmpeg.org/fate-suite/ fate-suite/</command> command,
    258       thus you may want to compress and keep this directory for testing again,
    259       in another system, or when a new version of ffmpeg is launched. Then, you
    260       unpack the sample files in the source directory, and run, again, the
    261       <command>make</command> command above, to sync with the repository. Now,
    262       the download size and time are drastically reduced.  Estimated values in
    263       "Package Information" do not include the download SBU. Next, FATE is
    264       executed, with the commands (you obtain a number of tests greater than
    265       2000):
    266     </para>
    267 
    268 <screen><userinput>make fate SAMPLES=fate-suite/ | tee ../fate.log &amp;&amp;
    269 grep ^TEST ../fate.log | wc -l</userinput></screen>
     232<screen role="root"><userinput>install -v -dm755 /usr/share/doc/ffmpeg-&ffmpeg-version;/api &amp;&amp;
     233cp -rv doc/doxy/html/* /usr/share/doc/ffmpeg-&ffmpeg-version;/api</userinput></screen>
    270234
    271235  </sect2>
    … …  
    282246
    283247    <para>
    284       <command>sed -i ... texi</command>: Fix some .texi files for
    285       documentation builds.
    286     </para>
    287 
    288     <para>
    289       <command>find ... ";"</command>: Fix permissions of documentation files
    290       and directories.
    291     </para>
    292 
    293     <para>
    294248      <option>--enable-libfreetype</option>: Enables
    295249      <application>Freetype</application> support.
    … …  
    356310      <parameter>--enable-libx264</parameter>: Enables high-quality
    357311      H.264/MPEG-4 AVC encoding via <filename
    358       class="libraryfile">libx264</filename>.A
     312      class="libraryfile">libx264</filename>.
    359313    </para>
    360314
    361315    <para>
    362316      <parameter>--enable-x11grab</parameter>: Enables X11 grabbing.
     317    </para>
     318
     319    <para>
     320      <option>--enable-openssl</option> or <option>--enable-gnutls</option>:
     321      Enables HTTPS protocol for network streams.
    363322    </para>
    364323
    … …  
    423382      <seglistitem>
    424383        <seg>
    425           ffmpeg, ffplay, ffprobe, ffserver, and
     384          ffmpeg, ffplay, ffprobe, ffserver and
    426385          qt-faststart
    427386        </seg>
    … …  
    429388          libavcodec.so, libavdevice.so, libavfilter.so,
    430389          libavformat.so, libavutil.so, libpostproc.so,
    431           libswresample, and libswscale.so
     390          libswresample and libswscale.so
    432391        </seg>
    433392        <seg>
    434           /usr/include/libavcodec,
    435           /usr/include/libavdevice,
    436           /usr/include/libavfilter,
    437           /usr/include/libavformat,
    438           /usr/include/libavutil,
    439           /usr/include/libpostproc,
    440           /usr/include/libswresample
    441           /usr/include/libswscale,
    442           /usr/share/ffmpeg, and
    443           /usr/share/doc/ffmpeg-&ffmpeg-version;
     393          /usr/include/{libavcodec,libavdevice,libavfilter,libavformat},
     394          /usr/include/{libavutil,libpostproc,libswresample,libswscale},
     395          /usr/share/doc/ffmpeg-&ffmpeg-version; and
     396          /usr/share/ffmpeg
    444397        </seg>
    445398      </seglistitem>
Note: See TracChangeset for help on using the changeset viewer.