* doc/lispref/macros.texi (Expansion): Document 'macroexpand-1'.

diff --git a/doc/lispref/macros.texi b/doc/lispref/macros.texi
index 7f3b670e328386d126e0c3189a0fb520a7a46191..3f9db8ce3756ff37fcbb23a657f58a9aaee9ee1f 100644 (file)
--- a/doc/lispref/macros.texi
+++ b/doc/lispref/macros.texi
@@ -160,6 +160,12 @@ expand the embedded calls to @code{inc}:
 
 @end defun
 
+@defun macroexpand-1 form &optional environment
+This function expands macros like @code{macroexpand}, but it only
+performs one step of the expansion: if the result is another macro
+call, @code{macroexpand-1} will not expand it.
+@end defun
+
 @node Compiling Macros
 @section Macros and Byte Compilation
 @cindex byte-compiling macros

diff --git a/etc/NEWS b/etc/NEWS
index 9b9e693d1855117e064e632f4fe25c11e631b00e..9a107f816efc70c4cd8c5547b7f3a528f68dc2f8 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -1428,7 +1428,8 @@ evaluated (and should return a string) when the closure is built.
 +++
 ** define-inline provides a new way to define inlinable functions.
 
-** New function `macroexpand-1' to perform a single step of macroexpansion.
++++
+** New function `macroexpand-1' to perform a single step of macro expansion.
 
 ** Some "x-*" were obsoleted:
 *** x-select-text is renamed gui-select-text.