aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGlenn Morris2014-06-08 16:41:43 -0700
committerGlenn Morris2014-06-08 16:41:43 -0700
commitfd60bf6c902b47daadda6ebf442045dbe1328941 (patch)
treefd351a1fc087aefbca38b87102f06edf9f8b04ff
parentff2d0e8336c05cb7d3e86f7406784cefc1d6589e (diff)
parent4181427f24e591f539122db2e3d8d8b55a7de7cd (diff)
downloademacs-fd60bf6c902b47daadda6ebf442045dbe1328941.tar.gz
emacs-fd60bf6c902b47daadda6ebf442045dbe1328941.zip
Merge from emacs-24; up to 2014-06-02T11:35:40Z!michael.albinus@gmx.de
-rw-r--r--doc/emacs/ChangeLog22
-rw-r--r--doc/emacs/buffers.texi27
-rw-r--r--doc/emacs/cmdargs.texi13
-rw-r--r--doc/emacs/dired.texi2
-rw-r--r--doc/emacs/entering.texi17
-rw-r--r--doc/emacs/files.texi6
-rw-r--r--doc/emacs/frames.texi8
-rw-r--r--doc/emacs/help.texi20
-rw-r--r--doc/emacs/misc.texi6
-rw-r--r--doc/emacs/msdog.texi7
-rw-r--r--doc/emacs/rmail.texi6
-rw-r--r--doc/emacs/screen.texi9
-rw-r--r--doc/lispref/ChangeLog8
-rw-r--r--doc/lispref/anti.texi2
-rw-r--r--doc/lispref/display.texi8
-rw-r--r--doc/lispref/files.texi5
-rw-r--r--doc/lispref/keymaps.texi4
-rw-r--r--doc/lispref/modes.texi8
-rw-r--r--doc/lispref/numbers.texi20
-rw-r--r--doc/lispref/os.texi17
-rw-r--r--doc/lispref/sequences.texi2
-rw-r--r--doc/lispref/text.texi4
-rw-r--r--doc/misc/ChangeLog21
-rw-r--r--doc/misc/calc.texi4
-rw-r--r--doc/misc/cc-mode.texi6
-rw-r--r--doc/misc/ebrowse.texi8
-rw-r--r--doc/misc/ede.texi18
-rw-r--r--doc/misc/efaq-w32.texi8
-rw-r--r--doc/misc/efaq.texi2
-rw-r--r--doc/misc/eieio.texi8
-rw-r--r--doc/misc/emacs-gnutls.texi2
-rw-r--r--doc/misc/erc.texi2
-rw-r--r--doc/misc/ert.texi14
-rw-r--r--doc/misc/eshell.texi4
-rw-r--r--doc/misc/gnus-faq.texi66
-rw-r--r--doc/misc/gnus.texi17
-rw-r--r--doc/misc/htmlfontify.texi4
-rw-r--r--doc/misc/idlwave.texi2
-rw-r--r--doc/misc/info.texi50
-rw-r--r--doc/misc/mairix-el.texi2
-rw-r--r--doc/misc/message.texi2
-rw-r--r--doc/misc/mh-e.texi2
-rw-r--r--doc/misc/reftex.texi20
-rw-r--r--doc/misc/ses.texi2
-rw-r--r--doc/misc/srecode.texi4
-rw-r--r--doc/misc/todo-mode.texi26
-rw-r--r--doc/misc/url.texi2
-rw-r--r--doc/misc/vip.texi6
-rw-r--r--doc/misc/wisent.texi4
-rw-r--r--doc/misc/woman.texi2
-rw-r--r--etc/ChangeLog4
-rw-r--r--etc/NEWS4
-rw-r--r--etc/themes/deeper-blue-theme.el12
-rw-r--r--lisp/ChangeLog8
-rw-r--r--lisp/bookmark.el3
-rw-r--r--lisp/files.el2
-rw-r--r--lisp/startup.el15
-rw-r--r--lisp/uniquify.el30
-rw-r--r--src/ChangeLog6
-rw-r--r--src/data.c10
-rw-r--r--src/fileio.c2
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 @@
12014-06-08 Glenn Morris <rgm@gnu.org> 12014-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
232014-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
611the buffers distinct names. The default method 611the buffers distinct names. The default method adds a suffix based on
612(@code{uniquify-buffer-name-style} set to 612the names of the directories that contain the files. For example, if
613@code{post-forward-angle-brackets}) for making buffer names unique 613you visit files @file{/foo/bar/mumble/name} and
614adds @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
615names, where @file{dir1} and @file{dir2} are the minimal parts of the 615named @samp{name<bar/mumble>} and @samp{name<quux/mumble>}, respectively.
616leading directories needed to make the buffer name unique. For 616Emacs adds as many directory parts as are needed to make a unique name.
617example, 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
623one, customize the variable @code{uniquify-buffer-name-style} 620buffer 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
627directory name at the beginning of the buffer name; using this method, 623directory 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
633buffers @samp{Makefile|tmp} and @samp{Makefile|zaphod}. The default 629buffers @samp{Makefile|tmp} and @samp{Makefile|zaphod}. The default
634method @code{post-forward-angle-brackets} is like @code{post-forward} 630method @code{post-forward-angle-brackets} is like @code{post-forward},
635except that it prepends the unique path in angle brackets. The 631except 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}
641becomes @samp{file\middle\top}, while @code{post-forward} puts them in 637becomes @samp{file\middle\top}, while @code{post-forward} puts them in
642forward order after the file name, as in @samp{file|top/middle}. If 638forward 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
644names simply get a @samp{<2>} etc. prepended. This used to be the 640names simply get @samp{<2>}, @samp{<3>}, etc. appended.
645default 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
648name is not very important if you are going to @emph{look} at the 643name 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
904Specify that width and height shall be the size of the screen. Normally 904Specify that width and height should be that of the screen. Normally
905no window manager decorations are shown. 905no window manager decorations are shown. (After starting Emacs,
906you 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
912Specify that the Emacs frame shall be maximized. This normally 913Specify that the Emacs frame should be maximized. This normally
913means that the frame has window manager decorations. 914means 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
920Specify that the height shall be the height of the screen. 923Specify 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
927Specify that the width shall be the width of the screen. 930Specify 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
522that already have @samp{D} flags: 522that 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
528This assumes that no files were already marked with @samp{t}. 528This 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
77by setting the variable @code{initial-buffer-choice} to a string 77by setting the variable @code{initial-buffer-choice} to a string
78naming that file or directory. The value of 78naming 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)
80return a buffer which is then displayed. @code{initial-buffer-choice} 80that should return a buffer which is then displayed.
81may also be @code{t} in which case the @file{*scratch*} buffer will be 81@ignore
82shown. 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
83command 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
87If @code{initial-buffer-choice} is non-@code{nil}, then if you specify
88any files on the command line, Emacs still visits them, but does not
89display 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
171buffer name from the file name, omitting the directory name. For 171buffer name from the file name, omitting the directory name. For
172example, a file named @file{/usr/rms/emacs.tex} is visited in a buffer 172example, a file named @file{/usr/rms/emacs.tex} is visited in a buffer
173named @samp{emacs.tex}. If there is already a buffer with that name, 173named @samp{emacs.tex}. If there is already a buffer with that name,
174Emacs constructs a unique name; the normal method is to append 174Emacs 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. 175based on the directory name (e.g., @samp{<rms>}, @samp{<tmp>},
176@xref{Uniquify}. 176and 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
460Toggle maximization state of the current frame. 460Toggle the maximization state of the current frame. When a frame is
461maximized, 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
465Toggle fullscreen mode of the current frame. 466Toggle fullscreen mode for the current frame. (The difference
467between ``fullscreen'' and ``maximized'' is normally that the former
468hides window manager decorations, giving slightly more screen space to
469Emacs 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
59contexts as well. For instance, you can type them after a prefix key 59well. For instance, you can type them after a prefix key to view a
60to view a list of the keys that can follow the prefix key. (A few 60list of the keys that can follow the prefix key. (You can also use
61prefix 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}
62they define other meanings for it, but they all support @key{F1} for 62or @kbd{?} in this way, because they define other meanings for those
63help.) 63inputs, 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}).
556typing @kbd{C-h}, @kbd{?}, or @key{F1} 556typing @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
558few prefix keys for which not all of these keys work---those that 558few prefix keys for which not all of these keys work---those that
559provide their own bindings for one of them. One of these prefix keys 559provide their own bindings for that key. One of these prefix keys
560is @key{ESC} in combination with @kbd{C-h}, because @kbd{@key{ESC} C-h} is 560is @key{ESC}, because @kbd{@key{ESC} C-h} is actually @kbd{C-M-h},
561actually @kbd{C-M-h}, which marks a defun. However, @kbd{@key{ESC} @key{F1}} 561which marks a defun. However, @kbd{@key{ESC} @key{F1}} and
562and @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
1560current text terminal. @xref{Windows Startup}. 1560current text terminal. @xref{Windows Startup}.
1561 1561
1562If you omit a filename argument while supplying the @samp{-c} option, 1562If you omit a filename argument while supplying the @samp{-c} option,
1563the new frame displays the @file{*scratch*} buffer by default. This 1563the new frame displays the @file{*scratch*} buffer by default. You
1564behavior can be customized using the variable 1564can 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
458You can redefine some of them with meanings more like the MS-Windows 458You can redefine some of them with meanings more like the MS-Windows
459meanings by enabling CUA Mode (@pxref{CUA Bindings}). 459meanings 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
464makes it possible to use the menus without a mouse. In this mode, the
465arrow keys traverse the menus, @key{RET} selects a highlighted menu
466item, 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
470Windows-specific variables in this category. 463Windows-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
116scroll through it by screenfuls, Rmail makes @key{SPC} and @key{DEL} 116scroll 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})
118and @kbd{M-v} (@code{scroll-down-command}) respectively. 118and @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
753value should be a regular expression; any recipients that match are 753value should be a regular expression; any recipients that match are
754excluded from the @samp{CC} field. They are also excluded from the 754excluded 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
756variable is nil, then the first time you compose a reply it is 756variable is @code{nil}, then the first time you compose a reply it is
757initialized to a default value that matches your own address. 757initialized 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.
962use for the summary window. The variable 962use 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
964for a message should include the line count of the message. Setting 964for a message should include the line count of the message. Setting
965this option to nil might speed up the generation of summaries. 965this 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}.
285can use to perform common operations. There's no need to list them 285can use to perform common operations. There's no need to list them
286here, as you can more easily see them yourself. 286here, 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
292command from the menu bar. An arrow on the right edge of a menu item 289command from the menu bar. An arrow on the right edge of a menu item
293means it leads to a subsidiary menu, or @dfn{submenu}. A @samp{...} 290means it leads to a subsidiary menu, or @dfn{submenu}. A @samp{...}
294at the end of a menu item means that the command will prompt you for 291at 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
300item, type @kbd{C-h k}, and then select the menu bar with the mouse in 297item, type @kbd{C-h k}, and then select the menu bar with the mouse in
301the usual way (@pxref{Key Help}). 298the 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
304item by pressing @key{F10} (to run the command @code{menu-bar-open}). 304item by pressing @key{F10} (to run the command @code{menu-bar-open}).
305You can then navigate the menus with the arrow keys. To activate a 305You can then navigate the menus with the arrow keys. To activate a
306selected menu item, press @key{RET}; to cancel menu navigation, press 306selected 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 @@
12014-06-08 Glenn Morris <rgm@gnu.org> 12014-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
92014-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
30making your programs hard to understand. 30making your programs hard to understand.
31 31
32@item 32@item
33Calling a minor mode function from Lisp with a nil or omitted argument 33Calling a minor mode function from Lisp with a @code{nil} or omitted argument
34does not enable the minor mode unconditionally; instead, it toggles 34does not enable the minor mode unconditionally; instead, it toggles
35the minor mode---which is the straightforward thing to do, since that 35the minor mode---which is the straightforward thing to do, since that
36is the behavior when invoked interactively. One downside is that it 36is 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
1722This function returns a list of all the overlays that cover the character at 1722This function returns a list of all the overlays that cover the character at
1723position @var{pos} in the current buffer. If @var{sorted} is non-nil, the list 1723position @var{pos} in the current buffer. If @var{sorted} is non-@code{nil},
1724is in decreasing order of priority, otherwise it is in no particular order. 1724the list is in decreasing order of priority, otherwise it is in no particular
1725An overlay contains position @var{pos} if it begins at or before @var{pos}, and 1725order. An overlay contains position @var{pos} if it begins at or before
1726ends after @var{pos}. 1726@var{pos}, and ends after @var{pos}.
1727 1727
1728To illustrate usage, here is a Lisp function that returns a list of the 1728To illustrate usage, here is a Lisp function that returns a list of the
1729overlays that specify property @var{prop} for the character at point: 1729overlays 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.
254which are sometimes useful in user Lisp code: @code{create-file-buffer} 254which are sometimes useful in user Lisp code: @code{create-file-buffer}
255and @code{after-find-file}. This section explains how to use them. 255and @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
258This function creates a suitably named buffer for visiting 261This 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)
260as the name if that name is free; otherwise, it appends a string such as 263as 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}.
265Note that the @file{uniquify} library affects the result of this
266function. @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}
264associate the new buffer with a file and does not select the buffer. 269associate 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
2904menu. It should be nil if you know that the menu item has no keyboard 2904menu. It should be @code{nil} if you know that the menu item has no keyboard
2905equivalent; otherwise it should be a string or vector specifying a 2905equivalent; otherwise it should be a string or vector specifying a
2906keyboard equivalent for the menu item. 2906keyboard 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
2932selected whenever the expression's value is non-nil. 2932selected 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
702retrieve the documentation strings of the major and minor mode 702retrieve the documentation strings of the major and minor mode
703commands (@pxref{Accessing Documentation}). 703commands (@pxref{Accessing Documentation}).
704 704
705If called from Lisp with a non-nil @var{buffer} argument, this 705If called from Lisp with a non-@code{nil} @var{buffer} argument, this
706function displays the documentation for that buffer's major and minor 706function displays the documentation for that buffer's major and minor
707modes, rather than those of the current buffer. 707modes, 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
3806When @var{arg} is a token, the function is called with point just before 3806When @var{arg} is a token, the function is called with point just before
3807that token. A return value of nil always means to fallback on the 3807that token. A return value of @code{nil} always means to fallback on the
3808default behavior, so the function should return nil for arguments it 3808default behavior, so the function should return @code{nil} for arguments it
3809does not expect. 3809does 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
3906The first case indicates the basic indentation increment to use. 3906The first case indicates the basic indentation increment to use.
3907If @code{sample-indent-basic} is nil, then SMIE uses the global 3907If @code{sample-indent-basic} is @code{nil}, then SMIE uses the global
3908setting @code{smie-indent-basic}. The major mode could have set 3908setting @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
3910is discouraged. 3910is 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
403This function tests whether every argument is strictly less than the 403This function tests whether each argument is strictly less than the
404respective next argument. It returns @code{t} if so, @code{nil} 404following argument. It returns @code{t} if so, @code{nil} otherwise.
405otherwise.
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
409This function tests whether every argument is less than or equal to 408This function tests whether each argument is less than or equal to
410the respective next argument. It returns @code{t} if so, @code{nil} 409the following argument. It returns @code{t} if so, @code{nil} otherwise.
411otherwise.
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
415This function tests whether every argument is strictly greater than 413This function tests whether each argument is strictly greater than
416the respective next argument. It returns @code{t} if so, @code{nil} 414the following argument. It returns @code{t} if so, @code{nil} otherwise.
417otherwise.
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
421This function tests whether every argument is greater than or equal to 418This function tests whether each argument is greater than or equal to
422the respective next argument. It returns @code{t} if so, @code{nil} 419the following argument. It returns @code{t} if so, @code{nil} otherwise.
423otherwise.
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.
194It now exits if the option @code{--batch} was specified. 194It now exits if the option @code{--batch} was specified.
195 195
196@item 196@item
197If @code{initial-buffer-choice} is a string, it visits the file with 197If @code{initial-buffer-choice} is a string, it visits the file (or
198that name. If it is a function, it calls the function and selects the 198directory) with that name. If it is a function, it calls the function
199buffer returned by the function. It it is @code{t}, it selects the 199with no arguments and selects the buffer that it returns.
200@file{*scratch*} buffer. If the @file{*scratch*} buffer exists and is 200@ignore
201empty, 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.
203If it is @code{t}, it selects the @file{*scratch*} buffer.
204@end ignore
205If 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
759Here is what you would see upon evaluating @code{(suspend-emacs "pwd")}: 764Here 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
864Return @code{t} if every @code{t} value in @var{a} is also t in 864Return @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
866same length. 866same 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
807If this command acts on the entire buffer (i.e. if called 807If this command acts on the entire buffer (i.e. if called
808interactively with the mark inactive, or called from Lisp with 808interactively 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
810buffer if the variable @code{delete-trailing-lines} is non-@code{nil}. 810buffer 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
2868If any text in the region already has a non-nil @code{face} property, 2868If any text in the region already has a non-@code{nil} @code{face} property,
2869those face(s) are retained. This function sets the @code{face} 2869those face(s) are retained. This function sets the @code{face}
2870property to a list of faces, with @var{face} as the first element (by 2870property to a list of faces, with @var{face} as the first element (by
2871default) and the pre-existing faces as the remaining elements. If the 2871default) 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 @@
12014-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
82014-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
12014-06-02 Glenn Morris <rgm@gnu.org> 222014-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
21625Every character not part of the sub-formula @samp{b} has been changed 21625Every character not part of the sub-formula @samp{b} has been changed
21626to a dot. (If the customizable variable 21626to 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
21628not part of the sub-formula are de-emphasized by using a less 21628not part of the sub-formula are de-emphasized by using a less
21629noticeable face instead of using dots. @pxref{Displaying Selections}.) 21629noticeable face instead of using dots. @pxref{Displaying Selections}.)
21630The @samp{*} next to the line number is to remind you that 21630The @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
21860If the customizable variable 21860If 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
21862non-selected portion of the formula will be de-emphasized by using a 21862non-selected portion of the formula will be de-emphasized by using a
21863less noticeable face (@code{calc-nonselected-face}) instead of dots 21863less noticeable face (@code{calc-nonselected-face}) instead of dots
21864and the selected sub-formula will be highlighted by using a more 21864and 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
3915position higher up in the buffer (typically the indentation of the 3915position higher up in the buffer (typically the indentation of the
3916previous line). That position is the @dfn{anchor position} in the 3916previous line). That position is the @dfn{anchor position} in the
3917syntactic element. If there is an entry after the syntactic symbol in 3917syntactic element. If there is an entry after the syntactic symbol in
3918the syntactic element list then it's either nil or that anchor position. 3918the syntactic element list then it's either @code{nil} or that anchor position.
3919 3919
3920Here is an example. Suppose we had the following code as the only thing 3920Here is an example. Suppose we had the following code as the only thing
3921in a C++ buffer @footnote{The line numbers in this and future examples 3921in 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-)
6069Line up the current line after the assignment operator on the first line 6069Line up the current line after the assignment operator on the first line
6070in the statement. If there isn't any, return nil to allow stacking with 6070in the statement. If there isn't any, return @code{nil} to allow stacking with
6071other line-up functions. If the current line contains an assignment 6071other line-up functions. If the current line contains an assignment
6072operator too, try to align it with the first one. 6072operator 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-)
6535Return the anchor position in @var{langelem}, or nil if there is none. 6535Return 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
475name. 475name.
476 476
477@table @kbd 477@table @kbd
478@item SPC 478@item @key{SPC}
479This command views the class declaration if the database 479This command views the class declaration if the database
480contains information about it. If you don't parse the entire source 480contains information about it. If you don't parse the entire source
481you are working on, some classes will only be known to exist but the 481you are working on, some classes will only be known to exist but the
482location of their declarations and definitions will not be known. 482location of their declarations and definitions will not be known.
483 483
484@item RET 484@item @key{RET}
485Works like @kbd{SPC}, except that it finds the class 485Works like @kbd{SPC}, except that it finds the class
486declaration rather than viewing it, so that it is ready for 486declaration rather than viewing it, so that it is ready for
487editing. 487editing.
@@ -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}
880This command finds the definition of the member the cursor is on. 880This command finds the definition of the member the cursor is on.
881Finding involves roughly the same as the standard Emacs tags facility 881Finding involves roughly the same as the standard Emacs tags facility
882does---loading the file and searching for a regular expression matching 882does---loading the file and searching for a regular expression matching
@@ -885,7 +885,7 @@ the member.
885@item f 885@item f
886This command finds the declaration of the member the cursor is on. 886This command finds the declaration of the member the cursor is on.
887 887
888@item SPC 888@item @key{SPC}
889This is the same command as @kbd{RET}, but views the member definition 889This is the same command as @kbd{RET}, but views the member definition
890instead of finding the member's source file. 890instead 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
1200from the autoload. If it is a string (i.e., a project file name), it 1200from the autoload. If it is a string (i.e., a project file name), it
1201checks to see if that exists in BUFFER's directory. If it is a 1201checks to see if that exists in BUFFER's directory. If it is a
1202function, then it calls that function and expects it to return a file 1202function, then it calls that function and expects it to return a file
1203name or nil. If the file exists, then this directory is assumed to be 1203name or @code{nil}. If the file exists, then this directory is assumed to be
1204part of a project, and @code{ede-directory-project-p} returns the 1204part of a project, and @code{ede-directory-project-p} returns the
1205instance of @code{ede-project-autoload} that matched. 1205instance 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.
1275A brief description of the project or target. This is currently used 1275A brief description of the project or target. This is currently used
1276by the @samp{ede-speedbar} interface. 1276by the @samp{ede-speedbar} interface.
1277@item ede-want-file-p 1277@item ede-want-file-p
1278Return non-nil if a target will accept a given file. 1278Return non-@code{nil} if a target will accept a given file.
1279It is generally unnecessary to override this. See the section on source 1279It is generally unnecessary to override this. See the section on source
1280code. 1280code.
1281@item ede-buffer-mine 1281@item ede-buffer-mine
1282Return non-nil if a buffer belongs to this target. Used during 1282Return non-@code{nil} if a buffer belongs to this target. Used during
1283association when a file is loaded. It is generally unnecessary to 1283association when a file is loaded. It is generally unnecessary to
1284override this unless you keep auxiliary files. 1284override 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
1617For project @var{THIS}, map @var{PROC} to all targets and return if any non-nil. 1617For project @var{THIS}, map @var{PROC} to all targets and return if any non-@code{nil}.
1618Return the first non-@code{nil} value returned by @var{PROC}. 1618Return 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
1771Fetch the target in @var{PROJ} belonging to @var{BUFFER} or nil. 1771Fetch 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
1887It should return the fully qualified file name passed in from NAME@. If that file does not 1887It should return the fully qualified file name passed in from NAME@.
1888exist, it should return nil. 1888If 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}
2047Non-@code{nil} if this is a metasubproject. 2047Non-@code{nil} if this is a metasubproject.
2048Usually, a subproject is determined by a parent project. If multiple top level 2048Usually, a subproject is determined by a parent project. If multiple top level
2049projects are grouped into a large project not maintained by EDE, then you need 2049projects are grouped into a large project not maintained by EDE, then you need
2050to set this to non-nil. The only effect is that the @code{dist} rule will then avoid 2050to set this to non-@code{nil}. The only effect is that the @code{dist} rule will then avoid
2051making a tar file. 2051making a tar file.
2052 2052
2053@end table 2053@end table
@@ -2281,7 +2281,7 @@ Default Value: @code{nil}
2281Non-@code{nil} if this is a metasubproject. 2281Non-@code{nil} if this is a metasubproject.
2282Usually, a subproject is determined by a parent project. If multiple top level 2282Usually, a subproject is determined by a parent project. If multiple top level
2283projects are grouped into a large project not maintained by EDE, then you need 2283projects are grouped into a large project not maintained by EDE, then you need
2284to set this to non-nil. The only effect is that the @code{dist} rule will then avoid 2284to set this to non-@code{nil}. The only effect is that the @code{dist} rule will then avoid
2285making a tar file. 2285making 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
1179If you have set w32-use-w32-font-dialog to nil, you can add fonts to 1179If you have set w32-use-w32-font-dialog to @code{nil}, you can add fonts to
1180the font menu by changing `w32-fixed-font-alist'. For example: 1180the 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
1666If you are experiencing problems with sending large messages, check 1666If you are experiencing problems with sending large messages, check
1667the value of the variable @code{smtpmail-debug-info}. If it is non-nil, you 1667the value of the variable @code{smtpmail-debug-info}. If it is
1668should set it to @code{nil}: 1668non-@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
1944left or right edge of the window. 1944left or right edge of the window.
1945 1945
1946Note that this is overridden by the variable 1946Note 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}
1948and the current buffer is not full-frame width. 1948and the current buffer is not full-frame width.
1949 1949
1950In Emacs 20, use @code{hscroll-mode}. 1950In 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
309If non-nil, @code{defclass} signals an error if a tag in a slot 309If non-@code{nil}, @code{defclass} signals an error if a tag in a slot
310specifier is unsupported. 310specifier is unsupported.
311 311
312This option is here to support programs written with older versions of 312This 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
573of slots, and before the options. 573of slots, and before the options.
574 574
575@item :allow-nil-initform 575@item :allow-nil-initform
576If this option is non-nil, and the @code{:initform} is @code{nil}, but 576If this option is non-@code{nil}, and the @code{:initform} is @code{nil}, but
577the @code{:type} is specifies something such as @code{string} then allow 577the @code{:type} is specifies something such as @code{string} then allow
578this to pass. The default is to have this option be off. This is 578this to pass. The default is to have this option be off. This is
579implemented as an alternative to unbound slots. 579implemented 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
1265For the given @var{class} return the :initarg associated with 1265For 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
1267nil. 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
94Zaretskii) in the same directory as Emacs, you should be OK. 94Zaretskii) in the same directory as Emacs, you should be OK.
95 95
96@defun gnutls-available-p 96@defun gnutls-available-p
97This function returns t if GnuTLS is available in this instance of Emacs. 97This function returns @code{t} if GnuTLS is available in this instance of Emacs.
98@end defun 98@end defun
99 99
100Oh, but sometimes things go wrong. Budgets aren't balanced, 100Oh, 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
153In that buffer, type ``/join SPC #emacs'' and hit @kbd{RET}. Depending 153In that buffer, type ``/join @key{SPC} #emacs'' and hit @kbd{RET}. Depending
154on how you've set up ERC, either a new buffer for ``#emacs'' will be 154on how you've set up ERC, either a new buffer for ``#emacs'' will be
155displayed, or a new buffer called ``#emacs'' will be created in the 155displayed, or a new buffer called ``#emacs'' will be created in the
156background. If the latter, switch to the ``#emacs'' buffer. You will 156background. 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
140If you know @code{defun}, the syntax of @code{ert-deftest} should look 140If you know @code{defun}, the syntax of @code{ert-deftest} should look
141familiar: This example defines a test named @code{pp-test-quote} that 141familiar: This example defines a test named @code{pp-test-quote} that
142will pass if the three calls to @code{equal} all return true 142will 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
146better error reporting. @xref{The @code{should} Macro}. 145better 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,
318a function that takes a test as argument and returns non-nil if it is selected. 317a function that takes a test as argument and returns non-@code{nil} if
318it is selected.
319@end itemize 319@end itemize
320 320
321Selectors that are frequently useful when selecting tests to run 321Selectors that are frequently useful when selecting tests to run
@@ -382,13 +382,13 @@ F addition-test
382@end example 382@end example
383 383
384In this example, @code{should} recorded the fact that (= (+ 1 2) 4) 384In this example, @code{should} recorded the fact that (= (+ 1 2) 4)
385reduced to (= 3 4) before it reduced to nil. When debugging why the 385reduced to (= 3 4) before it reduced to @code{nil}. When debugging why the
386test failed, it helps to know that the function @code{+} returned 3 386test failed, it helps to know that the function @code{+} returned 3
387here. ERT records the return value for any predicate called directly 387here. ERT records the return value for any predicate called directly
388within @code{should}. 388within @code{should}.
389 389
390In addition to @code{should}, ERT provides @code{should-not}, which 390In addition to @code{should}, ERT provides @code{should-not}, which
391checks that the predicate returns nil, and @code{should-error}, which 391checks that the predicate returns @code{nil}, and @code{should-error}, which
392checks that the form called within it signals an error. An example 392checks that the form called within it signals an error. An example
393use of @code{should-error}: 393use of @code{should-error}:
394 394
@@ -531,7 +531,7 @@ Instead, it is better to use lower-level mechanisms with simple and
531predictable semantics like @code{with-temp-buffer}, @code{insert} or 531predictable 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
533by calling the corresponding function directly, after binding the 533by calling the corresponding function directly, after binding the
534hook variables to nil. This avoids the above problems. 534hook 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
761that it returns. The explanation can be any object but should have a 761that it returns. The explanation can be any object but should have a
762comprehensible printed representation. If the return value of the 762comprehensible printed representation. If the return value of the
763predicate needs no explanation for a given list of arguments, the 763predicate needs no explanation for a given list of arguments, the
764explanation function should return nil. 764explanation function should return @code{nil}.
765 765
766To associate an explanation function with a predicate, add the 766To associate an explanation function with a predicate, add the
767property @code{ert-explainer} to the symbol that names the predicate. 767property @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
676by adding a list of the form @samp{("/dev/name" @var{function} @var{mode})} to 676by 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
680non-nil, then the function is passed the redirection mode as a 680non-@code{nil}, then the function is passed the redirection mode as a
681symbol--@code{overwrite} for @code{>}, @code{append} for @code{>>}, or 681symbol--@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
683the output function. 683the 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
378You've got to tell Gnus where to fetch the news from. Read 378You've got to tell Gnus where to fetch the news from. Read
379the documentation for information on how to do this. As a 379the documentation for information on how to do this. As a
380first start, put those lines in ~/.gnus.el: 380first 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
392I'm working under Windows and have no idea what ~/.gnus.el means. 392I'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
421possibility to set environment variables. Create a new one with 421possibility to set environment variables. Create a new one with
422name HOME and value C:\myhome. Rebooting is not necessary. 422name HOME and value C:\myhome. Rebooting is not necessary.
423 423
424Now to create ~/.gnus.el, say 424Now 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}.
426in Emacs. 426in Emacs.
427 427
@@ -495,7 +495,7 @@ I want Gnus to fetch news from several servers, is this possible?
495 495
496Of course. You can specify more sources for articles in the 496Of course. You can specify more sources for articles in the
497variable gnus-secondary-select-methods. Add something like 497variable gnus-secondary-select-methods. Add something like
498this in ~/.gnus.el: 498this 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
566and is therefore quite fast. However you might prefer a one 566and is therefore quite fast. However you might prefer a one
567file per group approach if your file system has problems with 567file per group approach if your file system has problems with
568many small files, the nnfolder back end is then probably the 568many small files, the nnfolder back end is then probably the
569choice for you. To use nnml add the following to ~/.gnus.el: 569choice 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
594Make sure ~/.gnus.el isn't readable to others if you store 594Make sure @file{~/.gnus.el} isn't readable to others if you store
595your password there. If you want to read your mail from a 595your password there. If you want to read your mail from a
596traditional spool file on your local machine, it's 596traditional 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
630want to send mail via sendmail (or whichever MTA is playing 630want to send mail via sendmail (or whichever MTA is playing
631the role of sendmail on your system), you don't need to do 631the role of sendmail on your system), you don't need to do
632anything. However, if you want to send your mail to an 632anything. However, if you want to send your mail to an
633SMTP Server you need the following in your ~/.gnus.el 633SMTP 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
650to use IMAP like POP3, that means Gnus fetches the mail from 650to use IMAP like POP3, that means Gnus fetches the mail from
651the IMAP server and stores it on disk. If you want to do 651the IMAP server and stores it on disk. If you want to do
652this (you don't really want to do this) add the following to 652this (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
768in ~/.gnus.el to load enough old articles to prevent teared threads, replace 'some with t to load 768in @file{~/.gnus.el} to load enough old articles to prevent teared threads, replace 'some with @code{t} to load
769all articles (Warning: Both settings enlarge the amount of data which is 769all articles (Warning: Both settings enlarge the amount of data which is
770fetched when you enter a group and slow down the process of entering a group). 770fetched 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
829are shown, its value is a regular expression, header lines 829are shown, its value is a regular expression, header lines
830which match it are shown. So if you want author, subject, 830which match it are shown. So if you want author, subject,
831date, and if the header exists, Followup-To and MUA / NUA 831date, and if the header exists, Followup-To and MUA / NUA
832say this in ~/.gnus.el: 832say 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
859in ~/.gnus.el. If you don't want HTML rendered, even if there's no text alternative add 859in @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
973in ~/.gnus.el. 973in @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
985can set options for the group. At the bottom of the buffer 985can set options for the group. At the bottom of the buffer
986you'll find an item that allows you to set variables 986you'll find an item that allows you to set variables
987locally for the group. To disable threading enter 987locally for the group. To disable threading enter
988gnus-show-threads as name of variable and nil as 988gnus-show-threads as name of variable and @code{nil} as
989value. Hit button done at the top of the buffer when 989value. Hit button done at the top of the buffer when
990you're ready. 990you'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
1150in ~/.gnus.el. 1150in @file{~/.gnus.el}.
1151 1151
1152An example might be better than thousand words, so here's 1152An example might be better than thousand words, so here's
1153my nnmail-split-methods. Note that I send duplicates in a 1153my 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
1272in ~/.gnus.el. 1272in @file{~/.gnus.el}.
1273 1273
1274You can reformat a paragraph by hitting @samp{M-q} 1274You 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,
1303organization, address, name or body. The attribute name 1303organization, address, name or body. The attribute name
1304can also be a string. In that case, this will be used as 1304can also be a string. In that case, this will be used as
1305a header name, and the value will be inserted in the 1305a header name, and the value will be inserted in the
1306headers of the article; if the value is `nil', the header 1306headers of the article; if the value is @code{nil}, the header
1307name will be removed. You can also say (eval (foo bar)), 1307name will be removed. You can also say (eval (foo bar)),
1308then the function foo will be evaluated with argument bar 1308then the function foo will be evaluated with argument bar
1309and the result will be thrown away. 1309and 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
1398In your ~/.gnus.el, if you prefer on-the-fly spell-checking say 1398In 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
1426in ~/.gnus.el. Change "^de\\." and "deutsch8" to something 1426in @file{~/.gnus.el}. Change "^de\\." and "deutsch8" to something
1427that suits your needs. 1427that suits your needs.
1428 1428
1429@node FAQ 5-7 1429@node FAQ 5-7
@@ -1452,7 +1452,7 @@ details.
1452However, what you really want is the Insidious Big Brother 1452However, what you really want is the Insidious Big Brother
1453Database bbdb. Get it through the XEmacs package system or from 1453Database 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}.
1455Now place the following in ~/.gnus.el, to activate bbdb for Gnus: 1455Now 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
1535in ~/.gnus.el. If you use Gnus 5.10, you can simply add an entry 1535in @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
1553Put this in ~/.gnus.el: 1553Put 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
1582Since 5.10 Gnus doesn't generate a sender header by 1582Since 5.10 Gnus doesn't generate a sender header by
1583default. For older Gnus' try this in ~/.gnus.el: 1583default. 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
1648in ~/.gnus.el. If you use Gnus 5.9 or earlier, you can use this 1648in @file{~/.gnus.el}. If you use Gnus 5.9 or earlier, you can use this
1649instead (works for newer versions as well): 1649instead (works for newer versions as well):
1650 1650
1651@example 1651@example
@@ -1745,7 +1745,7 @@ by saying @samp{O f}. However, wouldn't
1745it be much more convenient to have more direct access to 1745it be much more convenient to have more direct access to
1746the archived message from Gnus? If you say yes, put this 1746the archived message from Gnus? If you say yes, put this
1747snippet by Frank Haun <pille3003@@fhaun.de> in 1747snippet 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
1901Say something like this in ~/.gnus.el: 1901Say 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
1980mail and news and store them on disk for reading them 1980mail and news and store them on disk for reading them
1981later when you're offline. It kind of mimics offline 1981later when you're offline. It kind of mimics offline
1982newsreaders like Forte Agent. If you want to use 1982newsreaders like Forte Agent. If you want to use
1983the Agent place the following in ~/.gnus.el if you are 1983the Agent place the following in @file{~/.gnus.el} if you are
1984still using 5.8.8 or 5.9 (it's the default since 5.10): 1984still 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?
2175The reason for this could be the way Gnus reads its 2175The reason for this could be the way Gnus reads its
2176active file, see the node "The Active File" in the Gnus 2176active file, see the node "The Active File" in the Gnus
2177manual for things you might try to speed the process up. 2177manual for things you might try to speed the process up.
2178An other idea would be to byte compile your ~/.gnus.el (say 2178An 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
2180RET} to do it). Finally, if you have require 2180RET} to do it). Finally, if you have require
2181statements in your .gnus, you could replace them with 2181statements in your .gnus, you could replace them with
2182eval-after-load, which loads the stuff not at startup 2182eval-after-load, which loads the stuff not at startup
2183time, but when it's needed. Say you've got this in your 2183time, 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
2210A speed killer is setting the variable 2210A speed killer is setting the variable
2211gnus-fetch-old-headers to anything different from nil, 2211gnus-fetch-old-headers to anything different from @code{nil},
2212so don't do this if speed is an issue. To speed up 2212so don't do this if speed is an issue. To speed up
2213building of summary say 2213building 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
2220at the bottom of your ~/.gnus.el, this will make gnus 2220at the bottom of your @file{~/.gnus.el}, this will make gnus
2221byte-compile things like 2221byte-compile things like
2222gnus-summary-line-format. 2222gnus-summary-line-format.
2223then you could increase the value of gc-cons-threshold 2223then 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
2240in ~/.gnus.el (thanks to Jesper harder for the last 2240in @file{~/.gnus.el} (thanks to Jesper harder for the last
2241two suggestions). Finally if you are still using 5.8.8 2241two suggestions). Finally if you are still using 5.8.8
2242or 5.9 and experience speed problems with summary 2242or 5.9 and experience speed problems with summary
2243buffer generation, you definitely should update to 2243buffer 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
2266When the term ~/.gnus.el is used it just means your Gnus 2266When the term @file{~/.gnus.el} is used it just means your Gnus
2267configuration file. You might as well call it ~/.gnus or 2267configuration file. You might as well call it @file{~/.gnus} or
2268specify another name. 2268specify 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:
12537Modify to suit your needs. 12537Modify to suit your needs.
12538 12538
12539@vindex gnus-message-highlight-citation 12539@vindex gnus-message-highlight-citation
12540If @code{gnus-message-highlight-citation} is t, different levels of 12540If @code{gnus-message-highlight-citation} is @code{t}, different levels of
12541citations are highlighted like in Gnus article buffers also in message 12541citations are highlighted like in Gnus article buffers also in message
12542mode buffers. 12542mode buffers.
12543 12543
@@ -20487,7 +20487,7 @@ matches. This takes a long time in big groups.
20487You can inhibit this slow scoring on headers or body by setting the 20487You can inhibit this slow scoring on headers or body by setting the
20488variable @code{gnus-inhibit-slow-scoring}. If 20488variable @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
20490the group matches the regexp. If it is t, slow scoring on it is 20490the group matches the regexp. If it is @code{t}, slow scoring on it is
20491inhibited for all groups. 20491inhibited for all groups.
20492 20492
20493Now, there's not much you can do about the slowness for news groups, but for 20493Now, 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
21417If nil (the default) this will use @code{gnus-summary-line-format}. 21417If @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
21420If non-nil, a function that retrieves article headers rather than using 21420If non-@code{nil}, a function that retrieves article headers rather than using
21421the gnus built-in function. This function takes an article list and 21421the gnus built-in function. This function takes an article list and
21422group as arguments and populates the `nntp-server-buffer' with the 21422group as arguments and populates the `nntp-server-buffer' with the
21423retrieved headers. It should then return either 'nov or 'headers 21423retrieved headers. It should then return either 'nov or 'headers
21424indicating the retrieved header format. Failure to retrieve headers 21424indicating the retrieved header format. Failure to retrieve headers
21425should return @code{nil}. 21425should return @code{nil}.
21426 21426
21427If this variable is nil, or if the provided function returns nil for a 21427If this variable is @code{nil}, or if the provided function returns
21428search result, @code{gnus-retrieve-headers} will be called instead." 21428@code{nil} for a search result, @code{gnus-retrieve-headers} will be
21429called 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
21928search for determining the file name of the article. This, of course, is 21929search for determining the file name of the article. This, of course, is
21929way slower than the registry---if you set hundreds or even thousands of 21930way slower than the registry---if you set hundreds or even thousands of
21930marks this way, it might take some time. You can avoid this situation by 21931marks this way, it might take some time. You can avoid this situation by
21931setting @code{nnmairix-only-use-registry} to t. 21932setting @code{nnmairix-only-use-registry} to @code{t}.
21932 21933
21933Maybe you also want to propagate marks the other way round, i.e., if you 21934Maybe you also want to propagate marks the other way round, i.e., if you
21934tick an article in a "real" mail group, you'd like to have the same 21935tick an article in a "real" mail group, you'd like to have the same
@@ -24874,7 +24875,7 @@ classified as spammers.
24874While @code{spam-use-BBDB-exclusive} @emph{can} be used as an alias 24875While @code{spam-use-BBDB-exclusive} @emph{can} be used as an alias
24875for @code{spam-use-BBDB} as far as @code{spam.el} is concerned, it is 24876for @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
24878will be exclusive. 24879will 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
794Given @var{props}, a list of text-properties, return the value of the 794Given @var{props}, a list of text-properties, return the value of the
795face property, or nil. 795face 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.
824This matches Emacs's behavior when deciding on which face attributes to 824This matches Emacs's behavior when deciding on which face attributes to
825use, to the best of my understanding ). 825use, to the best of my understanding ).
826 826
827If @var{class} is nil, then you just get get whatever 827If @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
829effect for @var{face}. 829effect 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})
1647Non-@code{nil} means completion will always honor the settings in 1647Non-@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
1649case strings will always be completed to lower case, no matter what the 1649case strings will always be completed to lower case, no matter what the
1650settings in @code{idlwave-completion-case}. 1650settings 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
151screen, it is necessary to give you special advice at the beginning. 151screen, it is necessary to give you special advice at the beginning.
152 152
153If the entire text you are looking at fits on the screen, the text 153If 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
155stand-alone Info reader, it is displayed at the bottom right corner of 155mode line (usually, the line in inverse video). If you see the text
156the 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
157text @samp{Top} instead, it means that there is more text below that 157not fit. To move forward through the text and see another screenful,
158does not fit. To move forward through the text and see another screen 158press @key{SPC}, the Space bar. To move back up, press the key
159full, press @key{SPC}, the Space bar. To move back up, press the key
160labeled @samp{Backspace} or @samp{DEL} (on some keyboards, this key 159labeled @samp{Backspace} or @samp{DEL} (on some keyboards, this key
161might be labeled @samp{Delete}), or @key{S-SPC}. 160might 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
163stand-alone Info reader (nor in Emacs, if you are using it in a
164text-mode terminal).
162 165
163@ifinfo 166@ifinfo
164Here are 40 lines of junk, so you can try @key{SPC} and @key{DEL} (or 167Here 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 168see what they do. At the end are instructions of what you should do
166what you should do next. 169next.
167 170
168@format 171@format
169This is line 20 172This is line 20
@@ -209,11 +212,11 @@ This is line 59
209@end format 212@end format
210 213
211If you have managed to get here, go back to the beginning with 214If 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
213understand the about the @samp{Space} and @samp{Backspace} keys. So 216understand about the @samp{Space} and @samp{Backspace} keys. So now
214now type an @kbd{n}---just one character; don't type the quotes and 217type an @kbd{n}---just one character; don't type the quotes and don't
215don't type the Return key afterward---to get to the normal start of 218type the Return key afterward---to get to the normal start of the
216the course. 219course.
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
407return here, that is---press and hold @key{CTRL}, type an @kbd{x},
408then release @key{CTRL} and @kbd{x}, and press @kbd{0}; that's a zero,
409not 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
412will be expected to know how to use @key{SPC} and @key{BACKSPACE} to 412will be expected to know how to use @key{SPC} and @key{BACKSPACE} to
413move around in them without being told. Since not all terminals have 413move 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}.
478If you immediately want to go to that node, without having to scroll 478If you immediately want to go to that node, without having to scroll
479to the bottom of the screen first, you can type @kbd{]}. 479to the bottom of the screen first, you can type @kbd{]}.
480 480
481Similarly, @kbd{@key{BACKSPACE}} (or @kbd{@key{S-SPC}}) carries you to 481Similarly, @kbd{@key{BACKSPACE}} carries you to the preceding node
482the preceding node regardless of level, after you scrolled to the 482regardless of level, after you scrolled to the beginning of the
483beginning of the present node. If you want to go to the preceding 483present node. If you want to go to the preceding node immediately,
484node immediately, you can type @kbd{[}. 484you can type @kbd{[}.
485 485
486For instance, typing this sequence will come back here in three steps: 486For 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
1216If set to a non-@code{nil} value, @key{SPC} and @key{BACKSPACE} (or 1216If 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
1218current node before scrolling to its end or beginning, respectively. 1218current node before scrolling to its end or beginning, respectively.
1219For example, if the node's menu appears on the screen, the next 1219For 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
307make updates as fast as possible. Note that by using these options, 307make updates as fast as possible. Note that by using these options,
308absolutely no integrity checking is done. If your database somehow gets 308absolutely no integrity checking is done. If your database somehow gets
309corrupted, simply delete it and update. If `mairix-synchronous-update' 309corrupted, simply delete it and update. If `mairix-synchronous-update'
310is nil (the default), mairix will be called in a subprocess so Emacs 310is @code{nil} (the default), mairix will be called in a subprocess so Emacs
311will still be usable while the update is done. 311will 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
2139Local value for the column beyond which automatic line-wrapping should 2139Local value for the column beyond which automatic line-wrapping should
2140happen for message buffers. If non-nil (the default), also turn on 2140happen for message buffers. If non-@code{nil} (the default), also turn on
2141auto-fill in message buffers. 2141auto-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
3740The hook @code{mh-kill-folder-suppress-prompt-functions} is an abnormal 3740The hook @code{mh-kill-folder-suppress-prompt-functions} is an abnormal
3741hook run at the beginning of the command @kbd{k}. The hook functions 3741hook run at the beginning of the command @kbd{k}. The hook functions
3742are called with no arguments and should return a non-nil value to 3742are called with no arguments and should return a non-@code{nil} value to
3743suppress the normal prompt when you remove a folder. This is useful 3743suppress the normal prompt when you remove a folder. This is useful
3744for folders that are easily regenerated. The default value of 3744for 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.
4078This may also be a function to do local parsing and identify point to be 4078This may also be a function to do local parsing and identify point to be
4079in a non-standard label environment. The function must take an 4079in a non-standard label environment. The function must take an
4080argument @var{bound} and limit backward searches to this value. It 4080argument @var{bound} and limit backward searches to this value. It
4081should return either nil or a cons cell @code{(@var{function} 4081should 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
4083special environment starts. See the Info documentation for an 4083special environment starts. See the Info documentation for an
4084example. 4084example.
@@ -4235,7 +4235,7 @@ special packages like fancyref) are being used. RefTeX can and by
4235default does parse around each label to detect the correct label type, 4235default does parse around each label to detect the correct label type,
4236but this process can be slow when a document contains thousands of 4236but this process can be slow when a document contains thousands of
4237labels. If you use label prefixes consistently, you may speed up 4237labels. If you use label prefixes consistently, you may speed up
4238document parsing by setting this variable to a non-nil value. RefTeX 4238document parsing by setting this variable to a non-@code{nil} value. RefTeX
4239will then compare the label prefix with the prefixes found in 4239will 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.
4241Possible values for this option are: 4241Possible values for this option are:
@@ -4822,7 +4822,7 @@ case.
4822 4822
4823@defopt reftex-index-verify-function 4823@defopt reftex-index-verify-function
4824A function which is called at each match during global indexing. 4824A function which is called at each match during global indexing.
4825If the function returns nil, the current match is skipped. 4825If 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
4944Non-@code{nil} means, automatic citation display will revisit files if 4944Non-@code{nil} means, automatic citation display will revisit files if
4945necessary. When nil, citation display in echo area will only be active 4945necessary. When @code{nil}, citation display in echo area will only be active
4946for cached echo strings (see @code{reftex-cache-cite-echo}), or for 4946for 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
4948buffers. 4948buffers.
@@ -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
5278You may also set the variable itself to t or nil in order to turn all 5278You may also set the variable itself to @code{t} or @code{nil} in
5279options on or off, respectively.@* 5279order to turn all options on or off, respectively.@*
5280Supplying labels in new sections and environments applies when creating 5280Supplying labels in new sections and environments applies when creating
5281sections with @kbd{C-c C-s} and environments with @kbd{C-c C-e}.@* 5281sections with @kbd{C-c C-s} and environments with @kbd{C-c C-e}.@*
5282Supplying macro arguments applies when you insert such a macro 5282Supplying 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
5288Non-@code{nil} means, follow-mode will revisit files if necessary. 5288Non-@code{nil} means, follow-mode will revisit files if necessary.
5289When nil, follow-mode will be suspended for stuff in unvisited files. 5289When @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.
5395This can speed-up document parsing, but may in some cases reduce the 5395This can speed-up document parsing, but may in some cases reduce the
5396quality of the context used by RefTeX to describe a label. 5396quality of the context used by RefTeX to describe a label.
5397@item 5397@item
5398Fixed bug in @code{reftex-create-bibtex-file} when @code{reftex-comment-citations} 5398Fixed bug in @code{reftex-create-bibtex-file} when
5399is non-nil. 5399@code{reftex-comment-citations} is non-@code{nil}.
5400@item 5400@item
5401Fixed bugs in indexing: Case-sensitive search, quotes before and/or 5401Fixed bugs in indexing: Case-sensitive search, quotes before and/or
5402after words. Disabled indexing in comment lines. 5402after 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
5744info. 5744info.
5745@item 5745@item
5746Default of @code{reftex-revisit-to-follow} changed to nil. 5746Default 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
223ranges. 223ranges.
224 224
225@table @kbd 225@table @kbd
226@item C-SPC 226@item C-@key{SPC}
227@itemx C-@@ 227@itemx C-@@
228Set mark at point (@code{set-mark-command}). 228Set 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
1178Supplies the @code{INDENT} macro. When @code{INDENT} is non-nil, then 1178Supplies the @code{INDENT} macro. When @code{INDENT} is non-@code{nil}, then
1179each line is individually indented with 1179each 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}
1579Insert @var{template} using @var{dictionary} into @var{stream}. 1579Insert @var{template} using @var{dictionary} into @var{stream}.
1580If @var{stream} is nil, then use the current buffer. 1580If @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}
637if the option is non-nil, omit this marker if the option is nil. 637if 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
642symbol if the option is nil. Since this symbol only applies to diary 642symbol if the option is @code{nil}. Since this symbol only applies to diary
643items, the new item is automatically marked as such, i.e., lacks 643items, 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
659the minibuffer instead of automatically inserting the current time; 659the minibuffer instead of automatically inserting the current time;
660however, typing @key{RET} at the prompt enters the current time if 660however, 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
662empty string (i.e., no time string). 662empty 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
670text of the new item, and insert this in accordance with the item 670text of the new item, and insert this in accordance with the item
671insertion options and other parameters passed. If the option 671insertion 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
673region only when it is highlighted; otherwise, use the region 673region only when it is highlighted; otherwise, use the region
674regardless of highlighting. 674regardless 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
817present; otherwise, add one. Typing @key{RET} at the prompt enters 817present; otherwise, add one. Typing @key{RET} at the prompt enters
818the current time if @code{todo-always-add-time-string} is non-nil, 818the current time if @code{todo-always-add-time-string} is non-@code{nil},
819otherwise it enters the empty string (i.e., no time string). 819otherwise 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
841string, and, if the option @code{todo-always-add-time-string} is 841string, and, if the option @code{todo-always-add-time-string} is
842non-nil, also for editing its time string. 842non-@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
845you type @key{RET} on a date in the calendar makes that date the 845you 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}
1029or @kbd{Y}, but not @key{SPC}, as an affirmative answer. This is to 1029or @kbd{Y}, but not @key{SPC}, as an affirmative answer. This is to
1030diminish the risk of unintentionally executing the command, which is 1030diminish the risk of unintentionally executing the command, which is
1031especially important with commands that do deletion, since there is no 1031especially important with commands that do deletion, since there is no
1032Todo command to undo a deletion. If you want to be able to use SPC for 1032Todo command to undo a deletion. If you want to be able to use @key{SPC} for
1033confirmation, enable the option @code{todo-y-with-space}. 1033confirmation, 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
1175You may find it preferable not to delete empty todo categories but to 1175You may find it preferable not to delete empty todo categories but to
1176enable the option @code{todo-skip-archived-categories}. When this is 1176enable the option @code{todo-skip-archived-categories}. When this is
1177non-nil, such empty todo categories are skipped over by the sequential 1177non-@code{nil}, such empty todo categories are skipped over by the sequential
1178category navigation commands @kbd{f} and @kbd{b}, so they don't distract you 1178category navigation commands @kbd{f} and @kbd{b}, so they don't distract you
1179while navigating and you maintain the structural correspondence between 1179while navigating and you maintain the structural correspondence between
1180todo and archive files (you can also still jump to empty todo categories 1180todo 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
875This function returns non-nil if a cache entry has expired (or is absent). 875This function returns non-@code{nil} if a cache entry has expired (or is absent).
876The arguments are a URL and optional expiration delay in seconds 876The 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}
901already exists in the directory, Emacs will visit that file, and if not, 901already exists in the directory, Emacs will visit that file, and if not,
902the file will be created. Emacs will use the file name (@file{vip.el}, in 902the file will be created. Emacs will use the file name (@file{vip.el}, in
903this case) as the name of the buffer visiting the file. In order to make 903this case) as the name of the buffer visiting the file. In order to make
904the buffer name unique, Emacs may append @samp{<2>}, @samp{<3>} etc., to 904the buffer name unique, Emacs may add a suffix (@pxref{Uniquify,,,
905the buffer name. As the @dfn{file name completion} is provided here, you 905emacs, The GNU Emacs Manual}). As @dfn{file name completion} is provided here, you
906can sometime save typing. For instance, suppose there is only one file in the 906can sometimes save typing. For instance, suppose there is only one file in the
907default directory whose name starts with @samp{v}, that is @samp{vip.el}. 907default directory whose name starts with @samp{v}, that is @samp{vip.el}.
908Then if you just type @kbd{v @key{TAB}} then it will be completed to 908Then 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}
1445Skip the lookahead token in order to resume parsing. 1445Skip the lookahead token in order to resume parsing.
1446Return nil. 1446Return @code{nil}.
1447Must be used in error recovery semantic actions. 1447Must be used in error recovery semantic actions.
1448 1448
1449It typically looks like this: 1449It 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
1465Safely skip a block in order to resume parsing. 1465Safely skip a block in order to resume parsing.
1466Return nil. 1466Return @code{nil}.
1467Must be used in error recovery semantic actions. 1467Must be used in error recovery semantic actions.
1468 1468
1469A block is data between an open-delimiter (syntax class @code{(}) and 1469A 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.
630Scroll the man page up the window (@code{scroll-up}). 630Scroll 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 @@
12014-06-08 Leo Liu <sdl.web@gmail.com>
2
3 * themes/deeper-blue-theme.el: Use another fix. (Bug#17695)
4
12014-06-08 Juri Linkov <juri@jurta.org> 52014-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):
diff --git a/etc/NEWS b/etc/NEWS
index dd802b94b21..cfda70f62a8 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -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.
550In other words, if you visit two files that have the same base name,
551then rather than creating buffers basename and basename<2>,
552Emacs uses basename<dirA> and basename<dirB>. To change this,
553customize `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 @@
12014-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
12014-06-08 Juri Linkov <juri@jurta.org> 92014-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
1421If you load a file containing bookmarks with the same names as 1421If you load a file containing bookmarks with the same names as
1422bookmarks already present in your Emacs, the new bookmarks will get 1422bookmarks already present in your Emacs, the new bookmarks will get
1423unique numeric suffixes \"<2>\", \"<3>\", ... following the same 1423unique numeric suffixes \"<2>\", \"<3>\", etc."
1424method 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.
1642FILENAME (sans directory) is used unchanged if that name is free; 1644FILENAME (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.
43If the value is nil and `inhibit-startup-screen' is nil, show the 43If the value is nil and `inhibit-startup-screen' is nil, show the
44startup screen. If the value is a string, switch to a buffer 44startup screen. If the value is a string, switch to a buffer
45visiting the file or directory specified by that string. If the 45visiting the file or directory that the string specifies. If the
46value is a function, switch to the buffer returned by that 46value is a function, call it with no arguments and switch to the buffer
47function. If t, open the `*scratch*' buffer. 47that it returns. If t, open the `*scratch*' buffer.
48 48
49A string value also causes emacsclient to open the specified file 49If you use `emacsclient' with no target file, then it obeys any
50or directory when no target file is specified." 50string 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.
98The value determines the buffer name style and is one of `forward', 98The 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.
100For example, files `/foo/bar/mumble/name' and `/baz/quux/mumble/name' 100
101For example, the files `/foo/bar/mumble/name' and `/baz/quux/mumble/name'
101would have the following buffer names in the various styles: 102would 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>
107Of course, the \"mumble\" part may be stripped as well, depending on the setting 108 nil name name<2>
108of `uniquify-strip-common-suffix'." 109
110The \"mumble\" part may be stripped as well, depending on the
111setting of `uniquify-strip-common-suffix'. For more options that
112you 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 @@
12014-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
12014-06-08 Paul Eggert <eggert@cs.ucla.edu> 72014-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
2349DEFUN ("<", Flss, Slss, 1, MANY, 0, 2349DEFUN ("<", 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.
2351usage: (< NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) 2351usage: (< 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
2357DEFUN (">", Fgtr, Sgtr, 1, MANY, 0, 2357DEFUN (">", 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.
2359usage: (> NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) 2359usage: (> 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
2365DEFUN ("<=", Fleq, Sleq, 1, MANY, 0, 2365DEFUN ("<=", 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.
2367All must be numbers or markers.
2368usage: (<= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) 2367usage: (<= 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
2374DEFUN (">=", Fgeq, Sgeq, 1, MANY, 0, 2373DEFUN (">=", 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.
2376All must be numbers or markers.
2377usage: (>= NUMBER-OR-MARKER &rest NUMBERS-OR-MARKERS) */) 2375usage: (>= 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'.
6030This variable affects calls to `write-region' as well as save commands. 6030This variable affects calls to `write-region' as well as save commands.
6031Setting this to nil may avoid data loss if the system loses power or 6031Setting this to nil may avoid data loss if the system loses power or
6032the operating system crashes. */); 6032the 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,