Commit 32436d19 authored by Alexis de Lattre's avatar Alexis de Lattre

ALL : New VideoLAN FAQ, which remplaces the VLC FAQ.

news.msg : nomination at the FS trophies !
parent 75ed2ecb
...@@ -168,8 +168,8 @@ url="">VLC user ...@@ -168,8 +168,8 @@ url="">VLC user
guide</ulink>. This document is the complete guide for VLC.</para> guide</ulink>. This document is the complete guide for VLC.</para>
<listitem><para>the <ulink <listitem><para>the <ulink
url="">VLC FAQ</ulink>. This url="">VideoLAN FAQ</ulink>. This
document contains Frequently Asked Questions of VLC users.</para> document contains Frequently Asked Questions about VideoLAN.</para>
</itemizedlist> </itemizedlist>
# Makefile for the VideoLAN Documentation
DOC := videolan-faq
# We build HTML, PS, PDF, RTF and TXT for the Web site
all: img html ps pdf rtf txt
# Get the images from the /images/documentation directory
/bin/cp ../common/magic-jpg.sgml ../common/magic.sgml
sgmltools -b html -s ../common/stylesheet-html.dsl $(DOC).sgml
mv $(DOC)/*.html .
rmdir $(DOC)
ln -sf videolan-faq.html index.html
rm -f $(DOC)
zip $(DOC) *.html
/bin/cp ../common/magic-eps.sgml ../common/magic.sgml
sgmltools -b ps -s ../common/stylesheet-print.dsl $(DOC).sgml
zip $(DOC) $(DOC).ps
/bin/cp ../common/magic-jpg.sgml ../common/magic.sgml
sgmltools -b pdf -s ../common/stylesheet-print-noicones.dsl $(DOC).sgml
zip $(DOC) $(DOC).pdf
/bin/cp ../common/magic-jpg.sgml ../common/magic.sgml
sgmltools -b rtf -s ../common/stylesheet-print-noicones.dsl $(DOC).sgml
rm -f $(DOC)
zip $(DOC) $(DOC).rtf
sgmltools -b txt $(DOC).sgml
rm -f *.zip *.html *.pdf *.ps *.txt *.rtf
<!DOCTYPE article PUBLIC '-//OASIS//DTD DocBook V4.1//EN' >
<article id="videolan-faq">
<title>VideoLAN FAQ</title>
<year>2002, 2003</year>
<holder>the VideoLAN project</holder>
<para>Frequently Asked Questions about VideoLAN.</para>
<!-- Starting the Q & A -->
<qandaset><title>VideoLAN FAQ</title>
<qandadiv><title>VLC Media Player</title>
<qandaentry><question><para>Where can I download VLC for Mac OS
<para>Where did you read VLC for Mac OS 9 exist? There is not, and
won't be, a version for Mac OS 9.</para>
<qandaentry><question><para>Does VLC support DVDs from all
<para>VLC uses <emphasis>libdvdcss</emphasis> to read all DVDs,
disregarding their zone. All regions are supported without any
<qandaentry><question><para>Where does VLC store its config
<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>
<listitem><para>Unices (Linux, etc.):
<listitem><para>Mac OS X: <filename>/Library/Preferences/VLC</filename>
<listitem><para>Windows: <filename>Application Data\vlc\vlcrc</filename>
(Application Data is usually in <filename>C:\Documents and
<qandaentry><question><para>VLC has a strange behavior...</para></question>
<para>The first thing to do is to delete VLC's configuration
file (see the previous question to know about it's location). Then
restart VLC ; if it doesn't get any better, read the following questions
<qandaentry><question><para>I can't read DVDs... !</para></question>
<para>Here are a few things to check:</para>
<listitem><para>Did you install the libdvdcss package?</para></listitem>
<listitem><para>Do you have write access to your DVD device?
For instance, under Unix :</para>
<prompt># </prompt><userinput>chmod 666 /dev/dvd</userinput>
<para>where <filename>/dev/dvd</filename> is the device corresponding to
your DVD drive.</para>
<qandaentry><question><para>The video runs but the picture is
<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:</para>
<prompt>% </prompt><userinput>vlc --vout sdl</userinput>
<prompt>% </prompt><userinput>vlc --vout x11</userinput>
<para>Second, change your screen depth and/or definition. It quite
often helps. Lastly, if running Unix, have a look at your XFree86 video
<qandaentry><question><para>Video is choppy</para></question>
<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 Linux. Here are some elements to improve speed: </para>
<listitem><para>Turn on DMA on your DVD device, for instance:</para>
<listitem><para>Under Linux:</para>
<prompt># </prompt><userinput>hdparm -d1 /dev/dvd</userinput>
<listitem><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>
<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><para>Kill other applications running...</para></listitem>
<qandaentry><question><para>Audio and video are out of sync</para></question>
<para>This is not normal. Try using another audio output plugin and,
under Unix, kill <emphasis>esd</emphasis> or <emphasis>artsd</emphasis>
if they are running.</para>
<qandaentry><question><para>VLC crashes</para></question>
<para>Increase the verbosity level (either in the preferences or with a
<emphasis>-vvvv</emphasis> command line option) and look at the debug
messages (in the terminal or in the Messages window).</para>
<para>If you are convinced that it's a bug in VLC, have a look at the
<ulink url="">bug
reporting page</ulink>.</para>
<qandaentry><question><para>How can I take screenshots?</para></question>
<para>To take normal screen capture of the video displayed by VLC
<listitem><para>under XFree, add the <emphasis>--vout x11</emphasis>
option to the command line ;</para></listitem>
<listitem><para>under Windows, add the <command>--nooverlay</command>
option to the command line.</para></listitem>
<qandadiv><title>VideoLAN streaming solution</title>
<qandaentry><question><para>VLC vs. VLS</para></question>
<para>Yes, both programs can be used to stream video, as explained in
the <ulink url="">VideoLAN
HOWTO</ulink>. The streaming features of
each program are described on the <ulink
features</ulink> page.</para>
<para>Basically, for the moment:</para>
<listitem><para>VLC is good at streaming various MPEG files in various
encapsulation formats (mpg, vob, mp3, avi, mov, ogg, mp4...) with
a nice graphical interface and is starting to do some transcoding
<listitem><para>VLS is good at streaming DVDs, satellite
channels and digital terrestial TV channels, but cannot do
<para>In general, VLC has more features, but VLS is more
<para>To be a real streamer, VLC would need to be able to read multiple
sources at the same time. VLS can do this since it's origin, but VLC
can't do this for the moment. Some VLC developers are working on a new
version of the VLC input, known as "Input 4", which should address this
<qandaentry><question><para>Isn't it a waste of time to develop both
<para>To understand this situation, you must consider the history of VideoLAN.
Before VLC's stream output, we had two very different programs :</para>
<listitem><para>VLS, a Linux-only program written in C++, that is
basically a MPEG Transport Stream engine, with a very basic telnet
<listitem><para>VLC, a multi-plateform program written in C, that
implements demuxers, codecs, video and audio outputs and graphical
<para>In september 2002, some VLC developers had the idea of taking
advantage of the multiple demuxers and codecs implemented in VLC
to build a Stream Ouput who's ultimate goal was to be able to do
transcoding. They wrote a stream output for VLC, that was released with
VLC 0.5.0 in late January 2003. VLC's stream output is now beginning to
do some transcoding.</para>
<para>But what is more important is that VLS and VLC developers are not
the same persons ; and that they are free to developer the software they
prefer... ! That's how free software runs, and it has shown in the past
that is was a good engine for innovation and enhancement.</para>
<qandadiv><title>Legal concerns</title>
<qandaentry><question><para>May I use the VideoLAN logo?</para></question>
<para>You may freely use the VideoLAN logo using the following
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.
<qandaentry><question><para>May I redistribute a VideoLAN
<para>You may distribute an original or modified version of a VideoLAN
software 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 lastest binary
version of VLC, you should also include all the files listed on the
<ulink url="">VLC
source code page</ulink>.</para>
<para>You do not need to bother explaining where the sources are, but
the sources have to share the same media as the products. There are
other ways to comply with the GPL, but this should be the simplest
because it does not rely on a contract.</para>
<note><para>You don't need to ask the VideoLAN team the permission to do
<qandaentry><question><para>Is libdvdcss legal?</para></question>
<para>The use and distribution of the libdvdcss library is controversial
in a few countries such as the United States because of a law called
the DMCA (Digital Millennium Copyright Act). If you are unsure about the
legality of using and distributing this library in your country, please
consult your lawyer.</para>
<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 on the <ulink
url="">contribute page</ulink>.
<qandaentry><question><para>Why are your mailing-lists and your website in
<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 VLC in various
languages, maintaining translations of our documentation and website
costs too much more time than we can afford.</para>
...@@ -71,18 +71,18 @@ ...@@ -71,18 +71,18 @@
<tr> <tr>
<td class="category"><b>VLC FAQ</b></td> <td class="category"><b>VideoLAN FAQ</b></td>
<td>Frequently Asked Questions of VLC users</td> <td>Frequently Asked Questions about VideoLAN</td>
<td class="yes">Up-to-date</td> <td class="yes">Up-to-date</td>
<td class="yes"><a href="/doc/faq-vlc/faq/">Yes</a></td> <td class="yes"><a href="/doc/faq/">Yes</a></td>
<td class="yes"><a href="/doc/faq-vlc/faq/">Yes</a></td> <td class="yes"><a href="/doc/faq/videolan-faq.html">Yes</a></td>
<td class="yes"><a href="/doc/faq-vlc/faq/">Yes</a></td> <td class="yes"><a href="/doc/faq/videolan-faq.pdf">Yes</a></td>
<td class="yes"><a href="/doc/faq-vlc/faq/">Yes</a></td> <td class="yes"><a href="/doc/faq/">Yes</a></td>
<td class="yes"><a href="/doc/faq-vlc/faq/">Yes</a></td> <td class="yes"><a href="/doc/faq/videolan-faq.rtf">Yes</a></td>
<td class="yes"><a href="/doc/faq-vlc/faq/FAQ-vlc.txt">Yes</a></td> <td class="yes"><a href="/doc/faq/videolan-faq.txt">Yes</a></td>
</tr> </tr>
</table> </table>
<? footer('$Id: index.html,v 1.31 2003/05/05 12:56:35 alexis Exp $'); ?> <? footer('$Id: index.html,v 1.32 2003/05/25 14:58:38 alexis Exp $'); ?>
...@@ -15,7 +15,7 @@ html: ...@@ -15,7 +15,7 @@ html:
sgmltools -b html -s ../common/stylesheet-html.dsl $(DOC).sgml sgmltools -b html -s ../common/stylesheet-html.dsl $(DOC).sgml
mv $(DOC)/*.html . mv $(DOC)/*.html .
rmdir $(DOC) rmdir $(DOC)
ln -sf book1.html index.html ln -sf $(DOC).html index.html
rm -f $(DOC) rm -f $(DOC)
zip $(DOC) *.html images/*.jpg zip $(DOC) *.html images/*.jpg
...@@ -20,7 +20,7 @@ ...@@ -20,7 +20,7 @@
]> ]>
<book> <book id="videolan-howto">
<bookinfo> <bookinfo>
...@@ -15,7 +15,7 @@ html: ...@@ -15,7 +15,7 @@ html:
sgmltools -b html -s ../common/stylesheet-html.dsl $(DOC).sgml sgmltools -b html -s ../common/stylesheet-html.dsl $(DOC).sgml
mv $(DOC)/*.html . mv $(DOC)/*.html .
rmdir $(DOC) rmdir $(DOC)
ln -sf book1.html index.html ln -sf $(DOC).html index.html
rm -f $(DOC) rm -f $(DOC)
zip $(DOC) *.html images/*.jpg zip $(DOC) *.html images/*.jpg
...@@ -17,7 +17,7 @@ ...@@ -17,7 +17,7 @@
]> ]>
<book> <book id="videolan-quickstart">
<bookinfo> <bookinfo>
...@@ -15,7 +15,7 @@ html: ...@@ -15,7 +15,7 @@ html:
sgmltools -b html -s ../common/stylesheet-html.dsl $(DOC).sgml sgmltools -b html -s ../common/stylesheet-html.dsl $(DOC).sgml
mv $(DOC)/*.html . mv $(DOC)/*.html .
rmdir $(DOC) rmdir $(DOC)
ln -sf book1.html index.html ln -sf $(DOC).html index.html
rm -f $(DOC) rm -f $(DOC)
zip $(DOC) *.html images/*.jpg zip $(DOC) *.html images/*.jpg
...@@ -16,7 +16,7 @@ ...@@ -16,7 +16,7 @@
]> ]>
<book> <book id="vlc-user-guide">
<bookinfo> <bookinfo>
...@@ -4,6 +4,17 @@ ...@@ -4,6 +4,17 @@
# Et pour les nouvelles importantes, c'est pas un | , c'est un § # Et pour les nouvelles importantes, c'est pas un | , c'est un §
# #
|25 May 2003| VLC FAQ becomes VideoLAN FAQ | The new VideoLAN FAQ is
available in multiple formats on the <a href="/doc/">documentation
page</a>. If you have remarks about it or would like new questions to be
integrated in it, post in one of the user mailing-lists.
|23 May 2003| VLC nominated at the Free Software
Trophies! | VLC was nominated at the <a
href="">Free Software
Trophies</a>, an international competition aimed at promoting the
developpment of free software, in the category "General Public".
|21 May 2003| Release: VLS 0.5.2 | This releases fixes a bug when |21 May 2003| Release: VLS 0.5.2 | This releases fixes a bug when
trying to stream multiple DVB channels and a bug in the configure trying to stream multiple DVB channels and a bug in the configure
script with DVB drivers. To download this new version, go to the <a script with DVB drivers. To download this new version, go to the <a
...@@ -157,6 +157,18 @@ download page</a>.</p></li> ...@@ -157,6 +157,18 @@ download page</a>.</p></li>
</td> </td>
</tr> </tr>
<td class="category">VideoLAN FAQ</td>
<td class="yes">Up-to-date</td>
<a href="/doc/faq/">HTML</a>
<a href="/doc/faq/videolan-faq.pdf">PDF</a>
<a href="/doc/faq/">PS</a>
<a href="/doc/faq/videolan-faq.rtf">RTF</a>
</table> </table>
<? footer('$Id: index.html,v 1.40 2003/05/16 22:50:42 alexis Exp $'); ?> <? footer('$Id: index.html,v 1.41 2003/05/25 14:58:38 alexis Exp $'); ?>
...@@ -144,13 +144,13 @@ libraries and build them yourself: ...@@ -144,13 +144,13 @@ libraries and build them yourself:
</tr> </tr>
<tr> <tr>
<td class="category">VLC FAQ</td> <td class="category">VideoLAN FAQ</td>
<td class="yes">Up-to-date</td> <td class="yes">Up-to-date</td>
<td> <td>
<a href="/doc/faq-vlc/faq/">HTML</a> <a href="/doc/faq/">HTML</a>
<a href="/doc/faq-vlc/faq/">PDF</a> <a href="/doc/faq/videolan-faq.pdf">PDF</a>
<a href="/doc/faq-vlc/faq/">PS</a> <a href="/doc/faq/">PS</a>
<a href="/doc/faq-vlc/faq/">RTF</a> <a href="/doc/faq/videolan-faq.rtf">RTF</a>
</td> </td>
</tr> </tr>
...@@ -169,4 +169,4 @@ libraries and build them yourself: ...@@ -169,4 +169,4 @@ libraries and build them yourself:
</tr> </tr>
</table> </table>
<? footer('$Id: index.html,v 1.58 2003/05/12 12:33:11 alexis Exp $'); ?> <? footer('$Id: index.html,v 1.59 2003/05/25 14:58:38 alexis Exp $'); ?>
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment