From ca1bc14e955e5257348410e855d4590eb1176219 Mon Sep 17 00:00:00 2001 From: Eshel Yaron Date: Mon, 12 Aug 2024 12:40:56 +0200 Subject: [PATCH] ; * lisp/emacs-lisp/scope.el (scope): Update docstring. --- lisp/emacs-lisp/scope.el | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) 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 -- 2.39.2