gstreamer/docs/manual
Luc Pionchon bbe50ec6c1 docs/manual/: Add one more image showing different times together with a describing paragraph. Fixes #547729.
Original commit message from CVS:
patch by: Luc Pionchon <luc.pionchon@nokia.com>
* docs/manual/advanced-clocks.xml:
* docs/manual/clocks.png:
* docs/manual/diagrams-clocks.svg:
Add one more image showing different times together with a describing
paragraph. Fixes #547729.
2008-08-14 14:26:20 +00:00
..
images Fix .cvsignores 2000-12-31 14:02:32 +00:00
.gitignore images are important to us 2003-10-08 14:53:18 +00:00
advanced-autoplugging.xml docs/manual/advanced-autoplugging.xml: Add fakesink to example code to close the pipeline graph. This prevents the p... 2008-07-24 12:36:20 +00:00
advanced-clocks.xml docs/manual/: Add one more image showing different times together with a describing paragraph. Fixes #547729. 2008-08-14 14:26:20 +00:00
advanced-dataaccess.xml docs/manual/advanced-dataaccess.xml: Don't imply that it's okay to unconditionally change buffer data or buffer metad... 2007-10-09 10:41:41 +00:00
advanced-dparams.xml docs/manual/advanced-dparams.xml: Fix typo (g_object_control_properties() doesn't exist). 2006-12-19 15:06:42 +00:00
advanced-interfaces.xml docs/manual/advanced-interfaces.xml: Turn thoughts about HAL into a note-tag. Remove mentioning that is only used to ... 2008-08-11 07:07:45 +00:00
advanced-metadata.xml docs/manual/: Update (until threads/scheduling) Application Development Manual; remove GstThread, add GstBus, add sim... 2005-06-29 09:25:51 +00:00
advanced-position.xml docs/manual/advanced-position.xml: Fix typo in sample code. 2006-09-05 14:11:06 +00:00
advanced-threads.xml docs/manual/: Replace one diagram with two separate ones and updates others. 2008-07-26 12:00:36 +00:00
appendix-checklist.xml docs/manual/manual.xml: - Reorganised the previous "introduction" bundle into Foreword, 2008-06-25 14:44:52 +00:00
appendix-integration.xml docs/manual/manual.xml: - Reorganised the previous "introduction" bundle into Foreword, 2008-06-25 14:44:52 +00:00
appendix-licensing.xml docs/manual/: Typo and formatting fixes (#538594). 2008-06-24 19:56:51 +00:00
appendix-porting.xml docs/manual/: Update for 0.10: s/0.9/0.10/; s/audioscale/audiorsample/; add converters in front of pipelines; remove ... 2005-12-11 17:49:10 +00:00
appendix-programs.xml docs/manual/: Update for 0.10: s/0.9/0.10/; s/audioscale/audiorsample/; add converters in front of pipelines; remove ... 2005-12-11 17:49:10 +00:00
appendix-quotes.xml add quote 2007-05-22 10:21:31 +00:00
base.css Small updates to the manual 2002-03-31 15:28:51 +00:00
basics-bins.xml docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
basics-bus.xml docs/manual/basics-bus.xml: Correct typo. Fixes bug #544320. 2008-07-23 15:44:04 +00:00
basics-data.xml docs/manual/: Try 2. This time, include a short preface as a "general introduction", also add code blocks around all ... 2004-12-15 17:32:49 +00:00
basics-elements.xml docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
basics-helloworld.xml docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
basics-init.xml docs/manual/: Call g_thread_init() before g_option_context_new() to avoid warnings. Spotted by Ritesh Khadgaray. Fixe... 2007-10-08 17:26:09 +00:00
basics-pads.xml docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
basics-plugins.xml added docs for the TAG defines 2005-01-18 14:15:30 +00:00
bin-element-ghost.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
bin-element-noghost.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
bin-element.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
clocks.png docs/manual/: Add one more image showing different times together with a describing paragraph. Fixes #547729. 2008-08-14 14:26:20 +00:00
diagrams-clocks.svg docs/manual/: Add one more image showing different times together with a describing paragraph. Fixes #547729. 2008-08-14 14:26:20 +00:00
diagrams-general.svg docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
diagrams-pipelines.svg docs/manual/: Replace one diagram with two separate ones and updates others. 2008-07-26 12:00:36 +00:00
filter-element-multi.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
filter-element.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
gstreamer-overview.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
hello-world.png docs/manual/: Replace one diagram with two separate ones and updates others. 2008-07-26 12:00:36 +00:00
highlevel-components.xml docs/manual/manual.xml: - Reorganised the previous "introduction" bundle into Foreword, 2008-06-25 14:44:52 +00:00
highlevel-xml.xml docs/manual/: Typo and formatting fixes (#538594). 2008-06-24 19:56:51 +00:00
intro-basics.xml docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
intro-gstreamer.xml docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
intro-motivation.xml docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
intro-preface.xml docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
linked-elements.png docs/manual/: Replace one diagram with two separate ones and updates others. 2008-07-26 12:00:36 +00:00
Makefile.am docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
manual.xml docs/manual/manual.xml: - Reorganised the previous "introduction" bundle into Foreword, 2008-06-25 14:44:52 +00:00
mime-world.png docs/manual/: Replace one diagram with two separate ones and updates others. 2008-07-26 12:00:36 +00:00
outline.txt + changed connection/connect/conn/disconnect/connected/... to link/link/link/unlink/linked/... and moved connectish f... 2003-01-24 18:08:39 +00:00
README docs/README: Document that for plgin-docs we extraxt he short-desc from the element details. 2008-06-25 14:25:49 +00:00
simple-player.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
sink-element.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
src-element.png docs/manual/: Add scale factor for pdf output. 2008-06-27 07:03:05 +00:00
state-diagram.fig Misc tweaks to makefile for manual. Moved .figs into same directory so we can have them built appropriately without ... 2000-12-30 04:36:40 +00:00
thread-buffering.png docs/manual/: Replace one diagram with two separate ones and updates others. 2008-07-26 12:00:36 +00:00
thread-synchronizing.png docs/manual/: Replace one diagram with two separate ones and updates others. 2008-07-26 12:00:36 +00:00
titlepage.xml docs/manual/advanced-dparams.xml: describe controller 2006-01-30 21:11:38 +00:00

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.