diff options
Diffstat (limited to 'doc')
45 files changed, 461 insertions, 396 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index a808a96b444..b796acd8b39 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog | |||
| @@ -1,3 +1,16 @@ | |||
| 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 1cfb3d9ffe9..6801c7f1e0e 100644 --- a/doc/emacs/ack.texi +++ b/doc/emacs/ack.texi | |||
| @@ -99,7 +99,7 @@ ERC distribution). | |||
| 99 | 99 | ||
| 100 | @item | 100 | @item |
| 101 | Scott Bender, Michael Brouwer, Christophe de Dinechin, Carl Edman, | 101 | Scott Bender, Michael Brouwer, Christophe de Dinechin, Carl Edman, |
| 102 | Christian Limpach and Adrian Robert developed and maintained the | 102 | Christian Limpach and Adrian Robert developed and maintained the |
| 103 | NeXTstep port of Emacs. | 103 | NeXTstep port of Emacs. |
| 104 | 104 | ||
| 105 | @item | 105 | @item |
| @@ -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 |
| @@ -576,7 +576,7 @@ Emacs. | |||
| 576 | 576 | ||
| 577 | @item | 577 | @item |
| 578 | Karel Klí@v{c} contributed SELinux support, for preserving the | 578 | Karel Klí@v{c} contributed SELinux support, for preserving the |
| 579 | Security-Enchanced Linux context of files on backup and copy. | 579 | Security-Enhanced Linux context of files on backup and copy. |
| 580 | 580 | ||
| 581 | @item | 581 | @item |
| 582 | Shuhei Kobayashi wrote @file{hex-util.el}, for operating on hexadecimal | 582 | Shuhei Kobayashi wrote @file{hex-util.el}, for operating on hexadecimal |
diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi index cca9e441ed4..ac62e2d9652 100644 --- a/doc/emacs/building.texi +++ b/doc/emacs/building.texi | |||
| @@ -1251,7 +1251,7 @@ screen Emacs frame. | |||
| 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 cbe016ac96d..0fa50492481 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog | |||
| @@ -1,3 +1,36 @@ | |||
| 1 | 2011-11-17 Martin Rudalics <rudalics@gmx.at> | ||
| 2 | |||
| 3 | * windows.texi (Resizing Windows, Splitting Windows) | ||
| 4 | (Deleting Windows): Use term window-combination-resize instead | ||
| 5 | of window-splits. | ||
| 6 | |||
| 7 | 2011-11-16 Martin Rudalics <rudalics@gmx.at> | ||
| 8 | |||
| 9 | * windows.texi (Resizing Windows, Splitting Windows): Rename | ||
| 10 | occurrences of window-nest to window-combination-limit. | ||
| 11 | |||
| 12 | 2011-11-14 Juanma Barranquero <lekktu@gmail.com> | ||
| 13 | |||
| 14 | * intro.texi (Lisp History): Fix typo. | ||
| 15 | |||
| 16 | 2011-11-12 Martin Rudalics <rudalics@gmx.at> | ||
| 17 | |||
| 18 | * windows.texi (Splitting Windows, Deleting Windows): Remove | ||
| 19 | references to splits status of windows. | ||
| 20 | |||
| 21 | 2011-11-10 Glenn Morris <rgm@gnu.org> | ||
| 22 | |||
| 23 | * buffers.texi (Read Only Buffers): Expand a bit on why | ||
| 24 | toggle-read-only should only be used interactively. (Bug#7292) | ||
| 25 | |||
| 26 | 2011-11-09 Chong Yidong <cyd@gnu.org> | ||
| 27 | |||
| 28 | * windows.texi (Window Sizes): Document window-pixel-edges, | ||
| 29 | window-inside-pixel-edges, window-absolute-pixel-edges, and | ||
| 30 | window-inside-absolute-pixel-edges. | ||
| 31 | (Resizing Windows): shrink-window-if-larger-than-buffer works on | ||
| 32 | non-full-width windows. | ||
| 33 | |||
| 1 | 2011-11-09 Martin Rudalics <rudalics@gmx.at> | 34 | 2011-11-09 Martin Rudalics <rudalics@gmx.at> |
| 2 | 35 | ||
| 3 | * windows.texi (Resizing Windows): Rewrite documentation of | 36 | * windows.texi (Resizing Windows): Rewrite documentation of |
| @@ -1094,9 +1127,9 @@ | |||
| 1094 | * commands.texi (Misc Events): Add cross-references to where | 1127 | * commands.texi (Misc Events): Add cross-references to where |
| 1095 | POSITION of a mouse event is described in detail. | 1128 | POSITION of a mouse event is described in detail. |
| 1096 | 1129 | ||
| 1097 | 2010-08-08 Christoph <cschol2112@googlemail.com> | 1130 | 2010-08-08 Christoph Scholtes <cschol2112@googlemail.com> |
| 1098 | 1131 | ||
| 1099 | * control.texi (Handling Errors) <error-message-string>: Fix arg name. | 1132 | * control.texi (Handling Errors) <error-message-string>: Fix arg name. |
| 1100 | 1133 | ||
| 1101 | 2010-08-08 Juanma Barranquero <lekktu@gmail.com> | 1134 | 2010-08-08 Juanma Barranquero <lekktu@gmail.com> |
| 1102 | 1135 | ||
diff --git a/doc/lispref/buffers.texi b/doc/lispref/buffers.texi index 816d0f9faa8..ee2ce2e2001 100644 --- a/doc/lispref/buffers.texi +++ b/doc/lispref/buffers.texi | |||
| @@ -748,10 +748,11 @@ of the list (comparison is done with @code{eq}). | |||
| 748 | 748 | ||
| 749 | @deffn Command toggle-read-only &optional arg | 749 | @deffn Command toggle-read-only &optional arg |
| 750 | This command toggles whether the current buffer is read-only. It is | 750 | This command toggles whether the current buffer is read-only. It is |
| 751 | intended for interactive use; do not use it in programs. At any given | 751 | intended for interactive use; do not use it in programs (it may have |
| 752 | point in a program, you should know whether you want the read-only flag | 752 | side-effects, such as enabling View mode, and does not affect |
| 753 | on or off; so you can set @code{buffer-read-only} explicitly to the | 753 | read-only text properties). To change the read-only state of a buffer in |
| 754 | proper value, @code{t} or @code{nil}. | 754 | a program, explicitly set @code{buffer-read-only} to the proper value. |
| 755 | To temporarily ignore a read-only state, bind @code{inhibit-read-only}. | ||
| 755 | 756 | ||
| 756 | If @var{arg} is non-@code{nil}, it should be a raw prefix argument. | 757 | If @var{arg} is non-@code{nil}, it should be a raw prefix argument. |
| 757 | @code{toggle-read-only} sets @code{buffer-read-only} to @code{t} if | 758 | @code{toggle-read-only} sets @code{buffer-read-only} to @code{t} if |
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index 71b612c527d..86ecfd122ef 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi | |||
| @@ -2827,7 +2827,7 @@ If @code{file-remote-p} returns the same identifier for two different | |||
| 2827 | filenames, that means they are stored on the same file system and can | 2827 | filenames, that means they are stored on the same file system and can |
| 2828 | be accessed locally with respect to each other. This means, for | 2828 | be accessed locally with respect to each other. This means, for |
| 2829 | example, that it is possible to start a remote process accessing both | 2829 | example, that it is possible to start a remote process accessing both |
| 2830 | files at the same time. Implementors of file handlers need to ensure | 2830 | files at the same time. Implementers of file handlers need to ensure |
| 2831 | this principle is valid. | 2831 | this principle is valid. |
| 2832 | 2832 | ||
| 2833 | @var{identification} specifies which part of the identifier shall be | 2833 | @var{identification} specifies which part of the identifier shall be |
diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index d9399e98a69..d2e86a77112 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi | |||
| @@ -2414,7 +2414,7 @@ This function returns the ``vendor'' that provided the X server | |||
| 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/spellfile b/doc/lispref/spellfile index b373d00bebf..e66dcc88f71 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' |
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 52ac5a53900..8c99a06909b 100644 --- a/doc/lispref/windows.texi +++ b/doc/lispref/windows.texi | |||
| @@ -375,13 +375,13 @@ Bars}). At the top of the window is an optional header line | |||
| 375 | line (@pxref{Mode Line Format}). | 375 | line (@pxref{Mode Line Format}). |
| 376 | 376 | ||
| 377 | Emacs provides several functions for finding the height and width of | 377 | Emacs provides several functions for finding the height and width of |
| 378 | a window. Most of these functions report the values as integer | 378 | a window. Except where noted, these heights and widths are reported |
| 379 | multiples of the default character height and width. On a graphical | 379 | as integer numbers of lines and columns respectively. On a graphical |
| 380 | display, the actual screen size of this default height and width are | 380 | display, each ``line'' and ``column'' actually corresponds to the |
| 381 | those specified by the frame's default font. Hence, if the buffer | 381 | height and width of a ``default'' character specified by the frame's |
| 382 | contains text that is displayed in a different size, the reported | 382 | default font. Thus, if a window is displaying text with a different |
| 383 | height and width of the window may differ from the actual number of | 383 | font or size, the reported height and width for that window may differ |
| 384 | text lines or columns displayed in it. | 384 | from the actual number of text lines or columns displayed within it. |
| 385 | 385 | ||
| 386 | @cindex window height | 386 | @cindex window height |
| 387 | @cindex height of a window | 387 | @cindex height of a window |
| @@ -534,6 +534,45 @@ can be resized in the desired direction. To determine that, use the | |||
| 534 | function @code{window-resizable}. @xref{Resizing Windows}. | 534 | function @code{window-resizable}. @xref{Resizing Windows}. |
| 535 | @end defun | 535 | @end defun |
| 536 | 536 | ||
| 537 | The following functions can be used to find a window's size and | ||
| 538 | position in pixels. Though mostly useful on graphical displays, they | ||
| 539 | can also be called on text-only terminals, where the screen area of | ||
| 540 | each text character is taken to be ``one pixel''. | ||
| 541 | |||
| 542 | @defun window-pixel-edges &optional window | ||
| 543 | This function return a list of pixel coordinates for the edges of | ||
| 544 | @var{window}. If @var{window} is omitted or @code{nil}, it defaults | ||
| 545 | to the selected window. | ||
| 546 | |||
| 547 | The return value has the form @code{(@var{left} @var{top} @var{right} | ||
| 548 | @var{bottom})}. The list elements are, respectively, the X coordinate | ||
| 549 | of the left window edge, the Y coordinate of the top edge, one more | ||
| 550 | than the X coordinate of the right edge, and one more than the Y | ||
| 551 | coordinate of the bottom edge. The origin coordinate @samp{(0,0)} is | ||
| 552 | taken to be the top left corner of the frame's window area. | ||
| 553 | |||
| 554 | These edge values include the space used by the window's scroll bar, | ||
| 555 | margins, fringes, header line, and mode line, if any. | ||
| 556 | @end defun | ||
| 557 | |||
| 558 | @defun window-inside-pixel-edges &optional window | ||
| 559 | This function is like @code{window-pixel-edges}, except that it | ||
| 560 | returns the edge coordinates for the window's text area, rather than | ||
| 561 | the edge coordinates for the window itself. @var{window} must specify | ||
| 562 | a live window. | ||
| 563 | @end defun | ||
| 564 | |||
| 565 | @defun window-absolute-pixel-edges &optional window | ||
| 566 | This function is like @code{window-pixel-edges}, except that it | ||
| 567 | returns the edge coordinates relative to the top left corner of the | ||
| 568 | display screen. | ||
| 569 | @end defun | ||
| 570 | |||
| 571 | @defun window-inside-absolute-pixel-edges &optional window | ||
| 572 | This function is like @code{window-inside-pixel-edges}, except that it | ||
| 573 | returns the edge coordinates relative to the top left corner of the | ||
| 574 | display screen. @var{window} must specify a live window. | ||
| 575 | @end defun | ||
| 537 | 576 | ||
| 538 | @node Resizing Windows | 577 | @node Resizing Windows |
| 539 | @section Resizing Windows | 578 | @section Resizing Windows |
| @@ -593,10 +632,11 @@ the window cannot be resized as demanded, an error is signaled. | |||
| 593 | The optional argument @var{ignore} has the same meaning as for the | 632 | The optional argument @var{ignore} has the same meaning as for the |
| 594 | function @code{window-resizable} above. | 633 | function @code{window-resizable} above. |
| 595 | 634 | ||
| 596 | The choice of which window edge this function alters depends on the | 635 | The choice of which window edges this function alters depends on the |
| 597 | splitting and nesting status of the involved windows; in some cases, | 636 | values of the option @code{window-combination-resize} and the |
| 598 | it may alter both edges. @xref{Splitting Windows}. To resize by | 637 | combination-limit status of the involved windows; in some cases, it may |
| 599 | moving only the bottom or right edge of a window, use the function | 638 | alter both edges. @xref{Splitting Windows}. To resize by moving only |
| 639 | the bottom or right edge of a window, use the function | ||
| 600 | @code{adjust-window-trailing-edge}, below. | 640 | @code{adjust-window-trailing-edge}, below. |
| 601 | @end defun | 641 | @end defun |
| 602 | 642 | ||
| @@ -604,104 +644,85 @@ moving only the bottom or right edge of a window, use the function | |||
| 604 | @c shrink-window, and shrink-window-horizontally are documented in the | 644 | @c shrink-window, and shrink-window-horizontally are documented in the |
| 605 | @c Emacs manual. They are not preferred for calling from Lisp. | 645 | @c Emacs manual. They are not preferred for calling from Lisp. |
| 606 | 646 | ||
| 607 | The following function is useful for moving the line dividing two | ||
| 608 | windows. | ||
| 609 | |||
| 610 | @defun adjust-window-trailing-edge window delta &optional horizontal | 647 | @defun adjust-window-trailing-edge window delta &optional horizontal |
| 611 | This function moves @var{window}'s bottom edge by @var{delta} lines. | 648 | This function moves @var{window}'s bottom edge by @var{delta} lines. |
| 612 | Optional argument @var{horizontal} non-@code{nil} means to move | 649 | If optional argument @var{horizontal} is non-@code{nil}, it instead |
| 613 | @var{window}'s right edge by @var{delta} columns. The argument | 650 | moves the right edge by @var{delta} columns. If @var{window} is |
| 614 | @var{window} defaults to the selected window. | 651 | @code{nil}, it defaults to the selected window. |
| 615 | 652 | ||
| 616 | If @var{delta} is greater zero, this moves the edge downwards or to the | 653 | A positive @var{delta} moves the edge downwards or to the right; a |
| 617 | right. If @var{delta} is less than zero, this moves the edge upwards or | 654 | negative @var{delta} moves it upwards or to the left. If the edge |
| 618 | to the left. If the edge can't be moved by @var{delta} lines or columns, | 655 | cannot be moved as far as specified by @var{delta}, this function |
| 619 | it is moved as far as possible in the desired direction but no error is | 656 | moves it as far as possible but does not signal a error. |
| 620 | signaled. | ||
| 621 | 657 | ||
| 622 | This function tries to resize windows adjacent to the edge that is | 658 | This function tries to resize windows adjacent to the edge that is |
| 623 | moved. Only if this is insufficient, it will also resize windows not | 659 | moved. If this is not possible for some reason (e.g. if that adjacent |
| 624 | adjacent to that edge. As a consequence, if you move an edge in one | 660 | window is fixed-size), it may resize other windows. |
| 625 | direction and back in the other direction by the same amount, the | ||
| 626 | resulting window configuration will not be necessarily identical to the | ||
| 627 | one before the first move. So if your intend to just resize | ||
| 628 | @var{window}, you should not use this function but call | ||
| 629 | @code{window-resize} (see above) instead. | ||
| 630 | @end defun | 661 | @end defun |
| 631 | 662 | ||
| 663 | The following commands resize windows in more specific ways. When | ||
| 664 | called interactively, they act on the selected window. | ||
| 665 | |||
| 632 | @deffn Command fit-window-to-buffer &optional window max-height min-height override | 666 | @deffn Command fit-window-to-buffer &optional window max-height min-height override |
| 633 | This command makes @var{window} the right height to display its | 667 | This command adjusts the height of @var{window} to fit the text in it. |
| 634 | contents exactly. The default for @var{window} is the selected window. | 668 | It returns non-@code{nil} if it was able to resize @var{window}, and |
| 635 | 669 | @code{nil} otherwise. If @var{window} is omitted or @code{nil}, it | |
| 636 | The optional argument @var{max-height} specifies the maximum total | 670 | defaults to the selected window. Otherwise, it should be a live |
| 637 | height the window is allowed to be; @code{nil} means use the maximum | 671 | window. |
| 638 | permissible height of a window on @var{window}'s frame. The optional | 672 | |
| 639 | argument @var{min-height} specifies the minimum total height for the | 673 | The optional argument @var{max-height}, if non-@code{nil}, specifies |
| 640 | window; @code{nil} means use @code{window-min-height}. All these height | 674 | the maximum total height that this function can give @var{window}. |
| 641 | values include the mode line and/or header line. | 675 | The optional argument @var{min-height}, if no-@code{nil}, specifies |
| 642 | 676 | the minimum total height that it can give, which overrides the | |
| 643 | If the optional argument @var{override} is non-@code{nil}, this means to | 677 | variable @code{window-min-height}. |
| 644 | ignore any restrictions imposed by @code{window-min-height} and | 678 | |
| 645 | @code{window-min-width} on the size of @var{window}. | 679 | If the optional argument @var{override} is non-@code{nil}, this |
| 646 | 680 | function ignores any size restrictions imposed by | |
| 647 | This function returns non-@code{nil} if it orderly resized @var{window}, | 681 | @code{window-min-height} and @code{window-min-width}. |
| 648 | and @code{nil} otherwise. | ||
| 649 | @end deffn | 682 | @end deffn |
| 650 | 683 | ||
| 651 | @deffn Command shrink-window-if-larger-than-buffer &optional window | 684 | @deffn Command shrink-window-if-larger-than-buffer &optional window |
| 652 | This command shrinks @var{window} vertically to be as small as possible | 685 | This command attempts to reduce @var{window}'s height as much as |
| 653 | while still showing the full contents of its buffer---but not less than | 686 | possible while still showing its full buffer, but no less than |
| 654 | @code{window-min-height} lines. The argument @var{window} must denote | 687 | @code{window-min-height} lines. The return value is non-@code{nil} if |
| 655 | a live window and defaults to the selected one. | 688 | the window was resized, and @code{nil} otherwise. If @var{window} is |
| 656 | 689 | omitted or @code{nil}, it defaults to the selected window. Otherwise, | |
| 657 | However, this command does nothing if the window is already too small to | 690 | it should be a live window. |
| 658 | display the whole text of the buffer, or if part of the contents are | 691 | |
| 659 | currently scrolled off screen, or if the window is not the full width of | 692 | This command does nothing if the window is already too short to |
| 660 | its frame, or if the window is the only window in its frame. | 693 | display all of its buffer, or if any of the buffer is scrolled |
| 661 | 694 | off-screen, or if the window is the only live window in its frame. | |
| 662 | This command returns non-@code{nil} if it actually shrank the window | ||
| 663 | and @code{nil} otherwise. | ||
| 664 | @end deffn | 695 | @end deffn |
| 665 | 696 | ||
| 666 | @cindex balancing window sizes | 697 | @cindex balancing window sizes |
| 667 | Emacs provides two functions to balance windows, that is, to even out | ||
| 668 | the sizes of all windows on the same frame. The minibuffer window and | ||
| 669 | fixed-size windows are not resized by these functions. | ||
| 670 | |||
| 671 | @deffn Command balance-windows &optional window-or-frame | 698 | @deffn Command balance-windows &optional window-or-frame |
| 672 | This function balances windows in a way that gives more space to | 699 | This function balances windows in a way that gives more space to |
| 673 | full-width and/or full-height windows. If @var{window-or-frame} | 700 | full-width and/or full-height windows. If @var{window-or-frame} |
| 674 | specifies a frame, it balances all windows on that frame. If | 701 | specifies a frame, it balances all windows on that frame. If |
| 675 | @var{window-or-frame} specifies a window, it balances that window and | 702 | @var{window-or-frame} specifies a window, it balances only that window |
| 676 | its siblings (@pxref{Windows and Frames}) only. | 703 | and its siblings (@pxref{Windows and Frames}). |
| 677 | @end deffn | 704 | @end deffn |
| 678 | 705 | ||
| 679 | @deffn Command balance-windows-area | 706 | @deffn Command balance-windows-area |
| 680 | This function attempts to give all windows on the selected frame | 707 | This function attempts to give all windows on the selected frame |
| 681 | approximately the same share of the screen area. This means that | 708 | approximately the same share of the screen area. Full-width or |
| 682 | full-width or full-height windows are not given more space than other | 709 | full-height windows are not given more space than other windows. |
| 683 | windows. | ||
| 684 | @end deffn | 710 | @end deffn |
| 685 | 711 | ||
| 686 | @cindex maximizing windows | 712 | @cindex maximizing windows |
| 687 | The following function can be used to give a window the maximum possible | ||
| 688 | size without deleting other ones. | ||
| 689 | |||
| 690 | @deffn Command maximize-window &optional window | 713 | @deffn Command maximize-window &optional window |
| 691 | This function maximizes @var{window}. More precisely, this makes | 714 | This function attempts to make @var{window} as large as possible, in |
| 692 | @var{window} as large as possible without resizing its frame or deleting | 715 | both dimensions, without resizing its frame or deleting other windows. |
| 693 | other windows. @var{window} can be any window and defaults to the | 716 | If @var{window} is omitted or @code{nil}, it defaults to the selected |
| 694 | selected one. | 717 | window. |
| 695 | @end deffn | 718 | @end deffn |
| 696 | 719 | ||
| 697 | @cindex minimizing windows | 720 | @cindex minimizing windows |
| 698 | To make a window as small as possible without deleting it the | ||
| 699 | following function can be used. | ||
| 700 | |||
| 701 | @deffn Command minimize-window &optional window | 721 | @deffn Command minimize-window &optional window |
| 702 | This function minimizes @var{window}. More precisely, this makes | 722 | This function attempts to make @var{window} as small as possible, in |
| 703 | @var{window} as small as possible without deleting it or resizing its | 723 | both dimensions, without deleting it or resizing its frame. If |
| 704 | frame. @var{window} can be any window and defaults to the selected one. | 724 | @var{window} is omitted or @code{nil}, it defaults to the selected |
| 725 | window. | ||
| 705 | @end deffn | 726 | @end deffn |
| 706 | 727 | ||
| 707 | 728 | ||
| @@ -719,7 +740,7 @@ This function creates a new live window next to the window | |||
| 719 | to the selected window. That window is ``split'', and reduced in | 740 | to the selected window. That window is ``split'', and reduced in |
| 720 | size. The space is taken up by the new window, which is returned. | 741 | size. The space is taken up by the new window, which is returned. |
| 721 | 742 | ||
| 722 | The optional second argument @var{size} determines the sizes of the | 743 | The optional second argument @var{size} determines the sizes of |
| 723 | @var{window} and/or the new window. If it is omitted or @code{nil}, | 744 | @var{window} and/or the new window. If it is omitted or @code{nil}, |
| 724 | both windows are given equal sizes; if there is an odd line, it is | 745 | both windows are given equal sizes; if there is an odd line, it is |
| 725 | allocated to the new window. If @var{size} is a positive number, | 746 | allocated to the new window. If @var{size} is a positive number, |
| @@ -765,10 +786,10 @@ lieu of the usual action of @code{split-window}. | |||
| 765 | 786 | ||
| 766 | As an example, we show a combination of @code{split-window} calls | 787 | As an example, we show a combination of @code{split-window} calls |
| 767 | that yields the window configuration discussed in @ref{Windows and | 788 | that yields the window configuration discussed in @ref{Windows and |
| 768 | Frames}. This example demonstrates splitting live windows as well as | 789 | Frames}. This example demonstrates splitting a live window as well as |
| 769 | splitting internal windows. We begin with a frame containing a single | 790 | splitting an internal window. We begin with a frame containing a |
| 770 | window (a live root window), which we denote by @var{W4}. Calling | 791 | single window (a live root window), which we denote by @var{W4}. |
| 771 | @code{(split-window W3)} yields this window configuration: | 792 | Calling @code{(split-window W3)} yields this window configuration: |
| 772 | 793 | ||
| 773 | @smallexample | 794 | @smallexample |
| 774 | @group | 795 | @group |
| @@ -816,15 +837,14 @@ internal window @var{W3} as the argument. The result: | |||
| 816 | @end smallexample | 837 | @end smallexample |
| 817 | 838 | ||
| 818 | @noindent | 839 | @noindent |
| 819 | A new live window, @var{W2}, is created to the left of @var{W3} (which | 840 | A new live window @var{W2} is created, to the left of the internal |
| 820 | encompasses the vertical window combination of @var{W4} and @var{W5}). | 841 | window @var{W3}. A new internal window @var{W1} is created, becoming |
| 821 | A new internal window @var{W1} is also created, and becomes the new | 842 | the new root window. |
| 822 | root window. | ||
| 823 | 843 | ||
| 824 | The following two options can be used to modify the operation of | 844 | The following two options can be used to modify the operation of |
| 825 | @code{split-window}. | 845 | @code{split-window}. |
| 826 | 846 | ||
| 827 | @defopt window-splits | 847 | @defopt window-combination-resize |
| 828 | 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 |
| 829 | 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 |
| 830 | 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 |
| @@ -836,45 +856,16 @@ resize all windows that are part of the same combination as | |||
| 836 | 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 |
| 837 | a fixed-size window or too small to ordinarily split. | 857 | a fixed-size window or too small to ordinarily split. |
| 838 | 858 | ||
| 839 | In any case, the value of this variable is assigned to the splits status | 859 | Also if this variable is non-@code{nil}, subsequent resizing and |
| 840 | of the new window and, provided old and new window form a new | 860 | deleting @var{window} will usually affect @emph{all} windows in |
| 841 | combination, of the old window as well. The splits status of a window | 861 | @var{window}'s combination. |
| 842 | can be retrieved by invoking the function @code{window-splits} and | ||
| 843 | altered by the function @code{set-window-splits} described next. | ||
| 844 | 862 | ||
| 845 | If @code{window-nest} (see below) is non-@code{nil}, the space for the | 863 | The setting of this variable has no effect if |
| 846 | new window is exclusively taken from the old window, but the splits | 864 | @code{window-combination-limit} (see below) is non-@code{nil}. |
| 847 | status of the involved windows is nevertheless set as described here. | ||
| 848 | @end defopt | 865 | @end defopt |
| 849 | 866 | ||
| 850 | @defun window-splits &optional window | 867 | To illustrate the use of @code{window-combination-resize} consider the |
| 851 | This function returns the splits status of @var{window}. The argument | 868 | following window configuration: |
| 852 | @var{window} can be any window and defaults to the selected one. | ||
| 853 | |||
| 854 | @cindex splits status | ||
| 855 | The @dfn{splits status} of a window specifies how resizing and deleting | ||
| 856 | that window may affect the size of other windows in the same window | ||
| 857 | combination. More precisely, if @var{window}'s splits status is | ||
| 858 | @code{nil} and @var{window} is resized, the corresponding space is | ||
| 859 | preferably taken from (or given to) @var{window}'s right sibling. When | ||
| 860 | @var{window} is deleted, its space is given to its left sibling. If | ||
| 861 | @var{window}'s splits status is non-@code{nil}, resizing and deleting | ||
| 862 | @var{window} may resize @emph{all} windows in @var{window}'s | ||
| 863 | combination. | ||
| 864 | |||
| 865 | The splits status is initially set by @code{split-window} | ||
| 866 | from the current value of the variable @code{window-splits} (see above) | ||
| 867 | and can be reset by the function @code{set-window-splits} (see below). | ||
| 868 | @end defun | ||
| 869 | |||
| 870 | @defun set-window-splits window &optional status | ||
| 871 | This function sets the splits status (see above) of @var{window} to | ||
| 872 | @var{status}. The argument @var{window} can be any window and defaults | ||
| 873 | to the selected one. The return value is @var{status}. | ||
| 874 | @end defun | ||
| 875 | |||
| 876 | To illustrate the use of @code{window-splits} consider the following | ||
| 877 | window configuration: | ||
| 878 | @smallexample | 869 | @smallexample |
| 879 | @group | 870 | @group |
| 880 | ______________________________________ | 871 | ______________________________________ |
| @@ -895,8 +886,9 @@ window configuration: | |||
| 895 | @end group | 886 | @end group |
| 896 | @end smallexample | 887 | @end smallexample |
| 897 | 888 | ||
| 898 | Splitting window @code{W3} with @code{window-splits} @code{nil} | 889 | Splitting window @code{W3} with @code{window-combination-resize} |
| 899 | produces a configuration where the size of @code{W2} remains unchanged: | 890 | @code{nil} produces a configuration where the size of @code{W2} remains |
| 891 | unchanged: | ||
| 900 | @smallexample | 892 | @smallexample |
| 901 | @group | 893 | @group |
| 902 | ______________________________________ | 894 | ______________________________________ |
| @@ -917,10 +909,8 @@ produces a configuration where the size of @code{W2} remains unchanged: | |||
| 917 | @end group | 909 | @end group |
| 918 | @end smallexample | 910 | @end smallexample |
| 919 | 911 | ||
| 920 | Splitting @code{W3} with @code{window-splits} non-@code{nil} instead | 912 | Splitting @code{W3} with @code{window-combination-resize} non-@code{nil} |
| 921 | produces a configuration where all windows have approximately the same | 913 | instead steals the space for @code{W4} from both @code{W2} and @code{W3}: |
| 922 | height: | ||
| 923 | |||
| 924 | @smallexample | 914 | @smallexample |
| 925 | @group | 915 | @group |
| 926 | ______________________________________ | 916 | ______________________________________ |
| @@ -941,34 +931,36 @@ height: | |||
| 941 | @end group | 931 | @end group |
| 942 | @end smallexample | 932 | @end smallexample |
| 943 | 933 | ||
| 944 | @defopt window-nest | 934 | @defopt window-combination-limit |
| 945 | If this variable is @code{nil}, @code{split-window} creates a new parent | 935 | If this variable is @code{nil}, @code{split-window} creates a new parent |
| 946 | window if and only if the old window has no parent window or shall be | 936 | window if and only if the old window has no parent window or shall be |
| 947 | split orthogonally to the combination it is part of. If this variable | 937 | split orthogonally to the combination it is part of. If this variable |
| 948 | is non-@code{nil}, @code{split-window} always creates a new parent | 938 | is @code{t}, @code{split-window} always creates a new parent window. If |
| 949 | window. If this variable is always non-@code{nil}, a frame's window | 939 | this variable is always @code{t}, a frame's window tree is a binary tree |
| 950 | tree is a binary tree so every window but the frame's root window has | 940 | so every window but the frame's root window has exactly one sibling. |
| 951 | exactly one sibling. | 941 | Other values are reserved for future use. |
| 952 | 942 | ||
| 953 | The value of this variable is also assigned to the nest status of the | 943 | The value of this variable is also assigned to the combination-limit |
| 954 | new parent window. The nest status of any window can be retrieved via | 944 | status of the new parent window. The combination-limit status of any |
| 955 | the function @code{window-nest} and altered by the function | 945 | window can be retrieved via the function @code{window-combination-limit} |
| 956 | @code{set-window-nest}, see below. | 946 | and altered by the function @code{set-window-combination-limit}, see |
| 947 | below. | ||
| 957 | @end defopt | 948 | @end defopt |
| 958 | 949 | ||
| 959 | @defun window-nest &optional window | 950 | @defun window-combination-limit &optional window |
| 960 | This function returns the nest status of @var{window}. The argument | 951 | This function returns the combination-limit status of @var{window}. The |
| 961 | @var{window} can be any window and defaults to the selected one. Note, | 952 | argument @var{window} can be any window and defaults to the selected |
| 962 | however, that the nest status is currently meaningful for internal | 953 | one. Note, however, that the combination-limit status is currently |
| 963 | windows only. | 954 | meaningful for internal windows only. |
| 964 | 955 | ||
| 965 | @cindex nest status | 956 | @cindex combination-limit status |
| 966 | The @dfn{nest status} of a window specifies whether that window may be | 957 | The @dfn{combination-limit status} of a window specifies whether that |
| 967 | removed and its child windows recombined with that window's siblings | 958 | window may be removed and its child windows recombined with that |
| 968 | when such a sibling's child window is deleted. The nest status is | 959 | window's siblings when such a sibling's child window is deleted. The |
| 969 | initially assigned by @code{split-window} from the current value of the | 960 | combination-limit status is initially assigned by @code{split-window} |
| 970 | variable @code{window-nest} (see above) and can be reset by the function | 961 | from the current value of the variable @code{window-combination-limit} |
| 971 | @code{set-window-nest} (see below). | 962 | (see above) and can be reset by the function |
| 963 | @code{set-window-combination-limit} (see below). | ||
| 972 | 964 | ||
| 973 | If the return value is @code{nil}, child windows of @var{window} may be | 965 | If the return value is @code{nil}, child windows of @var{window} may be |
| 974 | recombined with @var{window}'s siblings when a window gets deleted. A | 966 | recombined with @var{window}'s siblings when a window gets deleted. A |
| @@ -976,16 +968,17 @@ return value of @code{nil} means that child windows of @var{window} are | |||
| 976 | never (re-)combined with @var{window}'s siblings in such a case. | 968 | never (re-)combined with @var{window}'s siblings in such a case. |
| 977 | @end defun | 969 | @end defun |
| 978 | 970 | ||
| 979 | @defun set-window-nest window &optional status | 971 | @defun set-window-combination-limit window &optional status |
| 980 | This functions sets the nest status (see above) of @var{window} to | 972 | This functions sets the combination-limit status (see above) of |
| 981 | @var{status}. The argument @var{window} can be any window and defaults | 973 | @var{window} to @var{status}. The argument @var{window} can be any |
| 982 | to the selected one. Note that setting the nest status is meaningful | 974 | window and defaults to the selected one. Note that setting the |
| 983 | for internal windows only. The return value is @var{status}. | 975 | combination-limit status is meaningful for internal windows only. The |
| 976 | return value is @var{status}. | ||
| 984 | @end defun | 977 | @end defun |
| 985 | 978 | ||
| 986 | To illustrate the use of @code{window-nest} consider the following | 979 | To illustrate the use of @code{window-combination-limit} consider the |
| 987 | configuration (throughout the following examples we shall assume that | 980 | following configuration (throughout the following examples we shall |
| 988 | @code{window-splits} invariantly is @code{nil}). | 981 | assume that @code{window-combination-resize} invariantly is @code{nil}). |
| 989 | @smallexample | 982 | @smallexample |
| 990 | @group | 983 | @group |
| 991 | ______________________________________ | 984 | ______________________________________ |
| @@ -1007,7 +1000,8 @@ configuration (throughout the following examples we shall assume that | |||
| 1007 | @end smallexample | 1000 | @end smallexample |
| 1008 | 1001 | ||
| 1009 | Splitting @code{W2} into two windows above each other with | 1002 | Splitting @code{W2} into two windows above each other with |
| 1010 | @code{window-nest} equal @code{nil} will get you a configuration like: | 1003 | @code{window-combination-limit} equal @code{nil} will get you a |
| 1004 | configuration like: | ||
| 1011 | @smallexample | 1005 | @smallexample |
| 1012 | @group | 1006 | @group |
| 1013 | ______________________________________ | 1007 | ______________________________________ |
| @@ -1074,9 +1068,9 @@ follows: | |||
| 1074 | 1068 | ||
| 1075 | Hence, with respect to the initial configuration, window @code{W2} has | 1069 | Hence, with respect to the initial configuration, window @code{W2} has |
| 1076 | grown at the expense of window @code{W3}. If, however, in the initial | 1070 | grown at the expense of window @code{W3}. If, however, in the initial |
| 1077 | configuration you had split @code{W2} with @code{window-nest} bound to | 1071 | configuration you had split @code{W2} with |
| 1078 | @code{t}, a new internal window @code{W5} would have been created as | 1072 | @code{window-combination-limit} bound to @code{t}, a new internal window |
| 1079 | depicted below. | 1073 | @code{W5} would have been created as depicted below. |
| 1080 | @smallexample | 1074 | @smallexample |
| 1081 | @group | 1075 | @group |
| 1082 | ______________________________________ | 1076 | ______________________________________ |
| @@ -1189,12 +1183,12 @@ window parameters. If the @code{delete-window} parameter specifies a | |||
| 1189 | function, that function is called with @var{window} as its sole | 1183 | function, that function is called with @var{window} as its sole |
| 1190 | argument. | 1184 | argument. |
| 1191 | 1185 | ||
| 1192 | If the splits status of @var{window} (@pxref{Splitting Windows}) is | 1186 | If @code{window-combination-resize} (@pxref{Splitting Windows}) is |
| 1193 | @code{nil}, the space @var{window} took up is given to its left sibling | 1187 | @code{nil}, the space @var{window} took up is given to its left sibling |
| 1194 | if such a window exists and to its right sibling otherwise. If the | 1188 | if such a window exists and to its right sibling otherwise. If |
| 1195 | splits status of @var{window} is non-@code{nil}, its space is | 1189 | @code{window-combination-resize} is non-@code{nil}, the space of |
| 1196 | proportionally distributed among the remaining windows in the same | 1190 | @var{window} is proportionally distributed among the remaining windows |
| 1197 | combination. | 1191 | in the same combination. |
| 1198 | @end deffn | 1192 | @end deffn |
| 1199 | 1193 | ||
| 1200 | @deffn Command delete-other-windows &optional window | 1194 | @deffn Command delete-other-windows &optional window |
diff --git a/doc/man/ChangeLog b/doc/man/ChangeLog index b9175ce51ea..758cdde1dea 100644 --- a/doc/man/ChangeLog +++ b/doc/man/ChangeLog | |||
| @@ -1,3 +1,7 @@ | |||
| 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 029406e2d30..924f3501bfa 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,22 @@ | |||
| 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 | |||
| 16 | 2011-11-11 Juanma Barranquero <lekktu@gmail.com> | ||
| 17 | |||
| 18 | * semantic.texi (Tag handling): Fix typo. | ||
| 19 | |||
| 1 | 2011-10-31 Katsumi Yamaoka <yamaoka@jpl.org> | 20 | 2011-10-31 Katsumi Yamaoka <yamaoka@jpl.org> |
| 2 | 21 | ||
| 3 | * gnus.texi (Other Gnus Versions): Remove. | 22 | * gnus.texi (Other Gnus Versions): Remove. |
| @@ -58,7 +77,7 @@ | |||
| 58 | 77 | ||
| 59 | Release MH-E manual version 8.3. | 78 | Release MH-E manual version 8.3. |
| 60 | 79 | ||
| 61 | * mh-e.texi: (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for | 80 | * mh-e.texi (VERSION, EDITION, UPDATED, UPDATE-MONTH): Update for |
| 62 | release 8.3. | 81 | release 8.3. |
| 63 | (Preface): Updated support information. | 82 | (Preface): Updated support information. |
| 64 | (From Bill Wohler): Reset text to original version. As a | 83 | (From Bill Wohler): Reset text to original version. As a |
| @@ -296,7 +315,7 @@ | |||
| 296 | 315 | ||
| 297 | 2011-08-15 Eric Schulte <schulte.eric@gmail.com> | 316 | 2011-08-15 Eric Schulte <schulte.eric@gmail.com> |
| 298 | 317 | ||
| 299 | * org.texi (Evaluating code blocks): Expanded discussion of | 318 | * org.texi (Evaluating code blocks): Expanded discussion of |
| 300 | #+call: line syntax. | 319 | #+call: line syntax. |
| 301 | (Header arguments in function calls): Expanded discussion of | 320 | (Header arguments in function calls): Expanded discussion of |
| 302 | #+call: line syntax. | 321 | #+call: line syntax. |
| @@ -2290,7 +2309,7 @@ | |||
| 2290 | 2009-08-25 Michael Albinus <michael.albinus@gmx.de> | 2309 | 2009-08-25 Michael Albinus <michael.albinus@gmx.de> |
| 2291 | 2310 | ||
| 2292 | * dbus.texi (Bus names): Add optional parameter TIMEOUT to dbus-ping. | 2311 | * dbus.texi (Bus names): Add optional parameter TIMEOUT to dbus-ping. |
| 2293 | Describe autostart behaviour of dbus-ping. | 2312 | Describe autostart behavior of dbus-ping. |
| 2294 | (Synchronous Methods, Asynchronous Methods): Use English numeric format | 2313 | (Synchronous Methods, Asynchronous Methods): Use English numeric format |
| 2295 | for timeout values. | 2314 | for timeout values. |
| 2296 | (Top): Remove footnote saying D-Bus is not enabled by | 2315 | (Top): Remove footnote saying D-Bus is not enabled by |
diff --git a/doc/misc/ada-mode.texi b/doc/misc/ada-mode.texi index 66cdb200111..374158c2c78 100644 --- a/doc/misc/ada-mode.texi +++ b/doc/misc/ada-mode.texi | |||
| @@ -184,7 +184,7 @@ convention, where file names are a simple modification of the Ada | |||
| 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 | af 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/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..79c7ada3b0b 100644 --- a/doc/misc/dbus.texi +++ b/doc/misc/dbus.texi | |||
| @@ -553,7 +553,7 @@ data from a running system: | |||
| 553 | @node Methods and Signal | 553 | @node Methods and Signal |
| 554 | @section Applying the functionality. | 554 | @section Applying the functionality. |
| 555 | 555 | ||
| 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/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..d2705155887 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi | |||
| @@ -379,7 +379,7 @@ eshell/sudo is a compiled Lisp function in `em-unix.el' | |||
| 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.texi b/doc/misc/gnus.texi index 545306e4dc7..a3a93c6ef61 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi | |||
| @@ -7665,7 +7665,7 @@ has its own article buffer. | |||
| 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 |
| @@ -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. |
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..cc925906c28 100644 --- a/doc/misc/org.texi +++ b/doc/misc/org.texi | |||
| @@ -36,7 +36,7 @@ | |||
| 36 | 36 | ||
| 37 | @c orgkey{key} A key item | 37 | @c orgkey{key} A key item |
| 38 | @c orgcmd{key,cmd} Key with command name | 38 | @c orgcmd{key,cmd} Key with command name |
| 39 | @c xorgcmd{key,cmmand} Key with command name as @itemx | 39 | @c xorgcmd{key,command} Key with command name as @itemx |
| 40 | @c orgcmdnki{key,cmd} Like orgcmd, but do not index the key | 40 | @c orgcmdnki{key,cmd} Like orgcmd, but do not index the key |
| 41 | @c orgcmdtkc{text,key,cmd} Like orgcmd,special text instead of key | 41 | @c orgcmdtkc{text,key,cmd} Like orgcmd,special text instead of key |
| 42 | @c orgcmdkkc{key1,key2,cmd} Two keys with one command name, use "or" | 42 | @c orgcmdkkc{key1,key2,cmd} Two keys with one command name, use "or" |
| @@ -3883,7 +3883,7 @@ special faces for some of them. This can be done using the variable | |||
| 3883 | @end lisp | 3883 | @end lisp |
| 3884 | 3884 | ||
| 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 |
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 f3f11d29f17..ad6159feb1a 100644 --- a/doc/misc/semantic.texi +++ b/doc/misc/semantic.texi | |||
| @@ -306,7 +306,7 @@ Files associated with tags. Goto-tag, file for include, and file for | |||
| 306 | a prototype. | 306 | a prototype. |
| 307 | 307 | ||
| 308 | @item semantic-tag-ls.el | 308 | @item semantic-tag-ls.el |
| 309 | Language dependant features of a tag, such as parent calculation, slot | 309 | Language dependent features of a tag, such as parent calculation, slot |
| 310 | protection, and other states like abstract, virtual, static, and leaf. | 310 | protection, and other states like abstract, virtual, static, and leaf. |
| 311 | 311 | ||
| 312 | @item semantic-dep.el | 312 | @item semantic-dep.el |
| @@ -349,7 +349,7 @@ This file also provides support for @code{semanticdb-minor-mode}, | |||
| 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 | ||
| @@ -606,7 +606,7 @@ Emacs Lisp. It is an LALR parser suitable for complex languages. | |||
| 606 | @c LocalWords: concat concocting const constantness ctxt Decl defcustom | 606 | @c LocalWords: concat concocting const constantness ctxt Decl defcustom |
| 607 | @c LocalWords: deffn deffnx defun defvar destructor's dfn diff dir | 607 | @c LocalWords: deffn deffnx defun defvar destructor's dfn diff dir |
| 608 | @c LocalWords: doc docstring EDE EIEIO elisp emacsman emph enum | 608 | @c LocalWords: doc docstring EDE EIEIO elisp emacsman emph enum |
| 609 | @c LocalWords: eq Exp EXPANDFULL expresssion fn foo func funcall | 609 | @c LocalWords: eq Exp EXPANDFULL expression fn foo func funcall |
| 610 | @c LocalWords: ia ids iff ifinfo imenu imenus init int isearch itemx java kbd | 610 | @c LocalWords: ia ids iff ifinfo imenu imenus init int isearch itemx java kbd |
| 611 | @c LocalWords: keymap keywordtable lang languagemode lexer lexing Ludlam | 611 | @c LocalWords: keymap keywordtable lang languagemode lexer lexing Ludlam |
| 612 | @c LocalWords: menubar metaparent metaparents min minibuffer Misc mode's | 612 | @c LocalWords: menubar metaparent metaparents min minibuffer Misc mode's |
diff --git a/doc/misc/tramp.texi b/doc/misc/tramp.texi index a4e06ab22f1..0accc6fac43 100644 --- a/doc/misc/tramp.texi +++ b/doc/misc/tramp.texi | |||
| @@ -1575,7 +1575,7 @@ password handling. Consider @command{ssh-agent} for @option{ssh}-like | |||
| 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} |