From 63adf9dcf53ac64585803fe5f9ad0acb107a9f9f Mon Sep 17 00:00:00 2001 From: Stefan Kangas Date: Mon, 24 Feb 2025 03:45:18 +0100 Subject: [PATCH] ; Reflow some cl-lib docstrings * lisp/emacs-lisp/cl-macs.el (cl-flet, cl-labels): Reflow docstrings. --- lisp/emacs-lisp/cl-macs.el | 30 ++++++++++++++++-------------- 1 file changed, 16 insertions(+), 14 deletions(-) diff --git a/lisp/emacs-lisp/cl-macs.el b/lisp/emacs-lisp/cl-macs.el index b07a881ba48..555b4f018ad 100644 --- a/lisp/emacs-lisp/cl-macs.el +++ b/lisp/emacs-lisp/cl-macs.el @@ -2067,15 +2067,15 @@ a `let' form, except that the list of symbols can be computed at run-time." ;;;###autoload (defmacro cl-flet (bindings &rest body) "Make local function definitions. -Each definition can take the form (FUNC EXP) where -FUNC is the function name, and EXP is an expression that returns the -function value to which it should be bound, or it can take the more common -form (FUNC ARGLIST BODY...) which is a shorthand -for (FUNC (lambda ARGLIST BODY)). -FUNC is defined only within FORM, not BODY, so you can't write -recursive function definitions. Use `cl-labels' for that. See -info node `(cl) Function Bindings' for details. +Each definition can take the form (FUNC EXP) where FUNC is the function +name, and EXP is an expression that returns the function value to which +it should be bound, or it can take the more common form (FUNC ARGLIST +BODY...) which is a shorthand for (FUNC (lambda ARGLIST BODY)). + +FUNC is defined only within FORM, not BODY, so you can't write recursive +function definitions. Use `cl-labels' for that. See Info node +`(cl) Function Bindings' for details. \(fn ((FUNC ARGLIST BODY...) ...) FORM...)" (declare (indent 1) @@ -2250,12 +2250,14 @@ Like `cl-flet' but the definitions can refer to previous ones. ;;;###autoload (defmacro cl-labels (bindings &rest body) "Make local (recursive) function definitions. -BINDINGS is a list of definitions of the form (FUNC ARGLIST BODY...) where -FUNC is the function name, ARGLIST its arguments, and BODY the -forms of the function body. FUNC is defined in any BODY, as well -as FORM, so you can write recursive and mutually recursive -function definitions. See info node `(cl) Function Bindings' for -details. + +BINDINGS is a list of definitions of the form (FUNC ARGLIST BODY...) +where FUNC is the function name, ARGLIST its arguments, and BODY the +forms of the function body. + +FUNC is defined in any BODY, as well as FORM, so you can write recursive +and mutually recursive function definitions. See Info node +`(cl) Function Bindings' for details. \(fn ((FUNC ARGLIST BODY...) ...) FORM...)" (declare (indent 1) (debug cl-flet))