GNU bug report logs - #56974
29.0.50; Missing documentation for former subr-x macros

Previous Next

Full log

Message #20 received at 56974 <at> debbugs.gnu.org (full text, mbox):

From: Michael Heerdegen <michael_heerdegen <at> web.de>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 56974 <at> debbugs.gnu.org, Philip Kaludercic <philipk <at> posteo.net>,
 Eli Zaretskii <eliz <at> gnu.org>
Subject: Re: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Date: Sat, 06 Aug 2022 03:45:05 +0200

Lars Ingebrigtsen <larsi <at> gnus.org> writes:

> > +For the sake of backwards compatibility, it is possible to write a
> > +single binding without a binding list:
>
> I'm not sure we need to document this bit.

I don't think we should.

> > +@defmac if-let* (bindings <at> dots) then &rest else
> > +@code{if-let*} is mostly equivalent to @code{if-let}, with the
> > +exception that the legacy @code{(if (@var{var} (test)) foo bar)}
> > +syntax is not permitted.
> > +@end defmac
>
> So I think it's sufficient to document only the *-less variant.

Ehm - isn't the *-less form the old one we intended to obsolete (because
of it's backwards-compatibility hack), and the *-variant the one we
actually want to advertise?

Michael.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.