[Emacs-diffs] emacs-24 r116995: Minor fixes to the docs.

[Eli Zaretskii]

------------------------------------------------------------
revno: 116995
revision-id: address@hidden
parent: address@hidden
committer: Eli Zaretskii <address@hidden>
branch nick: emacs-24
timestamp: Mon 2014-04-21 17:50:19 +0300
message:
  Minor fixes to the docs.
  
   doc/emacs/buffers.texi (Uniquify): Clarify the default uniquification.
   doc/emacs/indent.texi (Tab Stops): Improve wording.
   doc/emacs/cmdargs.texi (General Variables): Improve docs of
   EMACSLOADPATH.  Index all the environment variables.
   (Misc Variables): Index all the environment variables.
  
   doc/lispref/text.texi (Registers): Document register-read-with-preview.
   doc/lispref/internals.texi (Building Emacs): Improve indexing.
modified:
  doc/emacs/ChangeLog            changelog-20091113204419-o5vbwnq5f7feedwu-6227
  doc/emacs/buffers.texi         
buffers.texi-20091113204419-o5vbwnq5f7feedwu-6234
  doc/emacs/cmdargs.texi         
cmdargs.texi-20091113204419-o5vbwnq5f7feedwu-6238
  doc/emacs/indent.texi          
indent.texi-20091113204419-o5vbwnq5f7feedwu-6257
  doc/lispref/ChangeLog          changelog-20091113204419-o5vbwnq5f7feedwu-6155
  doc/lispref/internals.texi     
internals.texi-20091113204419-o5vbwnq5f7feedwu-6188
  doc/lispref/text.texi          text.texi-20091113204419-o5vbwnq5f7feedwu-6215

=== modified file 'doc/emacs/ChangeLog'
--- a/doc/emacs/ChangeLog       2014-04-21 14:01:56 +0000
+++ b/doc/emacs/ChangeLog       2014-04-21 14:50:19 +0000
@@ -1,3 +1,13 @@
+2014-04-21  Eli Zaretskii  <address@hidden>
+
+       * buffers.texi (Uniquify): Clarify the default uniquification.
+
+       * indent.texi (Tab Stops): Improve wording.
+
+       * cmdargs.texi (General Variables): Improve docs of
+       EMACSLOADPATH.  Index all the environment variables.
+       (Misc Variables): Index all the environment variables.
+
 2014-04-13  Eli Zaretskii  <address@hidden>
 
        * display.texi (Cursor Display): Explain better how to customize

=== modified file 'doc/emacs/buffers.texi'
--- a/doc/emacs/buffers.texi    2014-01-27 02:03:26 +0000
+++ b/doc/emacs/buffers.texi    2014-04-21 14:50:19 +0000
@@ -611,8 +611,12 @@
 the buffers distinct names.  The default method
 (@code{uniquify-buffer-name-style} set to
 @code{post-forward-angle-brackets}) for making buffer names unique
-adds @samp{<dir1>}, @samp{<dir2>}, etc. to the end of the buffer
-names.
+adds @samp{<dir1>}, @samp{<dir2>}, etc.@: to the end of the buffer
+names, where @file{dir1} and @file{dir2} are the minimal parts of the
+leading directories needed to make the buffer name unique.  For
+example, if you have files @file{/foo/bar/mumble/name} and
address@hidden/baz/quux/mumble/name} visited, their buffers will be named
address@hidden<bar/mumble>} and @samp{name<quux/mumble>} correspondingly.
 
 @vindex uniquify-buffer-name-style
   There are several styles to make buffer names unique.  To select

=== modified file 'doc/emacs/cmdargs.texi'
--- a/doc/emacs/cmdargs.texi    2014-03-12 21:00:36 +0000
+++ b/doc/emacs/cmdargs.texi    2014-04-21 14:50:19 +0000
@@ -439,7 +439,7 @@
 some other programs.  Emacs does not require any of these environment
 variables to be set, but it uses their values if they are set.
 
address@hidden @env
address@hidden @env
 @item CDPATH
 Used by the @code{cd} command to search for the directory you specify,
 when you specify a relative directory name.
@@ -464,7 +464,9 @@
 @code{load-path} variable (@pxref{Lisp Libraries}).  An empty element
 stands for the default value of @code{load-path}; e.g., using
 @samp{EMACSLOADPATH="/tmp:"} adds @file{/tmp} to the front of
-the default @code{load-path}.
+the default @code{load-path}.  To specify an empty element in the
+middle of the list, use 2 colons in a row, as in
address@hidden"/tmp::/foo"}.
 @item EMACSPATH
 A colon-separated list of directories to search for executable files.
 If set, Emacs uses this in addition to @env{PATH} (see below) when
@@ -598,14 +600,14 @@
 @item VERSION_CONTROL
 Used to initialize the @code{version-control} variable (@pxref{Backup
 Names}).
address@hidden table
address@hidden vtable
 
 @node Misc Variables
 @appendixsubsec Miscellaneous Variables
 
 These variables are used only on particular configurations:
 
address@hidden @env
address@hidden @env
 @item COMSPEC
 On MS-DOS and MS-Windows, the name of the command interpreter to use
 when invoking batch files and commands internal to the shell.  On MS-DOS
@@ -657,7 +659,7 @@
 versions of Emacs to share the same environment variable settings, and
 it allows you to move the Emacs installation directory, without
 changing any environment or registry settings.
address@hidden table
address@hidden vtable
 
 @node MS-Windows Registry
 @appendixsubsec The MS-Windows System Registry

=== modified file 'doc/emacs/indent.texi'
--- a/doc/emacs/indent.texi     2014-03-12 06:48:20 +0000
+++ b/doc/emacs/indent.texi     2014-04-21 14:50:19 +0000
@@ -153,11 +153,11 @@
 are used as stopping points by @key{TAB} when inserting whitespace in
 Text mode and related modes (@pxref{Indentation}), and by commands
 like @kbd{M-i} (@pxref{Indentation Commands}).  The variable
address@hidden controls these positions.  The default value
-is @code{nil}, which means a tab stop every 8 columns.  The value
-can also be a list of column numbers (in increasing order) at which to
-place tab stops.  Emacs extends the list forever by repeating the
-difference between the last and next-to-last elements.
address@hidden controls these positions.  The default value is
address@hidden, which means a tab stop every 8 columns.  The value can
+also be a list of zero-based column numbers (in increasing order) at
+which to place tab stops.  Emacs extends the list forever by repeating
+the difference between the last and next-to-last elements.
 
 @findex edit-tab-stops
 @kindex C-c C-c @r{(Edit Tab Stops)}

=== modified file 'doc/lispref/ChangeLog'
--- a/doc/lispref/ChangeLog     2014-04-05 18:33:55 +0000
+++ b/doc/lispref/ChangeLog     2014-04-21 14:50:19 +0000
@@ -1,3 +1,9 @@
+2014-04-21  Eli Zaretskii  <address@hidden>
+
+       * text.texi (Registers): Document register-read-with-preview.
+
+       * internals.texi (Building Emacs): Improve indexing.
+
 2014-04-05  Glenn Morris  <address@hidden>
 
        * os.texi (Recording Input): Dribble files may contain passwords.

=== modified file 'doc/lispref/internals.texi'
--- a/doc/lispref/internals.texi        2014-03-20 23:15:19 +0000
+++ b/doc/lispref/internals.texi        2014-04-21 14:50:19 +0000
@@ -111,6 +111,8 @@
 time.)
 @end itemize
 
address@hidden change @code{load-path} at configure time
address@hidden @option{--enable-locallisppath} option to @command{configure}
   It is not advisable to put anything in @file{site-load.el} or
 @file{site-init.el} that would alter any of the features that users
 expect in an ordinary unmodified Emacs.  If you feel you must override

=== modified file 'doc/lispref/text.texi'
--- a/doc/lispref/text.texi     2014-03-25 02:47:39 +0000
+++ b/doc/lispref/text.texi     2014-04-21 14:50:19 +0000
@@ -4117,6 +4117,18 @@
 changed in the future.
 @end deffn
 
address@hidden register-read-with-preview prompt
address@hidden register preview
+This function reads and returns a register name, prompting with
address@hidden and possibly showing a preview of the existing registers
+and their contents.  The preview is shown in a temporary window, after
+the delay specified by the user option @code{register-preview-delay},
+if its value and @code{register-alist} are both address@hidden  The
+preview is also shown if the user requests help (e.g., by typing the
+help character).  We recommend that all interactive commands which
+read register names use this function.
address@hidden defun
+
 @node Transposition
 @section Transposition of Text