diff --git a/LDP/ref/docbook/VLC-User-Guide/VLC-User-Guide.sgml b/LDP/ref/docbook/VLC-User-Guide/VLC-User-Guide.sgml
new file mode 100644
index 00000000..bd5c5fc9
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/VLC-User-Guide.sgml
@@ -0,0 +1,103 @@
+
+ %magic-entities;
+
+
+
+
+
+
+
+
+
+
+
+]>
+
+
+
+
+
+VLC User Guide
+
+
+
+ Henri
+ Fallon
+
+
+ Alexis
+ de Lattre
+
+
+ Johan
+ Bilien
+
+
+ Anil
+ Daoud
+
+
+ Mathieu
+ Gautier
+
+
+ Clément
+ Stenac
+
+
+
+
+ 2002, 2003
+ the VideoLAN project
+
+
+
+
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation ; with no
+Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
+Texts. The text of the license can be found in the appendix
+.
+
+
+
+
+ VideoLAN
+ Client
+ vlc
+ vls
+ vod
+ vlcs
+ stream
+ multicast
+ MPEG 1
+ MPEG 2
+ MPEG 4
+ DVD
+ DivX
+
+
+
+
+This document is the complete user guide of VLC, the VideoLAN Client.
+
+
+
+
+
+
+
+
+
+&intro;
+&modules;
+&install;
+&gui;
+&cmdline;
+&fdl;
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/cmdline.sgml b/LDP/ref/docbook/VLC-User-Guide/cmdline.sgml
new file mode 100644
index 00000000..d2e52153
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/cmdline.sgml
@@ -0,0 +1,336 @@
+The Command Line Interface
+
+Introduction
+
+Many options are only available through command line. They are
+detailed here.
+
+
+
+Opening streams
+
+The following commands start VLC and add the first element to the
+playlist.
+
+Opening a file
+
+Start VLC with :
+
+
+% vlc my_file.mpg
+
+
+Although VLC should be able to recognize the file
+type, you may tell VLC what codec to use with the
+--codec option. For example to play
+my_file.mpg using ffmpeg audo/video decoder do :
+
+
+% vlc --codec ffmpeg my_file.mpg
+
+
+A list of all video and audio codecs supported by VLC is available
+on the VLC
+features list
+
+
+
+Opening a DVD or VCD
+
+Start VLC with :
+
+
+% vlc dvd:[device][@raw_device][@[title][,[chapter][,angle]]]
+
+
+or
+
+
+% vlc vcd:[device][@[title][,[chapter]
+
+
+where device is the complete path to your DVD or CD-ROM drive.
+
+Start a network stream
+
+To receive an unicast UDP stream (sent by VLS or VLC's stream
+output), start VLC with :
+
+
+% vlc udp:[@:server_port]
+
+
+To receive a multicast UDP stream (sent by VLS or VLC's
+stream output), start VLC with :
+
+
+% vlc udp:@multicast_address[:server_port]
+
+
+To receive a HTTP stream, start VLC with :
+
+
+% vlc http://www.example.org/your_file.mpg
+
+
+
+
+
+Modules selection
+
+VLC tries to select the most appropriate interface, input and
+output modules, among the ones available on the system, according to the
+stream it is given to read. However, you may wish to force the use of a
+specific module with the following options (for the complete list of
+modules, see the section) :
+
+
+
+--intf <module>
+allows you to select the interface module.
+--aout <module>
+allows you to select the audio output module.
+--vout <module>
+allows you to select the video output module.
+--filter <module>
+allows you to add a video filter module.
+--memcpy <module>
+allows you to choose a memory copy module.
+--access <module>
+allows you to force the access module.
+--demux <module>
+allows you to force the demux module.
+
+
+
+
+Stream Output
+
+Stream output is a new feature of VLC, which allows you to save
+the video that you are watching to a file, or to stream it in UDP.
+
+
+
+--sout <string>
+enables stream output to string
+(string can be either a file name or a ip
+adress).
+
+--no-sout-audio disables audio
+stream output.
+
+--no-sout-video disables video
+stream output.
+
+--sout-acodec
+[|mpeg1|mpeg2|mpeg4|vorbis] allows you to force audio
+encoding.
+
+--sout-vcodec [|mpeg1|mpeg2|mpeg4]
+allows you to force video encoding.
+
+--packetizer <string> allows
+you to select the order in which VLC will select its packetizers.
+
+--mux <string> lets you
+configure mux modules.
+
+--access_output <string> lets
+you configure access output modules.
+
+
+
+
+
+Other Options
+
+Audio options
+
+
+--noaudio disables audio
+output.
+--mono forces VLC to treat the
+stream in mono audio.
+--volume <integer> sets the
+level of audio output.
+--aout-rate <integer> sets
+the audio output frequency (Hz).
+--desync <integer>
+compensates desynchronization of audio (ms).
+--headphone activates headphone
+virtual spatialization effect.
+--headphone-dim sets headphone
+characteristic dimension.
+
+
+
+
+Video options
+
+
+
+--novideo disables video
+output.
+
+--greyscale turns video output into
+greyscale mode.
+
+--fullscreen sets fullscreen
+video.
+
+--nooverlay disables hardware
+acceleration for the video output.
+
+--width, --height <integer>
+sets the video window dimensions.
+
+--zoom <float> adds a zoom
+factor.
+
+--aspect-ratio <mode> forces
+source aspect ratio.
+
+--spumargin <integer> forces
+SPU subtitles postion.
+
+
+
+
+
+Playlist options
+
+
+
+--playlist launches playlist on
+startup.
+
+--random plays files randomly
+forever.
+
+--enqueue enqueues items in
+playlist.
+
+--loop loops playlist on end.
+
+
+
+
+
+Network options
+
+
+
+--server-port <integer> sets
+server port.
+
+--network-channel enables network
+channel mode.
+
+--channel-server <string>
+specifies the channel server address.
+
+--channel-port <integer>
+specifies the channel server port.
+
+--iface <string> specifies
+the network interface to use.
+
+--iface-addr <string>
+specifies your network interface IP address.
+
+--mtu <integer> specifies
+the MTU of the network interface.
+
+--ipv6 forces IPv6.
+
+--ipv4 forces IPv4.
+
+
+
+
+
+CPU options
+
+
+
+--nommx disables the use of MMX CPU
+extensions.
+
+--no3dn disables the use of 3D Now!
+CPU extensions.
+
+--nommxext disables the use of MMX
+ext CPU extensions.
+
+--nosse disables the use of SSE
+CPU extensions.
+
+
+
+
+
+Miscellaneous options
+
+
+
+--quiet be quiet.
+
+--color displays color messages.
+
+--search-path <string>
+specifies interface default search path.
+
+--plugin-path <string>
+specifies plugin search path.
+
+--dvd <string>
+specifies the default dvd device.
+
+--vcd <string>
+specifies the default vcd device.
+
+--program <integer> specifies
+program (SID) (for streams with several programs, like satellite ones).
+
+--audio-type <integer>
+specifies the default audio type to use with dvds.
+
+--audio-channel <integer>
+specifies the default audio channel to use with dvds.
+
+--spu-channel <integer>
+specifies the default subtitle channel to use with dvds.
+
+
+
+
+
+Help options
+
+
+
+--verbose <verbosity>
+specifies verbosity level.
+
+--help gives you all available
+options.
+
+--longhelp gives you a detailled
+version of the available options.
+
+--version gives you information
+about the current VLC version.
+
+--list displays a list of available
+plugins.
+
+--module <module> displays
+help about specified module.
+
+
+
+
+
+
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/fdl.sgml b/LDP/ref/docbook/VLC-User-Guide/fdl.sgml
new file mode 100644
index 00000000..811aa1ee
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/fdl.sgml
@@ -0,0 +1,431 @@
+
+GNU Free Documentation License
+Version 1.2, November 2002
+
+
+ Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
+59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+Everyone is permitted to copy and distribute verbatim copies
+of this license document, but changing it is not allowed.
+
+
+PREAMBLE
+
+The purpose of this License is to make a manual, textbook, or
+other functional and useful document "free" in the sense of freedom: to
+assure everyone the effective freedom to copy and redistribute it, with
+or without modifying it, either commercially or noncommercially.
+Secondarily, this License preserves for the author and publisher a way
+to get credit for their work, while not being considered responsible for
+modifications made by others.
+
+This License is a kind of "copyleft", which means that derivative
+works of the document must themselves be free in the same sense. It
+complements the GNU General Public License, which is a copyleft license
+designed for free software.
+
+We have designed this License in order to use it for manuals for
+free software, because free software needs free documentation: a free
+program should come with manuals providing the same freedoms that the
+software does. But this License is not limited to software manuals; it
+can be used for any textual work, regardless of subject matter or
+whether it is published as a printed book. We recommend this License
+principally for works whose purpose is instruction or reference.
+
+
+APPLICABILITY AND DEFINITIONS
+
+This License applies to any manual or other work, in
+any medium, that contains a notice placed by the copyright holder saying
+it can be distributed under the terms of this License. Such a notice
+grants a world-wide, royalty-free license, unlimited in duration, to use
+that work under the conditions stated herein. The "Document", below,
+refers to any such manual or work. Any member of the public is a
+licensee, and is addressed as "you". You accept the license if you
+copy, modify or distribute the work in a way requiring permission under
+copyright law.
+
+A "Modified Version" of the Document means any
+work containing the Document or a portion of it, either copied verbatim,
+or with modifications and/or translated into another language.
+
+A "Secondary Section" is a named appendix or
+a front-matter section of the Document that deals exclusively with the
+relationship of the publishers or authors of the Document to the
+Document's overall subject (or to related matters) and contains nothing
+that could fall directly within that overall subject. (Thus, if the
+Document is in part a textbook of mathematics, a Secondary Section may
+not explain any mathematics.) The relationship could be a matter of
+historical connection with the subject or with related matters, or of
+legal, commercial, philosophical, ethical or political position
+regarding them.
+
+The "Invariant Sections" are certain Secondary
+Sections whose titles are designated, as being those of Invariant
+Sections, in the notice that says that the Document is released under
+this License. If a section does not fit the above definition of
+Secondary then it is not allowed to be designated as Invariant. The
+Document may contain zero Invariant Sections. If the Document does not
+identify any Invariant Sections then there are none.
+
+The "Cover Texts" are certain short passages of
+text that are listed, as Front-Cover Texts or Back-Cover Texts, in the
+notice that says that the Document is released under this License. A
+Front-Cover Text may be at most 5 words, and a Back-Cover Text may be at
+most 25 words.
+
+A "Transparent" copy of the Document means a
+machine-readable copy, represented in a format whose specification is
+available to the general public, that is suitable for revising the
+document straightforwardly with generic text editors or (for images
+composed of pixels) generic paint programs or (for drawings) some widely
+available drawing editor, and that is suitable for input to text
+formatters or for automatic translation to a variety of formats suitable
+for input to text formatters. A copy made in an otherwise Transparent
+file format whose markup, or absence of markup, has been arranged to
+thwart or discourage subsequent modification by readers is not
+Transparent. An image format is not Transparent if used for any
+substantial amount of text. A copy that is not "Transparent" is called
+"Opaque".
+
+Examples of suitable formats for Transparent copies include plain
+ASCII without markup, Texinfo input format, LaTeX input format, SGML or
+XML using a publicly available DTD, and standard-conforming simple HTML,
+PostScript or PDF designed for human modification. Examples of
+transparent image formats include PNG, XCF and JPG. Opaque formats
+include proprietary formats that can be read and edited only by
+proprietary word processors, SGML or XML for which the DTD and/or
+processing tools are not generally available, and the machine-generated
+HTML, PostScript or PDF produced by some word processors for output
+purposes only.
+
+The "Title Page" means, for a printed book,
+the title page itself, plus such following pages as are needed to hold,
+legibly, the material this License requires to appear in the title page.
+For works in formats which do not have any title page as such, "Title
+Page" means the text near the most prominent appearance of the work's
+title, preceding the beginning of the body of the text.
+
+A section "Entitled XYZ" means a named subunit
+of the Document whose title either is precisely XYZ or contains XYZ in
+parentheses following text that translates XYZ in another language.
+(Here XYZ stands for a specific section name mentioned below, such as
+"Acknowledgements", "Dedications", "Endorsements", or "History".) To
+"Preserve the Title" of such a section when you modify the Document
+means that it remains a section "Entitled XYZ" according to this
+definition.
+
+The Document may include Warranty Disclaimers next to the notice
+which states that this License applies to the Document. These Warranty
+Disclaimers are considered to be included by reference in this License,
+but only as regards disclaiming warranties: any other implication that
+these Warranty Disclaimers may have is void and has no effect on the
+meaning of this License.
+
+
+VERBATIM COPYING
+
+You may copy and distribute the Document in any medium, either
+commercially or noncommercially, provided that this License, the
+copyright notices, and the license notice saying this License applies to
+the Document are reproduced in all copies, and that you add no other
+conditions whatsoever to those of this License. You may not use
+technical measures to obstruct or control the reading or further copying
+of the copies you make or distribute. However, you may accept
+compensation in exchange for copies. If you distribute a large enough
+number of copies you must also follow the conditions in section 3.
+
+
+You may also lend copies, under the same conditions stated above,
+and you may publicly display copies.
+
+
+COPYING IN QUANTITY
+
+If you publish printed copies (or copies in media that commonly
+have printed covers) of the Document, numbering more than 100, and the
+Document's license notice requires Cover Texts, you must enclose the
+copies in covers that carry, clearly and legibly, all these Cover Texts:
+Front-Cover Texts on the front cover, and Back-Cover Texts on the back
+cover. Both covers must also clearly and legibly identify you as the
+publisher of these copies. The front cover must present the full title
+with all words of the title equally prominent and visible. You may add
+other material on the covers in addition. Copying with changes limited
+to the covers, as long as they preserve the title of the Document and
+satisfy these conditions, can be treated as verbatim copying in other
+respects.
+
+If the required texts for either cover are too voluminous to fit
+legibly, you should put the first ones listed (as many as fit
+reasonably) on the actual cover, and continue the rest onto adjacent
+pages.
+
+If you publish or distribute Opaque copies of the Document
+numbering more than 100, you must either include a machine-readable
+Transparent copy along with each Opaque copy, or state in or with each
+Opaque copy a computer-network location from which the general
+network-using public has access to download using public-standard
+network protocols a complete Transparent copy of the Document, free of
+added material. If you use the latter option, you must take reasonably
+prudent steps, when you begin distribution of Opaque copies in quantity,
+to ensure that this Transparent copy will remain thus accessible at the
+stated location until at least one year after the last time you
+distribute an Opaque copy (directly or through your agents or retailers)
+of that edition to the public.
+
+It is requested, but not required, that you contact the authors of
+the Document well before redistributing any large number of copies, to
+give them a chance to provide you with an updated version of the
+Document.
+
+
+MODIFICATIONS
+
+You may copy and distribute a Modified Version of the Document
+under the conditions of sections 2 and 3 above, provided that you
+release the Modified Version under precisely this License, with the
+Modified Version filling the role of the Document, thus licensing
+distribution and modification of the Modified Version to whoever
+possesses a copy of it. In addition, you must do these things in the
+Modified Version:
+
+
+Use in the Title Page (and on the covers, if any) a
+ title distinct from that of the Document, and from those of previous
+ versions (which should, if there were any, be listed in the History
+ section of the Document). You may use the same title as a previous
+ version if the original publisher of that version gives permission.
+
+List on the Title Page, as authors, one or more
+ persons or entities responsible for authorship of the modifications in
+ the Modified Version, together with at least five of the principal
+ authors of the Document (all of its principal authors, if it has fewer
+ than five), unless they release you from this requirement.
+
+State on the Title page the name of the publisher of
+ the Modified Version, as the publisher.
+Preserve all the copyright notices of the Document.
+
+Add an appropriate copyright notice for your
+ modifications adjacent to the other copyright notices.
+
+Include, immediately after the copyright notices, a
+ license notice giving the public permission to use the Modified
+ Version under the terms of this License, in the form shown in the
+ Addendum below.
+
+Preserve in that license notice the full lists of
+ Invariant Sections and required Cover Texts given in the Document's
+ license notice.
+Include an unaltered copy of this License.
+
+Preserve the section Entitled "History", Preserve its
+ Title, and add to it an item stating at least the title, year, new
+ authors, and publisher of the Modified Version as given on the Title
+ Page. If there is no section Entitled "History" in the Document,
+ create one stating the title, year, authors, and publisher of the
+ Document as given on its Title Page, then add an item describing the
+ Modified Version as stated in the previous sentence.
+
+Preserve the network location, if any, given in the
+ Document for public access to a Transparent copy of the Document, and
+ likewise the network locations given in the Document for previous
+ versions it was based on. These may be placed in the "History"
+ section. You may omit a network location for a work that was
+ published at least four years before the Document itself, or if the
+ original publisher of the version it refers to gives permission.
+
+For any section Entitled "Acknowledgements" or
+ "Dedications", Preserve the Title of the section, and preserve in the
+ section all the substance and tone of each of the contributor
+ acknowledgements and/or dedications given therein.
+
+Preserve all the Invariant Sections of the Document,
+ unaltered in their text and in their titles. Section numbers or the
+ equivalent are not considered part of the section titles.
+
+Delete any section Entitled "Endorsements".
+ Such a section may not be included in the Modified Version.
+
+Do not retitle any existing section to be Entitled
+ "Endorsements" or to conflict in title with any Invariant Section.
+
+Preserve any Warranty Disclaimers.
+
+
+
+If the Modified Version includes new front-matter sections or
+appendices that qualify as Secondary Sections and contain no material
+copied from the Document, you may at your option designate some or all
+of these sections as invariant. To do this, add their titles to the
+list of Invariant Sections in the Modified Version's license notice.
+These titles must be distinct from any other section titles.
+
+You may add a section Entitled "Endorsements", provided it
+contains nothing but endorsements of your Modified Version by various
+parties--for example, statements of peer review or that the text has
+been approved by an organization as the authoritative definition of a
+standard.
+
+You may add a passage of up to five words as a Front-Cover Text,
+and a passage of up to 25 words as a Back-Cover Text, to the end of the
+list of Cover Texts in the Modified Version. Only one passage of
+Front-Cover Text and one of Back-Cover Text may be added by (or through
+arrangements made by) any one entity. If the Document already includes
+a cover text for the same cover, previously added by you or by
+arrangement made by the same entity you are acting on behalf of, you may
+not add another; but you may replace the old one, on explicit permission
+from the previous publisher that added the old one.
+
+The author(s) and publisher(s) of the Document do not by this
+License give permission to use their names for publicity for or to
+assert or imply endorsement of any Modified Version.
+
+
+COMBINING DOCUMENTS
+
+You may combine the Document with other documents released under
+this License, under the terms defined in section
+4 above for modified versions, provided that you include in the
+combination all of the Invariant Sections of all of the original
+documents, unmodified, and list them all as Invariant Sections of your
+combined work in its license notice, and that you preserve all their
+Warranty Disclaimers.
+
+The combined work need only contain one copy of this License, and
+multiple identical Invariant Sections may be replaced with a single
+copy. If there are multiple Invariant Sections with the same name but
+different contents, make the title of each such section unique by adding
+at the end of it, in parentheses, the name of the original author or
+publisher of that section if known, or else a unique number. Make the
+same adjustment to the section titles in the list of Invariant Sections
+in the license notice of the combined work.
+
+In the combination, you must combine any sections Entitled
+"History" in the various original documents, forming one section
+Entitled "History"; likewise combine any sections Entitled
+"Acknowledgements", and any sections Entitled "Dedications". You must
+delete all sections Entitled "Endorsements".
+
+
+COLLECTIONS OF DOCUMENTS
+
+You may make a collection consisting of the Document and other
+documents released under this License, and replace the individual copies
+of this License in the various documents with a single copy that is
+included in the collection, provided that you follow the rules of this
+License for verbatim copying of each of the documents in all other
+respects.
+
+You may extract a single document from such a collection, and
+distribute it individually under this License, provided you insert a
+copy of this License into the extracted document, and follow this
+License in all other respects regarding verbatim copying of that
+document.
+
+
+AGGREGATION WITH INDEPENDENT WORKS
+
+A compilation of the Document or its derivatives with other
+separate and independent documents or works, in or on a volume of a
+storage or distribution medium, is called an "aggregate" if the
+copyright resulting from the compilation is not used to limit the legal
+rights of the compilation's users beyond what the individual works
+permit. When the Document is included an aggregate, this License does
+not apply to the other works in the aggregate which are not themselves
+derivative works of the Document.
+
+If the Cover Text requirement of section 3 is applicable to these
+copies of the Document, then if the Document is less than one half of
+the entire aggregate, the Document's Cover Texts may be placed on covers
+that bracket the Document within the aggregate, or the electronic
+equivalent of covers if the Document is in electronic form. Otherwise
+they must appear on printed covers that bracket the whole
+aggregate.
+
+
+TRANSLATION
+
+Translation is considered a kind of modification, so you may
+distribute translations of the Document under the terms of section 4.
+Replacing Invariant Sections with translations requires special
+permission from their copyright holders, but you may include
+translations of some or all Invariant Sections in addition to the
+original versions of these Invariant Sections. You may include a
+translation of this License, and all the license notices in the
+Document, and any Warrany Disclaimers, provided that you also include
+the original English version of this License and the original versions
+of those notices and disclaimers. In case of a disagreement between the
+translation and the original version of this License or a notice or
+disclaimer, the original version will prevail.
+
+If a section in the Document is Entitled "Acknowledgements",
+"Dedications", or "History", the requirement (section 4) to Preserve its
+Title (section 1) will typically require changing the actual
+title.
+
+
+TERMINATION
+
+You may not copy, modify, sublicense, or distribute the Document
+except as expressly provided for under this License. Any other attempt
+to copy, modify, sublicense or distribute the Document is void, and will
+automatically terminate your rights under this License. However,
+parties who have received copies, or rights, from you under this License
+will not have their licenses terminated so long as such parties remain
+in full compliance.
+
+
+FUTURE REVISIONS OF THIS LICENSE
+
+The Free Software Foundation may publish new, revised versions of
+the GNU Free Documentation License from time to time. Such new versions
+will be similar in spirit to the present version, but may differ in
+detail to address new problems or concerns. See
+http://www.gnu.org/copyleft/.
+
+Each version of the License is given a distinguishing version
+number. If the Document specifies that a particular numbered version of
+this License "or any later version" applies to it, you have the option
+of following the terms and conditions either of that specified version
+or of any later version that has been published (not as a draft) by the
+Free Software Foundation. If the Document does not specify a version
+number of this License, you may choose any version ever published (not
+as a draft) by the Free Software Foundation.
+
+
+ADDENDUM: How to use this License for
+ your documents
+
+To use this License in a document you have written, include a copy
+of the License in the document and put the following copyright and
+license notices just after the title page:
+
+
+ Copyright (c) YEAR YOUR NAME.
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the GNU Free Documentation License, Version 1.2
+ or any later version published by the Free Software Foundation;
+ with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ A copy of the license is included in the section entitled "GNU
+ Free Documentation License".
+
+
+If you have Invariant Sections, Front-Cover Texts and Back-Cover
+Texts, replace the "with...Texts." line with this:
+
+
+ with the Invariant Sections being LIST THEIR TITLES, with the
+ Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
+
+
+If you have Invariant Sections without Cover Texts, or some other
+combination of the three, merge those two alternatives to suit the
+situation.
+
+If your document contains nontrivial examples of program code, we
+recommend releasing these examples in parallel under your choice of free
+software license, such as the GNU General Public License, to permit
+their use in free software.
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/gui.sgml b/LDP/ref/docbook/VLC-User-Guide/gui.sgml
new file mode 100644
index 00000000..96ec64f9
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/gui.sgml
@@ -0,0 +1,277 @@
+The Graphical User Interface
+
+Opening a stream
+
+To open a stream using the graphical interface, click on either
+:
+
+
+
+"File" to open a file stored on your hard
+drive.
+
+"Disc" to read a DVD or a VCD.
+
+"Network" to read a network UDP stream
+or an HTTP stream.
+
+"Satellite" to read directly from a satellite
+card.
+
+
+
+These four buttons, as well as the ones located in the "File"
+menu, actually open the same dialog box, but on different tabs.
+
+The "open a stream" dialog box
+
+You can specify directly the Media Resource Locator MRL, if you
+know the syntax that you have to use, but you may also use the different
+tabs, that will fill it automatically.
+
+
+
+For a File, this is very simple, you
+only have to fill the path to the file.
+
+For a Disc, you select
+the type of the disk, the path to the drive (looks like
+/dev/dvd on Unix, or D: on
+Windows), and the starting title and chapter.
+
+For a Network stream :
+
+
+
+ if you use unicast mode, select UDP
+ and the port used,
+
+ if you use multicast, select UDP
+ multicast, enter the multicast address and the port ;
+
+ if you have a channel information service with
+ mini-VLCS, select Channel server, and give its
+ address ;
+
+ if you use HTTP streaming
+ to do Video On Demand, select HTTP and give the
+ address of your stream.
+
+
+
+For a Satellite stream, you have to
+give the frequency, the rate, the polarization, and the FEC of your
+stream.
+
+
+
+
+
+Basic stream control
+
+You have at your disposal all the classical control of a video
+player. For example when playing local streams or HTTP streams, you can
+pause, speed up or slow down the stream, go forth and back... Just use
+the corresponding buttons.
+
+To go fullscreen, you can select the right options in the
+view menu, or press f. To go
+back to the normal mode, press f.
+
+
+
+DVD and VCD navigation
+
+When reading a DVD or a VCD, you can change chapter and titles as
+you wish either by using the right-click menu or by using the options in
+the "Parameters" menu. These options are enabled only when you play a
+disk, or a disk through the network.
+
+
+
+Programs, languages and subtitles
+
+When reading a multiprogram stream, you can change the current
+program by selecting it in the "View/Programs" submenu on the bar, or by
+using the "right click" menu from the video output window. You can also
+change the title and the chapter by the same way.
+
+In DVDs, if different angles are availables, they will be treated as
+different programs.
+
+At any time you can change the audio/subtitles channel using either the
+"setting" menu from the interface or using the "right click" menu from
+the video output window.
+
+
+
+
+Preferences window
+
+By choosing "Preferences" in the "Settings" menu, you will open
+the preferences window. This window is generated dynamically according
+to the modules that were compiled.
+
+In every tab, you may click on "Save" to store your
+settings in your configuration file. (you can find it in
+~/.vlc/vlcrc on Unix/Linux systems, or in
+Application Data\vlc\vlcrc
+
+Interface tab
+
+In that tab, you can select which interface you would like
+to use on next start. Click on the choosen interface, click on
+Select then on Save.
+
+There can be some configuration options available by clicking
+Configure. This depends on the interface
+chosen.
+
+There are also a few generic settings, like color message or
+setting the verbosity level of the logs. You can also specify the
+path to the interface or to the plugin if they are not in the default
+directory. [FIX : compare with settings on other OS, where is the
+default file?]
+
+
+
+Audio tab
+
+ In this tab, you can select and configure the audio output
+you would like to use on next start (this works juste like for the
+interface). You may also specify other settings such as enabling
+or disabling the audio output, the output volume level, the audio
+frequency, the number of channels on output, add desynchronization, or
+set audio output format and headphone spazialization effect.
+
+
+
+Video tab
+
+In this tab, you can select which video output will be used on
+next start, and add a video filter module, which means a filter that
+will alter the rendered image. For more information on modules, please
+look the Modules section. You may also specify some video settings, such
+as the window size, if you would like fullscreen display or the video
+zoom.
+
+By using the adjust video filter module, you
+will be able to modify the Brightness, Contrast, Saturation and Hue of
+the video output.
+
+There are also specific modules as wall which cut the output in
+many windows to make a video wall, transform module to rotate the image
+or invert module to invert the colors (who said it's useless?)
+
+
+
+Input tab
+
+In this tab, you can enter the input method with options by
+default that will be used on next start.
+
+Note that these are only default options,
+which means that they will be written in the appropriate field, but, you
+can of course change them.
+
+You can configure the default addresses and port for network
+streaming :
+
+
+the server port for UDP streaming,
+the server port for UDP multicast streaming
+the channel server adress and the channel server if you have a channel information service based on mini-VLCS.
+
+
+Here you also can choose which network interface the videolan
+client will use to get the stream and the address of this interface.
+
+The other options allow you to choose audio, channel, subtitles,
+the device of the DVD, the device of the VCD and the IP protocol of the
+stream (IPv6 or IPv4).
+
+
+
+Decoders tab
+
+In this tab, you can select which decoder (codec) you want to use
+for audio or video decoders. VLC normally automatically detects the
+right codec to use, so be sure to know what you are doing.
+
+
+
+Stream ouput
+
+In this tab you can configure the stream output capabilities.
+
+Stream output is a new feature of VLC which allow you to save
+the stream that you are watching to a file, or to stream it in unicast or multicast.
+
+This tab allows you to set up some options for this. You will
+be able to select the muxer used for the stream, ie PS, TS or AVI. PS
+and TS are parts of the MPEG norm. PS stands for Program Stream, it is
+usually used for files, whereas TS stands for Transport Stream, which
+is rather used for network streams. AVI means output to an AVI file or
+stream.
+
+You may also select the access output,
+i.e. what the strem will be output to. You can choose
+beetween UDP (network stream) or
+file.
+
+The Packetizer is the format of the output.
+
+You can also enable or disable audio or video.
+
+
+
+CPU tab
+
+This tab is dedicated to enabling or disabling support for
+CPU extensions: MMX support (every processors since Pentium MMX),
+3D! Now Support (for AMD K6-2, K6-3, Athlon and Duron processors),
+MMX EXT support, and SSE support (for Pentium III and Pentium IV
+processors).
+
+
+
+Playlist tab
+
+In this tab, you can select some playlist options, such as looping
+the playlist, automatically launching the playlist on VLC's start, enqueue
+items in it or randomly read the files.
+
+
+
+Miscellanous tab
+
+ In this tab, you can select which memcpy version you want to use.
+Some of them uses MMX or 3Dnow! extensions. You can also select the
+access module (module used to get the stream) and the the demux module
+(used to ... demux the stream).
+
+
+
+
+Miscellaneous
+
+The Messages Window
+
+This window is available by clicking on
+Messages in the View menu. It
+shows all the debug messages of VLC. If you have a problem with VLC,
+don't hesitate to open this window, as it may contain an interesting
+error message.
+
+
+
+The Playlist
+
+VLC includes a simple playlist management system. By using the
+buttons which are in the playlist window, you can easily add or remove
+streams (whether these are files, disks, network streams, or satellites
+streams).
+
+
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/install-vlc.sgml b/LDP/ref/docbook/VLC-User-Guide/install-vlc.sgml
new file mode 100644
index 00000000..00b195f4
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/install-vlc.sgml
@@ -0,0 +1,240 @@
+There are VLC binaries available for the many OSes, but not for
+all supported OSes. If there are no binaries for your OS or if you want
+to change the default settings, you can compile VLC from sources.
+
+
+Under Windows
+
+VLC works under Windows 95/98/ME/2000/XP.
+Download the Zipip file from the VLC Windows
+download page. Unzip the file in a directory to install
+VLC.
+
+
+
+Under BeOS
+
+
+Download the Zip file from the VLC BeOS download
+page. Unzip the file in a directory to install VLC.
+
+
+
+
+Under Mac OS X
+
+
+
+Download the Mac OS X package from the VLC
+MacOS X download page . Double-click on the icon of the
+package : an icon will appear on your Desktop, right beside your
+drive(s). Open it and drag the VLC application from the resulting
+window to the place where you want to install it (it should be
+/Applications).
+
+
+
+
+
+Under Linux Debian
+
+Edit as root /etc/apt/sources.list and add
+the following lines :
+
+
+deb http://www.videolan.org/pub/videolan/debian $(ARCH)/
+deb-src http://www.videolan.org/pub/videolan/debian sources/
+
+
+Then install the packages :
+
+
+# apt-get update
+# apt-get install gnome-vlc vlc-plugin-a52 vlc-plugin-mad vlc-plugin-ogg libdvdcss2
+
+
+
+Under Linux Redhat, Mandrake and SuSE
+
+For these distributions, use the RPM packages.
+
+First, install the packages liba52 and
+libmad0 that should be packaged in your
+distribution. If they are not, try to find the RPMs on RPMfind.net or search
+the Internet.
+
+
+
+Download the RPM packages of libdvdcss2,
+libdvdpsi1, vlc
+gnome-vlc, vlc-plugin-mad, vlc-plugin-ogg, vlc-plugin-a52 from the
+VLC Linux
+download page.
+
+
+
+
+Then install the RPM packages you have downloaded:
+
+
+
+# rpm -Uhv vlc-version.i586.rpm gnome-vlc-version.i586.rpm vlc-plugin-mad-version.i586.rpm
+vlc-plugin-ogg-version.i586.rpm vlc-plugin-a52-version.i586.rpm libdvdcss2-version.i586.rpm libdvdpsi1-version.i586.rpm
+
+
+
+
+Compile the sources by yourself (for every other OS)
+
+The method below is for any Unix system supported by VLC, for
+which there is no packages available. It explains how to compile and
+install VLC and the needed librairies from their source code.
+
+You can also compile the VLC under Linux this way if you want to
+modify the default supported modules
+
+Install the libraries
+
+Many libraries are needed for particular uses :
+
+
+
+
+libdvdcss if you want to be able to
+read encrypted DVDs,
+
+libdvdplay if you want to have DVD
+menu navigation,
+
+libdvbpsi if you want to be able to
+read from the network,
+
+a52dec if you want to be
+able to decode the AC3 (i.e. A52) sound format often used in
+DVDs,
+
+ffmpeg, libmad
+and faad2 if you want to read MPEG 4 / DivX
+files,
+
+libogg and
+libvorbis if you want to read Ogg Vorbis
+files.
+
+
+
+Download the libraries from VLC sources
+download page.
+
+For each library :
+
+
+
+uncompress :
+
+
+% tar xvzf library.tar.gz
+
+or
+
+% tar xvjf library.tar.bz2
+
+
+configure :
+
+
+% cd library
+% ./configure --enable-shared
+
+
+compile and install :
+
+
+% make
+# make install
+
+
+
+
+
+Check that the configuration file /etc/ld.so.conf
+contains the following line :
+
+
+
+/usr/local/lib
+
+
+If the line is not present, add-it and then run (as root):
+
+
+# ldconfig
+
+
+
+
+Install VLC
+
+Download the sources of the lastest release : get the
+file vlc-version.tar.gz from the VLC sources
+download page. Uncompress-it :
+
+
+% tar xvzf vlc-version.tar.gz
+% cd vlc-version
+
+
+
+
+To get the list of configuration options, do :
+
+% ./configure --help
+
+
+Please note that all the modules are described in
+the Modules section of the VLC User
+Guide.
+
+
+Examples of very simple configurations:
+
+
+if you want a basic VLC, do :
+
+% ./configure
+
+
+
+if you want the Gnome interface instead of the GTK
+interface (you will need the developement packages of Gnome) :
+
+% ./configure --enable-gnome
+
+
+
+
+
+
+Then, compile and install :
+
+
+
+% make
+% su
+Password: [Root Password]
+# make install
+
+
+Please note that the installation (make install
+command) is not mandatory. You can execute VLC from where you compiled
+it.
+
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/install-vls.sgml b/LDP/ref/docbook/VLC-User-Guide/install-vls.sgml
new file mode 100644
index 00000000..e688cb62
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/install-vls.sgml
@@ -0,0 +1,226 @@
+
+
+Under Linux or Unix
+
+The method below is for any Unix or Linux supported by the
+Videolan Server. It explains how to compile and install vls and the
+needed librairies from sources.
+
+Install the librairies
+
+
+Many librairies are needed for particular uses :
+
+
+
+libdvbpsi (always needed)
+libdvdcss if you want to be able to access encrypted DVDs,
+libdvdread if you want to be able to stream DVDs.
+
+
+
+
+Download the libraries from in the directory
+version/contrib.
+
+
+
+
+For each librairie, uncompress, configure, compile and install :
+
+
+
+
+% tar xvzf library.tar.gz
+% cd library
+% ./configure --enable-shared
+% make
+# make install
+
+
+
+
+
+Check that the configuration file /etc/ld.so.conf
+contains the following line :
+
+
+
+
+/usr/local/lib
+
+
+If the line is not present, add-it and then run :
+
+
+# ldconfig
+
+
+
+
+Install the VideoLAN Server
+
+
+
+
+
+Get the most recent version of the VideoLAN Server from the public CVS :
+
+
+
+
+% cvs -d:pserver:anonymous@cvs.videolan.org:/cvs/videolan login
+
+
+
+There is no password. Type enter, then :
+
+
+
+% cvs -d:pserver:anonymous@cvs.videolan.org:/cvs/videolan checkout -P -r v0_4_5 vls
+
+
+
+To get the list of configuration options, do :
+
+
+
+% ./configure --help
+
+
+
+Then configure vls :
+
+
+
+
+if you want a basic vls without DVD support, do :
+
+
+
+% ./configure --disable-dvd
+
+
+
+
+if you want a full vls with DVD support, do :
+
+
+
+% ./configure
+
+
+
+
+
+
+
+Then, compile and install :
+
+
+
+% make
+# make install
+
+
+
+
+You can also do a make uninstall, make
+clean or make distclean as needed.
+
+
+
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/install.sgml b/LDP/ref/docbook/VLC-User-Guide/install.sgml
new file mode 100644
index 00000000..6977aea6
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/install.sgml
@@ -0,0 +1,13 @@
+Installing VLC
+
+
+Installing VLC
+&install-vlc;
+
+
+Uninstalling VLC
+&uninstall-vlc;
+
+
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/intro.sgml b/LDP/ref/docbook/VLC-User-Guide/intro.sgml
new file mode 100644
index 00000000..5f00e06a
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/intro.sgml
@@ -0,0 +1,261 @@
+Introduction
+
+What is the VideoLAN project ?
+
+Overview
+
+
+
+VideoLAN is a complete software solution for video streaming, developed
+by students of the Ecole Centrale
+Paris and developers from all over the world, under the
+GNU General Public
+License (GPL). VideoLAN is designed to stream MPEG videos on high
+bandwidth networks.
+
+
+
+
+
+The VideoLAN solution includes :
+
+
+
+
+
+the VideoLAN Server (VLS), which can stream MPEG 1 and 2
+files, DVDs, digital satellite channels, digital terrestial television
+channels and live videos on the network in unicast or multicast,
+
+the VideoLAN Client (VLC), which can be used as a server
+to stream MPEG 1, 2 and 4 files and DVDs on the network in unicast or
+multicast ; or used as a client to receive, decode and display MPEG streams
+under multiple operating systems.
+
+
+
+
+
+Here is an illustration of the complete VideoLAN solution :
+
+
+
+
+
+
+
+More details about the project can be found on the
+VideoLAN Web site.
+
+
+
+VideoLAN software
+
+VideoLAN Client
+
+
+
+The VideoLAN Client (VLC) works on many platforms : Linux, Windows, Mac
+OS X, BeOS, *BSD, Solaris, Familiar Linux and QNX. It can read :
+
+
+
+
+
+MPEG 1, MPEG 2 and MPEG 4 / DivX files from a hard disk
+or a CD-ROM drive,
+
+DVDs and VCDs,
+
+from a satellite card,
+
+MPEG 1, MPEG 2 and MPEG 4 streams from the
+network sent by VLS or VLC's stream output.
+
+
+
+VLC can also be used as a server to stream :
+
+
+
+MPEG 1, MPEG 2 and MPEG 4 / DivX files,
+
+and DVDs,
+
+
+
+to :
+
+
+
+one machine (i.e. to one IP address) : this is called
+unicast ;
+
+a dynamic group of machines that the clients can join or leave
+(i.e. to a multicast IP address) : this is called
+multicast.
+
+
+
+VLC doesn't work on Mac OS 9, and will
+probably never do.
+
+VideoLAN Server
+
+
+
+The VideoLAN Server (VLS) can stream :
+
+
+
+
+
+an MPEG 1 or MPEG 2 file stored on a hard drive or on a
+CD,
+
+a DVD located in a local DVD drive or copied on a hard
+disk,
+
+a satellite card or a digital terrestial television card,
+
+an MPEG encoding card ;
+
+
+
+to :
+
+
+
+one machine (i.e. to one IP address) : this is called
+unicast ;
+
+a dynamic group of machines that the clients can join or leave
+(i.e. to a multicast IP address) : this is called
+multicast.
+
+
+
+
+
+A Pentium 100 MHz with 32 MB of memory should be enough to send one
+stream on the network. When streaming a lot of videos stored on a
+hard drive, the actual limitation is not the processor but the hard
+drive and the network connection.
+
+
+
+
+
+VLS works under Linux and Windows, but only the Linux version
+have all the functionalities. The Windows port of vls can
+only stream a video from a file.
+
+
+
+How can I use VideoLAN ?
+
+The documentation
+
+
+
+The user documentation of the VideoLAN project is composed of four documents :
+
+
+
+
+
+the VideoLAN
+Quickstart. This document will give you a quick overview of
+of VLC, VLS, and the Video On Demand
+solution.
+
+the VideoLAN
+HOWTO. This document is the complete guide of the VideoLAN
+streaming solution.
+
+the VLC user
+guide. This document is the complete guide for VLC.
+
+the VLC FAQ. This
+document contains Frequently Asked Questions of VLC users.
+
+
+
+
+
+
+The latest version of these documents can be found on the VideoLAN Web site.
+
+
+
+User support
+
+
+
+If you have problems using VideoLAN, and if you don't find the
+answer to your problems in the documentation, please look at the
+online archive of the
+mailing-lists. There are two English-speaking mailing-lists for
+the users :
+
+
+
+
+
+vlc@videolan.org for the questions
+on VLC,
+
+streaming@videolan.org for the questions
+on VLS, mini-VLCS and the network.
+
+
+
+
+
+If you want to subscribe or unsubscribe to the mailing-lists,
+please go to the
+mailing-list page.
+
+
+
+You can also talk with VideoLAN users and developers on IRC :
+server irc.freenode.net, channel
+#videolan.
+
+If you find a bug, please follow the instructions on the bug reporting
+page.
+
+Convention
+
+In this document, we adopt the following conventions for the Unix
+commands :
+
+
+
+commands that should be typed as
+root have a # prompt :
+
+
+# command_to_be_typed_as_root
+
+
+commands that should be typed as a regular user have a
+% prompt :
+
+
+% command_to_be_typed_as_regular_user
+
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/magic-eps.sgml b/LDP/ref/docbook/VLC-User-Guide/magic-eps.sgml
new file mode 100644
index 00000000..a75462ae
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/magic-eps.sgml
@@ -0,0 +1 @@
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/magic-jpg.sgml b/LDP/ref/docbook/VLC-User-Guide/magic-jpg.sgml
new file mode 100644
index 00000000..058e7a06
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/magic-jpg.sgml
@@ -0,0 +1 @@
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/magic.sgml b/LDP/ref/docbook/VLC-User-Guide/magic.sgml
new file mode 100644
index 00000000..058e7a06
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/magic.sgml
@@ -0,0 +1 @@
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/modules.sgml b/LDP/ref/docbook/VLC-User-Guide/modules.sgml
new file mode 100644
index 00000000..523a4d86
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/modules.sgml
@@ -0,0 +1,740 @@
+Modules and options for VLC
+
+The modules
+
+VLC uses a modular system, which allows to add easily new fonctions
+and formats. Here is a description of nearly all the VLC
+modules. If you installed VLC through a binary file, you will get
+the default modules. If, however, you want to customize VLC to your
+needs, you will have to compile the VLC from sources.
+
+If you don't intend to compile the VLC and
+want only the regular functions, reading this part is not very
+useful.
+
+ The compilation itself is explained in the next chapter.
+
+If you wish to compile a module which is stated disabled
+by default, you have to launch the configure script with :
+
+
+
+% ./configure --enable-module_name
+
+
+On the other hand, if you would like to disable a module that is
+enabled by default, you would have to use :
+
+
+% ./configure --disable-module_name
+
+
+
+
+
+Video outputs
+
+Video outputs are the modules that enable the support of some
+systems to display the video on your screen.
+
+x11
+
+default: enabled
+
+For Unix with X11 servers only
+
+This is the basic x11 video output. It only requires a
+working X11 server. You will need xlibs headers to compile it
+(xlibs-dev package on Debian systems).
+
+
+xvideo
+
+default: enabled
+
+For Linux only
+
+It requires an xvideo compliant graphic card (it is the case for
+nearly all modern cards). It uses hardware acceleration for YUV
+transformation and rescaling.
+
+
+sdl
+
+default: enabled
+
+This video output uses sdl libraries. You need at least version
+1.1.6 of this libraries.
+
+ You may indicate the path to the sdl-config
+program with the --with-sdl-config-path=PATH
+switch, when running the configre script.
+
+
+directx
+
+default: enabled on win32
+
+For Windows only
+
+This video output uses Microsoft Direct X libraries. It is
+recommended for the win32 port.
+
+You may indicate the path to directX libraries and headers with
+the --with-directx=PATH switch, when running the
+configure script.
+
+
+wingdi
+
+default: enabled on win32
+
+For Windows only
+
+This video output uses GDI. It is designed for users who don't
+have Direct X, but the perfs are very low. If you have DirectX, do not
+use it.
+
+
+
+fb
+
+default: enabled on Linux
+
+For Linux only
+
+This is the frame buffer video output. It requires that your
+kernel was compiled with frame buffer support.
+
+
+glide
+
+default: disabled
+
+This video output uses Glide libraries (hardware acceleration for
+3Dfx cards).
+
+You may indicate the path to the library with the
+--with-glide=PATH configure option. /para>
+
+mga
+
+default: disabled
+
+For Linux only
+
+This module provides hardware acceleration for Matrox cards under
+Linux.
+
+ggi
+
+default: disabled
+
+
+aa
+
+default: disabled
+
+This is the ASCII Art Video Output. This video output uses the
+aalib library to display video through ASCII art. It requires aalib
+headers (aalib1-dev package under Debian) to
+compile.
+
+
+svgalib
+
+default: disabled
+
+For Linux only
+
+This is a video output for the SVGAlib library.
+
+
+qte
+
+default: disabled
+
+For iPaq only
+
+This is a video output for QT Embedded, an iPaq-specifiq graphical
+library.
+
+
+
+
+Video filters modules
+
+These modules allow you to perform modifications on the rendered
+image.
+
+deinterlace
+
+default: enabled
+
+This filter deinterlaces video. It is useful with streams coming
+from a digital satellite channel or digital terrestial television
+channels.
+
+
+wall
+
+default: enabled
+
+This filter allows you to have the video cut in pieces in several
+windows, which you can order as you wish. It can be used to generate
+image walls with several sources. Start it with :
+
+
+% vlc --filter wall:XxY ....
+
+
+in order to have the video cut in X rows and
+Y columns
+
+
+distort
+
+default: enabled
+
+This filter adds a distortion effect to the video. Who said it was
+useless ? :-)
+
+
+transform
+
+default: enable
+
+This filter rotates the video window of 90 degrees.
+
+
+invert
+
+default: enabled
+
+This filter inverses colors.
+
+
+
+
+
+Sound outputs
+
+These modules allow you to choose the way the sound will be output
+to your audio system.
+
+oss
+
+default: enabled on Linux
+
+For Unix/Linux only
+
+This is the audio output for OSS (Open Sound System) output
+(/dev/dsp, for exemple, under Linux). It requires
+that your kernel was compiled with support for your sound card.
+
+
+alsa
+
+default: disabled
+
+For Linux only
+
+This is the sound output for ALSA (Advanced Linux Sound
+Architecture). It only works under Linux, and it requires that you
+installed the ALSA drivers and libraries.
+
+
+esd
+
+default: disabled
+
+For Unix/Linux only
+
+This sound output has ESD (Enlightened Sound Daemon) support
+(usually used with Gnome). You must have the daemon and its libraries
+installed.
+
+
+arts
+
+default: disabled
+
+For Unix/Linux only
+
+This sound output has aRts (KDE's sound server) support. You must
+have the daemon and its libraries installed.
+
+
+waveout
+
+default: enabled on win32
+
+This is the Wave output, which is used by the win32 port.
+
+
+
+
+
+Input modules
+
+These modules allow VLC to read its streams from different
+sources.
+
+dvdplay
+
+default: enabled
+
+This is the regular DVD input module. It will need
+libdvdcss for DVD decryption (see the libdvdcss page)
+and libdvdplay for DVD navigation (see the libdvdplay
+page).
+
+
+
+dvdold
+
+default: enabled
+
+This is the old DVD input module. It uses
+libdvdcss for DVD decryption (see the
+libdvdcss
+page).
+
+
+
+dvdread
+
+default: disabled
+
+This is an alternative to the previous ones. It uses
+libdvdread for DVD reading (see the Ogle
+download page) and libdvdcss
+for DVD decryption (see the libdvdcss
+page).
+
+
+
+vcd
+
+default: enabled
+
+This is the VideoCD input.
+
+
+http
+
+default: enabled
+
+This is the HTTP input. You can use it for Video On Demand.
+
+
+satellite
+
+default: disabled
+
+This is an input module that allows to read
+directly from a Hauppauge WinTV Nova card under Linux.
+It requires drivers 0.9.4 available from linuxtv.org.
+
+
+
+v4l
+
+default: disabled
+
+For Linux only
+
+This module allows to get Video4Linux streams.
+
+
+
+
+
+Demuxers
+
+Demuxers or demultiplexers allow VLC to extract the stream(s)
+from the file or source where they are into.
+
+For example, an AVI file can contain a MPEG-4 video, or an
+uncompressed video. AVI is only a storing format, not a compression
+format.
+
+avi
+
+default: enabled
+
+This module allows you to read .avi files.
+
+
+asf
+
+default: enabled
+
+This module allows you to read .asf files.
+
+
+aac
+
+default: enabled
+
+This module allows to you read AAC files.
+
+
+ogg
+
+default: enabled
+
+This module allows to you read OGG files.
+
+
+rawdv
+
+default: enabled
+
+This module allows to you read DV files.
+
+
+dvbpsi
+
+default: enabled
+
+This module allows to demux streams from a satellite card.
+
+
+mp4
+
+default: enabled
+
+This module is the MPEG-4 demuxer.
+
+
+
+
+
+
+Interface modules
+
+These modules allow you to choose the interface you want to use.
+
+gtk
+
+default: enabled
+
+This is the GTK+ interface. It needs gtk libraries
+(libgtk1.2 package on Debian) and headers files
+if you are compiling it (libgtk1.2-dev package on
+Debian). Note that it can also be used under Windows.
+
+
+gnome
+
+default: disabled
+
+For Linux only
+
+This is the Gnome interface. It needs gnome libraries
+(libgnome32 package under Debian) and headers
+(libgnome-dev package under Debian) if you wish to
+compile it.
+
+intfwin
+
+default: enabled on win32
+
+For Windows only
+
+This is the Windows native interface. It requires
+Borland C++ builder to compile. You may use the
+--with-bc-builder=PATH option to specify the path to
+this application.
+
+
+qt
+
+default: disabled
+
+This is the QT interface module. You will need the libraries
+(libqt2 package on Debian) and headers
+(libqt-dev package under Debian) if you wish to
+compile it.
+
+
+kde
+
+default: disabled
+
+This is the KDE interface module. You will need the libraries
+(kdelibs3 package on Debian) and headers
+(kde-devel package under Debian) if you wish to
+compile it.
+
+
+rc
+
+default: enabled
+
+This is the Remote Control interface module. It allows you
+to control VLC via commands, such as play,
+stop, etc... or via a script.
+
+
+ncurses
+
+default: disabled
+
+This is a text interface, using ncurses library.
+You will need ncurses headers if you want to compile it
+(libncurses5-dev package on Debian).
+
+
+lirc
+
+default: disabled
+
+This interface module allows you to control VLC through a remote.
+A lircrc example is provided to help you configure it to your remote
+(see doc/lirc/example.lircrc).
+
+
+wxwindows
+
+default: enabled
+
+The wxWindows interface is a portable interface meant to
+replace win32, gnome and Gtk interface, but it is not completely
+finished.
+
+
+opie
+
+default: disabled
+
+This is an interface plugin for the Qt Embedded library (iPaq
+graphical library).
+
+
+
+
+
+
+Codec modules
+
+The following modules add codec (ie, compression formats)
+support.
+
+a52
+
+default: disabled
+
+This is a better AC3/A52 decoder than the built-in one, based on
+liba52 (see the liba52 web
+site.
+
+
+
+ffmpeg
+
+default: disabled
+
+This is a free MPEG-4/DivX/OpenDivX codec : ffmpeg (see the ffmpeg web site.
+
+
+
+vorbis
+
+default: enabled
+
+This codec allows you to read the OGG/Vorbis files.
+
+
+dv
+
+default: disabled
+
+This codec allows you to read DV-encoded files.
+
+
+xvid
+
+default: disabled
+
+This codec allows you to read files encoded with Xvid (see Xvid web site).
+
+
+mad
+
+default: disabled
+
+This codec is a very smart MP3 decoder, that only uses integers.
+This allows its use for CPU which don't handle floating point numbers
+(on PDA, for exemple).
+
+
+faad
+
+default: disabled
+
+Faad is an MPEG-4 audio decoder (see the FAAC web site).
+
+
+
+tarkin
+
+default: disabled
+
+tarkin is a new codec (experimental) by the Ogg Project (see the
+Ogg Vorbis web site).
+
+
+
+
+theora
+
+default: disabled
+
+theora is an experimental video codec by the Ogg Project (see the
+Ogg Vorbis web site).
+
+
+
+cinepak
+
+default: enabled
+
+This is the codec for the Cinepak format.
+
+
+tremor
+
+default: disabled
+
+This is an Ogg/Vorbis codec that only makes integer calculus,
+which allow its use on CPU which don't have floating point support
+(see the Ogg Vorbis web
+site).
+
+
+
+
+
+
+OS support modules
+
+The following modules add support for different OSs.
+
+macosx
+
+default: enabled on MacOS X
+
+For MacOS X only
+
+This is the MacOS X support module, including a native
+interface.
+
+
+
+qnx
+
+default: enabled on qnx
+
+For QNX only
+
+This is the QNX RTOS support module.
+
+
+
+
+
+
+
+Miscellaneous
+
+This section describes a few more modules that don't belong to any
+of the categories described before.
+
+sout
+
+default: enabled
+
+Stream Output is a new feature of VLC that allows
+it to stream an MPEG-1, MPEG-2 or MPEG-4/DivX file or a DVD.
+
+For more details, please have a look at the or
+sections.
+
+
+
+test-suite
+
+default: disabled
+
+This builds a special VLC, for testing purposes only.
+
+
+
+
+mozilla
+
+default: disabled
+
+This is not really a module. When enabled, a VLC-based Mozilla
+plugin is built.
+
+
+
+slp
+
+default: enabled
+
+This enables the SLP service discovery protocol.
+
+
+xosd
+
+default: disabled
+
+For Unix only
+
+This plugin outputs the current stream to an "OSD" (On Screen
+Display).
+
+
+
+
+
+Compilation Options
+
+There are a few options that you can set when running the
+configure script, which are not related to modules.
+
+You can have a look at these options by typing :
+
+
+% ./configure --help
+
+
+You can for example control all the installation directories,
+the system for which you want to build VLC for (if not guessed
+correctly),...
+
+You can also choose to enable or disable some optimizations.
+
+--disable-plugins
+
+If you select this option, no plugins will be enabled. This is
+definitely not recommended, as you would get a very poor VLC, and should
+only be used for testing purposes.
+
+
+
+
+
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/streamable-mpeg-file.sgml b/LDP/ref/docbook/VLC-User-Guide/streamable-mpeg-file.sgml
new file mode 100644
index 00000000..cf305a1f
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/streamable-mpeg-file.sgml
@@ -0,0 +1,46 @@
+
+Vls can stream MPEG 1 or MPEG 2 files that meet two
+critera :
+
+
+
+
+the file must be MPEG PS
+(Program Stream) or MPEG TS (Transport Stream),
+that contain video and audio multiplexed. Vls cannot stream MPEG
+ES (Elementary Stream), i.e. a file with only audio
+or video.
+
+In order to know if an MPEG file is MPEG PS,
+MPEG TS or MPEG ES, read the
+file with vlc and look at the messages (select in the menu
+View / Messages, or use the command line
+vlc -v) and look for a
+line :
+
+
+module: locking demux module `mpeg_XX'
+
+
+If XX = ps or XX =
+ts, then your file is MPEG PS and
+MPEG TS respectively, and you may be able to
+stream it. If XX = es, then your file is MPEG
+ES and is not streamable.
+
+the sequence header of the video must repeat itself regularly,
+which is often the case with MPEG 2, but very rare with MPEG 1. There is
+no easy way to know if the sequence header is repeated regularly. Files
+with a .vob extension are normally MPEG
+2 files and files with .mpg or
+.mpeg extension or
+usually
+MPEG 1 files.
+
+
+
+You can download this streamable
+MPEG 2 PS file for your tests : presentation_short.vob.
+
diff --git a/LDP/ref/docbook/VLC-User-Guide/uninstall-vlc.sgml b/LDP/ref/docbook/VLC-User-Guide/uninstall-vlc.sgml
new file mode 100644
index 00000000..69aa3514
--- /dev/null
+++ b/LDP/ref/docbook/VLC-User-Guide/uninstall-vlc.sgml
@@ -0,0 +1,54 @@
+Under Windows
+
+Click on the Uninstall VLC icon that was
+created during installation.
+
+
+
+Under BeOS
+
+Delete the vlc-version
+directory. You can also remove the configuration file
+/boot/home/config/settings/vlcrc.
+
+
+
+Under Mac OS X
+
+Drag the VLC application to your trash can.
+
+
+
+Under Linux Debian
+
+Remove the packages that you installed :
+
+
+# apt-get remove --purge vlc-gnome vlc-mad libdvdcss2 libdvbpsi1
+
+
+
+Under Linux Redhat, Mandrake and SuSE
+
+
+Uninstall the RPM packages that you installed :
+
+
+
+# rpm -e vlc-version vlc-mad-version vlc-gnome-version
+libdvdcss2-version libdvdpsi1-version
+
+
+
+
+If you compiled VLC from sources
+
+
+Go to the directory containing VLC sources and execute :
+
+
+# make uninstall
+
+
+Then you can remove the VLC sources.
+