]> git.eshelyaron.com Git - emacs.git/commitdiff
* doc/emacs/indent.texi (Tab Stops): Updates for new tab-stop behavior.
authorGlenn Morris <rgm@gnu.org>
Tue, 28 Jan 2014 02:16:13 +0000 (21:16 -0500)
committerGlenn Morris <rgm@gnu.org>
Tue, 28 Jan 2014 02:16:13 +0000 (21:16 -0500)
* etc/NEWS: Related markup.

doc/emacs/ChangeLog
doc/emacs/indent.texi
etc/NEWS

index bac170eaf3a5a6a6144abc7a1fc5afeb11db9432..ba6430c482667ce233dc4cb28aa1a3fddb617ded 100644 (file)
@@ -1,3 +1,7 @@
+2014-01-28  Glenn Morris  <rgm@gnu.org>
+
+       * indent.texi (Tab Stops): Updates for new tab-stop behavior.
+
 2014-01-27  Glenn Morris  <rgm@gnu.org>
 
        * dired.texi (Misc Dired Features): Copyedits for hide-details.
index e0c269ad57553886f8783be7a6d33587e7ee081c..f5543cc49b0ba07f985e5f4088f5906bd53e5f84 100644 (file)
@@ -157,10 +157,12 @@ C-u -999 C-x @key{TAB}
   Emacs defines certain column numbers to be @dfn{tab stops}.  These
 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}).  By default, tab stops
-are located every 8 columns.  These positions are stored in the
-variable @code{tab-stop-list}, whose value is a list of column numbers
-in increasing order.
+like @kbd{M-i} (@pxref{Indentation Commands}).  The variable
+@code{tab-stop-list} 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.
 
 @findex edit-tab-stops
 @kindex C-c C-c @r{(Edit Tab Stops)}
@@ -178,12 +180,15 @@ To install changes, type C-c C-c
 
 @noindent
 The first line contains a colon at each tab stop.  The numbers on the
-next two lines are present just to indicate where the colons are.  It
-is implicitly extended to infinity by repeating the last step.
+next two lines are present just to indicate where the colons are.
+If the value @code{tab-stop-list} is @code{nil}, as it is by default,
+no colons are displayed initially.
 
   You can edit this buffer to specify different tab stops by placing
 colons on the desired columns.  The buffer uses Overwrite mode
-(@pxref{Minor Modes}).  When you are done, type @kbd{C-c C-c} to make
+(@pxref{Minor Modes}).  Remember that Emacs will extend the list of
+tab stops forever by repeating the difference between the last two
+explicit stops that you place.  When you are done, type @kbd{C-c C-c} to make
 the new tab stops take effect.  Normally, the new tab stop settings
 apply to all buffers.  However, if you have made the
 @code{tab-stop-list} variable local to the buffer where you called
index 9924722c8417fb127b6b5e3c56e6226b3d926dfd..3a08223e2690debd319d266574e0e63d1e73fdf9 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -268,6 +268,7 @@ normal editing behavior.
 
 *** `electric-indent-mode' is enabled by default.
 
++++
 *** `tab-stop-list' is now implicitly extended to infinity by repeating
 the last step.  Its default value is changed to nil, which means a tab
 stop every `tab-width' columns.