XML Polishing, Part 1. Review GStreamer pages.

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@10463 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Krejzi 2012-07-24 16:16:08 +00:00
parent cc2e31b61e
commit 2ba0c1a1d6
9 changed files with 526 additions and 384 deletions

View File

@ -95,7 +95,7 @@
<para>Install <application>ALSA Utilities</application> by
running the following commands:</para>
<screen><userinput>./configure --with-systemdsystemunitdir=no &amp;&amp;
<screen><userinput>./configure --without-systemdsystemunitdir &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
@ -109,7 +109,7 @@ make</userinput></screen>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>--with-systemdsystemunitdir=no</command>:
<para><option>--without-systemdsystemunitdir</option>:
Do not install systemd units.</para>
</sect2>
@ -163,19 +163,7 @@ alsactl store</userinput></screen>
<para>The volume settings will be restored from the saved state by
<application>Udev</application> when the device is detected (during boot
or when plugged in for USB devices).</para>
<!--
<para>As the <systemitem class="username">root</systemitem> user, install
a new <application>Udev</application> rules file to create the audio
device nodes and run the restore script:</para>
<screen role="root"><userinput>cat &gt; /etc/udev/rules.d/40-alsa.rules &lt;&lt; "EOF"
# /etc/udev/rules.d/40-alsa.rules
# When a sound device is detected, restore the volume settings
KERNEL=="controlC[0-9]*", ACTION=="add", RUN+="/usr/sbin/alsactl restore %n"
EOF
chmod -v 644 /etc/udev/rules.d/40-alsa.rules</userinput></screen>
-->
<para>All sound devices are not accessible for any user except
<systemitem class="username">root</systemitem> and members of the
<systemitem class="groupname">audio</systemitem> group. Add any users
@ -198,14 +186,12 @@ chmod -v 644 /etc/udev/rules.d/40-alsa.rules</userinput></screen>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>aconnect, alsaconf, alsactl, alsamixer, amidi,
amixer, aplay, aplaymidi, arecord, arecordmidi, aseqdump,
aseqnet, iecset, and speaker-test</seg>
<seg>None</seg>
<seg>/var/lib/alsa and /usr/share/sounds/alsa</seg>
</seglistitem>
</segmentedlist>

View File

@ -114,8 +114,9 @@
commands:
</para>
<screen><userinput>./configure --prefix=/usr --disable-python \
--disable-static &amp;&amp;
<screen><userinput>./configure --prefix=/usr \
--disable-python \
--disable-static &amp;&amp;
make</userinput></screen>
<para>
@ -157,7 +158,8 @@ make</userinput></screen>
libfarstream-0.1.so
</seg>
<seg>
/usr/include/farstream-0.1, /usr/lib/farstream-0.1,
/usr/include/farstream-0.1,
/usr/lib/farstream-0.1,
/usr/share/farstream,
/usr/share/gtk-doc/html/farstream-libs-0.10 and
/usr/share/gtk-doc/html/farstream-plugins-0.1
@ -174,7 +176,7 @@ make</userinput></screen>
<term><filename class="libraryfile">libfarstream-0.1.so</filename></term>
<listitem>
<para>
contains the Farstream API functions.
contains the <application>Farstream</application> API functions.
</para>
<indexterm zone="farstream libfarstream-0.1">
<primary sortas="c-libfarstream-0.1">libfarstream-0.1.so</primary>

View File

@ -27,32 +27,46 @@
</indexterm>
<sect2 role="package">
<title>Introduction to gst-ffmpeg</title>
<title>Introduction to Gst FFMpeg</title>
<para>The <application>gst-ffmpeg</application> package is a gstreamer plugin
for ffmpeg.</para>
<para>
The <application>Gst FFMpeg</application> contains GStreamer plugins
for <application>FFMpeg</application>.
</para>
&lfs70_checked;
&lfs71_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gst-ffmpeg-download-http;"/></para>
<para>
Download (HTTP): <ulink url="&gst-ffmpeg-download-http;"/>
</para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gst-ffmpeg-download-ftp;"/></para>
<para>
Download (FTP): <ulink url="&gst-ffmpeg-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>Download MD5 sum: &gst-ffmpeg-md5sum;</para>
<para>
Download MD5 sum: &gst-ffmpeg-md5sum;
</para>
</listitem>
<listitem>
<para>Download size: &gst-ffmpeg-size;</para>
<para>
Download size: &gst-ffmpeg-size;
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gst-ffmpeg-buildsize;</para>
<para>
Estimated disk space required: &gst-ffmpeg-buildsize;
</para>
</listitem>
<listitem>
<para>Estimated build time: &gst-ffmpeg-time;</para>
<para>
Estimated build time: &gst-ffmpeg-time;
</para>
</listitem>
</itemizedlist>
@ -66,60 +80,57 @@
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">gst-ffmpeg Dependencies</bridgehead>
<bridgehead renderas="sect3">Gst FFMpeg Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="gst-plugins-base"/> and
<xref linkend="yasm"/></para>
<para role="required">
<xref linkend="gst-plugins-base"/> and
<xref linkend="yasm"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional"><ulink url="http://code.entropywave.com/projects/orc/">ORC
</ulink></para>
<para role="optional">
<ulink url="http://code.entropywave.com/projects/orc/">ORC</ulink>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gst-ffmpeg"/></para>
<ulink url="&blfs-wiki;/gst-ffmpeg"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of gst-ffmpeg</title>
<title>Installation of Gst FFMpeg</title>
<para>Install <application>gst-ffmpeg</application> by running the following
commands:</para>
<para>
Install <application>Gst FFMpeg</application> by running the following
commands:
</para>
<screen><userinput>patch -p1 &lt; ../gst-ffmpeg-&gst-ffmpeg-version;-gcc-4.7-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
To test the results, issue: <command>make check</command>.
</para>
<para>
<command>patch -p1 &lt;
../gst-ffmpeg-&gst-ffmpeg-version;-gcc-4.7-1.patch</command>: This patch
fixes compiling Gst FFmpeg with Gcc 4.7.
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<segtitle>Installed GStreamer Plugins</segtitle>
<seglistitem>
<seg>None</seg>
<seg>libgstffmpeg.so, libgstffmpegscale.so, and libgstpostproc.so</seg>
<seg>None</seg>
<seg>
libgstffmpeg.so, libgstffmpegscale.so and libgstpostproc.so
</seg>
</seglistitem>
</segmentedlist>

View File

@ -29,118 +29,146 @@
<sect2 role="package">
<title>Introduction to Gstreamer Bad Plug-ins</title>
<para>The <application>GStreamer Bad Plug-ins</application> package contains a
set a set of plug-ins that aren't up to par compared to the rest. They might
be close to being good quality, but they're missing something - be it a good
code review, some documentation, a set of tests, a real live maintainer, or
some actual wide use.</para>
<para>
The <application>GStreamer Bad Plug-ins</application> package contains a set
a set of plug-ins that aren't up to par compared to the rest. They might be
close to being good quality, but they're missing something - be it a good
code review, some documentation, a set of tests, a real live maintainer,
or some actual wide use. Also see the <xref linkend="gst-plugins-good"/>,
<xref linkend="gst-plugins-ugly"/> and <xref linkend="gst-ffmpeg"/> packages.
</para>
&lfs70_checked;
&lfs71_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gst-plugins-bad-download-http;"/></para>
<para>
Download (HTTP): <ulink url="&gst-plugins-bad-download-http;"/>
</para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gst-plugins-bad-download-ftp;"/></para>
<para>
Download (FTP): <ulink url="&gst-plugins-bad-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>Download MD5 sum: &gst-plugins-bad-md5sum;</para>
<para>
Download MD5 sum: &gst-plugins-bad-md5sum;
</para>
</listitem>
<listitem>
<para>Download size: &gst-plugins-bad-size;</para>
<para>
Download size: &gst-plugins-bad-size;
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gst-plugins-bad-buildsize;</para>
<para>
Estimated disk space required: &gst-plugins-bad-buildsize;
</para>
</listitem>
<listitem>
<para>Estimated build time: &gst-plugins-bad-time;</para>
<para>
Estimated build time: &gst-plugins-bad-time;
</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">GStreamer Bad Plug-ins Dependencies</bridgehead>
<bridgehead renderas="sect4">Required</bridgehead>
<para role="required"><xref linkend="gst-plugins-base"/></para>
<para role="required">
<xref linkend="gst-plugins-base"/>
</para>
<bridgehead renderas="sect4">Recommended</bridgehead>
<para role="recommended">
<xref linkend="faac"/>,
<xref linkend="libpng"/>,
<xref linkend="libvpx"/>,
<xref linkend="openssl"/> and
<xref linkend="xvid"/>
</para>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<ulink url="http://www.celt-codec.org/">celt</ulink>,
<xref linkend="curl"/>,
<ulink url="http://diracvideo.org/">Dirac</ulink>,
<ulink url="http://www.directfb.org/">DirectFB</ulink>,
<xref linkend="faac"/>,
<xref linkend="faad2"/>,
<ulink url="http://www.speech.cs.cmu.edu/flite/">Flite</ulink>,
<ulink url="http://code.google.com/p/game-music-emu/">
Game Music Emu</ulink>,
<ulink url="http://libgsm.sourcearchive.com/">GSM</ulink>,
<xref linkend="jasper"/>,
<ulink url="http://www.ladspa.org/">LADSPA</ulink>,
<ulink url="http://code.google.com/p/libass/">libass</ulink>,
<ulink url="http://libcdaudio.sourceforge.net/">libcdaudio</ulink>,
<ulink url="http://sourceforge.net/projects/libdc1394">libdc1394</ulink>,
<ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
<ulink url="http://libiptcdata.sourceforge.net/">libiptcdata</ulink>,
<ulink url="http://code.google.com/p/libkate/">libkate</ulink>,
<ulink url="http://sourceforge.net/projects/farsight/files/libmimic/">
libmimic</ulink>,
<ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
<ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
<ulink url="http://www.musepack.net/">libmpcdec</ulink>,
<xref linkend="libmusicbrainz"/>,
<ulink url="http://code.google.com/p/musicip-libofa/">libofa</ulink>,
<xref linkend="libpng"/>,
<xref linkend="librsvg"/>,
<xref linkend="libsndfile"/>,
<xref linkend="libtheora"/>,
<ulink url="http://cgit.freedesktop.org/~aplattner/libvdpau">
libvdpau</ulink>,
<xref linkend="libvpx"/>,
<ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>,
<xref linkend="neon"/>,
<ulink url="http://kcat.strangesoft.net/openal.html">OpenAL</ulink>,
<xref linkend="openssl"/>,
<ulink url="http://code.entropywave.com/projects/orc/">ORC</ulink>,
<ulink url="http://rtmpdump.mplayerhq.hu/">rtmpdump</ulink>,
<ulink url="http://diracvideo.org/">Schroedinger</ulink>,
<xref linkend="sdl"/>,
<ulink url="http://www.surina.net/soundtouch/">SoundTouch</ulink>,
<ulink url="http://www.soft-switch.org/">SpanDSP</ulink>,
<ulink url="http://sourceforge.net/projects/opencore-amr/">
vo-aacenc</ulink>,
<ulink url="http://sourceforge.net/projects/opencore-amr/">
vo-amrwbenc</ulink>,
<ulink url="http://wildmidi.sourceforge.net/">WildMidi</ulink>,
<xref linkend="xvid"/>,
<ulink url="http://zbar.sourceforge.net/">ZBAR</ulink>,
<ulink url="http://zapping.sourceforge.net/ZVBI/index.html">
ZVBI</ulink></para>
<ulink url="http://www.celt-codec.org/">celt</ulink>,
<xref linkend="curl"/>,
<ulink url="http://diracvideo.org/">Dirac</ulink>,
<ulink url="http://www.directfb.org/">DirectFB</ulink>,
<xref linkend="faac"/>,
<xref linkend="faad2"/>,
<ulink url="http://www.speech.cs.cmu.edu/flite/">Flite</ulink>,
<ulink url="http://code.google.com/p/game-music-emu/">
Game Music Emu</ulink>,
<ulink url="http://libgsm.sourcearchive.com/">GSM</ulink>,
<xref linkend="jasper"/>,
<ulink url="http://www.ladspa.org/">LADSPA</ulink>,
<ulink url="http://code.google.com/p/libass/">libass</ulink>,
<ulink url="http://libcdaudio.sourceforge.net/">libcdaudio</ulink>,
<ulink url="http://sourceforge.net/projects/libdc1394">libdc1394</ulink>,
<ulink url="http://www.videolan.org/developers/libdca.html">libdca</ulink>,
<ulink url="http://libiptcdata.sourceforge.net/">libiptcdata</ulink>,
<ulink url="http://code.google.com/p/libkate/">libkate</ulink>,
<ulink url="http://sourceforge.net/projects/farsight/files/libmimic/">
libmimic</ulink>,
<ulink url="http://sourceforge.net/projects/libmms">libmms</ulink>,
<ulink url="http://sourceforge.net/projects/modplug-xmms/">libmodplug</ulink>,
<ulink url="http://www.musepack.net/">libmpcdec</ulink>,
<xref linkend="libmusicbrainz"/>,
<ulink url="http://code.google.com/p/musicip-libofa/">libofa</ulink>,
<xref linkend="librsvg"/>,
<xref linkend="libsndfile"/>,
<ulink url="http://cgit.freedesktop.org/~aplattner/libvdpau">
libvdpau</ulink>,
<ulink url="http://mjpeg.sourceforge.net/">MJPEG Tools</ulink>,
<xref linkend="neon"/>,
<ulink url="http://kcat.strangesoft.net/openal.html">OpenAL</ulink>,
<ulink url="http://code.entropywave.com/projects/orc/">ORC</ulink>,
<ulink url="http://rtmpdump.mplayerhq.hu/">rtmpdump</ulink>,
<ulink url="http://diracvideo.org/">Schroedinger</ulink>,
<xref linkend="sdl"/>,
<ulink url="http://www.surina.net/soundtouch/">SoundTouch</ulink>,
<ulink url="http://www.soft-switch.org/">SpanDSP</ulink>,
<ulink url="http://sourceforge.net/projects/opencore-amr/">
VO AACENC</ulink>,
<ulink url="http://sourceforge.net/projects/opencore-amr/">
VO AMRWBENC</ulink>,
<ulink url="http://wildmidi.sourceforge.net/">WildMidi</ulink>,
<ulink url="http://zbar.sourceforge.net/">ZBAR</ulink> and
<ulink url="http://zapping.sourceforge.net/ZVBI/index.html">
ZVBI</ulink>
</para>
<bridgehead renderas="sect4">Optional, for the unit regression tests</bridgehead>
<para>To run the tests you need to have compiled gstreamer against libcheck,
and you can optionally use
<ulink url="http://www.valgrind.org/">Valgrind</ulink></para>
<para>
<ulink url="http://www.valgrind.org/">Valgrind</ulink>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gst-plugins-bad"/></para>
<ulink url="&blfs-wiki;/gst-plugins-bad"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of GStreamer Bad Plug-ins</title>
<para>Install <application>Gstreamer Bad Plug-ins</application> by running the following
commands:</para>
<para>
Install <application>Gstreamer Bad Plug-ins</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr --with-gtk=3.0 --disable-examples &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>. Note that
tests for some of the items may fail.</para>
<para>
To test the results, issue: <command>make check</command>. Note that
tests for some of the items may fail.
</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
@ -149,12 +177,16 @@ make</userinput></screen>
<sect2 role="commands">
<title>Command Explanations</title>
<para><command>--with-gtk=3.0</command>: Build with <application>gtk3</application>
instead of the default gtk2 : recommended for a <application>gnome</application>
desktop.</para>
<para>
<parameter>--with-gtk=3.0</parameter>: Build against <application>GTK+ 3</application>
instead of the default <application>GTK+ 2</application>: recommended for a
<application>GNOME</application> Desktop.
</para>
<para><command>--disable-examples</command>: if the dependenc{y,ies} for the camera
driver have been satisfied, the associated example code fails to build.</para>
<para>
<option>--disable-examples</option>: if the dependencies for the camera
driver have been satisfied, the associated example code fails to build.
</para>
</sect2>
@ -162,16 +194,19 @@ make</userinput></screen>
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>none</seg>
<seg>Several <application>GStreamer</application> plugins</seg>
<seg>/usr/{include/gstreamer-0.10/gst/signalprocessor,
share/{gtk-doc/gst-plugins-bad-libs-0.10,
gstreamer-0.10/camera-apps}}</seg>
<seg>
libgstbasecamerabinsrc-0.10.so, libgstbasevideo-0.10.so, libgstcodecparsers-0.10.so,
libgstphotography-0.10.so, libgstsignalprocessor-0.10.so and libgstvdp-0.10.so
</seg>
<seg>
/usr/include/gstreamer-0.10/gst/{basecamerabinsrc,codecparsers,interfaces},
/usr/include/gstreamer-0.10/gst/{signalprocessor,vdpau,video} and
/usr/share/gtk-doc/gst-plugins-bad-libs-0.10
</seg>
</seglistitem>
</segmentedlist>

View File

@ -30,38 +30,52 @@
<sect2 role="package">
<title>Introduction to GStreamer Base Plug-ins</title>
<para>The <application>GStreamer Base Plug-ins</application> is a
well-groomed and well-maintained collection of
<application>GStreamer</application> plug-ins and elements, spanning the
range of possible types of elements one would want to write for
<application>GStreamer</application>. It also contains helper libraries
and base classes useful for writing elements. A wide range of video and
audio decoders, encoders, and filters are included. Also see the
<xref linkend="gst-plugins-good"/>, <xref linkend="gst-plugins-bad"/>,
<xref linkend="gst-plugins-ugly"/>, and <xref linkend="gst-ffmpeg"/>
packages.</para>
<para>
The <application>GStreamer Base Plug-ins</application> is a
well-groomed and well-maintained collection of
<application>GStreamer</application> plug-ins and elements, spanning the
range of possible types of elements one would want to write for
<application>GStreamer</application>. It also contains helper libraries
and base classes useful for writing elements. A wide range of video and
audio decoders, encoders, and filters are included. Also see the
<xref linkend="gst-plugins-bad"/>, <xref linkend="gst-plugins-good"/>,
<xref linkend="gst-plugins-ugly"/>, and <xref linkend="gst-ffmpeg"/>
packages.
</para>
&lfs70_checked;
&lfs71_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gst-plugins-base-download-http;"/></para>
<para>
Download (HTTP): <ulink url="&gst-plugins-base-download-http;"/>
</para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gst-plugins-base-download-ftp;"/></para>
<para>
Download (FTP): <ulink url="&gst-plugins-base-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>Download MD5 sum: &gst-plugins-base-md5sum;</para>
<para>
Download MD5 sum: &gst-plugins-base-md5sum;
</para>
</listitem>
<listitem>
<para>Download size: &gst-plugins-base-size;</para>
<para>
Download size: &gst-plugins-base-size;
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gst-plugins-base-buildsize;</para>
<para>
Estimated disk space required: &gst-plugins-base-buildsize;
</para>
</listitem>
<listitem>
<para>Estimated build time: &gst-plugins-base-time;</para>
<para>
Estimated build time: &gst-plugins-base-time;
</para>
</listitem>
</itemizedlist>
@ -108,60 +122,56 @@
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gst-plugins-base"/></para>
<ulink url="&blfs-wiki;/gst-plugins-base"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of GStreamer Base Plug-ins</title>
<para>Install <application>GStreamer Base Plug-ins</application> by running
the following commands:</para>
<para>
Install <application>GStreamer Base Plug-ins</application> by running
the following commands:
</para>
<screen><userinput>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
docs/libs/Makefile.in &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<!-- without libcheck, 'make check' is pointless -->
<para>To run the unit regression tests, issue: <command>make check</command>.
There are
many other <filename>Makefile</filename> targets you can specify for
running the tests, issue <command>make -C tests/check help</command> to see
the complete list.</para>
<para>
To run the unit regression tests, issue: <command>make check</command>.
There are many other <filename>Makefile</filename> targets you can specify
for running the tests, issue <command>make -C tests/check help</command>
to see the complete list.
</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
<!-- Docs are installed now
<para>If you did not rebuild the API documentation by passing
<option>-enable-gtk-doc</option> to the <command>configure</command>
script and you wish to install the pre-built documentation, issue the
following command as the <systemitem class="username">root</systemitem>
user:</para>
<screen role="root"><userinput>make -C docs/libs install-data &amp;&amp;
make -C docs/plugins install-data</userinput></screen>-->
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<para>
<command>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
docs/libs/Makefile.in</command>: This <command>sed</command> tests if
<command>gtkdoc-rebase</command> is present, and only uses it if it is,
but the test <command>which gtk-doc</command> is interpreted as an error by
<command>make</command> if <command>gtkdoc-rebase</command> is not present.
The <command>sed</command> command ensures the command is always regarded as
successful.
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
href="../../xincludes/static-libraries.xml"/>
<para><option>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
docs/libs/Makefile.in</option>: This Makefile tests if
<command>gtkdoc-rebase</command> is present, and only uses it if it is,
but the test <command>which gtk-doc</command> is interpreted as an error by
<command>make</command> if <command>gtkdoc-rebase</command> is not present. The
<command>sed</command> command ensures the command is always regarded as
successful.</para>
<para><option>--disable-static</option>: This switch prevents the static
libraries from being built.</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
@ -174,11 +184,22 @@ make -C docs/plugins install-data</userinput></screen>-->
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>gst-visualise-0.10</seg>
<seg>libgst*.{so,a} and numerous <application>GStreamer</application>
plugins</seg>
<seg>/usr/include/gstreamer-0.10/gst/{too numerous to list} and
/usr/share/gtk-doc/html/gst-plugins-base-libs-0.10</seg>
<seg>
gst-visualise-0.10
</seg>
<seg>
libgstapp-0.10.so, libgstaudio-0.10.so, libgstcdda-0.10.so, libgstfft-0.10.so,
libgstinterfaces-0.10.so, libgstnetbuffer-0.10.so, libgstpbutils-0.10.so,
libgstriff-0.10.so, libgstrtp-0.10.so, libgstrtsp-0.10.so, libgstsdp-0.10.so,
libgsttag-0.10.so and libgstvideo-0.10.so
</seg>
<seg>
/usr/include/gstreamer-0.10/gst/{app,audio,cdda,fft,floatcast,interfaces,netbuffer}
/usr/include/gstreamer-0.10/gst/{pbutils,riff,rtp,rtsp,sdp,tag,video},
/usr/share/gst-plugins-base,
/usr/share/gtk-doc/html/gst-plugins-base-libs-0.10 and
/usr/share/gtk-doc/html/gst-plugins-base-plugins-0.10
</seg>
</seglistitem>
</segmentedlist>
@ -190,8 +211,10 @@ make -C docs/plugins install-data</userinput></screen>-->
<varlistentry id="gst-visualise">
<term><command>gst-visualise-0.10</command></term>
<listitem>
<para>is used to run a basic <application>GStreamer</application>
pipeline to display a graphical visualisation of an audio stream.</para>
<para>
is used to run a basic <application>GStreamer</application>
pipeline to display a graphical visualisation of an audio stream.
</para>
<indexterm zone="gst-plugins-base gst-visualise">
<primary sortas="b-gst-visualise">gst-visualise-0.10</primary>
</indexterm>

View File

@ -5,17 +5,16 @@
%general-entities;
<!ENTITY gst-plugins-good-download-http
"&gnome-download-http;/gst-plugins-good/0.10/gst-plugins-good-&gst-plugins-good-version;.tar.xz">
"&gnome-download-http;/gst-plugins-good/0.10/gst-plugins-good-&gst-plugins-good-version;.tar.xz">
<!ENTITY gst-plugins-good-download-ftp
"&gnome-download-ftp;/gst-plugins-good/0.10/gst-plugins-good-&gst-plugins-good-version;.tar.xz">
"&gnome-download-ftp;/gst-plugins-good/0.10/gst-plugins-good-&gst-plugins-good-version;.tar.xz">
<!ENTITY gst-plugins-good-md5sum "555845ceab722e517040bab57f9ace95">
<!ENTITY gst-plugins-good-size "2.6 MB">
<!ENTITY gst-plugins-good-buildsize "110 MB">
<!ENTITY gst-plugins-good-time "1.2 SBU">
]>
<sect1 id="gst-plugins-good"
xreflabel="gst-plugins-good-&gst-plugins-good-version;">
<sect1 id="gst-plugins-good" xreflabel="gst-plugins-good-&gst-plugins-good-version;">
<?dbhtml filename="gst-plugins-good.html"?>
<sect1info>
@ -124,8 +123,6 @@
<bridgehead renderas="sect4">Optional, for the unit regression tests</bridgehead>
<para>
To run the tests you need to have compiled gstreamer against libcheck, and
you can optionally use
<ulink url="http://www.valgrind.org/">Valgrind</ulink>
</para>
@ -192,13 +189,9 @@ make</userinput></screen>
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>
Numerous <application>GStreamer</application> plugins
</seg>
<seg>
/usr/share/gtk-doc/html/gst-plugins-good-plugins-0.10
</seg>

View File

@ -4,17 +4,16 @@
<!ENTITY % general-entities SYSTEM "../../general.ent">
%general-entities;
<!ENTITY gst-plugins-ugly-download-http "http://gstreamer.freedesktop.org/src/gst-plugins-ugly/gst-plugins-ugly-&gst-plugins-ugly-version;.tar.xz">
<!ENTITY gst-plugins-ugly-download-http
"http://gstreamer.freedesktop.org/src/gst-plugins-ugly/gst-plugins-ugly-&gst-plugins-ugly-version;.tar.xz">
<!ENTITY gst-plugins-ugly-download-ftp " ">
<!-- <!ENTITY gst-plugins-ugly-download-ftp "&gnome-download-ftp;/gst-plugins-ugly/0.10/gst-plugins-ugly-&gst-plugins-ugly-version;.tar.bz2"> -->
<!ENTITY gst-plugins-ugly-md5sum "ba26045c8c8c91f0d48d327ccf53ac0c">
<!ENTITY gst-plugins-ugly-size "864 KB">
<!ENTITY gst-plugins-ugly-buildsize "20 MB">
<!ENTITY gst-plugins-ugly-time "0.3 SBU">
]>
<sect1 id="gst-plugins-ugly"
xreflabel="gst-plugins-ugly-&gst-plugins-ugly-version;">
<sect1 id="gst-plugins-ugly" xreflabel="gst-plugins-ugly-&gst-plugins-ugly-version;">
<?dbhtml filename="gst-plugins-ugly.html"?>
<sect1info>
@ -31,39 +30,50 @@
<sect2 role="package">
<title>Introduction to GStreamer Ugly Plug-ins</title>
<para>The <application>GStreamer Ugly Plug-ins</application> is a set of
plug-ins considered by the <application>GStreamer</application> developers
to have good quality and correct functionality, but distributing them might
pose problems. The license on either the plug-ins or the supporting
libraries might not be how the <application>GStreamer</application>
developers would like. The code might be widely known to present patent
problems. Also see the <xref linkend="gst-plugins-good"/>, <ulink
url="http://gstreamer.freedesktop.org/modules/gst-plugins-bad.html">
GStreamer Bad Plug-ins</ulink> and <ulink
url="http://gstreamer.freedesktop.org/modules/gst-ffmpeg.html">GStreamer
FFmpeg plug-in</ulink> packages.</para>
<para>
The <application>GStreamer Ugly Plug-ins</application> is a set of plug-ins
considered by the <application>GStreamer</application> developers to have
good quality and correct functionality, but distributing them might pose
problems. The license on either the plug-ins or the supporting libraries
might not be how the <application>GStreamer</application> developers would
like. The code might be widely known to present patent problems. Also see
the <xref linkend="gst-plugins-bad"/>, <xref linkend="gst-plugins-good"/>
and <xref linkend="gst-ffmpeg"/> packages.
</para>
&lfs70_checked;
&lfs71_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gst-plugins-ugly-download-http;"/></para>
<para>
Download (HTTP): <ulink url="&gst-plugins-ugly-download-http;"/>
</para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gst-plugins-ugly-download-ftp;"/></para>
<para>
Download (FTP): <ulink url="&gst-plugins-ugly-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>Download MD5 sum: &gst-plugins-ugly-md5sum;</para>
<para>
Download MD5 sum: &gst-plugins-ugly-md5sum;
</para>
</listitem>
<listitem>
<para>Download size: &gst-plugins-ugly-size;</para>
<para>
Download size: &gst-plugins-ugly-size;
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gst-plugins-ugly-buildsize;</para>
<para>
Estimated disk space required: &gst-plugins-ugly-buildsize;
</para>
</listitem>
<listitem>
<para>Estimated build time: &gst-plugins-ugly-time;</para>
<para>
Estimated build time: &gst-plugins-ugly-time;
</para>
</listitem>
</itemizedlist>
@ -98,13 +108,12 @@
<bridgehead renderas="sect4">Optional, for the unit regression tests</bridgehead>
<para>
To run the tests you need to have compiled gstreamer against libcheck,
and you can optionaly use
<ulink url="http://www.valgrind.org/">Valgrind</ulink>
</para>
<bridgehead renderas="sect4">Optional (Required to Rebuild the API
Documentation)</bridgehead>
<bridgehead renderas="sect4">
Optional (Required to Rebuild the API Documentation)
</bridgehead>
<para role="optional">
<xref linkend="gtk-doc"/> and
<xref linkend="python2"/> (compiled against an XML parser such as
@ -112,47 +121,61 @@
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gst-plugins-ugly"/></para>
<ulink url="&blfs-wiki;/gst-plugins-ugly"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of GStreamer Ugly Plug-ins</title>
<para>Install <application>GStreamer Ugly Plug-ins</application> by running
the following commands:</para>
<para>
Install <application>GStreamer Ugly Plug-ins</application> by running
the following commands:
</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>To run the unit regression tests, issue: <command>make check</command>.</para>
<para>
To run the unit regression tests, issue: <command>make check</command>.
</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
<para>If you did not rebuild the API documentation by passing
<option>--enable-gtk-doc</option> to the <command>configure</command>
script and you wish to install the pre-built documentation, issue the
following command as the <systemitem class="username">root</systemitem>
user:</para>
<para>
If you did not rebuild the API documentation by passing
<option>--enable-gtk-doc</option> to the <command>configure</command>
script and you wish to install the pre-built documentation, issue the
following command as the <systemitem class="username">root</systemitem>
user:
</para>
<screen role="root"><userinput>make -C docs/plugins install-data</userinput></screen>
</sect2>
<sect2 role="commands">
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
<sect2 role="content">
<title>Contents</title>
<segmentedlist>
<segtitle>Installed Programs</segtitle>
<segtitle>Installed Libraries</segtitle>
<segtitle>Installed Directories</segtitle>
<segtitle>Installed Directory</segtitle>
<seglistitem>
<seg>None</seg>
<seg>Several <application>GStreamer</application> plugins</seg>
<seg>/usr/share/gtk-doc/html/gst-plugins-ugly-plugins-0.10</seg>
<seg>
/usr/share/gtk-doc/html/gst-plugins-ugly-plugins-0.10
</seg>
</seglistitem>
</segmentedlist>

View File

@ -12,7 +12,7 @@
<!ENTITY gstreamer-time "1.2 SBU">
]>
<sect1 id="gstreamer" xreflabel="gstreamer-&gstreamer-version;">
<sect1 id="gstreamer" xreflabel="GStreamer-&gstreamer-version;">
<?dbhtml filename="gstreamer.html"?>
<sect1info>
@ -20,7 +20,7 @@
<date>$Date$</date>
</sect1info>
<title>gstreamer-&gstreamer-version;</title>
<title>GStreamer-&gstreamer-version;</title>
<indexterm zone="gstreamer">
<primary sortas="a-GStreamer">GStreamer</primary>
@ -29,38 +29,52 @@
<sect2 role="package">
<title>Introduction to GStreamer</title>
<para>The <application>GStreamer</application> package contains a streaming
media framework that enables applications to share a common set of plugins for
things like video decoding and encoding, audio encoding and decoding, audio
and video filters, audio visualisation, Web streaming and anything else that
streams in real-time or otherwise. It is modelled after research software
worked on at the Oregon Graduate Institute. After installing
<application>GStreamer</application>, you'll likely need to install
one or more of the <xref linkend="gst-plugins-good"/>,
<xref linkend="gst-plugins-ugly"/>, <xref linkend="gst-plugins-bad"/>
and <xref linkend="gst-ffmpeg"/> packages.</para>
<para>
<application>GStreamer</application> is a streaming media framework that
enables applications to share a common set of plugins for things like
video decoding and encoding, audio encoding and decoding, audio and video
filters, audio visualisation, Web streaming and anything else that streams
in real-time or otherwise. It is modelled after research software worked
on at the Oregon Graduate Institute. After installing
<application>GStreamer</application>, you'll likely need to install one or
more of the <xref linkend="gst-plugins-bad"/>,
<xref linkend="gst-plugins-good"/>, <xref linkend="gst-plugins-ugly"/> and
<xref linkend="gst-ffmpeg"/> packages.
</para>
&lfs70_checked;
&lfs71_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&gstreamer-download-http;"/></para>
<para>
Download (HTTP): <ulink url="&gstreamer-download-http;"/>
</para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&gstreamer-download-ftp;"/></para>
<para>
Download (FTP): <ulink url="&gstreamer-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>Download MD5 sum: &gstreamer-md5sum;</para>
<para>
Download MD5 sum: &gstreamer-md5sum;
</para>
</listitem>
<listitem>
<para>Download size: &gstreamer-size;</para>
<para>
Download size: &gstreamer-size;
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &gstreamer-buildsize;</para>
<para>
Estimated disk space required: &gstreamer-buildsize;
</para>
</listitem>
<listitem>
<para>Estimated build time: &gstreamer-time;</para>
<para>
Estimated build time: &gstreamer-time;
</para>
</listitem>
</itemizedlist>
@ -80,64 +94,57 @@
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">
<xref linkend="gsl"/>,
<xref linkend='check'/> (required to run the unit regression tests and also enables
<filename class='libraryfile'>libgstcheck-0.10</filename>), and
<ulink url="http://www.valgrind.org/">Valgrind</ulink>
(optionaly used during the unit regression tests)
</para>
<!-- exceptionally, there seems no way to install the shipped
API docs, so they have to be built, not rebuilt.-->
<bridgehead renderas="sect4">Optional (Required to build the API
Documentation)</bridgehead>
<bridgehead renderas="sect4">
Optional (Required to rebuild the API Documentation)
</bridgehead>
<para role="optional">
<xref linkend="gtk-doc"/> and
<xref linkend="python2"/> (compiled against an XML Parser such as
<xref linkend="expat"/>). Alternatively, developers can access
the online API docs at <ulink
url="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/api-index-full.html">
freedesktop.org</ulink>
<xref linkend="expat"/>).
</para>
<bridgehead renderas="sect4">Optional (Required to Build
Manuals)</bridgehead>
<bridgehead renderas="sect4">Optional (Required to Build Manuals)</bridgehead>
<para role="optional">
<xref linkend="libxslt"/>,
<xref linkend="texlive"/>,
<xref linkend="docbook-utils"/>,
<ulink url="http://www.xfig.org/">Transfig</ulink> (all needed
to build the HTML manual), plus
<xref linkend="gs"/>, and
<ulink url="http://netpbm.sourceforge.net/">Netpbm</ulink>
to build the postscript and PDF manuals.
Alternatively, developers can access the online manual at <ulink
url="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/manual/html/index.html">
freedesktop.org</ulink>
<xref linkend="gs"/>
<xref linkend="libxslt"/> and
<xref linkend="texlive"/>
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/gstreamer"/></para>
<ulink url="&blfs-wiki;/gstreamer"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of GStreamer</title>
<para>Install <application>GStreamer</application> by running the following
commands:</para>
<para>
Install <application>GStreamer</application> by running the following
commands:
</para>
<screen><userinput>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
docs/{gst,libs}/Makefile.in &amp;&amp;
./configure --prefix=/usr \
--libexecdir=/usr/lib &amp;&amp;
--libexecdir=/usr/lib \
--disable-static &amp;&amp;
make</userinput></screen>
<para>To test the results, issue: <command>make check</command>. There are
many other <filename>Makefile</filename> targets you can specify for
running the tests, issue <command>make -C tests/check help</command> to see
the complete list.</para>
<para>
To test the results, issue: <command>make check</command>. There are
many other <filename>Makefile</filename> targets you can specify for
running the tests, issue <command>make -C tests/check help</command>
to see the complete list.
</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/gstreamer-0.10/design &amp;&amp;
@ -152,17 +159,21 @@ fi</userinput></screen>
<sect3>
<title>Testing the Installation</title>
<para>To test the functionality of the
<application>GStreamer</application> installation, you can run a simple
test as an unprivileged user (you may have to run
<command>ldconfig</command> as the
<systemitem class="username">root</systemitem> user before attempting
the test).</para>
<para>
To test the functionality of the
<application>GStreamer</application> installation, you can run a
simple test as an unprivileged user (you may have to run
<command>ldconfig</command> as the
<systemitem class="username">root</systemitem> user before
attempting the test).
</para>
<screen><userinput>gst-launch -v fakesrc num_buffers=5 ! fakesink</userinput></screen>
<para>If the command outputs a series of messages from fakesrc and
fakesink, everything is okay.</para>
<para>
If the command outputs a series of messages from fakesrc and
fakesink, everything is okay.
</para>
</sect3>
@ -171,36 +182,44 @@ fi</userinput></screen>
<sect2 role="commands">
<title>Command Explanations</title>
<para><option>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
docs/{gst,libs}/Makefile.in</option>: Two of the Makefiles test if
<command>gtkdoc-rebase</command> is present, and only use it if it is,
but the test <command>which gtk-doc</command> is interpreted as an error by
<command>make</command> if <command>gtkdoc-rebase</command> is not present. The
<command>sed</command> command ensures the command is always regarded as
successful.</para>
<para>
<command>sed -i 's/\(.*gtkdoc-rebase --relative.* \)\(;.*\)/\1|| true\2/' \
docs/{gst,libs}/Makefile.in</command>: Two of the Makefiles test if
<command>gtkdoc-rebase</command> is present, and only use it if it is,
but the test <command>which gtk-doc</command> is interpreted as an error by
<command>make</command> if <command>gtkdoc-rebase</command> is not present.
The <command>sed</command> command ensures the command is always regarded as
successful.
</para>
<para><parameter>--libexecdir=/usr/lib</parameter>: This parameter is used
so that the <application>GStreamer</application> internal support programs
are installed in the preferred location of <filename
class='directory'>/usr/lib/gstreamer-0.10</filename> instead of <filename
class='directory'>/usr/libexec/gstreamer-0.10</filename>.</para>
<para>
<parameter>--libexecdir=/usr/lib</parameter>: This parameter is used
so that the <application>GStreamer</application> internal support programs
are installed in the preferred location of <filename
class="directory">/usr/lib/gstreamer-0.10</filename> instead of <filename
class="directory">/usr/libexec/gstreamer-0.10</filename>.
</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
href="../../xincludes/static-libraries.xml"/>
<para><option>--disable-static</option>: This switch prevents the static
libraries from being built.</para>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
<para><option>--enable-docbook</option>: This parameter is used to build
HTML, PDF and PostScript versions of the
<application>GStreamer</application> User's Manual, FAQ and Writer's Guide.
Note that you must have all the listed dependencies installed.</para>
<para>
<option>--enable-docbook</option>: This parameter is used to build
HTML, PDF and PostScript versions of the
<application>GStreamer</application> User's Manual, FAQ and Writer's
Guide. Note that you must have all the listed dependencies installed.
</para>
<para><command>chown -v -R root:root ...</command>: The documentation is
installed with ownerships of the user who untarred and built the package.
This command changes the ownerships of the installed documentation files to
root:root and is only executed if the documentation files were built and
installed.</para>
<para>
<command>chown -v -R root:root ...</command>: The documentation is
installed with ownerships of the user who untarred and built the
package. This command changes the ownerships of the installed
documentation files to root:root and is only executed if the
documentation files were built and installed.
</para>
</sect2>
@ -213,18 +232,24 @@ fi</userinput></screen>
<segtitle>Installed Directories</segtitle>
<seglistitem>
<seg>gst-feedback, gst-feedback-0.10, gst-inspect, gst-inspect-0.10,
gst-launch, gst-launch-0.10, gst-plugin-scanner, gst-typefind,
gst-typefind-0.10, gst-xmlinspect, gst-xmlinspect-0.10, gst-xmllaunch,
and gst-xmllaunch-0.10</seg>
<seg>libgstbase-0.10.{so,a}, libgstcheck-0.10.{so,a},
libgstcontroller-0.10.{so,a}, libgstcoreelements.so,
libgstcoreindexers.so, libgstdataprotocol-0.10.{so,a},
libgstnet-0.10.{so,a}, and libgstreamer-0.10.{so,a}</seg>
<seg>/usr/{include/gstreamer-0.10/gst/{base,check,controller,
dataprotocol,net},lib/{gstreamer-0.10,gstreamer/gstreamer-0.10},
share/{gstreamer-0.10/presets,gtk-doc/html/{gstreamer-0.10,
gstreamer-libs-0.10,gstreamer-plugins-0.10}}}</seg>
<seg>
gst-feedback, gst-feedback-0.10, gst-inspect, gst-inspect-0.10,
gst-launch, gst-launch-0.10, gst-typefind, gst-typefind-0.10,
gst-xmlinspect, gst-xmlinspect-0.10, gst-xmllaunch and
gst-xmllaunch-0.10
</seg>
<seg>
libgstbase-0.10.so, libgstcheck-0.10.so, libgstcontroller-0.10.so,
libgstdataprotocol-0.10.so, libgstnet-0.10.so and
libgstreamer-0.10.so
</seg>
<seg>
/usr/include/gstreamer-0.10,
/usr/lib/gstreamer-0.10,
/usr/share/gtk-doc/html/gstreamer-0.10,
/usr/share/gtk-doc/html/gstreamer-libs-0.10 and
/usr/share/gtk-doc/html/gstreamer-plugins-0.10
</seg>
</seglistitem>
</segmentedlist>
@ -236,8 +261,10 @@ fi</userinput></screen>
<varlistentry id="gst-feedback">
<term><command>gst-feedback-0.10</command></term>
<listitem>
<para>generates debug info for <application>GStreamer</application>
bug reports.</para>
<para>
generates debug info for <application>GStreamer</application>
bug reports.
</para>
<indexterm zone="gstreamer gst-feedback">
<primary sortas="b-gst-feedback">gst-feedback-0.10</primary>
</indexterm>
@ -247,8 +274,10 @@ fi</userinput></screen>
<varlistentry id="gst-inspect">
<term><command>gst-inspect-0.10</command></term>
<listitem>
<para>prints information about a
<application>GStreamer</application> plugin or element.</para>
<para>
prints information about a
<application>GStreamer</application> plugin or element.
</para>
<indexterm zone="gstreamer gst-inspect">
<primary sortas="b-gst-inspect">gst-inspect-0.10</primary>
</indexterm>
@ -258,8 +287,10 @@ fi</userinput></screen>
<varlistentry id="gst-launch">
<term><command>gst-launch-0.10</command></term>
<listitem>
<para>is a tool that builds and runs basic
<application>GStreamer</application> pipelines.</para>
<para>
is a tool that builds and runs basic
<application>GStreamer</application> pipelines.
</para>
<indexterm zone="gstreamer gst-launch">
<primary sortas="b-gst-launch">gst-launch-0.10</primary>
</indexterm>
@ -269,10 +300,12 @@ fi</userinput></screen>
<varlistentry id="gst-typefind">
<term><command>gst-typefind-0.10</command></term>
<listitem>
<para>uses the <application>GStreamer</application> type finding
system to determine the relevant <application>GStreamer</application>
plugin to parse or decode a file, and determine the corresponding
MIME type.</para>
<para>
uses the <application>GStreamer</application> type finding system
to determine the relevant <application>GStreamer</application>
plugin to parse or decode a file, and determine the corresponding
MIME type.
</para>
<indexterm zone="gstreamer gst-typefind">
<primary sortas="b-gst-typefind">gst-typefind-0.10</primary>
</indexterm>
@ -282,8 +315,10 @@ fi</userinput></screen>
<varlistentry id="gst-xmlinspect">
<term><command>gst-xmlinspect-0.10</command></term>
<listitem>
<para>prints information about a <application>GStreamer</application>
plugin or element in XML document format.</para>
<para>
prints information about a <application>GStreamer</application>
plugin or element in XML document format.
</para>
<indexterm zone="gstreamer gst-xmlinspect">
<primary sortas="b-gst-xmlinspect">gst-xmlinspect-0.10</primary>
</indexterm>
@ -293,8 +328,10 @@ fi</userinput></screen>
<varlistentry id="gst-xmllaunch">
<term><command>gst-xmllaunch-0.10</command></term>
<listitem>
<para>is used to build and run a basic <application>GStreamer</application>
pipeline, loading it from an XML description.</para>
<para>
is used to build and run a basic <application>GStreamer</application>
pipeline, loading it from an XML description.
</para>
<indexterm zone="gstreamer gst-xmllaunch">
<primary sortas="b-gst-xmllaunch">gst-xmllaunch-0.10</primary>
</indexterm>

View File

@ -30,31 +30,45 @@
<sect2 role="package">
<title>Introduction to libcanberra</title>
<para>The <application>libcanberra</application> is an implementation of the
XDG Sound Theme and Name Specifications, for generating event sounds on free
desktops, such as <application>GNOME</application>.</para>
<para>
<application>libcanberra</application> is an implementation of the XDG Sound
Theme and Name Specifications, for generating event sounds on free desktops,
such as <application>GNOME</application>.
</para>
&lfs70_checked;
<bridgehead renderas="sect3">Package Information</bridgehead>
<itemizedlist spacing="compact">
<listitem>
<para>Download (HTTP): <ulink url="&libcanberra-download-http;"/></para>
<para>
Download (HTTP): <ulink url="&libcanberra-download-http;"/>
</para>
</listitem>
<listitem>
<para>Download (FTP): <ulink url="&libcanberra-download-ftp;"/></para>
<para>
Download (FTP): <ulink url="&libcanberra-download-ftp;"/>
</para>
</listitem>
<listitem>
<para>Download MD5 sum: &libcanberra-md5sum;</para>
<para>
Download MD5 sum: &libcanberra-md5sum;
</para>
</listitem>
<listitem>
<para>Download size: &libcanberra-size;</para>
<para>
Download size: &libcanberra-size;
</para>
</listitem>
<listitem>
<para>Estimated disk space required: &libcanberra-buildsize;</para>
<para>
Estimated disk space required: &libcanberra-buildsize;
</para>
</listitem>
<listitem>
<para>Estimated build time: &libcanberra-time;</para>
<para>
Estimated build time: &libcanberra-time;
</para>
</listitem>
</itemizedlist>
@ -86,23 +100,30 @@
</para>
<para condition="html" role="usernotes">User Notes:
<ulink url="&blfs-wiki;/libcanberra"/></para>
<ulink url="&blfs-wiki;/libcanberra"/>
</para>
</sect2>
<sect2 role="installation">
<title>Installation of libcanberra</title>
<para>Install <application>libcanberra</application> by running the following
commands:</para>
<para>
Install <application>libcanberra</application> by running the following
commands:
</para>
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
<screen><userinput>./configure --prefix=/usr \
--sysconfdir=/etc \
--disable-oss &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>
This package does not come with a test suite.
</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<para>
Now, as the <systemitem class="username">root</systemitem> user:
</para>
<screen role="root"><userinput>make install</userinput></screen>
@ -112,7 +133,7 @@ make</userinput></screen>
<title>Command Explanations</title>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
href="../../xincludes/gtk-doc-rebuild.xml"/>
href="../../xincludes/gtk-doc-rebuild.xml"/>
</sect2>
@ -133,8 +154,9 @@ make</userinput></screen>
libcanberra.so
</seg>
<seg>
/usr/lib/libcanberra-0.28, /usr/share/doc/libcanberra
and /usr/share/gtk-doc/html/libcanberra
/usr/lib/libcanberra-0.28,
/usr/share/doc/libcanberra and
/usr/share/gtk-doc/html/libcanberra
</seg>
</seglistitem>
</segmentedlist>
@ -147,7 +169,9 @@ make</userinput></screen>
<varlistentry id="canberra-gtk-play">
<term><command>canberra-gtk-play</command></term>
<listitem>
<para>is an application for playing sound events.</para>
<para>
is an application used for playing sound events.
</para>
<indexterm zone="libcanberra canberra-gtk-play">
<primary sortas="b-canberra-gtk-play">canberra-gtk-play</primary>
</indexterm>
@ -157,7 +181,10 @@ make</userinput></screen>
<varlistentry id="libcanberra-gtk">
<term><filename class='libraryfile'>libcanberra-gtk.so</filename></term>
<listitem>
<para>contains the libcanberra bindings for GTK+2.</para>
<para>
contains the <application>libcanberra</application> bindings
for <application>GTK+ 2</application>.
</para>
<indexterm zone="libcanberra libcanberra-gtk">
<primary sortas="c-libcanberra-gtk">libcanberra-gtk.so</primary>
</indexterm>
@ -167,7 +194,10 @@ make</userinput></screen>
<varlistentry id="libcanberra-gtk3">
<term><filename class='libraryfile'>libcanberra-gtk3.so</filename></term>
<listitem>
<para>contains the libcanberra bindings for GTK+3.</para>
<para>
contains the <application>libcanberra</application> bindings
for <application>GTK+ 3</application>.
</para>
<indexterm zone="libcanberra libcanberra-gtk3">
<primary sortas="c-libcanberra-gtk3">libcanberra-gtk3.so</primary>
</indexterm>
@ -177,7 +207,9 @@ make</userinput></screen>
<varlistentry id="libcanberra-lib">
<term><filename class='libraryfile'>libcanberra.so</filename></term>
<listitem>
<para>contains the libcanberra API functions.</para>
<para>
contains the <application>libcanberra</application> API functions.
</para>
<indexterm zone="libcanberra libcanberra-lib">
<primary sortas="c-libcanberra">libcanberra.so</primary>
</indexterm>