* converted FAQ to SGML
authorLoïc Minier <lool@videolan.org>
Thu, 30 Jan 2003 18:07:45 +0000 (18:07 +0000)
committerLoïc Minier <lool@videolan.org>
Thu, 30 Jan 2003 18:07:45 +0000 (18:07 +0000)
  * SGML sucks, this is absolutely ugly, please reread

FAQ
doc/common/stylesheet-html.dsl [new file with mode: 0644]
doc/faq/Makefile [new file with mode: 0644]
doc/faq/faq-alone.sgml [new file with mode: 0644]
doc/faq/faq.sgml [new file with mode: 0644]

diff --git a/FAQ b/FAQ
index a0af835..3c23771 100644 (file)
--- a/FAQ
+++ b/FAQ
@@ -1,379 +1,2 @@
-Frequentely Asked Questions for VideoLAN Client
-$Id: FAQ,v 1.21 2003/01/22 10:03:17 massiot Exp $
-
-1. Using VLC
-============
-
-1.1 How do I read a DVD?
-------------------------
-Just launch vlc and use the "open disc" command from the graphical
-interface. In case of trouble, you may want to use the command line.
-For instance, provided your DVD device is /dev/dvd:
-
-    vlc dvd:/dev/dvd
-
-
-1.2 How do I read an encrypted DVD?
------------------------------------
-It is exactly the same as for a normal DVD. You will need write access to
-/dev/dvd, because of the key negociation process.
-
-If you compiled your VLC by hand, please bear in mind that you also need
-to install libdvdcss. It can be downloaded from the VideoLAN website. It
-used to be distributed in the same package as VLC, but now you must install
-them seperately.
-
-
-1.3 How do I switch to full screen display?
--------------------------------------------
-Press 'f' to toggle fullscreen mode. Note that not all video output
-devices support full screen.
-
-
-1.4 How do I hide the mouse cursor?
------------------------------------
-It should disappear after a few seconds if you stop moving the mouse.
-
-
-1.5 How do I use vlc if I do not want to install Gnome and all this
-#@!£% *$@&§% !@# bloat?
--------------------------------------------------------------------
-You can run:
-
-    vlc --intf dummy myfile.mpg
-
-Most commands are available from the command line, see vlc --help for
-more information.
-
-
-1.6 VLC eats my buffer cache, how to I use raw device?
-------------------------------------------------------
-If you do not know what is a raw device, do not even read this answer :-).
-There is an experimental support for raw devices in libdvdcss. It needs
-that you set up a raw device pointing to your DVD device (under Linux,
-use the "raw" utility). Then pass the raw device as second argument, for
-instance:
-
-    vlc dvd:/dev/dvd@/dev/raw0
-
-
-1.7 How do I use VLC as a client for VLS/VLMS streaming?
---------------------------------------------------------
-First you must set up a VLS or VLMS stream. Please refer to the
-documentation of these programs. Then start VLC:
-
-    vlc udp:
-
-You should not need any option. If you are paranoid and want to control
-everything, here is the exact syntax:
-
-    vlc udp:[<server>[:<server port>]][@[<bind address>][:<bind port>]]
-
-
-1.8 How do I uninstall / reinstall VLC?
----------------------------------------
-Why would you want to? ;)
-
-If you are using a source distribution of VLC, for example a tarball or
-the CVS, then you have probably used "make install" to install the
-compiled VLC. To remove it just "make uninstall". If you want to
-install a newer version than the currently installed one, you should
-first uninstall the first one. If you deleted the original source tree,
-a "make uninstall" in the newer tree should still work.
-
-For binary packages, remove old packages first and install the new ones
-(normally this should be handled automagically by your sytem).
-
-
-1.9 Debian: what should I put in my sources.list for videolan?
---------------------------------------------------------------
-deb     http://www.videolan.org/pub/videolan/debian $(ARCH)/
-deb-src http://www.videolan.org/pub/videolan/debian sources/
-
-
-1.10 How can I save my VLC configuration?
------------------------------------------
-Currently, the only way to save the configuration options in VLC is through
-the preferences menu in one of the graphical user interface plugins.
-
-
-1.11 Where does VLC store its config file?
-------------------------------------------
-Currently, a config file is created on a per user basis (there is no global
-configuration file). If you modify the available options in VLC and save the
-new configuration, then a configuration file will be created in your user
-directory. The precise location of this file depends on the Operating System
-you are running:
-
- * Unices (Linux, etc.): "$(HOME)/.vlc/vlcrc"
-
- * Windows: "Application Data\vlc\vlcrc"
-
- * BeOS: "config/settings/vlcrc"
-
-
-1.12 How do I join an IPv6 multicast stream?
---------------------------------------------
-You often have to indicate the interface name on your system, for instance :
- udp:@[FEDC:BA98:7654:3210:FEDC:BA98:7654:3210%eth0]:1234
-
-
-2. Troubleshooting
-==================
-
-2.1 When I start vlc, I do not see any interface coming
--------------------------------------------------------
-If you installed a binary package, make sure you also installed an
-interface package such as vlc-gtk or vlc-qt. If you installed from
-source, make sure the development package for gtk or qt is correctly
-installed (often gtk-dev or gtk-devel) and recompile.
-
-
-2.2 Clicking on "disc" in the interface does not do anything
-------------------------------------------------------------
-Wait a few seconds. Key cracking can take much time on some discs. If it
-still does not work, you can have a more verbose output using "vlc -vvvvv".
-Here are a few things to check for:
-
- * Did you install the libdvdcss package?
-
- * Do you have write access to your DVD device? For instance:
-
-    chmod 666 /dev/hdc
-
- * Does your kernel log contain line about your DVD device?
-
- * Do you have a link from /dev/dvd to your real DVD device? For instance
-
-    ln -s hdc /dev/dvd
-
-
-2.3 [REMOVED]
--------------
-
-2.4 The video runs but the picture is distorted
------------------------------------------------
-There is probably a problem with the output layer. There are several
-ways of troubleshooting it. First, try with another output plugin, for
-instance:
-
-   vlc --vout sdl
-   vlc --vout x11
-
-Second, change your screen depth and/or definition. It quite often helps.
-Lastly, have a look at your XFree86 video driver (nVidia for instance
-releases optimized drivers for its boards).
-
-
-2.5 Video is choppy
--------------------
-Your system is too slow to decode all pictures. It might be that your
-CPU basically is not fast enough. It can also be that the subsystem is
-misconfigured/misdriven, this happens for example under Redhat. Here are
-some elements to improve speed:
-
- * Turn on DMA on your DVD device, for instance:
-    hdparm -X34 -d1 /dev/dvd
-
- * Upgrade to the latest XFree86 version and the latest driver for your
-   video board; check that the xvideo plugin is effectively used with
-   vlc -vvvv
-
- * Kill other running applications
-
-
-2.6 Audio is choppy
--------------------
-This is not normal; it is a known problem and is being investigated.
-
-
-2.7 Audio and video are out of sync
------------------------------------
-This is not normal. Try using another output plugin (for instance --aout dsp),
-kill esd or artsd if they are running. This is a known problem and
-is being investigated.
-
-
-2.8 [REMOVED]
--------------
-
-2.9 Sound volume is too low
----------------------------
-You can raise it with --volume command line switch or in the preferences
-window of your graphical interface.
-
-
-2.10 I have no image under DirectX
-----------------------------------
-Check that your video card drivers are in their latest version and that
-your DirectX is up-to-date.
-
-
-2.11 VLC crashes
-----------------
-Increase the verbosity level (either in the preferences or with a
-"-vv" command line option) and look at the debug messages (in the
-terminal or in the Messages window).
-
-
-2.12 I can only play a DVD as root
-----------------------------------
-Check that as user you have write access to your DVD drive / device.
-
-
-2.13 I am stuck with option xxx, how do I reset options?
---------------------------------------------------------
-Under unices, remove your ~/.videolan/vlcrc; for Windows, remove vlcrc
-in the videolan subfolder of your "Application Data" directory.
-
-
-2.14 I do not have access to the GUI anymore
---------------------------------------------
-If you change the default interface module in the preferences menu to a non
-GUI module (ie. to a command line interface) and then save the configuration,
-the only way to get VLC to show a GUI again is to run it directly from the
-command line.
-For instance on Windows, you need to open a dos command box, go to the
-directory where you installed VLC (usually
-c:\Program Files\VideoLAN\VideoLAN Client) and then type "vlc --intf win32"
-You will then be able to modify the configuration again and save it.
-
-
-2.15 I have just upgraded to VLC 0.4.5, and now I do not have any sound
-with the streams coming from the VLS!
------------------------------------------------------------------------
-This is a known problem. VLC 0.4.5 and later are now compliant to general
-usage regarding A/52 sound, and the new behavior is incompatible with the
-previous one. VLS version 0.4.0 and later now fixes this problem. If, for
-any reason, you wish to keep VLS 0.3.3, you can still read those streams by
-launching VLC (0.4.5 or later) with --vls-backwards-compat.
-
-
-2.16 NO VIDEO!! or NO AUDIO!!
------------------------------
-DON'T PANIC! Use the verbose mode of vlc to search the problem, you may
-either set the verbosity option in the interface preferences or use
-the "-v" command line switch to increase the number of report/error
-messages given by vlc. If you are not using a terminal, use the Messages
-window in the View menu.
-
-
-3. Ports and features
-=====================
-
-3.1 MacOS X port
-================
-
-3.1.1 Does VLC support the ATI DVD hardware acceleration cards?
----------------------------------------------------------------
-Currently it does not. We would be glad to support them, but we lack technical
-information on them.
-
-
-3.1.2 [REMOVED]
----------------
-
-3.2 Win32 port
-==============
-
-3.2.2 When moving the focus to another window, VLC network input stops
-working properly!
-----------------------------------------------------------------------
-This is a known problem with Win 95-class systems. Upgrade to an NT-class
-system.
-
-
-3.3 Planned ports
-=================
-
-3.3.1 Do you have plans for a MacOS 9 / OS/2 / &{#!@}~ port?
-------------------------------------------------------------
-No, nobody reported to be actually working on a MacOS 9 port. If you
-feel like you could write it, we would of course welcome it. Currently,
-the developers are more interested in supporting the latest Operating
-Systems and completing the functionalities.
-
-
-3.3.2 Does VLC have dxr2 / dxr3 cards support?
-----------------------------------------------
-This support is currently being developed.
-
-
-3.3.3 Does VLC support RTP?
----------------------------
-Yes. Just use vlc rtp:@<mcast addr>:<local port>.
-
-
-3.3.4 Does VLC support DVD from all regions?
---------------------------------------------
-VLC uses libdvdcss to read all DVD, disregarding their zone. All regions
-are supported without any constraint. However, libdvdcss might not be
-legal in your country.
-
-
-3.3.5 How can I take screenshots?
----------------------------------
-This is currently unsupported, but will be in a near future. The latest
-developments concern recording the video and the audio to a file.
-However, under XFree, you may use the "x11" video output to take normal
-screen capture of the video displayed by vlc.
-
-
-4. Legal concerns
-=================
-
-4.1 May I use the VideoLAN logo?
---------------------------------
-You may freely use the VideoLAN logo using the following copyright:
-
-  Copyright (c) 1996-2002 VideoLAN. This logo or a modified version
-  may be used or modified by anyone to refer to the VideoLAN project
-  or any product developed by the VideoLAN team, but does not indicate
-  endorsement by the project.
-
-
-4.2 May I redistribute VLC?
----------------------------
-You may distribute an original or modified version of VideoLAN as long
-as you comply with its license terms. It is the GNU General Public
-License Version 2 (referred herein as GPL), and it is in the file named
-COPYING in our products.
-The easiest way to conform to the GPL is to accompany the product you
-want to distribute with its sources. For example, if you plan to
-distribute the 0.4.6 binary version you should include:
-
-   http://www.videolan.org/pub/videolan/vlc/0.4.6/vlc-0.4.6.tar.gz
-   http://www.videolan.org/pub/videolan/vlc/0.4.6/contrib/
-
-You do not need to bother explaining where the sources are, but the
-sources have to share the same media as the products.
-
-They are other ways to comply with the GPL, but this should be the
-simplest because it does not rely on a contract.
-
-There is one additional issue you need to take care of. The VLC
-binary from our website can also read encrypted DVDs with the help of
-the libdvdcss library. Its use is controversial in a few countries
-such as the United States because of a law called the DMCA. If you are
-unsure about the legality of using and distributing this library in
-your country, please consult your lawyer.
-
-
-5. Miscellaneous
-================
-
-5.1 How may I help your project?
---------------------------------
-You might either contribute time, material, or money. We are also always
-needing some translators. You will find all information you need at
-<http://www.videolan.org/contribute.html>.
-
-
-5.2 Why are your mailing-lists and your website in english?
------------------------------------------------------------
-VideoLAN's developers come from all around the world and english is
-the only language they can use to communicate together. Although great
-care is given to the translation of our software in various languages,
-maintaining translations of our documentation and website costs too much
-more time than we can afford.
-
+The FAQ is in SGML format under doc/faq/ with an appropriate Makefile to
+build it.
diff --git a/doc/common/stylesheet-html.dsl b/doc/common/stylesheet-html.dsl
new file mode 100644 (file)
index 0000000..46f9cb8
--- /dev/null
@@ -0,0 +1,62 @@
+<!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 HTML output
+; These parameters overide James Clark's one.
+
+; 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)
+
+; Change of HTML page for each chapter, not for each "sect1"
+(define (chunk-element-list)
+  (list (normalize "preface")
+       (normalize "chapter")
+       (normalize "appendix") 
+       (normalize "article")
+       (normalize "glossary")
+       (normalize "bibliography")
+       (normalize "index")
+       (normalize "colophon")
+       (normalize "setindex")
+       (normalize "reference")
+       (normalize "refentry")
+       (normalize "part")
+       (normalize "book")
+       (normalize "set")
+       ))
+
+
+; "screens" should be in verbatim mode"
+(define %shade-verbatim%
+  #t)
+
+; I want small icons for "notes", "warnings", "caution" & "important"
+(define %admon-graphics%
+  #t)
+; Path for the icons
+(define %admon-graphics-path%
+  "../common/")
+
+; Use ID attributes as name for component HTML files
+(define %use-id-as-filename%
+  #t)
+
+(define %section-autolabel%
+  ;; Are sections enumerated?
+  #t)
+
+
+</style-specification-body>
+</style-specification>
+<external-specification id="docbook" document="dbstyle">
+</style-sheet>
diff --git a/doc/faq/Makefile b/doc/faq/Makefile
new file mode 100644 (file)
index 0000000..7f55388
--- /dev/null
@@ -0,0 +1,9 @@
+all: html
+
+html:
+       rm -f *.html
+       sgmltools -b html -s ../common/stylesheet-html.dsl faq-alone.sgml
+       mv faq-alone/*.html .
+       rmdir faq-alone
+       ln -s book1.html index.html
+
diff --git a/doc/faq/faq-alone.sgml b/doc/faq/faq-alone.sgml
new file mode 100644 (file)
index 0000000..582f80f
--- /dev/null
@@ -0,0 +1,26 @@
+<!DOCTYPE book PUBLIC '-//OASIS//DTD DocBook V4.1//EN'
+[
+
+  <!ENTITY faq SYSTEM "faq.sgml">
+
+]>
+
+<book>
+
+<bookinfo>
+
+<title>Frequently Asked Questions</title>
+
+<copyright>
+    <year>2002, 2003</year>
+    <holder>the VideoLAN project</holder>
+</copyright>
+
+</bookinfo>
+
+
+<toc></toc>
+
+&faq;
+
+</book>
diff --git a/doc/faq/faq.sgml b/doc/faq/faq.sgml
new file mode 100644 (file)
index 0000000..597a18e
--- /dev/null
@@ -0,0 +1,433 @@
+<qandaset><title>FAQ of the VideoLAN Client</title>
+
+<qandadiv><title>Using the VideoLAN Client</title>
+
+<qandaentry>
+<question><para>How do I read a DVD?</para></question>
+<answer><para>Just launch vlc and use the "open disc" command from the graphical
+interface. In case of trouble, you may want to use the command line.
+For instance, provided your DVD device is /dev/dvd:
+
+<screen><prompt>%</prompt><userinput>vlc dvd:/dev/dvd</userinput></screen>
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>How do I read an encrypted DVD?</para></question>
+<answer><para>It is exactly the same as for a normal DVD. You will need write access to
+/dev/dvd, because of the key negociation process.
+
+If you compiled your VLC by hand, please bear in mind that you also need
+to install libdvdcss. It can be downloaded from the VideoLAN website. It
+used to be distributed in the same package as VLC, but now you must install
+them seperately.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>How do I switch to full screen display?</para></question>
+<answer><para>Press 'f' to toggle fullscreen mode. Note that not all video output
+devices support full screen.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>How do I hide the mouse cursor?</para></question>
+<answer><para>It should disappear after a few seconds if you stop moving the mouse.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>How do I use vlc if I do not want to install Gnome and
+all this #@!£% *$@&§% !@# bloat?</para></question>
+<answer><para>You can run:
+
+    vlc --intf dummy myfile.mpg
+
+Most commands are available from the command line, see vlc --help for
+more information.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>VLC eats my buffer cache, how to I use raw device?</para></question>
+<answer><para>If you do not know what is a raw device, do not even read this answer :-).
+There is an experimental support for raw devices in libdvdcss. It needs
+that you set up a raw device pointing to your DVD device (under Linux,
+use the "raw" utility). Then pass the raw device as second argument, for
+instance:
+
+<screen><prompt>%</prompt><userinput>vlc dvd:/dev/dvd@/dev/raw0</userinput></screen>
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>How do I use VLC as a client for VLS/VLMS streaming?</para></question>
+<answer><para>First you must set up a VLS or VLMS stream. Please refer to the
+documentation of these programs. Then start VLC:
+
+<screen><prompt>%</prompt><userinput>vlc udp:</userinput></screen>
+
+You should not need any option. If you are paranoid and want to control
+everything, here is the exact syntax:
+
+<screen><prompt>%</prompt><userinput>vlc udp:[&lt;server&gt;[:&lt;server port&gt;]][@[&lt;bind address&gt;][:&lt;bind port&gt;]]</userinput></screen>
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>How do I uninstall / reinstall VLC?</para></question>
+<answer><para>Why would you want to? ;)
+
+If you are using a source distribution of VLC, for example a tarball or
+the CVS, then you have probably used "make install" to install the
+compiled VLC. To remove it just "make uninstall". If you want to
+install a newer version than the currently installed one, you should
+first uninstall the first one. If you deleted the original source tree,
+a "make uninstall" in the newer tree should still work.
+
+For binary packages, remove old packages first and install the new ones
+(normally this should be handled automagically by your sytem).
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>Debian: what should I put in my sources.list for videolan?</para></question>
+<answer><para>
+<programlisting>
+deb     http://www.videolan.org/pub/videolan/debian $(ARCH)/
+deb-src http://www.videolan.org/pub/videolan/debian sources/
+</programlisting>
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>How can I save my VLC configuration?</para></question>
+<answer><para>Currently, the only way to save the configuration options in VLC is through
+the preferences menu in one of the graphical user interface plugins.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>Where does VLC store its config file?</para></question>
+<answer><para>Currently, a config file is created on a per user basis (there is no global
+configuration file). If you modify the available options in VLC and save the
+new configuration, then a configuration file will be created in your user
+directory. The precise location of this file depends on the Operating System
+you are running:
+</para>
+
+<itemizedlist>
+<listitem><para>Unices
+(Linux, etc.): <filename>$(HOME)/.vlc/vlcrc</filename></para></listitem>
+<listitem><para>Windows: <filename>Application Data\vlc\vlcrc</filename> (Application Data is usually in <filename>C:\Documents and Settings\your_name</filename></para></listitem>
+<listitem><para>BeOS: <filename>config/settings/vlcrc</filename></listitem>
+</itemizedlist>
+
+</answer></qandaentry>
+
+<qandaentry>
+<question><para>How do I join an IPv6 multicast stream?</para></question>
+<answer><para>You often have to indicate the interface name on your system, for instance :
+ udp:@[FEDC:BA98:7654:3210:FEDC:BA98:7654:3210%eth0]:1234
+</para></answer></qandaentry>
+
+</qandadiv>
+<qandadiv><title>Troubleshooting</title>
+
+<qandaentry>
+<question><para>When I start vlc, I do not see any interface coming</para></question>
+<answer><para>If you installed a binary package, make sure you also installed an
+interface package such as vlc-gtk or vlc-qt. If you installed from
+source, make sure the development package for gtk or qt is correctly
+installed (often gtk-dev or gtk-devel) and recompile.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>Clicking on "disc" in the interface does not do anything</para></question>
+<answer><para>Wait a few seconds. Key cracking can take much time on some discs. If it
+still does not work, you can have a more verbose output using <command>vlc -vvvvv</command>.
+Here are a few things to check for:
+
+<itemizedlist>
+<listitem><para>Did you install the libdvdcss package?</para></listitem>
+
+<listitem><para>Do you have write access to your DVD device? For instance:
+<command>chmod 666 /dev/hdc</command> </para></listitem>
+
+<listitem><para>Does your kernel log contain line about your DVD device?</para></listitem>
+
+<listitem><para>Do you have a link from /dev/dvd to your real DVD device? For instance</para>
+<screen><prompt>%</prompt><userinput>ln -s hdc /dev/dvd</userinput></screen></listitem>
+</itemizedlist>
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>[REMOVED]</para></question>
+</qandaentry>
+
+<qandaentry>
+<question><para>The video runs but the picture is distorted</para></question>
+<answer><para>There is probably a problem with the output layer. There are several
+ways of troubleshooting it. First, try with another output plugin, for
+instance:
+
+<screen>
+<prompt>%</prompt><userinput>vlc --vout sdl</userinput>
+<prompt>%</prompt><userinput>vlc --vout x11</userinput>
+</screen>
+
+Second, change your screen depth and/or definition. It quite often helps.
+Lastly, have a look at your XFree86 video driver (nVidia for instance
+releases optimized drivers for its boards).
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>Video is choppy</para></question>
+<answer><para>Your system is too slow to decode all pictures. It might be that your
+CPU basically is not fast enough. It can also be that the subsystem is
+misconfigured/misdriven, this happens for example under Redhat. Here are
+some elements to improve speed:
+</para>
+
+<itemizedlist>
+<listitem><para>Turn on DMA on your DVD device, for instance</para>
+<screen><prompt>Under Linux:      % </prompt><userinput>hdparm -X34 -d1 /dev/dvd</userinput></screen>
+
+<para>Under Windows,  go to  the <emphasis>System</emphasis>  section of
+the control  panel, and go to  the <emphasis>Hardware manager</emphasis>
+(it is sometimes in a separate tab, and sometimes, you have to go to the
+<emphasis>Advanced</emphasis> tab.  Then, righ-click on your  DVD player,
+and check the <emphasis>DMA</emphasis> checkbox</para></listitem>
+
+<listitem><para>Upgrade to the latest driver for your
+video board</para>
+<para>If you are running Linux, you can additionnaly upgrade to the latest XFree86 version ; if supported, check that the xvideo plug-in is effectively used with</para>
+<screen><prompt>%</prompt><userinput>vlc -vvvv</userinput></screen>
+</listitem>
+
+<listitem><para>Kill other applications running...</para></listitem>
+</itemizedlist>
+</answer></qandaentry>
+
+<qandaentry>
+<question><para>Audio is choppy</para></question>
+<answer><para>This is not normal; it is a known problem and is being investigated.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>Audio and video are out of sync</para></question>
+<answer><para>This is not normal. Try using another output plugin (for instance <command>--aout dsp</command>),
+kill esd or artsd if they are running. This is a known problem and
+is being investigated.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>[REMOVED]</para></question>
+</qandaentry>
+
+<qandaentry>
+<question><para>Sound volume is too low</para></question>
+<answer><para>You can raise it with <command>--volume</command> command line switch or in the preferences
+window of your graphical interface.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>I have no image under DirectX</para></question>
+<answer><para>Check that your video card drivers are in their latest version and that
+your DirectX is up-to-date.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>VLC crashes</para></question>
+<answer><para>Increase the verbosity level (either in the preferences or with a
+<emphasis>-vv</emphasis> command line option) and look at the debug messages (in the
+terminal or in the Messages window).
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>I can only play a DVD as root</para></question>
+<answer><para>Check that as user you have write access to your DVD drive / device.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>I am stuck with option xxx, how do I reset options?</para></question>
+<answer><para>Under unices, remove your <filename>~/.vlc/vlcrc</filename>; for Windows, remove <filename>vlcrc</filename>
+in the videolan subfolder of your <filename>Application Data</filename> directory.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>I do not have access to the GUI anymore</para></question>
+<answer><para>If you change the default interface module in the preferences menu to a non
+GUI module (ie. to a command line interface) and then save the configuration,
+the only way to get VLC to show a GUI again is to run it directly from the
+command line.
+For instance on Windows, you need to open a dos command box, go to the
+directory where you installed VLC (usually
+<filename>c:\Program Files\VideoLAN\VideoLAN Client</filename>) and then type <command>vlc --intf win32</command>
+You will then be able to modify the configuration again and save it.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>I have just upgraded to VLC 0.4.5, and now I do not have any sound with the streams coming from the VLS!</para></question>
+<answer><para>This is a known problem. VLC 0.4.5 and later are now compliant to general
+usage regarding A/52 sound, and the new behavior is incompatible with the
+previous one. VLS version 0.4.0 and later now fixes this problem. If, for
+any reason, you wish to keep VLS 0.3.3, you can still read those streams by
+launching VLC (0.4.5 or later) with --vls-backwards-compat.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>NO VIDEO!! or NO AUDIO!!</para></question>
+<answer><para>DON'T PANIC! Use the verbose mode of vlc to search the problem, you may
+either set the verbosity option in the interface preferences or use
+the "-v" command line switch to increase the number of report/error
+messages given by vlc. If you are not using a terminal, use the Messages
+window in the View menu.
+</para></answer></qandaentry>
+
+</qandadiv>
+<qandadiv><title>Ports and features</title>
+
+<qandadiv><title>MacOS X port</title>
+
+<qandaentry>
+<question><para>Does VLC support the ATI DVD hardware acceleration cards?</para></question>
+<answer><para>Currently it does not. We would be glad to support them, but we lack technical
+information on them.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>[REMOVED]</para></question>
+</qandaentry>
+
+</qandadiv>
+
+<qandadiv><title>Win32 port</title>
+
+<qandaentry>
+<question><para>When moving the focus to another window, VLC network input stops working properly!</para></question>
+<answer><para>This is a known problem with Win 95-class systems. Upgrade to an NT-class
+system.
+</para></answer></qandaentry>
+
+</qandadiv>
+
+<qandadiv><title>Planned ports</title>
+
+<qandaentry>
+<question><para>Do you have plans for a MacOS 9 / OS/2 / &{#!@}~ port?</para></question>
+<answer><para>No, nobody reported to be actually working on a MacOS 9 port. If you
+feel like you could write it, we would of course welcome it. Currently,
+the developers are more interested in supporting the latest Operating
+Systems and completing the functionalities.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>Does VLC have dxr2 / dxr3 cards support?</para></question>
+<answer><para>This support is currently being developed.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>Does VLC support RTP?</para></question>
+<answer><para>Yes. Just use vlc rtp:@&lt;mcast addr&gt;:&lt;local port&gt;.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>Does VLC support DVD from all regions?</para></question>
+<answer><para>VLC uses libdvdcss to read all DVD, disregarding their zone. All regions
+are supported without any constraint. However, libdvdcss might not be
+legal in your country.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>How can I take screenshots?</para></question>
+<answer><para>This is currently unsupported, but will be in a near future. The latest
+developments concern recording the video and the audio to a file.
+However, under XFree, you may use the "x11" video output to take normal
+screen capture of the video displayed by vlc.
+</para></answer></qandaentry>
+
+</qandadiv>
+
+</qandadiv>
+
+<qandadiv><title>Legal concerns</title>
+
+<qandaentry>
+<question><para>May I use the VideoLAN logo?</para></question>
+<answer><para>You may freely use the VideoLAN logo using the following copyright:
+
+  Copyright (c) 1996-2002 VideoLAN. This logo or a modified version
+  may be used or modified by anyone to refer to the VideoLAN project
+  or any product developed by the VideoLAN team, but does not indicate
+  endorsement by the project.
+
+</para></answer></qandaentry>
+
+<qandaentry>
+<question><para>May I redistribute VLC?</para></question>
+<answer><para>You may distribute an original or modified version of VideoLAN as long
+as you comply with its license terms. It is the GNU General Public
+License Version 2 (referred herein as GPL), and it is in the file named
+COPYING in our products.
+The easiest way to conform to the GPL is to accompany the product you
+want to distribute with its sources. For example, if you plan to
+distribute the 0.4.6 binary version you should include:
+
+   http://www.videolan.org/pub/videolan/vlc/0.4.6/vlc-0.4.6.tar.gz
+   http://www.videolan.org/pub/videolan/vlc/0.4.6/contrib/
+
+You do not need to bother explaining where the sources are, but the
+sources have to share the same media as the products.
+
+They are other ways to comply with the GPL, but this should be the
+simplest because it does not rely on a contract.
+
+There is one additional issue you need to take care of. The VLC
+binary from our website can also read encrypted DVDs with the help of
+the libdvdcss library. Its use is controversial in a few countries
+such as the United States because of a law called the DMCA. If you are
+unsure about the legality of using and distributing this library in
+your country, please consult your lawyer.
+
+</para></answer></qandaentry>
+</qandadiv>
+<qandadiv><title>Miscellaneous</title>
+
+<qandaentry>
+<question><para>How may I help your project?</para></question>
+<answer><para>You might either contribute time, material, or money. We are also always
+needing some translators. You will find all information you need at
+<ulink url="http://www.videolan.org/contribute.html">http://www.videolan.org/contribute.html</ulink>.
+</para></answer></qandaentry>
+
+
+<qandaentry>
+<question><para>Why are your mailing-lists and your website in english?</para></question>
+<answer><para>VideoLAN's developers come from all around the world and english is
+the only language they can use to communicate together. Although great
+care is given to the translation of our software in various languages,
+maintaining translations of our documentation and website costs too much
+more time than we can afford.
+</para></answer></qandaentry>
+
+</qandadiv>
+</qandaset>