Document the new paren-space indentation rule

* doc/emacs/programs.texi (Lisp Indent): Mention the new
paren-space indentation rule.

diff --git a/doc/emacs/programs.texi b/doc/emacs/programs.texi
index ec11b0c00f215d3d10cfddc83c92aa252709a721..51a48df2e270425f5707929620238f67286d4bbc 100644 (file)
--- a/doc/emacs/programs.texi
+++ b/doc/emacs/programs.texi
@@ -471,6 +471,23 @@ the function name.  This is normally done for macro definitions, using
 the @code{declare} construct.  @xref{Defining Macros,,, elisp, The
 Emacs Lisp Reference Manual}.
 
+  In Emacs Lisp, lists are usually indented as if they are
+function-like forms:
+
+@lisp
+(setq foo '(bar zot
+                gazonk))
+@end lisp
+
+  However, if you add a space after the opening parenthesis, this tells
+Emacs that it's a data list instead of a piece of code, and Emacs will
+then indent it like this:
+
+@lisp
+(setq foo '( bar zot
+             gazonk))
+@end lisp
+
 @node C Indent
 @subsection Commands for C Indentation
 

diff --git a/etc/NEWS b/etc/NEWS
index 56fdbecff39930132aafb57da34ed54ad5730fff..f211a98678c28d4ed486b3e63b2892e3d39eb424 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1703,8 +1703,10 @@ work as before.
 
 ** Emacs Lisp mode
 
+---
 *** The mode-line now indicates whether we're using lexical or dynamic scoping.
 
++++
 *** A space between an open paren and a symbol changes the indentation rule.
 The presence of a space between an open paren and a symbol now is
 taken as a statement by the programmer that this should be indented