20 |
Permission is granted to copy, distribute and/or modify this document |
Permission is granted to copy, distribute and/or modify this document |
21 |
under the terms of the GNU Free Documentation License, Version 1.2 or |
under the terms of the GNU Free Documentation License, Version 1.2 or |
22 |
any later version published by the Free Software Foundation; with no |
any later version published by the Free Software Foundation; with no |
23 |
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A |
Invariant Sections, with the Front-Cover texts being ``A GNU Manual'', |
24 |
copy of the license is included in the section entitled ``GNU Free |
and with the Back-Cover Texts as in (a) below. A copy of the license |
25 |
Documentation License''. |
is included in the section entitled ``GNU Free Documentation License'' |
26 |
|
in the Emacs manual. |
27 |
|
|
28 |
|
(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify |
29 |
|
this GNU Manual, like GNU software. Copies published by the Free |
30 |
|
Software Foundation raise funds for GNU development.'' |
31 |
|
|
32 |
|
This document is part of a collection distributed under the GNU Free |
33 |
|
Documentation License. If you want to distribute this document |
34 |
|
separately from the collection, you can do so by adding a copy of the |
35 |
|
license to the document, as described in section 6 of the license. |
36 |
@end quotation |
@end quotation |
37 |
@end copying |
@end copying |
38 |
|
|
49 |
@author @uref{http://de.geocities.com/ulf_jasper} |
@author @uref{http://de.geocities.com/ulf_jasper} |
50 |
@page |
@page |
51 |
@vskip 0pt plus 1filll |
@vskip 0pt plus 1filll |
|
@insertcopying |
|
52 |
@end titlepage |
@end titlepage |
53 |
|
|
54 |
@contents |
@contents |
56 |
@ifnottex |
@ifnottex |
57 |
@node Top |
@node Top |
58 |
@top Newsticker |
@top Newsticker |
|
|
|
|
@insertcopying |
|
59 |
@end ifnottex |
@end ifnottex |
60 |
|
|
61 |
@menu |
@menu |
62 |
* Overview:: |
* Overview:: General description of newsticker. |
63 |
* Requirements:: |
* Requirements:: Requirements for using newsticker. |
64 |
* Installation:: |
* Installation:: Installing newsticker on your system. |
65 |
* Usage:: |
* Usage:: Basic newsticker instructions. |
66 |
* Configuration:: |
* Configuration:: Customizable newsticker settings. |
67 |
* Remarks:: |
* Remarks:: Remarks about newsticker. |
68 |
* GNU Free Documentation License:: |
* Index:: Variable, function, and concept index. |
|
* Index:: |
|
69 |
@end menu |
@end menu |
70 |
|
|
71 |
@node Overview |
@node Overview |
126 |
Place Newsticker in a directory where Emacs can find it. Add the |
Place Newsticker in a directory where Emacs can find it. Add the |
127 |
following line to your Emacs startup file (@file{~/.emacs}). |
following line to your Emacs startup file (@file{~/.emacs}). |
128 |
|
|
129 |
@example |
@lisp |
130 |
(add-to-list 'load-path "/path/to/newsticker/") |
(add-to-list 'load-path "/path/to/newsticker/") |
131 |
(autoload 'newsticker-start "newsticker" "Emacs Newsticker" t) |
(autoload 'newsticker-start "newsticker" "Emacs Newsticker" t) |
132 |
(autoload 'newsticker-show-news "newsticker" "Emacs Newsticker" t) |
(autoload 'newsticker-show-news "newsticker" "Emacs Newsticker" t) |
133 |
@end example |
@end lisp |
134 |
|
|
135 |
Newsticker-mode supports imenu. This allows for navigating with the |
Newsticker-mode supports imenu. This allows for navigating with the |
136 |
help of a menu. In order to use this feature you should also add the |
help of a menu. In order to use this feature you should also add the |
137 |
following. |
following. |
138 |
|
|
139 |
@example |
@lisp |
140 |
(add-hook 'newsticker-mode-hook 'imenu-add-menubar-index) |
(add-hook 'newsticker-mode-hook 'imenu-add-menubar-index) |
141 |
@end example |
@end lisp |
142 |
|
|
143 |
That's it. |
That's it. |
144 |
|
|
146 |
@chapter Usage |
@chapter Usage |
147 |
|
|
148 |
@findex newsticker-show-news |
@findex newsticker-show-news |
149 |
The command @command{newsticker-show-news} will display all available |
The command @code{newsticker-show-news} will display all available |
150 |
headlines in a special buffer, called @samp{*newsticker*}. It will |
headlines in a special buffer, called @samp{*newsticker*}. It will |
151 |
also start the asynchronous download of headlines. The modeline in |
also start the asynchronous download of headlines. The modeline in |
152 |
the @samp{*newsticker*} buffer informs whenever new headlines have |
the @samp{*newsticker*} buffer informs whenever new headlines have |
153 |
arrived. Clicking mouse-button 2 or pressing RET in this buffer on a |
arrived. Clicking mouse-button 2 or pressing RET in this buffer on a |
154 |
headline will call @command{browse-url} to load the corresponding news |
headline will call @code{browse-url} to load the corresponding news |
155 |
story in your favourite web browser. |
story in your favourite web browser. |
156 |
|
|
157 |
@findex newsticker-start-ticker |
@findex newsticker-start-ticker |
158 |
@findex newsticker-stop-ticker |
@findex newsticker-stop-ticker |
159 |
The scrolling, or flashing of headlines in the echo area, can be |
The scrolling, or flashing of headlines in the echo area, can be |
160 |
started with the command @command{newsticker-start-ticker}. It can be |
started with the command @code{newsticker-start-ticker}. It can be |
161 |
stopped with @command{newsticker-stop-ticker}. |
stopped with @code{newsticker-stop-ticker}. |
162 |
|
|
163 |
@findex newsticker-start |
@findex newsticker-start |
164 |
@findex newsticker-stop |
@findex newsticker-stop |
165 |
If you just want to start the periodic download of headlines use the |
If you just want to start the periodic download of headlines use the |
166 |
command @command{newsticker-start}. Calling @command{newsticker-stop} |
command @code{newsticker-start}. Calling @code{newsticker-stop} will |
167 |
will stop the periodic download, but will call |
stop the periodic download, but will call |
168 |
@command{newsticker-stop-ticker} as well. |
@code{newsticker-stop-ticker} as well. |
169 |
|
|
170 |
@node Configuration |
@node Configuration |
171 |
@chapter Configuration |
@chapter Configuration |
172 |
|
|
173 |
All Newsticker options are customizable, i.e. they can be changed with |
All Newsticker options are customizable, i.e. they can be changed with |
174 |
Emacs customization methods: Call the command |
Emacs customization methods: Call the command |
175 |
@command{customize-group} and enter @samp{newsticker} for the customization |
@code{customize-group} and enter @samp{newsticker} for the customization |
176 |
group. |
group. |
177 |
|
|
178 |
All Newsticker options have reasonable default values, so that in most |
All Newsticker options have reasonable default values, so that in most |
184 |
@itemize |
@itemize |
185 |
|
|
186 |
@item |
@item |
187 |
@command{newsticker-feed} contains options that define which news |
@code{newsticker-feed} contains options that define which news |
188 |
feeds are retrieved and how this is done. |
feeds are retrieved and how this is done. |
189 |
|
|
190 |
@itemize |
@itemize |
191 |
@item |
@item |
192 |
@vindex newsticker-url-list |
@vindex newsticker-url-list |
193 |
@command{newsticker-url-list} defines the list of headlines which are |
@code{newsticker-url-list} defines the list of headlines which are |
194 |
retrieved. |
retrieved. |
195 |
@item |
@item |
196 |
@vindex newsticker-retrieval-interval |
@vindex newsticker-retrieval-interval |
197 |
@command{newsticker-retrieval-interval} defines how often headlines |
@code{newsticker-retrieval-interval} defines how often headlines |
198 |
are retrieved. |
are retrieved. |
199 |
@end itemize |
@end itemize |
200 |
|
|
201 |
@item |
@item |
202 |
@command{newsticker-headline-processing} contains options that define |
@code{newsticker-headline-processing} contains options that define |
203 |
how the retrieved headlines are processed. |
how the retrieved headlines are processed. |
204 |
|
|
205 |
@itemize |
@itemize |
206 |
@item |
@item |
207 |
@vindex newsticker-keep-obsolete-items |
@vindex newsticker-keep-obsolete-items |
208 |
@command{newsticker-keep-obsolete-items} decides whether unread |
@code{newsticker-keep-obsolete-items} decides whether unread |
209 |
headlines that have been removed from the feed are kept in the |
headlines that have been removed from the feed are kept in the |
210 |
Newsticker cache. |
Newsticker cache. |
211 |
@end itemize |
@end itemize |
212 |
|
|
213 |
@item |
@item |
214 |
@command{newsticker-layout} contains options that define how the |
@code{newsticker-layout} contains options that define how the |
215 |
buffer for reading RSS headlines is formatted. |
buffer for reading RSS headlines is formatted. |
216 |
|
|
217 |
@itemize |
@itemize |
218 |
@item |
@item |
219 |
@vindex newsticker-heading-format |
@vindex newsticker-heading-format |
220 |
@command{newsticker-item-format} defines how the title of a headline |
@code{newsticker-item-format} defines how the title of a headline |
221 |
is formatted. |
is formatted. |
222 |
@end itemize |
@end itemize |
223 |
|
|
224 |
@item |
@item |
225 |
@command{newsticker-ticker} contains options that define how headlines |
@code{newsticker-ticker} contains options that define how headlines |
226 |
are shown in the echo area. |
are shown in the echo area. |
227 |
|
|
228 |
@itemize |
@itemize |
229 |
@item |
@item |
230 |
@vindex newsticker-display-interval |
@vindex newsticker-display-interval |
231 |
@vindex newsticker-scroll-smoothly |
@vindex newsticker-scroll-smoothly |
232 |
@command{newsticker-display-interval} and |
@code{newsticker-display-interval} and |
233 |
@command{newsticker-scroll-smoothly} define how headlines are shown in |
@code{newsticker-scroll-smoothly} define how headlines are shown in |
234 |
the echo area. |
the echo area. |
235 |
@end itemize |
@end itemize |
236 |
|
|
237 |
@item |
@item |
238 |
@command{newsticker-hooks} contains options for hooking other Emacs |
@code{newsticker-hooks} contains options for hooking other Emacs |
239 |
commands to newsticker functions. |
commands to newsticker functions. |
240 |
@itemize |
@itemize |
241 |
@item |
@item |
242 |
@vindex newsticker-new-item-functions |
@vindex newsticker-new-item-functions |
243 |
@command{newsticker-new-item-functions} allows for automatic |
@code{newsticker-new-item-functions} allows for automatic |
244 |
processing of headlines. See `newsticker-download-images', and |
processing of headlines. See `newsticker-download-images', and |
245 |
`newsticker-download-enclosures' for sample functions. |
`newsticker-download-enclosures' for sample functions. |
246 |
@end itemize |
@end itemize |
247 |
|
|
248 |
@item |
@item |
249 |
@command{newsticker-miscellaneous} contains other Newsticker options. |
@code{newsticker-miscellaneous} contains other Newsticker options. |
250 |
|
|
251 |
@end itemize |
@end itemize |
252 |
|
|
264 |
Byte-compiling newsticker.el is recommended. |
Byte-compiling newsticker.el is recommended. |
265 |
|
|
266 |
|
|
|
@node GNU Free Documentation License |
|
|
@chapter GNU Free Documentation License |
|
|
|
|
|
@verbatim |
|
|
|
|
|
GNU Free Documentation License |
|
|
============================== |
|
|
|
|
|
Version 1.2, November 2002 |
|
|
Copyright (C) 2000,2001,2002 Free Software Foundation, Inc. |
|
|
59 Temple Place, Suite 330, Boston, MA 02111-1307, USA |
|
|
|
|
|
Everyone is permitted to copy and distribute verbatim copies |
|
|
of this license document, but changing it is not allowed. |
|
|
|
|
|
0. PREAMBLE |
|
|
|
|
|
The purpose of this License is to make a manual, textbook, or other |
|
|
functional and useful document "free" in the sense of freedom: to |
|
|
assure everyone the effective freedom to copy and redistribute it, |
|
|
with or without modifying it, either commercially or |
|
|
noncommercially. Secondarily, this License preserves for the |
|
|
author and publisher a way to get credit for their work, while not |
|
|
being considered responsible for modifications made by others. |
|
|
|
|
|
This License is a kind of "copyleft", which means that derivative |
|
|
works of the document must themselves be free in the same sense. |
|
|
It complements the GNU General Public License, which is a copyleft |
|
|
license designed for free software. |
|
|
|
|
|
We have designed this License in order to use it for manuals for |
|
|
free software, because free software needs free documentation: a |
|
|
free program should come with manuals providing the same freedoms |
|
|
that the software does. But this License is not limited to |
|
|
software manuals; it can be used for any textual work, regardless |
|
|
of subject matter or whether it is published as a printed book. |
|
|
We recommend this License principally for works whose purpose is |
|
|
instruction or reference. |
|
|
|
|
|
1. APPLICABILITY AND DEFINITIONS |
|
|
|
|
|
This License applies to any manual or other work, in any medium, |
|
|
that contains a notice placed by the copyright holder saying it |
|
|
can be distributed under the terms of this License. Such a notice |
|
|
grants a world-wide, royalty-free license, unlimited in duration, |
|
|
to use that work under the conditions stated herein. The |
|
|
"Document", below, refers to any such manual or work. Any member |
|
|
of the public is a licensee, and is addressed as "you". You |
|
|
accept the license if you copy, modify or distribute the work in a |
|
|
way requiring permission under copyright law. |
|
|
|
|
|
A "Modified Version" of the Document means any work containing the |
|
|
Document or a portion of it, either copied verbatim, or with |
|
|
modifications and/or translated into another language. |
|
|
|
|
|
A "Secondary Section" is a named appendix or a front-matter section |
|
|
of the Document that deals exclusively with the relationship of the |
|
|
publishers or authors of the Document to the Document's overall |
|
|
subject (or to related matters) and contains nothing that could |
|
|
fall directly within that overall subject. (Thus, if the Document |
|
|
is in part a textbook of mathematics, a Secondary Section may not |
|
|
explain any mathematics.) The relationship could be a matter of |
|
|
historical connection with the subject or with related matters, or |
|
|
of legal, commercial, philosophical, ethical or political position |
|
|
regarding them. |
|
|
|
|
|
The "Invariant Sections" are certain Secondary Sections whose |
|
|
titles are designated, as being those of Invariant Sections, in |
|
|
the notice that says that the Document is released under this |
|
|
License. If a section does not fit the above definition of |
|
|
Secondary then it is not allowed to be designated as Invariant. |
|
|
The Document may contain zero Invariant Sections. If the Document |
|
|
does not identify any Invariant Sections then there are none. |
|
|
|
|
|
The "Cover Texts" are certain short passages of text that are |
|
|
listed, as Front-Cover Texts or Back-Cover Texts, in the notice |
|
|
that says that the Document is released under this License. A |
|
|
Front-Cover Text may be at most 5 words, and a Back-Cover Text may |
|
|
be at most 25 words. |
|
|
|
|
|
A "Transparent" copy of the Document means a machine-readable copy, |
|
|
represented in a format whose specification is available to the |
|
|
general public, that is suitable for revising the document |
|
|
straightforwardly with generic text editors or (for images |
|
|
composed of pixels) generic paint programs or (for drawings) some |
|
|
widely available drawing editor, and that is suitable for input to |
|
|
text formatters or for automatic translation to a variety of |
|
|
formats suitable for input to text formatters. A copy made in an |
|
|
otherwise Transparent file format whose markup, or absence of |
|
|
markup, has been arranged to thwart or discourage subsequent |
|
|
modification by readers is not Transparent. An image format is |
|
|
not Transparent if used for any substantial amount of text. A |
|
|
copy that is not "Transparent" is called "Opaque". |
|
|
|
|
|
Examples of suitable formats for Transparent copies include plain |
|
|
ASCII without markup, Texinfo input format, LaTeX input format, |
|
|
SGML or XML using a publicly available DTD, and |
|
|
standard-conforming simple HTML, PostScript or PDF designed for |
|
|
human modification. Examples of transparent image formats include |
|
|
PNG, XCF and JPG. Opaque formats include proprietary formats that |
|
|
can be read and edited only by proprietary word processors, SGML or |
|
|
XML for which the DTD and/or processing tools are not generally |
|
|
available, and the machine-generated HTML, PostScript or PDF |
|
|
produced by some word processors for output purposes only. |
|
|
|
|
|
The "Title Page" means, for a printed book, the title page itself, |
|
|
plus such following pages as are needed to hold, legibly, the |
|
|
material this License requires to appear in the title page. For |
|
|
works in formats which do not have any title page as such, "Title |
|
|
Page" means the text near the most prominent appearance of the |
|
|
work's title, preceding the beginning of the body of the text. |
|
|
|
|
|
A section "Entitled XYZ" means a named subunit of the Document |
|
|
whose title either is precisely XYZ or contains XYZ in parentheses |
|
|
following text that translates XYZ in another language. (Here XYZ |
|
|
stands for a specific section name mentioned below, such as |
|
|
"Acknowledgements", "Dedications", "Endorsements", or "History".) |
|
|
To "Preserve the Title" of such a section when you modify the |
|
|
Document means that it remains a section "Entitled XYZ" according |
|
|
to this definition. |
|
|
|
|
|
The Document may include Warranty Disclaimers next to the notice |
|
|
which states that this License applies to the Document. These |
|
|
Warranty Disclaimers are considered to be included by reference in |
|
|
this License, but only as regards disclaiming warranties: any other |
|
|
implication that these Warranty Disclaimers may have is void and |
|
|
has no effect on the meaning of this License. |
|
|
|
|
|
2. VERBATIM COPYING |
|
|
|
|
|
You may copy and distribute the Document in any medium, either |
|
|
commercially or noncommercially, provided that this License, the |
|
|
copyright notices, and the license notice saying this License |
|
|
applies to the Document are reproduced in all copies, and that you |
|
|
add no other conditions whatsoever to those of this License. You |
|
|
may not use technical measures to obstruct or control the reading |
|
|
or further copying of the copies you make or distribute. However, |
|
|
you may accept compensation in exchange for copies. If you |
|
|
distribute a large enough number of copies you must also follow |
|
|
the conditions in section 3. |
|
|
|
|
|
You may also lend copies, under the same conditions stated above, |
|
|
and you may publicly display copies. |
|
|
|
|
|
3. COPYING IN QUANTITY |
|
|
|
|
|
If you publish printed copies (or copies in media that commonly |
|
|
have printed covers) of the Document, numbering more than 100, and |
|
|
the Document's license notice requires Cover Texts, you must |
|
|
enclose the copies in covers that carry, clearly and legibly, all |
|
|
these Cover Texts: Front-Cover Texts on the front cover, and |
|
|
Back-Cover Texts on the back cover. Both covers must also clearly |
|
|
and legibly identify you as the publisher of these copies. The |
|
|
front cover must present the full title with all words of the |
|
|
title equally prominent and visible. You may add other material |
|
|
on the covers in addition. Copying with changes limited to the |
|
|
covers, as long as they preserve the title of the Document and |
|
|
satisfy these conditions, can be treated as verbatim copying in |
|
|
other respects. |
|
|
|
|
|
If the required texts for either cover are too voluminous to fit |
|
|
legibly, you should put the first ones listed (as many as fit |
|
|
reasonably) on the actual cover, and continue the rest onto |
|
|
adjacent pages. |
|
|
|
|
|
If you publish or distribute Opaque copies of the Document |
|
|
numbering more than 100, you must either include a |
|
|
machine-readable Transparent copy along with each Opaque copy, or |
|
|
state in or with each Opaque copy a computer-network location from |
|
|
which the general network-using public has access to download |
|
|
using public-standard network protocols a complete Transparent |
|
|
copy of the Document, free of added material. If you use the |
|
|
latter option, you must take reasonably prudent steps, when you |
|
|
begin distribution of Opaque copies in quantity, to ensure that |
|
|
this Transparent copy will remain thus accessible at the stated |
|
|
location until at least one year after the last time you |
|
|
distribute an Opaque copy (directly or through your agents or |
|
|
retailers) of that edition to the public. |
|
|
|
|
|
It is requested, but not required, that you contact the authors of |
|
|
the Document well before redistributing any large number of |
|
|
copies, to give them a chance to provide you with an updated |
|
|
version of the Document. |
|
|
|
|
|
4. MODIFICATIONS |
|
|
|
|
|
You may copy and distribute a Modified Version of the Document |
|
|
under the conditions of sections 2 and 3 above, provided that you |
|
|
release the Modified Version under precisely this License, with |
|
|
the Modified Version filling the role of the Document, thus |
|
|
licensing distribution and modification of the Modified Version to |
|
|
whoever possesses a copy of it. In addition, you must do these |
|
|
things in the Modified Version: |
|
|
|
|
|
A. 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. |
|
|
|
|
|
B. 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. |
|
|
|
|
|
C. State on the Title page the name of the publisher of the |
|
|
Modified Version, as the publisher. |
|
|
|
|
|
D. Preserve all the copyright notices of the Document. |
|
|
|
|
|
E. Add an appropriate copyright notice for your modifications |
|
|
adjacent to the other copyright notices. |
|
|
|
|
|
F. Include, immediately after the copyright notices, a license |
|
|
notice giving the public permission to use the Modified |
|
|
Version under the terms of this License, in the form shown in |
|
|
the Addendum below. |
|
|
|
|
|
G. Preserve in that license notice the full lists of Invariant |
|
|
Sections and required Cover Texts given in the Document's |
|
|
license notice. |
|
|
|
|
|
H. Include an unaltered copy of this License. |
|
|
|
|
|
I. 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. |
|
|
|
|
|
J. 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. |
|
|
|
|
|
K. 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. |
|
|
|
|
|
L. 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. |
|
|
|
|
|
M. Delete any section Entitled "Endorsements". Such a section |
|
|
may not be included in the Modified Version. |
|
|
|
|
|
N. Do not retitle any existing section to be Entitled |
|
|
"Endorsements" or to conflict in title with any Invariant |
|
|
Section. |
|
|
|
|
|
O. Preserve any Warranty Disclaimers. |
|
|
|
|
|
If the Modified Version includes new front-matter sections or |
|
|
appendices that qualify as Secondary Sections and contain no |
|
|
material copied from the Document, you may at your option |
|
|
designate some or all of these sections as invariant. To do this, |
|
|
add their titles to the list of Invariant Sections in the Modified |
|
|
Version's license notice. These titles must be distinct from any |
|
|
other section titles. |
|
|
|
|
|
You may add a section Entitled "Endorsements", provided it contains |
|
|
nothing but endorsements of your Modified Version by various |
|
|
parties--for example, statements of peer review or that the text |
|
|
has been approved by an organization as the authoritative |
|
|
definition of a standard. |
|
|
|
|
|
You may add a passage of up to five words as a Front-Cover Text, |
|
|
and a passage of up to 25 words as a Back-Cover Text, to the end |
|
|
of the list of Cover Texts in the Modified Version. Only one |
|
|
passage of Front-Cover Text and one of Back-Cover Text may be |
|
|
added by (or through arrangements made by) any one entity. If the |
|
|
Document already includes a cover text for the same cover, |
|
|
previously added by you or by arrangement made by the same entity |
|
|
you are acting on behalf of, you may not add another; but you may |
|
|
replace the old one, on explicit permission from the previous |
|
|
publisher that added the old one. |
|
|
|
|
|
The author(s) and publisher(s) of the Document do not by this |
|
|
License give permission to use their names for publicity for or to |
|
|
assert or imply endorsement of any Modified Version. |
|
|
|
|
|
5. COMBINING DOCUMENTS |
|
|
|
|
|
You may combine the Document with other documents released under |
|
|
this License, under the terms defined in section 4 above for |
|
|
modified versions, provided that you include in the combination |
|
|
all of the Invariant Sections of all of the original documents, |
|
|
unmodified, and list them all as Invariant Sections of your |
|
|
combined work in its license notice, and that you preserve all |
|
|
their Warranty Disclaimers. |
|
|
|
|
|
The combined work need only contain one copy of this License, and |
|
|
multiple identical Invariant Sections may be replaced with a single |
|
|
copy. If there are multiple Invariant Sections with the same name |
|
|
but different contents, make the title of each such section unique |
|
|
by adding at the end of it, in parentheses, the name of the |
|
|
original author or publisher of that section if known, or else a |
|
|
unique number. Make the same adjustment to the section titles in |
|
|
the list of Invariant Sections in the license notice of the |
|
|
combined work. |
|
|
|
|
|
In the combination, you must combine any sections Entitled |
|
|
"History" in the various original documents, forming one section |
|
|
Entitled "History"; likewise combine any sections Entitled |
|
|
"Acknowledgements", and any sections Entitled "Dedications". You |
|
|
must delete all sections Entitled "Endorsements." |
|
|
|
|
|
6. COLLECTIONS OF DOCUMENTS |
|
|
|
|
|
You may make a collection consisting of the Document and other |
|
|
documents released under this License, and replace the individual |
|
|
copies of this License in the various documents with a single copy |
|
|
that is included in the collection, provided that you follow the |
|
|
rules of this License for verbatim copying of each of the |
|
|
documents in all other respects. |
|
|
|
|
|
You may extract a single document from such a collection, and |
|
|
distribute it individually under this License, provided you insert |
|
|
a copy of this License into the extracted document, and follow |
|
|
this License in all other respects regarding verbatim copying of |
|
|
that document. |
|
|
|
|
|
7. AGGREGATION WITH INDEPENDENT WORKS |
|
|
|
|
|
A compilation of the Document or its derivatives with other |
|
|
separate and independent documents or works, in or on a volume of |
|
|
a storage or distribution medium, is called an "aggregate" if the |
|
|
copyright resulting from the compilation is not used to limit the |
|
|
legal rights of the compilation's users beyond what the individual |
|
|
works permit. When the Document is included in an aggregate, this |
|
|
License does not apply to the other works in the aggregate which |
|
|
are not themselves derivative works of the Document. |
|
|
|
|
|
If the Cover Text requirement of section 3 is applicable to these |
|
|
copies of the Document, then if the Document is less than one half |
|
|
of the entire aggregate, the Document's Cover Texts may be placed |
|
|
on covers that bracket the Document within the aggregate, or the |
|
|
electronic equivalent of covers if the Document is in electronic |
|
|
form. Otherwise they must appear on printed covers that bracket |
|
|
the whole aggregate. |
|
|
|
|
|
8. TRANSLATION |
|
|
|
|
|
Translation is considered a kind of modification, so you may |
|
|
distribute translations of the Document under the terms of section |
|
|
4. Replacing Invariant Sections with translations requires special |
|
|
permission from their copyright holders, but you may include |
|
|
translations of some or all Invariant Sections in addition to the |
|
|
original versions of these Invariant Sections. You may include a |
|
|
translation of this License, and all the license notices in the |
|
|
Document, and any Warranty Disclaimers, provided that you also |
|
|
include the original English version of this License and the |
|
|
original versions of those notices and disclaimers. In case of a |
|
|
disagreement between the translation and the original version of |
|
|
this License or a notice or disclaimer, the original version will |
|
|
prevail. |
|
|
|
|
|
If a section in the Document is Entitled "Acknowledgements", |
|
|
"Dedications", or "History", the requirement (section 4) to |
|
|
Preserve its Title (section 1) will typically require changing the |
|
|
actual title. |
|
|
|
|
|
9. TERMINATION |
|
|
|
|
|
You may not copy, modify, sublicense, or distribute the Document |
|
|
except as expressly provided for under this License. Any other |
|
|
attempt to copy, modify, sublicense or distribute the Document is |
|
|
void, and will automatically terminate your rights under this |
|
|
License. However, parties who have received copies, or rights, |
|
|
from you under this License will not have their licenses |
|
|
terminated so long as such parties remain in full compliance. |
|
|
|
|
|
10. FUTURE REVISIONS OF THIS LICENSE |
|
|
|
|
|
The Free Software Foundation may publish new, revised versions of |
|
|
the GNU Free Documentation License from time to time. Such new |
|
|
versions will be similar in spirit to the present version, but may |
|
|
differ in detail to address new problems or concerns. See |
|
|
`http://www.gnu.org/copyleft/'. |
|
|
|
|
|
Each version of the License is given a distinguishing version |
|
|
number. If the Document specifies that a particular numbered |
|
|
version of this License "or any later version" applies to it, you |
|
|
have the option of following the terms and conditions either of |
|
|
that specified version or of any later version that has been |
|
|
published (not as a draft) by the Free Software Foundation. If |
|
|
the Document does not specify a version number of this License, |
|
|
you may choose any version ever published (not as a draft) by the |
|
|
Free Software Foundation. |
|
|
|
|
|
@end verbatim |
|
267 |
|
|
268 |
@node Index |
@node Index |
269 |
@unnumbered Index |
@unnumbered Index |