mirror of
https://code.videolan.org/videolan/vlc
synced 2024-07-29 11:58:24 +02:00
* doc/faq/Makefile: added "text" and "clean" targets.
* doc/faq/faq-alone.sgml: Fixed build issues, added FDL, and legal notice. * doc/faq/faq.sgml: Fixed build issues, improved the SGML translation. * doc/faq/fdl.sgml: text of the FSF Free Documentation License.
This commit is contained in:
parent
17f4d010b4
commit
e3fa732acd
@ -1,4 +1,4 @@
|
||||
all: html
|
||||
all: clean html
|
||||
|
||||
html:
|
||||
rm -f *.html
|
||||
@ -7,3 +7,8 @@ html:
|
||||
rmdir faq-alone
|
||||
ln -s book1.html index.html
|
||||
|
||||
clean:
|
||||
rm -f *.html *.txt
|
||||
|
||||
txt:
|
||||
sgmltools -b txt faq-alone.sgml
|
||||
|
@ -2,25 +2,44 @@
|
||||
[
|
||||
|
||||
<!ENTITY faq SYSTEM "faq.sgml">
|
||||
|
||||
<!ENTITY fdl SYSTEM "fdl.sgml">
|
||||
]>
|
||||
|
||||
<book>
|
||||
|
||||
<bookinfo>
|
||||
|
||||
<title>Frequently Asked Questions</title>
|
||||
<title>Frequently Asked Questions for the VideoLAN Client</title>
|
||||
|
||||
<copyright>
|
||||
<year>2002, 2003</year>
|
||||
<holder>the VideoLAN project</holder>
|
||||
</copyright>
|
||||
|
||||
</bookinfo>
|
||||
<legalnotice>
|
||||
|
||||
<para>
|
||||
Permission is granted to copy, distribute and/or modify this document
|
||||
under the terms of the GNU Free Documentation License, Version 1.1 or
|
||||
any later version published by the Free Software Foundation ; 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
|
||||
<xref linkend="gfdl" endterm="tgfdl">.</para>
|
||||
|
||||
</legalnotice>
|
||||
|
||||
|
||||
|
||||
<abstract>
|
||||
|
||||
<para>This document is the FAQ (Frequently Asked Questions) for the VideoLAN Client. For a complete user guide, please have a look at the VideoLAN Client User Guide, available on the <ulink url="http://www.videolan.org">VideoLAN Website</ulink>
|
||||
</abstract>
|
||||
|
||||
</bookinfo>
|
||||
|
||||
<toc></toc>
|
||||
|
||||
&faq;
|
||||
&fdl;
|
||||
|
||||
</book>
|
||||
|
116
doc/faq/faq.sgml
116
doc/faq/faq.sgml
@ -1,3 +1,5 @@
|
||||
<chapter id="faq"><title id="tfaq">FAQ of the VideoLAN Client</title>
|
||||
|
||||
<qandaset><title>FAQ of the VideoLAN Client</title>
|
||||
|
||||
<qandadiv><title>Using the VideoLAN Client</title>
|
||||
@ -8,7 +10,7 @@
|
||||
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>
|
||||
<screen><prompt>% </prompt><userinput>vlc dvd:/dev/dvd</userinput></screen>
|
||||
|
||||
</para></answer></qandaentry>
|
||||
|
||||
@ -40,66 +42,61 @@ devices support full screen.
|
||||
<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>
|
||||
<answer><para>You can run:</para>
|
||||
<screen><prompt>% </prompt><userinput> vlc --intf dummy myfile.mpg</userinput>
|
||||
</screen>
|
||||
<para>Most commands are available from the command line, see <command>vlc
|
||||
--help</command> 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 :-).
|
||||
<question><para>VLC eats my buffer cache, how can I use raw device?</para></question>
|
||||
<answer><para>If you do not know what is a raw device, do not even read this answer :-).</para><para>
|
||||
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>
|
||||
instance:</para>
|
||||
<screen><prompt>% </prompt><userinput>vlc dvd:/dev/dvd@/dev/raw0</userinput></screen>
|
||||
</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:
|
||||
documentation of these programs. Then start VLC:</para>
|
||||
|
||||
<screen><prompt>%</prompt><userinput>vlc udp:</userinput></screen>
|
||||
<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:
|
||||
<para>You should not need any option. If you are paranoid and want to control
|
||||
everything, here is the exact syntax:</para>
|
||||
|
||||
<screen><prompt>%</prompt><userinput>vlc udp:[<server>[:<server port>]][@[<bind address>][:<bind port>]]</userinput></screen>
|
||||
<screen><prompt>% </prompt><userinput>vlc udp:[<server>[:<server port>]][@[<bind address>][:<bind port>]]</userinput></screen>
|
||||
|
||||
</para></answer></qandaentry>
|
||||
</answer></qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question><para>How do I uninstall / reinstall VLC?</para></question>
|
||||
<answer><para>Why would you want to? ;)
|
||||
|
||||
<answer><para>Why would you want to? ;)</para>
|
||||
<para>
|
||||
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.
|
||||
|
||||
</para><para>
|
||||
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>
|
||||
<answer>
|
||||
<programlisting>
|
||||
deb http://www.videolan.org/pub/videolan/debian $(ARCH)/
|
||||
deb-src http://www.videolan.org/pub/videolan/debian sources/
|
||||
</programlisting>
|
||||
|
||||
</para></answer></qandaentry>
|
||||
</answer></qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question><para>How can I save my VLC configuration?</para></question>
|
||||
@ -153,13 +150,12 @@ 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>Do you have write access to your DVD device? For instance, under Unix, <command>chmod 666 /dev/hdc</command> </para></listitem>
|
||||
|
||||
<listitem><para>Does your kernel log contain line about your DVD device?</para></listitem>
|
||||
<listitem><para>Under Unix, 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>
|
||||
<listitem><para>Under Unix, 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>
|
||||
@ -172,24 +168,22 @@ Here are a few things to check for:
|
||||
<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:
|
||||
instance:</para>
|
||||
|
||||
<screen>
|
||||
<prompt>%</prompt><userinput>vlc --vout sdl</userinput>
|
||||
<prompt>%</prompt><userinput>vlc --vout x11</userinput>
|
||||
<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
|
||||
<para>Second, change your screen depth and/or definition. It quite often helps.
|
||||
Lastly, if running Unix, 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
|
||||
<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 Linux. Here are
|
||||
some elements to improve speed:
|
||||
</para>
|
||||
|
||||
@ -206,7 +200,7 @@ 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>
|
||||
<screen><prompt>% </prompt><userinput>vlc -vvvv</userinput></screen>
|
||||
</listitem>
|
||||
|
||||
<listitem><para>Kill other applications running...</para></listitem>
|
||||
@ -222,8 +216,7 @@ video board</para>
|
||||
<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.
|
||||
kill <emphasis>esd</emphasis> or <emphasis>artsd</emphasis> if they are running. This is a known problem and is being investigated.
|
||||
|
||||
</para></answer></qandaentry>
|
||||
|
||||
@ -254,7 +247,7 @@ terminal or in the Messages window).
|
||||
</para></answer></qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question><para>I can only play a DVD as root</para></question>
|
||||
<question><para>Under Unices, 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>
|
||||
@ -271,10 +264,10 @@ in the videolan subfolder of your <filename>Application Data</filename> director
|
||||
<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
|
||||
command line.</para><para>
|
||||
For instance on Windows, you need to open a Command Line console, 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>
|
||||
<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>
|
||||
@ -285,7 +278,7 @@ You will then be able to modify the configuration again and save it.
|
||||
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.
|
||||
launching VLC (0.4.5 or later) with <command>--vls-backwards-compat</command>.
|
||||
|
||||
</para></answer></qandaentry>
|
||||
|
||||
@ -320,8 +313,7 @@ information on them.
|
||||
|
||||
<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.
|
||||
<answer><para>This is a known problem with Win 95-class systems (ie, Windows 95/98/Me). Upgrade to an NT-class system (ie, Windows NT/2000 or XP).
|
||||
</para></answer></qandaentry>
|
||||
|
||||
</qandadiv>
|
||||
@ -334,19 +326,16 @@ system.
|
||||
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:@<mcast addr>:<local port>.
|
||||
|
||||
</para></answer></qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
@ -354,7 +343,6 @@ Systems and completing the functionalities.
|
||||
<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>
|
||||
@ -374,12 +362,12 @@ screen capture of the video displayed by vlc.
|
||||
<qandaentry>
|
||||
<question><para>May I use the VideoLAN logo?</para></question>
|
||||
<answer><para>You may freely use the VideoLAN logo using the following copyright:
|
||||
|
||||
<emphasis>
|
||||
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.
|
||||
|
||||
</emphasis>
|
||||
</para></answer></qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
@ -391,25 +379,26 @@ 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:
|
||||
|
||||
</para>
|
||||
<programlisting>
|
||||
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/
|
||||
|
||||
</programlisting><para>
|
||||
You do not need to bother explaining where the sources are, but the
|
||||
sources have to share the same media as the products.
|
||||
|
||||
</para><para>
|
||||
They are other ways to comply with the GPL, but this should be the
|
||||
simplest because it does not rely on a contract.
|
||||
|
||||
</para><para>
|
||||
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>
|
||||
@ -431,3 +420,4 @@ more time than we can afford.
|
||||
|
||||
</qandadiv>
|
||||
</qandaset>
|
||||
</chapter>
|
||||
|
431
doc/faq/fdl.sgml
Normal file
431
doc/faq/fdl.sgml
Normal file
@ -0,0 +1,431 @@
|
||||
<appendix id="gfdl">
|
||||
<title id="tgfdl">GNU Free Documentation License</title>
|
||||
<subtitle>Version 1.2, November 2002</subtitle>
|
||||
|
||||
<blockquote id="fsf-copyright">
|
||||
<para>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.</para>
|
||||
</blockquote>
|
||||
|
||||
<section id="gfdl-0"><title>PREAMBLE</title>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-1"><title>APPLICABILITY AND DEFINITIONS</title>
|
||||
|
||||
<para id="gfdl-doc">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.</para>
|
||||
|
||||
<para id="gfdl-mod-ver">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.</para>
|
||||
|
||||
<para id="gfdl-secnd-sect">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.</para>
|
||||
|
||||
<para id="gfdl-inv-sect">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.</para>
|
||||
|
||||
<para id="gfdl-cov-text">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.</para>
|
||||
|
||||
<para id="gfdl-transparent">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".</para>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para id="gfdl-title-page">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.</para>
|
||||
|
||||
<para id="gfdl-entitled">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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-2"><title>VERBATIM COPYING</title>
|
||||
|
||||
<para>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.
|
||||
</para>
|
||||
|
||||
<para>You may also lend copies, under the same conditions stated above,
|
||||
and you may publicly display copies.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-3"><title>COPYING IN QUANTITY</title>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-4"><title>MODIFICATIONS</title>
|
||||
|
||||
<para>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:</para>
|
||||
|
||||
<orderedlist id="gfdl-modif-cond" numeration="upperalpha">
|
||||
<listitem><simpara>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.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>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.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>State on the Title page the name of the publisher of
|
||||
the Modified Version, as the publisher.</simpara></listitem>
|
||||
<listitem><simpara>Preserve all the copyright notices of the Document.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>Add an appropriate copyright notice for your
|
||||
modifications adjacent to the other copyright notices.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>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
|
||||
<link linkend="gfdl-addendum">Addendum</link> below.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>Preserve in that license notice the full lists of
|
||||
Invariant Sections and required Cover Texts given in the Document's
|
||||
license notice.</simpara></listitem>
|
||||
<listitem><simpara>Include an unaltered copy of this License.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>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.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>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.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>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.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>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.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>Delete any section Entitled "Endorsements".
|
||||
Such a section may not be included in the Modified Version.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>Do not retitle any existing section to be Entitled
|
||||
"Endorsements" or to conflict in title with any Invariant Section.
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>Preserve any Warranty Disclaimers.
|
||||
</simpara></listitem>
|
||||
</orderedlist>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-5"><title>COMBINING DOCUMENTS</title>
|
||||
|
||||
<para>You may combine the Document with other documents released under
|
||||
this License, under the terms defined in <link linkend="gfdl-4">section
|
||||
4</link> 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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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".</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-6"><title>COLLECTIONS OF DOCUMENTS</title>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-7"><title>AGGREGATION WITH INDEPENDENT WORKS</title>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-8"><title>TRANSLATION</title>
|
||||
|
||||
<para>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.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-9"><title>TERMINATION</title>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-10"><title>FUTURE REVISIONS OF THIS LICENSE</title>
|
||||
|
||||
<para>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/.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
|
||||
<section id="gfdl-addendum"><title>ADDENDUM: How to use this License for
|
||||
your documents</title>
|
||||
|
||||
<para>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:</para>
|
||||
|
||||
<blockquote id="copyright-sample"><para>
|
||||
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".
|
||||
</para></blockquote>
|
||||
|
||||
<para>If you have Invariant Sections, Front-Cover Texts and Back-Cover
|
||||
Texts, replace the "with...Texts." line with this:</para>
|
||||
|
||||
<blockquote id="inv-cover-sample"><para>
|
||||
with the Invariant Sections being LIST THEIR TITLES, with the
|
||||
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
|
||||
</para></blockquote>
|
||||
|
||||
<para>If you have Invariant Sections without Cover Texts, or some other
|
||||
combination of the three, merge those two alternatives to suit the
|
||||
situation.</para>
|
||||
|
||||
<para>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.</para>
|
||||
</section>
|
||||
</appendix>
|
Loading…
Reference in New Issue
Block a user