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

2 files changed, 8 insertions, 1 deletions

diff --git a/doc/lispref/macros.texi b/doc/lispref/macros.texi
index 7f3b670e328..3f9db8ce375 100644
--- 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 9b9e693d185..9a107f816ef 100644
--- 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.