* bug#57263: 29.0.50; Obsolete documentation of `cl-symbol-macrolet' @ 2022-08-17 10:26 Wing Hei Chan 2022-08-18 7:56 ` Eli Zaretskii 0 siblings, 1 reply; 5+ messages in thread From: Wing Hei Chan @ 2022-08-17 10:26 UTC (permalink / raw) To: 57263 The documentation of `cl-symbol-macrolet' fails to reflect the changes in "Fix bug#26073", that is, `let'-bindings shadow symbol macro bindings. ^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#57263: 29.0.50; Obsolete documentation of `cl-symbol-macrolet' 2022-08-17 10:26 bug#57263: 29.0.50; Obsolete documentation of `cl-symbol-macrolet' Wing Hei Chan @ 2022-08-18 7:56 ` Eli Zaretskii 2022-08-18 14:08 ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors 0 siblings, 1 reply; 5+ messages in thread From: Eli Zaretskii @ 2022-08-18 7:56 UTC (permalink / raw) To: Wing Hei Chan, Stefan Monnier; +Cc: 57263 > Date: Wed, 17 Aug 2022 18:26:44 +0800 > From: Wing Hei Chan <whmunkchan@outlook.com> > > The documentation of `cl-symbol-macrolet' fails to reflect the changes > in "Fix bug#26073", that is, `let'-bindings shadow symbol macro > bindings. Stefan, could you please fix the documentation, or suggest how it should be fixed? Thanks. ^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#57263: 29.0.50; Obsolete documentation of `cl-symbol-macrolet' 2022-08-18 7:56 ` Eli Zaretskii @ 2022-08-18 14:08 ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors 2022-08-18 16:04 ` Eli Zaretskii 0 siblings, 1 reply; 5+ messages in thread From: Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2022-08-18 14:08 UTC (permalink / raw) To: Eli Zaretskii; +Cc: 57263, Wing Hei Chan > Stefan, could you please fix the documentation, or suggest how it > should be fixed? Does the patch below seem readable to you? Stefan diff --git a/doc/misc/cl.texi b/doc/misc/cl.texi index 07c19e37ce4..a7548bb1f8a 100644 --- a/doc/misc/cl.texi +++ b/doc/misc/cl.texi @@ -1381,19 +1381,10 @@ Macro Bindings A @code{setq} of a symbol macro is treated the same as a @code{setf}. I.e., @code{(setq foo 4)} in the above would be equivalent to -@code{(setf foo 4)}, which in turn expands to @code{(setf (car bar) 4)}. - -Likewise, a @code{let} or @code{let*} binding a symbol macro is -treated like a @code{cl-letf} or @code{cl-letf*}. This differs from true -Common Lisp, where the rules of lexical scoping cause a @code{let} -binding to shadow a @code{symbol-macrolet} binding. In this package, -such shadowing does not occur, even when @code{lexical-binding} is -@c See https://debbugs.gnu.org/12119 -@code{t}. (This behavior predates the addition of lexical binding to -Emacs Lisp, and may change in future to respect @code{lexical-binding}.) -At present in this package, only @code{lexical-let} and -@code{lexical-let*} will shadow a symbol macro. @xref{Obsolete -Lexical Binding}. +@code{(setf foo 4)}, which in turn expands to @code{(setf (car bar) +4)}. A @code{let} (or @code{let*}, @code{lambda}, ...) binding of +the same symbol will locally shadow the symbol macro as is the case in +Common Lisp. There is no analogue of @code{defmacro} for symbol macros; all symbol macros are local. A typical use of @code{cl-symbol-macrolet} is in the ^ permalink raw reply related [flat|nested] 5+ messages in thread
* bug#57263: 29.0.50; Obsolete documentation of `cl-symbol-macrolet' 2022-08-18 14:08 ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2022-08-18 16:04 ` Eli Zaretskii 2022-08-18 16:29 ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors 0 siblings, 1 reply; 5+ messages in thread From: Eli Zaretskii @ 2022-08-18 16:04 UTC (permalink / raw) To: Stefan Monnier; +Cc: 57263, whmunkchan > From: Stefan Monnier <monnier@iro.umontreal.ca> > Cc: Wing Hei Chan <whmunkchan@outlook.com>, 57263@debbugs.gnu.org > Date: Thu, 18 Aug 2022 10:08:10 -0400 > > > Stefan, could you please fix the documentation, or suggest how it > > should be fixed? > > Does the patch below seem readable to you? LGTM, thanks. ^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#57263: 29.0.50; Obsolete documentation of `cl-symbol-macrolet' 2022-08-18 16:04 ` Eli Zaretskii @ 2022-08-18 16:29 ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors 0 siblings, 0 replies; 5+ messages in thread From: Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2022-08-18 16:29 UTC (permalink / raw) To: Eli Zaretskii; +Cc: 57263-done, whmunkchan >> Does the patch below seem readable to you? > LGTM, thanks. Installed, Stefan ^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2022-08-18 16:29 UTC | newest] Thread overview: 5+ messages (download: mbox.gz follow: Atom feed -- links below jump to the message on this page -- 2022-08-17 10:26 bug#57263: 29.0.50; Obsolete documentation of `cl-symbol-macrolet' Wing Hei Chan 2022-08-18 7:56 ` Eli Zaretskii 2022-08-18 14:08 ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors 2022-08-18 16:04 ` Eli Zaretskii 2022-08-18 16:29 ` Stefan Monnier via Bug reports for GNU Emacs, the Swiss army knife of text editors
Code repositories for project(s) associated with this public inbox https://git.savannah.gnu.org/cgit/emacs.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).