annotate man/newsticker.texi @ 65527:1b029723f4d8

(move_it_vertically): Don't try to fetch byte BEGV-1. (reseat_at_next_visible_line_start): Likewise (in xassert).
author Kim F. Storm <storm@cua.dk>
date Thu, 15 Sep 2005 12:06:39 +0000
parents bc64e5ea4657
children df114c065371
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
65496
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
1 \input texinfo @c -*-texinfo-*-
65497
bc64e5ea4657 Add arch tagline
Miles Bader <miles@gnu.org>
parents: 65496
diff changeset
2 @comment $Id: newsticker.texi,v 1.1 2005/09/13 15:50:31 rms Exp $
65496
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
3 @comment %**start of header
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
4 @setfilename newsticker.info
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
5 @set VERSION 1.8
65497
bc64e5ea4657 Add arch tagline
Miles Bader <miles@gnu.org>
parents: 65496
diff changeset
6 @set UPDATED ``$Id: newsticker.texi,v 1.1 2005/09/13 15:50:31 rms Exp $''
65496
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
7 @settitle Newsticker @value{VERSION}
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
8 @syncodeindex vr cp
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
9 @syncodeindex fn cp
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
10 @syncodeindex pg cp
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
11 @comment %**end of header
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
12
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
13 @copying
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
14 This manual is for Newsticker (version @value{VERSION}, @value{UPDATED}).
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
15
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
16 @noindent
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
17 Copyright @copyright{} 2004, 2005 Free Software Foundation, Inc.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
18
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
19 @quotation
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
20 Permission is granted to copy, distribute and/or modify this document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
21 under the terms of the GNU Free Documentation License, Version 1.2 or
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
22 any later version published by the Free Software Foundation; with no
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
23 Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
24 copy of the license is included in the section entitled ``GNU Free
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
25 Documentation License''.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
26 @end quotation
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
27 @end copying
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
28
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
29 @dircategory Emacs
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
30 @direntry
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
31 * Newsticker: (newsticker). A Newsticker for Emacs.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
32 @end direntry
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
33
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
34 @titlepage
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
35 @title Newsticker -- a Newsticker for Emacs
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
36 @subtitle for version @value{VERSION}, @value{UPDATED}
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
37 @author Ulf Jasper
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
38 @author @email{ulf.jasper@@web.de}
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
39 @author @uref{http://de.geocities.com/ulf_jasper}
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
40 @page
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
41 @vskip 0pt plus 1filll
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
42 @insertcopying
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
43 @end titlepage
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
44
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
45 @contents
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
46
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
47 @ifnottex
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
48 @node Top
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
49 @top Newsticker
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
50
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
51 @insertcopying
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
52 @end ifnottex
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
53
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
54 @menu
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
55 * Overview::
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
56 * Requirements::
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
57 * Installation::
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
58 * Usage::
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
59 * Configuration::
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
60 * Remarks::
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
61 * GNU Free Documentation License::
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
62 * Index::
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
63 @end menu
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
64
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
65 @node Overview
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
66 @chapter Overview
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
67
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
68 Newsticker provides a newsticker for Emacs. A newsticker is a thing
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
69 that asynchronously retrieves headlines from a list of news sites,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
70 prepares these headlines for reading, and allows for loading the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
71 corresponding articles in a web browser.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
72
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
73 Headlines consist of a title and (possibly) a small description. They
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
74 are contained in RSS (RDF Site Summary) files. Newsticker should work
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
75 with all RSS files that follow the @uref{http://purl.org/rss/1.0/spec,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
76 RDF Rich Site Summary 1.0} specification. It should also work with
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
77 version 2.0 as well as other/older/alternative rss formats (like
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
78 0.9<something> or such). In other words: Newsticker is a ``RSS
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
79 reader'' or ``RSS aggregator''.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
80
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
81 Newsticker provides several commands for reading headlines, navigating
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
82 through them, marking them as read/unread, hiding old headlines etc.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
83 Headlines can be displayed as plain text or as rendered HTML.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
84
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
85 Headlines can be displayed in the echo area, either scrolling like
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
86 messages in a stock-quote ticker, or just changing.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
87
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
88 Newsticker allows for automatic processing of headlines by providing
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
89 hooks and (sample) functions for automatically downloading images and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
90 enclosed files (as delivered by podcasts, e.g.).
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
91
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
92 @ifhtml
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
93 Here are screen shots of the @uref{newsticker-1.7.png, version 1.7
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
94 (current version)} and some older screen shots:
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
95 @uref{newsticker-1.6.png, version 1.6},
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
96 @uref{newsticker-1.5.png, version 1.5},
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
97 @uref{newsticker-1.4.png, version 1.4}
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
98 @uref{newsticker-1.3.png, version 1.3},
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
99 @uref{newsticker-1.0.png, version 1.0}.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
100 @end ifhtml
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
101
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
102 @node Requirements
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
103 @chapter Requirements
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
104
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
105 Newsticker can be used with
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
106 @uref{http://www.gnu.org/software/emacs/emacs.html, GNU Emacs} version
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
107 21.1 or later as well as @uref{http://www.xemacs.org, XEmacs}. It
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
108 requires an XML-parser (@file{xml.el}) which is part of GNU Emacs. If
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
109 you are using XEmacs you want to get the @file{net-utils} package
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
110 which contains @file{xml.el} for XEmacs.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
111
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
112 Newsticker requires a program which can retrieve files via http and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
113 prints them to stdout. By default Newsticker will use
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
114 @uref{http://www.gnu.org/software/wget/wget.html, wget} for this task.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
115
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
116
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
117 @node Installation
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
118 @chapter Installation
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
119
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
120 Place Newsticker in a directory where Emacs can find it. Add the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
121 following line to your Emacs startup file (@file{~/.emacs}).
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
122
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
123 @example
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
124 (add-to-list 'load-path "/path/to/newsticker/")
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
125 (autoload 'newsticker-start "newsticker" "Emacs Newsticker" t)
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
126 (autoload 'newsticker-show-news "newsticker" "Emacs Newsticker" t)
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
127 @end example
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
128
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
129 Newsticker-mode supports imenu. This allows for navigating with the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
130 help of a menu. In order to use this feature you should also add the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
131 following.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
132
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
133 @example
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
134 (add-hook 'newsticker-mode-hook 'imenu-add-menubar-index)
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
135 @end example
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
136
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
137 That's it.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
138
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
139 @node Usage
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
140 @chapter Usage
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
141
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
142 @findex newsticker-show-news
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
143 The command @command{newsticker-show-news} will display all available
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
144 headlines in a special buffer, called @samp{*newsticker*}. It will
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
145 also start the asynchronous download of headlines. The modeline in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
146 the @samp{*newsticker*} buffer informs whenever new headlines have
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
147 arrived. Clicking mouse-button 2 or pressing RET in this buffer on a
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
148 headline will call @command{browse-url} to load the corresponding news
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
149 story in your favourite web browser.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
150
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
151 @findex newsticker-start-ticker
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
152 @findex newsticker-stop-ticker
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
153 The scrolling, or flashing of headlines in the echo area, can be
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
154 started with the command @command{newsticker-start-ticker}. It can be
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
155 stopped with @command{newsticker-stop-ticker}.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
156
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
157 @findex newsticker-start
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
158 @findex newsticker-stop
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
159 If you just want to start the periodic download of headlines use the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
160 command @command{newsticker-start}. Calling @command{newsticker-stop}
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
161 will stop the periodic download, but will call
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
162 @command{newsticker-stop-ticker} as well.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
163
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
164 @node Configuration
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
165 @chapter Configuration
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
166
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
167 All Newsticker options are customizable, i.e. they can be changed with
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
168 Emacs customization methods: Call the command
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
169 @command{customize-group} and enter @samp{newsticker} for the customization
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
170 group.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
171
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
172 All Newsticker options have reasonable default values, so that in most
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
173 cases it is not necessary to customize settings before starting Newsticker
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
174 for the first time.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
175
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
176 Newsticker options are organized in the following groups.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
177
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
178 @itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
179
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
180 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
181 @command{newsticker-feed} contains options that define which news
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
182 feeds are retrieved and how this is done.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
183
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
184 @itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
185 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
186 @vindex newsticker-url-list
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
187 @command{newsticker-url-list} defines the list of headlines which are
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
188 retrieved.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
189 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
190 @vindex newsticker-retrieval-interval
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
191 @command{newsticker-retrieval-interval} defines how often headlines
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
192 are retrieved.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
193 @end itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
194
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
195 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
196 @command{newsticker-headline-processing} contains options that define
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
197 how the retrieved headlines are processed.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
198
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
199 @itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
200 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
201 @vindex newsticker-keep-obsolete-items
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
202 @command{newsticker-keep-obsolete-items} decides whether unread
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
203 headlines that have been removed from the feed are kept in the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
204 Newsticker cache.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
205 @end itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
206
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
207 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
208 @command{newsticker-layout} contains options that define how the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
209 buffer for reading RSS headlines is formatted.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
210
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
211 @itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
212 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
213 @vindex newsticker-heading-format
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
214 @command{newsticker-item-format} defines how the title of a headline
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
215 is formatted.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
216 @end itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
217
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
218 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
219 @command{newsticker-ticker} contains options that define how headlines
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
220 are shown in the echo area.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
221
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
222 @itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
223 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
224 @vindex newsticker-display-interval
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
225 @vindex newsticker-scroll-smoothly
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
226 @command{newsticker-display-interval} and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
227 @command{newsticker-scroll-smoothly} define how headlines are shown in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
228 the echo area.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
229 @end itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
230
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
231 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
232 @command{newsticker-hooks} contains options for hooking other Emacs
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
233 commands to newsticker functions.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
234 @itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
235 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
236 @vindex newsticker-new-item-functions
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
237 @command{newsticker-new-item-functions} allows for automatic
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
238 processing of headlines. See `newsticker-download-images', and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
239 `newsticker-download-enclosures' for sample functions.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
240 @end itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
241
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
242 @item
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
243 @command{newsticker-miscellaneous} contains other Newsticker options.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
244
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
245 @end itemize
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
246
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
247 Please have a look at the customization buffers for the complete list
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
248 of options.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
249
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
250 @node Remarks
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
251 @chapter Remarks
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
252
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
253 This newsticker is designed do its job silently in the background
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
254 without disturbing you. However, it is probably impossible to prevent
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
255 such a tool from slightly attenuating your Editor's responsiveness
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
256 every once in a while.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
257
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
258 Byte-compiling newsticker.el is recommended.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
259
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
260
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
261 @node GNU Free Documentation License
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
262 @chapter GNU Free Documentation License
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
263
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
264 @verbatim
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
265
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
266 GNU Free Documentation License
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
267 ==============================
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
268
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
269 Version 1.2, November 2002
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
270 Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
271 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
272
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
273 Everyone is permitted to copy and distribute verbatim copies
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
274 of this license document, but changing it is not allowed.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
275
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
276 0. PREAMBLE
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
277
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
278 The purpose of this License is to make a manual, textbook, or other
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
279 functional and useful document "free" in the sense of freedom: to
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
280 assure everyone the effective freedom to copy and redistribute it,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
281 with or without modifying it, either commercially or
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
282 noncommercially. Secondarily, this License preserves for the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
283 author and publisher a way to get credit for their work, while not
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
284 being considered responsible for modifications made by others.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
285
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
286 This License is a kind of "copyleft", which means that derivative
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
287 works of the document must themselves be free in the same sense.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
288 It complements the GNU General Public License, which is a copyleft
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
289 license designed for free software.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
290
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
291 We have designed this License in order to use it for manuals for
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
292 free software, because free software needs free documentation: a
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
293 free program should come with manuals providing the same freedoms
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
294 that the software does. But this License is not limited to
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
295 software manuals; it can be used for any textual work, regardless
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
296 of subject matter or whether it is published as a printed book.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
297 We recommend this License principally for works whose purpose is
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
298 instruction or reference.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
299
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
300 1. APPLICABILITY AND DEFINITIONS
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
301
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
302 This License applies to any manual or other work, in any medium,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
303 that contains a notice placed by the copyright holder saying it
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
304 can be distributed under the terms of this License. Such a notice
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
305 grants a world-wide, royalty-free license, unlimited in duration,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
306 to use that work under the conditions stated herein. The
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
307 "Document", below, refers to any such manual or work. Any member
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
308 of the public is a licensee, and is addressed as "you". You
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
309 accept the license if you copy, modify or distribute the work in a
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
310 way requiring permission under copyright law.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
311
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
312 A "Modified Version" of the Document means any work containing the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
313 Document or a portion of it, either copied verbatim, or with
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
314 modifications and/or translated into another language.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
315
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
316 A "Secondary Section" is a named appendix or a front-matter section
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
317 of the Document that deals exclusively with the relationship of the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
318 publishers or authors of the Document to the Document's overall
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
319 subject (or to related matters) and contains nothing that could
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
320 fall directly within that overall subject. (Thus, if the Document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
321 is in part a textbook of mathematics, a Secondary Section may not
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
322 explain any mathematics.) The relationship could be a matter of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
323 historical connection with the subject or with related matters, or
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
324 of legal, commercial, philosophical, ethical or political position
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
325 regarding them.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
326
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
327 The "Invariant Sections" are certain Secondary Sections whose
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
328 titles are designated, as being those of Invariant Sections, in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
329 the notice that says that the Document is released under this
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
330 License. If a section does not fit the above definition of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
331 Secondary then it is not allowed to be designated as Invariant.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
332 The Document may contain zero Invariant Sections. If the Document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
333 does not identify any Invariant Sections then there are none.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
334
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
335 The "Cover Texts" are certain short passages of text that are
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
336 listed, as Front-Cover Texts or Back-Cover Texts, in the notice
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
337 that says that the Document is released under this License. A
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
338 Front-Cover Text may be at most 5 words, and a Back-Cover Text may
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
339 be at most 25 words.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
340
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
341 A "Transparent" copy of the Document means a machine-readable copy,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
342 represented in a format whose specification is available to the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
343 general public, that is suitable for revising the document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
344 straightforwardly with generic text editors or (for images
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
345 composed of pixels) generic paint programs or (for drawings) some
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
346 widely available drawing editor, and that is suitable for input to
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
347 text formatters or for automatic translation to a variety of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
348 formats suitable for input to text formatters. A copy made in an
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
349 otherwise Transparent file format whose markup, or absence of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
350 markup, has been arranged to thwart or discourage subsequent
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
351 modification by readers is not Transparent. An image format is
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
352 not Transparent if used for any substantial amount of text. A
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
353 copy that is not "Transparent" is called "Opaque".
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
354
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
355 Examples of suitable formats for Transparent copies include plain
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
356 ASCII without markup, Texinfo input format, LaTeX input format,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
357 SGML or XML using a publicly available DTD, and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
358 standard-conforming simple HTML, PostScript or PDF designed for
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
359 human modification. Examples of transparent image formats include
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
360 PNG, XCF and JPG. Opaque formats include proprietary formats that
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
361 can be read and edited only by proprietary word processors, SGML or
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
362 XML for which the DTD and/or processing tools are not generally
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
363 available, and the machine-generated HTML, PostScript or PDF
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
364 produced by some word processors for output purposes only.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
365
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
366 The "Title Page" means, for a printed book, the title page itself,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
367 plus such following pages as are needed to hold, legibly, the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
368 material this License requires to appear in the title page. For
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
369 works in formats which do not have any title page as such, "Title
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
370 Page" means the text near the most prominent appearance of the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
371 work's title, preceding the beginning of the body of the text.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
372
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
373 A section "Entitled XYZ" means a named subunit of the Document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
374 whose title either is precisely XYZ or contains XYZ in parentheses
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
375 following text that translates XYZ in another language. (Here XYZ
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
376 stands for a specific section name mentioned below, such as
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
377 "Acknowledgements", "Dedications", "Endorsements", or "History".)
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
378 To "Preserve the Title" of such a section when you modify the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
379 Document means that it remains a section "Entitled XYZ" according
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
380 to this definition.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
381
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
382 The Document may include Warranty Disclaimers next to the notice
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
383 which states that this License applies to the Document. These
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
384 Warranty Disclaimers are considered to be included by reference in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
385 this License, but only as regards disclaiming warranties: any other
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
386 implication that these Warranty Disclaimers may have is void and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
387 has no effect on the meaning of this License.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
388
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
389 2. VERBATIM COPYING
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
390
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
391 You may copy and distribute the Document in any medium, either
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
392 commercially or noncommercially, provided that this License, the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
393 copyright notices, and the license notice saying this License
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
394 applies to the Document are reproduced in all copies, and that you
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
395 add no other conditions whatsoever to those of this License. You
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
396 may not use technical measures to obstruct or control the reading
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
397 or further copying of the copies you make or distribute. However,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
398 you may accept compensation in exchange for copies. If you
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
399 distribute a large enough number of copies you must also follow
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
400 the conditions in section 3.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
401
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
402 You may also lend copies, under the same conditions stated above,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
403 and you may publicly display copies.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
404
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
405 3. COPYING IN QUANTITY
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
406
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
407 If you publish printed copies (or copies in media that commonly
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
408 have printed covers) of the Document, numbering more than 100, and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
409 the Document's license notice requires Cover Texts, you must
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
410 enclose the copies in covers that carry, clearly and legibly, all
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
411 these Cover Texts: Front-Cover Texts on the front cover, and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
412 Back-Cover Texts on the back cover. Both covers must also clearly
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
413 and legibly identify you as the publisher of these copies. The
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
414 front cover must present the full title with all words of the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
415 title equally prominent and visible. You may add other material
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
416 on the covers in addition. Copying with changes limited to the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
417 covers, as long as they preserve the title of the Document and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
418 satisfy these conditions, can be treated as verbatim copying in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
419 other respects.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
420
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
421 If the required texts for either cover are too voluminous to fit
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
422 legibly, you should put the first ones listed (as many as fit
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
423 reasonably) on the actual cover, and continue the rest onto
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
424 adjacent pages.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
425
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
426 If you publish or distribute Opaque copies of the Document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
427 numbering more than 100, you must either include a
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
428 machine-readable Transparent copy along with each Opaque copy, or
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
429 state in or with each Opaque copy a computer-network location from
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
430 which the general network-using public has access to download
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
431 using public-standard network protocols a complete Transparent
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
432 copy of the Document, free of added material. If you use the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
433 latter option, you must take reasonably prudent steps, when you
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
434 begin distribution of Opaque copies in quantity, to ensure that
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
435 this Transparent copy will remain thus accessible at the stated
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
436 location until at least one year after the last time you
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
437 distribute an Opaque copy (directly or through your agents or
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
438 retailers) of that edition to the public.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
439
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
440 It is requested, but not required, that you contact the authors of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
441 the Document well before redistributing any large number of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
442 copies, to give them a chance to provide you with an updated
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
443 version of the Document.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
444
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
445 4. MODIFICATIONS
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
446
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
447 You may copy and distribute a Modified Version of the Document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
448 under the conditions of sections 2 and 3 above, provided that you
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
449 release the Modified Version under precisely this License, with
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
450 the Modified Version filling the role of the Document, thus
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
451 licensing distribution and modification of the Modified Version to
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
452 whoever possesses a copy of it. In addition, you must do these
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
453 things in the Modified Version:
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
454
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
455 A. Use in the Title Page (and on the covers, if any) a title
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
456 distinct from that of the Document, and from those of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
457 previous versions (which should, if there were any, be listed
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
458 in the History section of the Document). You may use the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
459 same title as a previous version if the original publisher of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
460 that version gives permission.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
461
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
462 B. List on the Title Page, as authors, one or more persons or
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
463 entities responsible for authorship of the modifications in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
464 the Modified Version, together with at least five of the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
465 principal authors of the Document (all of its principal
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
466 authors, if it has fewer than five), unless they release you
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
467 from this requirement.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
468
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
469 C. State on the Title page the name of the publisher of the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
470 Modified Version, as the publisher.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
471
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
472 D. Preserve all the copyright notices of the Document.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
473
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
474 E. Add an appropriate copyright notice for your modifications
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
475 adjacent to the other copyright notices.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
476
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
477 F. Include, immediately after the copyright notices, a license
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
478 notice giving the public permission to use the Modified
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
479 Version under the terms of this License, in the form shown in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
480 the Addendum below.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
481
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
482 G. Preserve in that license notice the full lists of Invariant
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
483 Sections and required Cover Texts given in the Document's
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
484 license notice.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
485
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
486 H. Include an unaltered copy of this License.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
487
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
488 I. Preserve the section Entitled "History", Preserve its Title,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
489 and add to it an item stating at least the title, year, new
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
490 authors, and publisher of the Modified Version as given on
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
491 the Title Page. If there is no section Entitled "History" in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
492 the Document, create one stating the title, year, authors,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
493 and publisher of the Document as given on its Title Page,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
494 then add an item describing the Modified Version as stated in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
495 the previous sentence.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
496
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
497 J. Preserve the network location, if any, given in the Document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
498 for public access to a Transparent copy of the Document, and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
499 likewise the network locations given in the Document for
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
500 previous versions it was based on. These may be placed in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
501 the "History" section. You may omit a network location for a
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
502 work that was published at least four years before the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
503 Document itself, or if the original publisher of the version
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
504 it refers to gives permission.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
505
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
506 K. For any section Entitled "Acknowledgements" or "Dedications",
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
507 Preserve the Title of the section, and preserve in the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
508 section all the substance and tone of each of the contributor
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
509 acknowledgements and/or dedications given therein.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
510
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
511 L. Preserve all the Invariant Sections of the Document,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
512 unaltered in their text and in their titles. Section numbers
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
513 or the equivalent are not considered part of the section
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
514 titles.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
515
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
516 M. Delete any section Entitled "Endorsements". Such a section
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
517 may not be included in the Modified Version.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
518
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
519 N. Do not retitle any existing section to be Entitled
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
520 "Endorsements" or to conflict in title with any Invariant
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
521 Section.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
522
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
523 O. Preserve any Warranty Disclaimers.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
524
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
525 If the Modified Version includes new front-matter sections or
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
526 appendices that qualify as Secondary Sections and contain no
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
527 material copied from the Document, you may at your option
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
528 designate some or all of these sections as invariant. To do this,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
529 add their titles to the list of Invariant Sections in the Modified
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
530 Version's license notice. These titles must be distinct from any
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
531 other section titles.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
532
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
533 You may add a section Entitled "Endorsements", provided it contains
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
534 nothing but endorsements of your Modified Version by various
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
535 parties--for example, statements of peer review or that the text
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
536 has been approved by an organization as the authoritative
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
537 definition of a standard.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
538
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
539 You may add a passage of up to five words as a Front-Cover Text,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
540 and a passage of up to 25 words as a Back-Cover Text, to the end
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
541 of the list of Cover Texts in the Modified Version. Only one
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
542 passage of Front-Cover Text and one of Back-Cover Text may be
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
543 added by (or through arrangements made by) any one entity. If the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
544 Document already includes a cover text for the same cover,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
545 previously added by you or by arrangement made by the same entity
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
546 you are acting on behalf of, you may not add another; but you may
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
547 replace the old one, on explicit permission from the previous
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
548 publisher that added the old one.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
549
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
550 The author(s) and publisher(s) of the Document do not by this
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
551 License give permission to use their names for publicity for or to
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
552 assert or imply endorsement of any Modified Version.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
553
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
554 5. COMBINING DOCUMENTS
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
555
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
556 You may combine the Document with other documents released under
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
557 this License, under the terms defined in section 4 above for
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
558 modified versions, provided that you include in the combination
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
559 all of the Invariant Sections of all of the original documents,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
560 unmodified, and list them all as Invariant Sections of your
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
561 combined work in its license notice, and that you preserve all
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
562 their Warranty Disclaimers.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
563
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
564 The combined work need only contain one copy of this License, and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
565 multiple identical Invariant Sections may be replaced with a single
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
566 copy. If there are multiple Invariant Sections with the same name
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
567 but different contents, make the title of each such section unique
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
568 by adding at the end of it, in parentheses, the name of the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
569 original author or publisher of that section if known, or else a
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
570 unique number. Make the same adjustment to the section titles in
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
571 the list of Invariant Sections in the license notice of the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
572 combined work.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
573
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
574 In the combination, you must combine any sections Entitled
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
575 "History" in the various original documents, forming one section
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
576 Entitled "History"; likewise combine any sections Entitled
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
577 "Acknowledgements", and any sections Entitled "Dedications". You
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
578 must delete all sections Entitled "Endorsements."
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
579
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
580 6. COLLECTIONS OF DOCUMENTS
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
581
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
582 You may make a collection consisting of the Document and other
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
583 documents released under this License, and replace the individual
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
584 copies of this License in the various documents with a single copy
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
585 that is included in the collection, provided that you follow the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
586 rules of this License for verbatim copying of each of the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
587 documents in all other respects.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
588
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
589 You may extract a single document from such a collection, and
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
590 distribute it individually under this License, provided you insert
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
591 a copy of this License into the extracted document, and follow
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
592 this License in all other respects regarding verbatim copying of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
593 that document.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
594
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
595 7. AGGREGATION WITH INDEPENDENT WORKS
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
596
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
597 A compilation of the Document or its derivatives with other
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
598 separate and independent documents or works, in or on a volume of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
599 a storage or distribution medium, is called an "aggregate" if the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
600 copyright resulting from the compilation is not used to limit the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
601 legal rights of the compilation's users beyond what the individual
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
602 works permit. When the Document is included in an aggregate, this
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
603 License does not apply to the other works in the aggregate which
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
604 are not themselves derivative works of the Document.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
605
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
606 If the Cover Text requirement of section 3 is applicable to these
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
607 copies of the Document, then if the Document is less than one half
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
608 of the entire aggregate, the Document's Cover Texts may be placed
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
609 on covers that bracket the Document within the aggregate, or the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
610 electronic equivalent of covers if the Document is in electronic
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
611 form. Otherwise they must appear on printed covers that bracket
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
612 the whole aggregate.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
613
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
614 8. TRANSLATION
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
615
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
616 Translation is considered a kind of modification, so you may
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
617 distribute translations of the Document under the terms of section
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
618 4. Replacing Invariant Sections with translations requires special
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
619 permission from their copyright holders, but you may include
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
620 translations of some or all Invariant Sections in addition to the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
621 original versions of these Invariant Sections. You may include a
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
622 translation of this License, and all the license notices in the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
623 Document, and any Warranty Disclaimers, provided that you also
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
624 include the original English version of this License and the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
625 original versions of those notices and disclaimers. In case of a
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
626 disagreement between the translation and the original version of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
627 this License or a notice or disclaimer, the original version will
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
628 prevail.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
629
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
630 If a section in the Document is Entitled "Acknowledgements",
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
631 "Dedications", or "History", the requirement (section 4) to
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
632 Preserve its Title (section 1) will typically require changing the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
633 actual title.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
634
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
635 9. TERMINATION
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
636
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
637 You may not copy, modify, sublicense, or distribute the Document
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
638 except as expressly provided for under this License. Any other
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
639 attempt to copy, modify, sublicense or distribute the Document is
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
640 void, and will automatically terminate your rights under this
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
641 License. However, parties who have received copies, or rights,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
642 from you under this License will not have their licenses
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
643 terminated so long as such parties remain in full compliance.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
644
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
645 10. FUTURE REVISIONS OF THIS LICENSE
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
646
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
647 The Free Software Foundation may publish new, revised versions of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
648 the GNU Free Documentation License from time to time. Such new
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
649 versions will be similar in spirit to the present version, but may
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
650 differ in detail to address new problems or concerns. See
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
651 `http://www.gnu.org/copyleft/'.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
652
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
653 Each version of the License is given a distinguishing version
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
654 number. If the Document specifies that a particular numbered
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
655 version of this License "or any later version" applies to it, you
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
656 have the option of following the terms and conditions either of
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
657 that specified version or of any later version that has been
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
658 published (not as a draft) by the Free Software Foundation. If
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
659 the Document does not specify a version number of this License,
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
660 you may choose any version ever published (not as a draft) by the
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
661 Free Software Foundation.
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
662
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
663 @end verbatim
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
664
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
665 @node Index
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
666 @unnumbered Index
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
667
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
668 @printindex cp
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
669
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
670 @bye
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
671
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
672
0aedc3f4854d New file.
Richard M. Stallman <rms@gnu.org>
parents:
diff changeset
673
65497
bc64e5ea4657 Add arch tagline
Miles Bader <miles@gnu.org>
parents: 65496
diff changeset
674 @ignore
bc64e5ea4657 Add arch tagline
Miles Bader <miles@gnu.org>
parents: 65496
diff changeset
675 arch-tag: 7a4de539-117c-4658-b799-0b9e3d0ccec0
bc64e5ea4657 Add arch tagline
Miles Bader <miles@gnu.org>
parents: 65496
diff changeset
676 @end ignore