mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-26 18:20:44 +00:00
bc82d5536c
Original commit message from CVS: * docs/README: Document that for plgin-docs we extraxt he short-desc from the element details. * docs/design/part-states.txt: Tell that devices should be closed in PAUSED -> READY. * docs/manual/README: Document how tests in the manual are handled. * docs/manuals.mak: Typo in comment.
61 lines
1.9 KiB
Text
61 lines
1.9 KiB
Text
Current requirements for building the docs :
|
|
--------------------------------------------
|
|
|
|
libxslt >= 1.0.6
|
|
libxml2 >= 2.4.12
|
|
|
|
|
|
These are not included with RH72. They are in debian. GDE has good rpms.
|
|
|
|
To build pdf's from xslt stuff, you need xmltex and (on redhat)
|
|
passivetex. They are not known to have been built on either redhat or
|
|
debian yet though.
|
|
|
|
Wingo's new comments on the doc building :
|
|
------------------------------------------
|
|
* Well he should add them soon here since he overhauled it. And did a good
|
|
job on it too ;)
|
|
|
|
Thomas's new comments on the doc building :
|
|
-------------------------------------------
|
|
* originally the manual was written with DocBook 3.0 in mind, which
|
|
supported the graphic tag. That is now deprecated, so I changed it to
|
|
the new mediaobject tag set.
|
|
|
|
* eps files in images/ should be generated from the makefile. You need to
|
|
have fig2dev installed for that.
|
|
|
|
Ensonic's comments on the doc build system :
|
|
--------------------------------------------
|
|
In case you like to share files between the manual and the pwg - it's
|
|
not trivial.
|
|
Before anything is done, the build-system copies all xml files into the build
|
|
subdir and this breaks including shared docs via entities.
|
|
|
|
The examples should be updated in the xml. We run a perlscript in
|
|
tests/examples/manual that extracts them.
|
|
|
|
Wtay's original comments :
|
|
--------------------------
|
|
|
|
For now use:
|
|
|
|
db2html gstreamer-manual
|
|
|
|
(On debian, db2html is in the cygnus-stylesheets package)
|
|
|
|
You will need the png support for docbook (see GNOME documentation project)
|
|
|
|
convert the fig images to png with:
|
|
|
|
fig2dev -L png -s 16 fig/<input file>.fig images/<input file>.png
|
|
|
|
Put a link in the gstreamer-manual directory with
|
|
|
|
ln -s ../images gstreamer-manual/images
|
|
|
|
point your browser to gstreamer-manual/gstreamer.html
|
|
|
|
Fix typing errors and correct bad english.
|
|
Let me know about the stuff that needs some more explanation.
|
|
Let me know about the structure of the document.
|