notes updates
[platform/upstream/gstreamer.git] / docs / manual / README
1 Current requirements for building the docs :
2 --------------------------------------------
3
4 libxslt >= 1.0.6
5 libxml2 >= 2.4.12
6
7 These are not included with RH72.  They are in debian.  GDE has good rpms.
8
9 Wingo's new comments on the doc building :
10 ------------------------------------------
11 * Well he should add them soon here since he overhauled it. And did a good 
12   job on it too ;)
13
14 Thomas's new comments on the doc building :
15 -------------------------------------------
16 * originally the manual was written with DocBook 3.0 in mind, which 
17   supported the graphic tag.  That is now deprecated, so I changed it to 
18   the new mediaobject tag set.
19
20 * eps files in images/ should be generated from the makefile.  You need to 
21   have fig2dev installed for that.
22
23
24 Wtay's original comments :
25 --------------------------
26
27 For now use:
28
29   db2html gstreamer-manual 
30
31 (On debian, db2html is in the cygnus-stylesheets package)
32
33 You will need the png support for docbook (see GNOME documentation project)
34
35 convert the fig images to png with:
36
37   fig2dev -L png -s 16 fig/<input file>.fig images/<input file>.png
38
39 Put a link in the gstreamer-manual directory with
40
41   ln -s ../images gstreamer-manual/images
42
43 point your browser to gstreamer-manual/gstreamer.html
44
45 Fix typing errors and correct bad english.
46 Let me know about the stuff that needs some more explanation.
47 Let me know about the structure of the document.