From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Heerdegen Newsgroups: gmane.emacs.bugs Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros Date: Sat, 06 Aug 2022 03:45:05 +0200 Message-ID: <871qtuno0u.fsf@web.de> References: <87o7x0jgz7.fsf@posteo.net> <83les42lfd.fsf@gnu.org> <87a68jjbdn.fsf@posteo.net> <871qtuc30u.fsf@gnus.org> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="19630"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: 56974@debbugs.gnu.org, Philip Kaludercic , Eli Zaretskii To: Lars Ingebrigtsen Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Sat Aug 06 03:46:49 2022 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1oK8tt-0004t0-Ae for geb-bug-gnu-emacs@m.gmane-mx.org; Sat, 06 Aug 2022 03:46:49 +0200 Original-Received: from localhost ([::1]:38444 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oK8tr-0001ME-Po for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 05 Aug 2022 21:46:47 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:49752) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oK8tF-0001CT-2z for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 21:46:09 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:42815) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oK8t8-0008V0-BS for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 21:46:07 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oK8t8-0002jM-77 for bug-gnu-emacs@gnu.org; Fri, 05 Aug 2022 21:46:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Michael Heerdegen Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Aug 2022 01:46:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 56974 X-GNU-PR-Package: emacs Original-Received: via spool by 56974-submit@debbugs.gnu.org id=B56974.165975031610434 (code B ref 56974); Sat, 06 Aug 2022 01:46:02 +0000 Original-Received: (at 56974) by debbugs.gnu.org; 6 Aug 2022 01:45:16 +0000 Original-Received: from localhost ([127.0.0.1]:60796 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oK8sO-0002iE-8u for submit@debbugs.gnu.org; Fri, 05 Aug 2022 21:45:16 -0400 Original-Received: from mout.web.de ([212.227.17.12]:34405) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oK8sL-0002hw-GI for 56974@debbugs.gnu.org; Fri, 05 Aug 2022 21:45:14 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=dbaedf251592; t=1659750306; bh=Xe7wvDrvgm3Gr6UZyMQdROTiv/KAJh0C8yJzAGlXEPs=; h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date; b=EYh3op8R4dXFGT46WAtT7mmaOz2ubE9pWAkwMVu0Q1W+r+7KCLWhb0749UbaRZ26M 2qSZAsk7Z9U+3jKKyCb1NW0JXQvD9CdUuEbxsFtFk230vkNQsDj7HHBwEOYJp3p73G e3KQmQxAbtKwiM9CatQnsswpt7ZSzoWibN4Os024= X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9 Original-Received: from drachen.dragon ([84.57.248.18]) by smtp.web.de (mrweb105 [213.165.67.124]) with ESMTPSA (Nemesis) id 1MS17h-1nrn330xxr-00T9pM; Sat, 06 Aug 2022 03:45:06 +0200 In-Reply-To: <871qtuc30u.fsf@gnus.org> (Lars Ingebrigtsen's message of "Fri, 05 Aug 2022 14:01:53 +0200") X-Provags-ID: V03:K1:+BCcy75iSnjKcx4q1zuXUUD70xGr0YrXTyj82lsktrTJ3h9jX1Q 6JtZtcbLYjkPnuf/NCfIs8Ky72SMmxkj2cslqRHbxLFWAqOZHGBo2AdPQyrARBGU9aAgJm7 Q2oPRERW3Ad28+lML3n3UWZACOfQL7Z6v4Av99B8c8Jkz5ZFQ2JvQOJO2Xr4cydrWqZsY71 +dNtrd8tEmZkzTjiMSlNg== X-UI-Out-Filterresults: notjunk:1;V03:K0:VVl1/7+M99Y=:oUl9XorWg32fh59LrvgD6B ePJaR0aU9/+oYSbWaUPMwJJPfMhFfTkkOJ2plE5vsKIf30T5glWkweq76LAK3WbOroyZOL+M1 t7WhZIlxYNPg896chi2DuJJ7vEzXs16KevcYbumMJswdqtjOlPF1zO6X/YUHAhPQIEw6PIbVV rNRFKx47WXNlcbeduw7WJxN1Np+h8DurrgxwI7URjQyiakWZVxmzOiGC8sAnZAXvkXd46p966 /xiy4VLJSshzxamBbRTOO3PH+HdxF4IMzJLAP2zB658QwatK7ThnjueSnxqjbs0u9TjNZ5Y8C jT4tsG0Y0mgFes4QYA9OpSOsnO5IpCjQEKirHR8Pz3uaQOsp/RD1bF+OqzexpO309H4wtPHsj 7lOEHTWvF8KJjEDdr+izDaumneki4UWGIDhGMvvQAf15BPQX0W+m/KnA6L90VEFFp+Djv/MIS zJDJUxmcJmneJh3krKf/j6FqYf3U0tL99fNRy2OUyOm8y8L28oIureh/4/8Irhx3P/iqY0nIu wz/4RI2ASbnvwcXtGroWnX+creHYSTCy5LOkUSkju9uHtRYYR5xXXDV9JkJ+YM52dHFhH+5M1 EiS7yCAyCrWDXZGaVg15xVrm5jyRYHW6PxYDL2ScbolbjwaXeZIG7RY12PciU/E9usIexpbZU W57NwU2l47xgASYAU9ENI+zVXuimaZnzsrYJTHYgF/wXrojRbz3YLKnpYXdXn6KKqAj/NDK10 SlNgwg8frE7SutTy+FsdFq52qs7NX9eSy1USd4oXGNNmFHimm3F7238tjsy4Ho95SAFZ7tNY X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:238953 Archived-At: Lars Ingebrigtsen 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@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.