Remove developer documentation, almost untouched in over 7 years

doc/developer/.gitignore

-!Makefile
-!Makefile.in

doc/developer/Makefile

-# Makefile for VideoLAN Doc
-#  Clément Stenac
-#  Anil Daoud
-
-XSLTPROC=xsltproc
-LYNX=lynx
-JADE=jade
-
-XML_DECL := /usr/share/sgml/declaration/xml.decl
-XSL_CHUNK = videolan-doc-chunk.xsl
-XSL = videolan-doc.xsl
-XSL_TXT = /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/xhtml/html.xsl
-
-all: manual
-
-manual: manual.html all-html manual.pdf manual.txt
-
-# HTML
-all-html: *.xml
-	xsltproc $(XSL_CHUNK) manual.xml
-	mv *.html html
-
-manual.html: *.xml
-	xsltproc $(XSL) manual.xml > manual.html
-
-# PDF
-manual.pdf: *.xml
-	jade -t tex -d stylesheet-print-noicones.dsl -o manual.tex $(XML_DECL) manual.xml
-	pdfjadetex manual.tex
-	pdfjadetex manual.tex
-	pdfjadetex manual.tex
-	rm -f *.tex *.out *.aux *.log
-	
-# TXT
-manual.txt:  *.xml
-	xsltproc $(XSL_TXT) manual.xml > manual.txt
-
-clean:
-	rm -f manual.txt manual.pdf
-	rm -f *.html *.aux *.log *.tex *.out
-	rm -f html/*.html

doc/developer/Makefile.in

-# Extract from the Debian SGML/XML HOWTO by Stéphane Bortzmeyer
-
-MAX_TEX_RECURSION=4
-
-# For Debian :
-#XML_DECL=/usr/lib/sgml/declaration/xml.decl
-#HTML_SS=/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl
-#PRINT_SS=/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl
-
-# For RedHat :
-# XML_DECL=/usr/share/sgml/docbook/dsssl-stylesheets-1.76/dtds/decls/xml.dcl
-# HTML_SS=/usr/share/sgml/docbook/dsssl-stylesheets-1.76/html/docbook.dsl
-# PRINT_SS=/usr/share/sgml/docbook/dsssl-stylesheets-1.76/print/docbook.dsl
-
-# For Mac OS X :
-#XML_DECL=/sw/share/sgml/dsssl/docbook-dsssl-nwalsh/dtds/decls/xml.dcl
-#HTML_SS=/sw/share/sgml/dsssl/docbook-dsssl-nwalsh/html/docbook.dsl
-#PRINT_SS=/sw/share/sgml/dsssl/docbook-dsssl-nwalsh/print/docbook.dsl
-#JADE=openjade
-
-JADE=@JADE@
-LYNX=@LYNX@
-DVIPS=@DVIPS@
-JADETEX=@JADETEX@
-
-XML_DECL=@XML_DECL@
-HTML_SS=@HTML_SS@
-PRINT_SS=@PRINT_SS@
-
-DOCS=@DOCS@
-
-all: manual
-
-
-manual: manual.txt manual.ps manual.html
-
-manual.tex: audio_output.xml debugging.xml decoders.xml gfdl.xml glossary.xml history.xml input.xml interface.xml manual.xml overview.xml ports.xml video_output.xml
-	$(JADE) -t tex -V %section-autolabel% -d $(PRINT_SS) $(XML_DECL) manual.xml
-	perl -i.bak -pe 's/\000//g' $@ && rm $*.tex.bak
-# No it's not a joke
-
-manual.html: audio_output.xml debugging.xml decoders.xml gfdl.xml glossary.xml history.xml input.xml interface.xml manual.xml overview.xml ports.xml video_output.xml
-	$(JADE) -t sgml -V %section-autolabel% -V nochunks \
-         -d $(HTML_SS) $(XML_DECL) manual.xml > $@
-
-manual.dvi: manual.tex modules.eps ps.eps stream.eps ts.eps
-	$(JADETEX) manual.tex
-	$(JADETEX) manual.tex
-	$(JADETEX) manual.tex
-
-manual.ps: manual.dvi
-	$(DVIPS) -f $< > $@
-
-manual.txt: audio_output.xml debugging.xml decoders.xml gfdl.xml glossary.xml history.xml input.xml interface.xml manual.xml overview.xml ports.xml video_output.xml
-	$(JADE) -t sgml -V nochunks -d $(HTML_SS) $(XML_DECL) manual.xml > dump.html
-	$(LYNX) -force_html -dump dump.html > $@
-	-rm -f dump.html
-
-clean:
-	rm -f manual.txt
-	rm -f *.html *.aux *.log *.dvi *.ps *.tex
-	rm -f *.bck *~ .\#* \#*
-

doc/developer/configure.ac

-dnl $Id$
-dnl Process this file with autoconf to produce a configure script.
-
-AC_INIT(manual.xml.in,0.0.1)
-
-AC_CHECK_PROGS(JADE, openjade jade, [nogood])
-
-if test "$JADE" = nogood ; then
-  AC_MSG_ERROR(You need jade to build the documentation. 
-  Get it from http://openjade.sourceforge.net/)
-else
-  DOCS="manual.html"
-fi
-
-AC_PATH_PROG(LYNX, lynx, [nope])
-
-if test "$LYNX" = nope ; then
-  AC_MSG_WARN(Can not create text version of manual)
-else 
-  DOCS="$DOCS manual.txt"
-fi
-
-AC_PATH_PROG(DVIPS, dvips, [nodvips])
-AC_PATH_PROG(JADETEX, jadetex, [nojadetex])
-
-if test "$DVIPS" = nodvips -o "$JADETEX" = nojadetex ; then
-  AC_MSG_WARN(Can not create PostScript version of manual)
-else 
-  DOCS="$DOCS manual.ps"
-fi
-
-AC_CANONICAL_SYSTEM
-dnl ========================================================================
-case "$host_os" in
-  linux* ) 
-    if test -f /etc/redhat-release ; then
-      XML_DECL=/usr/share/sgml/docbook/dsssl-stylesheets-1.76/dtds/decls/xml.dcl
-      HTML_SS=/usr/share/sgml/docbook/dsssl-stylesheets-1.76/html/docbook.dsl
-      PRINT_SS=/usr/share/sgml/docbook/dsssl-stylesheets-1.76/print/docbook.dsl
-      DOCBOOKX_DTD=/usr/share/sgml/docbook/xml-dtd-4.1.2/docbookx.dtd
-    else 
-      # Assume Debian
-      XML_DECL=/usr/lib/sgml/declaration/xml.decl
-      HTML_SS=/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/html/docbook.dsl
-      PRINT_SS=/usr/lib/sgml/stylesheet/dsssl/docbook/nwalsh/print/docbook.dsl
-      DOCBOOKX_DTS=/usr/share/sgml/docbook/dtd/xml/4.1/docbookx.dtd
-    fi
-    ;;	
-  darwin5* | darwin6* )
-    XML_DECL=/sw/share/sgml/dsssl/docbook-dsssl-nwalsh/dtds/decls/xml.dcl
-    HTML_SS=/sw/share/sgml/dsssl/docbook-dsssl-nwalsh/html/docbook.dsl
-    PRINT_SS=/sw/share/sgml/dsssl/docbook-dsssl-nwalsh/print/docbook.dsl
-    DOCBOOKX_DTD=/sw/share/xml/dtd/docbookx/4.1.2/docbookx.dtd
-    ;;	
-  * ) 
-    echo "Don't know $host_os. Picking up from environment."
-    XML_DECL=$XML_DECL
-    HTML_SS=$HTML_SS
-    PRINT_SS=$PRINT_SS
-esac
-
-AC_ARG_WITH(xml_decl,
-[  --with-xml-dcl=PATH    place to find xml.dcl file])
-if test -n "${xml_decl}"; then
-   XML_DECL=$xml_decl
-fi
-
-if test ! -f $XML_DECL ; then
-  AC_MSG_ERROR(Can't find xml.dcl file. Set with --with-xml-dcl.)
-fi
-
-
-AC_ARG_WITH(html_ss,
-[  --with-html-ss=PATH    place to find html/docbook.dsl file])
-if test -n "${html_ss}"; then
-   HTML_SS=$html_ss
-fi
-
-if test ! -f $HTML_SS ; then
-  AC_MSG_ERROR(Can't find html/docbook.dsl file. Set with --with-html-ss.)
-fi
-
-AC_ARG_WITH(print_ss,
-[  --with-print-ss=PATH    place to find print/docbook.dsl file])
-if test -n "${print_ss}"; then
-   PRINT_SS=$print_ss
-fi
-
-if test ! -f $PRINT_SS ; then
-  AC_MSG_ERROR(Can't find print/docbook.dsl file. Set with --with-print-ss.)
-fi
-
-AC_ARG_WITH(docbook_dtd,
-[  --with-dockbook-dtd=PATH    place to find docbookx.dtd file])
-if test -n "${docbook_dtd}"; then
-   DOCBOOKX_DTD=$docbook_dtd
-fi
-
-if test ! -f $DOCBOOKX_DTD ; then
-  AC_MSG_ERROR(Can't find docbook.dsl file. Set with --with-docbook_dtd.)
-fi
-
-AC_SUBST(XML_DECL)
-AC_SUBST(HTML_SS)
-AC_SUBST(PRINT_SS)
-AC_SUBST(DOCBOOKX_DTD)
-AC_SUBST(JADE)
-AC_SUBST(LYNX)
-AC_SUBST(DOCS)
-
-AC_CONFIG_FILES([manual.xml Makefile])
-AC_OUTPUT

doc/developer/debugging.xml

-<appendix> <title> Advanced debugging </title>
-
-  <para>
-We never debug our code, because we don't put bugs in. Okay, you want
-some real stuff. Sam still uses <function> printf() </function> to
-find out where it crashes. For real programmers, here is a summary
-of what you can do if you have problems.
-  </para>
-
-  <sect1> <title> Where does it crash ? </title>
-
-    <para>
-The best way to know that is to use gdb. You can start using it with
-good chances by configuring with <parameter> --enable-debug </parameter>.
-It will add <parameter> -g </parameter> to the compiler <parameter>
-CFLAGS</parameter>, and activate some additional safety checks. Just
-run <command> gdb vlc</command>, type <command> run myfile.vob</command>,
-and wait until it crashes. You can view where it stopped with
-<command>bt</command>, and print variables with <command>print
-&lt;C-style&gt;</command>.
-    </para>
-
-    <para>
-If you run into troubles, you may want to turn the optimizations off.
-Optimizations (especially inline functions) may confuse the debugger.
-Use <parameter> --disable-optimizations </parameter> in that case.
-    </para>
-
-  </sect1>
-
-  <sect1> <title> Other problems </title>
-
-    <para>
-It may be more complicated than that, for instance unpredictable
-behaviour, random bug or performance issue. You have several options
-to deal with this. If you experience unpredictable behaviour, I hope
-you don't have a heap or stack corruption (eg. writing in an unallocated
-space), because they are hard to find. If you are really desperate, have
-a look at something like ElectricFence or dmalloc. Under GNU/Linux, an
-easy check is to type <command> export MALLOC_CHECK_=2 </command> before
-launching vlc (see <command> malloc(3) </command> for more information).
-    </para>
-
-    <para>
-VLC offers a "trace-mode". It can create a log file with very accurate dates
-and messages of what it does, so it is useful to detect performance
-issues or lock-ups. Compile with <parameter> --enable-trace </parameter>
-and tune the <parameter> TRACE_* </parameter> flags in <filename>
-include/config.h </filename> to enable certain types of messages (log
-file writing can take up a lot of time, and will have side effects).
-    </para>
-
-  </sect1>
-
-</appendix>

doc/developer/glossary.xml

-    <glossary>
-
-      <warning> <para>
-        Please note that this book is in no way a reference documentation
-        on how DVDs work. Its only purpose is to describe the API
-        available for programmers in VLC media player. It is assumed that
-        you have basic knowledge of what MPEG is. The following paragraph
-        is just here as a reminder :
-      </para> </warning>
-
-      <glossentry>
-        <glossterm> <acronym> AC3 </acronym> :
-        Digital Audio Compression Standard </glossterm>
-        <glossdef> <para> Specification for coding audio data, used in DVD.
-        The documentation is
-        <ulink url="http://www.linuxvideo.org/devel/library/ac3-standard_a_52.pdf">
-        freely available </ulink>.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> B </acronym> (bi-directional) picture </glossterm>
-        <glossdef> <para> Picture decoded from its own data, <emphasis>
-        and </emphasis> from the data of the previous and next (that
-        means <emphasis>in the future</emphasis>) reference
-        pictures (I or P pictures). It is the most compressed picture
-        format, but it is less fault-tolerant.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> DVD </acronym> :
-        Digital Versatile Disc </glossterm>
-        <glossdef> <para> Disc hardware format, using the UDF file system,
-        an extension of the ISO 9660 file system format and a video format
-        which is an extension of the MPEG-2 specification.
-        It basically uses MPEG-2 PS files, with subtitles and sound
-        tracks encoded as private data and fed into non-MPEG decoders, 
-        along with .ifo files describing the contents of the DVD. DVD
-        specifications are very hard to get, and it takes some
-        time to reverse-engineer it. Sometimes DVD are zoned and
-        scrambled, so we use a brute-force algorithm to find the key.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> ES </acronym> : Elementary Stream </glossterm>
-        <glossdef> <para> Continuous stream of data fed into a decoder,
-        without any multiplexing layer. ES streams can be MPEG video
-        MPEG audio, AC3 audio, LPCM audio, SPU subpictures...
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> Field picture </glossterm>
-        <glossdef> <para> Picture split in two fields, even and odd, like
-        television does. DVDs coming from TV shows typically use field
-        pictures.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> Frame picture </glossterm>
-        <glossdef> <para> Picture without even/odd discontinuities, unlike
-        field pictures. DVDs coming from movies typically use frame
-        pictures.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym>I</acronym> (intra) picture </glossterm>
-        <glossdef> <para> Picture independantly coded. It can be
-        decoded without any other reference frame. It is regularly
-        sent (like twice a second) for resynchronization purposes.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> IDCT </acronym> : Inverse Discrete
-        Cosinus Transform </glossterm>
-        <glossdef> <para> IDCT is a classical mathematical algorithm
-        to convert from a space domain to a frequency domain. In a
-        nutshell, it codes differences instead of coding all absolute
-        pixels. MPEG uses an 2-D IDCT in the video decoder, and a 1-D
-        IDCT in the audio decoder.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> LPCM </acronym> :
-        Linear Pulse Code Modulation </glossterm>
-        <glossdef> <para> LPCM is a non-compressed audio encoding,
-        available in DVDs.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> MPEG </acronym> :
-        Motion Picture Expert Group </glossterm>
-        <glossdef> <para> Specification describing a standard syntax of files
-        and streams for carrying motion pictures and sound. MPEG-1 is
-        ISO/IEC 11172 (three books), MPEG-2 is ISO/IEC 13818. MPEG-4
-        version 1 is out, but this player doesn't support it. It is
-        relatively easy to get an MPEG specification from ISO or
-        equivalent, drafts are even freely available on the Internet.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> P </acronym> (predictive) picture </glossterm>
-        <glossdef> <para> Picture decoded from its own data <emphasis>
-        and </emphasis> data from a reference picture, which is the
-        last I or P picture received.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> PES </acronym> :
-        Packetized Elementary Stream </glossterm>
-        <glossdef> <para> A chunk of elementary stream. It often corresponds
-        to a logical boundary of the stream (for instance a picture
-        change), but it is not mandatory. PES carry the synchronization
-        information.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> PTS </acronym> :
-        Presentation Time Stamp </glossterm>
-        <glossdef> <para> Time at which the content of a PES packet is supposed
-        to be played. It is used for A/V synchronization.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> PS </acronym> : Program Stream </glossterm>
-        <glossdef> <para> File format obtained by concatenating PES packets
-        and inserting Pack headers and System headers (for timing
-        information). It is the only format described in MPEG-1, and
-        the most used format in MPEG-2.
-        </para></glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> RGB </acronym> : Red Green Blue </glossterm>
-        <glossdef> <para> Picture format where every pixel is calculated in a
-        vector space whose coordinates are red, green, and blue. This
-        is natively used by monitors and TV sets.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> SPU </acronym> : Sub Picture Unit </glossterm>
-        <glossdef> <para> Picture format allowing to do overlays, such
-        as subtitles or DVD menus.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> SCR </acronym> :
-        System Clock Reference </glossterm>
-        <glossdef> <para> Time at which the first byte of a particular pack
-        is supposed to be fed to the decoder. VLC uses it to read the
-        stream at the right pace.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> SDL </acronym> :
-        Simple DirectMedia Layer </glossterm>
-        <glossdef> <para> <ulink url="http://www.libsdl.org/"> SDL </ulink>
-        is a cross-platform multimedia library
-        designed to provide fast access to the video framebuffer and
-        the audio device. Since version 1.1, it features YUV overlay
-        support, which reduces decoding times by a third.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> TS </acronym> : Transport Stream </glossterm>
-        <glossdef> <para> Stream format constituted of fixed size packets
-        (188 bytes), defined by ISO/IEC 13818-1. PES packets are
-        split among several TS packets.
-        A TS stream can contain several programs. It is used in
-        streaming applications, in particular for satellite or cable
-        broadcasting.
-        </para> </glossdef>
-      </glossentry>
-
-      <glossentry>
-        <glossterm> <acronym> YUV </acronym> :
-        Luminance/Chrominance </glossterm>
-        <glossdef> <para> Picture format with 1 coordinate of luminance (black
-        and white) and 2 coordinates of chrominance (red and blue).
-        This is natively used by PAL video system, for backward
-        compatibility with older black and white TV sets. Your eyes
-        distinguish luminance variations much better than chrominance
-        variations, so you can compress them more. It is therefore
-        well suited for image compression, and is used by the MPEG
-        specification. The RGB picture can be obtained from the YUV one
-        via a costly matrix multiply operation, which can be done in
-        hardware by most modern video cards ("YUV acceleration").
-        </para> </glossdef>
-      </glossentry>
-    </glossary>

doc/developer/history.xml

-<?xml version="1.0" encoding="UTF-8" ?>
-<appendix> <title> Project history </title>
-
-  <sect1> <title> VIA and the Network2000 project </title>
-
-    <para>
-The whole project started back in 1995. At that time, students of the
-<ulink url="http://www.ecp.fr/"> &Eacute;cole Centrale de Paris </ulink>
-enjoyed a TokenRing network, managed by the <ulink
-url="http://www.via.ecp.fr/"> VIA Centrale R&eacute;seaux
-association</ulink>, and were looking
-for a solution to upgrade to a modern network. So the idea behind
-Network2000 was to find a project students would realize that would
-be interesting, would require a high-quality network, and could
-provide enough fame so that sponsors would be interested.
-    </para>
-
-    <para>
-Someone came up with the idea of doing television broadcast on the
-network, so that students could watch TV in their room. This was
-interesting, mixed a lot of cool technologies, and provided fame
-because no one had written a free MPEG-2 decoder so far.
-    </para>
-
-  </sect1>
-
-  <sect1> <title> Foundation of the VideoLAN project </title>
-
-    <para>
-<ulink url="http://www.3com.com/"> 3Com</ulink>,
-<ulink url="http://www.bouygues.com/"> Bouygues </ulink> and
-la Soci&eacute;t&eacute; des Amis were
-interested and financed the project, which was then known after
-the name of VideoLAN.
-    </para>
-
-    <para>
-The VideoLAN team, in particular <ulink url="mailto:walken@via.ecp.fr">
-Michel Lespinasse </ulink> (current maintainer of <ulink
-url="http://www.linuxvideo.org/">LiViD</ulink>'s mpeg2dec)
-and <ulink url="mailto:hpreg@via.ecp.fr"> R&eacute;gis
-Duchesne</ulink>, started writing code in 1996. By the end of 1997 they had
-a working client-server solution, but it would crash a lot and was
-hard to extend.
-    </para>
-
-    <para>
-At that time it was still closed-source and only-for-demo code.
-    </para>
-
-  </sect1>
-
-  <sect1> <title> VLC media player design </title>
-
-    <para>
-In 1998, <ulink url="mailto:seguin@via.ecp.fr"> Vincent Seguin</ulink>
-(structure, interface and video output),
-<ulink url="mailto:massiot@via.ecp.fr"> Christophe Massiot</ulink>
-(input and video decoder),
-<ulink url="mailto:maxx@via.ecp.fr"> Michel Kaempf</ulink>
-(audio decoder and audio output) and
-<ulink url="mailto:polux@via.ecp.fr"> Jean-Marc Dressler</ulink>
-(synchronization) decided to write a brand new player from scratch,
-called VideoLAN Client (VLC), so that it could be easily open sourced.
-Of course we based it on code written by our predecessors, but in
-an advanced structure, described in the first chapter (it hasn't been
-necessary to change it a lot).
-    </para>
-
-    <para>
-At the same time, <ulink url="mailto:benny@via.ecp.fr"> Beno&icirc;t
-Steiner </ulink> started the writing of an advanced stream server, called
-VideoLAN Server (VLS).
-    </para>
-
-    <para>
-Functional test seeds have been released internally in June 1999
-(vlc-DR1) and November 1999 (vlc-DR2), and we started large scale tests
-and presentations. The French audience discovered us at Linux Expo
-in June 1999, presenting our 20 minutes of Golden Eye (which is now
-a legend among developers :-).  At that time only a network input was
-possible, file input was added later, but it remained kludgy for a while.
-    </para>
-
-    <para>
-In early 2000, we (especially <ulink url="mailto:sam@via.ecp.fr"> Samuel
-Hocevar</ulink>, who is still a major contributor) started working
-on DVDs (PS files, AC3, SPU). In the summer 2000, pre-release builds
-have been seeded (0.2.0 versions), but they still lacked essential
-features.
-    </para>
-
-    <para>
-In late 2000, <ulink url="mailto:massiot@via.ecp.fr"> Christophe Massiot
-</ulink> with the support of his company,
-<ulink url="http://www.idealx.com/"> IDEALX</ulink>, rewrote major
-parts of the input to allow modularization and advanced navigation, and <ulink
-url="mailto:stef@via.ecp.fr"> Stéphane Borel </ulink> worked on a
-fully-featured DVD plug-in for VLC.
-    </para>
-
-  </sect1>
-
-  <sect1> <title> The Opening </title>
-
-    <para>
-For Linux Expo in February 2001, the <ulink url="http://www.gnu.org/">
-Free Software Foundation </ulink> and <ulink url="http://www.idealx.com/">
-IDEALX </ulink> wanted to make live streaming of the 2001 FSF awards
-from Paris to New York. VideoLAN was the chosen solution. Finally
-it couldn't be done live because of bandwidth considerations, but a
-<ulink url="http://www.via.ecp.fr/~massiot/encoding.html"> chain of 
-fully open-source solutions </ulink> made it possible to record it.
-    </para>
-
-    <para>
-At the same time, the president of the <ulink url="http://www.ecp.fr/">
-&Eacute;cole Centrale Paris</ulink> officially decided to place the software
-under GNU General Public Licence, thanks to <ulink
-url="mailto:henri@via.ecp.fr"> Henri Fallon</ulink>, <ulink
-url="mailto:jprey@ads.ecp.fr"> Jean-Philippe Rey</ulink>, and the IDEALX team.
-    </para>
-
-    <para>
-VideoLAN software is now one of the most popular open source DVD
-players available, and has contributors all around the world. The
-last chapter of this appendix is not written yet :-).
-    </para>
-
-  </sect1>
-
-</appendix>

doc/developer/manual.xml

-<?xml version="1.0" encoding="UTF-8"?>
-
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "/usr/share/sgml/docbook/dtd/xml/4.1/docbookx.dtd"
-[
-    <!ENTITY glossary SYSTEM "glossary.xml">
-    <!ENTITY overview SYSTEM "overview.xml">
-    <!ENTITY interface SYSTEM "interface.xml">
-    <!ENTITY input SYSTEM "input.xml">
-    <!ENTITY decoders SYSTEM "decoders.xml">
-    <!ENTITY video_output SYSTEM "video_output.xml">
-    <!ENTITY audio_output SYSTEM "audio_output.xml">
-    <!ENTITY ports SYSTEM "ports.xml">
-    <!ENTITY debugging SYSTEM "debugging.xml">
-    <!ENTITY history SYSTEM "history.xml">
-    <!ENTITY gfdl SYSTEM "gfdl.xml">
-]>
-
-<book id="vlc-dev-doc">
-
-<title> VLC media player API Documentation </title>
-
-<bookinfo>
-
-  <author>
-    <firstname> Christophe </firstname>
-    <surname> Massiot </surname>
-    <affiliation>
-      <jobtitle> <ulink url="mailto:christophe.massiot@idealx.com">
-      Developer </ulink> </jobtitle>
-      <orgname> <ulink url="http://www.idealx.com/"> IDEALX
-      S.A.S. </ulink> </orgname>
-      <orgdiv> Industrial Computing </orgdiv>
-    </affiliation>
-  </author>
-  <collab>
-    <collabname> <ulink url="mailto:sam@zoy.org"> Samuel Hocevar
-    </ulink> </collabname>
-    <affiliation>
-      <jobtitle> Developer </jobtitle>
-      <orgname> VideoLAN project </orgname>
-    </affiliation>
-  </collab>
-  <collab>
-    <collabname> Jean-Fran&ccedil;ois Lecomte </collabname>
-    <affiliation>
-      <jobtitle> <ulink url="mailto:jean-francois.lecomte@idealx.com">
-      Developer </ulink> </jobtitle>
-      <orgname> <ulink url="http://www.idealx.com/"> IDEALX
-      S.A.S. </ulink> </orgname>
-    </affiliation>
-  </collab>
-  <collab>
-    <collabname> <ulink url="mailto:henri@via.ecp.fr">Henri Fallon
-    </ulink> </collabname>
-    <affiliation>
-      <jobtitle> Developer </jobtitle>
-      <orgname> VideoLAN project </orgname>
-    </affiliation>
-  </collab>
-  <pubdate> $Id$ </pubdate>
-  <copyright> <year> 2001 </year>
-              <holder> Christophe Massiot, for IDEALX S.A.S. </holder>
-  </copyright>
-
-  <legalnotice> <para>
-      Permission is granted to copy, distribute and/or modify this document
-      under the terms of the GNU Free Documentation License, Version 1.1
-      or any later version published by the Free Software Foundation;
-      A copy of the license is included in the section entitled "GNU
-      Free Documentation License".
-  </para> </legalnotice>
-</bookinfo>
-
-<toc />
-
-<!-- ============================ GLOSSARY ============================
-  -->
-
-&glossary;
-
-<!-- ============================ OVERVIEW ============================
-  -->
-
-&overview;
-
-<!-- =========================== INTERFACE ============================
-  -->
-
-&interface;
-
-<!-- ============================= INPUT ==============================
-  -->
-
-&input;
-
-<!-- ============================ DECODERS ============================
-  -->
-
-&decoders;
-
-<!-- ========================== VIDEO OUTPUT ==========================
-  -->
-
-&video_output;
-
-<!-- ========================== AUDIO OUTPUT ==========================
-  -->
-
-&audio_output;
-
-<!-- ============================= PORTS ==============================
-  -->
-
-&ports;
-
-<!-- ======================= ADVANCED DEBUGGING =======================
-  -->
-
-&debugging;
-
-<!-- ======================== PROJECT HISTORY =========================
-  -->
-
-&history;
-
-<!-- ============================= GFDL ===============================
-  -->
-
-&gfdl;
-
-</book>

doc/developer/manual.xml.in

-<?xml version="1.0" encoding="iso-8859-1"?>
-
-<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "@DOCBOOKX_DTD@"
-[
-    <!ENTITY glossary SYSTEM "glossary.xml">
-    <!ENTITY overview SYSTEM "overview.xml">
-    <!ENTITY interface SYSTEM "interface.xml">
-    <!ENTITY input SYSTEM "input.xml">
-    <!ENTITY decoders SYSTEM "decoders.xml">
-    <!ENTITY video_output SYSTEM "video_output.xml">
-    <!ENTITY audio_output SYSTEM "audio_output.xml">
-    <!ENTITY ports SYSTEM "ports.xml">
-    <!ENTITY debugging SYSTEM "debugging.xml">
-    <!ENTITY history SYSTEM "history.xml">
-    <!ENTITY gfdl SYSTEM "gfdl.xml">
-]>
-
-<book>
-
-<title> VLC media player API Documentation </title>
-
-<bookinfo>
-
-  <author>
-    <firstname> Christophe </firstname>
-    <surname> Massiot </surname>
-    <affiliation>
-      <jobtitle> <ulink url="mailto:christophe.massiot@idealx.com">
-      Developer </ulink> </jobtitle>
-      <orgname> <ulink url="http://www.idealx.com/"> IDEALX
-      S.A.S. </ulink> </orgname>
-      <orgdiv> Industrial Computing </orgdiv>
-    </affiliation>
-  </author>
-  <collab>
-    <collabname> <ulink url="mailto:sam@zoy.org"> Samuel Hocevar
-    </ulink> </collabname>
-    <affiliation>
-      <jobtitle> Developer </jobtitle>
-      <orgname> VideoLAN project </orgname>
-    </affiliation>
-  </collab>
-  <collab>
-    <collabname> Jean-Fran&ccedil;ois Lecomte </collabname>
-    <affiliation>
-      <jobtitle> <ulink url="mailto:jean-francois.lecomte@idealx.com">
-      Developer </ulink> </jobtitle>
-      <orgname> <ulink url="http://www.idealx.com/"> IDEALX
-      S.A.S. </ulink> </orgname>
-    </affiliation>
-  </collab>
-  <collab>
-    <collabname> <ulink url="mailto:henri@via.ecp.fr">Henri Fallon
-    </ulink> </collabname>
-    <affiliation>
-      <jobtitle> Developer </jobtitle>
-      <orgname> VideoLAN project </orgname>
-    </affiliation>
-  </collab>
-  <pubdate> $Id$ </pubdate>
-  <copyright> <year> 2001 </year>
-              <holder> Christophe Massiot, for IDEALX S.A.S. </holder>
-  </copyright>
-
-  <legalnotice> <para>
-      Permission is granted to copy, distribute and/or modify this document
-      under the terms of the GNU Free Documentation License, Version 1.1
-      or any later version published by the Free Software Foundation;
-      A copy of the license is included in the section entitled "GNU
-      Free Documentation License".
-  </para> </legalnotice>
-</bookinfo>
-
-<toc />
-
-<!-- ============================ GLOSSARY ============================
-  -->
-
-&glossary;
-
-<!-- ============================ OVERVIEW ============================
-  -->
-
-&overview;
-
-<!-- =========================== INTERFACE ============================
-  -->
-
-&interface;
-
-<!-- ============================= INPUT ==============================
-  -->
-
-&input;
-
-<!-- ============================ DECODERS ============================
-  -->
-
-&decoders;
-
-<!-- ========================== VIDEO OUTPUT ==========================
-  -->
-
-&video_output;
-
-<!-- ========================== AUDIO OUTPUT ==========================
-  -->
-
-&audio_output;
-
-<!-- ============================= PORTS ==============================
-  -->
-
-&ports;
-
-<!-- ======================= ADVANCED DEBUGGING =======================
-  -->
-
-&debugging;
-
-<!-- ======================== PROJECT HISTORY =========================
-  -->
-
-&history;
-
-<!-- ============================= GFDL ===============================
-  -->
-
-&gfdl;
-
-</book>

doc/developer/modules.fig

-#FIG 3.2
-Landscape
-Center
-Metric
-A4      
-100.00
-Single
--2
-1200 2
-6 900 900 3150 3870
-6 1080 1620 2880 2070
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 1080 2070 2880 2070 2880 1620 1080 1620 1080 2070
-4 0 0 100 0 2 12 0.0000 4 135 735 1170 1800 interface\001
-4 0 0 100 0 0 12 0.0000 4 180 1635 1170 1980 management and loop\001
--6
-6 1080 2520 2520 2970
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 1080 2970 2520 2970 2520 2520 1080 2520 1080 2970
-4 0 0 100 0 2 12 0.0000 4 180 660 1170 2700 intf_msg\001
-4 0 0 100 0 0 12 0.0000 4 150 1290 1170 2880 messages output\001
--6
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 1530 2070 1530 2520
-2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 1620 2070 1620 2520
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 1080 3645 2835 3645 2835 3195 1080 3195 1080 3645
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 2655 2070 2655 3195
-2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 2745 2070 2745 3195
-2 4 0 1 0 7 100 0 -1 0.000 0 0 7 0 0 5
-	 3150 900 3150 3870 900 3870 900 900 3150 900
-4 0 0 100 0 0 12 0.0000 4 180 1920 1080 1350 Manage threads and user\001
-4 0 0 100 0 2 12 0.0000 4 180 570 1170 3375 playlist\001
-4 0 0 100 0 0 12 0.0000 4 180 1560 1170 3555 playlist management\001
--6
-6 4500 225 5850 675
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 4500 675 5850 675 5850 225 4500 225 4500 675
-4 0 0 100 0 2 12 0.0000 4 135 375 4590 405 main\001
-4 0 0 100 0 0 12 0.0000 4 180 1185 4590 585 program control\001
--6
-6 4095 900 5985 3240
-6 4275 1620 5805 2250
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 4275 2250 5805 2250 5805 1620 4275 1620 4275 2250
-4 0 0 100 0 2 12 0.0000 4 180 1020 4365 1800 video_output\001
-4 0 0 100 0 0 12 0.0000 4 180 1365 4365 1980 pictures rendering\001
-4 0 0 100 0 0 12 0.0000 4 180 1080 4365 2160 and displaying\001
--6
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4725 2250 4725 2610
-2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4815 2250 4815 2610
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4905 2250 4905 2610
-2 4 0 1 0 7 100 0 -1 0.000 0 0 7 0 0 5
-	 5985 900 5985 3240 4095 3240 4095 900 5985 900
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 4275 3060 5805 3060 5805 2610 4275 2610 4275 3060
-4 0 0 100 0 2 16 0.0000 4 225 1380 4275 1170 video_output\001
-4 0 0 100 0 0 12 0.0000 4 180 1425 4275 1350 pictures displaying\001
-4 0 0 100 0 2 12 0.0000 4 180 945 4365 2790 vout plug-in\001
-4 0 0 100 0 0 12 0.0000 4 180 1005 4365 2970 Output driver\001
--6
-6 900 5490 6705 7470
-6 1080 6120 2700 6570
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 1080 6570 2700 6570 2700 6120 1080 6120 1080 6570
-4 0 0 100 0 2 12 0.0000 4 180 375 1170 6300 input\001
-4 0 0 100 0 0 12 0.0000 4 135 1455 1170 6480 file/network socket\001
--6
-6 2970 6120 4590 6570
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 2970 6570 4590 6570 4590 6120 2970 6120 2970 6570
-4 0 0 100 0 2 12 0.0000 4 180 975 3060 6300 input plug-in\001
-4 0 0 100 0 0 12 0.0000 4 165 1515 3060 6480 init, read and demux\001
--6
-6 4860 6120 6480 6570
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 4860 6570 6480 6570 6480 6120 4860 6120 4860 6570
-4 0 0 100 0 2 12 0.0000 4 135 765 4950 6300 programs\001
-4 0 0 100 0 0 12 0.0000 4 150 1530 4950 6480 stream management\001
--6
-6 1080 6840 2700 7290
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 1080 7290 2700 7290 2700 6840 1080 6840 1080 7290
-4 0 0 100 0 2 12 0.0000 4 180 1080 1170 7020 input_ext-intf\001
-4 0 0 100 0 0 12 0.0000 4 180 1350 1170 7200 stream navigation\001
--6
-6 2970 6840 4590 7290
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 2970 7290 4590 7290 4590 6840 2970 6840 2970 7290
-4 0 0 100 0 2 12 0.0000 4 165 1080 3060 7020 mpeg_system\001
-4 0 0 100 0 0 12 0.0000 4 180 1020 3060 7200 demultiplexer\001
--6
-6 4860 6840 6480 7290
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 4860 7290 6480 7290 6480 6840 4860 6840 4860 7290
-4 0 0 100 0 2 12 0.0000 4 135 435 4950 7020 clock\001
-4 0 0 100 0 0 12 0.0000 4 180 1335 4950 7200 time management\001
--6
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 2700 6255 2970 6255
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4590 6255 4860 6255
-2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 2700 6345 2970 6345
-2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4590 6345 4860 6345
-2 4 0 1 0 7 100 0 -1 0.000 0 0 7 0 0 5
-	 6705 5490 6705 7470 900 7470 900 5490 6705 5490
-2 1 0 1 1 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 3645 6570 3645 6840
-2 1 0 1 1 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4590 7065 4860 7065
-4 0 0 100 0 2 16 0.0000 4 225 570 1080 5760 input\001
--6
-6 4275 4185 5805 4635
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 4275 4635 5805 4635 5805 4185 4275 4185 4275 4635
-4 0 0 100 0 0 12 0.0000 4 135 870 4365 4545 ES decoder\001
-4 0 0 100 0 2 12 0.0000 4 180 1185 4365 4365 video_decoder\001
--6
-6 6255 900 8685 4815
-6 6705 900 8685 3240
-6 6885 1620 8505 2250
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 6885 2250 8505 2250 8505 1620 6885 1620 6885 2250
-4 0 0 100 0 2 12 0.0000 4 180 1020 6975 1800 audio_output\001
-4 0 0 100 0 0 12 0.0000 4 135 1440 6975 1980 audio frames mixer\001
-4 0 0 100 0 0 12 0.0000 4 180 780 6975 2160 and player\001
--6
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 7335 2250 7335 2610
-2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 7425 2250 7425 2610
-2 4 0 1 0 7 100 0 -1 0.000 0 0 7 0 0 5
-	 8685 900 8685 3240 6705 3240 6705 900 8685 900
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 6885 3060 8325 3060 8325 2610 6885 2610 6885 3060
-4 0 0 100 0 2 16 0.0000 4 225 1410 6885 1170 audio_output\001
-4 0 0 100 0 2 12 0.0000 4 180 960 6975 2790 aout plug-in\001
-4 0 0 100 0 0 12 0.0000 4 180 960 6975 2970 output driver\001
--6
-6 6885 4185 8505 4635
-2 2 0 1 0 7 100 0 -1 0.000 0 0 -1 0 0 5
-	 6885 4635 8505 4635 8505 4185 6885 4185 6885 4635
-4 0 0 100 0 2 12 0.0000 4 180 1185 6975 4365 audio_decoder\001
-4 0 0 100 0 0 12 0.0000 4 135 870 6975 4545 ES decoder\001
--6
-2 1 0 1 1 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 6885 4275 6345 4275 6345 2070 6885 2070
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 6885 4365 6255 4365 6255 1980 6885 1980
-2 4 0 1 0 7 100 0 -1 0.000 0 0 7 0 0 5
-	 8685 3465 8685 4815 6705 4815 6705 3465 8685 3465
--6
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 1080 1800 675 1800 675 6255 1080 6255
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 3
-	1 1 1.00 60.00 120.00
-	 4500 360 2250 360 2250 1620
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 1530 3645 1530 6120
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 4275 4410 3645 4410 3645 1890 4275 1890
-2 1 0 1 1 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 4275 4320 3735 4320 3735 1980 4275 1980
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 4275 4500 3555 4500 3555 1800 4275 1800
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 3
-	1 1 1.00 60.00 120.00
-	 5850 450 7740 450 7740 1620
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 3
-	1 1 1.00 60.00 120.00
-	 5850 360 7830 360 7830 1620
-2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 1080 1710 585 1710 585 7020 1080 7020
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 5130 6120 5130 4635
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 5220 6120 5220 4635
-2 1 0 1 1 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 5310 6120 5310 4635
-2 4 0 1 0 7 100 0 -1 0.000 0 0 7 0 0 5
-	 5985 3465 5985 4815 4095 4815 4095 3465 5985 3465
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 5670 6120 5670 5175 7425 5175 7425 4635
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 5760 6120 5760 5265 7515 5265 7515 4635
-2 1 0 1 1 7 100 0 -1 0.000 0 0 -1 1 0 4
-	1 1 1.00 60.00 120.00
-	 5850 6120 5850 5355 7605 5355 7605 4635
-2 1 0 1 2 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 6840 6165 7335 6165
-2 1 0 1 0 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 6840 6435 7335 6435
-2 1 0 1 4 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 6840 6705 7335 6705
-2 1 0 1 1 7 100 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 6840 7155 7335 7155
-4 0 0 100 0 2 16 0.0000 4 165 930 1080 1170 interface\001
-4 0 0 100 0 2 16 0.0000 4 225 1485 4275 3735 video_decoder\001
-4 0 0 100 0 2 16 0.0000 4 225 1515 6930 3735 audio_decoder\001
-4 0 0 100 0 0 12 0.0000 4 135 585 7470 6480 manage\001
-4 0 0 100 0 0 12 0.0000 4 135 1155 7470 6210 store reference\001
-4 0 0 100 0 0 12 0.0000 4 135 1215 7470 6750 create/initialize/\001
-4 0 0 100 0 0 12 0.0000 4 135 330 7470 7200 feed\001
-4 0 0 50 0 0 12 0.0000 4 180 570 7470 6975 destroy\001

doc/developer/overview.xml

-<chapter> <title> VLC Overview </title>
-
-  <sect1> <title> LibVLC </title>
-
-    <para> LibVLC is the core part of VLC. It is a library providing an
-    interface for programs such as VLC to a lot of functionalities such as
-    stream access, audio and video output, plugin handling, a thread system.
-    All the LibVLC source files are located in the <filename>src/</filename>
-    directory and its subdirectories: </para>
-
-    <itemizedlist>
-
-      <listitem> <para> <filename>interface/</filename>: contains code for
-      user interaction such as key presses and device ejection. </para>
-      </listitem>
-
-      <listitem> <para> <filename>playlist/</filename>: manages playlist
-      interaction such as stop, play, next, or random playback. </para>
-      </listitem>
-
-      <listitem> <para> <filename>input/</filename>: opens an input module,
-      reads packets, parses them and passes reconstituted elementary streams
-      to the decoder(s). </para> </listitem>
-
-      <listitem> <para> <filename>video_output/</filename>: initializes the
-      video display, gets all pictures and subpictures (ie. subtitles) from
-      the decoder(s), optionally converts them to another format (such as YUV
-      to RGB), and displays them. </para></listitem>
-
-      <listitem> <para> <filename>audio_output/</filename>: initializes the
-      audio mixer, ie. finds the right playing frequency, and then resamples
-      audio frames received from the decoder(s). </para> </listitem>
-
-      <listitem> <para> <filename>stream_output/</filename>: TODO </para>
-      </listitem>
-
-      <listitem> <para> <filename>misc/</filename>: miscellaneous utilities
-      used in other parts of libvlc, such as the thread system, the message
-      queue, CPU detection, the object lookup system, or platform-specific
-      code. </para> </listitem>
-
-    </itemizedlist>
-
-    <mediaobject>
-      <imageobject>
-        <imagedata fileref="modules.png" format="PNG" scalefit="1" scale="80"/>
-      </imageobject>
-      <imageobject>
-        <imagedata fileref="modules.gif" format="GIF" />
-      </imageobject>
-      <textobject>
-        <phrase> Data flow between modules </phrase>
-      </textobject>
-    </mediaobject>
-
-  </sect1>
-
-  <sect1> <title> VLC </title>
-
-    <para> VLC is a simple program written around LibVLC. It is very small,
-    but is a fully featured multimedia player thanks to LibVLC's support for
-    dynamic modules. </para>
-
-  </sect1>
-
-  <sect1> <title> Modules </title>
-
-    <para> Modules are located in the <filename>modules/</filename>
-    subdirectory and are loaded at runtime. Every module may offer different
-    features that will best suit a particular file or a particular
-    environment. Besides, most portability works result in the writing of an
-    audio_output/video_output/interface module to support a new platform (eg.
-    BeOS or MacOS X). </para>
-
-    <para> Plugin modules are loaded and unloaded dynamically
-    by functions in <filename>src/misc/modules.c</filename> and
-    <filename>include/modules*.h</filename>. The API for writing modules will
-    be discussed in a following chapter. </para>
-
-    <para> Modules can also be built directly into the application which uses
-    LibVLC, for instance on an operating system that does not have support for
-    dynamically loadable code. Modules statically built into the application
-    are called builtins. </para>
-
-  </sect1>
-
-  <sect1> <title> Threads </title>
-
-    <sect2> <title> Thread management </title>
-
-    <para> VLC is heavily multi-threaded. We chose against a single-thread
-    approach because decoder preemptibility and scheduling would be a
-    mastermind (for instance decoders and outputs have to be separated,
-    otherwise it cannot be warrantied that a frame will be played at the
-    exact presentation time), and we currently have no plan to support a
-    single-threaded client. Multi-process decoders usually imply more overhead
-    (problems of shared memory) and communication between processes is harder.
-    </para>
-
-    <para> Our threading structure is modeled on pthreads.
-    However, for portability reasons, we don't call
-    <function>pthread_*</function> functions directly, but use a
-    similar wrapper, made of <function>vlc_thread_create</function>,
-    <function>vlc_thread_exit</function>,
-    <function>vlc_thread_join</function>,
-    <function>vlc_mutex_init</function>, <function>vlc_mutex_lock</function>,
-    <function>vlc_mutex_unlock</function>,
-    <function>vlc_mutex_destroy</function>,
-    <function>vlc_cond_init</function>, <function>vlc_cond_signal</function>,
-    <function>vlc_cond_broadcast</function>,
-    <function>vlc_cond_wait</function>, <function>vlc_cond_destroy</function>,
-    and structures <type>vlc_thread_t</type>, <type>vlc_mutex_t</type>, and
-    <type>vlc_cond_t</type>. </para>
-
-    </sect2>
-
-    <sect2> <title> Synchronization </title>
-
-    <para> Another key feature of VLC is that decoding and playing are
-    asynchronous: decoding is done by a decoder thread, playing is done by
-    audio_output or video_output thread. The design goal is to ensure that
-    an audio or video frame is played exactly at the right time, without
-    blocking any of the decoder threads. This leads to a complex communication
-    structure between the interface, the input, the decoders and the outputs.
-    </para>
-
-    <para> Having several input and video_output threads reading multiple
-    files at the same time is permitted, despite the fact that the current
-    interface doesn't allow any way to do it [this is subject to change in the
-    near future]. Anyway the client has been written from the ground up with
-    this in mind. This also implies that a non-reentrant library (including in
-    particular liba52) cannot be used without using a global lock. </para>
-
-    <para> Presentation Time Stamps located in the system layer of the
-    stream are passed to the decoders, and all resulting samples are dated
-    accordingly. The output layers are supposed to play them at the right
-    time. Dates are converted to microseconds ; an absolute date is the number
-    of microseconds since Epoch (Jan 1st, 1970). The <type>mtime_t</type> type
-    is a signed 64-bit integer. </para>
-
-    <para> The current date can be retrieved with
-    <function>mdate()</function>. The execution of a thread can be suspended
-    until a certain <parameter>date</parameter> via <function>mwait</function>
-    <parameter>( mtime_t date )</parameter>. You can sleep for a fixed number
-    of microseconds with <function>msleep</function> <parameter>( mtime_t
-    delay )</parameter>. </para>
-
-    <warning> <para> Please remember to wake up slightly
-    <emphasis>before</emphasis> the presentation date, if some particular
-    treatment needs to be done (e.g. a chroma transformation). For instance
-    in <filename>modules/codec/mpeg_video/synchro.c</filename>, track of the
-    average decoding times is kept to ensure pictures are not decoded too
-    late. </para> </warning>
-
-    </sect2>
-
-  </sect1>
-
-  <sect1> <title> Code conventions </title>
-
-    <sect2> <title> Function naming </title>
-
-      <para>
-All functions are named accordingly : module name (in lower case) + _ +
-function name (in mixed case, <emphasis> without underscores</emphasis>).
-For instance : <function>intf_FooFunction</function>. Static functions
-don't need usage of the module name.
-      </para>
-
-    </sect2>
-
-    <sect2> <title> Variable naming </title>
-
-      <para>
-Hungarian notations are used, that means we have the following prefixes :
-      </para>
-
-      <itemizedlist>
-        <listitem> <para> i_ for integers (sometimes l_ for long integers) ;
-        </para> </listitem>
-        <listitem> <para> b_ for booleans ; </para> </listitem>
-        <listitem> <para> d_ for doubles (sometimes f_ for floats) ;
-        </para> </listitem>
-        <listitem> <para> pf_ for function pointers ; </para> </listitem>
-        <listitem> <para> psz_ for a Pointer to a String terminated by a
-        Zero (C-string) ;
-        </para> </listitem>
-        <listitem> <para> More generally, we add a p when the variable is
-        a pointer to a type. </para> </listitem>
-      </itemizedlist>
-
-      <para>
-If one variable has no basic type (for instance a complex structure), don't
-put any prefix (except p_* if it's a pointer). After one prefix, put
-an <emphasis> explicit </emphasis> variable name <emphasis> in lower
-case</emphasis>. If several words are required, join them with an
-underscore (no mixed case). Examples :
-      </para>
-
-      <itemizedlist>
-        <listitem> <para>
-        <type> data_packet_t * </type> <varname> p_buffer; </varname>
-        </para> </listitem> <listitem> <para>
-        <type> char </type> <varname> psz_msg_date[42]; </varname>
-        </para> </listitem> <listitem> <para>
-        <type> int </type> <varname> pi_es_refcount[MAX_ES]; </varname>
-        </para> </listitem> <listitem> <para>
-        <type> void </type> <varname> (* pf_next_data_packet)( int * ); </varname>
-        </para> </listitem>
-      </itemizedlist>
-
-    </sect2>
-
-    <sect2> <title> A few words about white spaces </title>
-
-      <para>
-First, never use tabs in the source (you're entitled to use them in the
-Makefile :-). Use <command> set expandtab </command> under <application>
-vim </application> or the equivalent under <application>
-emacs</application>. Indents are 4 spaces long.
-      </para>
-
-      <para>
-Second, put spaces <emphasis> before and after </emphasis> operators, and
-inside brackets. For instance :
-<programlisting> for( i = 0; i &lt; 12; i++, j += 42 ); </programlisting>
-      </para>
-
-      <para>
-Third, leave braces alone on their lines (GNU style). For instance :
-        <programlisting>
-if( i_es == 42 )
-{
-    p_buffer[0] = 0x12;
-}
-        </programlisting>
-      </para>
-
-      <para>
-We write C, so use C-style comments /* ... */.
-      </para>
-
-    </sect2>
-
-  </sect1>
-
-</chapter>

doc/developer/ports.xml

-<appendix> <title> Ports </title>
-
-  <sect1> <title> Port steps </title>
-
-    <para>
-Basically, porting to a new architecture boils down to follow the
-following steps :
-    </para>
-
-    <orderedlist>
-
-      <listitem> <para> <emphasis> Building the VLC : </emphasis>
-      That may be the most difficult part, depending on how POSIX
-      the architecture is. You have to produce valid C.
-      </para> </listitem>
-
-      <listitem> <para> <emphasis> Having video : </emphasis>
-      If your architecture features an X server, it should be
-      straightforward, though you might have problems with xvideo
-      or xshm. Otherwise you can try to use SDL if it is supported,
-      or end up writing your own video output plugin.
-      </para> </listitem>
-
-      <listitem> <para> <emphasis> Having audio : </emphasis>
-      If your architecture features an OSS compatible DSP or ALSA, you
-      can reuse an existing plugin. Otherwise you will have to write
-      your own audio output plugin.
-      </para> </listitem>
-
-      <listitem> <para> <emphasis> Accessing DVDs : </emphasis>
-      You are going to need a write access to the DVD device.
-      Every system has specific ioctl() for key negociation with
-      the DVD drive, so we have set up an abstration layer in
-      <filename> plugins/dvd/dvd_ioctl.c</filename>. You might
-      need to add stuff here. Some operating systems won't give
-      you access to the key negociation (MacOS X), so you will
-      have to write a kernel extension or you will only be able to read
-      unencrypted DVDs. Other operating systems might only give
-      you read access to the DVD device if you are root. Your mileage
-      may vary.
-      </para> </listitem>
-
-      <listitem> <para> <emphasis> Writing a native interface : </emphasis>
-      If your system doesn't support GTK or Qt, you will have to
-      write a native interface plugin (for instance Aqua or Win32).
-      You may also need to rewrite the video output plugin if
-      you're currently using a slow compatibility layer.
-      </para> </listitem>
-
-      <listitem> <para> <emphasis> Optimizing : </emphasis>
-      If your architecture features a special set of multimedia
-      instructions (such as MMX) that is not supported by VLC, you
-      may want to write specific optimizations. Heavy calculation
-      parts are : IDCT (see idct plugin), motion compensation
-      (see motion plugin), and YUV (see video output) if you don't
-      use the YUV overlay support of your video board (SDL or
-      XVideo extension).
-      </para> </listitem>
-
-    </orderedlist>
-
-  </sect1>
-
-  <sect1> <title> Building </title>
-
-    <para>
-This is probably the most complicated part. If your platform is fully
-POSIX-compliant (such as GNU/Linux), it should be quick, otherwise
-expect troubles. Known issues are :
-    </para>
-
-    <itemizedlist>
-
-      <listitem> <para> Finding a compiler : We use <application> gcc
-      </application> on all platforms, and <application> mingw32
-      </application> to cross-compile the win32 port. If you don't you're
-      probably in <emphasis> very big </emphasis> trouble. Good luck.
-      </para> </listitem>
-
-      <listitem> <para> Finding <application> GNU make </application> : Our
-      <filename>Makefile</filename> is heavily <application>GNU make
-      </application> specific, so I suggest you install it.
-      </para> </listitem>
-
-      <listitem> <para> Running the <filename> configure </filename>
-      script : This is basically a shell script, so if you have a UNIX
-      shell on your platform it shouldn't be a problem. It will probe
-      your system for headers and libraries needed. It needs
-      adequate <filename> config.sub </filename> and <filename>
-      config.guess</filename>, so if your platform is young your
-      provider may have supplied customized versions. Check with it.
-      </para> </listitem>
-
-      <listitem> <para> Compiling the VLC binary : This is the most
-      difficult. Type <command> make </command> or <command> gmake
-      </command> and watch the results. It will probably break soon
-      on a parse error. Add the headers missing, fix mistakes. If
-      you cannot make it to also compiles on other platforms, use
-      #ifdef directives. Add tests for functions or libraries in
-      <filename> configure.in </filename> and run <command> autoheader
-      </command> and <command> autoconf</command>. Always prefer
-      tests on <property> #ifdef HAVE_MY_HEADER_T</property>,
-      instead of <property> #ifdef SYS_MYOPERATINGSYSTEM</property>.
-      You may especially experience problems with the network code
-      in <filename> src/input/input.c</filename>.
-      </para> </listitem>
-
-      <listitem> <para> Threads : If your system has an exotic thread
-      implementation, you will probably need to fill the wrappers in
-      <filename> include/threads.h </filename> for your system.
-      Currently supported implementations include the POSIX pthreads,
-      the BeOS threads, and the Mach cthreads.
-      </para> </listitem>
-
-      <listitem> <para> Linking : You will need special flags to the
-      compiler, to allow symbol exports (otherwise plug-ins won't
-      work). For instance under GNU/Linux you need <parameter>
-      -rdynamic</parameter>.
-      </para> </listitem>
-
-      <listitem> <para> Compiling plug-ins : You do not need external
-      plug-ins at first, you can build all you need in (see <filename>
-      Makefile.opts</filename>). In the long run though, it is a
-      good idea to change <parameter> PCFLAGS</parameter> and <parameter>
-      PLCFLAGS</parameter> to allow run-time loading of libraries.
-      You are going to need <application> libdl</application>, or a
-      similar dynamic loader. To add support for an exotic dynamic
-      loader, have a look at <filename> include/modules_core.h
-      </filename>. Currently supported implementations include the
-      UNIX dynamic loader and the BeOS image loader.
-      </para> </listitem>
-
-      <listitem> <para> Assembling : If you use specific optimizations
-      (such as MMX), you may have problem assembling files, because
-      the assembler syntax may be different on your platform. Try
-      without it at first. Pay attention to the optimization flags
-      too, you may see a <emphasis>huge</emphasis> difference.
-      </para> </listitem>
-
-    </itemizedlist>
-
-    <para>
-VLC should work both on little endian and big endian systems. All
-load operations should be aligned on the native size of the type, so
-that it works on exotic processors like Sparc or Alpha. It should
-work on 64-bit platforms, though it has not been optimized for it.
-A big boost for them would be to have a WORD_TYPE = u64 in <filename>
-include/input_ext-dec.h</filename>, but it is currently broken for
-unknown reasons.
-    </para>
-
-    <para>
-If you experience run-time problems, see the following appendix and
-pray for you to have <command> gdb</command>...
-    </para>
-
-  </sect1>
-
-</appendix>

doc/developer/ps.fig

-#FIG 3.2
-Landscape
-Center
-Metric
-A4      
-100.00
-Single
--2
-1200 2
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 450 135 6750 135 6750 2295 450 2295 450 135
-2 2 0 1 0 7 50 0 19 0.000 0 0 -1 0 0 5
-	 900 405 1800 405 1800 900 900 900 900 405
-2 2 0 1 0 7 50 0 18 0.000 0 0 -1 0 0 5
-	 1800 405 2790 405 2790 900 1800 900 1800 405
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 2790 405 6300 405 6300 900 2790 900 2790 405
-2 2 0 1 0 7 50 0 7 0.000 0 0 -1 0 0 5
-	 900 405 630 405 630 900 900 900 900 405
-2 2 0 1 0 7 50 0 7 0.000 0 0 -1 0 0 5
-	 6300 405 6570 405 6570 900 6300 900 6300 405
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 630 1350 630 945
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 2790 1395 2790 945
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 6300 1395 6300 945
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 6570 1710 6570 945
-4 0 0 50 0 0 12 0.0000 4 135 765 990 720 PS header\001
-4 0 0 50 0 0 12 0.0000 4 135 885 1845 720 PES header\001
-4 0 0 50 0 0 12 0.0000 4 180 1755 2970 720 PES payload (ES data)\001
-4 0 0 50 0 0 12 0.0000 4 180 630 585 1575 p_buffer\001
-4 0 0 50 0 0 12 0.0000 4 180 1215 2745 1620 p_payload_start\001
-4 0 0 50 0 0 12 0.0000 4 180 1125 5220 1575 p_payload_end\001
-4 2 0 50 0 0 12 0.0000 4 180 1275 6615 1890 p_buffer + i_size\001
-4 0 0 50 0 0 14 0.0000 4 195 2295 2205 2025 First (and last) data packet\001
-4 0 0 50 0 0 14 0.0000 4 195 1005 2835 2655 PES packet\001

doc/developer/screen.css

-/* screen.css
-*/
-
-a:link          {color: blue; text-decoration: underline}
-a:active        {color: red; text-decoration: underline}
-a:visited       {color: darkblue; text-decoration: underline}
-
-body            {font-family: "Verdana", Georgia, Times; font-size: 1em; color: #000000; background-color: #FFFFFF; margin: 1em 1em 1em 1em;}
-h1              {font-size: 1.4em; margin: 0em 0em 0em 0em;}
-h2              {font-size: 1.2em; margin: 0em 0em 0em 0em;}
-h3              {font-size: 1em; margin: 0em 0em 0em 0em;}
-h4              {font-size: 1em; margin: 0em 0em 0em 0em;}
-h5              {font-size: 1em; margin: 0em 0em 0em 0em;}
-p               {font-size: 1em; margin: 0em 0em 0.5em 0em;}
-tt              {font-family: "Courier New"; font-weight: bold;}
-hr		{height: 1px;}
-
-.navheader      {}
-/* .navfooter      {} */
-.revhistory table { border: none; padding: 0px 0px 0px 0px; margin: 1em 0em 1em 0em;}
-.revhistory th { border: none; padding: 0px 0px 0px 0px	;}
-.revhistory td { border: none; padding: 0px 0px 0px 0px	;}
-.note { border: 1px solid #CCCC99; background-color: #F5F5E7; padding: 0.5em 0.5em 0.5em 0.5em; margin: 1em 0em 1em 0em; }
-.caution { border: 1px solid #F6EA00; background-color: #FFFFC9; padding: 0.5em 0.5em 0.5em 0.5em;  margin: 1em 0em 1em 0em;}
-.tipp { background-color: #F5F5DC }
-.important { font-family: "Courier New"; font-size: 0.8em; border: 1px solid #F95E00; background-color: #F9CDB3; padding: 0.5em 0.5em 0.5em 0.5em; margin: 2em 0em 2em 0em;}
-.screen { font-family: "Courier New"; font-size: 0.8em; border: 1px solid #999999; background-color: #EBEBEB; padding: 0.5em 0.5em 0.5em 0.5em; margin: 2em 0em 2em 0em;}
-.programlisting { font-family: "Courier New"; font-size: 0.8em; border: 1px solid #B2DBFF; background-color: #F0F8FF; padding: 0.5em 0.5em 0.5em 0.5em; margin: 2em 0em 2em 0em;}
-.important .programlisting { font-family: "Courier New"; font-size: 1em; border: 1px solid #B2DBFF; background-color: #F0F8FF; padding: 0.5em 0.5em 0.5em 0.5em; margin: 2em 0em 2em 0em;}
-.important .screen { font-family: "Courier New"; font-size: 1em; border: 1px solid #999999; background-color: #EBEBEB; padding: 0.5em 0.5em 0.5em 0.5em; margin: 2em 0em 2em 0em;}
-.informalexample { font-family: "Courier New"; font-size: 0.8em; border: 1px solid #B2DBFF; background-color: #F0F8FF; padding: 0.5em 0.5em 0.5em 0.5em; margin: 2em 0em 2em 0em;}

doc/developer/stream.fig

-#FIG 3.2
-Landscape
-Center
-Metric
-A4      
-100.00
-Single
--2
-1200 2
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 1305 90 3915 90 3915 1170 1305 1170 1305 90
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	0 0 1.00 60.00 120.00
-	 1980 1215 1035 3420
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 225 3465 1800 3465 1800 4275 225 4275 225 3465
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	0 0 1.00 60.00 120.00
-	 630 4275 405 6210
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 0 6300 1845 6300 1845 7605 0 7605 0 6300
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	0 0 1.00 60.00 120.00
-	 990 4275 990 5625
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 720 5670 1260 5670 1260 5985 720 5985 720 5670
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	0 0 1.00 60.00 120.00
-	 1395 4275 1665 5580
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 1440 5670 2025 5670 2025 5985 1440 5985 1440 5670
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	0 0 1.00 60.00 120.00
-	 3195 1215 4095 3375
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 3645 3375 4590 3375 4590 3780 3645 3780 3645 3375
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	0 0 1.00 60.00 120.00
-	 3915 3780 3420 5670
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 3060 5760 3690 5760 3690 6120 3060 6120 3060 5760
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	0 0 1.00 60.00 120.00
-	 4275 3780 4815 5670
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 4545 5760 5085 5760 5085 6120 4545 6120 4545 5760
-4 0 0 50 0 0 12 0.0000 4 135 630 1485 360 Stream :\001
-4 0 0 50 0 0 12 0.0000 4 180 2250 1485 585 - b_pace_control, b_seekable\001
-4 0 0 50 0 0 12 0.0000 4 180 1065 1485 810 - i_size, i_tell\001
-4 0 0 50 0 0 12 0.0000 4 135 675 1485 1035 - control\001
-4 0 0 50 0 0 12 0.0000 4 180 855 360 3690 Program 1 :\001
-4 0 0 50 0 0 12 0.0000 4 180 1080 360 3915 - synchro info\001
-4 0 0 50 0 0 12 0.0000 4 150 1260 360 4140 - p_vout, p_aout\001
-4 0 0 50 0 0 12 0.0000 4 135 450 90 6525 ES 1 :\001
-4 0 0 50 0 0 12 0.0000 4 165 1635 90 6750 - audio, video or SPU\001
-4 0 0 50 0 0 12 0.0000 4 135 345 90 6975 - ID\001
-4 0 0 50 0 0 12 0.0000 4 180 615 90 7200 - i_type\001
-4 0 0 50 0 0 12 0.0000 4 180 1275 90 7425 - p_decoder_fifo\001
-4 0 0 50 0 0 12 0.0000 4 135 360 810 5895 ES 2\001
-4 0 0 50 0 0 12 0.0000 4 135 360 1575 5895 ES 3\001
-4 0 0 50 0 0 12 0.0000 4 180 765 3735 3645 Program 2\001
-4 0 0 50 0 0 12 0.0000 4 135 360 3195 6030 ES 4\001
-4 0 0 50 0 0 12 0.0000 4 135 360 4635 6030 ES 5\001

doc/developer/stylesheet-print-noicones.dsl

-<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
-<!ENTITY dbstyle SYSTEM
-"/usr/share/sgml/docbook/stylesheet/dsssl/modular/print/docbook.dsl" CDATA DSSSL>
-]>
-
-<style-sheet>
-<style-specification use="docbook">
-<style-specification-body>
-
-; Personnalization of James Clark's stylesheet for PS & PDF output
-; These parameters overide James Clark's one.
-; Written by Alexis de Lattre (alexis@videolan.org)
-
-; Only produce a table of contents (not a table of figure, etc...)
-(define ($generate-book-lot-list$)
-  (list ))
-
-; Depth of the table of contents
-(define (toc-depth nd)
-      2)
-
-; Magins
-(define %left-margin%
-  3pi)
-
-(define %right-margin%
-  3pi)
-
-(define %top-margin%
-  5pi)
-
-(define %bottom-margin%
-  3.5pi)
-
-(define %header-margin%
-  2pi)
-
-(define %footer-margin%
-  2pi)
-
-</style-specification-body>
-</style-specification>
-<external-specification id="docbook" document="dbstyle">
-</style-sheet>

doc/developer/stylesheet-txt.dsl

-<!DOCTYPE style-sheet PUBLIC "-//James Clark//DTD DSSSL Style Sheet//EN" [
-<!ENTITY dbstyle SYSTEM "/usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl" CDATA DSSSL>
-]>
-
-<style-sheet>
-<style-specification use="docbook">
-<style-specification-body>
-
-; Personnalization of James Clark's stylesheet for Text output
-; These parameters overide James Clark's one.
-; Written by Alexis de Lattre (alexis@videolan.org)
-
-; Only produce a table of contents (not a table of figure, etc...)
-(define ($generate-book-lot-list$)
-  (list ))
-
-; Depth of the table of contents
-(define (toc-depth nd)
-      1)
-
-; No icons
-(define %admon-graphics%
-  #f)
-
-; Are sections enumerated?
-(define %section-autolabel%
-  #t)
-
-
-</style-specification-body>
-</style-specification>
-<external-specification id="docbook" document="dbstyle">
-</style-sheet>

doc/developer/ts.fig

-#FIG 3.2
-Landscape
-Center
-Metric
-A4      
-100.00
-Single
--2
-1200 2
-6 585 405 4725 1935
-6 585 405 4725 1935
-2 2 0 1 0 7 50 0 19 0.000 0 0 -1 0 0 5
-	 765 405 1665 405 1665 900 765 900 765 405
-2 2 0 1 0 7 50 0 18 0.000 0 0 -1 0 0 5
-	 1665 405 2655 405 2655 900 1665 900 1665 405
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 2655 1395 2655 945
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 2655 405 4500 405 4500 900 2655 900 2655 405
-2 2 0 1 0 7 50 0 7 0.000 0 0 -1 0 0 5
-	 4500 405 4680 405 4680 900 4500 900 4500 405
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 630 1350 630 945
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4500 1395 4500 945
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4680 1710 4680 945
-4 0 0 50 0 0 12 0.0000 4 135 765 855 720 TS header\001
-4 0 0 50 0 0 12 0.0000 4 135 885 1710 720 PES header\001
-4 0 0 50 0 0 12 0.0000 4 180 1215 2070 1575 p_payload_start\001
-4 0 0 50 0 0 12 0.0000 4 180 1755 2700 720 PES payload (ES data)\001
-4 0 0 50 0 0 12 0.0000 4 180 630 585 1575 p_buffer\001
-4 0 0 50 0 0 12 0.0000 4 180 1125 3420 1575 p_payload_end\001
-4 2 0 50 0 0 12 0.0000 4 180 1275 4725 1890 p_buffer + i_size\001
--6
-2 2 0 1 0 7 50 0 7 0.000 0 0 -1 0 0 5
-	 765 405 630 405 630 900 765 900 765 405
--6
-6 5265 405 6975 900
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 5265 405 6930 405 6930 900 5265 900 5265 405
-4 0 0 50 0 0 12 0.0000 4 180 1635 5310 720 PES payload (cont'd)\001
--6
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 4680 630 5040 630
-2 2 0 1 0 7 50 0 19 0.000 0 0 -1 0 0 5
-	 5265 405 5085 405 5085 900 5265 900 5265 405
-2 2 0 1 0 7 50 0 19 0.000 0 0 -1 0 0 5
-	 5265 1575 5085 1575 5085 2070 5265 2070 5265 1575
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 5265 1575 6930 1575 6930 2070 5265 2070 5265 1575
-2 1 0 1 0 7 50 0 -1 0.000 0 0 -1 1 0 2
-	1 1 1.00 60.00 120.00
-	 6840 900 6840 1530
-2 2 0 1 0 7 50 0 -1 0.000 0 0 -1 0 0 5
-	 450 135 7110 135 7110 2565 450 2565 450 135
-4 0 0 50 0 0 14 0.0000 4 195 1440 1845 2340 First data packet\001
-4 0 0 50 0 0 14 0.0000 4 195 1695 5040 1170 Second data packet\001
-4 0 0 50 0 0 12 0.0000 4 180 1425 5400 1890 PES payload (end)\001
-4 0 0 50 0 0 14 0.0000 4 195 2370 4590 2340 Third (and last) data packet\001
-4 0 0 50 0 0 14 0.0000 4 195 1005 3330 2925 PES packet\001

doc/developer/video_output.xml

-<chapter> <title> The video output layer </title>
-
-  <sect1> <title> Data structures and main loop </title>
-
-    <para>
-Important data structures are defined in <filename> include/video.h
-</filename> and <filename> include/video_output.h</filename>. The main
-data structure is <type> picture_t</type>, which describes everything a
-video decoder thread needs. Please refer to this file for more
-information. Typically, <parameter> p_data </parameter> will be a
-pointer to YUV planar picture.
-    </para>
-
-    <para>
-Note also the <type> subpicture_t </type> structure. In fact the VLC SPU
-decoder only parses the SPU header, and converts the SPU graphical data
-to an internal format which can be rendered much faster. So a part of
-the "real" SPU decoder lies in
-<filename> src/video_output/video_spu.c</filename>.
-    </para>
-
-    <para>
-The <type> vout_thread_t </type> structure is much more complex, but
-you needn't understand everything. Basically the video output thread
-manages a heap of pictures and subpictures (5 by default). Every
-picture has a status (displayed, destroyed, empty...) and eventually
-a presentation time. The main job of the video output is an infinite
-loop to : [this is subject to change in the near future]
-    </para>
-
-    <orderedlist>
-
-      <listitem> <para> Find the next picture to display in the heap.
-      </para> </listitem>
-
-      <listitem> <para> Find the current subpicture to display.
-      </para> </listitem>
-
-      <listitem> <para> Render the picture (if the video output plug-in
-      doesn't support YUV overlay). Rendering will call an optimized
-      YUV plug-in, which will also do the scaling, add subtitles and
-      an optional picture information field.
-      </para> </listitem>
-
-      <listitem> <para> Sleep until the specified date.
-      </para> </listitem>
-
-      <listitem> <para> Display the picture (plug-in function). For
-      outputs which display RGB data, it is often accomplished with
-      a buffer switching. <parameter> p_vout-&gt;p_buffer </parameter>
-      is an array of two buffers where the YUV transform takes place,
-      and p_vout-&gt;i_buffer_index indicates the currently displayed
-      buffer.
-      </para> </listitem>
-
-      <listitem> <para> Manage events.
-      </para> </listitem>
-
-    </orderedlist>
-
-  </sect1>
-
-  <sect1> <title> Methods used by video decoders </title>
-
-    <para>
-The video output exports a bunch of functions so that decoders can send
-their decoded data. The most important function is
-<function>vout_CreatePicture</function> which allocates the picture
-buffer to the size indicated by the video decoder. It then just needs
-to feed <type> (void *) </type><parameter> p_picture-&gt;p_data </parameter>
-with the decoded data, and call <function> vout_DisplayPicture </function>
-and <function> vout_DatePicture </function> upon necessary.
-    </para>
-
-    <itemizedlist>
-
-      <listitem> <para> <type> picture_t * </type> <function>
-      vout_CreatePicture </function>
-      <parameter> ( vout_thread_t *p_vout, int i_type, int i_width,
-      int i_height ) </parameter> :
-      Returns an allocated picture buffer. <parameter> i_type </parameter>
-      will be for instance <constant> YUV_420_PICTURE</constant>, and
-      i_width and i_height are in pixels.
-      </para>
-
-      <warning> <para> If no picture is available in the heap,
-      <function> vout_CreatePicture </function> will return NULL.
-      </para> </warning>
-      </listitem>
-
-      <listitem> <para> <function> vout_LinkPicture </function>
-      <parameter> ( vout_thread_t *p_vout, picture_t *p_pic ) </parameter> :
-      Increases the refcount of the picture, so that it doesn't get
-      accidently freed while the decoder still needs it. For instance,
-      an I or P picture can still be needed after displaying to decode
-      interleaved B pictures.
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_UnlinkPicture </function>
-      <parameter> ( vout_thread_t *p_vout, picture_t *p_pic ) </parameter> :
-      Decreases the refcount of the picture. An unlink must be done
-      for every link previously made.
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_DatePicture </function>
-      <parameter> ( vout_thread_t *p_vout, picture_t *p_pic ) </parameter> :
-      Gives the picture a presentation date. You can start working on
-      a picture before knowing precisely at what time it will be
-      displayed. For instance to date an I or P picture, you must wait
-      until you have decoded all previous B pictures (which are
-      indeed placed after - decoding order != presentation order).
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_DisplayPicture </function>
-      <parameter> ( vout_thread_t *p_vout, picture_t *p_pic ) </parameter> :
-      Tells the video output that a picture has been completely decoded
-      and is ready to be rendered. It can be called before or after
-      <function> vout_DatePicture</function>.
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_DestroyPicture </function>
-      <parameter> ( vout_thread_t *p_vout, picture_t *p_pic ) </parameter> :
-      Marks the picture as empty (useful in case of a stream parsing
-      error).
-      </para> </listitem>
-
-      <listitem> <para> <type> subpicture_t * </type> <function>
-      vout_CreateSubPicture </function> <parameter> ( vout_thread_t *p_vout,
-      int i_channel, int i_type ) </parameter> :
-      Returns an allocated subpicture buffer. <parameter> i_channel
-      </parameter> is the ID of the subpicture channel, <parameter> i_type
-      </parameter> is <constant> DVD_SUBPICTURE </constant> or
-      <constant> TEXT_SUBPICTURE</constant>, <parameter> i_size
-      </parameter> is the length in bytes of the packet.
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_DisplaySubPicture </function>
-      <parameter> ( vout_thread_t *p_vout, subpicture_t *p_subpic )
-      </parameter> :
-      Tells the video output that a subpicture has been completely
-      decoded. It obsoletes the previous subpicture.
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_DestroySubPicture </function>
-      <parameter> ( vout_thread_t *p_vout, subpicture_t *p_subpic )
-      </parameter> :
-      Marks the subpicture as empty.
-      </para> </listitem>
-
-    </itemizedlist>
-
-  </sect1>
-
-  <sect1> <title> How to write a video output plug-in </title>
-
-    <para>
-A video output takes care of the system calls to display the pictures and
-manage the output window. Have a look at <filename>
-plugins/x11/vout_x11.c</filename>. You must write the following
-functions :
-    </para>
-
-    <orderedlist>
-
-      <listitem> <para> <type> int </type> <function> vout_Probe </function>
-      <parameter> ( probedata_t *p_data ) </parameter> :
-      Returns a score between 0 and 999 to indicate whether it can
-      run on the architecture. 999 is the best. <parameter> p_data
-      </parameter> is currently unused.
-      </para> </listitem>
-
-      <listitem> <para> <type> int </type> <function> vout_Create </function>
-      <parameter> ( vout_thread_t *p_vout ) </parameter> :
-      Basically, initializes and opens a new window. Returns TRUE if
-      it failed.
-      </para> </listitem>
-
-      <listitem> <para> <type> int </type> <function> vout_Init </function>
-      <parameter> ( vout_thread_t *p_vout ) </parameter> :
-      Creates optional picture buffers (for instance ximages or
-      xvimages). Returns TRUE if it failed.
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_End </function> <parameter>
-      ( vout_thread_t *p_vout ) </parameter> :
-      Frees optional picture buffers.
-      </para> </listitem>
-
-      <listitem> <para> <type> int </type> <function> vout_Manage
-      </function> <parameter> ( vout_thread_t *p_vout ) </parameter> :
-      Manages events (including for instance resize events).
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_Display </function> <parameter>
-      ( vout_thread_t *p_vout ) </parameter> :
-      Displays a previously rendered buffer.
-      </para> </listitem>
-
-      <listitem> <para> <function> vout_SetPalette </function>
-      <parameter> ( vout_thread_t *p_vout, u16 *red, u16 *green,
-      u16 *blue, u16 *transp ) </parameter> :
-      Sets the 8 bpp palette. <parameter> red, green </parameter>
-      and <parameter> blue </parameter> are arrays of 256 <type>
-      unsigned shorts</type>.
-      </para> </listitem>
-
-    </orderedlist>
-
-  </sect1>
-
-  <sect1> <title> How to write a YUV plug-in </title>
-
-    <para>
-Look at the C source <filename> plugins/yuv/transforms_yuv.c</filename>.
-You need to redefine just the same transformations. Basically, it is a
-matrix multiply operation. Good luck.
-    </para>
-
-  </sect1>
-
-</chapter>

doc/developer/videolan-doc-chunk.xsl

-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0' xmlns="http://www.w3.org/TR/xhtml1/transitional" exclude-result-prefixes="#default">
-
-<xsl:import href="/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/xhtml/chunk.xsl"/>
-
-<xsl:variable name="toc.section.depth">1</xsl:variable>
-<xsl:param name="chunker.output.encoding" select="'UTF-8'"/>
-<xsl:param name="chunk.section.depth" select="0"/>
-<xsl:param name="html.stylesheet" select="'../screen.css'"/>
-
-
-</xsl:stylesheet>
-

doc/developer/videolan-doc.xsl

-<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version='1.0' xmlns="http://www.w3.org/TR/xhtml1/transitional" exclude-result-prefixes="#default">
-
-<xsl:import href="/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/xhtml/docbook.xsl"/>
-
-<xsl:param name="html.stylesheet" select="'../screen.css'"/>
-<xsl:param name="toc.section.depth" select="1"/>
-<xsl:param name="generate.toc" select="'book toc chapter nop'"/>
-
-<xsl:output method="xml" encoding="UTF-8" indent="yes" doctype-public="-//W3C//DTD XHTML 1.0 Transitional//EN" doctype-system="http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"/>
-
-</xsl:stylesheet>
-