diff options
Diffstat (limited to 'doc')
50 files changed, 490 insertions, 507 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 @@ | |||
| 1 | 2011-11-17 Glenn Morris <rgm@gnu.org> | ||
| 2 | |||
| 3 | * regs.texi (Bookmarks): Small fixes related to saving. (Bug#10058) | ||
| 4 | |||
| 5 | 2011-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 | |||
| 1 | 2011-11-06 Chong Yidong <cyd@gnu.org> | 14 | 2011-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 | ||
| 1227 | 2010-03-27 Nick Roberts <nickrob@snap.net.nz> | 1240 | 2010-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 | ||
| 1232 | 2010-03-24 Glenn Morris <rgm@gnu.org> | 1246 | 2010-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 | ||
| 1717 | 2009-05-07 Chong Yidong <cyd@stupidchicken.com> | 1731 | 2009-05-07 Chong Yidong <cyd@stupidchicken.com> |
diff --git a/doc/emacs/ack.texi b/doc/emacs/ack.texi index c2242c444dd..d7022ba739b 100644 --- a/doc/emacs/ack.texi +++ b/doc/emacs/ack.texi | |||
| @@ -206,7 +206,7 @@ use it, Snake and Tetris. | |||
| 206 | 206 | ||
| 207 | @item | 207 | @item |
| 208 | Andrew Cohen wrote @file{spam-wash.el}, to decode and clean email before | 208 | Andrew Cohen wrote @file{spam-wash.el}, to decode and clean email before |
| 209 | it is analysed for spam. | 209 | it is analyzed for spam. |
| 210 | 210 | ||
| 211 | @item | 211 | @item |
| 212 | Georges Brun-Cottan and Stefan Monnier wrote @file{easy-mmode.el}, a | 212 | Georges Brun-Cottan and Stefan Monnier wrote @file{easy-mmode.el}, a |
| @@ -549,7 +549,7 @@ Taichi Kawabata added support for Devanagari script and the Indian | |||
| 549 | languages, and wrote @file{ucs-normalize.el} for Unicode normalization. | 549 | languages, and wrote @file{ucs-normalize.el} for Unicode normalization. |
| 550 | 550 | ||
| 551 | @item | 551 | @item |
| 552 | Taro Kawagishi implented the MD4 Message Digest Algorithm in Lisp; and | 552 | Taro Kawagishi implemented the MD4 Message Digest Algorithm in Lisp; and |
| 553 | wrote @file{ntlm.el} and @file{sasl-ntlm.el} for NT LanManager | 553 | wrote @file{ntlm.el} and @file{sasl-ntlm.el} for NT LanManager |
| 554 | authentication support. | 554 | authentication support. |
| 555 | 555 | ||
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. | |||
| 1251 | In all-stop mode, whenever your program stops, @emph{all} threads of | 1251 | In all-stop mode, whenever your program stops, @emph{all} threads of |
| 1252 | execution stop. Likewise, whenever you restart the program, all | 1252 | execution stop. Likewise, whenever you restart the program, all |
| 1253 | threads start executing. @xref{All-Stop Mode, , All-Stop Mode, gdb, | 1253 | threads start executing. @xref{All-Stop Mode, , All-Stop Mode, gdb, |
| 1254 | The GNU debugger}. You can enable this behaviour in Emacs by setting | 1254 | The 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 |
| 1256 | session. | 1256 | session. |
| 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}, |
| 548 | which brings up a buffer named @samp{*New Custom Theme*}. At the top | 548 | which brings up a buffer named @samp{*New Custom Theme*}. At the top |
| 549 | of the buffer is an editable field where you can specify the name of | 549 | of the buffer is an editable field where you can specify the name of |
| 550 | the theme. Click on the button labelled @samp{Insert Variable} to add | 550 | the theme. Click on the button labeled @samp{Insert Variable} to add |
| 551 | a variable to the theme, and click on @samp{Insert Face} to add a | 551 | a variable to the theme, and click on @samp{Insert Face} to add a |
| 552 | face. You can edit these values in the @samp{*New Custom Theme*} | 552 | face. You can edit these values in the @samp{*New Custom Theme*} |
| 553 | buffer like in an ordinary Customize buffer. To remove an option from | 553 | buffer like in an ordinary Customize buffer. To remove an option from |
| @@ -1068,7 +1068,7 @@ other context has no special meaning. | |||
| 1068 | well as the major modes; in fact, you can use it more than once, first | 1068 | well as the major modes; in fact, you can use it more than once, first |
| 1069 | to set the major mode and then to enable minor modes which are | 1069 | to set the major mode and then to enable minor modes which are |
| 1070 | specific to particular buffers. Using @code{mode} for minor modes | 1070 | specific to particular buffers. Using @code{mode} for minor modes |
| 1071 | is deprecated, though---instead, use @code{eval: (minor-mode 1)}. | 1071 | is 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 |
| 1074 | variables. Most minor modes, like Auto Fill mode, represent individual user | 1074 | variables. 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 | |||
| 1646 | keyboards usually issues the @key{Meta} modifier, not @key{Alt}. The | 1646 | keyboards usually issues the @key{Meta} modifier, not @key{Alt}. The |
| 1647 | standard key bindings in Emacs do not include any characters with | 1647 | standard key bindings in Emacs do not include any characters with |
| 1648 | these modifiers. However, you can customize Emacs to assign meanings | 1648 | these modifiers. However, you can customize Emacs to assign meanings |
| 1649 | to them. The modifier bits are labelled as @samp{s-}, @samp{H-} and | 1649 | to 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 |
| 736 | k} (@code{kill-rectangle}) to remove the text and and save it as the | 736 | k} (@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 |
| 738 | region-rectangle is like erasing the specified text on each line of | 738 | region-rectangle is like erasing the specified text on each line of |
| 739 | the rectangle; if there is any following text on the line, it moves | 739 | the 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 | ||
| 123 | The default behaviour when a user drags files from another application | 123 | The default behavior when a user drags files from another application |
| 124 | into an Emacs frame is to insert the contents of all the dragged files | 124 | into an Emacs frame is to insert the contents of all the dragged files |
| 125 | into the current buffer. To remap the @code{ns-drag-file} event to | 125 | into the current buffer. To remap the @code{ns-drag-file} event to |
| 126 | open the dragged files in the current frame use the following line: | 126 | open 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 | ||
| 247 | DocView mode (@code{doc-view-mode}) is a viewer for DVI, Postscript | 247 | DocView 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 |
| 249 | features such as slicing, zooming, and searching inside documents. It | 249 | features such as slicing, zooming, and searching inside documents. It |
| 250 | works by converting the document to a set of images using the | 250 | works 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 |
| 261 | files, Emacs automatically switches to DocView mode if possible | 261 | files, 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 |
| 263 | available, emacs needs to run in a graphical frame, and PNG image | 263 | available, emacs needs to run in a graphical frame, and PNG image |
| 264 | support has to be compiled into emacs. If any of these requirements | 264 | support has to be compiled into emacs. If any of these requirements |
| 265 | is not fulfilled, DocView falls back to an appropriate mode.}. When | 265 | is not fulfilled, DocView falls back to an appropriate mode.}. When |
| 266 | you visit a Postscript file, Emacs switches to PS mode, a major mode | 266 | you visit a PostScript file, Emacs switches to PS mode, a major mode |
| 267 | for editing Postscript files as text; however, it also enables DocView | 267 | for editing PostScript files as text; however, it also enables DocView |
| 268 | minor mode, so you can type @kbd{C-c C-c} to view the document with | 268 | minor mode, so you can type @kbd{C-c C-c} to view the document with |
| 269 | DocView. (PDF and DVI files, unlike Postscript files, are not usually | 269 | DocView. (PDF and DVI files, unlike PostScript files, are not usually |
| 270 | human-editable.) In either case, repeating @kbd{C-c C-c} | 270 | human-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 |
| 272 | text. | 272 | text. |
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 |
| 369 | only after @code{auto-mode-alist}. By default, | 369 | only 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 |
| 371 | files, HTML/XML/SGML files, and Postscript files. | 371 | files, 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 | |||
| 322 | attributes are displayed. | 322 | attributes 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 |
| 327 | described above: @code{ls-lisp-ignore-case}, | 327 | described 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 |
| 869 | supports all fonts that are natively supported by Windows. The | 869 | supports 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, |
| 871 | and supports Truetype and Opentype fonts. Some languages requiring | 871 | and supports TrueType and OpenType fonts. Some languages requiring |
| 872 | complex layout can only be properly supported by the uniscribe | 872 | complex layout can only be properly supported by the uniscribe |
| 873 | backend. By default, both backends are enabled if supported, with | 873 | backend. 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 |
| 916 | Specifies the character set registry that the font is | 916 | Specifies the character set registry that the font is |
| 917 | expected to cover. Most Truetype and Opentype fonts will be unicode fonts | 917 | expected to cover. Most TrueType and OpenType fonts will be unicode fonts |
| 918 | that cover several national character sets, but you can narrow down the | 918 | that cover several national character sets, but you can narrow down the |
| 919 | selection of fonts to those that support a particular character set by | 919 | selection of fonts to those that support a particular character set by |
| 920 | using a specific registry from @code{w32-charset-info-alist} here. | 920 | using 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, |
| 147 | previously documented in @ref{Text Registers}, inserts a rectangle | 147 | previously documented in @ref{Text Registers}, inserts a rectangle |
| 148 | rather than a a text string, if the register contains a rectangle. | 148 | rather 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 | |||
| 278 | bookmarks. Type @kbd{C-h m} in the bookmark buffer for more | 278 | bookmarks. Type @kbd{C-h m} in the bookmark buffer for more |
| 279 | information about its special editing commands. | 279 | information 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 |
| 282 | you have changed any bookmark values. You can also save the bookmarks | 282 | you have changed any bookmark values. You can also save the bookmarks |
| 283 | at any time with the @kbd{M-x bookmark-save} command. Bookmarks are | 283 | at any time with the @kbd{M-x bookmark-save} command. Bookmarks are |
| 284 | saved to the file @file{~/.emacs.d/bookmarks} (for compatibility with | 284 | saved 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 |
| 292 | that sets a bookmark will also save your bookmarks; this way, you | 292 | that sets a bookmark will also save your bookmarks; this way, you |
| 293 | don't lose any bookmark values even if Emacs crashes. (The value, if | 293 | don't lose any bookmark values even if Emacs crashes. The value, if |
| 294 | a number, says how many bookmark modifications should go by between | 294 | a number, says how many bookmark modifications should go by between |
| 295 | saving.) | 295 | saving. If you set this variable to @code{nil}, Emacs only |
| 296 | saves 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 |
| 311 | from the search string, and @kbd{C-M-y} (@code{isearch-yank-char}) | 311 | from the search string, and @kbd{C-M-y} (@code{isearch-yank-char}) |
| 312 | appends the character after point to the the search string. An | 312 | appends the character after point to the search string. An |
| 313 | alternative method to add the character after point is to enter the | 313 | alternative method to add the character after point is to enter the |
| 314 | minibuffer with @kbd{M-e} (@pxref{Repeat Isearch}) and type @kbd{C-f} | 314 | minibuffer with @kbd{M-e} (@pxref{Repeat Isearch}) and type @kbd{C-f} |
| 315 | at the end of the search string in the minibuffer. | 315 | at 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}, |
| 165 | which is ordinarily used to erase the last character that you typed. | 165 | which is ordinarily used to erase the last character that you typed. |
| 166 | We call this key @dfn{the usual erasure key}. In Emacs, it is | 166 | We call this key @dfn{the usual erasure key}. In Emacs, it is |
| 167 | supposed to be equivalent to @key{DEL}. | 167 | supposed 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 @@ | |||
| 1 | 2011-11-16 Juanma Barranquero <lekktu@gmail.com> | ||
| 2 | |||
| 3 | * emacs-lisp-intro.texi (etags): Fix typo. | ||
| 4 | |||
| 1 | 2011-03-07 Chong Yidong <cyd@stupidchicken.com> | 5 | 2011-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 | ||
| 796 | A Graph with Labelled Axes | 796 | A 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-\} | |||
| 1023 | invoke the command; this is called @dfn{rebinding}. @xref{Keymaps, , | 1023 | invoke the command; this is called @dfn{rebinding}. @xref{Keymaps, , |
| 1024 | Keymaps}.) The abbreviation @kbd{M-C-\} means that you type your | 1024 | Keymaps}.) 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}.) |
| 1028 | Sometimes a combination like this is called a keychord, since it is | 1028 | Sometimes a combination like this is called a keychord, since it is |
| 1029 | similar to the way you play a chord on a piano. If your keyboard does | 1029 | similar 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 | |||
| 1031 | of it. In this case, @kbd{M-C-\} means that you press and release your | 1031 | of 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 |
| 1033 | the same time. But usually @kbd{M-C-\} means press the @key{CTRL} key | 1033 | the same time. But usually @kbd{M-C-\} means press the @key{CTRL} key |
| 1034 | along with the key that is labelled @key{ALT} and, at the same time, | 1034 | along with the key that is labeled @key{ALT} and, at the same time, |
| 1035 | press the @key{\} key. | 1035 | press the @key{\} key. |
| 1036 | 1036 | ||
| 1037 | In addition to typing a lone keychord, you can prefix what you type | 1037 | In 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, | |||
| 4749 | such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will | 4749 | such as @code{mark-whole-buffer}, and then type @key{RET}. Emacs will |
| 4750 | switch buffers and display the source code for the function on your | 4750 | switch buffers and display the source code for the function on your |
| 4751 | screen. To switch back to your current buffer, type @kbd{C-x b | 4751 | screen. 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 | ||
| 13657 | The @code{etags} program handles more than 20 languages, including | 13657 | The @code{etags} program handles more than 20 languages, including |
| 13658 | Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java, | 13658 | Emacs Lisp, Common Lisp, Scheme, C, C++, Ada, Fortran, HTML, Java, |
| 13659 | LaTeX, Pascal, Perl, Postscript, Python, TeX, Texinfo, makefiles, and | 13659 | LaTeX, Pascal, Perl, PostScript, Python, TeX, Texinfo, makefiles, and |
| 13660 | most assemblers. The program has no switches for specifying the | 13660 | most assemblers. The program has no switches for specifying the |
| 13661 | language; it recognizes the language in an input file according to its | 13661 | language; it recognizes the language in an input file according to its |
| 13662 | file name and contents. | 13662 | file 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 |
| 16963 | the horizontal and vertical axes. Since the label printing functions | 16963 | the horizontal and vertical axes. Since the label printing functions |
| 16964 | do not contain much new material, I have placed their description in | 16964 | do not contain much new material, I have placed their description in |
| 16965 | an appendix. @xref{Full Graph, , A Graph with Labelled Axes}. | 16965 | an 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 | |||
| 19447 | exploration. | 19447 | exploration. |
| 19448 | 19448 | ||
| 19449 | From the human point of view, the act of exploration and discovery is | 19449 | From the human point of view, the act of exploration and discovery is |
| 19450 | not necessarily an error, and therefore should not be labelled as one, | 19450 | not necessarily an error, and therefore should not be labeled as one, |
| 19451 | even in the bowels of a computer. As it is, the code in Emacs implies | 19451 | even in the bowels of a computer. As it is, the code in Emacs implies |
| 19452 | that a human who is acting virtuously, by exploring his or her | 19452 | that a human who is acting virtuously, by exploring his or her |
| 19453 | environment, is making an error. This is bad. Even though the computer | 19453 | environment, 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 | |||
| 19760 | because they were written earlier. | 19760 | because 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 | ||
| 19765 | Printed axes help you understand a graph. They convey scale. In an | 19765 | Printed axes help you understand a graph. They convey scale. In an |
| 19766 | earlier chapter (@pxref{Readying a Graph, , Readying a Graph}), we | 19766 | earlier chapter (@pxref{Readying a Graph, , Readying a Graph}), we |
| 19767 | wrote the code to print the body of a graph. Here we write the code | 19767 | wrote the code to print the body of a graph. Here we write the code |
| 19768 | for printing and labelling vertical and horizontal axes, along with the | 19768 | for printing and labeling vertical and horizontal axes, along with the |
| 19769 | body itself. | 19769 | body 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 | ||
| 19784 | Since insertions fill a buffer to the right and below point, the new | 19784 | Since 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 |
| 19824 | In this graph, both the vertical and the horizontal axes are labelled | 19824 | In this graph, both the vertical and the horizontal axes are labeled |
| 19825 | with numbers. However, in some graphs, the horizontal axis is time | 19825 | with numbers. However, in some graphs, the horizontal axis is time |
| 19826 | and would be better labelled with months, like this: | 19826 | and 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 | ||
| 19840 | Indeed, with a little thought, we can easily come up with a variety of | 19840 | Indeed, with a little thought, we can easily come up with a variety of |
| 19841 | vertical and horizontal labelling schemes. Our task could become | 19841 | vertical and horizontal labeling schemes. Our task could become |
| 19842 | complicated. But complications breed confusion. Rather than permit | 19842 | complicated. But complications breed confusion. Rather than permit |
| 19843 | this, it is better choose a simple labelling scheme for our first | 19843 | this, it is better choose a simple labeling scheme for our first |
| 19844 | effort, and to modify or replace it later. | 19844 | effort, 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 | |||
| 19864 | We can work on each part of the @code{print-graph} function definition | 19864 | We can work on each part of the @code{print-graph} function definition |
| 19865 | in turn. | 19865 | in 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 | |||
| 20391 | The value of the variable @code{X-axis-label-spacing} should itself be | 20391 | The value of the variable @code{X-axis-label-spacing} should itself be |
| 20392 | measured in units of @code{symbol-width}, since you may want to change | 20392 | measured in units of @code{symbol-width}, since you may want to change |
| 20393 | the width of the symbols that you are using to print the body of the | 20393 | the width of the symbols that you are using to print the body of the |
| 20394 | graph without changing the ways the graph is labelled. | 20394 | graph 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: | |||
| 20722 | Now we are nearly ready to print the whole graph. | 20722 | Now we are nearly ready to print the whole graph. |
| 20723 | 20723 | ||
| 20724 | The function to print the graph with the proper labels follows the | 20724 | The function to print the graph with the proper labels follows the |
| 20725 | outline we created earlier (@pxref{Full Graph, , A Graph with Labelled | 20725 | outline we created earlier (@pxref{Full Graph, , A Graph with Labeled |
| 20726 | Axes}), but with additions. | 20726 | Axes}), 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. |
| 20861 | The numbers-list consists of the Y-axis values. | 20861 | The 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. |
| 21482 | The numbers-list consists of the Y-axis values. | 21482 | The 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. |
| 21983 | The numbers-list consists of the Y-axis values. | 21983 | The 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 a8e1439d242..232ddff6d3f 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog | |||
| @@ -1,3 +1,26 @@ | |||
| 1 | 2011-11-19 Chong Yidong <cyd@gnu.org> | ||
| 2 | |||
| 3 | * windows.texi (Splitting Windows): Clarify role of window | ||
| 4 | parameters in split-window. Shorten the example. | ||
| 5 | (Deleting Windows): Rewrite intro to handle internal windows. Fix | ||
| 6 | delete-windows-on doc. | ||
| 7 | (Selecting Windows): Copyedits. | ||
| 8 | |||
| 9 | 2011-11-17 Martin Rudalics <rudalics@gmx.at> | ||
| 10 | |||
| 11 | * windows.texi (Resizing Windows, Splitting Windows) | ||
| 12 | (Deleting Windows): Use term window-combination-resize instead | ||
| 13 | of window-splits. | ||
| 14 | |||
| 15 | 2011-11-16 Martin Rudalics <rudalics@gmx.at> | ||
| 16 | |||
| 17 | * windows.texi (Resizing Windows, Splitting Windows): Rename | ||
| 18 | occurrences of window-nest to window-combination-limit. | ||
| 19 | |||
| 20 | 2011-11-14 Juanma Barranquero <lekktu@gmail.com> | ||
| 21 | |||
| 22 | * intro.texi (Lisp History): Fix typo. | ||
| 23 | |||
| 1 | 2011-11-12 Martin Rudalics <rudalics@gmx.at> | 24 | 2011-11-12 Martin Rudalics <rudalics@gmx.at> |
| 2 | 25 | ||
| 3 | * windows.texi (Splitting Windows, Deleting Windows): Remove | 26 | * windows.texi (Splitting Windows, Deleting Windows): Remove |
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index 034d92f78c3..39a81ecc6ad 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi | |||
| @@ -4546,7 +4546,7 @@ you may prefer to use a different one for a given image type (which | |||
| 4546 | @c FIXME how is this priority determined? | 4546 | @c FIXME how is this priority determined? |
| 4547 | loader will be used in practice depends on the priority of the loaders). | 4547 | loader will be used in practice depends on the priority of the loaders). |
| 4548 | @c FIXME why are these uppercase when image-types is lower-case? | 4548 | @c FIXME why are these uppercase when image-types is lower-case? |
| 4549 | @c FIXME what are the possibe options? Are these actually file extensions? | 4549 | @c FIXME what are the possible options? Are these actually file extensions? |
| 4550 | For example, if you never want to use the ImageMagick loader to use | 4550 | For example, if you never want to use the ImageMagick loader to use |
| 4551 | JPEG files, add @code{JPG} to this list. | 4551 | JPEG files, add @code{JPG} to this list. |
| 4552 | 4552 | ||
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index d9399e98a69..dad1f28026e 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi | |||
| @@ -953,7 +953,7 @@ variable, Emacs uses the latter. By default, | |||
| 953 | The @code{alpha} frame parameter can also be a cons cell | 953 | The @code{alpha} frame parameter can also be a cons cell |
| 954 | @code{(@samp{active} . @samp{inactive})}, where @samp{active} is the | 954 | @code{(@samp{active} . @samp{inactive})}, where @samp{active} is the |
| 955 | opacity of the frame when it is selected, and @samp{inactive} is the | 955 | opacity of the frame when it is selected, and @samp{inactive} is the |
| 956 | opactity when it is not selected. | 956 | opacity when it is not selected. |
| 957 | @end table | 957 | @end table |
| 958 | 958 | ||
| 959 | The following frame parameters are semi-obsolete in that they are | 959 | The following frame parameters are semi-obsolete in that they are |
| @@ -2414,7 +2414,7 @@ This function returns the ``vendor'' that provided the X server | |||
| 2414 | software (as a string). Really this means whoever distributes the X | 2414 | software (as a string). Really this means whoever distributes the X |
| 2415 | server. | 2415 | server. |
| 2416 | 2416 | ||
| 2417 | When the developers of X labelled software distributors as | 2417 | When 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 |
| 2419 | ever be developed and distributed noncommercially. | 2419 | ever 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. | |||
| 2430 | The functions @code{x-pixel-width} and @code{x-pixel-height} return the | 2430 | The functions @code{x-pixel-width} and @code{x-pixel-height} return the |
| 2431 | width and height of an X Window frame, measured in pixels. | 2431 | width 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 |
| 889 | The values of @code{modiff} and @code{overlay_modiff}, respectively, | 889 | The values of @code{modiff} and @code{overlay_modiff}, respectively, |
| 890 | after the last compelete redisplay. If their current values match | 890 | after 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 |
| 893 | information. | 893 | information. |
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 |
| 102 | with its own idiosyncrasies. Many of them were inspired by Maclisp, | 102 | with its own idiosyncrasies. Many of them were inspired by Maclisp, |
| 103 | which was written in the 1960s at MIT's Project MAC. Eventually the | 103 | which was written in the 1960s at MIT's Project MAC. Eventually the |
| 104 | implementors of the descendants of Maclisp came together and developed a | 104 | implementers of the descendants of Maclisp came together and developed a |
| 105 | standard for Lisp systems, called Common Lisp. In the meantime, Gerry | 105 | standard for Lisp systems, called Common Lisp. In the meantime, Gerry |
| 106 | Sussman and Guy Steele at MIT developed a simplified but very powerful | 106 | Sussman and Guy Steele at MIT developed a simplified but very powerful |
| 107 | dialect of Lisp, called Scheme. | 107 | dialect 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. | |||
| 420 | Per default, this variable is always set to @code{t}, meaning that a | 420 | Per default, this variable is always set to @code{t}, meaning that a |
| 421 | call of @code{process-file} could potentially change any file on a | 421 | call of @code{process-file} could potentially change any file on a |
| 422 | remote host. When set to @code{nil}, a file handler could optimize | 422 | remote host. When set to @code{nil}, a file handler could optimize |
| 423 | its behaviour with respect to remote file attributes caching. | 423 | its behavior with respect to remote file attributes caching. |
| 424 | 424 | ||
| 425 | This variable should never be changed by @code{setq}. Instead of, it | 425 | This variable should never be changed by @code{setq}. Instead of, it |
| 426 | shall be set only by let-binding. | 426 | shall be set only by let-binding. |
diff --git a/doc/lispref/searching.texi b/doc/lispref/searching.texi index fe7c805c6f7..a601ed0c2c0 100644 --- a/doc/lispref/searching.texi +++ b/doc/lispref/searching.texi | |||
| @@ -1213,7 +1213,7 @@ match data around it, to prevent it from being overwritten. | |||
| 1213 | 1213 | ||
| 1214 | Notice that all functions are allowed to overwrite the match data | 1214 | Notice that all functions are allowed to overwrite the match data |
| 1215 | unless they're explicitly documented not to do so. A consequence is | 1215 | unless they're explicitly documented not to do so. A consequence is |
| 1216 | that functions that are run implictly in the background | 1216 | that functions that are run implicitly in the background |
| 1217 | (@pxref{Timers}, and @ref{Idle Timers}) should likely save and restore | 1217 | (@pxref{Timers}, and @ref{Idle Timers}) should likely save and restore |
| 1218 | the match data explicitly. | 1218 | the match data explicitly. |
| 1219 | 1219 | ||
diff --git a/doc/lispref/spellfile b/doc/lispref/spellfile index b373d00bebf..a98f0427ef6 100644 --- a/doc/lispref/spellfile +++ b/doc/lispref/spellfile | |||
| @@ -240,7 +240,7 @@ correct' | |||
| 240 | counterintuitive | 240 | counterintuitive |
| 241 | cr | 241 | cr |
| 242 | creatable | 242 | creatable |
| 243 | customie | 243 | customize |
| 244 | deactivate | 244 | deactivate |
| 245 | deactivated | 245 | deactivated |
| 246 | deassigns | 246 | deassigns |
| @@ -331,7 +331,6 @@ for' | |||
| 331 | formfeed | 331 | formfeed |
| 332 | forms' | 332 | forms' |
| 333 | forw | 333 | forw |
| 334 | forwa | ||
| 335 | found' | 334 | found' |
| 336 | frob | 335 | frob |
| 337 | from' | 336 | from' |
| @@ -377,7 +376,6 @@ inserting' | |||
| 377 | integerp | 376 | integerp |
| 378 | intermixed | 377 | intermixed |
| 379 | ints | 378 | ints |
| 380 | inturned | ||
| 381 | irreversibly | 379 | irreversibly |
| 382 | jum | 380 | jum |
| 383 | keymapp | 381 | keymapp |
| @@ -531,7 +529,6 @@ pointer' | |||
| 531 | pointm | 529 | pointm |
| 532 | pos | 530 | pos |
| 533 | preallocate | 531 | preallocate |
| 534 | predicale | ||
| 535 | preload | 532 | preload |
| 536 | prepend | 533 | prepend |
| 537 | prepended | 534 | prepended |
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 | |||
| 87 | insert elisp2-aux-vol-added into vol1.aux (append) | 87 | insert elisp2-aux-vol-added into vol1.aux (append) |
| 88 | insert elisp1-aux-vol-added into vol2.aux (prepend) | 88 | insert 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 b6bacc27684..4e67fa6d740 100644 --- a/doc/lispref/windows.texi +++ b/doc/lispref/windows.texi | |||
| @@ -110,6 +110,7 @@ including for the case where @var{object} is a deleted window. | |||
| 110 | @end defun | 110 | @end defun |
| 111 | 111 | ||
| 112 | @cindex selected window | 112 | @cindex selected window |
| 113 | @cindex window selected within a frame | ||
| 113 | In each frame, at any time, exactly one Emacs window is designated | 114 | In each frame, at any time, exactly one Emacs window is designated |
| 114 | as @dfn{selected within the frame}. For the selected frame, that | 115 | as @dfn{selected within the frame}. For the selected frame, that |
| 115 | window is called the @dfn{selected window}---the one in which most | 116 | window is called the @dfn{selected window}---the one in which most |
| @@ -632,10 +633,11 @@ the window cannot be resized as demanded, an error is signaled. | |||
| 632 | The optional argument @var{ignore} has the same meaning as for the | 633 | The optional argument @var{ignore} has the same meaning as for the |
| 633 | function @code{window-resizable} above. | 634 | function @code{window-resizable} above. |
| 634 | 635 | ||
| 635 | The choice of which window edge this function alters depends on the | 636 | The choice of which window edges this function alters depends on the |
| 636 | splitting and nesting status of the involved windows; in some cases, | 637 | values of the option @code{window-combination-resize} and the |
| 637 | it may alter both edges. @xref{Splitting Windows}. To resize by | 638 | combination-limit status of the involved windows; in some cases, it may |
| 638 | moving only the bottom or right edge of a window, use the function | 639 | alter both edges. @xref{Splitting Windows}. To resize by moving only |
| 640 | the bottom or right edge of a window, use the function | ||
| 639 | @code{adjust-window-trailing-edge}, below. | 641 | @code{adjust-window-trailing-edge}, below. |
| 640 | @end defun | 642 | @end defun |
| 641 | 643 | ||
| @@ -773,22 +775,24 @@ properties from it, including margins and scroll bars. If | |||
| 773 | @var{window} is an internal window, the new window inherits the | 775 | @var{window} is an internal window, the new window inherits the |
| 774 | properties of the window selected within @var{window}'s frame. | 776 | properties of the window selected within @var{window}'s frame. |
| 775 | 777 | ||
| 776 | If the variable @code{ignore-window-parameters} is non-@code{nil} | 778 | The behavior of this function may be altered by the window parameters |
| 777 | (@pxref{Window Parameters}), this function ignores window parameters. | 779 | of @var{window}, so long as the variable |
| 778 | Otherwise, it consults the @code{split-window} parameter of | 780 | @code{ignore-window-parameters} is non-@code{nil}. If the value of |
| 779 | @var{window}; if this is @code{t}, it splits the window disregarding | 781 | the @code{split-window} window parameter is @code{t}, this function |
| 780 | any other window parameters. If the @code{split-window} parameter | 782 | ignores all other window parameters. Otherwise, if the value of the |
| 781 | specifies a function, that function is called with the arguments | 783 | @code{split-window} window parameter is a function, that function is |
| 782 | @var{window}, @var{size}, and @var{side} to split @var{window}, in | 784 | called with the arguments @var{window}, @var{size}, and @var{side}, in |
| 783 | lieu of the usual action of @code{split-window}. | 785 | lieu of the usual action of @code{split-window}. Otherwise, this |
| 786 | function obeys the @code{window-atom} or @code{window-side} window | ||
| 787 | parameter, if any. @xref{Window Parameters}. | ||
| 784 | @end deffn | 788 | @end deffn |
| 785 | 789 | ||
| 786 | As an example, we show a combination of @code{split-window} calls | 790 | As an example, here is a sequence of @code{split-window} calls that |
| 787 | that yields the window configuration discussed in @ref{Windows and | 791 | yields the window configuration discussed in @ref{Windows and Frames}. |
| 788 | Frames}. This example demonstrates splitting a live window as well as | 792 | This example demonstrates splitting a live window as well as splitting |
| 789 | splitting an internal window. We begin with a frame containing a | 793 | an internal window. We begin with a frame containing a single window |
| 790 | single window (a live root window), which we denote by @var{W4}. | 794 | (a live root window), which we denote by @var{W4}. Calling |
| 791 | Calling @code{(split-window W3)} yields this window configuration: | 795 | @code{(split-window W3)} yields this window configuration: |
| 792 | 796 | ||
| 793 | @smallexample | 797 | @smallexample |
| 794 | @group | 798 | @group |
| @@ -840,10 +844,7 @@ A new live window @var{W2} is created, to the left of the internal | |||
| 840 | window @var{W3}. A new internal window @var{W1} is created, becoming | 844 | window @var{W3}. A new internal window @var{W1} is created, becoming |
| 841 | the new root window. | 845 | the new root window. |
| 842 | 846 | ||
| 843 | The following two options can be used to modify the operation of | 847 | @defopt window-combination-resize |
| 844 | @code{split-window}. | ||
| 845 | |||
| 846 | @defopt window-splits | ||
| 847 | If this variable is @code{nil}, @code{split-window} can only split a | 848 | If this variable is @code{nil}, @code{split-window} can only split a |
| 848 | window (denoted by @var{window}) if @var{window}'s screen area is | 849 | window (denoted by @var{window}) if @var{window}'s screen area is |
| 849 | large enough to accommodate both itself and the new window. This is | 850 | large enough to accommodate both itself and the new window. This is |
| @@ -853,18 +854,17 @@ If this variable is non-@code{nil}, @code{split-window} tries to | |||
| 853 | resize all windows that are part of the same combination as | 854 | resize all windows that are part of the same combination as |
| 854 | @var{window}, in order to accommodate the new window. In particular, | 855 | @var{window}, in order to accommodate the new window. In particular, |
| 855 | this may allow @code{split-window} to succeed even if @var{window} is | 856 | this may allow @code{split-window} to succeed even if @var{window} is |
| 856 | a fixed-size window or too small to ordinarily split. | 857 | a fixed-size window or too small to ordinarily split. Furthermore, |
| 857 | 858 | subsequently resizing or deleting @var{window} may resize all other | |
| 858 | Also if this variable is non-@code{nil}, subsequent resizing and | 859 | windows in its combination. |
| 859 | deleting @var{window} will usually affect @emph{all} windows in | ||
| 860 | @var{window}'s combination. | ||
| 861 | 860 | ||
| 862 | The setting of this variable has no effect if @code{window-nest} (see | 861 | This variable has no effect if @code{window-combination-limit} is |
| 863 | below) is non-@code{nil}. | 862 | non-@code{nil} (see below). |
| 864 | @end defopt | 863 | @end defopt |
| 865 | 864 | ||
| 866 | To illustrate the use of @code{window-splits} consider the following | 865 | To illustrate the effect of @code{window-combination-resize}, |
| 867 | window configuration: | 866 | consider the following window configuration: |
| 867 | |||
| 868 | @smallexample | 868 | @smallexample |
| 869 | @group | 869 | @group |
| 870 | ______________________________________ | 870 | ______________________________________ |
| @@ -885,8 +885,10 @@ window configuration: | |||
| 885 | @end group | 885 | @end group |
| 886 | @end smallexample | 886 | @end smallexample |
| 887 | 887 | ||
| 888 | Splitting window @code{W3} with @code{window-splits} @code{nil} | 888 | @noindent |
| 889 | produces a configuration where the size of @code{W2} remains unchanged: | 889 | If @code{window-combination-resize} is @code{nil}, splitting window |
| 890 | @code{W3} leaves the size of @code{W2} unchanged: | ||
| 891 | |||
| 890 | @smallexample | 892 | @smallexample |
| 891 | @group | 893 | @group |
| 892 | ______________________________________ | 894 | ______________________________________ |
| @@ -907,9 +909,10 @@ produces a configuration where the size of @code{W2} remains unchanged: | |||
| 907 | @end group | 909 | @end group |
| 908 | @end smallexample | 910 | @end smallexample |
| 909 | 911 | ||
| 910 | Splitting @code{W3} with @code{window-splits} non-@code{nil} instead | 912 | @noindent |
| 911 | produces a configuration where all windows have approximately the same | 913 | If @code{window-combination-resize} is non-@code{nil}, splitting |
| 912 | height: | 914 | @code{W3} instead leaves all three live windows with approximately the |
| 915 | same height: | ||
| 913 | 916 | ||
| 914 | @smallexample | 917 | @smallexample |
| 915 | @group | 918 | @group |
| @@ -931,51 +934,52 @@ height: | |||
| 931 | @end group | 934 | @end group |
| 932 | @end smallexample | 935 | @end smallexample |
| 933 | 936 | ||
| 934 | @defopt window-nest | 937 | @defopt window-combination-limit |
| 935 | If this variable is @code{nil}, @code{split-window} creates a new parent | 938 | If the value of this variable is @code{t}, the @code{split-window} |
| 936 | window if and only if the old window has no parent window or shall be | 939 | function always creates a new internal window. If the value is |
| 937 | split orthogonally to the combination it is part of. If this variable | 940 | @code{nil}, the new live window is allowed to share the existing |
| 938 | is non-@code{nil}, @code{split-window} always creates a new parent | 941 | parent window, if one exists, provided the split occurs in the same |
| 939 | window. If this variable is always non-@code{nil}, a frame's window | 942 | direction as the existing window combination (otherwise, a new |
| 940 | tree is a binary tree so every window but the frame's root window has | 943 | internal window is created anyway). The default is @code{nil}. Other |
| 941 | exactly one sibling. | 944 | values are reserved for future use. |
| 942 | 945 | ||
| 943 | The value of this variable is also assigned to the nest status of the | 946 | Thus, if the value is always @code{t}, each window tree is a binary |
| 944 | new parent window. The nest status of any window can be retrieved via | 947 | tree: each window except the root window has exactly one sibling. |
| 945 | the function @code{window-nest} and altered by the function | 948 | |
| 946 | @code{set-window-nest}, see below. | 949 | Furthermore, @code{split-window} calls |
| 950 | @code{set-window-combination-limit} on the newly-created internal | ||
| 951 | window, recording the current value of this variable. This affects | ||
| 952 | how the window tree is rearranged when the child windows are deleted | ||
| 953 | (see below). | ||
| 947 | @end defopt | 954 | @end defopt |
| 948 | 955 | ||
| 949 | @defun window-nest &optional window | 956 | @cindex window combination limit |
| 950 | This function returns the nest status of @var{window}. The argument | 957 | @defun set-window-combination-limit window status |
| 951 | @var{window} can be any window and defaults to the selected one. Note, | 958 | This functions sets the @dfn{combination limit} of the window |
| 952 | however, that the nest status is currently meaningful for internal | 959 | @var{window} to @var{status}. This value can be retrieved via the |
| 953 | windows only. | 960 | function @code{window-combination-limit}. See below for its effects; |
| 961 | note that it is only meaningful for internal windows. The | ||
| 962 | @code{split-window} function automatically calls this function, | ||
| 963 | passing the value of the variable @code{window-combination-limit} as | ||
| 964 | @var{status}. | ||
| 965 | @end defun | ||
| 954 | 966 | ||
| 955 | @cindex nest status | 967 | @defun window-combination-limit window |
| 956 | The @dfn{nest status} of a window specifies whether that window may be | 968 | This function returns the combination limit for @var{window}. |
| 957 | removed and its child windows recombined with that window's siblings | ||
| 958 | when such a sibling's child window is deleted. The nest status is | ||
| 959 | initially assigned by @code{split-window} from the current value of the | ||
| 960 | variable @code{window-nest} (see above) and can be reset by the function | ||
| 961 | @code{set-window-nest} (see below). | ||
| 962 | 969 | ||
| 963 | If the return value is @code{nil}, child windows of @var{window} may be | 970 | The combination limit is meaningful only for an internal window. If |
| 964 | recombined with @var{window}'s siblings when a window gets deleted. A | 971 | it is @code{nil}, then Emacs is allowed to automatically delete |
| 965 | return value of @code{nil} means that child windows of @var{window} are | 972 | @var{window}, in response to a window deletion, in order to group the |
| 966 | never (re-)combined with @var{window}'s siblings in such a case. | 973 | child windows of @var{window} with the child windows of one of its |
| 974 | siblings to form a new window combination. If the combination limit | ||
| 975 | is @code{t}, the child windows of @var{window} are never automatically | ||
| 976 | re-combined with its siblings'. | ||
| 967 | @end defun | 977 | @end defun |
| 968 | 978 | ||
| 969 | @defun set-window-nest window &optional status | 979 | To illustrate the effect of @code{window-combination-limit}, |
| 970 | This functions sets the nest status (see above) of @var{window} to | 980 | consider the following configuration (throughout this example, we will |
| 971 | @var{status}. The argument @var{window} can be any window and defaults | 981 | assume that @code{window-combination-resize} is @code{nil}): |
| 972 | to the selected one. Note that setting the nest status is meaningful | ||
| 973 | for internal windows only. The return value is @var{status}. | ||
| 974 | @end defun | ||
| 975 | 982 | ||
| 976 | To illustrate the use of @code{window-nest} consider the following | ||
| 977 | configuration (throughout the following examples we shall assume that | ||
| 978 | @code{window-splits} invariantly is @code{nil}). | ||
| 979 | @smallexample | 983 | @smallexample |
| 980 | @group | 984 | @group |
| 981 | ______________________________________ | 985 | ______________________________________ |
| @@ -996,30 +1000,10 @@ configuration (throughout the following examples we shall assume that | |||
| 996 | @end group | 1000 | @end group |
| 997 | @end smallexample | 1001 | @end smallexample |
| 998 | 1002 | ||
| 999 | Splitting @code{W2} into two windows above each other with | 1003 | @noindent |
| 1000 | @code{window-nest} equal @code{nil} will get you a configuration like: | 1004 | If @code{window-combination-limit} is @code{nil}, splitting @code{W2} |
| 1001 | @smallexample | 1005 | into two windows, one above the other, yields |
| 1002 | @group | ||
| 1003 | ______________________________________ | ||
| 1004 | | ____________________________________ | | ||
| 1005 | || || | ||
| 1006 | || || | ||
| 1007 | ||_________________W2_________________|| | ||
| 1008 | | ____________________________________ | | ||
| 1009 | || || | ||
| 1010 | || || | ||
| 1011 | ||_________________W4_________________|| | ||
| 1012 | | ____________________________________ | | ||
| 1013 | || || | ||
| 1014 | || || | ||
| 1015 | ||_________________W3_________________|| | ||
| 1016 | |__________________W1__________________| | ||
| 1017 | |||
| 1018 | @end group | ||
| 1019 | @end smallexample | ||
| 1020 | 1006 | ||
| 1021 | If you now enlarge window @code{W4}, Emacs steals the necessary space | ||
| 1022 | from window @code{W3} resulting in a configuration like: | ||
| 1023 | @smallexample | 1007 | @smallexample |
| 1024 | @group | 1008 | @group |
| 1025 | ______________________________________ | 1009 | ______________________________________ |
| @@ -1030,43 +1014,24 @@ from window @code{W3} resulting in a configuration like: | |||
| 1030 | | ____________________________________ | | 1014 | | ____________________________________ | |
| 1031 | || || | 1015 | || || |
| 1032 | || || | 1016 | || || |
| 1033 | || || | ||
| 1034 | ||_________________W4_________________|| | 1017 | ||_________________W4_________________|| |
| 1035 | | ____________________________________ | | 1018 | | ____________________________________ | |
| 1036 | || || | 1019 | || || |
| 1020 | || || | ||
| 1037 | ||_________________W3_________________|| | 1021 | ||_________________W3_________________|| |
| 1038 | |__________________W1__________________| | 1022 | |__________________W1__________________| |
| 1039 | 1023 | ||
| 1040 | @end group | 1024 | @end group |
| 1041 | @end smallexample | 1025 | @end smallexample |
| 1042 | 1026 | ||
| 1043 | Deleting window @code{W4}, will return its space to @code{W2} as | 1027 | @noindent |
| 1044 | follows: | 1028 | The newly-created window, @code{W4}, shares the same internal window |
| 1045 | @smallexample | 1029 | @code{W1}. If @code{W4} is resized, it is allowed to resize the other |
| 1046 | @group | 1030 | live window, @code{W3}. |
| 1047 | ______________________________________ | ||
| 1048 | | ____________________________________ | | ||
| 1049 | || || | ||
| 1050 | || || | ||
| 1051 | || || | ||
| 1052 | || || | ||
| 1053 | || || | ||
| 1054 | || || | ||
| 1055 | || || | ||
| 1056 | ||_________________W2_________________|| | ||
| 1057 | | ____________________________________ | | ||
| 1058 | || || | ||
| 1059 | ||_________________W3_________________|| | ||
| 1060 | |__________________W1__________________| | ||
| 1061 | 1031 | ||
| 1062 | @end group | 1032 | If @code{window-combination-limit} is @code{t}, splitting @code{W2} |
| 1063 | @end smallexample | 1033 | in the initial configuration would instead have produced this: |
| 1064 | 1034 | ||
| 1065 | Hence, with respect to the initial configuration, window @code{W2} has | ||
| 1066 | grown at the expense of window @code{W3}. If, however, in the initial | ||
| 1067 | configuration you had split @code{W2} with @code{window-nest} bound to | ||
| 1068 | @code{t}, a new internal window @code{W5} would have been created as | ||
| 1069 | depicted below. | ||
| 1070 | @smallexample | 1035 | @smallexample |
| 1071 | @group | 1036 | @group |
| 1072 | ______________________________________ | 1037 | ______________________________________ |
| @@ -1087,142 +1052,110 @@ depicted below. | |||
| 1087 | @end group | 1052 | @end group |
| 1088 | @end smallexample | 1053 | @end smallexample |
| 1089 | 1054 | ||
| 1090 | Enlarging @code{W4} would now have stolen the necessary space from | 1055 | @noindent |
| 1091 | @code{W2} instead of @code{W3} as | 1056 | A new internal window @code{W5} has been created; its children are |
| 1092 | @smallexample | 1057 | @code{W2} and the new live window @code{W4}. Now, @code{W2} is the |
| 1093 | @group | 1058 | only sibling of @code{W4}, so resizing @code{W4} will resize |
| 1094 | ______________________________________ | 1059 | @code{W2}, leaving @code{W3} unaffected. |
| 1095 | | ____________________________________ | | ||
| 1096 | || __________________________________ || | ||
| 1097 | |||________________W2________________||| | ||
| 1098 | || __________________________________ || | ||
| 1099 | ||| ||| | ||
| 1100 | ||| ||| | ||
| 1101 | |||________________W4________________||| | ||
| 1102 | ||_________________W5_________________|| | ||
| 1103 | | ____________________________________ | | ||
| 1104 | || || | ||
| 1105 | || || | ||
| 1106 | ||_________________W3_________________|| | ||
| 1107 | |__________________W1__________________| | ||
| 1108 | |||
| 1109 | @end group | ||
| 1110 | @end smallexample | ||
| 1111 | 1060 | ||
| 1112 | and the subsequent deletion of @code{W4} would have restored the initial | 1061 | For interactive use, Emacs provides two commands which always split |
| 1113 | configuration. | 1062 | the selected window. These call @code{split-window} internally. |
| 1114 | 1063 | ||
| 1115 | For interactive use, Emacs provides two commands which always split the | 1064 | @deffn Command split-window-right &optional size |
| 1116 | selected window. | 1065 | This function splits the selected window into two side-by-side |
| 1066 | windows, putting the selected window on the left. If @var{size} is | ||
| 1067 | positive, the left window gets @var{size} columns; if @var{size} is | ||
| 1068 | negative, the right window gets @minus{}@var{size} columns. | ||
| 1069 | @end deffn | ||
| 1117 | 1070 | ||
| 1118 | @deffn Command split-window-below &optional size | 1071 | @deffn Command split-window-below &optional size |
| 1119 | This function splits the selected window into two windows, one above the | 1072 | This function splits the selected window into two windows, one above |
| 1120 | other, leaving the upper of the two windows selected, with @var{size} | 1073 | the other, leaving the upper window selected. If @var{size} is |
| 1121 | lines. (If @var{size} is negative, then the lower of the two windows | 1074 | positive, the upper window gets @var{size} lines; if @var{size} is |
| 1122 | gets @minus{}@var{size} lines and the upper window gets the rest, but | 1075 | negative, the lower window gets @minus{}@var{size} lines. |
| 1123 | the upper window is still the one selected.) However, if | ||
| 1124 | @code{split-window-keep-point} (see below) is @code{nil}, then either | ||
| 1125 | window can be selected. | ||
| 1126 | |||
| 1127 | In other respects, this function is similar to @code{split-window}. | ||
| 1128 | In particular, the upper window is the original one and the return value | ||
| 1129 | is the new, lower window. | ||
| 1130 | @end deffn | 1076 | @end deffn |
| 1131 | 1077 | ||
| 1132 | @defopt split-window-keep-point | 1078 | @defopt split-window-keep-point |
| 1133 | If this variable is non-@code{nil} (the default), then | 1079 | If the value of this variable is non-@code{nil} (the default), |
| 1134 | @code{split-window-below} behaves as described above. | 1080 | @code{split-window-below} behaves as described above. |
| 1135 | 1081 | ||
| 1136 | If it is @code{nil}, then @code{split-window-below} adjusts point | 1082 | If it is @code{nil}, @code{split-window-below} adjusts point in each |
| 1137 | in each of the two windows to avoid scrolling. (This is useful on | 1083 | of the two windows to minimize redisplay. (This is useful on slow |
| 1138 | slow terminals.) It selects whichever window contains the screen line | 1084 | terminals.) It selects whichever window contains the screen line that |
| 1139 | that point was previously on. Other functions are not affected by | 1085 | point was previously on. Note that this only affects |
| 1140 | this variable. | 1086 | @code{split-window-below}, not the lower-level @code{split-window} |
| 1087 | function. | ||
| 1141 | @end defopt | 1088 | @end defopt |
| 1142 | 1089 | ||
| 1143 | @deffn Command split-window-right &optional size | ||
| 1144 | This function splits the selected window into two windows | ||
| 1145 | side-by-side, leaving the selected window on the left with @var{size} | ||
| 1146 | columns. If @var{size} is negative, the rightmost window gets | ||
| 1147 | @minus{}@var{size} columns, but the leftmost window still remains | ||
| 1148 | selected. | ||
| 1149 | @end deffn | ||
| 1150 | |||
| 1151 | |||
| 1152 | @node Deleting Windows | 1090 | @node Deleting Windows |
| 1153 | @section Deleting Windows | 1091 | @section Deleting Windows |
| 1154 | @cindex deleting windows | 1092 | @cindex deleting windows |
| 1155 | 1093 | ||
| 1156 | A window remains visible on its frame unless you @dfn{delete} it by | 1094 | @dfn{Deleting} a window removes it from the frame's window tree. If |
| 1157 | calling certain functions that delete windows. A deleted window cannot | 1095 | the window is a live window, it disappears from the screen. If the |
| 1158 | appear on the screen, but continues to exist as a Lisp object until | 1096 | window is an internal window, its child windows are deleted too. |
| 1159 | there are no references to it. There is no way to cancel the deletion | 1097 | |
| 1160 | of a window aside from restoring a saved window configuration | 1098 | Even after a window is deleted, it continues to exist as a Lisp |
| 1161 | (@pxref{Window Configurations}). Restoring a window configuration also | 1099 | object, until there are no more references to it. Window deletion can |
| 1162 | deletes any windows that aren't part of that configuration. Erroneous | 1100 | be reversed, by restoring a saved window configuration (@pxref{Window |
| 1163 | information may result from using a deleted window as if it were live. | 1101 | Configurations}). |
| 1164 | 1102 | ||
| 1165 | @deffn Command delete-window &optional window | 1103 | @deffn Command delete-window &optional window |
| 1166 | This function removes @var{window} from display and returns @code{nil}. | 1104 | This function removes @var{window} from display and returns |
| 1167 | The argument @var{window} can denote any window and defaults to the | 1105 | @code{nil}. If @var{window} is omitted or @code{nil}, it defaults to |
| 1168 | selected one. An error is signaled if @var{window} is the only window | 1106 | the selected window. If deleting the window would leave no more |
| 1169 | on its frame. Hence @var{window} must have at least one sibling window | 1107 | windows in the window tree (e.g. if it is the only live window in the |
| 1170 | (@pxref{Windows and Frames}) in order to get deleted. If @var{window} | 1108 | frame), an error is signaled. |
| 1171 | is the selected window on its frame, this function selects the most | 1109 | |
| 1172 | recently selected live window on that frame instead. | 1110 | By default, the space taken up by @var{window} is given to one of its |
| 1173 | 1111 | adjacent sibling windows, if any. However, if the variable | |
| 1174 | If the variable @code{ignore-window-parameters} (@pxref{Window | 1112 | @code{window-combination-resize} is non-@code{nil}, the space is |
| 1175 | Parameters}) is non-@code{nil}, this function ignores all parameters of | 1113 | proportionally distributed among any remaining windows in the window |
| 1176 | @var{window}. Otherwise, if the @code{delete-window} parameter of | 1114 | combination. @xref{Splitting Windows}. |
| 1177 | @var{window} is @code{t}, it deletes the window disregarding other | 1115 | |
| 1178 | window parameters. If the @code{delete-window} parameter specifies a | 1116 | The behavior of this function may be altered by the window parameters |
| 1179 | function, that function is called with @var{window} as its sole | 1117 | of @var{window}, so long as the variable |
| 1180 | argument. | 1118 | @code{ignore-window-parameters} is non-@code{nil}. If the value of |
| 1181 | 1119 | the @code{delete-window} window parameter is @code{t}, this function | |
| 1182 | If @code{window-splits} (@pxref{Splitting Windows}) is @code{nil}, the | 1120 | ignores all other window parameters. Otherwise, if the value of the |
| 1183 | space @var{window} took up is given to its left sibling if such a window | 1121 | @code{delete-window} window parameter is a function, that function is |
| 1184 | exists and to its right sibling otherwise. If @code{window-splits} is | 1122 | called with the argument @var{window}, in lieu of the usual action of |
| 1185 | non-@code{nil}, the space of @var{window} is proportionally distributed | 1123 | @code{delete-window}. Otherwise, this function obeys the |
| 1186 | among the remaining windows in the same combination. | 1124 | @code{window-atom} or @code{window-side} window parameter, if any. |
| 1125 | @xref{Window Parameters}. | ||
| 1187 | @end deffn | 1126 | @end deffn |
| 1188 | 1127 | ||
| 1189 | @deffn Command delete-other-windows &optional window | 1128 | @deffn Command delete-other-windows &optional window |
| 1190 | This function makes @var{window} fill its frame and returns @code{nil}. | 1129 | This function makes @var{window} fill its frame, by deleting other |
| 1191 | The argument @var{window} can denote an arbitrary window and defaults to | 1130 | windows as necessary. If @var{window} is omitted or @code{nil}, it |
| 1192 | the selected one. Upon exit, @var{window} will be the selected window | 1131 | defaults to the selected window. The return value is @code{nil}. |
| 1193 | on its frame. | 1132 | |
| 1194 | 1133 | The behavior of this function may be altered by the window parameters | |
| 1195 | If the variable @code{ignore-window-parameters} (@pxref{Window | 1134 | of @var{window}, so long as the variable |
| 1196 | Parameters}) is non-@code{nil}, this function ignores all parameters of | 1135 | @code{ignore-window-parameters} is non-@code{nil}. If the value of |
| 1197 | @var{window}. Otherwise, if the @code{delete-other-windows} parameter | 1136 | the @code{delete-other-windows} window parameter is @code{t}, this |
| 1198 | of @var{window} equals @code{t}, it deletes all other windows | 1137 | function ignores all other window parameters. Otherwise, if the value |
| 1199 | disregarding any remaining window parameters. If the | 1138 | of the @code{delete-other-windows} window parameter is a function, |
| 1200 | @code{delete-other-windows} parameter of @var{window} specifies a | 1139 | that function is called with the argument @var{window}, in lieu of the |
| 1201 | function, it calls that function with @var{window} as its sole argument. | 1140 | usual action of @code{delete-other-windows}. Otherwise, this function |
| 1141 | obeys the @code{window-atom} or @code{window-side} window parameter, | ||
| 1142 | if any. @xref{Window Parameters}. | ||
| 1202 | @end deffn | 1143 | @end deffn |
| 1203 | 1144 | ||
| 1204 | @deffn Command delete-windows-on &optional buffer-or-name frame | 1145 | @deffn Command delete-windows-on &optional buffer-or-name frame |
| 1205 | This function deletes all windows showing @var{buffer-or-name}. If | 1146 | This function deletes all windows showing @var{buffer-or-name}, by |
| 1206 | there are no windows showing @var{buffer-or-name}, it does nothing. | 1147 | calling @code{delete-window} on those windows. @var{buffer-or-name} |
| 1207 | The optional argument @var{buffer-or-name} may be a buffer or the name | 1148 | should be a buffer, or the name of a buffer; if omitted or @code{nil}, |
| 1208 | of an existing buffer and defaults to the current buffer. Invoking | 1149 | it defaults to the current buffer. If there are no windows showing |
| 1209 | this command on a minibuffer signals an error. | 1150 | the specified buffer, this function does nothing. If the specified |
| 1210 | 1151 | buffer is a minibuffer, an error is signaled. | |
| 1211 | The function @code{delete-windows-on} operates by calling | 1152 | |
| 1212 | @code{delete-window} for each window showing @var{buffer-or-name}. If a | 1153 | If there is a dedicated window showing the buffer, and that window is |
| 1213 | frame has several windows showing different buffers, then those showing | 1154 | the only one on its frame, this function also deletes that frame if it |
| 1214 | @var{buffer-or-name} are removed, and the other windows expand to fill | 1155 | is not the only frame on the terminal. |
| 1215 | the space. | 1156 | |
| 1216 | 1157 | The optional argument @var{frame} specifies which frames to operate | |
| 1217 | If all windows in some frame are showing @var{buffer-or-name} (including | 1158 | on: |
| 1218 | the case where there is only one window), then that frame is deleted | ||
| 1219 | provided there are other frames left. | ||
| 1220 | |||
| 1221 | The optional argument @var{frame} specifies which frames to operate on. | ||
| 1222 | This function does not use it in quite the same way as the other | ||
| 1223 | functions which scan all live windows (@pxref{Cyclic Window Ordering}); | ||
| 1224 | specifically, the values @code{t} and @code{nil} have the opposite of | ||
| 1225 | their meanings in the other functions. Here are the full details: | ||
| 1226 | 1159 | ||
| 1227 | @itemize @bullet | 1160 | @itemize @bullet |
| 1228 | @item @code{nil} | 1161 | @item @code{nil} |
| @@ -1236,34 +1169,37 @@ means operate on all visible or iconified frames. | |||
| 1236 | @item A frame | 1169 | @item A frame |
| 1237 | means operate on that frame. | 1170 | means operate on that frame. |
| 1238 | @end itemize | 1171 | @end itemize |
| 1239 | @end deffn | ||
| 1240 | 1172 | ||
| 1173 | Note that this argument does not have the same meaning as in other | ||
| 1174 | functions which scan all live windows (@pxref{Cyclic Window | ||
| 1175 | Ordering}). Specifically, the values @code{t} and @code{nil} have the | ||
| 1176 | opposite of their meanings in those other functions. | ||
| 1177 | @end deffn | ||
| 1241 | 1178 | ||
| 1242 | @node Selecting Windows | 1179 | @node Selecting Windows |
| 1243 | @section Selecting Windows | 1180 | @section Selecting Windows |
| 1244 | @cindex selecting a window | 1181 | @cindex selecting a window |
| 1245 | 1182 | ||
| 1246 | @defun select-window window &optional norecord | 1183 | @defun select-window window &optional norecord |
| 1247 | This function makes @var{window} the selected window, see @ref{Basic | 1184 | This function makes @var{window} the selected window, as well as the |
| 1248 | Windows}. Unless @var{window} already is the selected window, this also | 1185 | window selected within its frame (@pxref{Basic Windows}). |
| 1249 | makes @var{window}'s buffer (@pxref{Buffers and Windows}) the current | 1186 | @var{window} must be a live winow. Unless @var{window} already is the |
| 1250 | buffer. Moreover, the cursor for selected windows will be displayed in | 1187 | selected window, its buffer becomes the current buffer (@pxref{Buffers |
| 1251 | @var{window} after the next redisplay. This function returns | 1188 | and Windows}). The return value is @var{window}. |
| 1252 | @var{window}. | ||
| 1253 | 1189 | ||
| 1254 | Normally, @var{window}'s selected buffer is moved to the front of the | 1190 | By default, this function also moves @var{window}'s selected buffer to |
| 1255 | buffer list (@pxref{The Buffer List}) and @var{window} becomes the most | 1191 | the front of the buffer list (@pxref{The Buffer List}), and makes |
| 1256 | recently selected window. But if the optional argument @var{norecord} | 1192 | @var{window} the most recently selected window. However, if the |
| 1257 | is non-@code{nil}, the buffer list remains unchanged and @var{window} | 1193 | optional argument @var{norecord} is non-@code{nil}, these additional |
| 1258 | does not become the most recently selected one. | 1194 | actions are omitted. |
| 1259 | @end defun | 1195 | @end defun |
| 1260 | 1196 | ||
| 1261 | @cindex most recently selected windows | 1197 | @cindex most recently selected windows |
| 1262 | The sequence of calls to @code{select-window} with a non-@code{nil} | 1198 | The sequence of calls to @code{select-window} with a non-@code{nil} |
| 1263 | @var{norecord} argument determines an ordering of windows by their | 1199 | @var{norecord} argument determines an ordering of windows by their |
| 1264 | selection time. The function @code{get-lru-window} can be used to | 1200 | selection time. The function @code{get-lru-window} can be used to |
| 1265 | retrieve the least recently selected live window in this ordering, see | 1201 | retrieve the least recently selected live window (@pxref{Cyclic Window |
| 1266 | @ref{Cyclic Window Ordering}. | 1202 | Ordering}). |
| 1267 | 1203 | ||
| 1268 | @defmac save-selected-window forms@dots{} | 1204 | @defmac save-selected-window forms@dots{} |
| 1269 | This macro records the selected frame, as well as the selected window | 1205 | This macro records the selected frame, as well as the selected window |
| @@ -1295,33 +1231,26 @@ The order of recently selected windows and the buffer list are not | |||
| 1295 | changed by this macro. | 1231 | changed by this macro. |
| 1296 | @end defmac | 1232 | @end defmac |
| 1297 | 1233 | ||
| 1298 | @cindex frame selected window | 1234 | @defun frame-selected-window &optional frame |
| 1299 | @cindex window selected within frame | 1235 | This function returns the window on @var{frame} that is selected |
| 1300 | Earlier (@pxref{Basic Windows}) we mentioned that at any time, exactly | 1236 | within that frame. @var{frame} should be a live frame; if omitted or |
| 1301 | one window on any frame is selected within the frame. The significance | 1237 | @code{nil}, it defaults to the selected frame. |
| 1302 | of this designation is that selecting the frame also selects this | ||
| 1303 | window. Conversely, selecting a window for Emacs with | ||
| 1304 | @code{select-window} also makes that window selected within its frame. | ||
| 1305 | |||
| 1306 | @defun frame-selected-window &optional frame | ||
| 1307 | This function returns the window on @var{frame} that is selected within | ||
| 1308 | @var{frame}. The optional argument @var{frame} must denote a live frame | ||
| 1309 | and defaults to the selected one. | ||
| 1310 | @end defun | 1238 | @end defun |
| 1311 | 1239 | ||
| 1312 | @defun set-frame-selected-window frame window &optional norecord | 1240 | @defun set-frame-selected-window frame window &optional norecord |
| 1313 | This function sets the selected window of frame @var{frame} to | 1241 | This function makes @code{window} the window selected within the frame |
| 1314 | @var{window}. The argument @var{frame} must denote a live frame and | 1242 | @var{frame}. @var{frame} should be a live frame; if omitted or |
| 1315 | defaults to the selected one. If @var{frame} is the selected frame, | 1243 | @code{nil}, it defaults to the selected frame. @var{window} should be |
| 1316 | this also makes @var{window} the selected window. The argument | 1244 | a live window; if omitted or @code{nil}, it defaults to the selected |
| 1317 | @var{window} must denote a live window. This function returns | 1245 | window. |
| 1318 | @var{window}. | ||
| 1319 | 1246 | ||
| 1320 | Optional argument @var{norecord} non-@code{nil} means to neither change | 1247 | If @var{frame} is the selected frame, this makes @var{window} the |
| 1321 | the list of most recently selected windows (@pxref{Selecting Windows}) | 1248 | selected window. |
| 1322 | nor the buffer list (@pxref{The Buffer List}). | ||
| 1323 | @end defun | ||
| 1324 | 1249 | ||
| 1250 | If the optional argument @var{norecord} is non-@code{nil}, this | ||
| 1251 | function does not alter the list of most recently selected windows, | ||
| 1252 | nor the buffer list. | ||
| 1253 | @end defun | ||
| 1325 | 1254 | ||
| 1326 | @node Cyclic Window Ordering | 1255 | @node Cyclic Window Ordering |
| 1327 | @section Cyclic Ordering of Windows | 1256 | @section Cyclic Ordering of Windows |
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 @@ | |||
| 1 | 2011-11-16 Juanma Barranquero <lekktu@gmail.com> | ||
| 2 | |||
| 3 | * etags.1: Fix typo. | ||
| 4 | |||
| 1 | 2011-10-06 Chong Yidong <cyd@stupidchicken.com> | 5 | 2011-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 | ||
| 21 | 2011-01-02 Jari Aalto <jari.aalto@cante.net> (tiny change) | 25 | 2011-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 |
| 50 | the syntax of C, Objective C, C++, Java, Fortran, Ada, Cobol, Erlang, | 50 | the syntax of C, Objective C, C++, Java, Fortran, Ada, Cobol, Erlang, |
| 51 | Forth, HTML, LaTeX, Emacs Lisp/Common Lisp, Lua, Makefile, Pascal, Perl, | 51 | Forth, HTML, LaTeX, Emacs Lisp/Common Lisp, Lua, Makefile, Pascal, Perl, |
| 52 | PHP, Postscript, Python, Prolog, Scheme and | 52 | PHP, PostScript, Python, Prolog, Scheme and |
| 53 | most assembler\-like syntaxes. | 53 | most assembler\-like syntaxes. |
| 54 | Both forms read the files specified on the command line, and write a tag | 54 | Both forms read the files specified on the command line, and write a tag |
| 55 | table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for | 55 | table (defaults: \fBTAGS\fP for \fBetags\fP, \fBtags\fP for |
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index af8d38a077f..924f3501bfa 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,18 @@ | |||
| 1 | 2011-11-16 Juanma Barranquero <lekktu@gmail.com> | ||
| 2 | |||
| 3 | * org.texi (Agenda commands, Exporting Agenda Views): Fix typos. | ||
| 4 | |||
| 5 | 2011-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 | |||
| 11 | 2011-11-14 Juanma Barranquero <lekktu@gmail.com> | ||
| 12 | |||
| 13 | * ediff.texi (Hooks): | ||
| 14 | * sem-user.texi (Semanticdb Roots): Fix typos. | ||
| 15 | |||
| 1 | 2011-11-11 Juanma Barranquero <lekktu@gmail.com> | 16 | 2011-11-11 Juanma Barranquero <lekktu@gmail.com> |
| 2 | 17 | ||
| 3 | * semantic.texi (Tag handling): Fix typo. | 18 | * semantic.texi (Tag handling): Fix typo. |
| @@ -62,7 +77,7 @@ | |||
| 62 | 77 | ||
| 63 | Release MH-E manual version 8.3. | 78 | Release MH-E manual version 8.3. |
| 64 | 79 | ||
| 65 | * mh-e.texi: (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for | 80 | * mh-e.texi (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for |
| 66 | release 8.3. | 81 | release 8.3. |
| 67 | (Preface): Updated support information. | 82 | (Preface): Updated support information. |
| 68 | (From Bill Wohler): Reset text to original version. As a | 83 | (From Bill Wohler): Reset text to original version. As a |
| @@ -300,7 +315,7 @@ | |||
| 300 | 315 | ||
| 301 | 2011-08-15 Eric Schulte <schulte.eric@gmail.com> | 316 | 2011-08-15 Eric Schulte <schulte.eric@gmail.com> |
| 302 | 317 | ||
| 303 | * org.texi (Evaluating code blocks): Expanded discussion of | 318 | * org.texi (Evaluating code blocks): Expanded discussion of |
| 304 | #+call: line syntax. | 319 | #+call: line syntax. |
| 305 | (Header arguments in function calls): Expanded discussion of | 320 | (Header arguments in function calls): Expanded discussion of |
| 306 | #+call: line syntax. | 321 | #+call: line syntax. |
| @@ -2294,7 +2309,7 @@ | |||
| 2294 | 2009-08-25 Michael Albinus <michael.albinus@gmx.de> | 2309 | 2009-08-25 Michael Albinus <michael.albinus@gmx.de> |
| 2295 | 2310 | ||
| 2296 | * dbus.texi (Bus names): Add optional parameter TIMEOUT to dbus-ping. | 2311 | * dbus.texi (Bus names): Add optional parameter TIMEOUT to dbus-ping. |
| 2297 | Describe autostart behaviour of dbus-ping. | 2312 | Describe autostart behavior of dbus-ping. |
| 2298 | (Synchronous Methods, Asynchronous Methods): Use English numeric format | 2313 | (Synchronous Methods, Asynchronous Methods): Use English numeric format |
| 2299 | for timeout values. | 2314 | for timeout values. |
| 2300 | (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..0eb20d01324 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 | |||
| 184 | names, and the extension for specs and bodies are | 184 | names, and the extension for specs and bodies are |
| 185 | @samp{.ads} and @samp{.adb}, respectively. | 185 | @samp{.ads} and @samp{.adb}, respectively. |
| 186 | 186 | ||
| 187 | Ada mode uses the file extentions to allow moving from a package body | 187 | Ada mode uses the file extensions to allow moving from a package body |
| 188 | to the corresponding spec and back. | 188 | to the corresponding spec and back. |
| 189 | 189 | ||
| 190 | Ada mode supports a list of alternative file extensions for specs and bodies. | 190 | Ada 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 | |||
| 209 | that ends with either @file{.adb}, @file{_b.ada} or | 209 | that ends with either @file{.adb}, @file{_b.ada} or |
| 210 | @file{.body}. | 210 | @file{.body}. |
| 211 | 211 | ||
| 212 | Simililarly, if Ada mode is looking for a spec, it will look for | 212 | Similarly, 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 | ||
| 215 | If the filename is not derived from the Ada name following the GNAT | 215 | If 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 | |||
| 1357 | included, separated from the word by a space. | 1357 | included, separated from the word by a space. |
| 1358 | 1358 | ||
| 1359 | If the word starts with an asterisk (@key{*}), it defines the casing | 1359 | If the word starts with an asterisk (@key{*}), it defines the casing |
| 1360 | af a word fragemnt (or ``substring''); part of a word between two | 1360 | as a word fragment (or ``substring''); part of a word between two |
| 1361 | underscores or word boundary. | 1361 | underscores or word boundary. |
| 1362 | 1362 | ||
| 1363 | For example: | 1363 | For example: |
diff --git a/doc/misc/autotype.texi b/doc/misc/autotype.texi index 2e66c78a3cb..ecf4c7e47b2 100644 --- a/doc/misc/autotype.texi +++ b/doc/misc/autotype.texi | |||
| @@ -156,7 +156,7 @@ the point is normally left after that skeleton is inserted (@pxref{Using | |||
| 156 | Skeletons}). The point (@pxref{(emacs)Point}) is left at the next | 156 | Skeletons}). The point (@pxref{(emacs)Point}) is left at the next |
| 157 | interesting spot in the skeleton instead. | 157 | interesting spot in the skeleton instead. |
| 158 | 158 | ||
| 159 | A negative prefix means to do something similar with that many precedingly | 159 | A negative prefix means to do something similar with that many previously |
| 160 | marked interregions (@pxref{(emacs)Mark}). In the simplest case, if you type | 160 | marked interregions (@pxref{(emacs)Mark}). In the simplest case, if you type |
| 161 | @kbd{M--} just before issuing the skeleton command, that will wrap the | 161 | @kbd{M--} just before issuing the skeleton command, that will wrap the |
| 162 | skeleton around the current region, just like a positive argument would have | 162 | skeleton around the current region, just like a positive argument would have |
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index 5a1ee872a2b..56f6b64c20b 100644 --- a/doc/misc/calc.texi +++ b/doc/misc/calc.texi | |||
| @@ -10666,7 +10666,7 @@ and displayed in any radix just like integers and fractions. Since a | |||
| 10666 | float that is entered in a radix other that 10 will be converted to | 10666 | float that is entered in a radix other that 10 will be converted to |
| 10667 | decimal, the number that Calc stores may not be exactly the number that | 10667 | decimal, the number that Calc stores may not be exactly the number that |
| 10668 | was entered, it will be the closest decimal approximation given the | 10668 | was entered, it will be the closest decimal approximation given the |
| 10669 | current precison. The notation @samp{@var{radix}#@var{ddd}.@var{ddd}} | 10669 | current precision. The notation @samp{@var{radix}#@var{ddd}.@var{ddd}} |
| 10670 | is a floating-point number whose digits are in the specified radix. | 10670 | is a floating-point number whose digits are in the specified radix. |
| 10671 | Note that the @samp{.} is more aptly referred to as a ``radix point'' | 10671 | Note that the @samp{.} is more aptly referred to as a ``radix point'' |
| 10672 | than as a decimal point in this case. The number @samp{8#123.4567} is | 10672 | than as a decimal point in this case. The number @samp{8#123.4567} is |
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 | ||
| 288 | Styles | 288 | Styles |
| 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 | ||
| 296 | Customizing Auto-newlines | 296 | Customizing Auto-newlines |
| 297 | 297 | ||
| @@ -311,19 +311,19 @@ Indentation Engine Basics | |||
| 311 | 311 | ||
| 312 | Syntactic Symbols | 312 | Syntactic 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 | ||
| 328 | Customizing Indentation | 328 | Customizing Indentation |
| 329 | 329 | ||
| @@ -343,8 +343,8 @@ Line-Up Functions | |||
| 343 | 343 | ||
| 344 | Customizing Macros | 344 | Customizing 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 | |||
| 912 | function beginnings or ends inside the current declaration scope, it | 912 | function beginnings or ends inside the current declaration scope, it |
| 913 | will search the enclosing scopes. If you want @ccmode to recognize | 913 | will search the enclosing scopes. If you want @ccmode to recognize |
| 914 | functions only at the top level@footnote{this was @ccmode{}'s | 914 | functions only at the top level@footnote{this was @ccmode{}'s |
| 915 | behaviour prior to version 5.32.}, set @code{c-defun-tatic} to | 915 | behavior prior to version 5.32.}, set @code{c-defun-tatic} to |
| 916 | @code{t}. | 916 | @code{t}. |
| 917 | 917 | ||
| 918 | These functions are analogous to the Emacs built-in commands | 918 | These 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}, | |||
| 1173 | and @ref{Indentation Engine Basics}. | 1173 | and @ref{Indentation Engine Basics}. |
| 1174 | 1174 | ||
| 1175 | You can toggle each of these minor modes on and off, and you can | 1175 | You can toggle each of these minor modes on and off, and you can |
| 1176 | configure @ccmode{} so that it starts up with your favourite | 1176 | configure @ccmode{} so that it starts up with your favorite |
| 1177 | combination of them (@pxref{Sample .emacs File}). By default, when | 1177 | combination of them (@pxref{Sample .emacs File}). By default, when |
| 1178 | you initialize a buffer, electric mode and syntactic-indentation mode | 1178 | you initialize a buffer, electric mode and syntactic-indentation mode |
| 1179 | are enabled but the other two modes are disabled. | 1179 | are enabled but the other two modes are disabled. |
| @@ -2537,11 +2537,11 @@ As an alternative to writing a style definition yourself, you can have | |||
| 2537 | already formatted piece of your code, @ref{Guessing the Style}. | 2537 | already 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..88b068ccd5b 100644 --- a/doc/misc/dbus.texi +++ b/doc/misc/dbus.texi | |||
| @@ -332,7 +332,7 @@ Example: | |||
| 332 | @code{method}, @code{signal}, and @code{property} elements. Unlike | 332 | @code{method}, @code{signal}, and @code{property} elements. Unlike |
| 333 | properties, which can change their values during lifetime of a D-Bus | 333 | properties, which can change their values during lifetime of a D-Bus |
| 334 | object, annotations are static. Often they are used for code | 334 | object, annotations are static. Often they are used for code |
| 335 | generators of D-Bus langugae bindings. Example: | 335 | generators of D-Bus language bindings. Example: |
| 336 | 336 | ||
| 337 | @example | 337 | @example |
| 338 | <annotation name="de.berlios.Pinot.GetStatistics" value="pinotDBus"/> | 338 | <annotation name="de.berlios.Pinot.GetStatistics" value="pinotDBus"/> |
| @@ -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 | ||
| 556 | Methods and signals are the communicatione means to D-Bus. The | 556 | Methods and signals are the communication means to D-Bus. The |
| 557 | following functions return their specifications. | 557 | following 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/dired-x.texi b/doc/misc/dired-x.texi index 99530e6356d..a026c63e25b 100644 --- a/doc/misc/dired-x.texi +++ b/doc/misc/dired-x.texi | |||
| @@ -476,7 +476,7 @@ in your @code{dired-mode-hook}. | |||
| 476 | This Dired-X feature is obsolete as of Emacs 24.1. The standard Emacs | 476 | This Dired-X feature is obsolete as of Emacs 24.1. The standard Emacs |
| 477 | directory local variables mechanism (@pxref{Directory | 477 | directory local variables mechanism (@pxref{Directory |
| 478 | Variables,,,emacs,The Gnu Emacs manual}) replaces it. For an example of | 478 | Variables,,,emacs,The Gnu Emacs manual}) replaces it. For an example of |
| 479 | the new mechanims, @pxref{Omitting Variables}. | 479 | the new mechanisms, @pxref{Omitting Variables}. |
| 480 | 480 | ||
| 481 | When Dired visits a directory, it looks for a file whose name is the | 481 | When Dired visits a directory, it looks for a file whose name is the |
| 482 | value of variable @code{dired-local-variables-file} (default: @file{.dired}). | 482 | value of variable @code{dired-local-variables-file} (default: @file{.dired}). |
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. |
| 520 | Return nil if there isn't one." | 520 | Return 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 |
| 3276 | Default target t- use when compling a texinfo file. | 3276 | Default 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)} @* | |||
| 3370 | Default Value: @code{nil} | 3370 | Default Value: @code{nil} |
| 3371 | 3371 | ||
| 3372 | Emacs regex matching auxiliary source code this target accepts. | 3372 | Emacs regex matching auxiliary source code this target accepts. |
| 3373 | Aux source are source code files needed for compilation, which are not comiled | 3373 | Aux source are source code files needed for compilation, which are not compiled |
| 3374 | themselves. | 3374 | themselves. |
| 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 |
| 1208 | run right after the default bindings are set but before | 1208 | run 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 |
| 1210 | hook---it is provided for implementors of other Emacs packages built on top | 1210 | hook---it is provided for implementers of other Emacs packages built on top |
| 1211 | of Ediff. | 1211 | of 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 | ||
| 1049 | You can customize the value of the @code{mml-enable-flowed} variable | 1049 | You can customize the value of the @code{mml-enable-flowed} variable |
| 1050 | to enable or disable the flowed encoding usage when newline | 1050 | to enable or disable the flowed encoding usage when newline |
| 1051 | characteres are present in the buffer. | 1051 | characters are present in the buffer. |
| 1052 | 1052 | ||
| 1053 | On decoding flowed text, lines with soft newline characters are filled | 1053 | On decoding flowed text, lines with soft newline characters are filled |
| 1054 | together and wrapped after the column decided by | 1054 | together 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} |
| 390 | is optional; if absent, any type of error is accepted. | 390 | is 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 |
| 392 | signalled, to allow additional checks to be made. The error | 392 | signaled, to allow additional checks to be made. The error |
| 393 | description has the format @code{(ERROR-SYMBOL . DATA)}. | 393 | description has the format @code{(ERROR-SYMBOL . DATA)}. |
| 394 | 394 | ||
| 395 | There is no @code{should-not-error} macro since tests that signal an | 395 | There is no @code{should-not-error} macro since tests that signal an |
| @@ -748,7 +748,7 @@ explanation function. | |||
| 748 | 748 | ||
| 749 | Both @code{ert-run-tests-interactively} and @code{ert-run-tests-batch} | 749 | Both @code{ert-run-tests-interactively} and @code{ert-run-tests-batch} |
| 750 | are implemented on top of the lower-level test handling code in the | 750 | are implemented on top of the lower-level test handling code in the |
| 751 | sections of @file{ert.el} labelled ``Facilities for running a single test'', | 751 | sections 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 | ||
| 754 | If you want to write code that works with ERT tests, you should take a | 754 | If 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..b0090f0fb84 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi | |||
| @@ -61,7 +61,7 @@ developing GNU and promoting software freedom.'' | |||
| 61 | @node Top, What is Eshell?, (dir), (dir) | 61 | @node Top, What is Eshell?, (dir), (dir) |
| 62 | @top Eshell | 62 | @top Eshell |
| 63 | 63 | ||
| 64 | Eshell is a shell-like command interpretor | 64 | Eshell is a shell-like command interpreter |
| 65 | implemented in Emacs Lisp. It invokes no external processes except for | 65 | implemented in Emacs Lisp. It invokes no external processes except for |
| 66 | those requested by the user. It is intended to be a functional | 66 | those requested by the user. It is intended to be a functional |
| 67 | replacement for command shells such as @command{bash}, @command{zsh}, | 67 | replacement for command shells such as @command{bash}, @command{zsh}, |
| @@ -379,7 +379,7 @@ eshell/sudo is a compiled Lisp function in `em-unix.el' | |||
| 379 | sudo is an alias, defined as "*sudo $*" | 379 | sudo is an alias, defined as "*sudo $*" |
| 380 | @end example | 380 | @end example |
| 381 | 381 | ||
| 382 | Some of the built-in commands have a special behaviour in Eshell: | 382 | Some 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. | |||
| 368 | There has never been a copyright infringement case involving the GPL to | 368 | There has never been a copyright infringement case involving the GPL to |
| 369 | set any precedents. Although legal actions have been brought against | 369 | set any precedents. Although legal actions have been brought against |
| 370 | companies for violating the terms of the GPL, so far all have been | 370 | companies for violating the terms of the GPL, so far all have been |
| 371 | settled out of court (in favour of the plaintiffs). Please take any | 371 | settled out of court (in favor of the plaintiffs). Please take any |
| 372 | discussion regarding this issue to the newsgroup | 372 | discussion 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 |
| 374 | flame wars on the subject. | 374 | flame 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 | ||
| 38 | This is the new Gnus Frequently Asked Questions list. | 38 | This is the new Gnus Frequently Asked Questions list. |
| 39 | 39 | ||
| 40 | Please submit features and suggestions to the | 40 | Please 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 | |||
| 166 | 21 is outdated). | 166 | 21 is outdated). |
| 167 | You can get the latest released version of Gnus from | 167 | You 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} |
| 169 | or via anonymous FTP from | 169 | or 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 | ||
| 179 | Untar it via @samp{tar xvzf gnus.tar.gz} and do the common | 179 | Untar 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 | ||
| 372 | I just installed Gnus, started it via | 372 | I just installed Gnus, started it via |
| 373 | @samp{M-x gnus} | 373 | @samp{M-x gnus} |
| 374 | but it only says "nntp (news) open error", what to do? | 374 | but 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. | |||
| 396 | The ~/ means the home directory where Gnus and Emacs look | 396 | The ~/ means the home directory where Gnus and Emacs look |
| 397 | for the configuration files. However, you don't really | 397 | for the configuration files. However, you don't really |
| 398 | need to know what this means, it suffices that Emacs knows | 398 | need to know what this means, it suffices that Emacs knows |
| 399 | what it means :-) You can type | 399 | what 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 |
| 402 | Emacs will open the right file for you. (It will most | 402 | Emacs will open the right file for you. (It will most |
| 403 | likely be new, and thus empty.) | 403 | likely be new, and thus empty.) |
| 404 | However, I'd discourage you from doing so, since the | 404 | However, I'd discourage you from doing so, since the |
| 405 | directory Emacs chooses will most certainly not be what | 405 | directory Emacs chooses will most certainly not be what |
| 406 | you want, so let's do it the correct way. | 406 | you want, so let's do it the correct way. |
| 407 | The first thing you've got to do is to | 407 | The first thing you've got to do is to |
| 408 | create a suitable directory (no blanks in directory name | 408 | create a suitable directory (no blanks in directory name |
| 409 | please) e.g. c:\myhome. Then you must set the environment | 409 | please) e.g. c:\myhome. Then you must set the environment |
| @@ -442,7 +442,7 @@ machine news.yourprovider.net login YourUserName password YourPassword | |||
| 442 | . | 442 | . |
| 443 | Make sure that the file isn't readable to others if you | 443 | Make sure that the file isn't readable to others if you |
| 444 | work on a OS which is capable of doing so. (Under Unix | 444 | work on a OS which is capable of doing so. (Under Unix |
| 445 | say | 445 | say |
| 446 | @example | 446 | @example |
| 447 | chmod 600 ~/.authinfo | 447 | chmod 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 | ||
| 478 | Some providers allow restricted anonymous access and full | 478 | Some providers allow restricted anonymous access and full |
| 479 | access only after authorization. To make Gnus send authinfo | 479 | access only after authorization. To make Gnus send authinfo |
| 480 | to those servers append | 480 | to those servers append |
| 481 | 481 | ||
| 482 | @example | 482 | @example |
| 483 | force yes | 483 | force yes |
| 484 | @end example | 484 | @end example |
| 485 | @noindent | 485 | @noindent |
| 486 | 486 | ||
| 487 | to the line for those servers in ~/.authinfo. | 487 | to 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 | ||
| 777 | If you enter the group by saying | 777 | If you enter the group by saying |
| 778 | @samp{RET} | 778 | @samp{RET} |
| 779 | in group buffer with point over the group, only unread and ticked messages are loaded. Say | 779 | in 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 | ||
| 791 | in ~/.gnus.el to load enough old articles to prevent teared threads, replace 'some with t to load | 791 | in ~/.gnus.el to load enough old articles to prevent teared threads, replace 'some with t to load |
| 792 | all articles (Warning: Both settings enlarge the amount of data which is | 792 | all articles (Warning: Both settings enlarge the amount of data which is |
| 793 | fetched when you enter a group and slow down the process of entering a group). | 793 | fetched when you enter a group and slow down the process of entering a group). |
| 794 | 794 | ||
| 795 | If you already use Gnus 5.10, you can say | 795 | If you already use Gnus 5.10, you can say |
| 796 | @samp{/o N} | 796 | @samp{/o N} |
| 797 | In summary buffer to load the last N messages, this feature is not available in 5.8.8 | 797 | In summary buffer to load the last N messages, this feature is not available in 5.8.8 |
| 798 | 798 | ||
| 799 | If you don't want all old messages, but the parent of the message you're just reading, | 799 | If 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 | ||
| 825 | Say @samp{t} | 825 | Say @samp{t} |
| 826 | to show all headers, one more | 826 | to show all headers, one more |
| 827 | @samp{t} | 827 | @samp{t} |
| 828 | hides them again. | 828 | hides 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 | ||
| 837 | Say | 837 | Say |
| 838 | @samp{C-u g} | 838 | @samp{C-u g} |
| 839 | to show the raw message | 839 | to show the raw message |
| 840 | @samp{g} | 840 | @samp{g} |
| 841 | returns to normal view. | 841 | returns 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 - | |||
| 1042 | lowest-article-number = total-number-of-articles". This | 1042 | lowest-article-number = total-number-of-articles". This |
| 1043 | works OK for Usenet groups, but if you delete and move | 1043 | works OK for Usenet groups, but if you delete and move |
| 1044 | many messages in mail groups, this fails. To cure the | 1044 | many messages in mail groups, this fails. To cure the |
| 1045 | symptom, enter the group via @samp{C-u RET} | 1045 | symptom, enter the group via @samp{C-u RET} |
| 1046 | (this makes Gnus get all messages), then | 1046 | (this makes Gnus get all messages), then |
| 1047 | hit @samp{M P b} to mark all messages and | 1047 | hit @samp{M P b} to mark all messages and |
| 1048 | then say @samp{B m name.of.group} to move | 1048 | then say @samp{B m name.of.group} to move |
| @@ -1162,7 +1162,7 @@ general rule (regular expression .*) which denotes where | |||
| 1162 | articles should go which don't match any other rule. If | 1162 | articles should go which don't match any other rule. If |
| 1163 | the folder doesn't exist yet, it will be created as soon | 1163 | the folder doesn't exist yet, it will be created as soon |
| 1164 | as an article lands there. By default the mail will be | 1164 | as an article lands there. By default the mail will be |
| 1165 | send to all groups whose rules match. If you | 1165 | send to all groups whose rules match. If you |
| 1166 | don't want that (you probably don't want), say | 1166 | don'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 | |||
| 1393 | first thing to do is to make sure that you've got either | 1393 | first 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} |
| 1395 | or @uref{http://aspell.sourceforge.net/, aspell} | 1395 | or @uref{http://aspell.sourceforge.net/, aspell} |
| 1396 | installed and in your Path. Then you need | 1396 | installed 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} |
| 1398 | and for on-the-fly spell-checking | 1398 | and 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}. |
| 1400 | Ispell.el is shipped with Emacs and available through the XEmacs package system, | 1400 | Ispell.el is shipped with Emacs and available through the XEmacs package system, |
| 1401 | flyspell.el is shipped with Emacs and part of XEmacs text-modes package which is | 1401 | flyspell.el is shipped with Emacs and part of XEmacs text-modes package which is |
| 1402 | available through the package system, so there should be no need to install them | 1402 | available through the package system, so there should be no need to install them |
| 1403 | manually. | 1403 | manually. |
| 1404 | 1404 | ||
| 1405 | Ispell.el assumes you use ispell, if you choose aspell say | 1405 | Ispell.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 | ||
| 1412 | in your Emacs configuration file. | 1412 | in your Emacs configuration file. |
| 1413 | 1413 | ||
| 1414 | If you want your outgoing messages to be spell-checked, say | 1414 | If 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 | ||
| 1449 | in ~/.gnus.el. Change "^de\\." and "deutsch8" to something | 1449 | in ~/.gnus.el. Change "^de\\." and "deutsch8" to something |
| 1450 | that suits your needs. | 1450 | that suits your needs. |
| 1451 | 1451 | ||
| @@ -1472,7 +1472,7 @@ cause Gnus to insert the full address for you. See the | |||
| 1472 | node "Mail Aliases" in Message (not Gnus) manual for | 1472 | node "Mail Aliases" in Message (not Gnus) manual for |
| 1473 | details. | 1473 | details. |
| 1474 | 1474 | ||
| 1475 | However, what you really want is the Insidious Big Brother | 1475 | However, what you really want is the Insidious Big Brother |
| 1476 | Database bbdb. Get it through the XEmacs package system or from | 1476 | Database 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}. |
| 1478 | Now place the following in ~/.gnus.el, to activate bbdb for Gnus: | 1478 | Now 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 | |||
| 1529 | Gimp), open the image you want to include, cut out the | 1529 | Gimp), open the image you want to include, cut out the |
| 1530 | relevant part, reduce color depth to 1 bit, resize to | 1530 | relevant part, reduce color depth to 1 bit, resize to |
| 1531 | 48*48 and save as bitmap. Now you should get the compface | 1531 | 48*48 and save as bitmap. Now you should get the compface |
| 1532 | package from | 1532 | package from |
| 1533 | @uref{ftp://ftp.cs.indiana.edu:/pub/faces/, this site}. | 1533 | @uref{ftp://ftp.cs.indiana.edu:/pub/faces/, this site}. |
| 1534 | and create the actual X-face by saying | 1534 | and 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 | ||
| 1542 | If you can't use compface, there's an online X-face converter at | 1542 | If 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/}. |
| 1544 | If you use MS Windows, you could also use the WinFace program from | 1544 | If 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 | ||
| 1670 | in ~/.gnus.el. If you use Gnus 5.9 or earlier, you can use this | 1670 | in ~/.gnus.el. If you use Gnus 5.9 or earlier, you can use this |
| 1671 | instead (works for newer versions as well): | 1671 | instead (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 | |||
| 1961 | when you're online. | 1961 | when you're online. |
| 1962 | 1962 | ||
| 1963 | Let's talk about Unix systems first: For the news part, | 1963 | Let's talk about Unix systems first: For the news part, |
| 1964 | the easiest solution is a small nntp server like | 1964 | the 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}, |
| 1967 | of course you can also install a full featured news | 1967 | of course you can also install a full featured news |
| 1968 | server like | 1968 | server like |
| 1969 | @uref{http://www.isc.org/products/INN/, inn}. | 1969 | @uref{http://www.isc.org/products/INN/, inn}. |
| 1970 | Then you want to fetch your Mail, popular choices | 1970 | Then you want to fetch your Mail, popular choices |
| 1971 | are @uref{http://www.catb.org/~esr/fetchmail/, fetchmail} | 1971 | are @uref{http://www.catb.org/~esr/fetchmail/, fetchmail} |
| 1972 | and @uref{http://pyropus.ca/software/getmail/, getmail}. | 1972 | and @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 | ||
| 1981 | On windows boxes I'd vote for | 1981 | On windows boxes I'd vote for |
| 1982 | @uref{http://www.tglsoft.de/, Hamster}, | 1982 | @uref{http://www.tglsoft.de/, Hamster}, |
| 1983 | it's a small freeware, open-source program which fetches | 1983 | it's a small freeware, open-source program which fetches |
| 1984 | your mail and news from remote servers and offers them | 1984 | your mail and news from remote servers and offers them |
| 1985 | to Gnus (or any other mail and/or news reader) via nntp | 1985 | to 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 | ||
| 2138 | There's the newsgroup gnu.emacs.gnus (also available as | 2138 | There'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, |
| 2140 | gmane.emacs.gnus.user}) which deals with general Gnus | 2140 | gmane.emacs.gnus.user}) which deals with general Gnus |
| 2141 | questions. If you have questions about development versions of | 2141 | questions. If you have questions about development versions of |
| 2142 | Gnus, you should better ask on the ding mailing list, see below. | 2142 | Gnus, you should better ask on the ding mailing list, see below. |
| @@ -2149,7 +2149,7 @@ de.comm.software.gnus. | |||
| 2149 | 2149 | ||
| 2150 | The ding mailing list (ding@@gnus.org) deals with development of | 2150 | The ding mailing list (ding@@gnus.org) deals with development of |
| 2151 | Gnus. You can read the ding list via NNTP, too under the name | 2151 | Gnus. 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, |
| 2153 | gmane.emacs.gnus.general} from news.gmane.org. | 2153 | gmane.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 | ||
| 2162 | Say @samp{M-x gnus-bug}, this will start | 2162 | Say @samp{M-x gnus-bug}, this will start |
| 2163 | a message to the | 2163 | a message to the |
| 2164 | @email{bugs@@gnus.org, gnus bug mailing list} | 2164 | @email{bugs@@gnus.org, gnus bug mailing list} |
| 2165 | including information about your environment which make | 2165 | including information about your environment which make |
| 2166 | it easier to help you. | 2166 | it easier to help you. |
| @@ -2237,7 +2237,7 @@ building of summary say | |||
| 2237 | 2237 | ||
| 2238 | at the bottom of your ~/.gnus.el, this will make gnus | 2238 | at the bottom of your ~/.gnus.el, this will make gnus |
| 2239 | byte-compile things like | 2239 | byte-compile things like |
| 2240 | gnus-summary-line-format. | 2240 | gnus-summary-line-format. |
| 2241 | then you could increase the value of gc-cons-threshold | 2241 | then you could increase the value of gc-cons-threshold |
| 2242 | by saying something like | 2242 | by 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 | ||
| 2258 | in ~/.gnus.el (thanks to Jesper harder for the last | 2258 | in ~/.gnus.el (thanks to Jesper harder for the last |
| 2259 | two suggestions). Finally if you are still using 5.8.8 | 2259 | two suggestions). Finally if you are still using 5.8.8 |
| 2260 | or 5.9 and experience speed problems with summary | 2260 | or 5.9 and experience speed problems with summary |
diff --git a/doc/misc/gnus-news.texi b/doc/misc/gnus-news.texi index 62c1663508b..94984e5d3c3 100644 --- a/doc/misc/gnus-news.texi +++ b/doc/misc/gnus-news.texi | |||
| @@ -107,7 +107,7 @@ EasyPG is included in Emacs 23 and available separately as well. | |||
| 107 | @itemize @bullet | 107 | @itemize @bullet |
| 108 | 108 | ||
| 109 | @item | 109 | @item |
| 110 | Symbols like @code{gcc-self} now has the same presedence rules in | 110 | Symbols like @code{gcc-self} now has the same precedence rules in |
| 111 | @code{gnus-parameters} as other ``real'' variables: The last match | 111 | @code{gnus-parameters} as other ``real'' variables: The last match |
| 112 | wins instead of the first match. | 112 | wins instead of the first match. |
| 113 | 113 | ||
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index 545306e4dc7..3bfa5a89e79 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi | |||
| @@ -7665,7 +7665,7 @@ has its own article buffer. | |||
| 7665 | This implies that it's not possible to have more than one article buffer | 7665 | This implies that it's not possible to have more than one article buffer |
| 7666 | in a group at a time. But sometimes you might want to display all the | 7666 | in a group at a time. But sometimes you might want to display all the |
| 7667 | latest emails from your mother, your father, your aunt, your uncle and | 7667 | latest emails from your mother, your father, your aunt, your uncle and |
| 7668 | your 17 cousins to coordinate the next christmas party. | 7668 | your 17 cousins to coordinate the next Christmas party. |
| 7669 | 7669 | ||
| 7670 | That's where sticky articles come in handy. A sticky article buffer | 7670 | That's where sticky articles come in handy. A sticky article buffer |
| 7671 | basically is a normal article buffer, but it won't be reused when you | 7671 | basically 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 |
| 18002 | summary line formats. @code{D} corresponds to a formatted time string | 18002 | summary line formats. @code{D} corresponds to a formatted time string |
| 18003 | for the next occurrence of the event (e.g. ``Sat, Sep 22 01, 12:00''), | 18003 | for the next occurrence of the event (e.g. ``Sat, Sep 22 01, 12:00''), |
| 18004 | while @code{d} corresponds to an approximative remaining time until the | 18004 | while @code{d} corresponds to an approximate remaining time until the |
| 18005 | next occurrence of the event (e.g. ``in 6 months, 1 week''). | 18005 | next 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 |
| 18108 | messsages for real. This means for instance that you can give | 18108 | messages for real. This means for instance that you can give |
| 18109 | appointments to anybody (provided they use Gnus and @code{nndiary}) by | 18109 | appointments to anybody (provided they use Gnus and @code{nndiary}) by |
| 18110 | sending the diary message to them as well. | 18110 | sending the diary message to them as well. |
| 18111 | @item | 18111 | @item |
| @@ -21228,7 +21228,7 @@ features (inspired by the Google search input language): | |||
| 21228 | AND, OR, and NOT are supported, and parentheses can be used to control | 21228 | AND, OR, and NOT are supported, and parentheses can be used to control |
| 21229 | operator precedence, e.g. (emacs OR xemacs) AND linux. Note that | 21229 | operator precedence, e.g. (emacs OR xemacs) AND linux. Note that |
| 21230 | operators must be written with all capital letters to be | 21230 | operators must be written with all capital letters to be |
| 21231 | recognised. Also preceding a term with a - sign is equivalent to NOT | 21231 | recognized. Also preceding a term with a - sign is equivalent to NOT |
| 21232 | term. | 21232 | term. |
| 21233 | 21233 | ||
| 21234 | @item Automatic AND queries | 21234 | @item Automatic AND queries |
| @@ -21273,7 +21273,7 @@ Gmane queries follow a simple query language: | |||
| 21273 | AND, OR, NOT (or AND NOT), and XOR are supported, and brackets can be | 21273 | AND, OR, NOT (or AND NOT), and XOR are supported, and brackets can be |
| 21274 | used to control operator precedence, e.g. (emacs OR xemacs) AND linux. | 21274 | used to control operator precedence, e.g. (emacs OR xemacs) AND linux. |
| 21275 | Note that operators must be written with all capital letters to be | 21275 | Note that operators must be written with all capital letters to be |
| 21276 | recognised. | 21276 | recognized. |
| 21277 | 21277 | ||
| 21278 | @item Required and excluded terms | 21278 | @item Required and excluded terms |
| 21279 | + and - can be used to require or exclude terms, e.g. football -american | 21279 | + and - can be used to require or exclude terms, e.g. football -american |
| @@ -26756,7 +26756,7 @@ Sudish Joseph---innumerable bug fixes. | |||
| 26756 | Ilja Weis---@file{gnus-topic.el}. | 26756 | Ilja Weis---@file{gnus-topic.el}. |
| 26757 | 26757 | ||
| 26758 | @item | 26758 | @item |
| 26759 | Steven L. Baur---lots and lots and lots of bugs detections and fixes. | 26759 | Steven L. Baur---lots and lots and lots of bug detection and fixes. |
| 26760 | 26760 | ||
| 26761 | @item | 26761 | @item |
| 26762 | Vladimir Alexiev---the refcard and reference booklets. | 26762 | Vladimir Alexiev---the refcard and reference booklets. |
| @@ -30030,7 +30030,7 @@ this: | |||
| 30030 | @subsection Score File Syntax | 30030 | @subsection Score File Syntax |
| 30031 | 30031 | ||
| 30032 | Score files are meant to be easily parseable, but yet extremely | 30032 | Score files are meant to be easily parseable, but yet extremely |
| 30033 | mallable. It was decided that something that had the same read syntax | 30033 | malleable. It was decided that something that had the same read syntax |
| 30034 | as an Emacs Lisp list would fit that spec. | 30034 | as an Emacs Lisp list would fit that spec. |
| 30035 | 30035 | ||
| 30036 | Here's a typical score file: | 30036 | Here's a typical score file: |
diff --git a/doc/misc/message.texi b/doc/misc/message.texi index 48d0028e452..4d828f69bbd 100644 --- a/doc/misc/message.texi +++ b/doc/misc/message.texi | |||
| @@ -2120,7 +2120,7 @@ follows this line--} by default. | |||
| 2120 | 2120 | ||
| 2121 | @item message-directory | 2121 | @item message-directory |
| 2122 | @vindex message-directory | 2122 | @vindex message-directory |
| 2123 | Directory used by many mailey things. The default is @file{~/Mail/}. | 2123 | Directory used by many mailish things. The default is @file{~/Mail/}. |
| 2124 | All other mail file variables are derived from @code{message-directory}. | 2124 | All other mail file variables are derived from @code{message-directory}. |
| 2125 | 2125 | ||
| 2126 | @item message-auto-save-directory | 2126 | @item message-auto-save-directory |
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.). | |||
| 112 | Here are screen shots of the @uref{newsticker-1.7.png, version 1.7 | 112 | Here 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 |
| 164 | feeds (in tree form), a list of headlines for the current feed, and | 164 | feeds (in tree form), a list of headlines for the current feed, and |
| 165 | the content of the current headline. Feeds can be placed into groups | 165 | the content of the current headline. Feeds can be placed into groups |
| 166 | which itself can be placed in groups and so on. | 166 | which 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 |
| 168 | single buffer, called @samp{*newsticker*}. The modeline in the | 168 | single 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 |
| 172 | In both views clicking mouse-button 2 or pressing RET on a headline | 172 | In both views clicking mouse-button 2 or pressing RET on a headline |
| 173 | will call @code{browse-url} to load the corresponding news story in | 173 | will call @code{browse-url} to load the corresponding news story in |
| 174 | your favourite web browser. | 174 | your 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 |
| 208 | feeds are retrieved and how this is done. | 208 | feeds 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 |
| 244 | commands to newsticker functions. | 244 | commands 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..34a4ba4f8f3 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 | ||
| 3885 | While using a list with face properties as shown for CANCELED @emph{should} | 3885 | While using a list with face properties as shown for CANCELED @emph{should} |
| 3886 | work, this does not aways seem to be the case. If necessary, define a | 3886 | work, this does not always seem to be the case. If necessary, define a |
| 3887 | special face and use that. A string is interpreted as a color. The variable | 3887 | special 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 |
| 3889 | foreground or a background color. | 3889 | foreground 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} |
| 5665 | Insert @samp{DEADLINE} keyword along with a stamp. The insertion will happen | 5665 | Insert @samp{DEADLINE} keyword along with a stamp. The insertion will happen |
| 5666 | in the line directly following the headline. Any CLOSED timestamp will be | 5666 | in the line directly following the headline. Any CLOSED timestamp will be |
| 5667 | removed. When called with a prefix arg, an existing deadline will be removed | 5667 | removed. When called with a prefix arg, an existing deadline will be removed |
| 5668 | from the entry. Depending on the variable @code{org-log-redeadline}@footnote{with corresponding | 5668 | from 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}, |
| 5670 | and @code{nologredeadline}}, a note will be taken when changing an existing | 5670 | and @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 | ||
| 6218 | Calling @code{org-timer-set-timer} from an Org-mode buffer runs a countdown | 6218 | Calling @code{org-timer-set-timer} from an Org-mode buffer runs a countdown |
| 6219 | timer. Use @kbd{;} from agenda buffers, @key{C-c C-x ;} everwhere else. | 6219 | timer. 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 |
| 6222 | countdown timer in the modeline. @code{org-timer-default-timer} sets the | 6222 | countdown 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 | ||
| 6396 | Now lets look at the elements of a template definition. Each entry in | 6396 | Now 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 |
| 8263 | Write the agenda view to a file. Depending on the extension of the selected | 8263 | Write the agenda view to a file. Depending on the extension of the selected |
| 8264 | file name, the view will be exported as HTML (extension @file{.html} or | 8264 | file 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}), |
| 8266 | and plain text (any other extension). When called with a @kbd{C-u} prefix | 8266 | and plain text (any other extension). When called with a @kbd{C-u} prefix |
| 8267 | argument, immediately open the newly created file. Use the variable | 8267 | argument, 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. | |||
| 8477 | If you are away from your computer, it can be very useful to have a printed | 8477 | If you are away from your computer, it can be very useful to have a printed |
| 8478 | version of some agenda views to carry around. Org-mode can export custom | 8478 | version of some agenda views to carry around. Org-mode can export custom |
| 8479 | agenda views as plain text, HTML@footnote{You need to install Hrvoje Niksic's | 8479 | agenda 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 |
| 8481 | ghostscript @file{ps2pdf} utility must be installed on the system. Selecting | 8481 | ghostscript @file{ps2pdf} utility must be installed on the system. Selecting |
| 8482 | a PDF file will also create the postscript file.}, and iCalendar files. If | 8482 | a PDF file will also create the PostScript file.}, and iCalendar files. If |
| 8483 | you want to do this only occasionally, use the command | 8483 | you 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 |
| 8490 | Write the agenda view to a file. Depending on the extension of the selected | 8490 | Write the agenda view to a file. Depending on the extension of the selected |
| 8491 | file name, the view will be exported as HTML (extension @file{.html} or | 8491 | file 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 |
| 8495 | for @file{htmlize} to be used during export, for example | 8495 | for @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 |
| 8543 | the buffer to HTML and save it to this file name. If the extension is | 8543 | the 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 |
| 8545 | Postscript output. If the extension is @file{.ics}, iCalendar export is | 8545 | PostScript output. If the extension is @file{.ics}, iCalendar export is |
| 8546 | run export over all files that were used to construct the agenda, and | 8546 | run export over all files that were used to construct the agenda, and |
| 8547 | limit the export to entries listed in the agenda. Any other | 8547 | limit the export to entries listed in the agenda. Any other |
| 8548 | extension produces a plain ASCII file. | 8548 | extension 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 |
| 8576 | This command sets two options for the Postscript exporter, to make it | 8576 | This command sets two options for the PostScript exporter, to make it |
| 8577 | print in two columns in landscape format---the resulting page can be cut | 8577 | print in two columns in landscape format---the resulting page can be cut |
| 8578 | in two and then used in a paper agenda. The remaining settings modify | 8578 | in two and then used in a paper agenda. The remaining settings modify |
| 8579 | the agenda prefix to omit category and scheduling information, and | 8579 | the 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 | |||
| 9421 | broad range of other applications. @LaTeX{} export lets you use Org-mode and | 9421 | broad range of other applications. @LaTeX{} export lets you use Org-mode and |
| 9422 | its structured editing functions to easily create @LaTeX{} files. DocBook | 9422 | its structured editing functions to easily create @LaTeX{} files. DocBook |
| 9423 | export makes it possible to convert Org files to many other formats using | 9423 | export makes it possible to convert Org files to many other formats using |
| 9424 | DocBook tools. OpenDocumentText export allows seamless colloboration across | 9424 | DocBook tools. OpenDocumentText export allows seamless collaboration across |
| 9425 | organizational boundaries. For project management you can create gantt and | 9425 | organizational boundaries. For project management you can create gantt and |
| 9426 | resource charts by using TaskJuggler export. To incorporate entries with | 9426 | resource charts by using TaskJuggler export. To incorporate entries with |
| 9427 | associated times like deadlines or appointments into a desktop calendar | 9427 | associated times like deadlines or appointments into a desktop calendar |
| @@ -15533,7 +15533,7 @@ chapter about publishing. | |||
| 15533 | @i{Jambunathan K} contributed the OpenDocumentText exporter. | 15533 | @i{Jambunathan K} contributed the OpenDocumentText exporter. |
| 15534 | @item | 15534 | @item |
| 15535 | @i{Sebastien Vauban} reported many issues with LaTeX and BEAMER export and | 15535 | @i{Sebastien Vauban} reported many issues with LaTeX and BEAMER export and |
| 15536 | enabled source code highlighling in Gnus. | 15536 | enabled source code highlighting in Gnus. |
| 15537 | @item | 15537 | @item |
| 15538 | @i{Stefan Vollmar} organized a video-recorded talk at the | 15538 | @i{Stefan Vollmar} organized a video-recorded talk at the |
| 15539 | Max-Planck-Institute for Neurology. He also inspired the creation of a | 15539 | Max-Planck-Institute for Neurology. He also inspired the creation of a |
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 | |||
| 57 | user interface to encrypt, decrypt, sign, and verify MIME messages. | 57 | user 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 | ||
| 359 | Since PGG was designed for accessing and developing PGP functionality, | 359 | Since PGG was designed for accessing and developing PGP functionality, |
| 360 | the architecture had to be designed not just for interoperability but | 360 | the architecture had to be designed not just for interoperability but |
| 361 | also for extensiblity. In this chapter we explore the architecture | 361 | also for extensibility. In this chapter we explore the architecture |
| 362 | while finding out how to write the PGG back end. | 362 | while 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 | ||
| 61 | The manual is divided | 61 | The manual is divided |
| 62 | into the following chapters. | 62 | into the following chapters. |
| @@ -1877,7 +1877,7 @@ been continuously added through the comments and suggestions of the | |||
| 1877 | Supercite mailing list participants. | 1877 | Supercite mailing list participants. |
| 1878 | 1878 | ||
| 1879 | With version 3, Supercite underwent an almost complete rewrite, | 1879 | With version 3, Supercite underwent an almost complete rewrite, |
| 1880 | benefitting in a number of ways, including vast improvements in the | 1880 | benefiting in a number of ways, including vast improvements in the |
| 1881 | speed of performance, a big reduction in size of the code and in the use | 1881 | speed of performance, a big reduction in size of the code and in the use |
| 1882 | of Emacs resources, and a much cleaner and flexible internal | 1882 | of Emacs resources, and a much cleaner and flexible internal |
| 1883 | architecture. Most of this work was internal and not of very great | 1883 | architecture. 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 |
| 383 | The value of this variable is a list of directories (strings) that are | 383 | The value of this variable is a list of directories (strings) that are |
| 384 | project roots. All subdirectories of a project root are considered | 384 | project roots. All subdirectories of a project root are considered |
| 385 | part of the same project. This variable can be overriden by | 385 | part 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 | ||
| 611 | If you see an error signalled during idle time, it could be an | 611 | If you see an error signaled during idle time, it could be an |
| 612 | indication of a more serious issue elsewhere. It is not enough to | 612 | indication of a more serious issue elsewhere. It is not enough to |
| 613 | enable @code{debug-on-error}, because the idle scheduler inhibits the | 613 | enable @code{debug-on-error}, because the idle scheduler inhibits the |
| 614 | debugger. Instead, use the following commands to debug the error: | 614 | debugger. Instead, use the following commands to debug the error: |
diff --git a/doc/misc/semantic.texi b/doc/misc/semantic.texi index f6cf7a07ae8..55b60937fb6 100644 --- a/doc/misc/semantic.texi +++ b/doc/misc/semantic.texi | |||
| @@ -349,7 +349,7 @@ This file also provides support for @code{semanticdb-minor-mode}, | |||
| 349 | which automatically associates files with tables in databases so that | 349 | which automatically associates files with tables in databases so that |
| 350 | tags are @emph{saved} while a buffer is not in memory. | 350 | tags are @emph{saved} while a buffer is not in memory. |
| 351 | 351 | ||
| 352 | The database and tables both also provide applicate cache information, | 352 | The database and tables both also provide applicable cache information, |
| 353 | and cache flushing system. The semanticdb search routines use caches | 353 | and cache flushing system. The semanticdb search routines use caches |
| 354 | to save datastructures that are complex to calculate. | 354 | to save datastructures that are complex to calculate. |
| 355 | 355 | ||
| @@ -421,7 +421,7 @@ local variables, and tag lists in scope for various reasons, such as | |||
| 421 | C++ using statements. | 421 | C++ using statements. |
| 422 | 422 | ||
| 423 | @item semanticdb-typecache.el | 423 | @item semanticdb-typecache.el |
| 424 | The typecache is part of @code{semanticdb}, but is used primarilly by | 424 | The typecache is part of @code{semanticdb}, but is used primarily by |
| 425 | the analyzer to look up datatypes and complex names. The typecache is | 425 | the analyzer to look up datatypes and complex names. The typecache is |
| 426 | bound across source files and builds a master lookup table for data | 426 | bound across source files and builds a master lookup table for data |
| 427 | type names. | 427 | type names. |
| @@ -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..e6b0f4fa235 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 | |||
| 1575 | methods, or @command{pageant} for @option{plink}-like methods. | 1575 | methods, or @command{pageant} for @option{plink}-like methods. |
| 1576 | 1576 | ||
| 1577 | However, if you cannot apply such native password handling, | 1577 | However, 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} |
| @@ -3180,7 +3180,7 @@ names: | |||
| 3180 | '("^/xy" . "@trampfn{ssh, news, news.my.domain, /opt/news/etc/}")) | 3180 | '("^/xy" . "@trampfn{ssh, news, news.my.domain, /opt/news/etc/}")) |
| 3181 | @end lisp | 3181 | @end lisp |
| 3182 | 3182 | ||
| 3183 | This shortens the file openening command to @kbd{C-x C-f /xy | 3183 | This shortens the file opening command to @kbd{C-x C-f /xy |
| 3184 | @key{RET}}. The disadvantage is, again, that you cannot edit the file | 3184 | @key{RET}}. The disadvantage is, again, that you cannot edit the file |
| 3185 | name, because the expansion happens after entering the file name only. | 3185 | name, because the expansion happens after entering the file name only. |
| 3186 | 3186 | ||