# HG changeset patch
# User Richard M. Stallman <rms@gnu.org>
# Date 783663663 0
# Node ID 6a9124f418db60eb6fd59997cc5193e0ac0dfb0d
# Parent  61b41f22369504c6a648a8e1550671e8905225bf
(cl-macroexpand): keep documentation from `macroexpand'.

diff -r 61b41f223695 -r 6a9124f418db lisp/emacs-lisp/cl.el
--- a/lisp/emacs-lisp/cl.el	Tue Nov 01 04:20:43 1994 +0000
+++ b/lisp/emacs-lisp/cl.el	Tue Nov 01 04:21:03 1994 +0000
@@ -254,6 +254,13 @@
 			     (defalias 'macroexpand 'cl-macroexpand)))
 
 (defun cl-macroexpand (cl-macro &optional cl-env)
+  "Return result of expanding macros at top level of FORM.
+If FORM is not a macro call, it is returned unchanged.
+Otherwise, the macro is expanded and the expansion is considered
+in place of FORM.  When a non-macro-call results, it is returned.
+
+The second optional arg ENVIRONMENT species an environment of macro
+definitions to shadow the loaded ones for use in file byte-compilation."
   (let ((cl-macro-environment cl-env))
     (while (progn (setq cl-macro (funcall cl-old-macroexpand cl-macro cl-env))
 		  (and (symbolp cl-macro)