From: Eshel Yaron Date: Mon, 12 Aug 2024 10:40:56 +0000 (+0200) Subject: ; * lisp/emacs-lisp/scope.el (scope): Update docstring. X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=ca1bc14e955e5257348410e855d4590eb1176219;p=emacs.git ; * lisp/emacs-lisp/scope.el (scope): Update docstring. --- diff --git a/lisp/emacs-lisp/scope.el b/lisp/emacs-lisp/scope.el index 098012e2301..79968e86d53 100644 --- a/lisp/emacs-lisp/scope.el +++ b/lisp/emacs-lisp/scope.el @@ -1075,10 +1075,11 @@ Optional argument LOCAL is a local context to extend." Return a bindings graph associating symbols with their binders. It is a list of elements (OCCURRENCE LEN BINDING) where OCCURRENCE is a buffer -position where a symbol of length LEN occurs, which is bound by another -occurrence of the same symbol that starts at position BINDING. If -OCCURRENCE is itself a binding occurrence, then BINDING and OCCURRENCE -are equal. If OCCURRENCE is not lexically bound, then BINDING is nil. +position where a symbol of length LEN occurs, which is lexically bound +at position BINDING. If OCCURRENCE is itself a binding occurrence, then +BINDING is equal to OCCURRENCE. If OCCURRENCE is variable that is not +lexically bound, then BINDING is nil. If OCCURRENCE is a function name, +then BINDING is \\+`function'. This function recursively analyzes Lisp forms (HEAD . TAIL), usually starting with a top-level form, by inspecting HEAD at each level: @@ -1087,8 +1088,8 @@ starting with a top-level form, by inspecting HEAD at each level: running Emacs session, analzye the form as a function call. - Standard macros and special forms, such as `defun', `if', `let', - `pcase', quotes, backquotes and more, are handled specially according - to their particular semantics. + `pcase', `cl-loop', quotes, backquotes and more, are handled specially + according to their particular semantics. - If HEAD has the property symbol `scope-function', the value of this property is used to analyze TAIL. It should be a function that takes