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 | |
| 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
61 files changed, 355 insertions, 270 deletions
diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index daccb5a2682..5d85687bd00 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog | |||
| @@ -1,5 +1,27 @@ | |||
| 1 | 2014-06-08 Glenn Morris <rgm@gnu.org> | 1 | 2014-06-08 Glenn Morris <rgm@gnu.org> |
| 2 | 2 | ||
| 3 | * entering.texi (Entering Emacs): Small fix re initial-buffer-choice. | ||
| 4 | * misc.texi (emacsclient Options): Copyedit. | ||
| 5 | |||
| 6 | * buffers.texi (Uniquify): Copyedits. | ||
| 7 | * files.texi (Visiting): Update for uniquify changes. | ||
| 8 | |||
| 9 | * dired.texi (Marks vs Flags): | ||
| 10 | * rmail.texi (Rmail Scrolling): Markup fixes re SPC. | ||
| 11 | |||
| 12 | * help.texi (Help, Misc Help): Copyedits. | ||
| 13 | |||
| 14 | * screen.texi (Menu Bar): Copyedits. | ||
| 15 | * msdog.texi (Windows Keyboard): F10 menus are now a general feature. | ||
| 16 | |||
| 17 | * frames.texi (Frame Commands): Copyedits re M-F10, F11. | ||
| 18 | * cmdargs.texi (Window Size X): Copyedits. | ||
| 19 | |||
| 20 | * ack.texi (Acknowledgments): | ||
| 21 | * emacs.texi (Acknowledgments): Updates. | ||
| 22 | |||
| 23 | 2014-06-08 Glenn Morris <rgm@gnu.org> | ||
| 24 | |||
| 3 | * ack.texi (Acknowledgments): | 25 | * ack.texi (Acknowledgments): |
| 4 | * emacs.texi (Acknowledgments): Updates. | 26 | * emacs.texi (Acknowledgments): Updates. |
| 5 | 27 | ||
diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi index 89b56da7723..54a84989e2e 100644 --- a/doc/emacs/buffers.texi +++ b/doc/emacs/buffers.texi | |||
| @@ -608,20 +608,16 @@ convenient to switch between buffers. | |||
| 608 | @cindex unique buffer names | 608 | @cindex unique buffer names |
| 609 | @cindex directories in buffer names | 609 | @cindex directories in buffer names |
| 610 | When several buffers visit identically-named files, Emacs must give | 610 | When several buffers visit identically-named files, Emacs must give |
| 611 | the buffers distinct names. The default method | 611 | the buffers distinct names. The default method adds a suffix based on |
| 612 | (@code{uniquify-buffer-name-style} set to | 612 | the names of the directories that contain the files. For example, if |
| 613 | @code{post-forward-angle-brackets}) for making buffer names unique | 613 | you visit files @file{/foo/bar/mumble/name} and |
| 614 | adds @samp{<dir1>}, @samp{<dir2>}, etc.@: to the end of the buffer | 614 | @file{/baz/quux/mumble/name} at the same time, their buffers will be |
| 615 | names, where @file{dir1} and @file{dir2} are the minimal parts of the | 615 | named @samp{name<bar/mumble>} and @samp{name<quux/mumble>}, respectively. |
| 616 | leading directories needed to make the buffer name unique. For | 616 | Emacs adds as many directory parts as are needed to make a unique name. |
| 617 | example, if you have files @file{/foo/bar/mumble/name} and | ||
| 618 | @file{/baz/quux/mumble/name} visited, their buffers will be named | ||
| 619 | @samp{name<bar/mumble>} and @samp{name<quux/mumble>} correspondingly. | ||
| 620 | 617 | ||
| 621 | @vindex uniquify-buffer-name-style | 618 | @vindex uniquify-buffer-name-style |
| 622 | There are several styles to make buffer names unique. To select | 619 | You can choose from several different styles for constructing unique |
| 623 | one, customize the variable @code{uniquify-buffer-name-style} | 620 | buffer names, by customizing the option @code{uniquify-buffer-name-style}. |
| 624 | (@pxref{Easy Customization}). | ||
| 625 | 621 | ||
| 626 | The @code{forward} naming method includes part of the file's | 622 | The @code{forward} naming method includes part of the file's |
| 627 | directory name at the beginning of the buffer name; using this method, | 623 | directory name at the beginning of the buffer name; using this method, |
| @@ -631,8 +627,8 @@ buffers visiting the files @file{/u/rms/tmp/Makefile} and | |||
| 631 | 627 | ||
| 632 | In contrast, the @code{post-forward} naming method would call the | 628 | In contrast, the @code{post-forward} naming method would call the |
| 633 | buffers @samp{Makefile|tmp} and @samp{Makefile|zaphod}. The default | 629 | buffers @samp{Makefile|tmp} and @samp{Makefile|zaphod}. The default |
| 634 | method @code{post-forward-angle-brackets} is like @code{post-forward} | 630 | method @code{post-forward-angle-brackets} is like @code{post-forward}, |
| 635 | except that it prepends the unique path in angle brackets. The | 631 | except that it encloses the unique path in angle brackets. The |
| 636 | @code{reverse} naming method would call them @samp{Makefile\tmp} and | 632 | @code{reverse} naming method would call them @samp{Makefile\tmp} and |
| 637 | @samp{Makefile\zaphod}. The nontrivial difference between | 633 | @samp{Makefile\zaphod}. The nontrivial difference between |
| 638 | @code{post-forward} and @code{reverse} occurs when just one directory | 634 | @code{post-forward} and @code{reverse} occurs when just one directory |
| @@ -641,8 +637,7 @@ the directory names in reverse order, so that @file{/top/middle/file} | |||
| 641 | becomes @samp{file\middle\top}, while @code{post-forward} puts them in | 637 | becomes @samp{file\middle\top}, while @code{post-forward} puts them in |
| 642 | forward order after the file name, as in @samp{file|top/middle}. If | 638 | forward order after the file name, as in @samp{file|top/middle}. If |
| 643 | @code{uniquify-buffer-name-style} is set to @code{nil}, the buffer | 639 | @code{uniquify-buffer-name-style} is set to @code{nil}, the buffer |
| 644 | names simply get a @samp{<2>} etc. prepended. This used to be the | 640 | names simply get @samp{<2>}, @samp{<3>}, etc. appended. |
| 645 | default behavior in Emacs versions up to 24.4. | ||
| 646 | 641 | ||
| 647 | Which rule to follow for putting the directory names in the buffer | 642 | Which rule to follow for putting the directory names in the buffer |
| 648 | name is not very important if you are going to @emph{look} at the | 643 | name is not very important if you are going to @emph{look} at the |
diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi index ce7af79076e..8b3654dae68 100644 --- a/doc/emacs/cmdargs.texi +++ b/doc/emacs/cmdargs.texi | |||
| @@ -901,30 +901,33 @@ the initial frame. | |||
| 901 | @itemx --fullscreen | 901 | @itemx --fullscreen |
| 902 | @opindex --fullscreen | 902 | @opindex --fullscreen |
| 903 | @cindex fullscreen, command-line argument | 903 | @cindex fullscreen, command-line argument |
| 904 | Specify that width and height shall be the size of the screen. Normally | 904 | Specify that width and height should be that of the screen. Normally |
| 905 | no window manager decorations are shown. | 905 | no window manager decorations are shown. (After starting Emacs, |
| 906 | you can toggle this state using @key{F11}, @code{toggle-frame-fullscreen}.) | ||
| 906 | 907 | ||
| 907 | @item -mm | 908 | @item -mm |
| 908 | @opindex -mm | 909 | @opindex -mm |
| 909 | @itemx --maximized | 910 | @itemx --maximized |
| 910 | @opindex --maximized | 911 | @opindex --maximized |
| 911 | @cindex maximized, command-line argument | 912 | @cindex maximized, command-line argument |
| 912 | Specify that the Emacs frame shall be maximized. This normally | 913 | Specify that the Emacs frame should be maximized. This normally |
| 913 | means that the frame has window manager decorations. | 914 | means that the frame has window manager decorations. |
| 915 | (After starting Emacs, you can toggle this state using @kbd{M-F10}, | ||
| 916 | @code{toggle-frame-maximized}.) | ||
| 914 | 917 | ||
| 915 | @item -fh | 918 | @item -fh |
| 916 | @opindex -fh | 919 | @opindex -fh |
| 917 | @itemx --fullheight | 920 | @itemx --fullheight |
| 918 | @opindex --fullheight | 921 | @opindex --fullheight |
| 919 | @cindex fullheight, command-line argument | 922 | @cindex fullheight, command-line argument |
| 920 | Specify that the height shall be the height of the screen. | 923 | Specify that the height should be the height of the screen. |
| 921 | 924 | ||
| 922 | @item -fw | 925 | @item -fw |
| 923 | @opindex -fw | 926 | @opindex -fw |
| 924 | @itemx --fullwidth | 927 | @itemx --fullwidth |
| 925 | @opindex --fullwidth | 928 | @opindex --fullwidth |
| 926 | @cindex fullwidth, command-line argument | 929 | @cindex fullwidth, command-line argument |
| 927 | Specify that the width shall be the width of the screen. | 930 | Specify that the width should be the width of the screen. |
| 928 | @end table | 931 | @end table |
| 929 | 932 | ||
| 930 | @noindent | 933 | @noindent |
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi index 4e9dfd5d12a..c7dace619e9 100644 --- a/doc/emacs/dired.texi +++ b/doc/emacs/dired.texi | |||
| @@ -522,7 +522,7 @@ flags on all the files that have no marks, while unflagging all those | |||
| 522 | that already have @samp{D} flags: | 522 | that already have @samp{D} flags: |
| 523 | 523 | ||
| 524 | @example | 524 | @example |
| 525 | * c D t * c SPC D * c t SPC | 525 | * c D t * c @key{SPC} D * c t @key{SPC} |
| 526 | @end example | 526 | @end example |
| 527 | 527 | ||
| 528 | This assumes that no files were already marked with @samp{t}. | 528 | This assumes that no files were already marked with @samp{t}. |
diff --git a/doc/emacs/entering.texi b/doc/emacs/entering.texi index 71b1fc839ac..f8ab4eb971a 100644 --- a/doc/emacs/entering.texi +++ b/doc/emacs/entering.texi | |||
| @@ -76,12 +76,17 @@ information about @file{site-start.el}.} | |||
| 76 | You can also force Emacs to display a file or directory at startup | 76 | You can also force Emacs to display a file or directory at startup |
| 77 | by setting the variable @code{initial-buffer-choice} to a string | 77 | by setting the variable @code{initial-buffer-choice} to a string |
| 78 | naming that file or directory. The value of | 78 | naming that file or directory. The value of |
| 79 | @code{initial-buffer-choice} may also be a function which should | 79 | @code{initial-buffer-choice} may also be a function (of no arguments) |
| 80 | return a buffer which is then displayed. @code{initial-buffer-choice} | 80 | that should return a buffer which is then displayed. |
| 81 | may also be @code{t} in which case the @file{*scratch*} buffer will be | 81 | @ignore |
| 82 | shown. In any case, even if you specify one or more files on the | 82 | @c I do not think this should be mentioned. AFAICS it is just a dodge |
| 83 | command line, Emacs opens but does not display them if | 83 | @c around inhibit-startup-screen not being settable on a site-wide basis. |
| 84 | @code{initial-buffer-choice} is non-nil. | 84 | @code{initial-buffer-choice} may also be @code{t} in which case the |
| 85 | @file{*scratch*} buffer will be shown. | ||
| 86 | @end ignore | ||
| 87 | If @code{initial-buffer-choice} is non-@code{nil}, then if you specify | ||
| 88 | any files on the command line, Emacs still visits them, but does not | ||
| 89 | display them initially. | ||
| 85 | 90 | ||
| 86 | @node Exiting | 91 | @node Exiting |
| 87 | @section Exiting Emacs | 92 | @section Exiting Emacs |
diff --git a/doc/emacs/files.texi b/doc/emacs/files.texi index 894e61d0f04..ee80c49af0b 100644 --- a/doc/emacs/files.texi +++ b/doc/emacs/files.texi | |||
| @@ -171,9 +171,9 @@ the mode line (@pxref{Mode Line}). Emacs normally constructs the | |||
| 171 | buffer name from the file name, omitting the directory name. For | 171 | buffer name from the file name, omitting the directory name. For |
| 172 | example, a file named @file{/usr/rms/emacs.tex} is visited in a buffer | 172 | example, a file named @file{/usr/rms/emacs.tex} is visited in a buffer |
| 173 | named @samp{emacs.tex}. If there is already a buffer with that name, | 173 | named @samp{emacs.tex}. If there is already a buffer with that name, |
| 174 | Emacs constructs a unique name; the normal method is to append | 174 | Emacs constructs a unique name; the normal method is to add a suffix |
| 175 | @samp{<2>}, @samp{<3>}, and so on, but you can select other methods. | 175 | based on the directory name (e.g., @samp{<rms>}, @samp{<tmp>}, |
| 176 | @xref{Uniquify}. | 176 | and so on), but you can select other methods. @xref{Uniquify}. |
| 177 | 177 | ||
| 178 | @cindex creating files | 178 | @cindex creating files |
| 179 | To create a new file, just visit it using the same command, @kbd{C-x | 179 | To create a new file, just visit it using the same command, @kbd{C-x |
diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index cd8347369d3..036e8cf65eb 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi | |||
| @@ -457,12 +457,16 @@ Delete all frames on the current terminal, except the selected one. | |||
| 457 | @item M-<F10> | 457 | @item M-<F10> |
| 458 | @kindex M-<F10> | 458 | @kindex M-<F10> |
| 459 | @findex toggle-frame-maximized | 459 | @findex toggle-frame-maximized |
| 460 | Toggle maximization state of the current frame. | 460 | Toggle the maximization state of the current frame. When a frame is |
| 461 | maximized, it fills the screen. | ||
| 461 | 462 | ||
| 462 | @item <F11> | 463 | @item <F11> |
| 463 | @kindex <F11> | 464 | @kindex <F11> |
| 464 | @findex toggle-frame-fullscreen | 465 | @findex toggle-frame-fullscreen |
| 465 | Toggle fullscreen mode of the current frame. | 466 | Toggle fullscreen mode for the current frame. (The difference |
| 467 | between ``fullscreen'' and ``maximized'' is normally that the former | ||
| 468 | hides window manager decorations, giving slightly more screen space to | ||
| 469 | Emacs itself.) | ||
| 466 | @end table | 470 | @end table |
| 467 | 471 | ||
| 468 | The @kbd{C-x 5 0} (@code{delete-frame}) command deletes the selected | 472 | The @kbd{C-x 5 0} (@code{delete-frame}) command deletes the selected |
diff --git a/doc/emacs/help.texi b/doc/emacs/help.texi index e6cf46acbe5..f47600d97ec 100644 --- a/doc/emacs/help.texi +++ b/doc/emacs/help.texi | |||
| @@ -55,12 +55,12 @@ This displays the available Emacs packages based on keywords. | |||
| 55 | @xref{Package Keywords}. | 55 | @xref{Package Keywords}. |
| 56 | @end table | 56 | @end table |
| 57 | 57 | ||
| 58 | @kbd{C-h}, @key{F1}, or @kbd{?} means ``help'' in various other | 58 | @kbd{C-h} or @key{F1} mean ``help'' in various other contexts as |
| 59 | contexts as well. For instance, you can type them after a prefix key | 59 | well. For instance, you can type them after a prefix key to view a |
| 60 | to view a list of the keys that can follow the prefix key. (A few | 60 | list of the keys that can follow the prefix key. (You can also use |
| 61 | prefix keys don't support @kbd{C-h} or @kbd{?} in this way, because | 61 | @kbd{?} in this context. A few prefix keys don't support @kbd{C-h} |
| 62 | they define other meanings for it, but they all support @key{F1} for | 62 | or @kbd{?} in this way, because they define other meanings for those |
| 63 | help.) | 63 | inputs, but they all support @key{F1}.) |
| 64 | 64 | ||
| 65 | @menu | 65 | @menu |
| 66 | * Help Summary:: Brief list of all Help commands. | 66 | * Help Summary:: Brief list of all Help commands. |
| @@ -556,10 +556,10 @@ Emacs Lisp Reference Manual}). | |||
| 556 | typing @kbd{C-h}, @kbd{?}, or @key{F1} | 556 | typing @kbd{C-h}, @kbd{?}, or @key{F1} |
| 557 | (@code{describe-prefix-bindings}) after the prefix key. (There are a | 557 | (@code{describe-prefix-bindings}) after the prefix key. (There are a |
| 558 | few prefix keys for which not all of these keys work---those that | 558 | few prefix keys for which not all of these keys work---those that |
| 559 | provide their own bindings for one of them. One of these prefix keys | 559 | provide their own bindings for that key. One of these prefix keys |
| 560 | is @key{ESC} in combination with @kbd{C-h}, because @kbd{@key{ESC} C-h} is | 560 | is @key{ESC}, because @kbd{@key{ESC} C-h} is actually @kbd{C-M-h}, |
| 561 | actually @kbd{C-M-h}, which marks a defun. However, @kbd{@key{ESC} @key{F1}} | 561 | which marks a defun. However, @kbd{@key{ESC} @key{F1}} and |
| 562 | and @kbd{@key{ESC} ?} work fine.) | 562 | @kbd{@key{ESC} ?} work fine.) |
| 563 | 563 | ||
| 564 | @node Help Files | 564 | @node Help Files |
| 565 | @section Help Files | 565 | @section Help Files |
diff --git a/doc/emacs/misc.texi b/doc/emacs/misc.texi index 8a8da2789d4..ae1aefcee76 100644 --- a/doc/emacs/misc.texi +++ b/doc/emacs/misc.texi | |||
| @@ -1560,9 +1560,9 @@ option, like the @samp{-t} option, creates a new frame in the server's | |||
| 1560 | current text terminal. @xref{Windows Startup}. | 1560 | current text terminal. @xref{Windows Startup}. |
| 1561 | 1561 | ||
| 1562 | If you omit a filename argument while supplying the @samp{-c} option, | 1562 | If you omit a filename argument while supplying the @samp{-c} option, |
| 1563 | the new frame displays the @file{*scratch*} buffer by default. This | 1563 | the new frame displays the @file{*scratch*} buffer by default. You |
| 1564 | behavior can be customized using the variable | 1564 | can customize this behavior with the variable @code{initial-buffer-choice} |
| 1565 | @code{initial-buffer-choice} (@pxref{Entering Emacs}). | 1565 | (@pxref{Entering Emacs}). |
| 1566 | 1566 | ||
| 1567 | @item -F @var{alist} | 1567 | @item -F @var{alist} |
| 1568 | @itemx --frame-parameters=@var{alist} | 1568 | @itemx --frame-parameters=@var{alist} |
diff --git a/doc/emacs/msdog.texi b/doc/emacs/msdog.texi index 4787f98c7ed..7c5b3600728 100644 --- a/doc/emacs/msdog.texi +++ b/doc/emacs/msdog.texi | |||
| @@ -458,13 +458,6 @@ before Microsoft was founded.) Examples of conflicts include | |||
| 458 | You can redefine some of them with meanings more like the MS-Windows | 458 | You can redefine some of them with meanings more like the MS-Windows |
| 459 | meanings by enabling CUA Mode (@pxref{CUA Bindings}). | 459 | meanings by enabling CUA Mode (@pxref{CUA Bindings}). |
| 460 | 460 | ||
| 461 | @kindex F10 @r{(MS-Windows)} | ||
| 462 | @cindex menu bar access using keyboard @r{(MS-Windows)} | ||
| 463 | The @key{F10} key on Windows activates the menu bar in a way that | ||
| 464 | makes it possible to use the menus without a mouse. In this mode, the | ||
| 465 | arrow keys traverse the menus, @key{RET} selects a highlighted menu | ||
| 466 | item, and @key{ESC} closes the menu. | ||
| 467 | |||
| 468 | @iftex | 461 | @iftex |
| 469 | @inforef{Windows Keyboard, , emacs}, for information about additional | 462 | @inforef{Windows Keyboard, , emacs}, for information about additional |
| 470 | Windows-specific variables in this category. | 463 | Windows-specific variables in this category. |
diff --git a/doc/emacs/rmail.texi b/doc/emacs/rmail.texi index 6ba252393f6..6fab25a187d 100644 --- a/doc/emacs/rmail.texi +++ b/doc/emacs/rmail.texi | |||
| @@ -114,7 +114,7 @@ Scroll to end of message (@code{rmail-end-of-message}). | |||
| 114 | @kindex S-SPC @r{(Rmail)} | 114 | @kindex S-SPC @r{(Rmail)} |
| 115 | Since the most common thing to do while reading a message is to | 115 | Since the most common thing to do while reading a message is to |
| 116 | scroll through it by screenfuls, Rmail makes @key{SPC} and @key{DEL} | 116 | scroll through it by screenfuls, Rmail makes @key{SPC} and @key{DEL} |
| 117 | (or @key{S-SPC}) do the same as @kbd{C-v} (@code{scroll-up-command}) | 117 | (or @kbd{S-@key{SPC}}) do the same as @kbd{C-v} (@code{scroll-up-command}) |
| 118 | and @kbd{M-v} (@code{scroll-down-command}) respectively. | 118 | and @kbd{M-v} (@code{scroll-down-command}) respectively. |
| 119 | 119 | ||
| 120 | @kindex . @r{(Rmail)} | 120 | @kindex . @r{(Rmail)} |
| @@ -753,7 +753,7 @@ in replies, using the variable @code{mail-dont-reply-to-names}. Its | |||
| 753 | value should be a regular expression; any recipients that match are | 753 | value should be a regular expression; any recipients that match are |
| 754 | excluded from the @samp{CC} field. They are also excluded from the | 754 | excluded from the @samp{CC} field. They are also excluded from the |
| 755 | @samp{To} field, unless this would leave the field empty. If this | 755 | @samp{To} field, unless this would leave the field empty. If this |
| 756 | variable is nil, then the first time you compose a reply it is | 756 | variable is @code{nil}, then the first time you compose a reply it is |
| 757 | initialized to a default value that matches your own address. | 757 | initialized to a default value that matches your own address. |
| 758 | 758 | ||
| 759 | To omit the @samp{CC} field completely for a particular reply, enter | 759 | To omit the @samp{CC} field completely for a particular reply, enter |
| @@ -962,7 +962,7 @@ making any kind of summary discards any previous summary. | |||
| 962 | use for the summary window. The variable | 962 | use for the summary window. The variable |
| 963 | @code{rmail-summary-line-count-flag} controls whether the summary line | 963 | @code{rmail-summary-line-count-flag} controls whether the summary line |
| 964 | for a message should include the line count of the message. Setting | 964 | for a message should include the line count of the message. Setting |
| 965 | this option to nil might speed up the generation of summaries. | 965 | this option to @code{nil} might speed up the generation of summaries. |
| 966 | 966 | ||
| 967 | @node Rmail Summary Edit | 967 | @node Rmail Summary Edit |
| 968 | @subsection Editing in Summaries | 968 | @subsection Editing in Summaries |
diff --git a/doc/emacs/screen.texi b/doc/emacs/screen.texi index d26b3bb49ff..3c254268ed2 100644 --- a/doc/emacs/screen.texi +++ b/doc/emacs/screen.texi | |||
| @@ -285,10 +285,7 @@ performs various commands. @xref{Mode Line Mouse}. | |||
| 285 | can use to perform common operations. There's no need to list them | 285 | can use to perform common operations. There's no need to list them |
| 286 | here, as you can more easily see them yourself. | 286 | here, as you can more easily see them yourself. |
| 287 | 287 | ||
| 288 | @kindex M-` | 288 | On a display that supports a mouse, you can use the mouse to choose a |
| 289 | @kindex F10 | ||
| 290 | @findex menu-bar-open | ||
| 291 | On a display that support a mouse, you can use the mouse to choose a | ||
| 292 | command from the menu bar. An arrow on the right edge of a menu item | 289 | command from the menu bar. An arrow on the right edge of a menu item |
| 293 | means it leads to a subsidiary menu, or @dfn{submenu}. A @samp{...} | 290 | means it leads to a subsidiary menu, or @dfn{submenu}. A @samp{...} |
| 294 | at the end of a menu item means that the command will prompt you for | 291 | at the end of a menu item means that the command will prompt you for |
| @@ -300,12 +297,16 @@ itself. To view the full command name and documentation for a menu | |||
| 300 | item, type @kbd{C-h k}, and then select the menu bar with the mouse in | 297 | item, type @kbd{C-h k}, and then select the menu bar with the mouse in |
| 301 | the usual way (@pxref{Key Help}). | 298 | the usual way (@pxref{Key Help}). |
| 302 | 299 | ||
| 300 | @kindex F10 | ||
| 301 | @findex menu-bar-open | ||
| 302 | @cindex menu bar access using keyboard | ||
| 303 | Instead of using the mouse, you can also invoke the first menu bar | 303 | Instead of using the mouse, you can also invoke the first menu bar |
| 304 | item by pressing @key{F10} (to run the command @code{menu-bar-open}). | 304 | item by pressing @key{F10} (to run the command @code{menu-bar-open}). |
| 305 | You can then navigate the menus with the arrow keys. To activate a | 305 | You can then navigate the menus with the arrow keys. To activate a |
| 306 | selected menu item, press @key{RET}; to cancel menu navigation, press | 306 | selected menu item, press @key{RET}; to cancel menu navigation, press |
| 307 | @kbd{C-g} or @kbd{@key{ESC} @key{ESC} @key{ESC}}. | 307 | @kbd{C-g} or @kbd{@key{ESC} @key{ESC} @key{ESC}}. |
| 308 | 308 | ||
| 309 | @kindex M-` | ||
| 309 | @findex tmm-menubar | 310 | @findex tmm-menubar |
| 310 | @vindex tty-menu-open-use-tmm | 311 | @vindex tty-menu-open-use-tmm |
| 311 | On a text terminal, you can optionally access the menu-bar menus in | 312 | On a text terminal, you can optionally access the menu-bar menus in |
diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog index 74557361eab..93128962c33 100644 --- a/doc/lispref/ChangeLog +++ b/doc/lispref/ChangeLog | |||
| @@ -1,5 +1,13 @@ | |||
| 1 | 2014-06-08 Glenn Morris <rgm@gnu.org> | 1 | 2014-06-08 Glenn Morris <rgm@gnu.org> |
| 2 | 2 | ||
| 3 | * os.texi (Startup Summary): Small fix for initial-buffer-choice. | ||
| 4 | |||
| 5 | * files.texi (Subroutines of Visiting): Mention uniquify. | ||
| 6 | |||
| 7 | * numbers.texi (Comparison of Numbers): Copyedits. | ||
| 8 | |||
| 9 | 2014-06-08 Glenn Morris <rgm@gnu.org> | ||
| 10 | |||
| 3 | * display.texi (Window Systems): Remove window-setup-hook. | 11 | * display.texi (Window Systems): Remove window-setup-hook. |
| 4 | * os.texi (Startup Summary, Init File): | 12 | * os.texi (Startup Summary, Init File): |
| 5 | Improve description of window-setup-hook. | 13 | Improve description of window-setup-hook. |
diff --git a/doc/lispref/anti.texi b/doc/lispref/anti.texi index 3de9f4ab9d1..2ca2290a022 100644 --- a/doc/lispref/anti.texi +++ b/doc/lispref/anti.texi | |||
| @@ -30,7 +30,7 @@ minimum of fuss. But @xref{Dynamic Binding Tips}, for tips to avoid | |||
| 30 | making your programs hard to understand. | 30 | making your programs hard to understand. |
| 31 | 31 | ||
| 32 | @item | 32 | @item |
| 33 | Calling a minor mode function from Lisp with a nil or omitted argument | 33 | Calling a minor mode function from Lisp with a @code{nil} or omitted argument |
| 34 | does not enable the minor mode unconditionally; instead, it toggles | 34 | does not enable the minor mode unconditionally; instead, it toggles |
| 35 | the minor mode---which is the straightforward thing to do, since that | 35 | the minor mode---which is the straightforward thing to do, since that |
| 36 | is the behavior when invoked interactively. One downside is that it | 36 | is the behavior when invoked interactively. One downside is that it |
diff --git a/doc/lispref/display.texi b/doc/lispref/display.texi index b4f987bb2a8..e0349e4ca0c 100644 --- a/doc/lispref/display.texi +++ b/doc/lispref/display.texi | |||
| @@ -1720,10 +1720,10 @@ Properties}. | |||
| 1720 | 1720 | ||
| 1721 | @defun overlays-at pos &optional sorted | 1721 | @defun overlays-at pos &optional sorted |
| 1722 | This function returns a list of all the overlays that cover the character at | 1722 | This function returns a list of all the overlays that cover the character at |
| 1723 | position @var{pos} in the current buffer. If @var{sorted} is non-nil, the list | 1723 | position @var{pos} in the current buffer. If @var{sorted} is non-@code{nil}, |
| 1724 | is in decreasing order of priority, otherwise it is in no particular order. | 1724 | the list is in decreasing order of priority, otherwise it is in no particular |
| 1725 | An overlay contains position @var{pos} if it begins at or before @var{pos}, and | 1725 | order. An overlay contains position @var{pos} if it begins at or before |
| 1726 | ends after @var{pos}. | 1726 | @var{pos}, and ends after @var{pos}. |
| 1727 | 1727 | ||
| 1728 | To illustrate usage, here is a Lisp function that returns a list of the | 1728 | To illustrate usage, here is a Lisp function that returns a list of the |
| 1729 | overlays that specify property @var{prop} for the character at point: | 1729 | overlays that specify property @var{prop} for the character at point: |
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index fcfd37e987d..ac77b94d8f6 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi | |||
| @@ -254,11 +254,16 @@ is permanent local, so it is unaffected by changes of major modes. | |||
| 254 | which are sometimes useful in user Lisp code: @code{create-file-buffer} | 254 | which are sometimes useful in user Lisp code: @code{create-file-buffer} |
| 255 | and @code{after-find-file}. This section explains how to use them. | 255 | and @code{after-find-file}. This section explains how to use them. |
| 256 | 256 | ||
| 257 | @c FIXME This does not describe the default behavior, because | ||
| 258 | @c uniquify is enabled by default and advises this function. | ||
| 259 | @c This is confusing. uniquify should be folded into the function proper. | ||
| 257 | @defun create-file-buffer filename | 260 | @defun create-file-buffer filename |
| 258 | This function creates a suitably named buffer for visiting | 261 | This function creates a suitably named buffer for visiting |
| 259 | @var{filename}, and returns it. It uses @var{filename} (sans directory) | 262 | @var{filename}, and returns it. It uses @var{filename} (sans directory) |
| 260 | as the name if that name is free; otherwise, it appends a string such as | 263 | as the name if that name is free; otherwise, it appends a string such as |
| 261 | @samp{<2>} to get an unused name. See also @ref{Creating Buffers}. | 264 | @samp{<2>} to get an unused name. See also @ref{Creating Buffers}. |
| 265 | Note that the @file{uniquify} library affects the result of this | ||
| 266 | function. @xref{Uniquify,,, emacs, The GNU Emacs Manual}. | ||
| 262 | 267 | ||
| 263 | @strong{Please note:} @code{create-file-buffer} does @emph{not} | 268 | @strong{Please note:} @code{create-file-buffer} does @emph{not} |
| 264 | associate the new buffer with a file and does not select the buffer. | 269 | associate the new buffer with a file and does not select the buffer. |
diff --git a/doc/lispref/keymaps.texi b/doc/lispref/keymaps.texi index a2168d3e53a..7cc2b393456 100644 --- a/doc/lispref/keymaps.texi +++ b/doc/lispref/keymaps.texi | |||
| @@ -2901,7 +2901,7 @@ Documentation}). | |||
| 2901 | 2901 | ||
| 2902 | @item :key-sequence @var{keys} | 2902 | @item :key-sequence @var{keys} |
| 2903 | @var{keys} is a hint for speeding up Emacs's first display of the | 2903 | @var{keys} is a hint for speeding up Emacs's first display of the |
| 2904 | menu. It should be nil if you know that the menu item has no keyboard | 2904 | menu. It should be @code{nil} if you know that the menu item has no keyboard |
| 2905 | equivalent; otherwise it should be a string or vector specifying a | 2905 | equivalent; otherwise it should be a string or vector specifying a |
| 2906 | keyboard equivalent for the menu item. | 2906 | keyboard equivalent for the menu item. |
| 2907 | 2907 | ||
| @@ -2929,7 +2929,7 @@ anything else (meaning an ordinary menu item). | |||
| 2929 | 2929 | ||
| 2930 | @item :selected @var{selected} | 2930 | @item :selected @var{selected} |
| 2931 | @var{selected} is an expression; the checkbox or radio button is | 2931 | @var{selected} is an expression; the checkbox or radio button is |
| 2932 | selected whenever the expression's value is non-nil. | 2932 | selected whenever the expression's value is non-@code{nil}. |
| 2933 | 2933 | ||
| 2934 | @item :help @var{help} | 2934 | @item :help @var{help} |
| 2935 | @var{help} is a string describing the menu item. | 2935 | @var{help} is a string describing the menu item. |
diff --git a/doc/lispref/modes.texi b/doc/lispref/modes.texi index c30547e65ab..e23e2685a7c 100644 --- a/doc/lispref/modes.texi +++ b/doc/lispref/modes.texi | |||
| @@ -702,7 +702,7 @@ mode and minor modes. It uses the @code{documentation} function to | |||
| 702 | retrieve the documentation strings of the major and minor mode | 702 | retrieve the documentation strings of the major and minor mode |
| 703 | commands (@pxref{Accessing Documentation}). | 703 | commands (@pxref{Accessing Documentation}). |
| 704 | 704 | ||
| 705 | If called from Lisp with a non-nil @var{buffer} argument, this | 705 | If called from Lisp with a non-@code{nil} @var{buffer} argument, this |
| 706 | function displays the documentation for that buffer's major and minor | 706 | function displays the documentation for that buffer's major and minor |
| 707 | modes, rather than those of the current buffer. | 707 | modes, rather than those of the current buffer. |
| 708 | @end deffn | 708 | @end deffn |
| @@ -3804,8 +3804,8 @@ expressions (not separated by any token) rather than an expression. | |||
| 3804 | @end itemize | 3804 | @end itemize |
| 3805 | 3805 | ||
| 3806 | When @var{arg} is a token, the function is called with point just before | 3806 | When @var{arg} is a token, the function is called with point just before |
| 3807 | that token. A return value of nil always means to fallback on the | 3807 | that token. A return value of @code{nil} always means to fallback on the |
| 3808 | default behavior, so the function should return nil for arguments it | 3808 | default behavior, so the function should return @code{nil} for arguments it |
| 3809 | does not expect. | 3809 | does not expect. |
| 3810 | 3810 | ||
| 3811 | @var{offset} can be: | 3811 | @var{offset} can be: |
| @@ -3904,7 +3904,7 @@ A few things to note: | |||
| 3904 | @itemize | 3904 | @itemize |
| 3905 | @item | 3905 | @item |
| 3906 | The first case indicates the basic indentation increment to use. | 3906 | The first case indicates the basic indentation increment to use. |
| 3907 | If @code{sample-indent-basic} is nil, then SMIE uses the global | 3907 | If @code{sample-indent-basic} is @code{nil}, then SMIE uses the global |
| 3908 | setting @code{smie-indent-basic}. The major mode could have set | 3908 | setting @code{smie-indent-basic}. The major mode could have set |
| 3909 | @code{smie-indent-basic} buffer-locally instead, but that | 3909 | @code{smie-indent-basic} buffer-locally instead, but that |
| 3910 | is discouraged. | 3910 | is discouraged. |
diff --git a/doc/lispref/numbers.texi b/doc/lispref/numbers.texi index 5da950e1601..8fcd77c009a 100644 --- a/doc/lispref/numbers.texi +++ b/doc/lispref/numbers.texi | |||
| @@ -400,27 +400,23 @@ returns @code{t} if they are not, and @code{nil} if they are. | |||
| 400 | @end defun | 400 | @end defun |
| 401 | 401 | ||
| 402 | @defun < number-or-marker &rest number-or-markers | 402 | @defun < number-or-marker &rest number-or-markers |
| 403 | This function tests whether every argument is strictly less than the | 403 | This function tests whether each argument is strictly less than the |
| 404 | respective next argument. It returns @code{t} if so, @code{nil} | 404 | following argument. It returns @code{t} if so, @code{nil} otherwise. |
| 405 | otherwise. | ||
| 406 | @end defun | 405 | @end defun |
| 407 | 406 | ||
| 408 | @defun <= number-or-marker &rest number-or-markers | 407 | @defun <= number-or-marker &rest number-or-markers |
| 409 | This function tests whether every argument is less than or equal to | 408 | This function tests whether each argument is less than or equal to |
| 410 | the respective next argument. It returns @code{t} if so, @code{nil} | 409 | the following argument. It returns @code{t} if so, @code{nil} otherwise. |
| 411 | otherwise. | ||
| 412 | @end defun | 410 | @end defun |
| 413 | 411 | ||
| 414 | @defun > number-or-marker &rest number-or-markers | 412 | @defun > number-or-marker &rest number-or-markers |
| 415 | This function tests whether every argument is strictly greater than | 413 | This function tests whether each argument is strictly greater than |
| 416 | the respective next argument. It returns @code{t} if so, @code{nil} | 414 | the following argument. It returns @code{t} if so, @code{nil} otherwise. |
| 417 | otherwise. | ||
| 418 | @end defun | 415 | @end defun |
| 419 | 416 | ||
| 420 | @defun >= number-or-marker &rest number-or-markers | 417 | @defun >= number-or-marker &rest number-or-markers |
| 421 | This function tests whether every argument is greater than or equal to | 418 | This function tests whether each argument is greater than or equal to |
| 422 | the respective next argument. It returns @code{t} if so, @code{nil} | 419 | the following argument. It returns @code{t} if so, @code{nil} otherwise. |
| 423 | otherwise. | ||
| 424 | @end defun | 420 | @end defun |
| 425 | 421 | ||
| 426 | @defun max number-or-marker &rest numbers-or-markers | 422 | @defun max number-or-marker &rest numbers-or-markers |
diff --git a/doc/lispref/os.texi b/doc/lispref/os.texi index 04c7adda24a..5cfbb9ff2ef 100644 --- a/doc/lispref/os.texi +++ b/doc/lispref/os.texi | |||
| @@ -194,11 +194,16 @@ It processes any command-line options that were not handled earlier. | |||
| 194 | It now exits if the option @code{--batch} was specified. | 194 | It now exits if the option @code{--batch} was specified. |
| 195 | 195 | ||
| 196 | @item | 196 | @item |
| 197 | If @code{initial-buffer-choice} is a string, it visits the file with | 197 | If @code{initial-buffer-choice} is a string, it visits the file (or |
| 198 | that name. If it is a function, it calls the function and selects the | 198 | directory) with that name. If it is a function, it calls the function |
| 199 | buffer returned by the function. It it is @code{t}, it selects the | 199 | with no arguments and selects the buffer that it returns. |
| 200 | @file{*scratch*} buffer. If the @file{*scratch*} buffer exists and is | 200 | @ignore |
| 201 | empty, it inserts @code{initial-scratch-message} into that buffer. | 201 | @c I do not think this should be mentioned. AFAICS it is just a dodge |
| 202 | @c around inhibit-startup-screen not being settable on a site-wide basis. | ||
| 203 | If it is @code{t}, it selects the @file{*scratch*} buffer. | ||
| 204 | @end ignore | ||
| 205 | If the @file{*scratch*} buffer exists and is empty, it inserts | ||
| 206 | @code{initial-scratch-message} into that buffer. | ||
| 202 | 207 | ||
| 203 | @c To make things nice and confusing, the next three items can be | 208 | @c To make things nice and confusing, the next three items can be |
| 204 | @c called from two places. If displaying a startup screen, they are | 209 | @c called from two places. If displaying a startup screen, they are |
| @@ -753,7 +758,7 @@ Here is an example of how you could use these hooks: | |||
| 753 | (add-hook 'suspend-resume-hook (lambda () (message "Resumed!") | 758 | (add-hook 'suspend-resume-hook (lambda () (message "Resumed!") |
| 754 | (sit-for 2))) | 759 | (sit-for 2))) |
| 755 | @end smallexample | 760 | @end smallexample |
| 756 | @c The sit-for prevents the ``nil'' that suspend-emacs returns | 761 | @c The sit-for prevents the @code{nil} that suspend-emacs returns |
| 757 | @c hiding the message. | 762 | @c hiding the message. |
| 758 | 763 | ||
| 759 | Here is what you would see upon evaluating @code{(suspend-emacs "pwd")}: | 764 | Here is what you would see upon evaluating @code{(suspend-emacs "pwd")}: |
diff --git a/doc/lispref/sequences.texi b/doc/lispref/sequences.texi index cafdb7fc53d..8f17862d427 100644 --- a/doc/lispref/sequences.texi +++ b/doc/lispref/sequences.texi | |||
| @@ -862,7 +862,7 @@ argument @var{b} is given, the result of this operation is stored into | |||
| 862 | 862 | ||
| 863 | @defun bool-vector-subsetp a b | 863 | @defun bool-vector-subsetp a b |
| 864 | Return @code{t} if every @code{t} value in @var{a} is also t in | 864 | Return @code{t} if every @code{t} value in @var{a} is also t in |
| 865 | @var{b}, nil otherwise. All arguments should be bool vectors of the | 865 | @var{b}, @code{nil} otherwise. All arguments should be bool vectors of the |
| 866 | same length. | 866 | same length. |
| 867 | @end defun | 867 | @end defun |
| 868 | 868 | ||
diff --git a/doc/lispref/text.texi b/doc/lispref/text.texi index 4c3286adbfc..6665cc3e673 100644 --- a/doc/lispref/text.texi +++ b/doc/lispref/text.texi | |||
| @@ -806,7 +806,7 @@ non-whitespace character in each line in the region. | |||
| 806 | 806 | ||
| 807 | If this command acts on the entire buffer (i.e. if called | 807 | If this command acts on the entire buffer (i.e. if called |
| 808 | interactively with the mark inactive, or called from Lisp with | 808 | interactively with the mark inactive, or called from Lisp with |
| 809 | @var{end} nil), it also deletes all trailing lines at the end of the | 809 | @var{end} @code{nil}), it also deletes all trailing lines at the end of the |
| 810 | buffer if the variable @code{delete-trailing-lines} is non-@code{nil}. | 810 | buffer if the variable @code{delete-trailing-lines} is non-@code{nil}. |
| 811 | @end deffn | 811 | @end deffn |
| 812 | 812 | ||
| @@ -2865,7 +2865,7 @@ adding the face @var{face} to the @code{face} text property. | |||
| 2865 | (@pxref{Special Properties}), such as a face name or an anonymous face | 2865 | (@pxref{Special Properties}), such as a face name or an anonymous face |
| 2866 | (@pxref{Faces}). | 2866 | (@pxref{Faces}). |
| 2867 | 2867 | ||
| 2868 | If any text in the region already has a non-nil @code{face} property, | 2868 | If any text in the region already has a non-@code{nil} @code{face} property, |
| 2869 | those face(s) are retained. This function sets the @code{face} | 2869 | those face(s) are retained. This function sets the @code{face} |
| 2870 | property to a list of faces, with @var{face} as the first element (by | 2870 | property to a list of faces, with @var{face} as the first element (by |
| 2871 | default) and the pre-existing faces as the remaining elements. If the | 2871 | default) and the pre-existing faces as the remaining elements. If the |
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 |
diff --git a/etc/ChangeLog b/etc/ChangeLog index 2189fac6a05..9c2582cb0f4 100644 --- a/etc/ChangeLog +++ b/etc/ChangeLog | |||
| @@ -1,3 +1,7 @@ | |||
| 1 | 2014-06-08 Leo Liu <sdl.web@gmail.com> | ||
| 2 | |||
| 3 | * themes/deeper-blue-theme.el: Use another fix. (Bug#17695) | ||
| 4 | |||
| 1 | 2014-06-08 Juri Linkov <juri@jurta.org> | 5 | 2014-06-08 Juri Linkov <juri@jurta.org> |
| 2 | 6 | ||
| 3 | * themes/deeper-blue-theme.el (diff-added, diff-changed, diff-removed): | 7 | * themes/deeper-blue-theme.el (diff-added, diff-changed, diff-removed): |
| @@ -547,6 +547,10 @@ conventions. To use it, add it to the `fill-nobreak-predicate' hook. | |||
| 547 | 547 | ||
| 548 | +++ | 548 | +++ |
| 549 | ** Uniquify is enabled by default, with `post-forward-angle-brackets' style. | 549 | ** Uniquify is enabled by default, with `post-forward-angle-brackets' style. |
| 550 | In other words, if you visit two files that have the same base name, | ||
| 551 | then rather than creating buffers basename and basename<2>, | ||
| 552 | Emacs uses basename<dirA> and basename<dirB>. To change this, | ||
| 553 | customize `uniquify-buffer-name-style'. Set it to nil for the old behavior. | ||
| 550 | 554 | ||
| 551 | +++ | 555 | +++ |
| 552 | ** New command `C-x SPC' (`rectangle-mark-mode') makes a rectangular region. | 556 | ** New command `C-x SPC' (`rectangle-mark-mode') makes a rectangular region. |
diff --git a/etc/themes/deeper-blue-theme.el b/etc/themes/deeper-blue-theme.el index 95f9c260260..3b5ab4ccccd 100644 --- a/etc/themes/deeper-blue-theme.el +++ b/etc/themes/deeper-blue-theme.el | |||
| @@ -40,19 +40,19 @@ | |||
| 40 | `(cperl-hash-face ((,class (:foreground "coral1")))) | 40 | `(cperl-hash-face ((,class (:foreground "coral1")))) |
| 41 | `(cursor ((,class (:background "green")))) | 41 | `(cursor ((,class (:background "green")))) |
| 42 | `(default ((,class (:background "#181a26" :foreground "gray80")))) | 42 | `(default ((,class (:background "#181a26" :foreground "gray80")))) |
| 43 | `(diff-added ((,class (:foreground "white" :background "darkolivegreen")))) | 43 | ;; `(diff-added ((,class (nil)))) |
| 44 | `(diff-changed ((,class (:foreground "white" :background "dodgerblue4")))) | 44 | ;; `(diff-changed ((,class (nil)))) |
| 45 | `(diff-context ((,class (:foreground "seashell4")))) | 45 | `(diff-context ((,class (:foreground "seashell4")))) |
| 46 | `(diff-file-header ((,class (:background "grey60")))) | 46 | `(diff-file-header ((,class (:background "grey60")))) |
| 47 | `(diff-function ((,class (:inherit diff-header)))) | 47 | `(diff-function ((,class (:inherit diff-header)))) |
| 48 | `(diff-header ((,class (:background "grey45")))) | 48 | `(diff-header ((,class (:background "grey45")))) |
| 49 | `(diff-hunk-header ((,class (:inherit diff-header)))) | 49 | `(diff-hunk-header ((,class (:inherit diff-header)))) |
| 50 | `(diff-index ((,class (:inherit diff-file-header)))) | 50 | `(diff-index ((,class (:inherit diff-file-header)))) |
| 51 | `(diff-indicator-added ((,class (:inherit diff-added)))) | 51 | `(diff-indicator-added ((,class (:foreground "white" :background "darkolivegreen")))) |
| 52 | `(diff-indicator-changed ((,class (:inherit diff-changed)))) | 52 | `(diff-indicator-changed ((,class (:foreground "white" :background "dodgerblue4")))) |
| 53 | `(diff-indicator-removed ((,class (:inherit diff-removed)))) | 53 | `(diff-indicator-removed ((,class (:foreground "white" :background "indianred4")))) |
| 54 | `(diff-refine-change ((,class (:background "skyblue4")))) | 54 | `(diff-refine-change ((,class (:background "skyblue4")))) |
| 55 | `(diff-removed ((,class (:foreground "white" :background "indianred4")))) | 55 | ;; `(diff-removed ((,class (nil)))) |
| 56 | `(dired-marked ((,class (:background "dodgerblue3" :foreground "white")))) | 56 | `(dired-marked ((,class (:background "dodgerblue3" :foreground "white")))) |
| 57 | `(ediff-current-diff-A ((,class (:background "green4" :foreground "white")))) | 57 | `(ediff-current-diff-A ((,class (:background "green4" :foreground "white")))) |
| 58 | `(ediff-current-diff-B ((,class (:background "darkorange3" :foreground "white")))) | 58 | `(ediff-current-diff-B ((,class (:background "darkorange3" :foreground "white")))) |
diff --git a/lisp/ChangeLog b/lisp/ChangeLog index 80105470985..2ce06f6ba54 100644 --- a/lisp/ChangeLog +++ b/lisp/ChangeLog | |||
| @@ -1,3 +1,11 @@ | |||
| 1 | 2014-06-08 Glenn Morris <rgm@gnu.org> | ||
| 2 | |||
| 3 | * startup.el (initial-buffer-choice): Doc fix. | ||
| 4 | Reset :version (adding an option does not merit a :version bump). | ||
| 5 | |||
| 6 | * bookmark.el (bookmark-load): | ||
| 7 | * uniquify.el (uniquify-buffer-name-style): Doc fixes. | ||
| 8 | |||
| 1 | 2014-06-08 Juri Linkov <juri@jurta.org> | 9 | 2014-06-08 Juri Linkov <juri@jurta.org> |
| 2 | 10 | ||
| 3 | * desktop.el: Activate auto-saving on window configuration changes. | 11 | * desktop.el: Activate auto-saving on window configuration changes. |
diff --git a/lisp/bookmark.el b/lisp/bookmark.el index e4e4ed9afcb..7ea54a8e2b4 100644 --- a/lisp/bookmark.el +++ b/lisp/bookmark.el | |||
| @@ -1420,8 +1420,7 @@ explicitly. | |||
| 1420 | 1420 | ||
| 1421 | If you load a file containing bookmarks with the same names as | 1421 | If you load a file containing bookmarks with the same names as |
| 1422 | bookmarks already present in your Emacs, the new bookmarks will get | 1422 | bookmarks already present in your Emacs, the new bookmarks will get |
| 1423 | unique numeric suffixes \"<2>\", \"<3>\", ... following the same | 1423 | unique numeric suffixes \"<2>\", \"<3>\", etc." |
| 1424 | method buffers use to resolve name collisions." | ||
| 1425 | (interactive | 1424 | (interactive |
| 1426 | (list (read-file-name | 1425 | (list (read-file-name |
| 1427 | (format "Load bookmarks from: (%s) " | 1426 | (format "Load bookmarks from: (%s) " |
diff --git a/lisp/files.el b/lisp/files.el index cf54df710c2..0b3e1d6f552 100644 --- a/lisp/files.el +++ b/lisp/files.el | |||
| @@ -1637,6 +1637,8 @@ killed." | |||
| 1637 | (let (kill-buffer-query-functions kill-buffer-hook) | 1637 | (let (kill-buffer-query-functions kill-buffer-hook) |
| 1638 | (kill-buffer obuf)))))) | 1638 | (kill-buffer obuf)))))) |
| 1639 | 1639 | ||
| 1640 | ;; FIXME we really need to fold the uniquify stuff in here by default, | ||
| 1641 | ;; not using advice, and add it to the doc string. | ||
| 1640 | (defun create-file-buffer (filename) | 1642 | (defun create-file-buffer (filename) |
| 1641 | "Create a suitably named buffer for visiting FILENAME, and return it. | 1643 | "Create a suitably named buffer for visiting FILENAME, and return it. |
| 1642 | FILENAME (sans directory) is used unchanged if that name is free; | 1644 | FILENAME (sans directory) is used unchanged if that name is free; |
diff --git a/lisp/startup.el b/lisp/startup.el index 5a4ddf335c4..aa448848cea 100644 --- a/lisp/startup.el +++ b/lisp/startup.el | |||
| @@ -42,20 +42,21 @@ | |||
| 42 | "Buffer to show after starting Emacs. | 42 | "Buffer to show after starting Emacs. |
| 43 | If the value is nil and `inhibit-startup-screen' is nil, show the | 43 | If the value is nil and `inhibit-startup-screen' is nil, show the |
| 44 | startup screen. If the value is a string, switch to a buffer | 44 | startup screen. If the value is a string, switch to a buffer |
| 45 | visiting the file or directory specified by that string. If the | 45 | visiting the file or directory that the string specifies. If the |
| 46 | value is a function, switch to the buffer returned by that | 46 | value is a function, call it with no arguments and switch to the buffer |
| 47 | function. If t, open the `*scratch*' buffer. | 47 | that it returns. If t, open the `*scratch*' buffer. |
| 48 | 48 | ||
| 49 | A string value also causes emacsclient to open the specified file | 49 | If you use `emacsclient' with no target file, then it obeys any |
| 50 | or directory when no target file is specified." | 50 | string or function value that this variable has." |
| 51 | :type '(choice | 51 | :type '(choice |
| 52 | (const :tag "Startup screen" nil) | 52 | (const :tag "Startup screen" nil) |
| 53 | (directory :tag "Directory" :value "~/") | 53 | (directory :tag "Directory" :value "~/") |
| 54 | (file :tag "File" :value "~/.emacs") | 54 | (file :tag "File" :value "~/.emacs") |
| 55 | (const :tag "Notes buffer" remember-notes) | 55 | ;; Note sure about hard-coding this as an option... |
| 56 | (const :tag "Remember Mode notes buffer" remember-notes) | ||
| 56 | (function :tag "Function") | 57 | (function :tag "Function") |
| 57 | (const :tag "Lisp scratch buffer" t)) | 58 | (const :tag "Lisp scratch buffer" t)) |
| 58 | :version "24.4" | 59 | :version "23.1" |
| 59 | :group 'initialization) | 60 | :group 'initialization) |
| 60 | 61 | ||
| 61 | (defcustom inhibit-startup-screen nil | 62 | (defcustom inhibit-startup-screen nil |
diff --git a/lisp/uniquify.el b/lisp/uniquify.el index 5d973c72897..f0e86dc544f 100644 --- a/lisp/uniquify.el +++ b/lisp/uniquify.el | |||
| @@ -26,7 +26,7 @@ | |||
| 26 | 26 | ||
| 27 | ;;; Commentary: | 27 | ;;; Commentary: |
| 28 | 28 | ||
| 29 | ;; Emacs's standard method for making buffer names unique adds <2>, <3>, | 29 | ;; Emacs's traditional method for making buffer names unique adds <2>, <3>, |
| 30 | ;; etc. to the end of (all but one of) the buffers. This file replaces | 30 | ;; etc. to the end of (all but one of) the buffers. This file replaces |
| 31 | ;; that behavior, for buffers visiting files and dired buffers, with a | 31 | ;; that behavior, for buffers visiting files and dired buffers, with a |
| 32 | ;; uniquification that adds parts of the file name until the buffer names | 32 | ;; uniquification that adds parts of the file name until the buffer names |
| @@ -94,23 +94,27 @@ | |||
| 94 | 94 | ||
| 95 | 95 | ||
| 96 | (defcustom uniquify-buffer-name-style 'post-forward-angle-brackets | 96 | (defcustom uniquify-buffer-name-style 'post-forward-angle-brackets |
| 97 | "If non-nil, buffer names are uniquified with parts of directory name. | 97 | "How to construct unique buffer names for files with the same base name. |
| 98 | The value determines the buffer name style and is one of `forward', | 98 | The value can be one of: `forward', `reverse', `post-forward', |
| 99 | `reverse', `post-forward', or `post-forward-angle-brackets'. | 99 | `post-forward-angle-brackets', or nil. |
| 100 | For example, files `/foo/bar/mumble/name' and `/baz/quux/mumble/name' | 100 | |
| 101 | For example, the files `/foo/bar/mumble/name' and `/baz/quux/mumble/name' | ||
| 101 | would have the following buffer names in the various styles: | 102 | would have the following buffer names in the various styles: |
| 102 | forward bar/mumble/name quux/mumble/name | 103 | |
| 103 | reverse name\\mumble\\bar name\\mumble\\quux | 104 | forward bar/mumble/name quux/mumble/name |
| 104 | post-forward name|bar/mumble name|quux/mumble | 105 | reverse name\\mumble\\bar name\\mumble\\quux |
| 105 | post-forward-angle-brackets name<bar/mumble> name<quux/mumble> | 106 | post-forward name|bar/mumble name|quux/mumble |
| 106 | nil name name<2> | 107 | post-forward-angle-brackets name<bar/mumble> name<quux/mumble> |
| 107 | Of course, the \"mumble\" part may be stripped as well, depending on the setting | 108 | nil name name<2> |
| 108 | of `uniquify-strip-common-suffix'." | 109 | |
| 110 | The \"mumble\" part may be stripped as well, depending on the | ||
| 111 | setting of `uniquify-strip-common-suffix'. For more options that | ||
| 112 | you can set, browse the `uniquify' custom group." | ||
| 109 | :type '(radio (const forward) | 113 | :type '(radio (const forward) |
| 110 | (const reverse) | 114 | (const reverse) |
| 111 | (const post-forward) | 115 | (const post-forward) |
| 112 | (const post-forward-angle-brackets) | 116 | (const post-forward-angle-brackets) |
| 113 | (const :tag "standard Emacs behavior (nil)" nil)) | 117 | (const :tag "numeric suffixes" nil)) |
| 114 | :version "24.4" | 118 | :version "24.4" |
| 115 | :require 'uniquify | 119 | :require 'uniquify |
| 116 | :group 'uniquify) | 120 | :group 'uniquify) |
diff --git a/src/ChangeLog b/src/ChangeLog index 72aaea5eeb6..6f864f5eef5 100644 --- a/src/ChangeLog +++ b/src/ChangeLog | |||
| @@ -1,3 +1,9 @@ | |||
| 1 | 2014-06-08 Glenn Morris <rgm@gnu.org> | ||
| 2 | |||
| 3 | * fileio.c (write-region-inhibit-fsync): Doc tweak. | ||
| 4 | |||
| 5 | * data.c (Flss, Fgtr, Fleq, Fgeq): Doc tweaks. | ||
| 6 | |||
| 1 | 2014-06-08 Paul Eggert <eggert@cs.ucla.edu> | 7 | 2014-06-08 Paul Eggert <eggert@cs.ucla.edu> |
| 2 | 8 | ||
| 3 | If a C name must be extern on some platforms, make it extern on all. | 9 | If a C name must be extern on some platforms, make it extern on all. |
diff --git a/src/data.c b/src/data.c index 0c90944f0ad..2de1c19452c 100644 --- a/src/data.c +++ b/src/data.c | |||
| @@ -2347,7 +2347,7 @@ usage: (= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) | |||
| 2347 | } | 2347 | } |
| 2348 | 2348 | ||
| 2349 | DEFUN ("<", Flss, Slss, 1, MANY, 0, | 2349 | DEFUN ("<", Flss, Slss, 1, MANY, 0, |
| 2350 | doc: /* Return t if each arg is less than the next arg. All must be numbers or markers. | 2350 | doc: /* Return t if each arg (a number or marker), is less than the next arg. |
| 2351 | usage: (< NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) | 2351 | usage: (< NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) |
| 2352 | (ptrdiff_t nargs, Lisp_Object *args) | 2352 | (ptrdiff_t nargs, Lisp_Object *args) |
| 2353 | { | 2353 | { |
| @@ -2355,7 +2355,7 @@ usage: (< NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) | |||
| 2355 | } | 2355 | } |
| 2356 | 2356 | ||
| 2357 | DEFUN (">", Fgtr, Sgtr, 1, MANY, 0, | 2357 | DEFUN (">", Fgtr, Sgtr, 1, MANY, 0, |
| 2358 | doc: /* Return t if each arg is greater than the next arg. All must be numbers or markers. | 2358 | doc: /* Return t if each arg (a number or marker) is greater than the next arg. |
| 2359 | usage: (> NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) | 2359 | usage: (> NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) |
| 2360 | (ptrdiff_t nargs, Lisp_Object *args) | 2360 | (ptrdiff_t nargs, Lisp_Object *args) |
| 2361 | { | 2361 | { |
| @@ -2363,8 +2363,7 @@ usage: (> NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) | |||
| 2363 | } | 2363 | } |
| 2364 | 2364 | ||
| 2365 | DEFUN ("<=", Fleq, Sleq, 1, MANY, 0, | 2365 | DEFUN ("<=", Fleq, Sleq, 1, MANY, 0, |
| 2366 | doc: /* Return t if each arg is less than or equal to the next arg. | 2366 | doc: /* Return t if each arg (a number or marker) is less than or equal to the next. |
| 2367 | All must be numbers or markers. | ||
| 2368 | usage: (<= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) | 2367 | usage: (<= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) |
| 2369 | (ptrdiff_t nargs, Lisp_Object *args) | 2368 | (ptrdiff_t nargs, Lisp_Object *args) |
| 2370 | { | 2369 | { |
| @@ -2372,8 +2371,7 @@ usage: (<= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) | |||
| 2372 | } | 2371 | } |
| 2373 | 2372 | ||
| 2374 | DEFUN (">=", Fgeq, Sgeq, 1, MANY, 0, | 2373 | DEFUN (">=", Fgeq, Sgeq, 1, MANY, 0, |
| 2375 | doc: /* Return t if each arg is greater than or equal to the next arg. | 2374 | doc: /* Return t if each arg (a number or marker) is greater than or equal to the next. |
| 2376 | All must be numbers or markers. | ||
| 2377 | usage: (>= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) | 2375 | usage: (>= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) |
| 2378 | (ptrdiff_t nargs, Lisp_Object *args) | 2376 | (ptrdiff_t nargs, Lisp_Object *args) |
| 2379 | { | 2377 | { |
diff --git a/src/fileio.c b/src/fileio.c index 8b20c65802d..dc3ed431d40 100644 --- a/src/fileio.c +++ b/src/fileio.c | |||
| @@ -6029,7 +6029,7 @@ file is usually more useful if it contains the deleted text. */); | |||
| 6029 | doc: /* Non-nil means don't call fsync in `write-region'. | 6029 | doc: /* Non-nil means don't call fsync in `write-region'. |
| 6030 | This variable affects calls to `write-region' as well as save commands. | 6030 | This variable affects calls to `write-region' as well as save commands. |
| 6031 | Setting this to nil may avoid data loss if the system loses power or | 6031 | Setting this to nil may avoid data loss if the system loses power or |
| 6032 | the operating system crashes. */); | 6032 | the operating system crashes. By default, it is non-nil in batch mode. */); |
| 6033 | write_region_inhibit_fsync = 0; /* See also `init_fileio' above. */ | 6033 | write_region_inhibit_fsync = 0; /* See also `init_fileio' above. */ |
| 6034 | 6034 | ||
| 6035 | DEFVAR_BOOL ("delete-by-moving-to-trash", delete_by_moving_to_trash, | 6035 | DEFVAR_BOOL ("delete-by-moving-to-trash", delete_by_moving_to_trash, |