fix validation

Original commit message from CVS:
fix validation
This commit is contained in:
Thomas Vander Stichele 2002-12-12 16:51:45 +00:00
parent 2ced1a341f
commit 41fafb9aec
9 changed files with 70 additions and 60 deletions

2
common

@ -1 +1 @@
Subproject commit 773e3a64961084c37477faa464f12add3dfcd6dc Subproject commit 79e6940e7ff1a6cbf959a1f7a0a3d1ed3f90d3ee

View file

@ -35,3 +35,7 @@ www-faq: gstreamer-faq
perl -i -p -e's@href="index\.html@href="index.php@' $$a; \ perl -i -p -e's@href="index\.html@href="index.php@' $$a; \
perl -i -p -e's@href="(ar.*)\.html@href="$$1.php@' $$a; \ perl -i -p -e's@href="(ar.*)\.html@href="$$1.php@' $$a; \
done done
check:
xmllint -noout -valid $(MAIN)

View file

@ -30,15 +30,16 @@ prefix both aclocal and libtool are installed.
<para> <para>
You can do three things to fix this : You can do three things to fix this :
<orderedlist> <orderedlist>
<listitem>install automake in the same prefix as libtool</listitem> <listitem><para>install automake in the same prefix as libtool</para></listitem>
<listitem>force use of the automake installed in the same prefix as libtool <listitem><para>force use of the automake installed in the same prefix as libtool
by using the --with-automake option</listitem> by using the --with-automake option</para></listitem>
<listitem>figure out what prefix libtool has been installed to and point <listitem><para>figure out what prefix libtool has been installed to and point
aclocal to the right location by running</listitem> aclocal to the right location by running
<programlisting> <programlisting>
export ACLOCAL_FLAGS="-I $(prefix)/share/aclocal" export ACLOCAL_FLAGS="-I $(prefix)/share/aclocal"
</programlisting> </programlisting>
where you replace prefix with the prefix where libtool was installed. where you replace prefix with the prefix where libtool was installed.
</para></listitem>
</orderedlist> </orderedlist>
</para> </para>
</answer> </answer>

View file

@ -1,7 +1,7 @@
<sect1 id="chapter-developing"> <sect1 id="chapter-developing">
<title id="title-developing">Developing applications with GStreamer</title> <title id="title-developing">Developing applications with GStreamer</title>
<qandaset defaultlabel="qandaset-developing"> <qandaset>
<qandaentry> <qandaentry>
<question id="developing-compile-programs"> <question id="developing-compile-programs">

View file

@ -30,17 +30,17 @@ Why is GStreamer written in C ? Why not C++/Objective-C/... ?
We like C. Aside from "personal preference", there are a number of technical We like C. Aside from "personal preference", there are a number of technical
reasons why C is nice in this project: reasons why C is nice in this project:
<itemizedlist> <itemizedlist>
<listitem>C is extremely portable.</listitem> <listitem><para>C is extremely portable.</para></listitem>
<listitem>C is fast.</listitem> <listitem><para>C is fast.</para></listitem>
<listitem>It is easy to make language bindings for libraries written in C. <listitem><para>It is easy to make language bindings for libraries written in C.
</listitem> </para></listitem>
<listitem>The GObject object system provided by GLib implements objects in C, <listitem><para>The GObject object system provided by GLib implements objects in C,
in a portable, powerful way. This library provides for introspection and in a portable, powerful way. This library provides for introspection and
runtime dynamic typing. It is a full OO system, but without the syntactic runtime dynamic typing. It is a full OO system, but without the syntactic
sugar. If you want sugar, take a look at sugar. If you want sugar, take a look at
<ulink url="http://www.5z.com/jirka/gob.html">GOB</ulink>.</listitem> <ulink url="http://www.5z.com/jirka/gob.html">GOB</ulink>.</para></listitem>
<listitem>Use of C integrates nicely with Gtk+ and GNOME. Some people like <listitem><para>Use of C integrates nicely with Gtk+ and GNOME. Some people like
this a lot, but neither Gtk+ nor GNOME are required by GStreamer.</listitem> this a lot, but neither Gtk+ nor GNOME are required by GStreamer.</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
<para> <para>
@ -88,10 +88,10 @@ terms of the libraries we use. As a general rule, GStreamer aims at using
only LGPL or BSD licensed libraries if available and only use GPL or only LGPL or BSD licensed libraries if available and only use GPL or
proprietary libraries where no good LGPL or BSD alternatives are available. proprietary libraries where no good LGPL or BSD alternatives are available.
</para> </para>
<para>
From GStreamer 0.4.2 on, we implemented a license field for all of the plugins, From GStreamer 0.4.2 on, we implemented a license field for all of the plugins,
and in the future we might have the application enforce a stricter policy and in the future we might have the application enforce a stricter policy
(much like tainting in the kernel). (much like tainting in the kernel).
<para>
</para> </para>
</answer> </answer>
</qandaentry> </qandaentry>

View file

@ -11,12 +11,12 @@
<para> <para>
Generally speaking, you have three options, ranging from easy to hard : Generally speaking, you have three options, ranging from easy to hard :
<itemizedlist> <itemizedlist>
<item><link linkend="getting-gstreamer-packages"> <listitem><para><link linkend="getting-gstreamer-packages">
distribution-specific packages</link></item> distribution-specific packages</link></para></listitem>
<item><link linkend="getting-gstreamer-source"> <listitem><para><link linkend="getting-gstreamer-source">
source tarballs</link></item> source tarballs</link></para></listitem>
<item><link linkend="getting-gstreamer-packages"> <listitem><para><link linkend="getting-gstreamer-packages">
CVS</link></item> CVS</link></para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
</answer> </answer>

View file

@ -3,18 +3,25 @@
<para> <para>
So you're eager to get started learning about GStreamer. So you're eager to get started learning about GStreamer.
There's a few ways you can get started. There's a few ways you can get started.
<itemizedlist> <itemizedlist>
<listitem>If you want to learn by reading about it, start with <listitem>
<xref linkend="title-general" endterm="title-general"/></listitem> <para>
<listitem> If you want to learn by reading about it, start with
<xref linkend="title-general" endterm="title-general"/>
</para>
</listitem>
<listitem>
<para>
If you'd rather learn by trying it out, start with If you'd rather learn by trying it out, start with
<xref linkend="title-getting" endterm="title-getting"/> <xref linkend="title-getting" endterm="title-getting"/>
</listitem> </para>
<listitem> </listitem>
<listitem>
<para>
If you want to live on the bleeding edge and develop and use CVS, see If you want to live on the bleeding edge and develop and use CVS, see
<xref linkend="title-cvs" endterm="title-cvs"/> <xref linkend="title-cvs" endterm="title-cvs"/>
</listitem> </para>
</itemizedlist> </listitem>
</itemizedlist>
</para> </para>
</sect1> </sect1>

View file

@ -24,11 +24,11 @@ If you're not sure either way, then chances are good that you don't have
it. You should get the plug-in and run gst-register to register it. it. You should get the plug-in and run gst-register to register it.
How to get the plug-in depends on your distribution. How to get the plug-in depends on your distribution.
<itemizedlist> <itemizedlist>
<listitem>if you run GStreamer using packages for your distribution, you <listitem><para>if you run GStreamer using packages for your distribution, you
should check what packages are available for your distribution and see should check what packages are available for your distribution and see
if any of the available packages contains the plug-in. if any of the available packages contains the plug-in.
</listitem> </para></listitem>
<listitem>if you run GStreamer from a source install, there's a good chance <listitem><para>if you run GStreamer from a source install, there's a good chance
the plug-in didn't get built because you are missing an external library. the plug-in didn't get built because you are missing an external library.
When you ran configure, you should have gotten output of what plug-ins are When you ran configure, you should have gotten output of what plug-ins are
going to be built. You can re-run configure to see if it's there. going to be built. You can re-run configure to see if it's there.
@ -37,13 +37,13 @@ The most likely is that you're missing the library you need for it.
Check the README file in gst-plugins to see what library you need. Check the README file in gst-plugins to see what library you need.
Make sure to remember to re-run configure after installing the supporting Make sure to remember to re-run configure after installing the supporting
library ! library !
</listitem> </para></listitem>
<listitem> <listitem><para>
if you run GStreamer from CVS, the same logic applies as for a source install. if you run GStreamer from CVS, the same logic applies as for a source install.
Go over the reasons why the plug-in didn't get configured for build. Go over the reasons why the plug-in didn't get configured for build.
Check output of config.log for a clue as to why it doesn't get built if Check output of config.log for a clue as to why it doesn't get built if
you're sure you have the library needed installed in a sane place. you're sure you have the library needed installed in a sane place.
</listitem> </para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
@ -87,31 +87,31 @@ The second thing you can do is look at the backtrace to get an idea of where
things are going wrong, or give us an idea of what is going wrong. things are going wrong, or give us an idea of what is going wrong.
To provide a backtrace, you should To provide a backtrace, you should
<orderedlist> <orderedlist>
<listitem> <listitem><para>
run the application in gdb by starting it with run the application in gdb by starting it with
<programlisting> <programlisting>
gdb (gst-application) gdb (gst-application)
</programlisting> </programlisting>
(If the application is in a source tree instead of installed on the system, (If the application is in a source tree instead of installed on the system,
you might want to put "libtool" before "gdb") you might want to put "libtool" before "gdb")
</listitem> </para></listitem>
<listitem> <listitem><para>
Pass on the command line arguments to the application by typing Pass on the command line arguments to the application by typing
<programlisting> <programlisting>
set args (the arguments to the application) set args (the arguments to the application)
</programlisting> </programlisting>
at the (gdb) prompt at the (gdb) prompt
</listitem> </para></listitem>
<listitem> <listitem><para>
Type "run" at the (gdb) prompt and wait for the application to Type "run" at the (gdb) prompt and wait for the application to
segfault. The application will run a lot slower, however. segfault. The application will run a lot slower, however.
</listitem> </para></listitem>
<listitem> <listitem><para>
After the segfault, type "bt" to get a backtrace. This is a stack of After the segfault, type "bt" to get a backtrace. This is a stack of
function calls detailing the path from main () to where the code is function calls detailing the path from main () to where the code is
currently at. currently at.
</listitem> </para></listitem>
<listitem> <listitem><para>
If the application you're trying to debug contains threads, it is also If the application you're trying to debug contains threads, it is also
useful to do useful to do
<programlisting> <programlisting>
@ -120,14 +120,12 @@ To provide a backtrace, you should
and get backtraces of all of the threads involved, by switching to and get backtraces of all of the threads involved, by switching to
a different thread using "thread (number)" and then again requesting a different thread using "thread (number)" and then again requesting
a backtrace using "bt". a backtrace using "bt".
</listitem> </para></listitem>
<listitem> <listitem><para>
<para>
If you can't or don't want to work out the problem yourself, a copy and paste If you can't or don't want to work out the problem yourself, a copy and paste
of all this information should be included in your of all this information should be included in your
<link linkend="using-bugs-where">bug report</link>. <link linkend="using-bugs-where">bug report</link>.
</para> </para></listitem>
</listitem>
</orderedlist> </orderedlist>
</para> </para>
</answer> </answer>

View file

@ -56,11 +56,11 @@ You can test this by trying to play a sine tone. For this, you need to
connect the sinesrc plug-in to an output plug-in that matches your hardware. connect the sinesrc plug-in to an output plug-in that matches your hardware.
A (non-complete) list of output plug-ins for audio is A (non-complete) list of output plug-ins for audio is
<itemizedlist> <itemizedlist>
<listitem>osssink for OSS output</listitem> <listitem><para>osssink for OSS output</para></listitem>
<listitem>esdsink for ESound output</listitem> <listitem><para>esdsink for ESound output</para></listitem>
<listitem>artssink for aRTs output</listitem> <listitem><para>artssink for aRTs output</para></listitem>
<listitem>alsasink for ALSA output</listitem> <listitem><para>alsasink for ALSA output</para></listitem>
<listitem>jacksink for JACK output</listitem> <listitem><para>jacksink for JACK output</para></listitem>
</itemizedlist> </itemizedlist>
First of all, run gst-inspect on the output plug-in you want to use to First of all, run gst-inspect on the output plug-in you want to use to
make sure you have it installed. For example, if you use OSS, run make sure you have it installed. For example, if you use OSS, run
@ -136,10 +136,10 @@ information, as we will most likely have to.
<para> <para>
When doing a bug report, you should at least describe When doing a bug report, you should at least describe
<itemizedlist> <itemizedlist>
<listitem>your distribution</listitem> <listitem><para>your distribution</para></listitem>
<listitem> <listitem><para>
how you installed GStreamer (from cvs, source, packages, which ?)</listitem> how you installed GStreamer (from cvs, source, packages, which ?)</para></listitem>
<listitem>if you installed GStreamer before</listitem> <listitem><para>if you installed GStreamer before</para></listitem>
</itemizedlist> </itemizedlist>
</para> </para>
<para> <para>