aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorJoakim Verona2011-11-22 15:39:42 +0100
committerJoakim Verona2011-11-22 15:39:42 +0100
commit40bb789236e486a3f36eefb2840c293369ce2af3 (patch)
tree8e81d3aa5f232ec7f2c5187c683cb0998d2dc4e2 /doc
parent62318aed495a48e24ff73fe79e420dd801df3189 (diff)
parenta8e1496d750ab0f571b3412ff61aaa4da640a036 (diff)
downloademacs-40bb789236e486a3f36eefb2840c293369ce2af3.tar.gz
emacs-40bb789236e486a3f36eefb2840c293369ce2af3.zip
upstream
Diffstat (limited to 'doc')
-rw-r--r--doc/emacs/ChangeLog18
-rw-r--r--doc/emacs/ack.texi6
-rw-r--r--doc/emacs/building.texi2
-rw-r--r--doc/emacs/custom.texi8
-rw-r--r--doc/emacs/killing.texi2
-rw-r--r--doc/emacs/macos.texi2
-rw-r--r--doc/emacs/misc.texi12
-rw-r--r--doc/emacs/modes.texi2
-rw-r--r--doc/emacs/msdog.texi6
-rw-r--r--doc/emacs/regs.texi9
-rw-r--r--doc/emacs/search.texi2
-rw-r--r--doc/emacs/trouble.texi2
-rw-r--r--doc/lispintro/ChangeLog4
-rw-r--r--doc/lispintro/emacs-lisp-intro.texi53
-rw-r--r--doc/lispref/ChangeLog37
-rw-r--r--doc/lispref/buffers.texi9
-rw-r--r--doc/lispref/files.texi2
-rw-r--r--doc/lispref/frames.texi3
-rw-r--r--doc/lispref/internals.texi2
-rw-r--r--doc/lispref/intro.texi2
-rw-r--r--doc/lispref/processes.texi2
-rw-r--r--doc/lispref/spellfile3
-rw-r--r--doc/lispref/two-volume-cross-refs.txt4
-rw-r--r--doc/lispref/windows.texi336
-rw-r--r--doc/man/ChangeLog6
-rw-r--r--doc/man/etags.12
-rw-r--r--doc/misc/ChangeLog25
-rw-r--r--doc/misc/ada-mode.texi6
-rw-r--r--doc/misc/cc-mode.texi80
-rw-r--r--doc/misc/dbus.texi2
-rw-r--r--doc/misc/ede.texi6
-rw-r--r--doc/misc/ediff.texi2
-rw-r--r--doc/misc/emacs-mime.texi2
-rw-r--r--doc/misc/ert.texi4
-rw-r--r--doc/misc/eshell.texi2
-rw-r--r--doc/misc/faq.texi4
-rw-r--r--doc/misc/gnus-faq.texi98
-rw-r--r--doc/misc/gnus.texi8
-rw-r--r--doc/misc/newsticker.texi16
-rw-r--r--doc/misc/org.texi24
-rw-r--r--doc/misc/pgg.texi26
-rw-r--r--doc/misc/sc.texi4
-rw-r--r--doc/misc/sem-user.texi4
-rw-r--r--doc/misc/semantic.texi6
-rw-r--r--doc/misc/tramp.texi2
45 files changed, 461 insertions, 396 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index a808a96b444..b796acd8b39 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,16 @@
12011-11-17 Glenn Morris <rgm@gnu.org>
2
3 * regs.texi (Bookmarks): Small fixes related to saving. (Bug#10058)
4
52011-11-16 Juanma Barranquero <lekktu@gmail.com>
6
7 * killing.texi (Rectangles):
8 * misc.texi (Document View):
9 * modes.texi (Choosing Modes):
10 * msdog.texi (Windows Fonts):
11 * regs.texi (Rectangle Registers):
12 * search.texi (Isearch Yank): Fix typos.
13
12011-11-06 Chong Yidong <cyd@gnu.org> 142011-11-06 Chong Yidong <cyd@gnu.org>
2 15
3 * windows.texi (Basic Window): Add xref to Cursor Display. 16 * windows.texi (Basic Window): Add xref to Cursor Display.
@@ -1226,7 +1239,8 @@
1226 1239
12272010-03-27 Nick Roberts <nickrob@snap.net.nz> 12402010-03-27 Nick Roberts <nickrob@snap.net.nz>
1228 1241
1229 doc/emacs/building.texi: Describe restored GDB/MI fuctionality removed by 2009-12-29T07:15:34Z!nickrob@snap.net.nz. 1242 doc/emacs/building.texi: Describe restored GDB/MI functionality
1243 removed by 2009-12-29T07:15:34Z!nickrob@snap.net.nz.
1230 doc/emacs/emacs.texi: Update node names for building.texi. 1244 doc/emacs/emacs.texi: Update node names for building.texi.
1231 1245
12322010-03-24 Glenn Morris <rgm@gnu.org> 12462010-03-24 Glenn Morris <rgm@gnu.org>
@@ -1711,7 +1725,7 @@
1711 (Table of Resources): Document fontBackend resource. 1725 (Table of Resources): Document fontBackend resource.
1712 1726
1713 * trouble.texi (Quitting): Add other undo bindings to table. 1727 * trouble.texi (Quitting): Add other undo bindings to table.
1714 (DEL Does Not Delete): Note that the erasure key is usually labelled 1728 (DEL Does Not Delete): Note that the erasure key is usually labeled
1715 "Backspace". Remove discussion of obscure Xmodmap issue. 1729 "Backspace". Remove discussion of obscure Xmodmap issue.
1716 1730
17172009-05-07 Chong Yidong <cyd@stupidchicken.com> 17312009-05-07 Chong Yidong <cyd@stupidchicken.com>
diff --git a/doc/emacs/ack.texi b/doc/emacs/ack.texi
index 1cfb3d9ffe9..6801c7f1e0e 100644
--- a/doc/emacs/ack.texi
+++ b/doc/emacs/ack.texi
@@ -99,7 +99,7 @@ ERC distribution).
99 99
100@item 100@item
101Scott Bender, Michael Brouwer, Christophe de Dinechin, Carl Edman, 101Scott Bender, Michael Brouwer, Christophe de Dinechin, Carl Edman,
102Christian Limpach and Adrian Robert developed and maintained the 102Christian Limpach and Adrian Robert developed and maintained the
103NeXTstep port of Emacs. 103NeXTstep port of Emacs.
104 104
105@item 105@item
@@ -206,7 +206,7 @@ use it, Snake and Tetris.
206 206
207@item 207@item
208Andrew Cohen wrote @file{spam-wash.el}, to decode and clean email before 208Andrew Cohen wrote @file{spam-wash.el}, to decode and clean email before
209it is analysed for spam. 209it is analyzed for spam.
210 210
211@item 211@item
212Georges Brun-Cottan and Stefan Monnier wrote @file{easy-mmode.el}, a 212Georges Brun-Cottan and Stefan Monnier wrote @file{easy-mmode.el}, a
@@ -576,7 +576,7 @@ Emacs.
576 576
577@item 577@item
578Karel Klí@v{c} contributed SELinux support, for preserving the 578Karel Klí@v{c} contributed SELinux support, for preserving the
579Security-Enchanced Linux context of files on backup and copy. 579Security-Enhanced Linux context of files on backup and copy.
580 580
581@item 581@item
582Shuhei Kobayashi wrote @file{hex-util.el}, for operating on hexadecimal 582Shuhei Kobayashi wrote @file{hex-util.el}, for operating on hexadecimal
diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index cca9e441ed4..ac62e2d9652 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -1251,7 +1251,7 @@ screen Emacs frame.
1251In all-stop mode, whenever your program stops, @emph{all} threads of 1251In all-stop mode, whenever your program stops, @emph{all} threads of
1252execution stop. Likewise, whenever you restart the program, all 1252execution stop. Likewise, whenever you restart the program, all
1253threads start executing. @xref{All-Stop Mode, , All-Stop Mode, gdb, 1253threads start executing. @xref{All-Stop Mode, , All-Stop Mode, gdb,
1254The GNU debugger}. You can enable this behaviour in Emacs by setting 1254The GNU debugger}. You can enable this behavior in Emacs by setting
1255@code{gdb-non-stop-setting} to @code{nil} before starting a debugging 1255@code{gdb-non-stop-setting} to @code{nil} before starting a debugging
1256session. 1256session.
1257 1257
diff --git a/doc/emacs/custom.texi b/doc/emacs/custom.texi
index fd680576b4e..5b98216369d 100644
--- a/doc/emacs/custom.texi
+++ b/doc/emacs/custom.texi
@@ -82,7 +82,7 @@ under it. It looks like this, in part:
82@group 82@group
83/- Emacs group: Customization of the One True Editor. -------------\ 83/- Emacs group: Customization of the One True Editor. -------------\
84 [State]: visible group members are all at standard values. 84 [State]: visible group members are all at standard values.
85 85
86 See also [Manual]. 86 See also [Manual].
87 87
88[Editing] : Basic text editing facilities. 88[Editing] : Basic text editing facilities.
@@ -547,7 +547,7 @@ such collections from one computer to another.
547 To define a Custom theme, use @kbd{M-x customize-create-theme}, 547 To define a Custom theme, use @kbd{M-x customize-create-theme},
548which brings up a buffer named @samp{*New Custom Theme*}. At the top 548which brings up a buffer named @samp{*New Custom Theme*}. At the top
549of the buffer is an editable field where you can specify the name of 549of the buffer is an editable field where you can specify the name of
550the theme. Click on the button labelled @samp{Insert Variable} to add 550the theme. Click on the button labeled @samp{Insert Variable} to add
551a variable to the theme, and click on @samp{Insert Face} to add a 551a variable to the theme, and click on @samp{Insert Face} to add a
552face. You can edit these values in the @samp{*New Custom Theme*} 552face. You can edit these values in the @samp{*New Custom Theme*}
553buffer like in an ordinary Customize buffer. To remove an option from 553buffer like in an ordinary Customize buffer. To remove an option from
@@ -1068,7 +1068,7 @@ other context has no special meaning.
1068well as the major modes; in fact, you can use it more than once, first 1068well as the major modes; in fact, you can use it more than once, first
1069to set the major mode and then to enable minor modes which are 1069to set the major mode and then to enable minor modes which are
1070specific to particular buffers. Using @code{mode} for minor modes 1070specific to particular buffers. Using @code{mode} for minor modes
1071is deprecated, though---instead, use @code{eval: (minor-mode 1)}. 1071is deprecated, though---instead, use @code{eval: (minor-mode 1)}.
1072 1072
1073 Often, however, it is a mistake to enable minor modes in file local 1073 Often, however, it is a mistake to enable minor modes in file local
1074variables. Most minor modes, like Auto Fill mode, represent individual user 1074variables. Most minor modes, like Auto Fill mode, represent individual user
@@ -1646,7 +1646,7 @@ ways to use these modifiers; the key labeled @key{Alt} on most
1646keyboards usually issues the @key{Meta} modifier, not @key{Alt}. The 1646keyboards usually issues the @key{Meta} modifier, not @key{Alt}. The
1647standard key bindings in Emacs do not include any characters with 1647standard key bindings in Emacs do not include any characters with
1648these modifiers. However, you can customize Emacs to assign meanings 1648these modifiers. However, you can customize Emacs to assign meanings
1649to them. The modifier bits are labelled as @samp{s-}, @samp{H-} and 1649to them. The modifier bits are labeled as @samp{s-}, @samp{H-} and
1650@samp{A-} respectively. 1650@samp{A-} respectively.
1651 1651
1652 Even if your keyboard lacks these additional modifier keys, you can 1652 Even if your keyboard lacks these additional modifier keys, you can
diff --git a/doc/emacs/killing.texi b/doc/emacs/killing.texi
index 6237b00c2ee..1443ad019bb 100644
--- a/doc/emacs/killing.texi
+++ b/doc/emacs/killing.texi
@@ -733,7 +733,7 @@ insert rectangles, and commands to make blank rectangles.
733@findex delete-rectangle 733@findex delete-rectangle
734 There are two ways to erase the text in a rectangle: @kbd{C-x r d} 734 There are two ways to erase the text in a rectangle: @kbd{C-x r d}
735(@code{delete-rectangle}) to delete the text outright, or @kbd{C-x r 735(@code{delete-rectangle}) to delete the text outright, or @kbd{C-x r
736k} (@code{kill-rectangle}) to remove the text and and save it as the 736k} (@code{kill-rectangle}) to remove the text and save it as the
737@dfn{last killed rectangle}. In both cases, erasing the 737@dfn{last killed rectangle}. In both cases, erasing the
738region-rectangle is like erasing the specified text on each line of 738region-rectangle is like erasing the specified text on each line of
739the rectangle; if there is any following text on the line, it moves 739the rectangle; if there is any following text on the line, it moves
diff --git a/doc/emacs/macos.texi b/doc/emacs/macos.texi
index 5a97fa8460b..3e1e67fecd8 100644
--- a/doc/emacs/macos.texi
+++ b/doc/emacs/macos.texi
@@ -120,7 +120,7 @@ Useful in this context is the listing of all faces obtained by @key{M-x}
120 120
121@subsection Open files by dragging to an Emacs window 121@subsection Open files by dragging to an Emacs window
122 122
123The default behaviour when a user drags files from another application 123The default behavior when a user drags files from another application
124into an Emacs frame is to insert the contents of all the dragged files 124into an Emacs frame is to insert the contents of all the dragged files
125into the current buffer. To remap the @code{ns-drag-file} event to 125into the current buffer. To remap the @code{ns-drag-file} event to
126open the dragged files in the current frame use the following line: 126open the dragged files in the current frame use the following line:
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi
index d7639b3b665..714e7f3441c 100644
--- a/doc/emacs/misc.texi
+++ b/doc/emacs/misc.texi
@@ -236,7 +236,7 @@ for @var{regexp}.
236@cindex DVI file 236@cindex DVI file
237@cindex PDF file 237@cindex PDF file
238@cindex PS file 238@cindex PS file
239@cindex Postscript file 239@cindex PostScript file
240@cindex OpenDocument file 240@cindex OpenDocument file
241@cindex Microsoft Office file 241@cindex Microsoft Office file
242@cindex DocView mode 242@cindex DocView mode
@@ -244,7 +244,7 @@ for @var{regexp}.
244@cindex document viewer (DocView) 244@cindex document viewer (DocView)
245@findex doc-view-mode 245@findex doc-view-mode
246 246
247DocView mode (@code{doc-view-mode}) is a viewer for DVI, Postscript 247DocView mode (@code{doc-view-mode}) is a viewer for DVI, PostScript
248(PS), PDF, OpenDocument, and Microsoft Office documents. It provides 248(PS), PDF, OpenDocument, and Microsoft Office documents. It provides
249features such as slicing, zooming, and searching inside documents. It 249features such as slicing, zooming, and searching inside documents. It
250works by converting the document to a set of images using the 250works by converting the document to a set of images using the
@@ -257,16 +257,16 @@ displaying those images.
257@findex doc-view-toggle-display 257@findex doc-view-toggle-display
258@findex doc-view-toggle-display 258@findex doc-view-toggle-display
259@cindex doc-view-minor-mode 259@cindex doc-view-minor-mode
260 When you visit a document file with the exception of Postscript 260 When you visit a document file with the exception of PostScript
261files, Emacs automatically switches to DocView mode if possible 261files, Emacs automatically switches to DocView mode if possible
262@footnote{The needed external tools for this document type have to be 262@footnote{The needed external tools for this document type have to be
263available, emacs needs to run in a graphical frame, and PNG image 263available, emacs needs to run in a graphical frame, and PNG image
264support has to be compiled into emacs. If any of these requirements 264support has to be compiled into emacs. If any of these requirements
265is not fulfilled, DocView falls back to an appropriate mode.}. When 265is not fulfilled, DocView falls back to an appropriate mode.}. When
266you visit a Postscript file, Emacs switches to PS mode, a major mode 266you visit a PostScript file, Emacs switches to PS mode, a major mode
267for editing Postscript files as text; however, it also enables DocView 267for editing PostScript files as text; however, it also enables DocView
268minor mode, so you can type @kbd{C-c C-c} to view the document with 268minor mode, so you can type @kbd{C-c C-c} to view the document with
269DocView. (PDF and DVI files, unlike Postscript files, are not usually 269DocView. (PDF and DVI files, unlike PostScript files, are not usually
270human-editable.) In either case, repeating @kbd{C-c C-c} 270human-editable.) In either case, repeating @kbd{C-c C-c}
271(@code{doc-view-toggle-display}) toggles between DocView and the file 271(@code{doc-view-toggle-display}) toggles between DocView and the file
272text. 272text.
diff --git a/doc/emacs/modes.texi b/doc/emacs/modes.texi
index d82423a73b4..5a786be62cf 100644
--- a/doc/emacs/modes.texi
+++ b/doc/emacs/modes.texi
@@ -368,7 +368,7 @@ compares the text at the start of the buffer to the variable
368@code{magic-mode-alist}, described above, except that is consulted 368@code{magic-mode-alist}, described above, except that is consulted
369only after @code{auto-mode-alist}. By default, 369only after @code{auto-mode-alist}. By default,
370@code{magic-fallback-mode-alist} contains forms that check for image 370@code{magic-fallback-mode-alist} contains forms that check for image
371files, HTML/XML/SGML files, and Postscript files. 371files, HTML/XML/SGML files, and PostScript files.
372 372
373@vindex major-mode 373@vindex major-mode
374 Once a major mode is chosen, Emacs sets the value of the variable 374 Once a major mode is chosen, Emacs sets the value of the variable
diff --git a/doc/emacs/msdog.texi b/doc/emacs/msdog.texi
index 533872ddf61..bbaf31ade85 100644
--- a/doc/emacs/msdog.texi
+++ b/doc/emacs/msdog.texi
@@ -322,7 +322,7 @@ default value is @code{(links uid gid)} i.e.@: all the 3 optional
322attributes are displayed. 322attributes are displayed.
323 323
324@vindex ls-lisp-emulation 324@vindex ls-lisp-emulation
325 The variable @code{ls-lisp-emulation} controls the flavour of the 325 The variable @code{ls-lisp-emulation} controls the flavor of the
326@code{ls} emulation by setting the defaults for the 3 options 326@code{ls} emulation by setting the defaults for the 3 options
327described above: @code{ls-lisp-ignore-case}, 327described above: @code{ls-lisp-ignore-case},
328@code{ls-lisp-dirs-first}, and @code{ls-lisp-verbosity}. The value of 328@code{ls-lisp-dirs-first}, and @code{ls-lisp-verbosity}. The value of
@@ -868,7 +868,7 @@ and @code{uniscribe} font backends are supported on Windows. The
868@code{gdi} font backend is available on all versions of Windows, and 868@code{gdi} font backend is available on all versions of Windows, and
869supports all fonts that are natively supported by Windows. The 869supports all fonts that are natively supported by Windows. The
870@code{uniscribe} font backend is available on Windows 2000 and later, 870@code{uniscribe} font backend is available on Windows 2000 and later,
871and supports Truetype and Opentype fonts. Some languages requiring 871and supports TrueType and OpenType fonts. Some languages requiring
872complex layout can only be properly supported by the uniscribe 872complex layout can only be properly supported by the uniscribe
873backend. By default, both backends are enabled if supported, with 873backend. By default, both backends are enabled if supported, with
874@code{uniscribe} taking priority over @code{gdi}. 874@code{uniscribe} taking priority over @code{gdi}.
@@ -914,7 +914,7 @@ as a fallback with the font family left unspecified.
914@vindex w32-charset-info-alist 914@vindex w32-charset-info-alist
915@item registry 915@item registry
916Specifies the character set registry that the font is 916Specifies the character set registry that the font is
917expected to cover. Most Truetype and Opentype fonts will be unicode fonts 917expected to cover. Most TrueType and OpenType fonts will be unicode fonts
918that cover several national character sets, but you can narrow down the 918that cover several national character sets, but you can narrow down the
919selection of fonts to those that support a particular character set by 919selection of fonts to those that support a particular character set by
920using a specific registry from @code{w32-charset-info-alist} here. 920using a specific registry from @code{w32-charset-info-alist} here.
diff --git a/doc/emacs/regs.texi b/doc/emacs/regs.texi
index 41a807375a9..f7fd52bd28d 100644
--- a/doc/emacs/regs.texi
+++ b/doc/emacs/regs.texi
@@ -145,7 +145,7 @@ rectangle) (@code{insert-register}).
145 145
146 The @kbd{C-x r i @var{r}} (@code{insert-register}) command, 146 The @kbd{C-x r i @var{r}} (@code{insert-register}) command,
147previously documented in @ref{Text Registers}, inserts a rectangle 147previously documented in @ref{Text Registers}, inserts a rectangle
148rather than a a text string, if the register contains a rectangle. 148rather than a text string, if the register contains a rectangle.
149 149
150@node Configuration Registers 150@node Configuration Registers
151@section Saving Window Configurations in Registers 151@section Saving Window Configurations in Registers
@@ -278,7 +278,7 @@ you can use it to edit your bookmark definitions or annotate the
278bookmarks. Type @kbd{C-h m} in the bookmark buffer for more 278bookmarks. Type @kbd{C-h m} in the bookmark buffer for more
279information about its special editing commands. 279information about its special editing commands.
280 280
281 When you kill Emacs, Emacs offers to save your bookmark values, if 281 When you kill Emacs, Emacs saves your bookmarks, if
282you have changed any bookmark values. You can also save the bookmarks 282you have changed any bookmark values. You can also save the bookmarks
283at any time with the @kbd{M-x bookmark-save} command. Bookmarks are 283at any time with the @kbd{M-x bookmark-save} command. Bookmarks are
284saved to the file @file{~/.emacs.d/bookmarks} (for compatibility with 284saved to the file @file{~/.emacs.d/bookmarks} (for compatibility with
@@ -290,9 +290,10 @@ persist from one Emacs session to the next.
290@vindex bookmark-save-flag 290@vindex bookmark-save-flag
291 If you set the variable @code{bookmark-save-flag} to 1, each command 291 If you set the variable @code{bookmark-save-flag} to 1, each command
292that sets a bookmark will also save your bookmarks; this way, you 292that sets a bookmark will also save your bookmarks; this way, you
293don't lose any bookmark values even if Emacs crashes. (The value, if 293don't lose any bookmark values even if Emacs crashes. The value, if
294a number, says how many bookmark modifications should go by between 294a number, says how many bookmark modifications should go by between
295saving.) 295saving. If you set this variable to @code{nil}, Emacs only
296saves bookmarks if you explicitly use @kbd{M-x bookmark-save}.
296 297
297@vindex bookmark-search-size 298@vindex bookmark-search-size
298 Bookmark position values are saved with surrounding context, so that 299 Bookmark position values are saved with surrounding context, so that
diff --git a/doc/emacs/search.texi b/doc/emacs/search.texi
index 0b68373d47c..c6747042df5 100644
--- a/doc/emacs/search.texi
+++ b/doc/emacs/search.texi
@@ -309,7 +309,7 @@ search remains case-insensitive.
309@findex isearch-yank-char 309@findex isearch-yank-char
310 @kbd{C-M-w} (@code{isearch-del-char}) deletes the last character 310 @kbd{C-M-w} (@code{isearch-del-char}) deletes the last character
311from the search string, and @kbd{C-M-y} (@code{isearch-yank-char}) 311from the search string, and @kbd{C-M-y} (@code{isearch-yank-char})
312appends the character after point to the the search string. An 312appends the character after point to the search string. An
313alternative method to add the character after point is to enter the 313alternative method to add the character after point is to enter the
314minibuffer with @kbd{M-e} (@pxref{Repeat Isearch}) and type @kbd{C-f} 314minibuffer with @kbd{M-e} (@pxref{Repeat Isearch}) and type @kbd{C-f}
315at the end of the search string in the minibuffer. 315at the end of the search string in the minibuffer.
diff --git a/doc/emacs/trouble.texi b/doc/emacs/trouble.texi
index ec159af6f84..ae7550d0fae 100644
--- a/doc/emacs/trouble.texi
+++ b/doc/emacs/trouble.texi
@@ -161,7 +161,7 @@ in the Emacs distribution. Type @kbd{C-h C-f} to read the FAQ; type
161@cindex @key{BACKSPACE} vs @key{DEL} 161@cindex @key{BACKSPACE} vs @key{DEL}
162@cindex usual erasure key 162@cindex usual erasure key
163 163
164 Every keyboard has a large key, usually labelled @key{Backspace}, 164 Every keyboard has a large key, usually labeled @key{Backspace},
165which is ordinarily used to erase the last character that you typed. 165which is ordinarily used to erase the last character that you typed.
166We call this key @dfn{the usual erasure key}. In Emacs, it is 166We call this key @dfn{the usual erasure key}. In Emacs, it is
167supposed to be equivalent to @key{DEL}. 167supposed to be equivalent to @key{DEL}.
diff --git a/doc/lispintro/ChangeLog b/doc/lispintro/ChangeLog
index 9d3894c38fc..bdcd9e9aea8 100644
--- a/doc/lispintro/ChangeLog
+++ b/doc/lispintro/ChangeLog
@@ -1,3 +1,7 @@
12011-11-16 Juanma Barranquero <lekktu@gmail.com>
2
3 * emacs-lisp-intro.texi (etags): Fix typo.
4
12011-03-07 Chong Yidong <cyd@stupidchicken.com> 52011-03-07 Chong Yidong <cyd@stupidchicken.com>
2 6
3 * Version 23.3 released. 7 * Version 23.3 released.
diff --git a/doc/lispintro/emacs-lisp-intro.texi b/doc/lispintro/emacs-lisp-intro.texi
index 11ceea19eef..ef04626e95f 100644
--- a/doc/lispintro/emacs-lisp-intro.texi
+++ b/doc/lispintro/emacs-lisp-intro.texi
@@ -11,7 +11,7 @@
11@c --------- 11@c ---------
12@c <<<< For hard copy printing, this file is now 12@c <<<< For hard copy printing, this file is now
13@c set for smallbook, which works for all sizes 13@c set for smallbook, which works for all sizes
14@c of paper, and with Postscript figures >>>> 14@c of paper, and with PostScript figures >>>>
15@set smallbook 15@set smallbook
16@ifset smallbook 16@ifset smallbook
17@smallbook 17@smallbook
@@ -357,7 +357,7 @@ every node in every chapter.
357* Conclusion:: Now you have the basics. 357* Conclusion:: Now you have the basics.
358* the-the:: An appendix: how to find reduplicated words. 358* the-the:: An appendix: how to find reduplicated words.
359* Kill Ring:: An appendix: how the kill ring works. 359* Kill Ring:: An appendix: how the kill ring works.
360* Full Graph:: How to create a graph with labelled axes. 360* Full Graph:: How to create a graph with labeled axes.
361* Free Software and Free Manuals:: 361* Free Software and Free Manuals::
362* GNU Free Documentation License:: 362* GNU Free Documentation License::
363* Index:: 363* Index::
@@ -793,9 +793,9 @@ The @code{current-kill} Function
793* Digression concerning error:: How to mislead humans, but not computers. 793* Digression concerning error:: How to mislead humans, but not computers.
794* Determining the Element:: 794* Determining the Element::
795 795
796A Graph with Labelled Axes 796A Graph with Labeled Axes
797 797
798* Labelled Example:: 798* Labeled Example::
799* print-graph Varlist:: @code{let} expression in @code{print-graph}. 799* print-graph Varlist:: @code{let} expression in @code{print-graph}.
800* print-Y-axis:: Print a label for the vertical axis. 800* print-Y-axis:: Print a label for the vertical axis.
801* print-X-axis:: Print a horizontal label. 801* print-X-axis:: Print a horizontal label.
@@ -1023,7 +1023,7 @@ the command in parentheses, like this: @kbd{M-C-\}
1023invoke the command; this is called @dfn{rebinding}. @xref{Keymaps, , 1023invoke the command; this is called @dfn{rebinding}. @xref{Keymaps, ,
1024Keymaps}.) The abbreviation @kbd{M-C-\} means that you type your 1024Keymaps}.) The abbreviation @kbd{M-C-\} means that you type your
1025@key{META} key, @key{CTRL} key and @key{\} key all at the same time. 1025@key{META} key, @key{CTRL} key and @key{\} key all at the same time.
1026(On many modern keyboards the @key{META} key is labelled 1026(On many modern keyboards the @key{META} key is labeled
1027@key{ALT}.) 1027@key{ALT}.)
1028Sometimes a combination like this is called a keychord, since it is 1028Sometimes a combination like this is called a keychord, since it is
1029similar to the way you play a chord on a piano. If your keyboard does 1029similar to the way you play a chord on a piano. If your keyboard does
@@ -1031,7 +1031,7 @@ not have a @key{META} key, the @key{ESC} key prefix is used in place
1031of it. In this case, @kbd{M-C-\} means that you press and release your 1031of it. In this case, @kbd{M-C-\} means that you press and release your
1032@key{ESC} key and then type the @key{CTRL} key and the @key{\} key at 1032@key{ESC} key and then type the @key{CTRL} key and the @key{\} key at
1033the same time. But usually @kbd{M-C-\} means press the @key{CTRL} key 1033the same time. But usually @kbd{M-C-\} means press the @key{CTRL} key
1034along with the key that is labelled @key{ALT} and, at the same time, 1034along with the key that is labeled @key{ALT} and, at the same time,
1035press the @key{\} key. 1035press the @key{\} key.
1036 1036
1037In addition to typing a lone keychord, you can prefix what you type 1037In addition to typing a lone keychord, you can prefix what you type
@@ -4749,7 +4749,7 @@ type in the name of the function whose source code you want to see,
4749such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will 4749such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will
4750switch buffers and display the source code for the function on your 4750switch buffers and display the source code for the function on your
4751screen. To switch back to your current buffer, type @kbd{C-x b 4751screen. To switch back to your current buffer, type @kbd{C-x b
4752@key{RET}}. (On some keyboards, the @key{META} key is labelled 4752@key{RET}}. (On some keyboards, the @key{META} key is labeled
4753@key{ALT}.) 4753@key{ALT}.)
4754 4754
4755@c !!! 22.1.1 tags table location in this paragraph 4755@c !!! 22.1.1 tags table location in this paragraph
@@ -8200,7 +8200,7 @@ The command \\[yank] can retrieve it from there. @dots{} "
8200 ;; it will be set in an error 8200 ;; it will be set in an error
8201 (setq this-command 'kill-region) 8201 (setq this-command 'kill-region)
8202 ;; Finally, in the then-part, send a message if you may copy 8202 ;; Finally, in the then-part, send a message if you may copy
8203 ;; the text to the kill ring without signally an error, but 8203 ;; the text to the kill ring without signaling an error, but
8204 ;; don't if you may not. 8204 ;; don't if you may not.
8205@end group 8205@end group
8206@group 8206@group
@@ -13656,7 +13656,7 @@ list of supported languages.
13656 13656
13657The @code{etags} program handles more than 20 languages, including 13657The @code{etags} program handles more than 20 languages, including
13658Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java, 13658Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java,
13659LaTeX, Pascal, Perl, Postscript, Python, TeX, Texinfo, makefiles, and 13659LaTeX, Pascal, Perl, PostScript, Python, TeX, Texinfo, makefiles, and
13660most assemblers. The program has no switches for specifying the 13660most assemblers. The program has no switches for specifying the
13661language; it recognizes the language in an input file according to its 13661language; it recognizes the language in an input file according to its
13662file name and contents. 13662file name and contents.
@@ -16962,7 +16962,7 @@ For this reason, I have written enhancements to the basic
16962@code{print-graph-body} function that automatically print labels for 16962@code{print-graph-body} function that automatically print labels for
16963the horizontal and vertical axes. Since the label printing functions 16963the horizontal and vertical axes. Since the label printing functions
16964do not contain much new material, I have placed their description in 16964do not contain much new material, I have placed their description in
16965an appendix. @xref{Full Graph, , A Graph with Labelled Axes}. 16965an appendix. @xref{Full Graph, , A Graph with Labeled Axes}.
16966 16966
16967@node Line Graph Exercise, , Printed Axes, Readying a Graph 16967@node Line Graph Exercise, , Printed Axes, Readying a Graph
16968@section Exercise 16968@section Exercise
@@ -19447,7 +19447,7 @@ whether the kill ring is full or empty. This is an act of
19447exploration. 19447exploration.
19448 19448
19449From the human point of view, the act of exploration and discovery is 19449From the human point of view, the act of exploration and discovery is
19450not necessarily an error, and therefore should not be labelled as one, 19450not necessarily an error, and therefore should not be labeled as one,
19451even in the bowels of a computer. As it is, the code in Emacs implies 19451even in the bowels of a computer. As it is, the code in Emacs implies
19452that a human who is acting virtuously, by exploring his or her 19452that a human who is acting virtuously, by exploring his or her
19453environment, is making an error. This is bad. Even though the computer 19453environment, is making an error. This is bad. Even though the computer
@@ -19760,25 +19760,25 @@ as @code{kill-ring-yank-pointer} do not use this library, possibly
19760because they were written earlier. 19760because they were written earlier.
19761 19761
19762@node Full Graph, Free Software and Free Manuals, Kill Ring, Top 19762@node Full Graph, Free Software and Free Manuals, Kill Ring, Top
19763@appendix A Graph with Labelled Axes 19763@appendix A Graph with Labeled Axes
19764 19764
19765Printed axes help you understand a graph. They convey scale. In an 19765Printed axes help you understand a graph. They convey scale. In an
19766earlier chapter (@pxref{Readying a Graph, , Readying a Graph}), we 19766earlier chapter (@pxref{Readying a Graph, , Readying a Graph}), we
19767wrote the code to print the body of a graph. Here we write the code 19767wrote the code to print the body of a graph. Here we write the code
19768for printing and labelling vertical and horizontal axes, along with the 19768for printing and labeling vertical and horizontal axes, along with the
19769body itself. 19769body itself.
19770 19770
19771@menu 19771@menu
19772* Labelled Example:: 19772* Labeled Example::
19773* print-graph Varlist:: @code{let} expression in @code{print-graph}. 19773* print-graph Varlist:: @code{let} expression in @code{print-graph}.
19774* print-Y-axis:: Print a label for the vertical axis. 19774* print-Y-axis:: Print a label for the vertical axis.
19775* print-X-axis:: Print a horizontal label. 19775* print-X-axis:: Print a horizontal label.
19776* Print Whole Graph:: The function to print a complete graph. 19776* Print Whole Graph:: The function to print a complete graph.
19777@end menu 19777@end menu
19778 19778
19779@node Labelled Example, print-graph Varlist, Full Graph, Full Graph 19779@node Labeled Example, print-graph Varlist, Full Graph, Full Graph
19780@ifnottex 19780@ifnottex
19781@unnumberedsec Labelled Example Graph 19781@unnumberedsec Labeled Example Graph
19782@end ifnottex 19782@end ifnottex
19783 19783
19784Since insertions fill a buffer to the right and below point, the new 19784Since insertions fill a buffer to the right and below point, the new
@@ -19821,9 +19821,9 @@ Here is an example of how a finished graph should look:
19821@end smallexample 19821@end smallexample
19822 19822
19823@noindent 19823@noindent
19824In this graph, both the vertical and the horizontal axes are labelled 19824In this graph, both the vertical and the horizontal axes are labeled
19825with numbers. However, in some graphs, the horizontal axis is time 19825with numbers. However, in some graphs, the horizontal axis is time
19826and would be better labelled with months, like this: 19826and would be better labeled with months, like this:
19827 19827
19828@smallexample 19828@smallexample
19829@group 19829@group
@@ -19838,9 +19838,9 @@ and would be better labelled with months, like this:
19838@end smallexample 19838@end smallexample
19839 19839
19840Indeed, with a little thought, we can easily come up with a variety of 19840Indeed, with a little thought, we can easily come up with a variety of
19841vertical and horizontal labelling schemes. Our task could become 19841vertical and horizontal labeling schemes. Our task could become
19842complicated. But complications breed confusion. Rather than permit 19842complicated. But complications breed confusion. Rather than permit
19843this, it is better choose a simple labelling scheme for our first 19843this, it is better choose a simple labeling scheme for our first
19844effort, and to modify or replace it later. 19844effort, and to modify or replace it later.
19845 19845
19846@need 1200 19846@need 1200
@@ -19864,7 +19864,7 @@ These considerations suggest the following outline for the
19864We can work on each part of the @code{print-graph} function definition 19864We can work on each part of the @code{print-graph} function definition
19865in turn. 19865in turn.
19866 19866
19867@node print-graph Varlist, print-Y-axis, Labelled Example, Full Graph 19867@node print-graph Varlist, print-Y-axis, Labeled Example, Full Graph
19868@comment node-name, next, previous, up 19868@comment node-name, next, previous, up
19869@appendixsec The @code{print-graph} Varlist 19869@appendixsec The @code{print-graph} Varlist
19870@cindex @code{print-graph} varlist 19870@cindex @code{print-graph} varlist
@@ -20391,7 +20391,7 @@ blank spaces and also separated according to the value of the variable
20391The value of the variable @code{X-axis-label-spacing} should itself be 20391The value of the variable @code{X-axis-label-spacing} should itself be
20392measured in units of @code{symbol-width}, since you may want to change 20392measured in units of @code{symbol-width}, since you may want to change
20393the width of the symbols that you are using to print the body of the 20393the width of the symbols that you are using to print the body of the
20394graph without changing the ways the graph is labelled. 20394graph without changing the ways the graph is labeled.
20395 20395
20396@menu 20396@menu
20397* Similarities differences:: Much like @code{print-Y-axis}, but not exactly. 20397* Similarities differences:: Much like @code{print-Y-axis}, but not exactly.
@@ -20722,7 +20722,7 @@ Emacs will print the horizontal axis like this:
20722Now we are nearly ready to print the whole graph. 20722Now we are nearly ready to print the whole graph.
20723 20723
20724The function to print the graph with the proper labels follows the 20724The function to print the graph with the proper labels follows the
20725outline we created earlier (@pxref{Full Graph, , A Graph with Labelled 20725outline we created earlier (@pxref{Full Graph, , A Graph with Labeled
20726Axes}), but with additions. 20726Axes}), but with additions.
20727 20727
20728@need 1250 20728@need 1250
@@ -20857,7 +20857,7 @@ Finally, the code for the @code{print-graph} function:
20857;;; @r{Final version.} 20857;;; @r{Final version.}
20858(defun print-graph 20858(defun print-graph
20859 (numbers-list &optional vertical-step) 20859 (numbers-list &optional vertical-step)
20860 "Print labelled bar graph of the NUMBERS-LIST. 20860 "Print labeled bar graph of the NUMBERS-LIST.
20861The numbers-list consists of the Y-axis values. 20861The numbers-list consists of the Y-axis values.
20862@end group 20862@end group
20863 20863
@@ -21478,7 +21478,7 @@ each column."
21478@group 21478@group
21479(defun print-graph 21479(defun print-graph
21480 (numbers-list &optional vertical-step horizontal-step) 21480 (numbers-list &optional vertical-step horizontal-step)
21481 "Print labelled bar graph of the NUMBERS-LIST. 21481 "Print labeled bar graph of the NUMBERS-LIST.
21482The numbers-list consists of the Y-axis values. 21482The numbers-list consists of the Y-axis values.
21483@end group 21483@end group
21484 21484
@@ -21979,7 +21979,7 @@ each column."
21979@group 21979@group
21980(defun print-graph 21980(defun print-graph
21981 (numbers-list &optional vertical-step horizontal-step) 21981 (numbers-list &optional vertical-step horizontal-step)
21982 "Print labelled bar graph of the NUMBERS-LIST. 21982 "Print labeled bar graph of the NUMBERS-LIST.
21983The numbers-list consists of the Y-axis values. 21983The numbers-list consists of the Y-axis values.
21984@end group 21984@end group
21985 21985
@@ -22275,4 +22275,3 @@ airplane.
22275@c @end iftex 22275@c @end iftex
22276 22276
22277@bye 22277@bye
22278
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index cbe016ac96d..0fa50492481 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,36 @@
12011-11-17 Martin Rudalics <rudalics@gmx.at>
2
3 * windows.texi (Resizing Windows, Splitting Windows)
4 (Deleting Windows): Use term window-combination-resize instead
5 of window-splits.
6
72011-11-16 Martin Rudalics <rudalics@gmx.at>
8
9 * windows.texi (Resizing Windows, Splitting Windows): Rename
10 occurrences of window-nest to window-combination-limit.
11
122011-11-14 Juanma Barranquero <lekktu@gmail.com>
13
14 * intro.texi (Lisp History): Fix typo.
15
162011-11-12 Martin Rudalics <rudalics@gmx.at>
17
18 * windows.texi (Splitting Windows, Deleting Windows): Remove
19 references to splits status of windows.
20
212011-11-10 Glenn Morris <rgm@gnu.org>
22
23 * buffers.texi (Read Only Buffers): Expand a bit on why
24 toggle-read-only should only be used interactively. (Bug#7292)
25
262011-11-09 Chong Yidong <cyd@gnu.org>
27
28 * windows.texi (Window Sizes): Document window-pixel-edges,
29 window-inside-pixel-edges, window-absolute-pixel-edges, and
30 window-inside-absolute-pixel-edges.
31 (Resizing Windows): shrink-window-if-larger-than-buffer works on
32 non-full-width windows.
33
12011-11-09 Martin Rudalics <rudalics@gmx.at> 342011-11-09 Martin Rudalics <rudalics@gmx.at>
2 35
3 * windows.texi (Resizing Windows): Rewrite documentation of 36 * windows.texi (Resizing Windows): Rewrite documentation of
@@ -1094,9 +1127,9 @@
1094 * commands.texi (Misc Events): Add cross-references to where 1127 * commands.texi (Misc Events): Add cross-references to where
1095 POSITION of a mouse event is described in detail. 1128 POSITION of a mouse event is described in detail.
1096 1129
10972010-08-08 Christoph <cschol2112@googlemail.com> 11302010-08-08 Christoph Scholtes <cschol2112@googlemail.com>
1098 1131
1099 * control.texi (Handling Errors) <error-message-string>: Fix arg name. 1132 * control.texi (Handling Errors) <error-message-string>: Fix arg name.
1100 1133
11012010-08-08 Juanma Barranquero <lekktu@gmail.com> 11342010-08-08 Juanma Barranquero <lekktu@gmail.com>
1102 1135
diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi
index 816d0f9faa8..ee2ce2e2001 100644
--- a/doc/lispref/buffers.texi
+++ b/doc/lispref/buffers.texi
@@ -748,10 +748,11 @@ of the list (comparison is done with @code{eq}).
748 748
749@deffn Command toggle-read-only &optional arg 749@deffn Command toggle-read-only &optional arg
750This command toggles whether the current buffer is read-only. It is 750This command toggles whether the current buffer is read-only. It is
751intended for interactive use; do not use it in programs. At any given 751intended for interactive use; do not use it in programs (it may have
752point in a program, you should know whether you want the read-only flag 752side-effects, such as enabling View mode, and does not affect
753on or off; so you can set @code{buffer-read-only} explicitly to the 753read-only text properties). To change the read-only state of a buffer in
754proper value, @code{t} or @code{nil}. 754a program, explicitly set @code{buffer-read-only} to the proper value.
755To temporarily ignore a read-only state, bind @code{inhibit-read-only}.
755 756
756If @var{arg} is non-@code{nil}, it should be a raw prefix argument. 757If @var{arg} is non-@code{nil}, it should be a raw prefix argument.
757@code{toggle-read-only} sets @code{buffer-read-only} to @code{t} if 758@code{toggle-read-only} sets @code{buffer-read-only} to @code{t} if
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index 71b612c527d..86ecfd122ef 100644
--- a/doc/lispref/files.texi
+++ b/doc/lispref/files.texi
@@ -2827,7 +2827,7 @@ If @code{file-remote-p} returns the same identifier for two different
2827filenames, that means they are stored on the same file system and can 2827filenames, that means they are stored on the same file system and can
2828be accessed locally with respect to each other. This means, for 2828be accessed locally with respect to each other. This means, for
2829example, that it is possible to start a remote process accessing both 2829example, that it is possible to start a remote process accessing both
2830files at the same time. Implementors of file handlers need to ensure 2830files at the same time. Implementers of file handlers need to ensure
2831this principle is valid. 2831this principle is valid.
2832 2832
2833@var{identification} specifies which part of the identifier shall be 2833@var{identification} specifies which part of the identifier shall be
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index d9399e98a69..d2e86a77112 100644
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -2414,7 +2414,7 @@ This function returns the ``vendor'' that provided the X server
2414software (as a string). Really this means whoever distributes the X 2414software (as a string). Really this means whoever distributes the X
2415server. 2415server.
2416 2416
2417When the developers of X labelled software distributors as 2417When the developers of X labeled software distributors as
2418``vendors,'' they showed their false assumption that no system could 2418``vendors,'' they showed their false assumption that no system could
2419ever be developed and distributed noncommercially. 2419ever be developed and distributed noncommercially.
2420@end defun 2420@end defun
@@ -2430,4 +2430,3 @@ This variable's value is @code{t} if no X window manager is in use.
2430The functions @code{x-pixel-width} and @code{x-pixel-height} return the 2430The functions @code{x-pixel-width} and @code{x-pixel-height} return the
2431width and height of an X Window frame, measured in pixels. 2431width and height of an X Window frame, measured in pixels.
2432@end ignore 2432@end ignore
2433
diff --git a/doc/lispref/internals.texi b/doc/lispref/internals.texi
index 5cdd983f40d..0168c564e34 100644
--- a/doc/lispref/internals.texi
+++ b/doc/lispref/internals.texi
@@ -887,7 +887,7 @@ known to be unchanged since the last complete redisplay.
887@item unchanged_modified 887@item unchanged_modified
888@itemx overlay_unchanged_modified 888@itemx overlay_unchanged_modified
889The values of @code{modiff} and @code{overlay_modiff}, respectively, 889The values of @code{modiff} and @code{overlay_modiff}, respectively,
890after the last compelete redisplay. If their current values match 890after the last complete redisplay. If their current values match
891@code{modiff} or @code{overlay_modiff}, that means 891@code{modiff} or @code{overlay_modiff}, that means
892@code{beg_unchanged} and @code{end_unchanged} contain no useful 892@code{beg_unchanged} and @code{end_unchanged} contain no useful
893information. 893information.
diff --git a/doc/lispref/intro.texi b/doc/lispref/intro.texi
index 7c070726023..44ac947fa99 100644
--- a/doc/lispref/intro.texi
+++ b/doc/lispref/intro.texi
@@ -101,7 +101,7 @@ for other purposes as well, such as writing editing commands.
101 Dozens of Lisp implementations have been built over the years, each 101 Dozens of Lisp implementations have been built over the years, each
102with its own idiosyncrasies. Many of them were inspired by Maclisp, 102with its own idiosyncrasies. Many of them were inspired by Maclisp,
103which was written in the 1960s at MIT's Project MAC. Eventually the 103which was written in the 1960s at MIT's Project MAC. Eventually the
104implementors of the descendants of Maclisp came together and developed a 104implementers of the descendants of Maclisp came together and developed a
105standard for Lisp systems, called Common Lisp. In the meantime, Gerry 105standard for Lisp systems, called Common Lisp. In the meantime, Gerry
106Sussman and Guy Steele at MIT developed a simplified but very powerful 106Sussman and Guy Steele at MIT developed a simplified but very powerful
107dialect of Lisp, called Scheme. 107dialect of Lisp, called Scheme.
diff --git a/doc/lispref/processes.texi b/doc/lispref/processes.texi
index d4f8ee9708b..51d91572d0e 100644
--- a/doc/lispref/processes.texi
+++ b/doc/lispref/processes.texi
@@ -420,7 +420,7 @@ remote files.
420Per default, this variable is always set to @code{t}, meaning that a 420Per default, this variable is always set to @code{t}, meaning that a
421call of @code{process-file} could potentially change any file on a 421call of @code{process-file} could potentially change any file on a
422remote host. When set to @code{nil}, a file handler could optimize 422remote host. When set to @code{nil}, a file handler could optimize
423its behaviour with respect to remote file attributes caching. 423its behavior with respect to remote file attributes caching.
424 424
425This variable should never be changed by @code{setq}. Instead of, it 425This variable should never be changed by @code{setq}. Instead of, it
426shall be set only by let-binding. 426shall be set only by let-binding.
diff --git a/doc/lispref/spellfile b/doc/lispref/spellfile
index b373d00bebf..e66dcc88f71 100644
--- a/doc/lispref/spellfile
+++ b/doc/lispref/spellfile
@@ -240,7 +240,7 @@ correct'
240counterintuitive 240counterintuitive
241cr 241cr
242creatable 242creatable
243customie 243customize
244deactivate 244deactivate
245deactivated 245deactivated
246deassigns 246deassigns
@@ -331,7 +331,6 @@ for'
331formfeed 331formfeed
332forms' 332forms'
333forw 333forw
334forwa
335found' 334found'
336frob 335frob
337from' 336from'
diff --git a/doc/lispref/two-volume-cross-refs.txt b/doc/lispref/two-volume-cross-refs.txt
index 99b48d342ab..53a9f58cd01 100644
--- a/doc/lispref/two-volume-cross-refs.txt
+++ b/doc/lispref/two-volume-cross-refs.txt
@@ -87,7 +87,7 @@ to create elisp2-aux-vol-added
87insert elisp2-aux-vol-added into vol1.aux (append) 87insert elisp2-aux-vol-added into vol1.aux (append)
88insert elisp1-aux-vol-added into vol2.aux (prepend) 88insert elisp1-aux-vol-added into vol2.aux (prepend)
89 89
90(so you dont have to do it again) 90(so you don't have to do it again)
91% cp vol1.aux elisp1-aux-ready 91% cp vol1.aux elisp1-aux-ready
92% cp vol2.aux elisp2-aux-ready 92% cp vol2.aux elisp2-aux-ready
93 93
@@ -120,7 +120,7 @@ Be sure that .fn file has no blank lines.
120% texindex vol1.fn 120% texindex vol1.fn
121% texindex vol2.fn 121% texindex vol2.fn
122 122
123(so you dont have to do it again) 123(so you don't have to do it again)
124% cp vol1.fns elisp1-fns-2vol-ready 124% cp vol1.fns elisp1-fns-2vol-ready
125% cp vol2.fns elisp2-fns-2vol-ready 125% cp vol2.fns elisp2-fns-2vol-ready
126 126
diff --git a/doc/lispref/windows.texi b/doc/lispref/windows.texi
index 52ac5a53900..8c99a06909b 100644
--- a/doc/lispref/windows.texi
+++ b/doc/lispref/windows.texi
@@ -375,13 +375,13 @@ Bars}). At the top of the window is an optional header line
375line (@pxref{Mode Line Format}). 375line (@pxref{Mode Line Format}).
376 376
377 Emacs provides several functions for finding the height and width of 377 Emacs provides several functions for finding the height and width of
378a window. Most of these functions report the values as integer 378a window. Except where noted, these heights and widths are reported
379multiples of the default character height and width. On a graphical 379as integer numbers of lines and columns respectively. On a graphical
380display, the actual screen size of this default height and width are 380display, each ``line'' and ``column'' actually corresponds to the
381those specified by the frame's default font. Hence, if the buffer 381height and width of a ``default'' character specified by the frame's
382contains text that is displayed in a different size, the reported 382default font. Thus, if a window is displaying text with a different
383height and width of the window may differ from the actual number of 383font or size, the reported height and width for that window may differ
384text lines or columns displayed in it. 384from the actual number of text lines or columns displayed within it.
385 385
386@cindex window height 386@cindex window height
387@cindex height of a window 387@cindex height of a window
@@ -534,6 +534,45 @@ can be resized in the desired direction. To determine that, use the
534function @code{window-resizable}. @xref{Resizing Windows}. 534function @code{window-resizable}. @xref{Resizing Windows}.
535@end defun 535@end defun
536 536
537 The following functions can be used to find a window's size and
538position in pixels. Though mostly useful on graphical displays, they
539can also be called on text-only terminals, where the screen area of
540each text character is taken to be ``one pixel''.
541
542@defun window-pixel-edges &optional window
543This function return a list of pixel coordinates for the edges of
544@var{window}. If @var{window} is omitted or @code{nil}, it defaults
545to the selected window.
546
547The return value has the form @code{(@var{left} @var{top} @var{right}
548@var{bottom})}. The list elements are, respectively, the X coordinate
549of the left window edge, the Y coordinate of the top edge, one more
550than the X coordinate of the right edge, and one more than the Y
551coordinate of the bottom edge. The origin coordinate @samp{(0,0)} is
552taken to be the top left corner of the frame's window area.
553
554These edge values include the space used by the window's scroll bar,
555margins, fringes, header line, and mode line, if any.
556@end defun
557
558@defun window-inside-pixel-edges &optional window
559This function is like @code{window-pixel-edges}, except that it
560returns the edge coordinates for the window's text area, rather than
561the edge coordinates for the window itself. @var{window} must specify
562a live window.
563@end defun
564
565@defun window-absolute-pixel-edges &optional window
566This function is like @code{window-pixel-edges}, except that it
567returns the edge coordinates relative to the top left corner of the
568display screen.
569@end defun
570
571@defun window-inside-absolute-pixel-edges &optional window
572This function is like @code{window-inside-pixel-edges}, except that it
573returns the edge coordinates relative to the top left corner of the
574display screen. @var{window} must specify a live window.
575@end defun
537 576
538@node Resizing Windows 577@node Resizing Windows
539@section Resizing Windows 578@section Resizing Windows
@@ -593,10 +632,11 @@ the window cannot be resized as demanded, an error is signaled.
593The optional argument @var{ignore} has the same meaning as for the 632The optional argument @var{ignore} has the same meaning as for the
594function @code{window-resizable} above. 633function @code{window-resizable} above.
595 634
596The choice of which window edge this function alters depends on the 635The choice of which window edges this function alters depends on the
597splitting and nesting status of the involved windows; in some cases, 636values of the option @code{window-combination-resize} and the
598it may alter both edges. @xref{Splitting Windows}. To resize by 637combination-limit status of the involved windows; in some cases, it may
599moving only the bottom or right edge of a window, use the function 638alter both edges. @xref{Splitting Windows}. To resize by moving only
639the bottom or right edge of a window, use the function
600@code{adjust-window-trailing-edge}, below. 640@code{adjust-window-trailing-edge}, below.
601@end defun 641@end defun
602 642
@@ -604,104 +644,85 @@ moving only the bottom or right edge of a window, use the function
604@c shrink-window, and shrink-window-horizontally are documented in the 644@c shrink-window, and shrink-window-horizontally are documented in the
605@c Emacs manual. They are not preferred for calling from Lisp. 645@c Emacs manual. They are not preferred for calling from Lisp.
606 646
607 The following function is useful for moving the line dividing two
608windows.
609
610@defun adjust-window-trailing-edge window delta &optional horizontal 647@defun adjust-window-trailing-edge window delta &optional horizontal
611This function moves @var{window}'s bottom edge by @var{delta} lines. 648This function moves @var{window}'s bottom edge by @var{delta} lines.
612Optional argument @var{horizontal} non-@code{nil} means to move 649If optional argument @var{horizontal} is non-@code{nil}, it instead
613@var{window}'s right edge by @var{delta} columns. The argument 650moves the right edge by @var{delta} columns. If @var{window} is
614@var{window} defaults to the selected window. 651@code{nil}, it defaults to the selected window.
615 652
616If @var{delta} is greater zero, this moves the edge downwards or to the 653A positive @var{delta} moves the edge downwards or to the right; a
617right. If @var{delta} is less than zero, this moves the edge upwards or 654negative @var{delta} moves it upwards or to the left. If the edge
618to the left. If the edge can't be moved by @var{delta} lines or columns, 655cannot be moved as far as specified by @var{delta}, this function
619it is moved as far as possible in the desired direction but no error is 656moves it as far as possible but does not signal a error.
620signaled.
621 657
622This function tries to resize windows adjacent to the edge that is 658This function tries to resize windows adjacent to the edge that is
623moved. Only if this is insufficient, it will also resize windows not 659moved. If this is not possible for some reason (e.g. if that adjacent
624adjacent to that edge. As a consequence, if you move an edge in one 660window is fixed-size), it may resize other windows.
625direction and back in the other direction by the same amount, the
626resulting window configuration will not be necessarily identical to the
627one before the first move. So if your intend to just resize
628@var{window}, you should not use this function but call
629@code{window-resize} (see above) instead.
630@end defun 661@end defun
631 662
663 The following commands resize windows in more specific ways. When
664called interactively, they act on the selected window.
665
632@deffn Command fit-window-to-buffer &optional window max-height min-height override 666@deffn Command fit-window-to-buffer &optional window max-height min-height override
633This command makes @var{window} the right height to display its 667This command adjusts the height of @var{window} to fit the text in it.
634contents exactly. The default for @var{window} is the selected window. 668It returns non-@code{nil} if it was able to resize @var{window}, and
635 669@code{nil} otherwise. If @var{window} is omitted or @code{nil}, it
636The optional argument @var{max-height} specifies the maximum total 670defaults to the selected window. Otherwise, it should be a live
637height the window is allowed to be; @code{nil} means use the maximum 671window.
638permissible height of a window on @var{window}'s frame. The optional 672
639argument @var{min-height} specifies the minimum total height for the 673The optional argument @var{max-height}, if non-@code{nil}, specifies
640window; @code{nil} means use @code{window-min-height}. All these height 674the maximum total height that this function can give @var{window}.
641values include the mode line and/or header line. 675The optional argument @var{min-height}, if no-@code{nil}, specifies
642 676the minimum total height that it can give, which overrides the
643If the optional argument @var{override} is non-@code{nil}, this means to 677variable @code{window-min-height}.
644ignore any restrictions imposed by @code{window-min-height} and 678
645@code{window-min-width} on the size of @var{window}. 679If the optional argument @var{override} is non-@code{nil}, this
646 680function ignores any size restrictions imposed by
647This function returns non-@code{nil} if it orderly resized @var{window}, 681@code{window-min-height} and @code{window-min-width}.
648and @code{nil} otherwise.
649@end deffn 682@end deffn
650 683
651@deffn Command shrink-window-if-larger-than-buffer &optional window 684@deffn Command shrink-window-if-larger-than-buffer &optional window
652This command shrinks @var{window} vertically to be as small as possible 685This command attempts to reduce @var{window}'s height as much as
653while still showing the full contents of its buffer---but not less than 686possible while still showing its full buffer, but no less than
654@code{window-min-height} lines. The argument @var{window} must denote 687@code{window-min-height} lines. The return value is non-@code{nil} if
655a live window and defaults to the selected one. 688the window was resized, and @code{nil} otherwise. If @var{window} is
656 689omitted or @code{nil}, it defaults to the selected window. Otherwise,
657However, this command does nothing if the window is already too small to 690it should be a live window.
658display the whole text of the buffer, or if part of the contents are 691
659currently scrolled off screen, or if the window is not the full width of 692This command does nothing if the window is already too short to
660its frame, or if the window is the only window in its frame. 693display all of its buffer, or if any of the buffer is scrolled
661 694off-screen, or if the window is the only live window in its frame.
662This command returns non-@code{nil} if it actually shrank the window
663and @code{nil} otherwise.
664@end deffn 695@end deffn
665 696
666@cindex balancing window sizes 697@cindex balancing window sizes
667Emacs provides two functions to balance windows, that is, to even out
668the sizes of all windows on the same frame. The minibuffer window and
669fixed-size windows are not resized by these functions.
670
671@deffn Command balance-windows &optional window-or-frame 698@deffn Command balance-windows &optional window-or-frame
672This function balances windows in a way that gives more space to 699This function balances windows in a way that gives more space to
673full-width and/or full-height windows. If @var{window-or-frame} 700full-width and/or full-height windows. If @var{window-or-frame}
674specifies a frame, it balances all windows on that frame. If 701specifies a frame, it balances all windows on that frame. If
675@var{window-or-frame} specifies a window, it balances that window and 702@var{window-or-frame} specifies a window, it balances only that window
676its siblings (@pxref{Windows and Frames}) only. 703and its siblings (@pxref{Windows and Frames}).
677@end deffn 704@end deffn
678 705
679@deffn Command balance-windows-area 706@deffn Command balance-windows-area
680This function attempts to give all windows on the selected frame 707This function attempts to give all windows on the selected frame
681approximately the same share of the screen area. This means that 708approximately the same share of the screen area. Full-width or
682full-width or full-height windows are not given more space than other 709full-height windows are not given more space than other windows.
683windows.
684@end deffn 710@end deffn
685 711
686@cindex maximizing windows 712@cindex maximizing windows
687The following function can be used to give a window the maximum possible
688size without deleting other ones.
689
690@deffn Command maximize-window &optional window 713@deffn Command maximize-window &optional window
691This function maximizes @var{window}. More precisely, this makes 714This function attempts to make @var{window} as large as possible, in
692@var{window} as large as possible without resizing its frame or deleting 715both dimensions, without resizing its frame or deleting other windows.
693other windows. @var{window} can be any window and defaults to the 716If @var{window} is omitted or @code{nil}, it defaults to the selected
694selected one. 717window.
695@end deffn 718@end deffn
696 719
697@cindex minimizing windows 720@cindex minimizing windows
698To make a window as small as possible without deleting it the
699following function can be used.
700
701@deffn Command minimize-window &optional window 721@deffn Command minimize-window &optional window
702This function minimizes @var{window}. More precisely, this makes 722This function attempts to make @var{window} as small as possible, in
703@var{window} as small as possible without deleting it or resizing its 723both dimensions, without deleting it or resizing its frame. If
704frame. @var{window} can be any window and defaults to the selected one. 724@var{window} is omitted or @code{nil}, it defaults to the selected
725window.
705@end deffn 726@end deffn
706 727
707 728
@@ -719,7 +740,7 @@ This function creates a new live window next to the window
719to the selected window. That window is ``split'', and reduced in 740to the selected window. That window is ``split'', and reduced in
720size. The space is taken up by the new window, which is returned. 741size. The space is taken up by the new window, which is returned.
721 742
722The optional second argument @var{size} determines the sizes of the 743The optional second argument @var{size} determines the sizes of
723@var{window} and/or the new window. If it is omitted or @code{nil}, 744@var{window} and/or the new window. If it is omitted or @code{nil},
724both windows are given equal sizes; if there is an odd line, it is 745both windows are given equal sizes; if there is an odd line, it is
725allocated to the new window. If @var{size} is a positive number, 746allocated to the new window. If @var{size} is a positive number,
@@ -765,10 +786,10 @@ lieu of the usual action of @code{split-window}.
765 786
766 As an example, we show a combination of @code{split-window} calls 787 As an example, we show a combination of @code{split-window} calls
767that yields the window configuration discussed in @ref{Windows and 788that yields the window configuration discussed in @ref{Windows and
768Frames}. This example demonstrates splitting live windows as well as 789Frames}. This example demonstrates splitting a live window as well as
769splitting internal windows. We begin with a frame containing a single 790splitting an internal window. We begin with a frame containing a
770window (a live root window), which we denote by @var{W4}. Calling 791single window (a live root window), which we denote by @var{W4}.
771@code{(split-window W3)} yields this window configuration: 792Calling @code{(split-window W3)} yields this window configuration:
772 793
773@smallexample 794@smallexample
774@group 795@group
@@ -816,15 +837,14 @@ internal window @var{W3} as the argument. The result:
816@end smallexample 837@end smallexample
817 838
818@noindent 839@noindent
819A new live window, @var{W2}, is created to the left of @var{W3} (which 840A new live window @var{W2} is created, to the left of the internal
820encompasses the vertical window combination of @var{W4} and @var{W5}). 841window @var{W3}. A new internal window @var{W1} is created, becoming
821A new internal window @var{W1} is also created, and becomes the new 842the new root window.
822root window.
823 843
824 The following two options can be used to modify the operation of 844 The following two options can be used to modify the operation of
825@code{split-window}. 845@code{split-window}.
826 846
827@defopt window-splits 847@defopt window-combination-resize
828If this variable is @code{nil}, @code{split-window} can only split a 848If this variable is @code{nil}, @code{split-window} can only split a
829window (denoted by @var{window}) if @var{window}'s screen area is 849window (denoted by @var{window}) if @var{window}'s screen area is
830large enough to accommodate both itself and the new window. This is 850large enough to accommodate both itself and the new window. This is
@@ -836,45 +856,16 @@ resize all windows that are part of the same combination as
836this may allow @code{split-window} to succeed even if @var{window} is 856this may allow @code{split-window} to succeed even if @var{window} is
837a fixed-size window or too small to ordinarily split. 857a fixed-size window or too small to ordinarily split.
838 858
839In any case, the value of this variable is assigned to the splits status 859Also if this variable is non-@code{nil}, subsequent resizing and
840of the new window and, provided old and new window form a new 860deleting @var{window} will usually affect @emph{all} windows in
841combination, of the old window as well. The splits status of a window 861@var{window}'s combination.
842can be retrieved by invoking the function @code{window-splits} and
843altered by the function @code{set-window-splits} described next.
844 862
845If @code{window-nest} (see below) is non-@code{nil}, the space for the 863The setting of this variable has no effect if
846new window is exclusively taken from the old window, but the splits 864@code{window-combination-limit} (see below) is non-@code{nil}.
847status of the involved windows is nevertheless set as described here.
848@end defopt 865@end defopt
849 866
850@defun window-splits &optional window 867To illustrate the use of @code{window-combination-resize} consider the
851This function returns the splits status of @var{window}. The argument 868following window configuration:
852@var{window} can be any window and defaults to the selected one.
853
854@cindex splits status
855The @dfn{splits status} of a window specifies how resizing and deleting
856that window may affect the size of other windows in the same window
857combination. More precisely, if @var{window}'s splits status is
858@code{nil} and @var{window} is resized, the corresponding space is
859preferably taken from (or given to) @var{window}'s right sibling. When
860@var{window} is deleted, its space is given to its left sibling. If
861@var{window}'s splits status is non-@code{nil}, resizing and deleting
862@var{window} may resize @emph{all} windows in @var{window}'s
863combination.
864
865The splits status is initially set by @code{split-window}
866from the current value of the variable @code{window-splits} (see above)
867and can be reset by the function @code{set-window-splits} (see below).
868@end defun
869
870@defun set-window-splits window &optional status
871This function sets the splits status (see above) of @var{window} to
872@var{status}. The argument @var{window} can be any window and defaults
873to the selected one. The return value is @var{status}.
874@end defun
875
876To illustrate the use of @code{window-splits} consider the following
877window configuration:
878@smallexample 869@smallexample
879@group 870@group
880 ______________________________________ 871 ______________________________________
@@ -895,8 +886,9 @@ window configuration:
895@end group 886@end group
896@end smallexample 887@end smallexample
897 888
898Splitting window @code{W3} with @code{window-splits} @code{nil} 889Splitting window @code{W3} with @code{window-combination-resize}
899produces a configuration where the size of @code{W2} remains unchanged: 890@code{nil} produces a configuration where the size of @code{W2} remains
891unchanged:
900@smallexample 892@smallexample
901@group 893@group
902 ______________________________________ 894 ______________________________________
@@ -917,10 +909,8 @@ produces a configuration where the size of @code{W2} remains unchanged:
917@end group 909@end group
918@end smallexample 910@end smallexample
919 911
920Splitting @code{W3} with @code{window-splits} non-@code{nil} instead 912Splitting @code{W3} with @code{window-combination-resize} non-@code{nil}
921produces a configuration where all windows have approximately the same 913instead steals the space for @code{W4} from both @code{W2} and @code{W3}:
922height:
923
924@smallexample 914@smallexample
925@group 915@group
926 ______________________________________ 916 ______________________________________
@@ -941,34 +931,36 @@ height:
941@end group 931@end group
942@end smallexample 932@end smallexample
943 933
944@defopt window-nest 934@defopt window-combination-limit
945If this variable is @code{nil}, @code{split-window} creates a new parent 935If this variable is @code{nil}, @code{split-window} creates a new parent
946window if and only if the old window has no parent window or shall be 936window if and only if the old window has no parent window or shall be
947split orthogonally to the combination it is part of. If this variable 937split orthogonally to the combination it is part of. If this variable
948is non-@code{nil}, @code{split-window} always creates a new parent 938is @code{t}, @code{split-window} always creates a new parent window. If
949window. If this variable is always non-@code{nil}, a frame's window 939this variable is always @code{t}, a frame's window tree is a binary tree
950tree is a binary tree so every window but the frame's root window has 940so every window but the frame's root window has exactly one sibling.
951exactly one sibling. 941Other values are reserved for future use.
952 942
953The value of this variable is also assigned to the nest status of the 943The value of this variable is also assigned to the combination-limit
954new parent window. The nest status of any window can be retrieved via 944status of the new parent window. The combination-limit status of any
955the function @code{window-nest} and altered by the function 945window can be retrieved via the function @code{window-combination-limit}
956@code{set-window-nest}, see below. 946and altered by the function @code{set-window-combination-limit}, see
947below.
957@end defopt 948@end defopt
958 949
959@defun window-nest &optional window 950@defun window-combination-limit &optional window
960This function returns the nest status of @var{window}. The argument 951This function returns the combination-limit status of @var{window}. The
961@var{window} can be any window and defaults to the selected one. Note, 952argument @var{window} can be any window and defaults to the selected
962however, that the nest status is currently meaningful for internal 953one. Note, however, that the combination-limit status is currently
963windows only. 954meaningful for internal windows only.
964 955
965@cindex nest status 956@cindex combination-limit status
966The @dfn{nest status} of a window specifies whether that window may be 957The @dfn{combination-limit status} of a window specifies whether that
967removed and its child windows recombined with that window's siblings 958window may be removed and its child windows recombined with that
968when such a sibling's child window is deleted. The nest status is 959window's siblings when such a sibling's child window is deleted. The
969initially assigned by @code{split-window} from the current value of the 960combination-limit status is initially assigned by @code{split-window}
970variable @code{window-nest} (see above) and can be reset by the function 961from the current value of the variable @code{window-combination-limit}
971@code{set-window-nest} (see below). 962(see above) and can be reset by the function
963@code{set-window-combination-limit} (see below).
972 964
973If the return value is @code{nil}, child windows of @var{window} may be 965If the return value is @code{nil}, child windows of @var{window} may be
974recombined with @var{window}'s siblings when a window gets deleted. A 966recombined with @var{window}'s siblings when a window gets deleted. A
@@ -976,16 +968,17 @@ return value of @code{nil} means that child windows of @var{window} are
976never (re-)combined with @var{window}'s siblings in such a case. 968never (re-)combined with @var{window}'s siblings in such a case.
977@end defun 969@end defun
978 970
979@defun set-window-nest window &optional status 971@defun set-window-combination-limit window &optional status
980This functions sets the nest status (see above) of @var{window} to 972This functions sets the combination-limit status (see above) of
981@var{status}. The argument @var{window} can be any window and defaults 973@var{window} to @var{status}. The argument @var{window} can be any
982to the selected one. Note that setting the nest status is meaningful 974window and defaults to the selected one. Note that setting the
983for internal windows only. The return value is @var{status}. 975combination-limit status is meaningful for internal windows only. The
976return value is @var{status}.
984@end defun 977@end defun
985 978
986To illustrate the use of @code{window-nest} consider the following 979To illustrate the use of @code{window-combination-limit} consider the
987configuration (throughout the following examples we shall assume that 980following configuration (throughout the following examples we shall
988@code{window-splits} invariantly is @code{nil}). 981assume that @code{window-combination-resize} invariantly is @code{nil}).
989@smallexample 982@smallexample
990@group 983@group
991 ______________________________________ 984 ______________________________________
@@ -1007,7 +1000,8 @@ configuration (throughout the following examples we shall assume that
1007@end smallexample 1000@end smallexample
1008 1001
1009Splitting @code{W2} into two windows above each other with 1002Splitting @code{W2} into two windows above each other with
1010@code{window-nest} equal @code{nil} will get you a configuration like: 1003@code{window-combination-limit} equal @code{nil} will get you a
1004configuration like:
1011@smallexample 1005@smallexample
1012@group 1006@group
1013 ______________________________________ 1007 ______________________________________
@@ -1074,9 +1068,9 @@ follows:
1074 1068
1075Hence, with respect to the initial configuration, window @code{W2} has 1069Hence, with respect to the initial configuration, window @code{W2} has
1076grown at the expense of window @code{W3}. If, however, in the initial 1070grown at the expense of window @code{W3}. If, however, in the initial
1077configuration you had split @code{W2} with @code{window-nest} bound to 1071configuration you had split @code{W2} with
1078@code{t}, a new internal window @code{W5} would have been created as 1072@code{window-combination-limit} bound to @code{t}, a new internal window
1079depicted below. 1073@code{W5} would have been created as depicted below.
1080@smallexample 1074@smallexample
1081@group 1075@group
1082 ______________________________________ 1076 ______________________________________
@@ -1189,12 +1183,12 @@ window parameters. If the @code{delete-window} parameter specifies a
1189function, that function is called with @var{window} as its sole 1183function, that function is called with @var{window} as its sole
1190argument. 1184argument.
1191 1185
1192If the splits status of @var{window} (@pxref{Splitting Windows}) is 1186If @code{window-combination-resize} (@pxref{Splitting Windows}) is
1193@code{nil}, the space @var{window} took up is given to its left sibling 1187@code{nil}, the space @var{window} took up is given to its left sibling
1194if such a window exists and to its right sibling otherwise. If the 1188if such a window exists and to its right sibling otherwise. If
1195splits status of @var{window} is non-@code{nil}, its space is 1189@code{window-combination-resize} is non-@code{nil}, the space of
1196proportionally distributed among the remaining windows in the same 1190@var{window} is proportionally distributed among the remaining windows
1197combination. 1191in the same combination.
1198@end deffn 1192@end deffn
1199 1193
1200@deffn Command delete-other-windows &optional window 1194@deffn Command delete-other-windows &optional window
diff --git a/doc/man/ChangeLog b/doc/man/ChangeLog
index b9175ce51ea..758cdde1dea 100644
--- a/doc/man/ChangeLog
+++ b/doc/man/ChangeLog
@@ -1,3 +1,7 @@
12011-11-16 Juanma Barranquero <lekktu@gmail.com>
2
3 * etags.1: Fix typo.
4
12011-10-06 Chong Yidong <cyd@stupidchicken.com> 52011-10-06 Chong Yidong <cyd@stupidchicken.com>
2 6
3 * emacsclient.1: Document how -a "" starts the daemon. 7 * emacsclient.1: Document how -a "" starts the daemon.
@@ -18,7 +22,7 @@
18 22
19 * Version 23.3 released. 23 * Version 23.3 released.
20 24
212011-01-02 Jari Aalto <jari.aalto@cante.net> (tiny change) 252011-01-02 Jari Aalto <jari.aalto@cante.net>
22 26
23 * emacsclient.1: Arrange options alphabetically (Bug#7620). 27 * emacsclient.1: Arrange options alphabetically (Bug#7620).
24 28
diff --git a/doc/man/etags.1 b/doc/man/etags.1
index f6b46add215..f7ffa112f3c 100644
--- a/doc/man/etags.1
+++ b/doc/man/etags.1
@@ -49,7 +49,7 @@ format understood by
49\&. Both forms of the program understand 49\&. Both forms of the program understand
50the syntax of C, Objective C, C++, Java, Fortran, Ada, Cobol, Erlang, 50the syntax of C, Objective C, C++, Java, Fortran, Ada, Cobol, Erlang,
51Forth, HTML, LaTeX, Emacs Lisp/Common Lisp, Lua, Makefile, Pascal, Perl, 51Forth, HTML, LaTeX, Emacs Lisp/Common Lisp, Lua, Makefile, Pascal, Perl,
52PHP, Postscript, Python, Prolog, Scheme and 52PHP, PostScript, Python, Prolog, Scheme and
53most assembler\-like syntaxes. 53most assembler\-like syntaxes.
54Both forms read the files specified on the command line, and write a tag 54Both forms read the files specified on the command line, and write a tag
55table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for 55table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog
index 029406e2d30..924f3501bfa 100644
--- a/doc/misc/ChangeLog
+++ b/doc/misc/ChangeLog
@@ -1,3 +1,22 @@
12011-11-16 Juanma Barranquero <lekktu@gmail.com>
2
3 * org.texi (Agenda commands, Exporting Agenda Views): Fix typos.
4
52011-11-15 Juanma Barranquero <lekktu@gmail.com>
6
7 * ede.texi (project-am-texinfo):
8 * gnus.texi (Sending or Not Sending):
9 * org.texi (Template elements): Fix typos.
10
112011-11-14 Juanma Barranquero <lekktu@gmail.com>
12
13 * ediff.texi (Hooks):
14 * sem-user.texi (Semanticdb Roots): Fix typos.
15
162011-11-11 Juanma Barranquero <lekktu@gmail.com>
17
18 * semantic.texi (Tag handling): Fix typo.
19
12011-10-31 Katsumi Yamaoka <yamaoka@jpl.org> 202011-10-31 Katsumi Yamaoka <yamaoka@jpl.org>
2 21
3 * gnus.texi (Other Gnus Versions): Remove. 22 * gnus.texi (Other Gnus Versions): Remove.
@@ -58,7 +77,7 @@
58 77
59 Release MH-E manual version 8.3. 78 Release MH-E manual version 8.3.
60 79
61 * mh-e.texi: (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for 80 * mh-e.texi (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for
62 release 8.3. 81 release 8.3.
63 (Preface): Updated support information. 82 (Preface): Updated support information.
64 (From Bill Wohler): Reset text to original version. As a 83 (From Bill Wohler): Reset text to original version. As a
@@ -296,7 +315,7 @@
296 315
2972011-08-15 Eric Schulte <schulte.eric@gmail.com> 3162011-08-15 Eric Schulte <schulte.eric@gmail.com>
298 317
299 * org.texi (Evaluating code blocks): Expanded discussion of 318 * org.texi (Evaluating code blocks): Expanded discussion of
300 #+call: line syntax. 319 #+call: line syntax.
301 (Header arguments in function calls): Expanded discussion of 320 (Header arguments in function calls): Expanded discussion of
302 #+call: line syntax. 321 #+call: line syntax.
@@ -2290,7 +2309,7 @@
22902009-08-25 Michael Albinus <michael.albinus@gmx.de> 23092009-08-25 Michael Albinus <michael.albinus@gmx.de>
2291 2310
2292 * dbus.texi (Bus names): Add optional parameter TIMEOUT to dbus-ping. 2311 * dbus.texi (Bus names): Add optional parameter TIMEOUT to dbus-ping.
2293 Describe autostart behaviour of dbus-ping. 2312 Describe autostart behavior of dbus-ping.
2294 (Synchronous Methods, Asynchronous Methods): Use English numeric format 2313 (Synchronous Methods, Asynchronous Methods): Use English numeric format
2295 for timeout values. 2314 for timeout values.
2296 (Top): Remove footnote saying D-Bus is not enabled by 2315 (Top): Remove footnote saying D-Bus is not enabled by
diff --git a/doc/misc/ada-mode.texi b/doc/misc/ada-mode.texi
index 66cdb200111..374158c2c78 100644
--- a/doc/misc/ada-mode.texi
+++ b/doc/misc/ada-mode.texi
@@ -184,7 +184,7 @@ convention, where file names are a simple modification of the Ada
184names, and the extension for specs and bodies are 184names, and the extension for specs and bodies are
185@samp{.ads} and @samp{.adb}, respectively. 185@samp{.ads} and @samp{.adb}, respectively.
186 186
187Ada mode uses the file extentions to allow moving from a package body 187Ada mode uses the file extensions to allow moving from a package body
188to the corresponding spec and back. 188to the corresponding spec and back.
189 189
190Ada mode supports a list of alternative file extensions for specs and bodies. 190Ada mode supports a list of alternative file extensions for specs and bodies.
@@ -209,7 +209,7 @@ whose extension is @file{.ads}, it will take the first available file
209that ends with either @file{.adb}, @file{_b.ada} or 209that ends with either @file{.adb}, @file{_b.ada} or
210@file{.body}. 210@file{.body}.
211 211
212Simililarly, if Ada mode is looking for a spec, it will look for 212Similarly, if Ada mode is looking for a spec, it will look for
213@file{.ads} or @file{_s.ada}. 213@file{.ads} or @file{_s.ada}.
214 214
215If the filename is not derived from the Ada name following the GNAT 215If the filename is not derived from the Ada name following the GNAT
@@ -1357,7 +1357,7 @@ specifies the casing of one word or word fragment. Comments may be
1357included, separated from the word by a space. 1357included, separated from the word by a space.
1358 1358
1359If the word starts with an asterisk (@key{*}), it defines the casing 1359If the word starts with an asterisk (@key{*}), it defines the casing
1360af a word fragemnt (or ``substring''); part of a word between two 1360af a word fragment (or ``substring''); part of a word between two
1361underscores or word boundary. 1361underscores or word boundary.
1362 1362
1363For example: 1363For example:
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi
index 887e3f3c808..55c2c4c0ae8 100644
--- a/doc/misc/cc-mode.texi
+++ b/doc/misc/cc-mode.texi
@@ -287,11 +287,11 @@ Configuration Basics
287 287
288Styles 288Styles
289 289
290* Built-in Styles:: 290* Built-in Styles::
291* Choosing a Style:: 291* Choosing a Style::
292* Adding Styles:: 292* Adding Styles::
293* Guessing the Style:: 293* Guessing the Style::
294* File Styles:: 294* File Styles::
295 295
296Customizing Auto-newlines 296Customizing Auto-newlines
297 297
@@ -311,19 +311,19 @@ Indentation Engine Basics
311 311
312Syntactic Symbols 312Syntactic Symbols
313 313
314* Function Symbols:: 314* Function Symbols::
315* Class Symbols:: 315* Class Symbols::
316* Conditional Construct Symbols:: 316* Conditional Construct Symbols::
317* Switch Statement Symbols:: 317* Switch Statement Symbols::
318* Brace List Symbols:: 318* Brace List Symbols::
319* External Scope Symbols:: 319* External Scope Symbols::
320* Paren List Symbols:: 320* Paren List Symbols::
321* Literal Symbols:: 321* Literal Symbols::
322* Multiline Macro Symbols:: 322* Multiline Macro Symbols::
323* Objective-C Method Symbols:: 323* Objective-C Method Symbols::
324* Java Symbols:: 324* Java Symbols::
325* Statement Block Symbols:: 325* Statement Block Symbols::
326* K&R Symbols:: 326* K&R Symbols::
327 327
328Customizing Indentation 328Customizing Indentation
329 329
@@ -343,8 +343,8 @@ Line-Up Functions
343 343
344Customizing Macros 344Customizing Macros
345 345
346* Macro Backslashes:: 346* Macro Backslashes::
347* Macros with ;:: 347* Macros with ;::
348 348
349@end detailmenu 349@end detailmenu
350@end menu 350@end menu
@@ -912,7 +912,7 @@ construct, should the point start inside it. If @ccmode fails to find
912function beginnings or ends inside the current declaration scope, it 912function beginnings or ends inside the current declaration scope, it
913will search the enclosing scopes. If you want @ccmode to recognize 913will search the enclosing scopes. If you want @ccmode to recognize
914functions only at the top level@footnote{this was @ccmode{}'s 914functions only at the top level@footnote{this was @ccmode{}'s
915behaviour prior to version 5.32.}, set @code{c-defun-tatic} to 915behavior prior to version 5.32.}, set @code{c-defun-tatic} to
916@code{t}. 916@code{t}.
917 917
918These functions are analogous to the Emacs built-in commands 918These functions are analogous to the Emacs built-in commands
@@ -1173,7 +1173,7 @@ Full details on how these minor modes work are at @ref{Electric Keys},
1173and @ref{Indentation Engine Basics}. 1173and @ref{Indentation Engine Basics}.
1174 1174
1175You can toggle each of these minor modes on and off, and you can 1175You can toggle each of these minor modes on and off, and you can
1176configure @ccmode{} so that it starts up with your favourite 1176configure @ccmode{} so that it starts up with your favorite
1177combination of them (@pxref{Sample .emacs File}). By default, when 1177combination of them (@pxref{Sample .emacs File}). By default, when
1178you initialize a buffer, electric mode and syntactic-indentation mode 1178you initialize a buffer, electric mode and syntactic-indentation mode
1179are enabled but the other two modes are disabled. 1179are enabled but the other two modes are disabled.
@@ -2537,11 +2537,11 @@ As an alternative to writing a style definition yourself, you can have
2537already formatted piece of your code, @ref{Guessing the Style}. 2537already formatted piece of your code, @ref{Guessing the Style}.
2538 2538
2539@menu 2539@menu
2540* Built-in Styles:: 2540* Built-in Styles::
2541* Choosing a Style:: 2541* Choosing a Style::
2542* Adding Styles:: 2542* Adding Styles::
2543* Guessing the Style:: 2543* Guessing the Style::
2544* File Styles:: 2544* File Styles::
2545@end menu 2545@end menu
2546 2546
2547@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 2547@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@@ -4266,19 +4266,19 @@ Java. @ref{Java Symbols}.
4266@end table 4266@end table
4267 4267
4268@menu 4268@menu
4269* Function Symbols:: 4269* Function Symbols::
4270* Class Symbols:: 4270* Class Symbols::
4271* Conditional Construct Symbols:: 4271* Conditional Construct Symbols::
4272* Switch Statement Symbols:: 4272* Switch Statement Symbols::
4273* Brace List Symbols:: 4273* Brace List Symbols::
4274* External Scope Symbols:: 4274* External Scope Symbols::
4275* Paren List Symbols:: 4275* Paren List Symbols::
4276* Literal Symbols:: 4276* Literal Symbols::
4277* Multiline Macro Symbols:: 4277* Multiline Macro Symbols::
4278* Objective-C Method Symbols:: 4278* Objective-C Method Symbols::
4279* Java Symbols:: 4279* Java Symbols::
4280* Statement Block Symbols:: 4280* Statement Block Symbols::
4281* K&R Symbols:: 4281* K&R Symbols::
4282@end menu 4282@end menu
4283 4283
4284@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 4284@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
@@ -6653,8 +6653,8 @@ these macros properly, see @ref{Macros with ;}.
6653 6653
6654@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 6654@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
6655@menu 6655@menu
6656* Macro Backslashes:: 6656* Macro Backslashes::
6657* Macros with ;:: 6657* Macros with ;::
6658@end menu 6658@end menu
6659 6659
6660@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!! 6660@comment !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
diff --git a/doc/misc/dbus.texi b/doc/misc/dbus.texi
index e6fb00d3482..79c7ada3b0b 100644
--- a/doc/misc/dbus.texi
+++ b/doc/misc/dbus.texi
@@ -553,7 +553,7 @@ data from a running system:
553@node Methods and Signal 553@node Methods and Signal
554@section Applying the functionality. 554@section Applying the functionality.
555 555
556Methods and signals are the communicatione means to D-Bus. The 556Methods and signals are the communication means to D-Bus. The
557following functions return their specifications. 557following functions return their specifications.
558 558
559@defun dbus-introspect-get-method-names bus service path interface 559@defun dbus-introspect-get-method-names bus service path interface
diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi
index 13b640a09fe..55dc7f9a822 100644
--- a/doc/misc/ede.texi
+++ b/doc/misc/ede.texi
@@ -518,7 +518,7 @@ It would look like this:
518(defun MY-LOAD (dir) 518(defun MY-LOAD (dir)
519 "Load a project of type `cpp-root' for the directory DIR. 519 "Load a project of type `cpp-root' for the directory DIR.
520Return nil if there isn't one." 520Return nil if there isn't one."
521 ;; Use your preferred constructin method here. 521 ;; Use your preferred construction method here.
522 (ede-cpp-root-project "NAME" :file (expand-file-name "FILE" dir) 522 (ede-cpp-root-project "NAME" :file (expand-file-name "FILE" dir)
523 :locate-fcn 'MYFCN) 523 :locate-fcn 'MYFCN)
524 ) 524 )
@@ -3273,7 +3273,7 @@ Return the default macro to 'edit' for this object type.
3273@end deffn 3273@end deffn
3274 3274
3275@deffn Method project-compile-target-command :AFTER this 3275@deffn Method project-compile-target-command :AFTER this
3276Default target t- use when compling a texinfo file. 3276Default target t- use when compiling a texinfo file.
3277@end deffn 3277@end deffn
3278 3278
3279@deffn Method ede-documentation :AFTER this 3279@deffn Method ede-documentation :AFTER this
@@ -3370,7 +3370,7 @@ Type: @code{(or null string)} @*
3370Default Value: @code{nil} 3370Default Value: @code{nil}
3371 3371
3372Emacs regex matching auxiliary source code this target accepts. 3372Emacs regex matching auxiliary source code this target accepts.
3373Aux source are source code files needed for compilation, which are not comiled 3373Aux source are source code files needed for compilation, which are not compiled
3374themselves. 3374themselves.
3375@refill 3375@refill
3376 3376
diff --git a/doc/misc/ediff.texi b/doc/misc/ediff.texi
index 20c2ed90873..62cd684b57b 100644
--- a/doc/misc/ediff.texi
+++ b/doc/misc/ediff.texi
@@ -1207,7 +1207,7 @@ This hook can be used to alter bindings in Ediff's keymap,
1207@code{ediff-mode-map}. These hooks are 1207@code{ediff-mode-map}. These hooks are
1208run right after the default bindings are set but before 1208run right after the default bindings are set but before
1209@code{ediff-load-hook}. The regular user needs not be concerned with this 1209@code{ediff-load-hook}. The regular user needs not be concerned with this
1210hook---it is provided for implementors of other Emacs packages built on top 1210hook---it is provided for implementers of other Emacs packages built on top
1211of Ediff. 1211of Ediff.
1212 1212
1213@item ediff-before-setup-windows-hook 1213@item ediff-before-setup-windows-hook
diff --git a/doc/misc/emacs-mime.texi b/doc/misc/emacs-mime.texi
index a9d80d868b6..c44cc1c9b09 100644
--- a/doc/misc/emacs-mime.texi
+++ b/doc/misc/emacs-mime.texi
@@ -1048,7 +1048,7 @@ occurs.
1048 1048
1049You can customize the value of the @code{mml-enable-flowed} variable 1049You can customize the value of the @code{mml-enable-flowed} variable
1050to enable or disable the flowed encoding usage when newline 1050to enable or disable the flowed encoding usage when newline
1051characteres are present in the buffer. 1051characters are present in the buffer.
1052 1052
1053On decoding flowed text, lines with soft newline characters are filled 1053On decoding flowed text, lines with soft newline characters are filled
1054together and wrapped after the column decided by 1054together and wrapped after the column decided by
diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi
index d1cecf1347a..00755262075 100644
--- a/doc/misc/ert.texi
+++ b/doc/misc/ert.texi
@@ -389,7 +389,7 @@ This checks that dividing one by zero signals an error of type
389@code{arith-error}. The @code{:type} argument to @code{should-error} 389@code{arith-error}. The @code{:type} argument to @code{should-error}
390is optional; if absent, any type of error is accepted. 390is optional; if absent, any type of error is accepted.
391@code{should-error} returns an error description of the error that was 391@code{should-error} returns an error description of the error that was
392signalled, to allow additional checks to be made. The error 392signaled, to allow additional checks to be made. The error
393description has the format @code{(ERROR-SYMBOL . DATA)}. 393description has the format @code{(ERROR-SYMBOL . DATA)}.
394 394
395There is no @code{should-not-error} macro since tests that signal an 395There is no @code{should-not-error} macro since tests that signal an
@@ -748,7 +748,7 @@ explanation function.
748 748
749Both @code{ert-run-tests-interactively} and @code{ert-run-tests-batch} 749Both @code{ert-run-tests-interactively} and @code{ert-run-tests-batch}
750are implemented on top of the lower-level test handling code in the 750are implemented on top of the lower-level test handling code in the
751sections of @file{ert.el} labelled ``Facilities for running a single test'', 751sections of @file{ert.el} labeled ``Facilities for running a single test'',
752``Test selectors'', and ``Facilities for running a whole set of tests''. 752``Test selectors'', and ``Facilities for running a whole set of tests''.
753 753
754If you want to write code that works with ERT tests, you should take a 754If you want to write code that works with ERT tests, you should take a
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi
index 74082bfd3b1..d2705155887 100644
--- a/doc/misc/eshell.texi
+++ b/doc/misc/eshell.texi
@@ -379,7 +379,7 @@ eshell/sudo is a compiled Lisp function in `em-unix.el'
379sudo is an alias, defined as "*sudo $*" 379sudo is an alias, defined as "*sudo $*"
380@end example 380@end example
381 381
382Some of the built-in commands have a special behaviour in Eshell: 382Some of the built-in commands have a special behavior in Eshell:
383 383
384@table @code 384@table @code
385 385
diff --git a/doc/misc/faq.texi b/doc/misc/faq.texi
index 7528abca58d..262c3d734fe 100644
--- a/doc/misc/faq.texi
+++ b/doc/misc/faq.texi
@@ -80,7 +80,7 @@ Emacs, the Emacs manual is often the best starting point.
80 80
81@ifnottex 81@ifnottex
82@insertcopying 82@insertcopying
83@end ifnottex 83@end ifnottex
84 84
85@menu 85@menu
86* FAQ notation:: 86* FAQ notation::
@@ -368,7 +368,7 @@ only be known if and when a judge rules on its validity and scope.
368There has never been a copyright infringement case involving the GPL to 368There has never been a copyright infringement case involving the GPL to
369set any precedents. Although legal actions have been brought against 369set any precedents. Although legal actions have been brought against
370companies for violating the terms of the GPL, so far all have been 370companies for violating the terms of the GPL, so far all have been
371settled out of court (in favour of the plaintiffs). Please take any 371settled out of court (in favor of the plaintiffs). Please take any
372discussion regarding this issue to the newsgroup 372discussion regarding this issue to the newsgroup
373@uref{news:gnu.misc.discuss}, which was created to hold the extensive 373@uref{news:gnu.misc.discuss}, which was created to hold the extensive
374flame wars on the subject. 374flame wars on the subject.
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi
index e8e89ed2a30..b5bb75f7284 100644
--- a/doc/misc/gnus-faq.texi
+++ b/doc/misc/gnus-faq.texi
@@ -12,7 +12,7 @@
12@section Frequently Asked Questions 12@section Frequently Asked Questions
13 13
14@menu 14@menu
15* FAQ - Changes:: 15* FAQ - Changes::
16* FAQ - Introduction:: About Gnus and this FAQ. 16* FAQ - Introduction:: About Gnus and this FAQ.
17* FAQ 1 - Installation FAQ:: Installation of Gnus. 17* FAQ 1 - Installation FAQ:: Installation of Gnus.
18* FAQ 2 - Startup / Group buffer:: Start up questions and the 18* FAQ 2 - Startup / Group buffer:: Start up questions and the
@@ -37,7 +37,7 @@
37 37
38This is the new Gnus Frequently Asked Questions list. 38This is the new Gnus Frequently Asked Questions list.
39 39
40Please submit features and suggestions to the 40Please submit features and suggestions to the
41@email{ding@@gnus.org, ding list}. 41@email{ding@@gnus.org, ding list}.
42 42
43@node FAQ - Changes 43@node FAQ - Changes
@@ -166,7 +166,7 @@ package system might not be up to date (e.g. Gnus 5.9 bundled with Emacs
16621 is outdated). 16621 is outdated).
167You can get the latest released version of Gnus from 167You can get the latest released version of Gnus from
168@uref{http://www.gnus.org/dist/gnus.tar.gz} 168@uref{http://www.gnus.org/dist/gnus.tar.gz}
169or via anonymous FTP from 169or via anonymous FTP from
170@uref{ftp://ftp.gnus.org/pub/gnus/gnus.tar.gz}. 170@uref{ftp://ftp.gnus.org/pub/gnus/gnus.tar.gz}.
171 171
172@node FAQ 1-4 172@node FAQ 1-4
@@ -176,7 +176,7 @@ What to do with the tarball now?
176 176
177@subsubheading Answer 177@subsubheading Answer
178 178
179Untar it via @samp{tar xvzf gnus.tar.gz} and do the common 179Untar it via @samp{tar xvzf gnus.tar.gz} and do the common
180@samp{./configure; make; make install} circle. 180@samp{./configure; make; make install} circle.
181(under MS-Windows either get the Cygwin environment from 181(under MS-Windows either get the Cygwin environment from
182@uref{http://www.cygwin.com} 182@uref{http://www.cygwin.com}
@@ -344,7 +344,7 @@ hit @samp{C-y}.
344@subsection Getting Messages 344@subsection Getting Messages
345 345
346@menu 346@menu
347* FAQ 3-1:: I just installed Gnus, started it via @samp{M-x gnus} 347* FAQ 3-1:: I just installed Gnus, started it via @samp{M-x gnus}
348 but it only says "nntp (news) open error", what to do? 348 but it only says "nntp (news) open error", what to do?
349* FAQ 3-2:: I'm working under Windows and have no idea what 349* FAQ 3-2:: I'm working under Windows and have no idea what
350 ~/.gnus.el means. 350 ~/.gnus.el means.
@@ -369,8 +369,8 @@ hit @samp{C-y}.
369@node FAQ 3-1 369@node FAQ 3-1
370@subsubheading Question 3.1 370@subsubheading Question 3.1
371 371
372I just installed Gnus, started it via 372I just installed Gnus, started it via
373@samp{M-x gnus} 373@samp{M-x gnus}
374but it only says "nntp (news) open error", what to do? 374but it only says "nntp (news) open error", what to do?
375 375
376@subsubheading Answer 376@subsubheading Answer
@@ -396,14 +396,14 @@ I'm working under Windows and have no idea what ~/.gnus.el means.
396The ~/ means the home directory where Gnus and Emacs look 396The ~/ means the home directory where Gnus and Emacs look
397for the configuration files. However, you don't really 397for the configuration files. However, you don't really
398need to know what this means, it suffices that Emacs knows 398need to know what this means, it suffices that Emacs knows
399what it means :-) You can type 399what it means :-) You can type
400@samp{C-x C-f ~/.gnus.el RET } 400@samp{C-x C-f ~/.gnus.el RET }
401(yes, with the forward slash, even on Windows), and 401(yes, with the forward slash, even on Windows), and
402Emacs will open the right file for you. (It will most 402Emacs will open the right file for you. (It will most
403likely be new, and thus empty.) 403likely be new, and thus empty.)
404However, I'd discourage you from doing so, since the 404However, I'd discourage you from doing so, since the
405directory Emacs chooses will most certainly not be what 405directory Emacs chooses will most certainly not be what
406you want, so let's do it the correct way. 406you want, so let's do it the correct way.
407The first thing you've got to do is to 407The first thing you've got to do is to
408create a suitable directory (no blanks in directory name 408create a suitable directory (no blanks in directory name
409please) e.g. c:\myhome. Then you must set the environment 409please) e.g. c:\myhome. Then you must set the environment
@@ -442,7 +442,7 @@ machine news.yourprovider.net login YourUserName password YourPassword
442. 442.
443Make sure that the file isn't readable to others if you 443Make sure that the file isn't readable to others if you
444work on a OS which is capable of doing so. (Under Unix 444work on a OS which is capable of doing so. (Under Unix
445say 445say
446@example 446@example
447chmod 600 ~/.authinfo 447chmod 600 ~/.authinfo
448@end example 448@end example
@@ -477,13 +477,13 @@ post on this server as well as I am, what's that?
477 477
478Some providers allow restricted anonymous access and full 478Some providers allow restricted anonymous access and full
479access only after authorization. To make Gnus send authinfo 479access only after authorization. To make Gnus send authinfo
480to those servers append 480to those servers append
481 481
482@example 482@example
483force yes 483force yes
484@end example 484@end example
485@noindent 485@noindent
486 486
487to the line for those servers in ~/.authinfo. 487to the line for those servers in ~/.authinfo.
488 488
489@node FAQ 3-6 489@node FAQ 3-6
@@ -774,7 +774,7 @@ When I enter a group, all read messages are gone. How to view them again?
774 774
775@subsubheading Answer 775@subsubheading Answer
776 776
777If you enter the group by saying 777If you enter the group by saying
778@samp{RET} 778@samp{RET}
779in group buffer with point over the group, only unread and ticked messages are loaded. Say 779in group buffer with point over the group, only unread and ticked messages are loaded. Say
780@samp{C-u RET} 780@samp{C-u RET}
@@ -787,13 +787,13 @@ Loading only unread messages can be annoying if you have threaded view enabled,
787(setq gnus-fetch-old-headers 'some) 787(setq gnus-fetch-old-headers 'some)
788@end example 788@end example
789@noindent 789@noindent
790 790
791in ~/.gnus.el to load enough old articles to prevent teared threads, replace 'some with t to load 791in ~/.gnus.el to load enough old articles to prevent teared threads, replace 'some with t to load
792all articles (Warning: Both settings enlarge the amount of data which is 792all articles (Warning: Both settings enlarge the amount of data which is
793fetched when you enter a group and slow down the process of entering a group). 793fetched when you enter a group and slow down the process of entering a group).
794 794
795If you already use Gnus 5.10, you can say 795If you already use Gnus 5.10, you can say
796@samp{/o N} 796@samp{/o N}
797In summary buffer to load the last N messages, this feature is not available in 5.8.8 797In summary buffer to load the last N messages, this feature is not available in 5.8.8
798 798
799If you don't want all old messages, but the parent of the message you're just reading, 799If you don't want all old messages, but the parent of the message you're just reading,
@@ -822,9 +822,9 @@ How to view the headers of a message?
822 822
823@subsubheading Answer 823@subsubheading Answer
824 824
825Say @samp{t} 825Say @samp{t}
826to show all headers, one more 826to show all headers, one more
827@samp{t} 827@samp{t}
828hides them again. 828hides them again.
829 829
830@node FAQ 4-4 830@node FAQ 4-4
@@ -834,10 +834,10 @@ How to view the raw unformatted message?
834 834
835@subsubheading Answer 835@subsubheading Answer
836 836
837Say 837Say
838@samp{C-u g} 838@samp{C-u g}
839to show the raw message 839to show the raw message
840@samp{g} 840@samp{g}
841returns to normal view. 841returns to normal view.
842 842
843@node FAQ 4-5 843@node FAQ 4-5
@@ -873,7 +873,7 @@ Say
873 873
874@example 874@example
875(eval-after-load "mm-decode" 875(eval-after-load "mm-decode"
876 '(progn 876 '(progn
877 (add-to-list 'mm-discouraged-alternatives "text/html") 877 (add-to-list 'mm-discouraged-alternatives "text/html")
878 (add-to-list 'mm-discouraged-alternatives "text/richtext"))) 878 (add-to-list 'mm-discouraged-alternatives "text/richtext")))
879@end example 879@end example
@@ -1042,7 +1042,7 @@ back ends. Gnus thinks "highest-article-number -
1042lowest-article-number = total-number-of-articles". This 1042lowest-article-number = total-number-of-articles". This
1043works OK for Usenet groups, but if you delete and move 1043works OK for Usenet groups, but if you delete and move
1044many messages in mail groups, this fails. To cure the 1044many messages in mail groups, this fails. To cure the
1045symptom, enter the group via @samp{C-u RET} 1045symptom, enter the group via @samp{C-u RET}
1046(this makes Gnus get all messages), then 1046(this makes Gnus get all messages), then
1047hit @samp{M P b} to mark all messages and 1047hit @samp{M P b} to mark all messages and
1048then say @samp{B m name.of.group} to move 1048then say @samp{B m name.of.group} to move
@@ -1162,7 +1162,7 @@ general rule (regular expression .*) which denotes where
1162articles should go which don't match any other rule. If 1162articles should go which don't match any other rule. If
1163the folder doesn't exist yet, it will be created as soon 1163the folder doesn't exist yet, it will be created as soon
1164as an article lands there. By default the mail will be 1164as an article lands there. By default the mail will be
1165send to all groups whose rules match. If you 1165send to all groups whose rules match. If you
1166don't want that (you probably don't want), say 1166don't want that (you probably don't want), say
1167 1167
1168@example 1168@example
@@ -1203,7 +1203,7 @@ from using them):
1203 ("Spam" "^CC: .*azzrael@@t-online.invalid") 1203 ("Spam" "^CC: .*azzrael@@t-online.invalid")
1204 ("Spam" "^X-Mailer-Version: 1.50 BETA") 1204 ("Spam" "^X-Mailer-Version: 1.50 BETA")
1205 ("Uni" "^\\(CC:\\|To:\\).*localpart@@uni-koblenz.invalid.*") 1205 ("Uni" "^\\(CC:\\|To:\\).*localpart@@uni-koblenz.invalid.*")
1206 ("Inbox" "^\\(CC:\\|To:\\).*\\(my\ name\\|address@@one.invalid\\|adress@@two.invalid\\)") 1206 ("Inbox" "^\\(CC:\\|To:\\).*\\(my\ name\\|address@@one.invalid\\|address@@two.invalid\\)")
1207 ("Spam" ""))) 1207 ("Spam" "")))
1208@end example 1208@end example
1209@noindent 1209@noindent
@@ -1393,13 +1393,13 @@ You can use ispell.el to spell-check stuff in Emacs. So the
1393first thing to do is to make sure that you've got either 1393first thing to do is to make sure that you've got either
1394@uref{http://fmg-www.cs.ucla.edu/fmg-members/geoff/ispell.html, ispell} 1394@uref{http://fmg-www.cs.ucla.edu/fmg-members/geoff/ispell.html, ispell}
1395or @uref{http://aspell.sourceforge.net/, aspell} 1395or @uref{http://aspell.sourceforge.net/, aspell}
1396installed and in your Path. Then you need 1396installed and in your Path. Then you need
1397@uref{http://www.kdstevens.com/~stevens/ispell-page.html, ispell.el} 1397@uref{http://www.kdstevens.com/~stevens/ispell-page.html, ispell.el}
1398and for on-the-fly spell-checking 1398and for on-the-fly spell-checking
1399@uref{http://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}. 1399@uref{http://www-sop.inria.fr/members/Manuel.Serrano/flyspell/flyspell.html, flyspell.el}.
1400Ispell.el is shipped with Emacs and available through the XEmacs package system, 1400Ispell.el is shipped with Emacs and available through the XEmacs package system,
1401flyspell.el is shipped with Emacs and part of XEmacs text-modes package which is 1401flyspell.el is shipped with Emacs and part of XEmacs text-modes package which is
1402available through the package system, so there should be no need to install them 1402available through the package system, so there should be no need to install them
1403manually. 1403manually.
1404 1404
1405Ispell.el assumes you use ispell, if you choose aspell say 1405Ispell.el assumes you use ispell, if you choose aspell say
@@ -1408,7 +1408,7 @@ Ispell.el assumes you use ispell, if you choose aspell say
1408(setq ispell-program-name "aspell") 1408(setq ispell-program-name "aspell")
1409@end example 1409@end example
1410@noindent 1410@noindent
1411 1411
1412in your Emacs configuration file. 1412in your Emacs configuration file.
1413 1413
1414If you want your outgoing messages to be spell-checked, say 1414If you want your outgoing messages to be spell-checked, say
@@ -1445,7 +1445,7 @@ Yes, say something like
1445 (ispell-change-dictionary "english"))))) 1445 (ispell-change-dictionary "english")))))
1446@end example 1446@end example
1447@noindent 1447@noindent
1448 1448
1449in ~/.gnus.el. Change "^de\\." and "deutsch8" to something 1449in ~/.gnus.el. Change "^de\\." and "deutsch8" to something
1450that suits your needs. 1450that suits your needs.
1451 1451
@@ -1472,7 +1472,7 @@ cause Gnus to insert the full address for you. See the
1472node "Mail Aliases" in Message (not Gnus) manual for 1472node "Mail Aliases" in Message (not Gnus) manual for
1473details. 1473details.
1474 1474
1475However, what you really want is the Insidious Big Brother 1475However, what you really want is the Insidious Big Brother
1476Database bbdb. Get it through the XEmacs package system or from 1476Database bbdb. Get it through the XEmacs package system or from
1477@uref{http://bbdb.sourceforge.net/, bbdb's homepage}. 1477@uref{http://bbdb.sourceforge.net/, bbdb's homepage}.
1478Now place the following in ~/.gnus.el, to activate bbdb for Gnus: 1478Now place the following in ~/.gnus.el, to activate bbdb for Gnus:
@@ -1488,7 +1488,7 @@ place them in ~/.emacs:
1488 1488
1489@example 1489@example
1490(require 'bbdb) 1490(require 'bbdb)
1491;;If you don't live in Northern America, you should disable the 1491;;If you don't live in Northern America, you should disable the
1492;;syntax check for telephone numbers by saying 1492;;syntax check for telephone numbers by saying
1493(setq bbdb-north-american-phone-numbers-p nil) 1493(setq bbdb-north-american-phone-numbers-p nil)
1494;;Tell bbdb about your email address: 1494;;Tell bbdb about your email address:
@@ -1529,7 +1529,7 @@ X-Face. So fire up some image manipulation program (say
1529Gimp), open the image you want to include, cut out the 1529Gimp), open the image you want to include, cut out the
1530relevant part, reduce color depth to 1 bit, resize to 1530relevant part, reduce color depth to 1 bit, resize to
153148*48 and save as bitmap. Now you should get the compface 153148*48 and save as bitmap. Now you should get the compface
1532package from 1532package from
1533@uref{ftp://ftp.cs.indiana.edu:/pub/faces/, this site}. 1533@uref{ftp://ftp.cs.indiana.edu:/pub/faces/, this site}.
1534and create the actual X-face by saying 1534and create the actual X-face by saying
1535 1535
@@ -1539,7 +1539,7 @@ cat file.face | sed 's/\\/\\\\/g;s/\"/\\\"/g;' > file.face.quoted
1539@end example 1539@end example
1540@noindent 1540@noindent
1541 1541
1542If you can't use compface, there's an online X-face converter at 1542If you can't use compface, there's an online X-face converter at
1543@uref{http://www.dairiki.org/xface/}. 1543@uref{http://www.dairiki.org/xface/}.
1544If you use MS Windows, you could also use the WinFace program from 1544If you use MS Windows, you could also use the WinFace program from
1545@uref{http://www.xs4all.nl/~walterln/winface/}. 1545@uref{http://www.xs4all.nl/~walterln/winface/}.
@@ -1668,7 +1668,7 @@ by saying:
1668@noindent 1668@noindent
1669 1669
1670in ~/.gnus.el. If you use Gnus 5.9 or earlier, you can use this 1670in ~/.gnus.el. If you use Gnus 5.9 or earlier, you can use this
1671instead (works for newer versions as well): 1671instead (works for newer versions as well):
1672 1672
1673@example 1673@example
1674(eval-after-load "message" 1674(eval-after-load "message"
@@ -1961,12 +1961,12 @@ receives the mail you write from Gnus and sends them
1961when you're online. 1961when you're online.
1962 1962
1963Let's talk about Unix systems first: For the news part, 1963Let's talk about Unix systems first: For the news part,
1964the easiest solution is a small nntp server like 1964the easiest solution is a small nntp server like
1965@uref{http://www.leafnode.org/, Leafnode} or 1965@uref{http://www.leafnode.org/, Leafnode} or
1966@uref{http://infa.abo.fi/~patrik/sn/, sn}, 1966@uref{http://infa.abo.fi/~patrik/sn/, sn},
1967of course you can also install a full featured news 1967of course you can also install a full featured news
1968server like 1968server like
1969@uref{http://www.isc.org/products/INN/, inn}. 1969@uref{http://www.isc.org/products/INN/, inn}.
1970Then you want to fetch your Mail, popular choices 1970Then you want to fetch your Mail, popular choices
1971are @uref{http://www.catb.org/~esr/fetchmail/, fetchmail} 1971are @uref{http://www.catb.org/~esr/fetchmail/, fetchmail}
1972and @uref{http://pyropus.ca/software/getmail/, getmail}. 1972and @uref{http://pyropus.ca/software/getmail/, getmail}.
@@ -1978,8 +1978,8 @@ sending part: This can be done with every MTA like
1978@uref{http://www.exim.org/, exim} or 1978@uref{http://www.exim.org/, exim} or
1979@uref{http://www.qmail.org/, qmail}. 1979@uref{http://www.qmail.org/, qmail}.
1980 1980
1981On windows boxes I'd vote for 1981On windows boxes I'd vote for
1982@uref{http://www.tglsoft.de/, Hamster}, 1982@uref{http://www.tglsoft.de/, Hamster},
1983it's a small freeware, open-source program which fetches 1983it's a small freeware, open-source program which fetches
1984your mail and news from remote servers and offers them 1984your mail and news from remote servers and offers them
1985to Gnus (or any other mail and/or news reader) via nntp 1985to Gnus (or any other mail and/or news reader) via nntp
@@ -2136,7 +2136,7 @@ Which mailing lists and newsgroups are there?
2136@subsubheading Answer 2136@subsubheading Answer
2137 2137
2138There's the newsgroup gnu.emacs.gnus (also available as 2138There's the newsgroup gnu.emacs.gnus (also available as
2139@uref{http://dir.gmane.org/gmane.emacs.gnus.user, 2139@uref{http://dir.gmane.org/gmane.emacs.gnus.user,
2140gmane.emacs.gnus.user}) which deals with general Gnus 2140gmane.emacs.gnus.user}) which deals with general Gnus
2141questions. If you have questions about development versions of 2141questions. If you have questions about development versions of
2142Gnus, you should better ask on the ding mailing list, see below. 2142Gnus, you should better ask on the ding mailing list, see below.
@@ -2149,7 +2149,7 @@ de.comm.software.gnus.
2149 2149
2150The ding mailing list (ding@@gnus.org) deals with development of 2150The ding mailing list (ding@@gnus.org) deals with development of
2151Gnus. You can read the ding list via NNTP, too under the name 2151Gnus. You can read the ding list via NNTP, too under the name
2152@uref{http://dir.gmane.org/gmane.emacs.gnus.general, 2152@uref{http://dir.gmane.org/gmane.emacs.gnus.general,
2153gmane.emacs.gnus.general} from news.gmane.org. 2153gmane.emacs.gnus.general} from news.gmane.org.
2154 2154
2155@node FAQ 8-5 2155@node FAQ 8-5
@@ -2160,7 +2160,7 @@ Where to report bugs?
2160@subsubheading Answer 2160@subsubheading Answer
2161 2161
2162Say @samp{M-x gnus-bug}, this will start 2162Say @samp{M-x gnus-bug}, this will start
2163a message to the 2163a message to the
2164@email{bugs@@gnus.org, gnus bug mailing list} 2164@email{bugs@@gnus.org, gnus bug mailing list}
2165including information about your environment which make 2165including information about your environment which make
2166it easier to help you. 2166it easier to help you.
@@ -2237,7 +2237,7 @@ building of summary say
2237 2237
2238at the bottom of your ~/.gnus.el, this will make gnus 2238at the bottom of your ~/.gnus.el, this will make gnus
2239byte-compile things like 2239byte-compile things like
2240gnus-summary-line-format. 2240gnus-summary-line-format.
2241then you could increase the value of gc-cons-threshold 2241then you could increase the value of gc-cons-threshold
2242by saying something like 2242by saying something like
2243 2243
@@ -2254,7 +2254,7 @@ recent GNU Emacs, you should say
2254(setq gnus-use-correct-string-widths nil) 2254(setq gnus-use-correct-string-widths nil)
2255@end example 2255@end example
2256@noindent 2256@noindent
2257 2257
2258in ~/.gnus.el (thanks to Jesper harder for the last 2258in ~/.gnus.el (thanks to Jesper harder for the last
2259two suggestions). Finally if you are still using 5.8.8 2259two suggestions). Finally if you are still using 5.8.8
2260or 5.9 and experience speed problems with summary 2260or 5.9 and experience speed problems with summary
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi
index 545306e4dc7..a3a93c6ef61 100644
--- a/doc/misc/gnus.texi
+++ b/doc/misc/gnus.texi
@@ -7665,7 +7665,7 @@ has its own article buffer.
7665This implies that it's not possible to have more than one article buffer 7665This implies that it's not possible to have more than one article buffer
7666in a group at a time. But sometimes you might want to display all the 7666in a group at a time. But sometimes you might want to display all the
7667latest emails from your mother, your father, your aunt, your uncle and 7667latest emails from your mother, your father, your aunt, your uncle and
7668your 17 cousins to coordinate the next christmas party. 7668your 17 cousins to coordinate the next Christmas party.
7669 7669
7670That's where sticky articles come in handy. A sticky article buffer 7670That's where sticky articles come in handy. A sticky article buffer
7671basically is a normal article buffer, but it won't be reused when you 7671basically is a normal article buffer, but it won't be reused when you
@@ -18001,7 +18001,7 @@ see the event's date.
18001 @code{gnus-diary} provides two supplemental user formats to be used in 18001 @code{gnus-diary} provides two supplemental user formats to be used in
18002summary line formats. @code{D} corresponds to a formatted time string 18002summary line formats. @code{D} corresponds to a formatted time string
18003for the next occurrence of the event (e.g. ``Sat, Sep 22 01, 12:00''), 18003for the next occurrence of the event (e.g. ``Sat, Sep 22 01, 12:00''),
18004while @code{d} corresponds to an approximative remaining time until the 18004while @code{d} corresponds to an approximate remaining time until the
18005next occurrence of the event (e.g. ``in 6 months, 1 week''). 18005next occurrence of the event (e.g. ``in 6 months, 1 week'').
18006 18006
18007 For example, here's how Joe's birthday is displayed in my 18007 For example, here's how Joe's birthday is displayed in my
@@ -18105,7 +18105,7 @@ mail sending with @code{nndiary}:
18105@itemize @bullet 18105@itemize @bullet
18106@item 18106@item
18107@code{nndiary} is a @emph{real} mail back end. You really send real diary 18107@code{nndiary} is a @emph{real} mail back end. You really send real diary
18108messsages for real. This means for instance that you can give 18108messages for real. This means for instance that you can give
18109appointments to anybody (provided they use Gnus and @code{nndiary}) by 18109appointments to anybody (provided they use Gnus and @code{nndiary}) by
18110sending the diary message to them as well. 18110sending the diary message to them as well.
18111@item 18111@item
@@ -26756,7 +26756,7 @@ Sudish Joseph---innumerable bug fixes.
26756Ilja Weis---@file{gnus-topic.el}. 26756Ilja Weis---@file{gnus-topic.el}.
26757 26757
26758@item 26758@item
26759Steven L. Baur---lots and lots and lots of bugs detections and fixes. 26759Steven L. Baur---lots and lots and lots of bug detection and fixes.
26760 26760
26761@item 26761@item
26762Vladimir Alexiev---the refcard and reference booklets. 26762Vladimir Alexiev---the refcard and reference booklets.
diff --git a/doc/misc/newsticker.texi b/doc/misc/newsticker.texi
index c7d82245973..18e11aeeeb3 100644
--- a/doc/misc/newsticker.texi
+++ b/doc/misc/newsticker.texi
@@ -52,7 +52,7 @@ developing GNU and promoting software freedom.''
52@node Top 52@node Top
53@top Newsticker 53@top Newsticker
54 54
55@insertcopying 55@insertcopying
56 56
57@end ifnottex 57@end ifnottex
58 58
@@ -112,9 +112,9 @@ enclosed files (as delivered by podcasts, e.g.).
112Here are screen shots of the @uref{newsticker-1.7.png, version 1.7 112Here are screen shots of the @uref{newsticker-1.7.png, version 1.7
113(current version)} and some older screen shots: 113(current version)} and some older screen shots:
114@uref{newsticker-1.6.png, version 1.6}, 114@uref{newsticker-1.6.png, version 1.6},
115@uref{newsticker-1.5.png, version 1.5}, 115@uref{newsticker-1.5.png, version 1.5},
116@uref{newsticker-1.4.png, version 1.4} 116@uref{newsticker-1.4.png, version 1.4}
117@uref{newsticker-1.3.png, version 1.3}, 117@uref{newsticker-1.3.png, version 1.3},
118@uref{newsticker-1.0.png, version 1.0}. 118@uref{newsticker-1.0.png, version 1.0}.
119@end ifhtml 119@end ifhtml
120 120
@@ -163,7 +163,7 @@ You can choose between two different frontends for reading headlines:
163@item Newsticker's @emph{treeview} uses separate windows for the 163@item Newsticker's @emph{treeview} uses separate windows for the
164feeds (in tree form), a list of headlines for the current feed, and 164feeds (in tree form), a list of headlines for the current feed, and
165the content of the current headline. Feeds can be placed into groups 165the content of the current headline. Feeds can be placed into groups
166which itself can be placed in groups and so on. 166which itself can be placed in groups and so on.
167@item Newsticker's @emph{plainview} displays all headlines in a 167@item Newsticker's @emph{plainview} displays all headlines in a
168single buffer, called @samp{*newsticker*}. The modeline in the 168single buffer, called @samp{*newsticker*}. The modeline in the
169@samp{*newsticker*} buffer informs whenever new headlines have 169@samp{*newsticker*} buffer informs whenever new headlines have
@@ -171,7 +171,7 @@ arrived.
171@end itemize 171@end itemize
172In both views clicking mouse-button 2 or pressing RET on a headline 172In both views clicking mouse-button 2 or pressing RET on a headline
173will call @code{browse-url} to load the corresponding news story in 173will call @code{browse-url} to load the corresponding news story in
174your favourite web browser. 174your favorite web browser.
175 175
176@findex newsticker-start-ticker 176@findex newsticker-start-ticker
177@findex newsticker-stop-ticker 177@findex newsticker-stop-ticker
@@ -205,7 +205,7 @@ and some of the most important options.
205 205
206@item 206@item
207@code{newsticker-retrieval} contains options that define which news 207@code{newsticker-retrieval} contains options that define which news
208feeds are retrieved and how this is done. 208feeds are retrieved and how this is done.
209 209
210@itemize 210@itemize
211@item 211@item
@@ -241,7 +241,7 @@ automatically mark headlines as immortal or old.
241 241
242@item 242@item
243@code{newsticker-hooks} contains options for hooking other Emacs 243@code{newsticker-hooks} contains options for hooking other Emacs
244commands to newsticker functions. 244commands to newsticker functions.
245@itemize 245@itemize
246@item 246@item
247@vindex newsticker-new-item-functions 247@vindex newsticker-new-item-functions
@@ -313,5 +313,3 @@ Byte-compiling newsticker.el is recommended.
313@printindex cp 313@printindex cp
314 314
315@bye 315@bye
316
317
diff --git a/doc/misc/org.texi b/doc/misc/org.texi
index 2a3d99ca7f4..cc925906c28 100644
--- a/doc/misc/org.texi
+++ b/doc/misc/org.texi
@@ -36,7 +36,7 @@
36 36
37@c orgkey{key} A key item 37@c orgkey{key} A key item
38@c orgcmd{key,cmd} Key with command name 38@c orgcmd{key,cmd} Key with command name
39@c xorgcmd{key,cmmand} Key with command name as @itemx 39@c xorgcmd{key,command} Key with command name as @itemx
40@c orgcmdnki{key,cmd} Like orgcmd, but do not index the key 40@c orgcmdnki{key,cmd} Like orgcmd, but do not index the key
41@c orgcmdtkc{text,key,cmd} Like orgcmd,special text instead of key 41@c orgcmdtkc{text,key,cmd} Like orgcmd,special text instead of key
42@c orgcmdkkc{key1,key2,cmd} Two keys with one command name, use "or" 42@c orgcmdkkc{key1,key2,cmd} Two keys with one command name, use "or"
@@ -3883,7 +3883,7 @@ special faces for some of them. This can be done using the variable
3883@end lisp 3883@end lisp
3884 3884
3885While using a list with face properties as shown for CANCELED @emph{should} 3885While using a list with face properties as shown for CANCELED @emph{should}
3886work, this does not aways seem to be the case. If necessary, define a 3886work, this does not always seem to be the case. If necessary, define a
3887special face and use that. A string is interpreted as a color. The variable 3887special face and use that. A string is interpreted as a color. The variable
3888@code{org-faces-easy-properties} determines if that color is interpreted as a 3888@code{org-faces-easy-properties} determines if that color is interpreted as a
3889foreground or a background color. 3889foreground or a background color.
@@ -5664,7 +5664,7 @@ an item:
5664@orgcmd{C-c C-d,org-deadline} 5664@orgcmd{C-c C-d,org-deadline}
5665Insert @samp{DEADLINE} keyword along with a stamp. The insertion will happen 5665Insert @samp{DEADLINE} keyword along with a stamp. The insertion will happen
5666in the line directly following the headline. Any CLOSED timestamp will be 5666in the line directly following the headline. Any CLOSED timestamp will be
5667removed. When called with a prefix arg, an existing deadline will be removed 5667removed. When called with a prefix arg, an existing deadline will be removed
5668from the entry. Depending on the variable @code{org-log-redeadline}@footnote{with corresponding 5668from the entry. Depending on the variable @code{org-log-redeadline}@footnote{with corresponding
5669@code{#+STARTUP} keywords @code{logredeadline}, @code{lognoteredeadline}, 5669@code{#+STARTUP} keywords @code{logredeadline}, @code{lognoteredeadline},
5670and @code{nologredeadline}}, a note will be taken when changing an existing 5670and @code{nologredeadline}}, a note will be taken when changing an existing
@@ -6216,7 +6216,7 @@ not started at exactly the right moment.
6216@kindex ; 6216@kindex ;
6217 6217
6218Calling @code{org-timer-set-timer} from an Org-mode buffer runs a countdown 6218Calling @code{org-timer-set-timer} from an Org-mode buffer runs a countdown
6219timer. Use @kbd{;} from agenda buffers, @key{C-c C-x ;} everwhere else. 6219timer. Use @kbd{;} from agenda buffers, @key{C-c C-x ;} everywhere else.
6220 6220
6221@code{org-timer-set-timer} prompts the user for a duration and displays a 6221@code{org-timer-set-timer} prompts the user for a duration and displays a
6222countdown timer in the modeline. @code{org-timer-default-timer} sets the 6222countdown timer in the modeline. @code{org-timer-default-timer} sets the
@@ -6393,7 +6393,7 @@ like this:
6393@node Template elements, Template expansion, Capture templates, Capture templates 6393@node Template elements, Template expansion, Capture templates, Capture templates
6394@subsubsection Template elements 6394@subsubsection Template elements
6395 6395
6396Now lets look at the elements of a template definition. Each entry in 6396Now let's look at the elements of a template definition. Each entry in
6397@code{org-capture-templates} is a list with the following items: 6397@code{org-capture-templates} is a list with the following items:
6398 6398
6399@table @var 6399@table @var
@@ -8262,7 +8262,7 @@ This is a globally available command, and also available in the agenda menu.
8262@vindex org-agenda-exporter-settings 8262@vindex org-agenda-exporter-settings
8263Write the agenda view to a file. Depending on the extension of the selected 8263Write the agenda view to a file. Depending on the extension of the selected
8264file name, the view will be exported as HTML (extension @file{.html} or 8264file name, the view will be exported as HTML (extension @file{.html} or
8265@file{.htm}), Postscript (extension @file{.ps}), PDF (extension @file{.pdf}), 8265@file{.htm}), PostScript (extension @file{.ps}), PDF (extension @file{.pdf}),
8266and plain text (any other extension). When called with a @kbd{C-u} prefix 8266and plain text (any other extension). When called with a @kbd{C-u} prefix
8267argument, immediately open the newly created file. Use the variable 8267argument, immediately open the newly created file. Use the variable
8268@code{org-agenda-exporter-settings} to set options for @file{ps-print} and 8268@code{org-agenda-exporter-settings} to set options for @file{ps-print} and
@@ -8477,9 +8477,9 @@ yourself.
8477If you are away from your computer, it can be very useful to have a printed 8477If you are away from your computer, it can be very useful to have a printed
8478version of some agenda views to carry around. Org-mode can export custom 8478version of some agenda views to carry around. Org-mode can export custom
8479agenda views as plain text, HTML@footnote{You need to install Hrvoje Niksic's 8479agenda views as plain text, HTML@footnote{You need to install Hrvoje Niksic's
8480@file{htmlize.el}.}, Postscript, PDF@footnote{To create PDF output, the 8480@file{htmlize.el}.}, PostScript, PDF@footnote{To create PDF output, the
8481ghostscript @file{ps2pdf} utility must be installed on the system. Selecting 8481ghostscript @file{ps2pdf} utility must be installed on the system. Selecting
8482a PDF file will also create the postscript file.}, and iCalendar files. If 8482a PDF file will also create the PostScript file.}, and iCalendar files. If
8483you want to do this only occasionally, use the command 8483you want to do this only occasionally, use the command
8484 8484
8485@table @kbd 8485@table @kbd
@@ -8489,7 +8489,7 @@ you want to do this only occasionally, use the command
8489@vindex org-agenda-exporter-settings 8489@vindex org-agenda-exporter-settings
8490Write the agenda view to a file. Depending on the extension of the selected 8490Write the agenda view to a file. Depending on the extension of the selected
8491file name, the view will be exported as HTML (extension @file{.html} or 8491file name, the view will be exported as HTML (extension @file{.html} or
8492@file{.htm}), Postscript (extension @file{.ps}), iCalendar (extension 8492@file{.htm}), PostScript (extension @file{.ps}), iCalendar (extension
8493@file{.ics}), or plain text (any other extension). Use the variable 8493@file{.ics}), or plain text (any other extension). Use the variable
8494@code{org-agenda-exporter-settings} to set options for @file{ps-print} and 8494@code{org-agenda-exporter-settings} to set options for @file{ps-print} and
8495for @file{htmlize} to be used during export, for example 8495for @file{htmlize} to be used during export, for example
@@ -8542,7 +8542,7 @@ The extension of the file name determines the type of export. If it is
8542@file{.html}, Org-mode will use the @file{htmlize.el} package to convert 8542@file{.html}, Org-mode will use the @file{htmlize.el} package to convert
8543the buffer to HTML and save it to this file name. If the extension is 8543the buffer to HTML and save it to this file name. If the extension is
8544@file{.ps}, @code{ps-print-buffer-with-faces} is used to produce 8544@file{.ps}, @code{ps-print-buffer-with-faces} is used to produce
8545Postscript output. If the extension is @file{.ics}, iCalendar export is 8545PostScript output. If the extension is @file{.ics}, iCalendar export is
8546run export over all files that were used to construct the agenda, and 8546run export over all files that were used to construct the agenda, and
8547limit the export to entries listed in the agenda. Any other 8547limit the export to entries listed in the agenda. Any other
8548extension produces a plain ASCII file. 8548extension produces a plain ASCII file.
@@ -8573,7 +8573,7 @@ set options for the export commands. For example:
8573@end lisp 8573@end lisp
8574 8574
8575@noindent 8575@noindent
8576This command sets two options for the Postscript exporter, to make it 8576This command sets two options for the PostScript exporter, to make it
8577print in two columns in landscape format---the resulting page can be cut 8577print in two columns in landscape format---the resulting page can be cut
8578in two and then used in a paper agenda. The remaining settings modify 8578in two and then used in a paper agenda. The remaining settings modify
8579the agenda prefix to omit category and scheduling information, and 8579the agenda prefix to omit category and scheduling information, and
@@ -9421,7 +9421,7 @@ the web, while the XOXO format provides a solid base for exchange with a
9421broad range of other applications. @LaTeX{} export lets you use Org-mode and 9421broad range of other applications. @LaTeX{} export lets you use Org-mode and
9422its structured editing functions to easily create @LaTeX{} files. DocBook 9422its structured editing functions to easily create @LaTeX{} files. DocBook
9423export makes it possible to convert Org files to many other formats using 9423export makes it possible to convert Org files to many other formats using
9424DocBook tools. OpenDocumentText export allows seamless colloboration across 9424DocBook tools. OpenDocumentText export allows seamless collaboration across
9425organizational boundaries. For project management you can create gantt and 9425organizational boundaries. For project management you can create gantt and
9426resource charts by using TaskJuggler export. To incorporate entries with 9426resource charts by using TaskJuggler export. To incorporate entries with
9427associated times like deadlines or appointments into a desktop calendar 9427associated times like deadlines or appointments into a desktop calendar
diff --git a/doc/misc/pgg.texi b/doc/misc/pgg.texi
index 9cb7a637a05..0de12577b2d 100644
--- a/doc/misc/pgg.texi
+++ b/doc/misc/pgg.texi
@@ -57,18 +57,18 @@ and various tools for secure communication. PGG also provides a simple
57user interface to encrypt, decrypt, sign, and verify MIME messages. 57user interface to encrypt, decrypt, sign, and verify MIME messages.
58 58
59@ifnottex 59@ifnottex
60@insertcopying 60@insertcopying
61@end ifnottex 61@end ifnottex
62 62
63@menu 63@menu
64* Overview:: What PGG is. 64* Overview:: What PGG is.
65* Prerequisites:: Complicated stuff you may have to do. 65* Prerequisites:: Complicated stuff you may have to do.
66* How to use:: Getting started quickly. 66* How to use:: Getting started quickly.
67* Architecture:: 67* Architecture::
68* Parsing OpenPGP packets:: 68* Parsing OpenPGP packets::
69* GNU Free Documentation License:: The license for this documentation. 69* GNU Free Documentation License:: The license for this documentation.
70* Function Index:: 70* Function Index::
71* Variable Index:: 71* Variable Index::
72@end menu 72@end menu
73 73
74@node Overview 74@node Overview
@@ -137,10 +137,10 @@ list autoload setting for desired functions as follows.
137@end lisp 137@end lisp
138 138
139@menu 139@menu
140* User Commands:: 140* User Commands::
141* Selecting an implementation:: 141* Selecting an implementation::
142* Caching passphrase:: 142* Caching passphrase::
143* Default user identity:: 143* Default user identity::
144@end menu 144@end menu
145 145
146@node User Commands 146@node User Commands
@@ -358,13 +358,13 @@ singleton object wrapped with the luna object system.
358 358
359Since PGG was designed for accessing and developing PGP functionality, 359Since PGG was designed for accessing and developing PGP functionality,
360the architecture had to be designed not just for interoperability but 360the architecture had to be designed not just for interoperability but
361also for extensiblity. In this chapter we explore the architecture 361also for extensibility. In this chapter we explore the architecture
362while finding out how to write the PGG back end. 362while finding out how to write the PGG back end.
363 363
364@menu 364@menu
365* Initializing:: 365* Initializing::
366* Back end methods:: 366* Back end methods::
367* Getting output:: 367* Getting output::
368@end menu 368@end menu
369 369
370@node Initializing 370@node Initializing
diff --git a/doc/misc/sc.texi b/doc/misc/sc.texi
index 8853192af04..37ccc4045be 100644
--- a/doc/misc/sc.texi
+++ b/doc/misc/sc.texi
@@ -56,7 +56,7 @@ developing GNU and promoting software freedom.''
56@top Supercite 56@top Supercite
57@comment node-name, next, previous, up 57@comment node-name, next, previous, up
58 58
59@insertcopying 59@insertcopying
60 60
61The manual is divided 61The manual is divided
62into the following chapters. 62into the following chapters.
@@ -1877,7 +1877,7 @@ been continuously added through the comments and suggestions of the
1877Supercite mailing list participants. 1877Supercite mailing list participants.
1878 1878
1879With version 3, Supercite underwent an almost complete rewrite, 1879With version 3, Supercite underwent an almost complete rewrite,
1880benefitting in a number of ways, including vast improvements in the 1880benefiting in a number of ways, including vast improvements in the
1881speed of performance, a big reduction in size of the code and in the use 1881speed of performance, a big reduction in size of the code and in the use
1882of Emacs resources, and a much cleaner and flexible internal 1882of Emacs resources, and a much cleaner and flexible internal
1883architecture. Most of this work was internal and not of very great 1883architecture. Most of this work was internal and not of very great
diff --git a/doc/misc/sem-user.texi b/doc/misc/sem-user.texi
index b17f1ab7e93..7a363523aa6 100644
--- a/doc/misc/sem-user.texi
+++ b/doc/misc/sem-user.texi
@@ -382,7 +382,7 @@ them yourself.
382@deffn Option semanticdb-project-roots 382@deffn Option semanticdb-project-roots
383The value of this variable is a list of directories (strings) that are 383The value of this variable is a list of directories (strings) that are
384project roots. All subdirectories of a project root are considered 384project roots. All subdirectories of a project root are considered
385part of the same project. This variable can be overriden by 385part of the same project. This variable can be overridden by
386@code{semanticdb-project-root-functions}. 386@code{semanticdb-project-root-functions}.
387@end deffn 387@end deffn
388 388
@@ -608,7 +608,7 @@ of parsing. The default is @code{t}.
608@node Debugging Idle Time Issues 608@node Debugging Idle Time Issues
609@subsection Debugging Idle Time Issues 609@subsection Debugging Idle Time Issues
610 610
611If you see an error signalled during idle time, it could be an 611If you see an error signaled during idle time, it could be an
612indication of a more serious issue elsewhere. It is not enough to 612indication of a more serious issue elsewhere. It is not enough to
613enable @code{debug-on-error}, because the idle scheduler inhibits the 613enable @code{debug-on-error}, because the idle scheduler inhibits the
614debugger. Instead, use the following commands to debug the error: 614debugger. Instead, use the following commands to debug the error:
diff --git a/doc/misc/semantic.texi b/doc/misc/semantic.texi
index f3f11d29f17..ad6159feb1a 100644
--- a/doc/misc/semantic.texi
+++ b/doc/misc/semantic.texi
@@ -306,7 +306,7 @@ Files associated with tags. Goto-tag, file for include, and file for
306a prototype. 306a prototype.
307 307
308@item semantic-tag-ls.el 308@item semantic-tag-ls.el
309Language dependant features of a tag, such as parent calculation, slot 309Language dependent features of a tag, such as parent calculation, slot
310protection, and other states like abstract, virtual, static, and leaf. 310protection, and other states like abstract, virtual, static, and leaf.
311 311
312@item semantic-dep.el 312@item semantic-dep.el
@@ -349,7 +349,7 @@ This file also provides support for @code{semanticdb-minor-mode},
349which automatically associates files with tables in databases so that 349which automatically associates files with tables in databases so that
350tags are @emph{saved} while a buffer is not in memory. 350tags are @emph{saved} while a buffer is not in memory.
351 351
352The database and tables both also provide applicate cache information, 352The database and tables both also provide applicable cache information,
353and cache flushing system. The semanticdb search routines use caches 353and cache flushing system. The semanticdb search routines use caches
354to save datastructures that are complex to calculate. 354to save datastructures that are complex to calculate.
355 355
@@ -606,7 +606,7 @@ Emacs Lisp. It is an LALR parser suitable for complex languages.
606@c LocalWords: concat concocting const constantness ctxt Decl defcustom 606@c LocalWords: concat concocting const constantness ctxt Decl defcustom
607@c LocalWords: deffn deffnx defun defvar destructor's dfn diff dir 607@c LocalWords: deffn deffnx defun defvar destructor's dfn diff dir
608@c LocalWords: doc docstring EDE EIEIO elisp emacsman emph enum 608@c LocalWords: doc docstring EDE EIEIO elisp emacsman emph enum
609@c LocalWords: eq Exp EXPANDFULL expresssion fn foo func funcall 609@c LocalWords: eq Exp EXPANDFULL expression fn foo func funcall
610@c LocalWords: ia ids iff ifinfo imenu imenus init int isearch itemx java kbd 610@c LocalWords: ia ids iff ifinfo imenu imenus init int isearch itemx java kbd
611@c LocalWords: keymap keywordtable lang languagemode lexer lexing Ludlam 611@c LocalWords: keymap keywordtable lang languagemode lexer lexing Ludlam
612@c LocalWords: menubar metaparent metaparents min minibuffer Misc mode's 612@c LocalWords: menubar metaparent metaparents min minibuffer Misc mode's
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi
index a4e06ab22f1..0accc6fac43 100644
--- a/doc/misc/tramp.texi
+++ b/doc/misc/tramp.texi
@@ -1575,7 +1575,7 @@ password handling. Consider @command{ssh-agent} for @option{ssh}-like
1575methods, or @command{pageant} for @option{plink}-like methods. 1575methods, or @command{pageant} for @option{plink}-like methods.
1576 1576
1577However, if you cannot apply such native password handling, 1577However, if you cannot apply such native password handling,
1578@value{tramp} offers altenatives. 1578@value{tramp} offers alternatives.
1579 1579
1580 1580
1581@anchor{Using an authentication file} 1581@anchor{Using an authentication file}