diff options
| author | Glenn Morris | 2014-06-08 16:41:43 -0700 |
|---|---|---|
| committer | Glenn Morris | 2014-06-08 16:41:43 -0700 |
| commit | fd60bf6c902b47daadda6ebf442045dbe1328941 (patch) | |
| tree | fd351a1fc087aefbca38b87102f06edf9f8b04ff /doc/misc | |
| parent | ff2d0e8336c05cb7d3e86f7406784cefc1d6589e (diff) | |
| parent | 4181427f24e591f539122db2e3d8d8b55a7de7cd (diff) | |
| download | emacs-fd60bf6c902b47daadda6ebf442045dbe1328941.tar.gz emacs-fd60bf6c902b47daadda6ebf442045dbe1328941.zip | |
Merge from emacs-24; up to 2014-06-02T11:35:40Z!michael.albinus@gmx.de
Diffstat (limited to 'doc/misc')
| -rw-r--r-- | doc/misc/ChangeLog | 21 | ||||
| -rw-r--r-- | doc/misc/calc.texi | 4 | ||||
| -rw-r--r-- | doc/misc/cc-mode.texi | 6 | ||||
| -rw-r--r-- | doc/misc/ebrowse.texi | 8 | ||||
| -rw-r--r-- | doc/misc/ede.texi | 18 | ||||
| -rw-r--r-- | doc/misc/efaq-w32.texi | 8 | ||||
| -rw-r--r-- | doc/misc/efaq.texi | 2 | ||||
| -rw-r--r-- | doc/misc/eieio.texi | 8 | ||||
| -rw-r--r-- | doc/misc/emacs-gnutls.texi | 2 | ||||
| -rw-r--r-- | doc/misc/erc.texi | 2 | ||||
| -rw-r--r-- | doc/misc/ert.texi | 14 | ||||
| -rw-r--r-- | doc/misc/eshell.texi | 4 | ||||
| -rw-r--r-- | doc/misc/gnus-faq.texi | 66 | ||||
| -rw-r--r-- | doc/misc/gnus.texi | 17 | ||||
| -rw-r--r-- | doc/misc/htmlfontify.texi | 4 | ||||
| -rw-r--r-- | doc/misc/idlwave.texi | 2 | ||||
| -rw-r--r-- | doc/misc/info.texi | 50 | ||||
| -rw-r--r-- | doc/misc/mairix-el.texi | 2 | ||||
| -rw-r--r-- | doc/misc/message.texi | 2 | ||||
| -rw-r--r-- | doc/misc/mh-e.texi | 2 | ||||
| -rw-r--r-- | doc/misc/reftex.texi | 20 | ||||
| -rw-r--r-- | doc/misc/ses.texi | 2 | ||||
| -rw-r--r-- | doc/misc/srecode.texi | 4 | ||||
| -rw-r--r-- | doc/misc/todo-mode.texi | 26 | ||||
| -rw-r--r-- | doc/misc/url.texi | 2 | ||||
| -rw-r--r-- | doc/misc/vip.texi | 6 | ||||
| -rw-r--r-- | doc/misc/wisent.texi | 4 | ||||
| -rw-r--r-- | doc/misc/woman.texi | 2 |
28 files changed, 165 insertions, 143 deletions
diff --git a/doc/misc/ChangeLog b/doc/misc/ChangeLog index 0bf989c75d4..d4bd5e43acb 100644 --- a/doc/misc/ChangeLog +++ b/doc/misc/ChangeLog | |||
| @@ -1,3 +1,24 @@ | |||
| 1 | 2014-06-08 Karl Berry <karl@gnu.org> | ||
| 2 | |||
| 3 | * doc/info.texi (Help-^L): "mode line", "screenful", | ||
| 4 | stand-alone and Emacs Info both use the mode line. | ||
| 5 | Use x instead of weird C-x 0 to get rid of help msg | ||
| 6 | in standalone Info. | ||
| 7 | |||
| 8 | 2014-06-08 Glenn Morris <rgm@gnu.org> | ||
| 9 | |||
| 10 | * vip.texi (Files): Defer to Emacs manual for uniquify details. | ||
| 11 | |||
| 12 | * info.texi (Help-Small-Screen): Clarify details of S-SPC. | ||
| 13 | (Help-Small-Screen, Help-]): Do not mention S-SPC. | ||
| 14 | (Emacs Info Variables): Markup fix. | ||
| 15 | |||
| 16 | * ebrowse.texi (Source Display, Finding/Viewing): | ||
| 17 | * erc.texi (Sample Session): | ||
| 18 | * ses.texi (The Basics): | ||
| 19 | * todo-mode.texi (Moving and Deleting Items): | ||
| 20 | * woman.texi (Navigation): Markup fixes re SPC, RET. | ||
| 21 | |||
| 1 | 2014-06-02 Glenn Morris <rgm@gnu.org> | 22 | 2014-06-02 Glenn Morris <rgm@gnu.org> |
| 2 | 23 | ||
| 3 | * efaq.texi (Finding a package with particular functionality): | 24 | * efaq.texi (Finding a package with particular functionality): |
diff --git a/doc/misc/calc.texi b/doc/misc/calc.texi index 93c873e2ed6..56aa2d04a1a 100644 --- a/doc/misc/calc.texi +++ b/doc/misc/calc.texi | |||
| @@ -21624,7 +21624,7 @@ to | |||
| 21624 | @noindent | 21624 | @noindent |
| 21625 | Every character not part of the sub-formula @samp{b} has been changed | 21625 | Every character not part of the sub-formula @samp{b} has been changed |
| 21626 | to a dot. (If the customizable variable | 21626 | to a dot. (If the customizable variable |
| 21627 | @code{calc-highlight-selections-with-faces} is non-nil, then the characters | 21627 | @code{calc-highlight-selections-with-faces} is non-@code{nil}, then the characters |
| 21628 | not part of the sub-formula are de-emphasized by using a less | 21628 | not part of the sub-formula are de-emphasized by using a less |
| 21629 | noticeable face instead of using dots. @pxref{Displaying Selections}.) | 21629 | noticeable face instead of using dots. @pxref{Displaying Selections}.) |
| 21630 | The @samp{*} next to the line number is to remind you that | 21630 | The @samp{*} next to the line number is to remind you that |
| @@ -21858,7 +21858,7 @@ by @samp{#} signs: | |||
| 21858 | @end group | 21858 | @end group |
| 21859 | @end smallexample | 21859 | @end smallexample |
| 21860 | If the customizable variable | 21860 | If the customizable variable |
| 21861 | @code{calc-highlight-selections-with-faces} is non-nil, then the | 21861 | @code{calc-highlight-selections-with-faces} is non-@code{nil}, then the |
| 21862 | non-selected portion of the formula will be de-emphasized by using a | 21862 | non-selected portion of the formula will be de-emphasized by using a |
| 21863 | less noticeable face (@code{calc-nonselected-face}) instead of dots | 21863 | less noticeable face (@code{calc-nonselected-face}) instead of dots |
| 21864 | and the selected sub-formula will be highlighted by using a more | 21864 | and the selected sub-formula will be highlighted by using a more |
diff --git a/doc/misc/cc-mode.texi b/doc/misc/cc-mode.texi index 35aea2889a6..cbb49e00efa 100644 --- a/doc/misc/cc-mode.texi +++ b/doc/misc/cc-mode.texi | |||
| @@ -3915,7 +3915,7 @@ Conceptually, a line of code is always indented relative to some | |||
| 3915 | position higher up in the buffer (typically the indentation of the | 3915 | position higher up in the buffer (typically the indentation of the |
| 3916 | previous line). That position is the @dfn{anchor position} in the | 3916 | previous line). That position is the @dfn{anchor position} in the |
| 3917 | syntactic element. If there is an entry after the syntactic symbol in | 3917 | syntactic element. If there is an entry after the syntactic symbol in |
| 3918 | the syntactic element list then it's either nil or that anchor position. | 3918 | the syntactic element list then it's either @code{nil} or that anchor position. |
| 3919 | 3919 | ||
| 3920 | Here is an example. Suppose we had the following code as the only thing | 3920 | Here is an example. Suppose we had the following code as the only thing |
| 3921 | in a C++ buffer @footnote{The line numbers in this and future examples | 3921 | in a C++ buffer @footnote{The line numbers in this and future examples |
| @@ -6067,7 +6067,7 @@ suggestion to get a consistent style): | |||
| 6067 | @defun c-lineup-assignments | 6067 | @defun c-lineup-assignments |
| 6068 | @findex lineup-assignments (c-) | 6068 | @findex lineup-assignments (c-) |
| 6069 | Line up the current line after the assignment operator on the first line | 6069 | Line up the current line after the assignment operator on the first line |
| 6070 | in the statement. If there isn't any, return nil to allow stacking with | 6070 | in the statement. If there isn't any, return @code{nil} to allow stacking with |
| 6071 | other line-up functions. If the current line contains an assignment | 6071 | other line-up functions. If the current line contains an assignment |
| 6072 | operator too, try to align it with the first one. | 6072 | operator too, try to align it with the first one. |
| 6073 | 6073 | ||
| @@ -6532,7 +6532,7 @@ Return the syntactic symbol in @var{langelem}. | |||
| 6532 | 6532 | ||
| 6533 | @defun c-langelem-pos langelem | 6533 | @defun c-langelem-pos langelem |
| 6534 | @findex langelem-pos (c-) | 6534 | @findex langelem-pos (c-) |
| 6535 | Return the anchor position in @var{langelem}, or nil if there is none. | 6535 | Return the anchor position in @var{langelem}, or @code{nil} if there is none. |
| 6536 | @end defun | 6536 | @end defun |
| 6537 | 6537 | ||
| 6538 | @defun c-langelem-col langelem &optional preserve-point | 6538 | @defun c-langelem-col langelem &optional preserve-point |
diff --git a/doc/misc/ebrowse.texi b/doc/misc/ebrowse.texi index 77e221d3c83..9ff3e28e99d 100644 --- a/doc/misc/ebrowse.texi +++ b/doc/misc/ebrowse.texi | |||
| @@ -475,13 +475,13 @@ You can view or find a class declaration when the cursor is on a class | |||
| 475 | name. | 475 | name. |
| 476 | 476 | ||
| 477 | @table @kbd | 477 | @table @kbd |
| 478 | @item SPC | 478 | @item @key{SPC} |
| 479 | This command views the class declaration if the database | 479 | This command views the class declaration if the database |
| 480 | contains information about it. If you don't parse the entire source | 480 | contains information about it. If you don't parse the entire source |
| 481 | you are working on, some classes will only be known to exist but the | 481 | you are working on, some classes will only be known to exist but the |
| 482 | location of their declarations and definitions will not be known. | 482 | location of their declarations and definitions will not be known. |
| 483 | 483 | ||
| 484 | @item RET | 484 | @item @key{RET} |
| 485 | Works like @kbd{SPC}, except that it finds the class | 485 | Works like @kbd{SPC}, except that it finds the class |
| 486 | declaration rather than viewing it, so that it is ready for | 486 | declaration rather than viewing it, so that it is ready for |
| 487 | editing. | 487 | editing. |
| @@ -876,7 +876,7 @@ context menu. | |||
| 876 | @cindex declaration of a member, in member buffers | 876 | @cindex declaration of a member, in member buffers |
| 877 | 877 | ||
| 878 | @table @kbd | 878 | @table @kbd |
| 879 | @item RET | 879 | @item @key{RET} |
| 880 | This command finds the definition of the member the cursor is on. | 880 | This command finds the definition of the member the cursor is on. |
| 881 | Finding involves roughly the same as the standard Emacs tags facility | 881 | Finding involves roughly the same as the standard Emacs tags facility |
| 882 | does---loading the file and searching for a regular expression matching | 882 | does---loading the file and searching for a regular expression matching |
| @@ -885,7 +885,7 @@ the member. | |||
| 885 | @item f | 885 | @item f |
| 886 | This command finds the declaration of the member the cursor is on. | 886 | This command finds the declaration of the member the cursor is on. |
| 887 | 887 | ||
| 888 | @item SPC | 888 | @item @key{SPC} |
| 889 | This is the same command as @kbd{RET}, but views the member definition | 889 | This is the same command as @kbd{RET}, but views the member definition |
| 890 | instead of finding the member's source file. | 890 | instead of finding the member's source file. |
| 891 | 891 | ||
diff --git a/doc/misc/ede.texi b/doc/misc/ede.texi index 0bf1983cdcf..89e576b8c25 100644 --- a/doc/misc/ede.texi +++ b/doc/misc/ede.texi | |||
| @@ -1200,7 +1200,7 @@ until one of them returns true. The method | |||
| 1200 | from the autoload. If it is a string (i.e., a project file name), it | 1200 | from the autoload. If it is a string (i.e., a project file name), it |
| 1201 | checks to see if that exists in BUFFER's directory. If it is a | 1201 | checks to see if that exists in BUFFER's directory. If it is a |
| 1202 | function, then it calls that function and expects it to return a file | 1202 | function, then it calls that function and expects it to return a file |
| 1203 | name or nil. If the file exists, then this directory is assumed to be | 1203 | name or @code{nil}. If the file exists, then this directory is assumed to be |
| 1204 | part of a project, and @code{ede-directory-project-p} returns the | 1204 | part of a project, and @code{ede-directory-project-p} returns the |
| 1205 | instance of @code{ede-project-autoload} that matched. | 1205 | instance of @code{ede-project-autoload} that matched. |
| 1206 | 1206 | ||
| @@ -1275,11 +1275,11 @@ Return a string that is the name of the target used by a Make system. | |||
| 1275 | A brief description of the project or target. This is currently used | 1275 | A brief description of the project or target. This is currently used |
| 1276 | by the @samp{ede-speedbar} interface. | 1276 | by the @samp{ede-speedbar} interface. |
| 1277 | @item ede-want-file-p | 1277 | @item ede-want-file-p |
| 1278 | Return non-nil if a target will accept a given file. | 1278 | Return non-@code{nil} if a target will accept a given file. |
| 1279 | It is generally unnecessary to override this. See the section on source | 1279 | It is generally unnecessary to override this. See the section on source |
| 1280 | code. | 1280 | code. |
| 1281 | @item ede-buffer-mine | 1281 | @item ede-buffer-mine |
| 1282 | Return non-nil if a buffer belongs to this target. Used during | 1282 | Return non-@code{nil} if a buffer belongs to this target. Used during |
| 1283 | association when a file is loaded. It is generally unnecessary to | 1283 | association when a file is loaded. It is generally unnecessary to |
| 1284 | override this unless you keep auxiliary files. | 1284 | override this unless you keep auxiliary files. |
| 1285 | @end table | 1285 | @end table |
| @@ -1614,7 +1614,7 @@ Provide a speedbar description for @var{OBJ}. | |||
| 1614 | @end deffn | 1614 | @end deffn |
| 1615 | 1615 | ||
| 1616 | @deffn Method ede-map-any-target-p :AFTER this proc | 1616 | @deffn Method ede-map-any-target-p :AFTER this proc |
| 1617 | For project @var{THIS}, map @var{PROC} to all targets and return if any non-nil. | 1617 | For project @var{THIS}, map @var{PROC} to all targets and return if any non-@code{nil}. |
| 1618 | Return the first non-@code{nil} value returned by @var{PROC}. | 1618 | Return the first non-@code{nil} value returned by @var{PROC}. |
| 1619 | @end deffn | 1619 | @end deffn |
| 1620 | 1620 | ||
| @@ -1768,7 +1768,7 @@ If @var{TARGET} belongs to a subproject, return that project file. | |||
| 1768 | @end deffn | 1768 | @end deffn |
| 1769 | 1769 | ||
| 1770 | @deffn Method ede-find-target :AFTER proj buffer | 1770 | @deffn Method ede-find-target :AFTER proj buffer |
| 1771 | Fetch the target in @var{PROJ} belonging to @var{BUFFER} or nil. | 1771 | Fetch the target in @var{PROJ} belonging to @var{BUFFER} or @code{nil}. |
| 1772 | @end deffn | 1772 | @end deffn |
| 1773 | 1773 | ||
| 1774 | @deffn Method ede-add-subproject :AFTER proj-a proj-b | 1774 | @deffn Method ede-add-subproject :AFTER proj-a proj-b |
| @@ -1884,8 +1884,8 @@ The function symbol must take two arguments: | |||
| 1884 | NAME - The name of the file to find. | 1884 | NAME - The name of the file to find. |
| 1885 | DIR - The directory root for this cpp-root project. | 1885 | DIR - The directory root for this cpp-root project. |
| 1886 | 1886 | ||
| 1887 | It should return the fully qualified file name passed in from NAME@. If that file does not | 1887 | It should return the fully qualified file name passed in from NAME@. |
| 1888 | exist, it should return nil. | 1888 | If that file does not exist, it should return @code{nil}. |
| 1889 | 1889 | ||
| 1890 | @end table | 1890 | @end table |
| 1891 | 1891 | ||
| @@ -2047,7 +2047,7 @@ Default Value: @code{nil} | |||
| 2047 | Non-@code{nil} if this is a metasubproject. | 2047 | Non-@code{nil} if this is a metasubproject. |
| 2048 | Usually, a subproject is determined by a parent project. If multiple top level | 2048 | Usually, a subproject is determined by a parent project. If multiple top level |
| 2049 | projects are grouped into a large project not maintained by EDE, then you need | 2049 | projects are grouped into a large project not maintained by EDE, then you need |
| 2050 | to set this to non-nil. The only effect is that the @code{dist} rule will then avoid | 2050 | to set this to non-@code{nil}. The only effect is that the @code{dist} rule will then avoid |
| 2051 | making a tar file. | 2051 | making a tar file. |
| 2052 | 2052 | ||
| 2053 | @end table | 2053 | @end table |
| @@ -2281,7 +2281,7 @@ Default Value: @code{nil} | |||
| 2281 | Non-@code{nil} if this is a metasubproject. | 2281 | Non-@code{nil} if this is a metasubproject. |
| 2282 | Usually, a subproject is determined by a parent project. If multiple top level | 2282 | Usually, a subproject is determined by a parent project. If multiple top level |
| 2283 | projects are grouped into a large project not maintained by EDE, then you need | 2283 | projects are grouped into a large project not maintained by EDE, then you need |
| 2284 | to set this to non-nil. The only effect is that the @code{dist} rule will then avoid | 2284 | to set this to non-@code{nil}. The only effect is that the @code{dist} rule will then avoid |
| 2285 | making a tar file. | 2285 | making a tar file. |
| 2286 | 2286 | ||
| 2287 | @end table | 2287 | @end table |
diff --git a/doc/misc/efaq-w32.texi b/doc/misc/efaq-w32.texi index 314aa8db36e..c59f7547d8d 100644 --- a/doc/misc/efaq-w32.texi +++ b/doc/misc/efaq-w32.texi | |||
| @@ -1176,8 +1176,8 @@ Place the following in your init file: | |||
| 1176 | @cindex font menu, adding fonts | 1176 | @cindex font menu, adding fonts |
| 1177 | @vindex w32-fixed-font-alist | 1177 | @vindex w32-fixed-font-alist |
| 1178 | 1178 | ||
| 1179 | If you have set w32-use-w32-font-dialog to nil, you can add fonts to | 1179 | If you have set w32-use-w32-font-dialog to @code{nil}, you can add fonts to |
| 1180 | the font menu by changing `w32-fixed-font-alist'. For example: | 1180 | the font menu by changing @code{w32-fixed-font-alist}. For example: |
| 1181 | 1181 | ||
| 1182 | @example | 1182 | @example |
| 1183 | (setq w32-fixed-font-alist | 1183 | (setq w32-fixed-font-alist |
| @@ -1664,8 +1664,8 @@ smtpmail is loaded, then you'll need to change | |||
| 1664 | @code{smtpmail-smtp-server}. | 1664 | @code{smtpmail-smtp-server}. |
| 1665 | 1665 | ||
| 1666 | If you are experiencing problems with sending large messages, check | 1666 | If you are experiencing problems with sending large messages, check |
| 1667 | the value of the variable @code{smtpmail-debug-info}. If it is non-nil, you | 1667 | the value of the variable @code{smtpmail-debug-info}. If it is |
| 1668 | should set it to @code{nil}: | 1668 | non-@code{nil}, you should set it to @code{nil}: |
| 1669 | 1669 | ||
| 1670 | @node Incoming mail with Rmail | 1670 | @node Incoming mail with Rmail |
| 1671 | @subsection Incoming mail with Rmail and POP3 | 1671 | @subsection Incoming mail with Rmail and POP3 |
diff --git a/doc/misc/efaq.texi b/doc/misc/efaq.texi index 3e86f30cdb5..e596777817b 100644 --- a/doc/misc/efaq.texi +++ b/doc/misc/efaq.texi | |||
| @@ -1944,7 +1944,7 @@ automatically scrolls the display horizontally when point moves off the | |||
| 1944 | left or right edge of the window. | 1944 | left or right edge of the window. |
| 1945 | 1945 | ||
| 1946 | Note that this is overridden by the variable | 1946 | Note that this is overridden by the variable |
| 1947 | @code{truncate-partial-width-windows} if that variable is non-nil | 1947 | @code{truncate-partial-width-windows} if that variable is non-@code{nil} |
| 1948 | and the current buffer is not full-frame width. | 1948 | and the current buffer is not full-frame width. |
| 1949 | 1949 | ||
| 1950 | In Emacs 20, use @code{hscroll-mode}. | 1950 | In Emacs 20, use @code{hscroll-mode}. |
diff --git a/doc/misc/eieio.texi b/doc/misc/eieio.texi index d65bcf1d28d..937fae26907 100644 --- a/doc/misc/eieio.texi +++ b/doc/misc/eieio.texi | |||
| @@ -306,7 +306,7 @@ or is of a subclass of @var{CLASS-NAME}. | |||
| 306 | @end defun | 306 | @end defun |
| 307 | 307 | ||
| 308 | @defvar eieio-error-unsupported-class-tags | 308 | @defvar eieio-error-unsupported-class-tags |
| 309 | If non-nil, @code{defclass} signals an error if a tag in a slot | 309 | If non-@code{nil}, @code{defclass} signals an error if a tag in a slot |
| 310 | specifier is unsupported. | 310 | specifier is unsupported. |
| 311 | 311 | ||
| 312 | This option is here to support programs written with older versions of | 312 | This option is here to support programs written with older versions of |
| @@ -471,7 +471,7 @@ Here are some examples: | |||
| 471 | @item my-class-name | 471 | @item my-class-name |
| 472 | An object of your class type. | 472 | An object of your class type. |
| 473 | @item (or null symbol) | 473 | @item (or null symbol) |
| 474 | A symbol, or nil. | 474 | A symbol, or @code{nil}. |
| 475 | @end table | 475 | @end table |
| 476 | 476 | ||
| 477 | @item :allocation | 477 | @item :allocation |
| @@ -573,7 +573,7 @@ prefixed by the @code{:documentation} tag, and appears after the list | |||
| 573 | of slots, and before the options. | 573 | of slots, and before the options. |
| 574 | 574 | ||
| 575 | @item :allow-nil-initform | 575 | @item :allow-nil-initform |
| 576 | If this option is non-nil, and the @code{:initform} is @code{nil}, but | 576 | If this option is non-@code{nil}, and the @code{:initform} is @code{nil}, but |
| 577 | the @code{:type} is specifies something such as @code{string} then allow | 577 | the @code{:type} is specifies something such as @code{string} then allow |
| 578 | this to pass. The default is to have this option be off. This is | 578 | this to pass. The default is to have this option be off. This is |
| 579 | implemented as an alternative to unbound slots. | 579 | implemented as an alternative to unbound slots. |
| @@ -1264,7 +1264,7 @@ Return the list of public slots for @var{obj}. | |||
| 1264 | @defun class-slot-initarg class slot | 1264 | @defun class-slot-initarg class slot |
| 1265 | For the given @var{class} return the :initarg associated with | 1265 | For the given @var{class} return the :initarg associated with |
| 1266 | @var{slot}. Not all slots have initargs, so the return value can be | 1266 | @var{slot}. Not all slots have initargs, so the return value can be |
| 1267 | nil. | 1267 | @code{nil}. |
| 1268 | @end defun | 1268 | @end defun |
| 1269 | 1269 | ||
| 1270 | @node Base Classes | 1270 | @node Base Classes |
diff --git a/doc/misc/emacs-gnutls.texi b/doc/misc/emacs-gnutls.texi index 844579c1f94..bc054ac76b0 100644 --- a/doc/misc/emacs-gnutls.texi +++ b/doc/misc/emacs-gnutls.texi | |||
| @@ -94,7 +94,7 @@ There's one way to find out if GnuTLS is available, by calling | |||
| 94 | Zaretskii) in the same directory as Emacs, you should be OK. | 94 | Zaretskii) in the same directory as Emacs, you should be OK. |
| 95 | 95 | ||
| 96 | @defun gnutls-available-p | 96 | @defun gnutls-available-p |
| 97 | This function returns t if GnuTLS is available in this instance of Emacs. | 97 | This function returns @code{t} if GnuTLS is available in this instance of Emacs. |
| 98 | @end defun | 98 | @end defun |
| 99 | 99 | ||
| 100 | Oh, but sometimes things go wrong. Budgets aren't balanced, | 100 | Oh, but sometimes things go wrong. Budgets aren't balanced, |
diff --git a/doc/misc/erc.texi b/doc/misc/erc.texi index f21b9d5cbd4..4cb5eaed604 100644 --- a/doc/misc/erc.texi +++ b/doc/misc/erc.texi | |||
| @@ -150,7 +150,7 @@ then a bunch of other messages that describe the current IRC server. | |||
| 150 | 150 | ||
| 151 | @item Join the #emacs channel | 151 | @item Join the #emacs channel |
| 152 | 152 | ||
| 153 | In that buffer, type ``/join SPC #emacs'' and hit @kbd{RET}. Depending | 153 | In that buffer, type ``/join @key{SPC} #emacs'' and hit @kbd{RET}. Depending |
| 154 | on how you've set up ERC, either a new buffer for ``#emacs'' will be | 154 | on how you've set up ERC, either a new buffer for ``#emacs'' will be |
| 155 | displayed, or a new buffer called ``#emacs'' will be created in the | 155 | displayed, or a new buffer called ``#emacs'' will be created in the |
| 156 | background. If the latter, switch to the ``#emacs'' buffer. You will | 156 | background. If the latter, switch to the ``#emacs'' buffer. You will |
diff --git a/doc/misc/ert.texi b/doc/misc/ert.texi index 25174a396a3..ec1614c7140 100644 --- a/doc/misc/ert.texi +++ b/doc/misc/ert.texi | |||
| @@ -139,8 +139,7 @@ An ERT test definition equivalent to the above comments is this: | |||
| 139 | 139 | ||
| 140 | If you know @code{defun}, the syntax of @code{ert-deftest} should look | 140 | If you know @code{defun}, the syntax of @code{ert-deftest} should look |
| 141 | familiar: This example defines a test named @code{pp-test-quote} that | 141 | familiar: This example defines a test named @code{pp-test-quote} that |
| 142 | will pass if the three calls to @code{equal} all return true | 142 | will pass if the three calls to @code{equal} all return non-@code{nil}. |
| 143 | (non-nil). | ||
| 144 | 143 | ||
| 145 | @code{should} is a macro with the same meaning as @code{cl-assert} but | 144 | @code{should} is a macro with the same meaning as @code{cl-assert} but |
| 146 | better error reporting. @xref{The @code{should} Macro}. | 145 | better error reporting. @xref{The @code{should} Macro}. |
| @@ -315,7 +314,8 @@ tests or symbols naming tests. | |||
| 315 | @item @code{(tag TAG)} selects all tests that have TAG on their tags list. | 314 | @item @code{(tag TAG)} selects all tests that have TAG on their tags list. |
| 316 | (Tags are optional labels you can apply to tests when you define them.) | 315 | (Tags are optional labels you can apply to tests when you define them.) |
| 317 | @item @code{(satisfies PREDICATE)} selects all tests that satisfy PREDICATE, | 316 | @item @code{(satisfies PREDICATE)} selects all tests that satisfy PREDICATE, |
| 318 | a function that takes a test as argument and returns non-nil if it is selected. | 317 | a function that takes a test as argument and returns non-@code{nil} if |
| 318 | it is selected. | ||
| 319 | @end itemize | 319 | @end itemize |
| 320 | 320 | ||
| 321 | Selectors that are frequently useful when selecting tests to run | 321 | Selectors that are frequently useful when selecting tests to run |
| @@ -382,13 +382,13 @@ F addition-test | |||
| 382 | @end example | 382 | @end example |
| 383 | 383 | ||
| 384 | In this example, @code{should} recorded the fact that (= (+ 1 2) 4) | 384 | In this example, @code{should} recorded the fact that (= (+ 1 2) 4) |
| 385 | reduced to (= 3 4) before it reduced to nil. When debugging why the | 385 | reduced to (= 3 4) before it reduced to @code{nil}. When debugging why the |
| 386 | test failed, it helps to know that the function @code{+} returned 3 | 386 | test failed, it helps to know that the function @code{+} returned 3 |
| 387 | here. ERT records the return value for any predicate called directly | 387 | here. ERT records the return value for any predicate called directly |
| 388 | within @code{should}. | 388 | within @code{should}. |
| 389 | 389 | ||
| 390 | In addition to @code{should}, ERT provides @code{should-not}, which | 390 | In addition to @code{should}, ERT provides @code{should-not}, which |
| 391 | checks that the predicate returns nil, and @code{should-error}, which | 391 | checks that the predicate returns @code{nil}, and @code{should-error}, which |
| 392 | checks that the form called within it signals an error. An example | 392 | checks that the form called within it signals an error. An example |
| 393 | use of @code{should-error}: | 393 | use of @code{should-error}: |
| 394 | 394 | ||
| @@ -531,7 +531,7 @@ Instead, it is better to use lower-level mechanisms with simple and | |||
| 531 | predictable semantics like @code{with-temp-buffer}, @code{insert} or | 531 | predictable semantics like @code{with-temp-buffer}, @code{insert} or |
| 532 | @code{insert-file-contents-literally}, and to activate any desired mode | 532 | @code{insert-file-contents-literally}, and to activate any desired mode |
| 533 | by calling the corresponding function directly, after binding the | 533 | by calling the corresponding function directly, after binding the |
| 534 | hook variables to nil. This avoids the above problems. | 534 | hook variables to @code{nil}. This avoids the above problems. |
| 535 | 535 | ||
| 536 | 536 | ||
| 537 | @node Useful Techniques | 537 | @node Useful Techniques |
| @@ -761,7 +761,7 @@ the arguments given to the explanation function, returns the value | |||
| 761 | that it returns. The explanation can be any object but should have a | 761 | that it returns. The explanation can be any object but should have a |
| 762 | comprehensible printed representation. If the return value of the | 762 | comprehensible printed representation. If the return value of the |
| 763 | predicate needs no explanation for a given list of arguments, the | 763 | predicate needs no explanation for a given list of arguments, the |
| 764 | explanation function should return nil. | 764 | explanation function should return @code{nil}. |
| 765 | 765 | ||
| 766 | To associate an explanation function with a predicate, add the | 766 | To associate an explanation function with a predicate, add the |
| 767 | property @code{ert-explainer} to the symbol that names the predicate. | 767 | property @code{ert-explainer} to the symbol that names the predicate. |
diff --git a/doc/misc/eshell.texi b/doc/misc/eshell.texi index 67aa4799f75..e7c3c71afd8 100644 --- a/doc/misc/eshell.texi +++ b/doc/misc/eshell.texi | |||
| @@ -676,8 +676,8 @@ You can, of course, define your own virtual targets. They are defined | |||
| 676 | by adding a list of the form @samp{("/dev/name" @var{function} @var{mode})} to | 676 | by adding a list of the form @samp{("/dev/name" @var{function} @var{mode})} to |
| 677 | @code{eshell-virtual-targets}. The first element is the device name; | 677 | @code{eshell-virtual-targets}. The first element is the device name; |
| 678 | @var{function} may be either a lambda or a function name. If | 678 | @var{function} may be either a lambda or a function name. If |
| 679 | @var{mode} is nil, then the function is the output function; if it is | 679 | @var{mode} is @code{nil}, then the function is the output function; if it is |
| 680 | non-nil, then the function is passed the redirection mode as a | 680 | non-@code{nil}, then the function is passed the redirection mode as a |
| 681 | symbol--@code{overwrite} for @code{>}, @code{append} for @code{>>}, or | 681 | symbol--@code{overwrite} for @code{>}, @code{append} for @code{>>}, or |
| 682 | @code{insert} for @code{>>>}--and the function is expected to return | 682 | @code{insert} for @code{>>>}--and the function is expected to return |
| 683 | the output function. | 683 | the output function. |
diff --git a/doc/misc/gnus-faq.texi b/doc/misc/gnus-faq.texi index a053164691f..fd4f427431d 100644 --- a/doc/misc/gnus-faq.texi +++ b/doc/misc/gnus-faq.texi | |||
| @@ -377,7 +377,7 @@ but it only says "nntp (news) open error", what to do? | |||
| 377 | 377 | ||
| 378 | You've got to tell Gnus where to fetch the news from. Read | 378 | You've got to tell Gnus where to fetch the news from. Read |
| 379 | the documentation for information on how to do this. As a | 379 | the documentation for information on how to do this. As a |
| 380 | first start, put those lines in ~/.gnus.el: | 380 | first start, put those lines in @file{~/.gnus.el}: |
| 381 | 381 | ||
| 382 | @example | 382 | @example |
| 383 | (setq gnus-select-method '(nntp "news.yourprovider.net")) | 383 | (setq gnus-select-method '(nntp "news.yourprovider.net")) |
| @@ -389,7 +389,7 @@ first start, put those lines in ~/.gnus.el: | |||
| 389 | @node FAQ 3-2 | 389 | @node FAQ 3-2 |
| 390 | @subsubheading Question 3.2 | 390 | @subsubheading Question 3.2 |
| 391 | 391 | ||
| 392 | I'm working under Windows and have no idea what ~/.gnus.el means. | 392 | I'm working under Windows and have no idea what @file{~/.gnus.el} means. |
| 393 | 393 | ||
| 394 | @subsubheading Answer | 394 | @subsubheading Answer |
| 395 | 395 | ||
| @@ -421,7 +421,7 @@ to Control Panel -> System -> Advanced). There you'll find the | |||
| 421 | possibility to set environment variables. Create a new one with | 421 | possibility to set environment variables. Create a new one with |
| 422 | name HOME and value C:\myhome. Rebooting is not necessary. | 422 | name HOME and value C:\myhome. Rebooting is not necessary. |
| 423 | 423 | ||
| 424 | Now to create ~/.gnus.el, say | 424 | Now to create @file{~/.gnus.el}, say |
| 425 | @samp{C-x C-f ~/.gnus.el RET C-x C-s}. | 425 | @samp{C-x C-f ~/.gnus.el RET C-x C-s}. |
| 426 | in Emacs. | 426 | in Emacs. |
| 427 | 427 | ||
| @@ -495,7 +495,7 @@ I want Gnus to fetch news from several servers, is this possible? | |||
| 495 | 495 | ||
| 496 | Of course. You can specify more sources for articles in the | 496 | Of course. You can specify more sources for articles in the |
| 497 | variable gnus-secondary-select-methods. Add something like | 497 | variable gnus-secondary-select-methods. Add something like |
| 498 | this in ~/.gnus.el: | 498 | this in @file{~/.gnus.el}: |
| 499 | 499 | ||
| 500 | @example | 500 | @example |
| 501 | (add-to-list 'gnus-secondary-select-methods | 501 | (add-to-list 'gnus-secondary-select-methods |
| @@ -566,7 +566,7 @@ commonly used one is nnml. It stores every mail in one file | |||
| 566 | and is therefore quite fast. However you might prefer a one | 566 | and is therefore quite fast. However you might prefer a one |
| 567 | file per group approach if your file system has problems with | 567 | file per group approach if your file system has problems with |
| 568 | many small files, the nnfolder back end is then probably the | 568 | many small files, the nnfolder back end is then probably the |
| 569 | choice for you. To use nnml add the following to ~/.gnus.el: | 569 | choice for you. To use nnml add the following to @file{~/.gnus.el}: |
| 570 | 570 | ||
| 571 | @example | 571 | @example |
| 572 | (add-to-list 'gnus-secondary-select-methods '(nnml "")) | 572 | (add-to-list 'gnus-secondary-select-methods '(nnml "")) |
| @@ -591,7 +591,7 @@ it's a POP3 server, then you need something like this: | |||
| 591 | @end example | 591 | @end example |
| 592 | @noindent | 592 | @noindent |
| 593 | 593 | ||
| 594 | Make sure ~/.gnus.el isn't readable to others if you store | 594 | Make sure @file{~/.gnus.el} isn't readable to others if you store |
| 595 | your password there. If you want to read your mail from a | 595 | your password there. If you want to read your mail from a |
| 596 | traditional spool file on your local machine, it's | 596 | traditional spool file on your local machine, it's |
| 597 | 597 | ||
| @@ -630,7 +630,7 @@ OK, now you only need to tell Gnus how to send mail. If you | |||
| 630 | want to send mail via sendmail (or whichever MTA is playing | 630 | want to send mail via sendmail (or whichever MTA is playing |
| 631 | the role of sendmail on your system), you don't need to do | 631 | the role of sendmail on your system), you don't need to do |
| 632 | anything. However, if you want to send your mail to an | 632 | anything. However, if you want to send your mail to an |
| 633 | SMTP Server you need the following in your ~/.gnus.el | 633 | SMTP Server you need the following in your @file{~/.gnus.el} |
| 634 | 634 | ||
| 635 | @example | 635 | @example |
| 636 | (setq send-mail-function 'smtpmail-send-it) | 636 | (setq send-mail-function 'smtpmail-send-it) |
| @@ -650,7 +650,7 @@ There are two ways of using IMAP with Gnus. The first one is | |||
| 650 | to use IMAP like POP3, that means Gnus fetches the mail from | 650 | to use IMAP like POP3, that means Gnus fetches the mail from |
| 651 | the IMAP server and stores it on disk. If you want to do | 651 | the IMAP server and stores it on disk. If you want to do |
| 652 | this (you don't really want to do this) add the following to | 652 | this (you don't really want to do this) add the following to |
| 653 | ~/.gnus.el | 653 | @file{~/.gnus.el} |
| 654 | 654 | ||
| 655 | @example | 655 | @example |
| 656 | (add-to-list 'mail-sources '(imap :server "mail.mycorp.com" | 656 | (add-to-list 'mail-sources '(imap :server "mail.mycorp.com" |
| @@ -765,7 +765,7 @@ Loading only unread messages can be annoying if you have threaded view enabled, | |||
| 765 | @end example | 765 | @end example |
| 766 | @noindent | 766 | @noindent |
| 767 | 767 | ||
| 768 | in ~/.gnus.el to load enough old articles to prevent teared threads, replace 'some with t to load | 768 | in @file{~/.gnus.el} to load enough old articles to prevent teared threads, replace 'some with @code{t} to load |
| 769 | all articles (Warning: Both settings enlarge the amount of data which is | 769 | all articles (Warning: Both settings enlarge the amount of data which is |
| 770 | fetched when you enter a group and slow down the process of entering a group). | 770 | fetched when you enter a group and slow down the process of entering a group). |
| 771 | 771 | ||
| @@ -829,7 +829,7 @@ The variable gnus-visible-headers controls which headers | |||
| 829 | are shown, its value is a regular expression, header lines | 829 | are shown, its value is a regular expression, header lines |
| 830 | which match it are shown. So if you want author, subject, | 830 | which match it are shown. So if you want author, subject, |
| 831 | date, and if the header exists, Followup-To and MUA / NUA | 831 | date, and if the header exists, Followup-To and MUA / NUA |
| 832 | say this in ~/.gnus.el: | 832 | say this in @file{~/.gnus.el}: |
| 833 | 833 | ||
| 834 | @example | 834 | @example |
| 835 | (setq gnus-visible-headers | 835 | (setq gnus-visible-headers |
| @@ -856,7 +856,7 @@ Say | |||
| 856 | @end example | 856 | @end example |
| 857 | @noindent | 857 | @noindent |
| 858 | 858 | ||
| 859 | in ~/.gnus.el. If you don't want HTML rendered, even if there's no text alternative add | 859 | in @file{~/.gnus.el}. If you don't want HTML rendered, even if there's no text alternative add |
| 860 | 860 | ||
| 861 | @example | 861 | @example |
| 862 | (setq mm-automatic-display (remove "text/html" mm-automatic-display)) | 862 | (setq mm-automatic-display (remove "text/html" mm-automatic-display)) |
| @@ -970,7 +970,7 @@ adaptive scoring say | |||
| 970 | @end example | 970 | @end example |
| 971 | @noindent | 971 | @noindent |
| 972 | 972 | ||
| 973 | in ~/.gnus.el. | 973 | in @file{~/.gnus.el}. |
| 974 | 974 | ||
| 975 | @node FAQ 4-10 | 975 | @node FAQ 4-10 |
| 976 | @subsubheading Question 4.10 | 976 | @subsubheading Question 4.10 |
| @@ -985,7 +985,7 @@ While in group buffer move point over the group and hit | |||
| 985 | can set options for the group. At the bottom of the buffer | 985 | can set options for the group. At the bottom of the buffer |
| 986 | you'll find an item that allows you to set variables | 986 | you'll find an item that allows you to set variables |
| 987 | locally for the group. To disable threading enter | 987 | locally for the group. To disable threading enter |
| 988 | gnus-show-threads as name of variable and nil as | 988 | gnus-show-threads as name of variable and @code{nil} as |
| 989 | value. Hit button done at the top of the buffer when | 989 | value. Hit button done at the top of the buffer when |
| 990 | you're ready. | 990 | you're ready. |
| 991 | 991 | ||
| @@ -1147,7 +1147,7 @@ don't want that (you probably don't want), say | |||
| 1147 | @end example | 1147 | @end example |
| 1148 | @noindent | 1148 | @noindent |
| 1149 | 1149 | ||
| 1150 | in ~/.gnus.el. | 1150 | in @file{~/.gnus.el}. |
| 1151 | 1151 | ||
| 1152 | An example might be better than thousand words, so here's | 1152 | An example might be better than thousand words, so here's |
| 1153 | my nnmail-split-methods. Note that I send duplicates in a | 1153 | my nnmail-split-methods. Note that I send duplicates in a |
| @@ -1269,7 +1269,7 @@ For other versions of Gnus, say | |||
| 1269 | @end example | 1269 | @end example |
| 1270 | @noindent | 1270 | @noindent |
| 1271 | 1271 | ||
| 1272 | in ~/.gnus.el. | 1272 | in @file{~/.gnus.el}. |
| 1273 | 1273 | ||
| 1274 | You can reformat a paragraph by hitting @samp{M-q} | 1274 | You can reformat a paragraph by hitting @samp{M-q} |
| 1275 | (as usual). | 1275 | (as usual). |
| @@ -1303,7 +1303,7 @@ following lists are signature, signature-file, | |||
| 1303 | organization, address, name or body. The attribute name | 1303 | organization, address, name or body. The attribute name |
| 1304 | can also be a string. In that case, this will be used as | 1304 | can also be a string. In that case, this will be used as |
| 1305 | a header name, and the value will be inserted in the | 1305 | a header name, and the value will be inserted in the |
| 1306 | headers of the article; if the value is `nil', the header | 1306 | headers of the article; if the value is @code{nil}, the header |
| 1307 | name will be removed. You can also say (eval (foo bar)), | 1307 | name will be removed. You can also say (eval (foo bar)), |
| 1308 | then the function foo will be evaluated with argument bar | 1308 | then the function foo will be evaluated with argument bar |
| 1309 | and the result will be thrown away. | 1309 | and the result will be thrown away. |
| @@ -1395,7 +1395,7 @@ If you want your outgoing messages to be spell-checked, say | |||
| 1395 | @end example | 1395 | @end example |
| 1396 | @noindent | 1396 | @noindent |
| 1397 | 1397 | ||
| 1398 | In your ~/.gnus.el, if you prefer on-the-fly spell-checking say | 1398 | In your @file{~/.gnus.el}, if you prefer on-the-fly spell-checking say |
| 1399 | 1399 | ||
| 1400 | @example | 1400 | @example |
| 1401 | (add-hook 'message-mode-hook (lambda () (flyspell-mode 1))) | 1401 | (add-hook 'message-mode-hook (lambda () (flyspell-mode 1))) |
| @@ -1423,7 +1423,7 @@ Yes, say something like | |||
| 1423 | @end example | 1423 | @end example |
| 1424 | @noindent | 1424 | @noindent |
| 1425 | 1425 | ||
| 1426 | in ~/.gnus.el. Change "^de\\." and "deutsch8" to something | 1426 | in @file{~/.gnus.el}. Change "^de\\." and "deutsch8" to something |
| 1427 | that suits your needs. | 1427 | that suits your needs. |
| 1428 | 1428 | ||
| 1429 | @node FAQ 5-7 | 1429 | @node FAQ 5-7 |
| @@ -1452,7 +1452,7 @@ details. | |||
| 1452 | However, what you really want is the Insidious Big Brother | 1452 | However, what you really want is the Insidious Big Brother |
| 1453 | Database bbdb. Get it through the XEmacs package system or from | 1453 | Database bbdb. Get it through the XEmacs package system or from |
| 1454 | @uref{http://bbdb.sourceforge.net/, bbdb's homepage}. | 1454 | @uref{http://bbdb.sourceforge.net/, bbdb's homepage}. |
| 1455 | Now place the following in ~/.gnus.el, to activate bbdb for Gnus: | 1455 | Now place the following in @file{~/.gnus.el}, to activate bbdb for Gnus: |
| 1456 | 1456 | ||
| 1457 | @example | 1457 | @example |
| 1458 | (require 'bbdb) | 1458 | (require 'bbdb) |
| @@ -1532,7 +1532,7 @@ Now you only have to tell Gnus to include the X-face in your postings by saying | |||
| 1532 | @end example | 1532 | @end example |
| 1533 | @noindent | 1533 | @noindent |
| 1534 | 1534 | ||
| 1535 | in ~/.gnus.el. If you use Gnus 5.10, you can simply add an entry | 1535 | in @file{~/.gnus.el}. If you use Gnus 5.10, you can simply add an entry |
| 1536 | 1536 | ||
| 1537 | @example | 1537 | @example |
| 1538 | (x-face-file "~/.xface") | 1538 | (x-face-file "~/.xface") |
| @@ -1550,7 +1550,7 @@ newsgroups? | |||
| 1550 | 1550 | ||
| 1551 | @subsubheading Answer | 1551 | @subsubheading Answer |
| 1552 | 1552 | ||
| 1553 | Put this in ~/.gnus.el: | 1553 | Put this in @file{~/.gnus.el}: |
| 1554 | 1554 | ||
| 1555 | @example | 1555 | @example |
| 1556 | (setq gnus-confirm-mail-reply-to-news t) | 1556 | (setq gnus-confirm-mail-reply-to-news t) |
| @@ -1580,7 +1580,7 @@ How to tell Gnus not to generate a sender header? | |||
| 1580 | @subsubheading Answer | 1580 | @subsubheading Answer |
| 1581 | 1581 | ||
| 1582 | Since 5.10 Gnus doesn't generate a sender header by | 1582 | Since 5.10 Gnus doesn't generate a sender header by |
| 1583 | default. For older Gnus' try this in ~/.gnus.el: | 1583 | default. For older Gnus' try this in @file{~/.gnus.el}: |
| 1584 | 1584 | ||
| 1585 | @example | 1585 | @example |
| 1586 | (eval-after-load "message" | 1586 | (eval-after-load "message" |
| @@ -1645,7 +1645,7 @@ by saying: | |||
| 1645 | @end example | 1645 | @end example |
| 1646 | @noindent | 1646 | @noindent |
| 1647 | 1647 | ||
| 1648 | in ~/.gnus.el. If you use Gnus 5.9 or earlier, you can use this | 1648 | in @file{~/.gnus.el}. If you use Gnus 5.9 or earlier, you can use this |
| 1649 | instead (works for newer versions as well): | 1649 | instead (works for newer versions as well): |
| 1650 | 1650 | ||
| 1651 | @example | 1651 | @example |
| @@ -1745,7 +1745,7 @@ by saying @samp{O f}. However, wouldn't | |||
| 1745 | it be much more convenient to have more direct access to | 1745 | it be much more convenient to have more direct access to |
| 1746 | the archived message from Gnus? If you say yes, put this | 1746 | the archived message from Gnus? If you say yes, put this |
| 1747 | snippet by Frank Haun <pille3003@@fhaun.de> in | 1747 | snippet by Frank Haun <pille3003@@fhaun.de> in |
| 1748 | ~/.gnus.el: | 1748 | @file{~/.gnus.el}: |
| 1749 | 1749 | ||
| 1750 | @example | 1750 | @example |
| 1751 | (defun my-archive-article (&optional n) | 1751 | (defun my-archive-article (&optional n) |
| @@ -1898,7 +1898,7 @@ to another group. | |||
| 1898 | 1898 | ||
| 1899 | @subsubheading Answer | 1899 | @subsubheading Answer |
| 1900 | 1900 | ||
| 1901 | Say something like this in ~/.gnus.el: | 1901 | Say something like this in @file{~/.gnus.el}: |
| 1902 | 1902 | ||
| 1903 | @example | 1903 | @example |
| 1904 | (setq nnmail-expiry-target "nnml:expired") | 1904 | (setq nnmail-expiry-target "nnml:expired") |
| @@ -1980,7 +1980,7 @@ The Gnus agent is part of Gnus, it allows you to fetch | |||
| 1980 | mail and news and store them on disk for reading them | 1980 | mail and news and store them on disk for reading them |
| 1981 | later when you're offline. It kind of mimics offline | 1981 | later when you're offline. It kind of mimics offline |
| 1982 | newsreaders like Forte Agent. If you want to use | 1982 | newsreaders like Forte Agent. If you want to use |
| 1983 | the Agent place the following in ~/.gnus.el if you are | 1983 | the Agent place the following in @file{~/.gnus.el} if you are |
| 1984 | still using 5.8.8 or 5.9 (it's the default since 5.10): | 1984 | still using 5.8.8 or 5.9 (it's the default since 5.10): |
| 1985 | 1985 | ||
| 1986 | @example | 1986 | @example |
| @@ -2175,13 +2175,13 @@ Starting Gnus is really slow, how to speed it up? | |||
| 2175 | The reason for this could be the way Gnus reads its | 2175 | The reason for this could be the way Gnus reads its |
| 2176 | active file, see the node "The Active File" in the Gnus | 2176 | active file, see the node "The Active File" in the Gnus |
| 2177 | manual for things you might try to speed the process up. | 2177 | manual for things you might try to speed the process up. |
| 2178 | An other idea would be to byte compile your ~/.gnus.el (say | 2178 | An other idea would be to byte compile your @file{~/.gnus.el} (say |
| 2179 | @samp{M-x byte-compile-file RET ~/.gnus.el | 2179 | @samp{M-x byte-compile-file RET ~/.gnus.el |
| 2180 | RET} to do it). Finally, if you have require | 2180 | RET} to do it). Finally, if you have require |
| 2181 | statements in your .gnus, you could replace them with | 2181 | statements in your .gnus, you could replace them with |
| 2182 | eval-after-load, which loads the stuff not at startup | 2182 | eval-after-load, which loads the stuff not at startup |
| 2183 | time, but when it's needed. Say you've got this in your | 2183 | time, but when it's needed. Say you've got this in your |
| 2184 | ~/.gnus.el: | 2184 | @file{~/.gnus.el}: |
| 2185 | 2185 | ||
| 2186 | @example | 2186 | @example |
| 2187 | (require 'message) | 2187 | (require 'message) |
| @@ -2208,7 +2208,7 @@ How to speed up the process of entering a group? | |||
| 2208 | @subsubheading Answer | 2208 | @subsubheading Answer |
| 2209 | 2209 | ||
| 2210 | A speed killer is setting the variable | 2210 | A speed killer is setting the variable |
| 2211 | gnus-fetch-old-headers to anything different from nil, | 2211 | gnus-fetch-old-headers to anything different from @code{nil}, |
| 2212 | so don't do this if speed is an issue. To speed up | 2212 | so don't do this if speed is an issue. To speed up |
| 2213 | building of summary say | 2213 | building of summary say |
| 2214 | 2214 | ||
| @@ -2217,7 +2217,7 @@ building of summary say | |||
| 2217 | @end example | 2217 | @end example |
| 2218 | @noindent | 2218 | @noindent |
| 2219 | 2219 | ||
| 2220 | at the bottom of your ~/.gnus.el, this will make gnus | 2220 | at the bottom of your @file{~/.gnus.el}, this will make gnus |
| 2221 | byte-compile things like | 2221 | byte-compile things like |
| 2222 | gnus-summary-line-format. | 2222 | gnus-summary-line-format. |
| 2223 | then you could increase the value of gc-cons-threshold | 2223 | then you could increase the value of gc-cons-threshold |
| @@ -2237,7 +2237,7 @@ recent GNU Emacs, you should say | |||
| 2237 | @end example | 2237 | @end example |
| 2238 | @noindent | 2238 | @noindent |
| 2239 | 2239 | ||
| 2240 | in ~/.gnus.el (thanks to Jesper harder for the last | 2240 | in @file{~/.gnus.el} (thanks to Jesper harder for the last |
| 2241 | two suggestions). Finally if you are still using 5.8.8 | 2241 | two suggestions). Finally if you are still using 5.8.8 |
| 2242 | or 5.9 and experience speed problems with summary | 2242 | or 5.9 and experience speed problems with summary |
| 2243 | buffer generation, you definitely should update to | 2243 | buffer generation, you definitely should update to |
| @@ -2263,8 +2263,8 @@ to normal speed. | |||
| 2263 | @table @dfn | 2263 | @table @dfn |
| 2264 | 2264 | ||
| 2265 | @item ~/.gnus.el | 2265 | @item ~/.gnus.el |
| 2266 | When the term ~/.gnus.el is used it just means your Gnus | 2266 | When the term @file{~/.gnus.el} is used it just means your Gnus |
| 2267 | configuration file. You might as well call it ~/.gnus or | 2267 | configuration file. You might as well call it @file{~/.gnus} or |
| 2268 | specify another name. | 2268 | specify another name. |
| 2269 | 2269 | ||
| 2270 | @item Back End | 2270 | @item Back End |
diff --git a/doc/misc/gnus.texi b/doc/misc/gnus.texi index b2dce6db2bc..1dbb22bc617 100644 --- a/doc/misc/gnus.texi +++ b/doc/misc/gnus.texi | |||
| @@ -12537,7 +12537,7 @@ you're in, you could say something like the following: | |||
| 12537 | Modify to suit your needs. | 12537 | Modify to suit your needs. |
| 12538 | 12538 | ||
| 12539 | @vindex gnus-message-highlight-citation | 12539 | @vindex gnus-message-highlight-citation |
| 12540 | If @code{gnus-message-highlight-citation} is t, different levels of | 12540 | If @code{gnus-message-highlight-citation} is @code{t}, different levels of |
| 12541 | citations are highlighted like in Gnus article buffers also in message | 12541 | citations are highlighted like in Gnus article buffers also in message |
| 12542 | mode buffers. | 12542 | mode buffers. |
| 12543 | 12543 | ||
| @@ -20487,7 +20487,7 @@ matches. This takes a long time in big groups. | |||
| 20487 | You can inhibit this slow scoring on headers or body by setting the | 20487 | You can inhibit this slow scoring on headers or body by setting the |
| 20488 | variable @code{gnus-inhibit-slow-scoring}. If | 20488 | variable @code{gnus-inhibit-slow-scoring}. If |
| 20489 | @code{gnus-inhibit-slow-scoring} is regexp, slow scoring is inhibited if | 20489 | @code{gnus-inhibit-slow-scoring} is regexp, slow scoring is inhibited if |
| 20490 | the group matches the regexp. If it is t, slow scoring on it is | 20490 | the group matches the regexp. If it is @code{t}, slow scoring on it is |
| 20491 | inhibited for all groups. | 20491 | inhibited for all groups. |
| 20492 | 20492 | ||
| 20493 | Now, there's not much you can do about the slowness for news groups, but for | 20493 | Now, there's not much you can do about the slowness for news groups, but for |
| @@ -21414,18 +21414,19 @@ three items unique to nnir summary buffers: | |||
| 21414 | %g Article original short group name (string) | 21414 | %g Article original short group name (string) |
| 21415 | @end example | 21415 | @end example |
| 21416 | 21416 | ||
| 21417 | If nil (the default) this will use @code{gnus-summary-line-format}. | 21417 | If @code{nil} (the default) this will use @code{gnus-summary-line-format}. |
| 21418 | 21418 | ||
| 21419 | @item nnir-retrieve-headers-override-function | 21419 | @item nnir-retrieve-headers-override-function |
| 21420 | If non-nil, a function that retrieves article headers rather than using | 21420 | If non-@code{nil}, a function that retrieves article headers rather than using |
| 21421 | the gnus built-in function. This function takes an article list and | 21421 | the gnus built-in function. This function takes an article list and |
| 21422 | group as arguments and populates the `nntp-server-buffer' with the | 21422 | group as arguments and populates the `nntp-server-buffer' with the |
| 21423 | retrieved headers. It should then return either 'nov or 'headers | 21423 | retrieved headers. It should then return either 'nov or 'headers |
| 21424 | indicating the retrieved header format. Failure to retrieve headers | 21424 | indicating the retrieved header format. Failure to retrieve headers |
| 21425 | should return @code{nil}. | 21425 | should return @code{nil}. |
| 21426 | 21426 | ||
| 21427 | If this variable is nil, or if the provided function returns nil for a | 21427 | If this variable is @code{nil}, or if the provided function returns |
| 21428 | search result, @code{gnus-retrieve-headers} will be called instead." | 21428 | @code{nil} for a search result, @code{gnus-retrieve-headers} will be |
| 21429 | called instead." | ||
| 21429 | 21430 | ||
| 21430 | 21431 | ||
| 21431 | @end table | 21432 | @end table |
| @@ -21928,7 +21929,7 @@ original article yet, @code{nnmairix} will use an additional mairix | |||
| 21928 | search for determining the file name of the article. This, of course, is | 21929 | search for determining the file name of the article. This, of course, is |
| 21929 | way slower than the registry---if you set hundreds or even thousands of | 21930 | way slower than the registry---if you set hundreds or even thousands of |
| 21930 | marks this way, it might take some time. You can avoid this situation by | 21931 | marks this way, it might take some time. You can avoid this situation by |
| 21931 | setting @code{nnmairix-only-use-registry} to t. | 21932 | setting @code{nnmairix-only-use-registry} to @code{t}. |
| 21932 | 21933 | ||
| 21933 | Maybe you also want to propagate marks the other way round, i.e., if you | 21934 | Maybe you also want to propagate marks the other way round, i.e., if you |
| 21934 | tick an article in a "real" mail group, you'd like to have the same | 21935 | tick an article in a "real" mail group, you'd like to have the same |
| @@ -24874,7 +24875,7 @@ classified as spammers. | |||
| 24874 | While @code{spam-use-BBDB-exclusive} @emph{can} be used as an alias | 24875 | While @code{spam-use-BBDB-exclusive} @emph{can} be used as an alias |
| 24875 | for @code{spam-use-BBDB} as far as @code{spam.el} is concerned, it is | 24876 | for @code{spam-use-BBDB} as far as @code{spam.el} is concerned, it is |
| 24876 | @emph{not} a separate back end. If you set | 24877 | @emph{not} a separate back end. If you set |
| 24877 | @code{spam-use-BBDB-exclusive} to t, @emph{all} your BBDB splitting | 24878 | @code{spam-use-BBDB-exclusive} to @code{t}, @emph{all} your BBDB splitting |
| 24878 | will be exclusive. | 24879 | will be exclusive. |
| 24879 | 24880 | ||
| 24880 | @end defvar | 24881 | @end defvar |
diff --git a/doc/misc/htmlfontify.texi b/doc/misc/htmlfontify.texi index 1d8794d772d..d31a087be2a 100644 --- a/doc/misc/htmlfontify.texi +++ b/doc/misc/htmlfontify.texi | |||
| @@ -792,7 +792,7 @@ See: @ref{hfy-link-style-fun}. | |||
| 792 | @end lisp | 792 | @end lisp |
| 793 | 793 | ||
| 794 | Given @var{props}, a list of text-properties, return the value of the | 794 | Given @var{props}, a list of text-properties, return the value of the |
| 795 | face property, or nil. | 795 | face property, or @code{nil}. |
| 796 | 796 | ||
| 797 | @item hfy-box-to-border-assoc | 797 | @item hfy-box-to-border-assoc |
| 798 | @findex hfy-box-to-border-assoc | 798 | @findex hfy-box-to-border-assoc |
| @@ -824,7 +824,7 @@ with a class of @code{t} is considered to match any class you specify. | |||
| 824 | This matches Emacs's behavior when deciding on which face attributes to | 824 | This matches Emacs's behavior when deciding on which face attributes to |
| 825 | use, to the best of my understanding ). | 825 | use, to the best of my understanding ). |
| 826 | 826 | ||
| 827 | If @var{class} is nil, then you just get get whatever | 827 | If @var{class} is @code{nil}, then you just get get whatever |
| 828 | @code{face-attr-construct} returns; i.e., the current specification in | 828 | @code{face-attr-construct} returns; i.e., the current specification in |
| 829 | effect for @var{face}. | 829 | effect for @var{face}. |
| 830 | 830 | ||
diff --git a/doc/misc/idlwave.texi b/doc/misc/idlwave.texi index 4a150803640..40c98a358cf 100644 --- a/doc/misc/idlwave.texi +++ b/doc/misc/idlwave.texi | |||
| @@ -1645,7 +1645,7 @@ of completed words. | |||
| 1645 | 1645 | ||
| 1646 | @defopt idlwave-completion-force-default-case (@code{nil}) | 1646 | @defopt idlwave-completion-force-default-case (@code{nil}) |
| 1647 | Non-@code{nil} means completion will always honor the settings in | 1647 | Non-@code{nil} means completion will always honor the settings in |
| 1648 | @code{idlwave-completion-case}. When nil (the default), entirely lower | 1648 | @code{idlwave-completion-case}. When @code{nil} (the default), entirely lower |
| 1649 | case strings will always be completed to lower case, no matter what the | 1649 | case strings will always be completed to lower case, no matter what the |
| 1650 | settings in @code{idlwave-completion-case}. | 1650 | settings in @code{idlwave-completion-case}. |
| 1651 | @end defopt | 1651 | @end defopt |
diff --git a/doc/misc/info.texi b/doc/misc/info.texi index 144ce89707b..87e7794c61e 100644 --- a/doc/misc/info.texi +++ b/doc/misc/info.texi | |||
| @@ -151,19 +151,22 @@ Since your terminal has a relatively small number of lines on its | |||
| 151 | screen, it is necessary to give you special advice at the beginning. | 151 | screen, it is necessary to give you special advice at the beginning. |
| 152 | 152 | ||
| 153 | If the entire text you are looking at fits on the screen, the text | 153 | If the entire text you are looking at fits on the screen, the text |
| 154 | @samp{All} will be displayed at the bottom of the screen. In the | 154 | @samp{All} will be displayed near the bottom of the screen, on the |
| 155 | stand-alone Info reader, it is displayed at the bottom right corner of | 155 | mode line (usually, the line in inverse video). If you see the text |
| 156 | the screen; in Emacs, it is displayed on the modeline. If you see the | 156 | @samp{Top} instead, it means that there is more text below that does |
| 157 | text @samp{Top} instead, it means that there is more text below that | 157 | not fit. To move forward through the text and see another screenful, |
| 158 | does not fit. To move forward through the text and see another screen | 158 | press @key{SPC}, the Space bar. To move back up, press the key |
| 159 | full, press @key{SPC}, the Space bar. To move back up, press the key | ||
| 160 | labeled @samp{Backspace} or @samp{DEL} (on some keyboards, this key | 159 | labeled @samp{Backspace} or @samp{DEL} (on some keyboards, this key |
| 161 | might be labeled @samp{Delete}), or @key{S-SPC}. | 160 | might be labeled @samp{Delete}). In a graphical Emacs, you can also use |
| 161 | @kbd{S-@key{SPC}} (press and hold the @key{Shift} key and then press | ||
| 162 | @key{SPC}) to move backwards, but this does not work in the | ||
| 163 | stand-alone Info reader (nor in Emacs, if you are using it in a | ||
| 164 | text-mode terminal). | ||
| 162 | 165 | ||
| 163 | @ifinfo | 166 | @ifinfo |
| 164 | Here are 40 lines of junk, so you can try @key{SPC} and @key{DEL} (or | 167 | Here are 40 lines of junk, so you can try @key{SPC} and @key{DEL} and |
| 165 | @key{S-SPC}) and see what they do. At the end are instructions of | 168 | see what they do. At the end are instructions of what you should do |
| 166 | what you should do next. | 169 | next. |
| 167 | 170 | ||
| 168 | @format | 171 | @format |
| 169 | This is line 20 | 172 | This is line 20 |
| @@ -209,11 +212,11 @@ This is line 59 | |||
| 209 | @end format | 212 | @end format |
| 210 | 213 | ||
| 211 | If you have managed to get here, go back to the beginning with | 214 | If you have managed to get here, go back to the beginning with |
| 212 | @kbd{DEL} (or @key{S-SPC}), and come back here again, then you | 215 | @key{DEL} (or @key{BACKSPACE}), and come back here again, then you |
| 213 | understand the about the @samp{Space} and @samp{Backspace} keys. So | 216 | understand about the @samp{Space} and @samp{Backspace} keys. So now |
| 214 | now type an @kbd{n}---just one character; don't type the quotes and | 217 | type an @kbd{n}---just one character; don't type the quotes and don't |
| 215 | don't type the Return key afterward---to get to the normal start of | 218 | type the Return key afterward---to get to the normal start of the |
| 216 | the course. | 219 | course. |
| 217 | @end ifinfo | 220 | @end ifinfo |
| 218 | 221 | ||
| 219 | @node Help | 222 | @node Help |
| @@ -401,13 +404,10 @@ repeatedly. | |||
| 401 | >> Type a @key{?} now. Press @key{SPC} to see consecutive screenfuls of | 404 | >> Type a @key{?} now. Press @key{SPC} to see consecutive screenfuls of |
| 402 | the list until finished. Then type @key{SPC} several times. If | 405 | the list until finished. Then type @key{SPC} several times. If |
| 403 | you are using Emacs, the help will then go away automatically. | 406 | you are using Emacs, the help will then go away automatically. |
| 407 | If you are using the stand-alone Info reader, type @kbd{x} to | ||
| 408 | return here. | ||
| 404 | @end format | 409 | @end format |
| 405 | 410 | ||
| 406 | (If you are using the stand-alone Info reader, type @kbd{C-x 0} to | ||
| 407 | return here, that is---press and hold @key{CTRL}, type an @kbd{x}, | ||
| 408 | then release @key{CTRL} and @kbd{x}, and press @kbd{0}; that's a zero, | ||
| 409 | not the letter ``o''.) | ||
| 410 | |||
| 411 | From now on, you will encounter large nodes without warning, and | 411 | From now on, you will encounter large nodes without warning, and |
| 412 | will be expected to know how to use @key{SPC} and @key{BACKSPACE} to | 412 | will be expected to know how to use @key{SPC} and @key{BACKSPACE} to |
| 413 | move around in them without being told. Since not all terminals have | 413 | move around in them without being told. Since not all terminals have |
| @@ -478,10 +478,10 @@ you to the following node in the manual @emph{regardless of level}. | |||
| 478 | If you immediately want to go to that node, without having to scroll | 478 | If you immediately want to go to that node, without having to scroll |
| 479 | to the bottom of the screen first, you can type @kbd{]}. | 479 | to the bottom of the screen first, you can type @kbd{]}. |
| 480 | 480 | ||
| 481 | Similarly, @kbd{@key{BACKSPACE}} (or @kbd{@key{S-SPC}}) carries you to | 481 | Similarly, @kbd{@key{BACKSPACE}} carries you to the preceding node |
| 482 | the preceding node regardless of level, after you scrolled to the | 482 | regardless of level, after you scrolled to the beginning of the |
| 483 | beginning of the present node. If you want to go to the preceding | 483 | present node. If you want to go to the preceding node immediately, |
| 484 | node immediately, you can type @kbd{[}. | 484 | you can type @kbd{[}. |
| 485 | 485 | ||
| 486 | For instance, typing this sequence will come back here in three steps: | 486 | For instance, typing this sequence will come back here in three steps: |
| 487 | @kbd{[ n [}. To do the same backward, type @kbd{] p ]}. | 487 | @kbd{[ n [}. To do the same backward, type @kbd{] p ]}. |
| @@ -1214,7 +1214,7 @@ all text that could potentially be useful. | |||
| 1214 | 1214 | ||
| 1215 | @item Info-scroll-prefer-subnodes | 1215 | @item Info-scroll-prefer-subnodes |
| 1216 | If set to a non-@code{nil} value, @key{SPC} and @key{BACKSPACE} (or | 1216 | If set to a non-@code{nil} value, @key{SPC} and @key{BACKSPACE} (or |
| 1217 | @key{DEL}, or @key{S-SPC}) keys in a menu visit subnodes of the | 1217 | @key{DEL}, or @kbd{S-@key{SPC}}) keys in a menu visit subnodes of the |
| 1218 | current node before scrolling to its end or beginning, respectively. | 1218 | current node before scrolling to its end or beginning, respectively. |
| 1219 | For example, if the node's menu appears on the screen, the next | 1219 | For example, if the node's menu appears on the screen, the next |
| 1220 | @key{SPC} moves to a subnode indicated by the following menu item. | 1220 | @key{SPC} moves to a subnode indicated by the following menu item. |
diff --git a/doc/misc/mairix-el.texi b/doc/misc/mairix-el.texi index 01d9e333816..f20582659ba 100644 --- a/doc/misc/mairix-el.texi +++ b/doc/misc/mairix-el.texi | |||
| @@ -307,7 +307,7 @@ options `mairix-update-options'; the default is ``-F'' and ``-Q'' to | |||
| 307 | make updates as fast as possible. Note that by using these options, | 307 | make updates as fast as possible. Note that by using these options, |
| 308 | absolutely no integrity checking is done. If your database somehow gets | 308 | absolutely no integrity checking is done. If your database somehow gets |
| 309 | corrupted, simply delete it and update. If `mairix-synchronous-update' | 309 | corrupted, simply delete it and update. If `mairix-synchronous-update' |
| 310 | is nil (the default), mairix will be called in a subprocess so Emacs | 310 | is @code{nil} (the default), mairix will be called in a subprocess so Emacs |
| 311 | will still be usable while the update is done. | 311 | will still be usable while the update is done. |
| 312 | 312 | ||
| 313 | @end table | 313 | @end table |
diff --git a/doc/misc/message.texi b/doc/misc/message.texi index 88d8566137a..0ac2c03a6aa 100644 --- a/doc/misc/message.texi +++ b/doc/misc/message.texi | |||
| @@ -2137,7 +2137,7 @@ translation process. | |||
| 2137 | @vindex message-fill-column | 2137 | @vindex message-fill-column |
| 2138 | @cindex auto-fill | 2138 | @cindex auto-fill |
| 2139 | Local value for the column beyond which automatic line-wrapping should | 2139 | Local value for the column beyond which automatic line-wrapping should |
| 2140 | happen for message buffers. If non-nil (the default), also turn on | 2140 | happen for message buffers. If non-@code{nil} (the default), also turn on |
| 2141 | auto-fill in message buffers. | 2141 | auto-fill in message buffers. |
| 2142 | 2142 | ||
| 2143 | @item message-signature-separator | 2143 | @item message-signature-separator |
diff --git a/doc/misc/mh-e.texi b/doc/misc/mh-e.texi index d4fd6d52bb3..a5766e346e3 100644 --- a/doc/misc/mh-e.texi +++ b/doc/misc/mh-e.texi | |||
| @@ -3739,7 +3739,7 @@ when you press @key{TAB} when prompted for a folder name. | |||
| 3739 | 3739 | ||
| 3740 | The hook @code{mh-kill-folder-suppress-prompt-functions} is an abnormal | 3740 | The hook @code{mh-kill-folder-suppress-prompt-functions} is an abnormal |
| 3741 | hook run at the beginning of the command @kbd{k}. The hook functions | 3741 | hook run at the beginning of the command @kbd{k}. The hook functions |
| 3742 | are called with no arguments and should return a non-nil value to | 3742 | are called with no arguments and should return a non-@code{nil} value to |
| 3743 | suppress the normal prompt when you remove a folder. This is useful | 3743 | suppress the normal prompt when you remove a folder. This is useful |
| 3744 | for folders that are easily regenerated. The default value of | 3744 | for folders that are easily regenerated. The default value of |
| 3745 | @code{mh-search-p} suppresses the prompt on folders generated by | 3745 | @code{mh-search-p} suppresses the prompt on folders generated by |
diff --git a/doc/misc/reftex.texi b/doc/misc/reftex.texi index 5479dfd9a24..6d79d352e40 100644 --- a/doc/misc/reftex.texi +++ b/doc/misc/reftex.texi | |||
| @@ -4078,7 +4078,7 @@ group which contains all labels. | |||
| 4078 | This may also be a function to do local parsing and identify point to be | 4078 | This may also be a function to do local parsing and identify point to be |
| 4079 | in a non-standard label environment. The function must take an | 4079 | in a non-standard label environment. The function must take an |
| 4080 | argument @var{bound} and limit backward searches to this value. It | 4080 | argument @var{bound} and limit backward searches to this value. It |
| 4081 | should return either nil or a cons cell @code{(@var{function} | 4081 | should return either @code{nil} or a cons cell @code{(@var{function} |
| 4082 | . @var{position})} with the function symbol and the position where the | 4082 | . @var{position})} with the function symbol and the position where the |
| 4083 | special environment starts. See the Info documentation for an | 4083 | special environment starts. See the Info documentation for an |
| 4084 | example. | 4084 | example. |
| @@ -4235,7 +4235,7 @@ special packages like fancyref) are being used. RefTeX can and by | |||
| 4235 | default does parse around each label to detect the correct label type, | 4235 | default does parse around each label to detect the correct label type, |
| 4236 | but this process can be slow when a document contains thousands of | 4236 | but this process can be slow when a document contains thousands of |
| 4237 | labels. If you use label prefixes consistently, you may speed up | 4237 | labels. If you use label prefixes consistently, you may speed up |
| 4238 | document parsing by setting this variable to a non-nil value. RefTeX | 4238 | document parsing by setting this variable to a non-@code{nil} value. RefTeX |
| 4239 | will then compare the label prefix with the prefixes found in | 4239 | will then compare the label prefix with the prefixes found in |
| 4240 | `reftex-label-alist' and derive the correct label type in this way. | 4240 | `reftex-label-alist' and derive the correct label type in this way. |
| 4241 | Possible values for this option are: | 4241 | Possible values for this option are: |
| @@ -4822,7 +4822,7 @@ case. | |||
| 4822 | 4822 | ||
| 4823 | @defopt reftex-index-verify-function | 4823 | @defopt reftex-index-verify-function |
| 4824 | A function which is called at each match during global indexing. | 4824 | A function which is called at each match during global indexing. |
| 4825 | If the function returns nil, the current match is skipped. | 4825 | If the function returns @code{nil}, the current match is skipped. |
| 4826 | @end defopt | 4826 | @end defopt |
| 4827 | 4827 | ||
| 4828 | @defopt reftex-index-phrases-skip-indexed-matches | 4828 | @defopt reftex-index-phrases-skip-indexed-matches |
| @@ -4942,7 +4942,7 @@ escapes. | |||
| 4942 | 4942 | ||
| 4943 | @defopt reftex-revisit-to-echo | 4943 | @defopt reftex-revisit-to-echo |
| 4944 | Non-@code{nil} means, automatic citation display will revisit files if | 4944 | Non-@code{nil} means, automatic citation display will revisit files if |
| 4945 | necessary. When nil, citation display in echo area will only be active | 4945 | necessary. When @code{nil}, citation display in echo area will only be active |
| 4946 | for cached echo strings (see @code{reftex-cache-cite-echo}), or for | 4946 | for cached echo strings (see @code{reftex-cache-cite-echo}), or for |
| 4947 | @BibTeX{} database files which are already visited by a live associated | 4947 | @BibTeX{} database files which are already visited by a live associated |
| 4948 | buffers. | 4948 | buffers. |
| @@ -5275,8 +5275,8 @@ will | |||
| 5275 | - supply arguments for macros like @code{\index} (flag 5) | 5275 | - supply arguments for macros like @code{\index} (flag 5) |
| 5276 | @end example | 5276 | @end example |
| 5277 | 5277 | ||
| 5278 | You may also set the variable itself to t or nil in order to turn all | 5278 | You may also set the variable itself to @code{t} or @code{nil} in |
| 5279 | options on or off, respectively.@* | 5279 | order to turn all options on or off, respectively.@* |
| 5280 | Supplying labels in new sections and environments applies when creating | 5280 | Supplying labels in new sections and environments applies when creating |
| 5281 | sections with @kbd{C-c C-s} and environments with @kbd{C-c C-e}.@* | 5281 | sections with @kbd{C-c C-s} and environments with @kbd{C-c C-e}.@* |
| 5282 | Supplying macro arguments applies when you insert such a macro | 5282 | Supplying macro arguments applies when you insert such a macro |
| @@ -5286,7 +5286,7 @@ See the @AUCTeX{} documentation for more information. | |||
| 5286 | 5286 | ||
| 5287 | @defopt reftex-revisit-to-follow | 5287 | @defopt reftex-revisit-to-follow |
| 5288 | Non-@code{nil} means, follow-mode will revisit files if necessary. | 5288 | Non-@code{nil} means, follow-mode will revisit files if necessary. |
| 5289 | When nil, follow-mode will be suspended for stuff in unvisited files. | 5289 | When @code{nil}, follow-mode will be suspended for stuff in unvisited files. |
| 5290 | @end defopt | 5290 | @end defopt |
| 5291 | 5291 | ||
| 5292 | @defopt reftex-allow-detached-macro-args | 5292 | @defopt reftex-allow-detached-macro-args |
| @@ -5395,8 +5395,8 @@ if you'd like RefTeX to base its classification of labels on prefixes. | |||
| 5395 | This can speed-up document parsing, but may in some cases reduce the | 5395 | This can speed-up document parsing, but may in some cases reduce the |
| 5396 | quality of the context used by RefTeX to describe a label. | 5396 | quality of the context used by RefTeX to describe a label. |
| 5397 | @item | 5397 | @item |
| 5398 | Fixed bug in @code{reftex-create-bibtex-file} when @code{reftex-comment-citations} | 5398 | Fixed bug in @code{reftex-create-bibtex-file} when |
| 5399 | is non-nil. | 5399 | @code{reftex-comment-citations} is non-@code{nil}. |
| 5400 | @item | 5400 | @item |
| 5401 | Fixed bugs in indexing: Case-sensitive search, quotes before and/or | 5401 | Fixed bugs in indexing: Case-sensitive search, quotes before and/or |
| 5402 | after words. Disabled indexing in comment lines. | 5402 | after words. Disabled indexing in comment lines. |
| @@ -5743,7 +5743,7 @@ New option @code{reftex-cache-cite-echo}. | |||
| 5743 | @kbd{M-x reftex-reset-mode} now also removes the file with parsing | 5743 | @kbd{M-x reftex-reset-mode} now also removes the file with parsing |
| 5744 | info. | 5744 | info. |
| 5745 | @item | 5745 | @item |
| 5746 | Default of @code{reftex-revisit-to-follow} changed to nil. | 5746 | Default of @code{reftex-revisit-to-follow} changed to @code{nil}. |
| 5747 | @end itemize | 5747 | @end itemize |
| 5748 | 5748 | ||
| 5749 | @noindent @b{Version 3.24} | 5749 | @noindent @b{Version 3.24} |
diff --git a/doc/misc/ses.texi b/doc/misc/ses.texi index fb4d0887c68..2e1159a98fe 100644 --- a/doc/misc/ses.texi +++ b/doc/misc/ses.texi | |||
| @@ -223,7 +223,7 @@ range A1-A2. Many @acronym{SES} commands operate only on single cells, not | |||
| 223 | ranges. | 223 | ranges. |
| 224 | 224 | ||
| 225 | @table @kbd | 225 | @table @kbd |
| 226 | @item C-SPC | 226 | @item C-@key{SPC} |
| 227 | @itemx C-@@ | 227 | @itemx C-@@ |
| 228 | Set mark at point (@code{set-mark-command}). | 228 | Set mark at point (@code{set-mark-command}). |
| 229 | 229 | ||
diff --git a/doc/misc/srecode.texi b/doc/misc/srecode.texi index 7c274b4a20a..cd72656c91b 100644 --- a/doc/misc/srecode.texi +++ b/doc/misc/srecode.texi | |||
| @@ -1175,7 +1175,7 @@ The following built-in simple arguments are available: | |||
| 1175 | 1175 | ||
| 1176 | @subsubsection Argument :indent | 1176 | @subsubsection Argument :indent |
| 1177 | 1177 | ||
| 1178 | Supplies the @code{INDENT} macro. When @code{INDENT} is non-nil, then | 1178 | Supplies the @code{INDENT} macro. When @code{INDENT} is non-@code{nil}, then |
| 1179 | each line is individually indented with | 1179 | each line is individually indented with |
| 1180 | @code{indent-according-to-mode} during macro processing. | 1180 | @code{indent-according-to-mode} during macro processing. |
| 1181 | 1181 | ||
| @@ -1577,7 +1577,7 @@ start with the main entry point. | |||
| 1577 | @defun srecode-insert-fcn template dictionary &optional stream | 1577 | @defun srecode-insert-fcn template dictionary &optional stream |
| 1578 | @anchor{srecode-insert-fcn} | 1578 | @anchor{srecode-insert-fcn} |
| 1579 | Insert @var{template} using @var{dictionary} into @var{stream}. | 1579 | Insert @var{template} using @var{dictionary} into @var{stream}. |
| 1580 | If @var{stream} is nil, then use the current buffer. | 1580 | If @var{stream} is @code{nil}, then use the current buffer. |
| 1581 | @end defun | 1581 | @end defun |
| 1582 | 1582 | ||
| 1583 | @node Template Naming Conventions | 1583 | @node Template Naming Conventions |
diff --git a/doc/misc/todo-mode.texi b/doc/misc/todo-mode.texi index 44ea7fbf06e..e63bc2c64a2 100644 --- a/doc/misc/todo-mode.texi +++ b/doc/misc/todo-mode.texi | |||
| @@ -634,12 +634,12 @@ operations described in the next section.) | |||
| 634 | @item | 634 | @item |
| 635 | @samp{diary} (@kbd{y}): Override the option | 635 | @samp{diary} (@kbd{y}): Override the option |
| 636 | @code{todo-include-in-diary}; that is, add @code{todo-nondiary-marker} | 636 | @code{todo-include-in-diary}; that is, add @code{todo-nondiary-marker} |
| 637 | if the option is non-nil, omit this marker if the option is nil. | 637 | if the option is non-@code{nil}, omit this marker if the option is @code{nil}. |
| 638 | 638 | ||
| 639 | @samp{nonmarking} (@kbd{k}): Override the option | 639 | @samp{nonmarking} (@kbd{k}): Override the option |
| 640 | @code{todo-diary-nonmarking}; that is, add | 640 | @code{todo-diary-nonmarking}; that is, add |
| 641 | @code{diary-nonmarking-symbol} if the option is non-nil, omit this | 641 | @code{diary-nonmarking-symbol} if the option is non-@code{nil}, omit this |
| 642 | symbol if the option is nil. Since this symbol only applies to diary | 642 | symbol if the option is @code{nil}. Since this symbol only applies to diary |
| 643 | items, the new item is automatically marked as such, i.e., lacks | 643 | items, the new item is automatically marked as such, i.e., lacks |
| 644 | @code{todo-nondiary-marker}. | 644 | @code{todo-nondiary-marker}. |
| 645 | 645 | ||
| @@ -658,7 +658,7 @@ a weekday name as the date header instead of a year-month-day string. | |||
| 658 | @samp{time} (@kbd{t}): Prompt for entering a time string in | 658 | @samp{time} (@kbd{t}): Prompt for entering a time string in |
| 659 | the minibuffer instead of automatically inserting the current time; | 659 | the minibuffer instead of automatically inserting the current time; |
| 660 | however, typing @key{RET} at the prompt enters the current time if | 660 | however, typing @key{RET} at the prompt enters the current time if |
| 661 | @code{todo-always-add-time-string} is non-nil, otherwise it enters the | 661 | @code{todo-always-add-time-string} is non-@code{nil}, otherwise it enters the |
| 662 | empty string (i.e., no time string). | 662 | empty string (i.e., no time string). |
| 663 | 663 | ||
| 664 | @item | 664 | @item |
| @@ -669,7 +669,7 @@ down, i.e., lowering their priority, by one. | |||
| 669 | @samp{region} (@kbd{r}): Use the text of the selected region as the | 669 | @samp{region} (@kbd{r}): Use the text of the selected region as the |
| 670 | text of the new item, and insert this in accordance with the item | 670 | text of the new item, and insert this in accordance with the item |
| 671 | insertion options and other parameters passed. If the option | 671 | insertion options and other parameters passed. If the option |
| 672 | @code{todo-use-only-highlighted-region} is non-nil, then use the | 672 | @code{todo-use-only-highlighted-region} is non-@code{nil}, then use the |
| 673 | region only when it is highlighted; otherwise, use the region | 673 | region only when it is highlighted; otherwise, use the region |
| 674 | regardless of highlighting. | 674 | regardless of highlighting. |
| 675 | @end enumerate | 675 | @end enumerate |
| @@ -733,14 +733,14 @@ key again will complete the sequence. | |||
| 733 | @c @item | 733 | @c @item |
| 734 | @c @kbd{i y h} does the same as the preceding command, except that | 734 | @c @kbd{i y h} does the same as the preceding command, except that |
| 735 | @c @code{todo-nondiary-marker} is added if @code{todo-include-in-diary} is | 735 | @c @code{todo-nondiary-marker} is added if @code{todo-include-in-diary} is |
| 736 | @c non-nil and omitted if that option is nil; that is, the diary key @kbd{y} | 736 | @c non-@code{nil} and omitted if that option is @code{nil}; that is, |
| 737 | @c overrides the setting of this option. | 737 | @c the diary key @kbd{y} @c overrides the setting of this option. |
| 738 | @c @item | 738 | @c @item |
| 739 | @c @kbd{i y t h} does the same as the preceding command, except that it | 739 | @c @kbd{i y t h} does the same as the preceding command, except that it |
| 740 | @c prompts for a time string instead of automatically inserting the | 740 | @c prompts for a time string instead of automatically inserting the |
| 741 | @c current time; however, typing @key{RET} at the prompt returns the | 741 | @c current time; however, typing @key{RET} at the prompt returns the |
| 742 | @c current time if @code{todo-always-add-time-string} is non-nil, otherwise | 742 | @c current time if @code{todo-always-add-time-string} is non-@code{nil}, |
| 743 | @c the empty string (i.e., no time string). | 743 | @c otherwise the empty string (i.e., no time string). |
| 744 | @c @item | 744 | @c @item |
| 745 | @c @kbd{i y t t} does the same as the preceding command, except that it | 745 | @c @kbd{i y t t} does the same as the preceding command, except that it |
| 746 | @c prompts for the item's priority and inserts it accordingly. | 746 | @c prompts for the item's priority and inserts it accordingly. |
| @@ -815,7 +815,7 @@ of item editing parameters to edit the current item's date string. | |||
| 815 | 815 | ||
| 816 | @samp{time} (@kbd{t}): Edit the current item's time string, if | 816 | @samp{time} (@kbd{t}): Edit the current item's time string, if |
| 817 | present; otherwise, add one. Typing @key{RET} at the prompt enters | 817 | present; otherwise, add one. Typing @key{RET} at the prompt enters |
| 818 | the current time if @code{todo-always-add-time-string} is non-nil, | 818 | the current time if @code{todo-always-add-time-string} is non-@code{nil}, |
| 819 | otherwise it enters the empty string (i.e., no time string). | 819 | otherwise it enters the empty string (i.e., no time string). |
| 820 | @end enumerate | 820 | @end enumerate |
| 821 | 821 | ||
| @@ -839,7 +839,7 @@ invocation. | |||
| 839 | @samp{full} (@kbd{f}): Successively prompt for editing the year, month | 839 | @samp{full} (@kbd{f}): Successively prompt for editing the year, month |
| 840 | (with completion) and day number parts of the current item's date | 840 | (with completion) and day number parts of the current item's date |
| 841 | string, and, if the option @code{todo-always-add-time-string} is | 841 | string, and, if the option @code{todo-always-add-time-string} is |
| 842 | non-nil, also for editing its time string. | 842 | non-@code{nil}, also for editing its time string. |
| 843 | 843 | ||
| 844 | @samp{calendar} (@kbd{c}): This pops up the Emacs calendar, and after | 844 | @samp{calendar} (@kbd{c}): This pops up the Emacs calendar, and after |
| 845 | you type @key{RET} on a date in the calendar makes that date the | 845 | you type @key{RET} on a date in the calendar makes that date the |
| @@ -1029,7 +1029,7 @@ modified form of @code{y-or-n-p}, which by default only accepts @kbd{y} | |||
| 1029 | or @kbd{Y}, but not @key{SPC}, as an affirmative answer. This is to | 1029 | or @kbd{Y}, but not @key{SPC}, as an affirmative answer. This is to |
| 1030 | diminish the risk of unintentionally executing the command, which is | 1030 | diminish the risk of unintentionally executing the command, which is |
| 1031 | especially important with commands that do deletion, since there is no | 1031 | especially important with commands that do deletion, since there is no |
| 1032 | Todo command to undo a deletion. If you want to be able to use SPC for | 1032 | Todo command to undo a deletion. If you want to be able to use @key{SPC} for |
| 1033 | confirmation, enable the option @code{todo-y-with-space}. | 1033 | confirmation, enable the option @code{todo-y-with-space}. |
| 1034 | @end quotation | 1034 | @end quotation |
| 1035 | 1035 | ||
| @@ -1174,7 +1174,7 @@ of putting the todo file out of synch with the archive file. | |||
| 1174 | 1174 | ||
| 1175 | You may find it preferable not to delete empty todo categories but to | 1175 | You may find it preferable not to delete empty todo categories but to |
| 1176 | enable the option @code{todo-skip-archived-categories}. When this is | 1176 | enable the option @code{todo-skip-archived-categories}. When this is |
| 1177 | non-nil, such empty todo categories are skipped over by the sequential | 1177 | non-@code{nil}, such empty todo categories are skipped over by the sequential |
| 1178 | category navigation commands @kbd{f} and @kbd{b}, so they don't distract you | 1178 | category navigation commands @kbd{f} and @kbd{b}, so they don't distract you |
| 1179 | while navigating and you maintain the structural correspondence between | 1179 | while navigating and you maintain the structural correspondence between |
| 1180 | todo and archive files (you can also still jump to empty todo categories | 1180 | todo and archive files (you can also still jump to empty todo categories |
diff --git a/doc/misc/url.texi b/doc/misc/url.texi index 49d4b1526d8..765d97d5980 100644 --- a/doc/misc/url.texi +++ b/doc/misc/url.texi | |||
| @@ -872,7 +872,7 @@ more likely to conflict with other files. | |||
| 872 | @end defun | 872 | @end defun |
| 873 | 873 | ||
| 874 | @defun url-cache-expired | 874 | @defun url-cache-expired |
| 875 | This function returns non-nil if a cache entry has expired (or is absent). | 875 | This function returns non-@code{nil} if a cache entry has expired (or is absent). |
| 876 | The arguments are a URL and optional expiration delay in seconds | 876 | The arguments are a URL and optional expiration delay in seconds |
| 877 | (default @var{url-cache-expire-time}). | 877 | (default @var{url-cache-expire-time}). |
| 878 | @end defun | 878 | @end defun |
diff --git a/doc/misc/vip.texi b/doc/misc/vip.texi index 4008fbecd82..3d1a31c3295 100644 --- a/doc/misc/vip.texi +++ b/doc/misc/vip.texi | |||
| @@ -901,9 +901,9 @@ just type @samp{vip.el} followed by @key{RET}. If the file @file{vip.el} | |||
| 901 | already exists in the directory, Emacs will visit that file, and if not, | 901 | already exists in the directory, Emacs will visit that file, and if not, |
| 902 | the file will be created. Emacs will use the file name (@file{vip.el}, in | 902 | the file will be created. Emacs will use the file name (@file{vip.el}, in |
| 903 | this case) as the name of the buffer visiting the file. In order to make | 903 | this case) as the name of the buffer visiting the file. In order to make |
| 904 | the buffer name unique, Emacs may append @samp{<2>}, @samp{<3>} etc., to | 904 | the buffer name unique, Emacs may add a suffix (@pxref{Uniquify,,, |
| 905 | the buffer name. As the @dfn{file name completion} is provided here, you | 905 | emacs, The GNU Emacs Manual}). As @dfn{file name completion} is provided here, you |
| 906 | can sometime save typing. For instance, suppose there is only one file in the | 906 | can sometimes save typing. For instance, suppose there is only one file in the |
| 907 | default directory whose name starts with @samp{v}, that is @samp{vip.el}. | 907 | default directory whose name starts with @samp{v}, that is @samp{vip.el}. |
| 908 | Then if you just type @kbd{v @key{TAB}} then it will be completed to | 908 | Then if you just type @kbd{v @key{TAB}} then it will be completed to |
| 909 | @samp{vip.el}. Thus, in this case, you just have to type @kbd{v v @key{TAB} | 909 | @samp{vip.el}. Thus, in this case, you just have to type @kbd{v v @key{TAB} |
diff --git a/doc/misc/wisent.texi b/doc/misc/wisent.texi index 9435235ec02..dce853a13d0 100644 --- a/doc/misc/wisent.texi +++ b/doc/misc/wisent.texi | |||
| @@ -1443,7 +1443,7 @@ tokens (@pxref{Useful functions}). | |||
| 1443 | @defun wisent-skip-token | 1443 | @defun wisent-skip-token |
| 1444 | @anchor{wisent-skip-token} | 1444 | @anchor{wisent-skip-token} |
| 1445 | Skip the lookahead token in order to resume parsing. | 1445 | Skip the lookahead token in order to resume parsing. |
| 1446 | Return nil. | 1446 | Return @code{nil}. |
| 1447 | Must be used in error recovery semantic actions. | 1447 | Must be used in error recovery semantic actions. |
| 1448 | 1448 | ||
| 1449 | It typically looks like this: | 1449 | It typically looks like this: |
| @@ -1463,7 +1463,7 @@ It typically looks like this: | |||
| 1463 | @findex wisent-skip-block | 1463 | @findex wisent-skip-block |
| 1464 | @defun wisent-skip-block | 1464 | @defun wisent-skip-block |
| 1465 | Safely skip a block in order to resume parsing. | 1465 | Safely skip a block in order to resume parsing. |
| 1466 | Return nil. | 1466 | Return @code{nil}. |
| 1467 | Must be used in error recovery semantic actions. | 1467 | Must be used in error recovery semantic actions. |
| 1468 | 1468 | ||
| 1469 | A block is data between an open-delimiter (syntax class @code{(}) and | 1469 | A block is data between an open-delimiter (syntax class @code{(}) and |
diff --git a/doc/misc/woman.texi b/doc/misc/woman.texi index 565d9177d4e..5a63d3523f6 100644 --- a/doc/misc/woman.texi +++ b/doc/misc/woman.texi | |||
| @@ -630,7 +630,7 @@ the @code{man} key bindings. | |||
| 630 | Scroll the man page up the window (@code{scroll-up}). | 630 | Scroll the man page up the window (@code{scroll-up}). |
| 631 | 631 | ||
| 632 | @item @key{DEL} | 632 | @item @key{DEL} |
| 633 | @itemx @key{S-SPC} | 633 | @itemx @kbd{S-@key{SPC}} |
| 634 | @kindex DEL | 634 | @kindex DEL |
| 635 | @kindex S-SPC | 635 | @kindex S-SPC |
| 636 | @findex scroll-down | 636 | @findex scroll-down |