[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
bug#56974: 29.0.50; Missing documentation for former subr-x macros
From: |
Philip Kaludercic |
Subject: |
bug#56974: 29.0.50; Missing documentation for former subr-x macros |
Date: |
Tue, 09 Aug 2022 09:10:22 +0000 |
Michael Heerdegen <michael_heerdegen@web.de> writes:
> Lars Ingebrigtsen <larsi@gnus.org> writes:
>
>> when-let is a 3:1 winner over when-let* in the Emacs tree, so I think
>> the public has spokeneth, and we should document when-let and not
>> when-let*. (And just pretend that when-let doesn't have the compat
>> forms in the manual.)
>
> Could be that most uses date from before the new names had been added.
> AFAIR using the * names was an agreement in some thread in the past -
> when this had been discussed the last time.
I could imagine this being the case, and from grepping through lisp/. I
also get the impression that people decide to use when-let vs. when-let*
the same way they would when choosing between let and let*, even though
both function more like let* than let. Making one "more official" by
documenting the less confusingly named alternatives seems like an
argument for the *'ed ones to me.
> Personally I don't care that much, both names are equally good (or bad).
> I would make them synonymous. Although when-let and and-let are already
> synonymous names...
What and-let are you referring to? All I can find is and-let*. Unless
I am missing something, I'd also argue that for the sake of consistency
documenting if-let* and when-let* would be preferable.
> Michael.
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Philip Kaludercic, 2022/08/04
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Eli Zaretskii, 2022/08/04
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Philip Kaludercic, 2022/08/05
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Lars Ingebrigtsen, 2022/08/05
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Michael Heerdegen, 2022/08/05
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Lars Ingebrigtsen, 2022/08/06
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Michael Heerdegen, 2022/08/06
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Lars Ingebrigtsen, 2022/08/07
- bug#56974: 29.0.50; Missing documentation for former subr-x macros,
Philip Kaludercic <=
- bug#56974: 29.0.50; Missing documentation for former subr-x macros, Po Lu, 2022/08/05