GNU logs - #56974, boring messages


Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Philip Kaludercic <philipk@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Thu, 04 Aug 2022 13:07:01 +0000
Resent-Message-ID: <handler.56974.B.16596184022440 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: report 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: 56974 <at> debbugs.gnu.org
X-Debbugs-Original-To: bug-gnu-emacs@HIDDEN
Received: via spool by submit <at> debbugs.gnu.org id=B.16596184022440
          (code B ref -1); Thu, 04 Aug 2022 13:07:01 +0000
Received: (at submit) by debbugs.gnu.org; 4 Aug 2022 13:06:42 +0000
Received: from localhost ([127.0.0.1]:51555 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oJaYj-0000dI-U0
	for submit <at> debbugs.gnu.org; Thu, 04 Aug 2022 09:06:42 -0400
Received: from lists.gnu.org ([209.51.188.17]:47634)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <philipk@HIDDEN>) id 1oJaYg-0000d9-Nb
 for submit <at> debbugs.gnu.org; Thu, 04 Aug 2022 09:06:41 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:46396)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <philipk@HIDDEN>)
 id 1oJaYf-00057W-07
 for bug-gnu-emacs@HIDDEN; Thu, 04 Aug 2022 09:06:38 -0400
Received: from mout02.posteo.de ([185.67.36.66]:38137)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <philipk@HIDDEN>)
 id 1oJaYb-0000YE-TJ
 for bug-gnu-emacs@HIDDEN; Thu, 04 Aug 2022 09:06:36 -0400
Received: from submission (posteo.de [185.67.36.169]) 
 by mout02.posteo.de (Postfix) with ESMTPS id 6CD5D240104
 for <bug-gnu-emacs@HIDDEN>; Thu,  4 Aug 2022 15:06:27 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017;
 t=1659618389; bh=mPieYGEPPaoMHxka+xF2T6WEWmj7cANweaDdiHz6dvs=;
 h=From:To:Subject:Autocrypt:Date:From;
 b=n/QhNPrHymzkts+SCR0eax74i+chQp+rXjj5yiqxkZcrTu0S3+hrSmWlRi1gOP20r
 h7kaFcFWWOAoZLxh3G8C9aGaUcnZxPjgd1fnF4eqZfUfEjHYfMbyVaB5VF/XW8/DJj
 zA4dOHY81tLP7PwKTcBtkSKzYoEjUnD5E2aIHwBZObBTFVnS7JGmIKTMzhZ8YCEzM3
 YkVZLqAbSyBUHD+nklykrffdrhWG+5TGAsnMGlR62zPekz0pG6oSU+AqEifq9HmX4x
 zNVyRQBRmVLvAHPQ0H/X0fcN38yMoZVgYVY+LkO3ZCUnDgJOfD792NeF1hlOUHpwfy
 +E9bV0cC9UOYA==
Received: from customer (localhost [127.0.0.1])
 by submission (posteo.de) with ESMTPSA id 4Lz8BC2RXwz6tp2
 for <bug-gnu-emacs@HIDDEN>; Thu,  4 Aug 2022 15:06:26 +0200 (CEST)
From: Philip Kaludercic <philipk@HIDDEN>
Autocrypt: addr=philipk@HIDDEN; prefer-encrypt=nopreference; keydata=
 mDMEYHHqUhYJKwYBBAHaRw8BAQdAp3GdmYJ6tm5McweY6dEvIYIiry+Oz9rU4MH6NHWK0Ee0QlBo
 aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0
 ZW8ubmV0PoiQBBMWCAA4FiEEDM2H44ZoPt9Ms0eHtVrAHPRh1FwFAmBx6lICGwMFCwkIBwIGFQoJ
 CAsCBBYCAwECHgECF4AACgkQtVrAHPRh1FyTkgEAjlbGPxFchvMbxzAES3r8QLuZgCxeAXunM9gh
 io0ePtUBALVhh9G6wIoZhl0gUCbQpoN/UJHI08Gm1qDob5zDxnIHuDgEYHHqUhIKKwYBBAGXVQEF
 AQEHQNcRB+MUimTMqoxxMMUERpOR+Q4b1KgncDZkhrO2ql1tAwEIB4h4BBgWCAAgFiEEDM2H44Zo
 Pt9Ms0eHtVrAHPRh1FwFAmBx6lICGwwACgkQtVrAHPRh1Fw1JwD/Qo7kvtib8jy7puyWrSv0MeTS
 g8qIxgoRWJE/KKdkCLEA/jb9b9/g8nnX+UcwHf/4VfKsjExlnND3FrBviXUW6NcB
Date: Thu, 04 Aug 2022 13:06:20 +0000
Message-ID: <87o7x0jgz7.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: text/plain
Received-SPF: pass client-ip=185.67.36.66; envelope-from=philipk@HIDDEN;
 helo=mout02.posteo.de
X-Spam_score_int: -43
X-Spam_score: -4.4
X-Spam_bar: ----
X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
 RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -1.3 (-)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.3 (--)


As far as I see, if-let, when-let, thread-first, ... were moved from
subr-x.el to subr.el last April (b05a103e).  But there appears to be no
documentation in (I'd assume) lispref/controls.texi.  My understanding
was that these macros were not documented in the Elisp manual as they
were just part of subr-x, as the comment in the subr-x header indicates

    ;; Do not document these functions in the lispref.
    ;; https://lists.gnu.org/r/emacs-devel/2014-01/msg01006.html

So should they be documented now?


In GNU Emacs 29.0.50 (build 1, x86_64-pc-linux-gnu, GTK+ Version 3.24.34, cairo version 1.17.6)
 of 2022-08-01 built on rhea
Repository revision: 47f1cae83c269ea43d6b208e055ce536c017856f
Repository branch: feature/package+vc
System Description: Fedora Linux 36 (Workstation Edition)

Configured using:
 'configure --with-pgtk --with-native-compilation --with-imagemagick'

Configured features:
CAIRO DBUS FREETYPE GIF GLIB GMP GNUTLS GSETTINGS HARFBUZZ IMAGEMAGICK
JPEG JSON LIBSELINUX LIBSYSTEMD LIBXML2 MODULES NATIVE_COMP NOTIFY
INOTIFY PDUMPER PGTK PNG RSVG SECCOMP SOUND SQLITE3 THREADS TIFF
TOOLKIT_SCROLL_BARS XIM GTK3 ZLIB

Important settings:
  value of $LANG: en_US.UTF-8
  value of $XMODIFIERS: @im=ibus
  locale-coding-system: utf-8-unix

Major mode: Texinfo/P

Minor modes in effect:
  gtags-mode: t
  global-git-commit-mode: t
  magit-auto-revert-mode: t
  auto-revert-mode: t
  bug-reference-prog-mode: t
  TeX-PDF-mode: t
  shell-dirtrack-mode: t
  flyspell-mode: t
  repeat-mode: t
  diff-hl-flydiff-mode: t
  winner-mode: t
  windmove-mode: t
  corfu-history-mode: t
  vertico-multiform-mode: t
  vertico-mode: t
  electric-pair-mode: t
  recentf-mode: t
  save-place-mode: t
  savehist-mode: t
  xterm-mouse-mode: t
  pixel-scroll-precision-mode: t
  pixel-scroll-mode: t
  display-time-mode: t
  display-battery-mode: t
  tooltip-mode: t
  global-eldoc-mode: t
  show-paren-mode: t
  electric-indent-mode: t
  mouse-wheel-mode: t
  tab-bar-mode: t
  file-name-shadow-mode: t
  context-menu-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  line-number-mode: t
  auto-fill-function: do-auto-fill
  transient-mark-mode: t
  auto-composition-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  auto-save-visited-mode: t

Load-path shadows:
/home/philip/.config/emacs/elpa/transient-0.3.7/transient hides /home/philip/Source/emacs/lisp/transient
~/.config/emacs/site-lisp/autoload hides /home/philip/Source/emacs/lisp/emacs-lisp/autoload
/home/philip/Source/emacs/lisp/ps-def hides /home/philip/Source/emacs/lisp/obsolete/ps-def

Features:
(shadow skeleton two-column grep tramp-archive tramp-gvfs tramp-cache
zeroconf tramp tramp-loaddefs trampver tramp-integration tramp-compat
ls-lisp dcl-mode tempo consult-imenu markdown-mode etags fileloop
generator gtags-mode tar-mode arc-mode archive-mode macrostep
alect-black-alt-theme alect-light-theme alect-light-alt-theme
alect-dark-theme alect-dark-alt-theme cus-theme ert alect-themes
alect-themes-autoloads files-x gtags-mode-autoloads html2text package-x
flymake-cc edebug reposition shortdoc delsel pulse cus-edit ctrlf
hl-line ctrlf-autoloads package-vc xref ffap vertico-buffer
consult-vertico consult-icomplete consult compat-28 magit-bookmark
bookmark pp vc-hg vc-bzr vc-src vc-sccs vc-svn vc-cvs vc-rcs goto-addr
mailalias smtpmail autocrypt-message ecomplete view emacsbug
magit-extras face-remap magit-submodule magit-obsolete magit-blame
magit-stash magit-reflog magit-bisect magit-push magit-pull magit-fetch
magit-clone magit-remote magit-commit magit-sequence magit-notes
magit-worktree magit-tag magit-merge magit-branch magit-reset
magit-files magit-refs magit-status magit magit-repos magit-apply
magit-wip magit-log which-func magit-diff git-commit magit-core
magit-autorevert autorevert filenotify magit-margin magit-transient
magit-process with-editor server magit-mode transient edmacro kmacro
magit-git magit-section magit-utils dash log-edit avy whitespace
bug-reference cl-print debug backtrace find-func cus-start mhtml-mode
css-mode smie eww xdg url-queue mm-url color js sgml-mode facemenu
tex-info tex crm texmathp texinfo texinfo-loaddefs tabify imenu man
smerge-mode add-log vc-annotate nroff-mode cc-awk cc-mode cc-fonts
cc-guess cc-menus cc-cmds cc-styles cc-align cc-engine cc-vars cc-defs
python shell pcomplete shell-command+ ietf-drums-date sort smiley
gnus-cite mail-extr qp textsec uni-scripts idna-mapping ucs-normalize
uni-confusable textsec-check gnus-async gnus-bcklg gnus-ml disp-table
char-fold misearch multi-isearch dired-aux gnus-dired mm-archive
mule-util url-cache url-http url-auth url-gw display-line-numbers
finder-inf vertico-directory orderless vertico-flat vc-git buffer-env
compat vc-backup log-view pcvs-util copyright time-stamp
modus-vivendi-theme autocrypt-gnus autocrypt nndraft nnmh utf-7 nnfolder
epa-file network-stream nsm gnus-agent gnus-srvr gnus-score score-mode
nnvirtual gnus-msg gnus-art mm-uu mml2015 mm-view mml-smime smime gnutls
dig nntp gnus-cache gnus-sum shr pixel-fill kinsoku url-file url-dired
svg dom gnus-group gnus-undo gnus-start gnus-dbus gnus-cloud nnimap
nnmail mail-source utf7 netrc nnoo parse-time iso8601 gnus-spec gnus-int
gnus-range message yank-media puny rfc822 mml mml-sec epa derived epg
rfc6068 epg-config mm-decode mm-bodies mm-encode mail-parse rfc2231
mailabbrev gmm-utils mailheader gnus-win noutline outline checkdoc
flymake-proc flymake project thingatpt flyspell ispell comp comp-cstr
warnings icons cl-extra auth-source-pass repeat dired-x dired
dired-loaddefs rx sendmail rfc2047 rfc2045 ietf-drums gnus nnheader
gnus-util time-date mail-utils range mm-util mail-prsvr diff-hl-flydiff
diff diff-hl vc-dir ewoc vc vc-dispatcher diff-mode easy-mmode
hippie-exp winner windmove corfu-history corfu vertico-multiform vertico
elec-pair recentf tree-widget wid-edit saveplace savehist xt-mouse
modus-operandi-theme modus-themes pcase format-spec pixel-scroll
cua-base icomplete time battery dbus xml cus-load setup site-lisp
compile text-property-search comint ansi-color autoload loaddefs-gen
lisp-mnt magit-autoloads vertico-autoloads buffer-env-autoloads
geiser-chibi-autoloads consult-autoloads compat-autoloads crdt-autoloads
corfu-autoloads slime-autoloads geiser-impl help-fns radix-tree
help-mode geiser-custom geiser-base ring transient-autoloads info
tex-site package browse-url url url-proxy url-privacy url-expand
url-methods url-history url-cookie generate-lisp-file url-domsuf
url-util mailcap url-handlers url-parse auth-source cl-seq eieio
eieio-core cl-macs password-cache json subr-x map byte-opt gv bytecomp
byte-compile cconv url-vars cl-loaddefs cl-lib rmc iso-transl tooltip
eldoc paren electric uniquify ediff-hook vc-hooks lisp-float-type
elisp-mode mwheel term/pgtk-win pgtk-win term/common-win pgtk-dnd
tool-bar dnd fontset image regexp-opt fringe tabulated-list replace
newcomment text-mode lisp-mode prog-mode register page tab-bar menu-bar
rfn-eshadow isearch easymenu timer select scroll-bar mouse jit-lock
font-lock syntax font-core term/tty-colors frame minibuffer nadvice seq
simple cl-generic indonesian philippine cham georgian utf-8-lang
misc-lang vietnamese tibetan thai tai-viet lao korean japanese eucjp-ms
cp51932 hebrew greek romanian slovak czech european ethiopic indian
cyrillic chinese composite emoji-zwj charscript charprop case-table
epa-hook jka-cmpr-hook help abbrev obarray oclosure cl-preloaded button
loaddefs faces cus-face macroexp files window text-properties overlay
sha1 md5 base64 format env code-pages mule custom widget keymap
hashtable-print-readable backquote threads dbusbind inotify
dynamic-setting system-font-setting font-render-setting cairo gtk pgtk
multi-tty make-network-process native-compile emacs)

Memory information:
((conses 16 1282480 178918)
 (symbols 48 56238 14)
 (strings 32 254489 16947)
 (string-bytes 1 7300121)
 (vectors 16 122508)
 (vector-slots 8 3196813 139019)
 (floats 8 871 930)
 (intervals 56 72624 5479)
 (buffers 992 150))




Message sent:


Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: Philip Kaludercic <philipk@HIDDEN>
Subject: bug#56974: Acknowledgement (29.0.50; Missing documentation for
 former subr-x macros)
Message-ID: <handler.56974.B.16596184022440.ack <at> debbugs.gnu.org>
References: <87o7x0jgz7.fsf@HIDDEN>
X-Gnu-PR-Message: ack 56974
X-Gnu-PR-Package: emacs
Reply-To: 56974 <at> debbugs.gnu.org
Date: Thu, 04 Aug 2022 13:07:01 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-gnu-emacs@HIDDEN

If you wish to submit further information on this problem, please
send it to 56974 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
56974: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D56974
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems


Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Eli Zaretskii <eliz@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Thu, 04 Aug 2022 13:23:01 +0000
Resent-Message-ID: <handler.56974.B56974.165961934412422 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Philip Kaludercic <philipk@HIDDEN>
Cc: 56974 <at> debbugs.gnu.org
Received: via spool by 56974-submit <at> debbugs.gnu.org id=B56974.165961934412422
          (code B ref 56974); Thu, 04 Aug 2022 13:23:01 +0000
Received: (at 56974) by debbugs.gnu.org; 4 Aug 2022 13:22:24 +0000
Received: from localhost ([127.0.0.1]:51613 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oJanw-0003EI-DJ
	for submit <at> debbugs.gnu.org; Thu, 04 Aug 2022 09:22:24 -0400
Received: from eggs.gnu.org ([209.51.188.92]:37494)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <eliz@HIDDEN>) id 1oJanu-0003E5-IC
 for 56974 <at> debbugs.gnu.org; Thu, 04 Aug 2022 09:22:23 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e]:40552)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1oJanp-0003Xx-B3; Thu, 04 Aug 2022 09:22:17 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date:
 mime-version; bh=nQCxDsqSpl/vc7XliINz7qD/9gDTBtHvO7vmQyK5BPE=; b=UNrmnKYOZa97
 k3bgC0K3zW0WIv3DZVD6nB8HtWN8md5rY9jIOroU4FqacHsgwmOfpk0DeJ12agbn99DojsYC1edWV
 QjK6PkCqId4sPK87nkwd4zOg5QNeg16HyzF2arXxJTATCAOqIgy39+Fv3RQQU0uOesAA/AFd5Yb7E
 LuFrvV1Ct4m/bs0IQhoP1KiIKO/YhO+i72O3tFCMmO98V0RpgB/UufL4LwCOx4SlUrup1EIn7OUkg
 yqGOFkkYFNAbD2DvETEydu6i1eYkG9jJtLdtGqa5D/A5oqXqF8Idnr+P1pIE7z1/Hp6cH9sJhassU
 K1MizyifJXOyjyUiuLhPMA==;
Received: from [87.69.77.57] (port=1769 helo=home-c4e4a596f7)
 by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1oJano-00051Q-Q6; Thu, 04 Aug 2022 09:22:17 -0400
Date: Thu, 04 Aug 2022 16:22:14 +0300
Message-Id: <83les42lfd.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
In-Reply-To: <87o7x0jgz7.fsf@HIDDEN> (message from Philip Kaludercic on
 Thu, 04 Aug 2022 13:06:20 +0000)
References: <87o7x0jgz7.fsf@HIDDEN>
X-Spam-Score: -2.3 (--)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Philip Kaludercic <philipk@HIDDEN>
> Date: Thu, 04 Aug 2022 13:06:20 +0000
> 
> 
> As far as I see, if-let, when-let, thread-first, ... were moved from
> subr-x.el to subr.el last April (b05a103e).  But there appears to be no
> documentation in (I'd assume) lispref/controls.texi.  My understanding
> was that these macros were not documented in the Elisp manual as they
> were just part of subr-x, as the comment in the subr-x header indicates
> 
>     ;; Do not document these functions in the lispref.
>     ;; https://lists.gnu.org/r/emacs-devel/2014-01/msg01006.html
> 
> So should they be documented now?

Yes, they should be.




Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Philip Kaludercic <philipk@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Fri, 05 Aug 2022 09:20:02 +0000
Resent-Message-ID: <handler.56974.B56974.165969119128254 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Eli Zaretskii <eliz@HIDDEN>
Cc: 56974 <at> debbugs.gnu.org
Received: via spool by 56974-submit <at> debbugs.gnu.org id=B56974.165969119128254
          (code B ref 56974); Fri, 05 Aug 2022 09:20:02 +0000
Received: (at 56974) by debbugs.gnu.org; 5 Aug 2022 09:19:51 +0000
Received: from localhost ([127.0.0.1]:56176 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oJtUl-0007Le-2x
	for submit <at> debbugs.gnu.org; Fri, 05 Aug 2022 05:19:51 -0400
Received: from mout01.posteo.de ([185.67.36.65]:55005)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <philipk@HIDDEN>) id 1oJtUf-0007LI-Uc
 for 56974 <at> debbugs.gnu.org; Fri, 05 Aug 2022 05:19:49 -0400
Received: from submission (posteo.de [185.67.36.169]) 
 by mout01.posteo.de (Postfix) with ESMTPS id E54CA240027
 for <56974 <at> debbugs.gnu.org>; Fri,  5 Aug 2022 11:19:37 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017;
 t=1659691179; bh=A5WMFFIy4yGgAv5TCgXSg/x4Zi6+2Zc7mIFMKO/Pe7Q=;
 h=From:To:Cc:Subject:Autocrypt:Date:From;
 b=RgorE3BLQAMsnyA556qyVHDPdBW5g5GzFkGKjsRvI3oRCi6Nc1KNhqHng85mC1m+o
 yG76Qac7bhiFOTKFQsAaP1CBzrttCCjaQIuv8/7AH67LLaBW+MMc6kCQJsPqw71xEu
 ivH+IKt/OgHEIIrADvZFb86L4oMn/RF4ApOOQaVZtth8bcjb6ievAppXCrFx6tCPzD
 i9iumJfd3J3L3kJi+Wrc78p3uujcc322FUHHF2APXqJhSx3f+X0aoIsnMXPfNYzgXA
 F/R3Cnw/YYIseoVeBMvJ/adAKjL8y7LtWTubWDI9A0iIPs7ANPkJSyrygTGEMDQO4L
 MkDnXGjDFShCA==
Received: from customer (localhost [127.0.0.1])
 by submission (posteo.de) with ESMTPSA id 4Lzg605bLBz6tmR;
 Fri,  5 Aug 2022 11:19:34 +0200 (CEST)
From: Philip Kaludercic <philipk@HIDDEN>
In-Reply-To: <83les42lfd.fsf@HIDDEN> (Eli Zaretskii's message of "Thu, 04 Aug
 2022 16:22:14 +0300")
References: <87o7x0jgz7.fsf@HIDDEN> <83les42lfd.fsf@HIDDEN>
Autocrypt: addr=philipk@HIDDEN; prefer-encrypt=nopreference; keydata=
 mDMEYHHqUhYJKwYBBAHaRw8BAQdAp3GdmYJ6tm5McweY6dEvIYIiry+Oz9rU4MH6NHWK0Ee0QlBo
 aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0
 ZW8ubmV0PoiQBBMWCAA4FiEEDM2H44ZoPt9Ms0eHtVrAHPRh1FwFAmBx6lICGwMFCwkIBwIGFQoJ
 CAsCBBYCAwECHgECF4AACgkQtVrAHPRh1FyTkgEAjlbGPxFchvMbxzAES3r8QLuZgCxeAXunM9gh
 io0ePtUBALVhh9G6wIoZhl0gUCbQpoN/UJHI08Gm1qDob5zDxnIHuDgEYHHqUhIKKwYBBAGXVQEF
 AQEHQNcRB+MUimTMqoxxMMUERpOR+Q4b1KgncDZkhrO2ql1tAwEIB4h4BBgWCAAgFiEEDM2H44Zo
 Pt9Ms0eHtVrAHPRh1FwFAmBx6lICGwwACgkQtVrAHPRh1Fw1JwD/Qo7kvtib8jy7puyWrSv0MeTS
 g8qIxgoRWJE/KKdkCLEA/jb9b9/g8nnX+UcwHf/4VfKsjExlnND3FrBviXUW6NcB
Date: Fri, 05 Aug 2022 09:19:32 +0000
Message-ID: <87a68jjbdn.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="=-=-="
X-Spam-Score: -2.3 (--)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

--=-=-=
Content-Type: text/plain

Eli Zaretskii <eliz@HIDDEN> writes:

>> From: Philip Kaludercic <philipk@HIDDEN>
>> Date: Thu, 04 Aug 2022 13:06:20 +0000
>> 
>> 
>> As far as I see, if-let, when-let, thread-first, ... were moved from
>> subr-x.el to subr.el last April (b05a103e).  But there appears to be no
>> documentation in (I'd assume) lispref/controls.texi.  My understanding
>> was that these macros were not documented in the Elisp manual as they
>> were just part of subr-x, as the comment in the subr-x header indicates
>> 
>>     ;; Do not document these functions in the lispref.
>>     ;; https://lists.gnu.org/r/emacs-devel/2014-01/msg01006.html
>> 
>> So should they be documented now?
>
> Yes, they should be.

How is this for a start:


--=-=-=
Content-Type: text/x-patch
Content-Disposition: inline;
 filename=0001-Document-if-let-if-let-when-let-and-and-let.patch

From 0d4c3f418d5dcdaa2f2f9c93b7e1fd103a310c62 Mon Sep 17 00:00:00 2001
From: Philip Kaludercic <philipk@HIDDEN>
Date: Fri, 5 Aug 2022 11:18:29 +0200
Subject: [PATCH] Document if-let*, if-let, when-let* and and-let*

* control.texi (Conditionals): Add if-let*, if-let, when-let*
(Combining Conditions): Add and-let*
---
 doc/lispref/control.texi | 47 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/doc/lispref/control.texi b/doc/lispref/control.texi
index d4520ebdee..e7fd1bb41a 100644
--- a/doc/lispref/control.texi
+++ b/doc/lispref/control.texi
@@ -294,6 +294,46 @@ Conditionals
 @end group
 @end example
 
+During complex computations that might at any step, one can combine a
+@code{let}-block and some of the previous conditional control
+structures:
+
+@defmac if-let (bindings@dots) then &rest else@dots
+As with @code{let*}, @var{bindings} will consist of
+@code{(@var{symbol} @var{value-form})} entries that are evaluated and
+bound sequentially.  If all @var{value-form} evaluate to
+non-@code{nil} values, then @var{then} is evaluated as were the case
+with a regular @code{let*} expression, with all the variables bound.
+If any @var{value-form} evaluates to @code{nil}, @var{else} is
+evaluated, without any bound variables.
+
+A binding may also optionally drop the @var{symbol}, and simplify to
+@code{(@var{value-form})} if only the test is of interest.
+
+For the sake of backwards compatibility, it is possible to write a
+single binding without a binding list:
+
+@example
+@group
+(if-let* (@var{symbol} (test)) foo bar)
+@equiv{}
+(if-let* ((@var{symbol} (test))) foo bar)
+@end group
+@end example
+@end defmac
+
+@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
+
+@defmac when-let (bindings@dots) &rest body
+As with @code{when}, if one is only interested in the case where all
+@var{bindings} are non-nil.  Otherwise @var{bindings} are interpreted
+just as they are by @code{if-let*}.
+@end defmac
+
 @node Combining Conditions
 @section Constructs for Combining Conditions
 @cindex combining conditions
@@ -428,6 +468,13 @@ Combining Conditions
 Note that in contrast to @code{or}, both arguments are always evaluated.
 @end defun
 
+@defmac and-let* (bindings@dots) &rest body
+A combination of @var{let*} and @var{and}, analogous to
+@code{when-let*}.  If all @var{bindings} are non-@code{nil} and
+@var{body} is @code{nil}, then the result of the @code{and-let*} form
+will be the last value bound in @var{bindings}.
+@end defmac
+
 @node Pattern-Matching Conditional
 @section Pattern-Matching Conditional
 @cindex pcase
-- 
2.37.1


--=-=-=--




Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Lars Ingebrigtsen <larsi@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Fri, 05 Aug 2022 12:03:02 +0000
Resent-Message-ID: <handler.56974.B56974.165970092921505 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Philip Kaludercic <philipk@HIDDEN>
Cc: 56974 <at> debbugs.gnu.org, Eli Zaretskii <eliz@HIDDEN>
Received: via spool by 56974-submit <at> debbugs.gnu.org id=B56974.165970092921505
          (code B ref 56974); Fri, 05 Aug 2022 12:03:02 +0000
Received: (at 56974) by debbugs.gnu.org; 5 Aug 2022 12:02:09 +0000
Received: from localhost ([127.0.0.1]:56459 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oJw1o-0005an-Rb
	for submit <at> debbugs.gnu.org; Fri, 05 Aug 2022 08:02:09 -0400
Received: from quimby.gnus.org ([95.216.78.240]:34998)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@HIDDEN>) id 1oJw1i-0005aF-Qw
 for 56974 <at> debbugs.gnu.org; Fri, 05 Aug 2022 08:02:06 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org;
 s=20200322; h=Content-Type:MIME-Version:Message-ID:Date:References:
 In-Reply-To:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding:
 Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender:
 Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=eXuF4K2SzSsoH0pbEz+kX6z6VwQP2+wFX7VGP/GDtm8=; b=pyQDcJ1B2FG4lYqHdJt1xE+ZCe
 mifEuxIT8NZhxxy7VgwjcyEm5MMh0OALICj55CAgp3+5coLKfTFDb7lOau3P5SjAAIr5zcFUFKIlW
 LleY4KAxI7UC7SI7Q0e+cbgqGt9GylcJS1R3CXchOnVW/mjn9nFpirA4sHoBIdZSUDks=;
Received: from [84.212.220.105] (helo=joga)
 by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.92) (envelope-from <larsi@HIDDEN>)
 id 1oJw1a-00013O-Fn; Fri, 05 Aug 2022 14:01:56 +0200
From: Lars Ingebrigtsen <larsi@HIDDEN>
In-Reply-To: <87a68jjbdn.fsf@HIDDEN> (Philip Kaludercic's message of "Fri, 
 05 Aug 2022 09:19:32 +0000")
References: <87o7x0jgz7.fsf@HIDDEN> <83les42lfd.fsf@HIDDEN>
 <87a68jjbdn.fsf@HIDDEN>
Face: iVBORw0KGgoAAAANSUhEUgAAADAAAAAwBAMAAAClLOS0AAAABGdBTUEAALGPC/xhBQAAACBj
 SFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAIVBMVEX6+vvS0dTd3eGi
 oaS+vcExMDAgHh9eXl9+foA/PT7////viaxHAAAAAWJLR0QKaND0VgAAAAd0SU1FB+YIBQsuNC2B
 +7QAAAGpSURBVDjLtZNLTuQwEIYdwwFiJwewq5HY0hRShh3pDINYgpSOWI96ejtRgkxOwAFQhHJb
 yq80dLMAaeZfZOHPfz1SZcb+vRKQXEj4BEiphTgEWmopQWixDzjdl+Izy/9VgkEXKTtJla3El7Co
 15s/pM221M/llQW+6KOhnsaa1GdFx33xzlBM02TP67YyqHYpru3ZekOfrmgMMIg9XrswpAZN3fMk
 BVBqdngw1J3KgXMF78A0micCIBTnUuxAYyZjhm2vcwuc45evCC+HcfPSCzED5zApOx5fMWtLqYDG
 Eh2tvXKTskX704E8gG1s6xQvgICO4Hcc4y0ugaRlAHfxP99U0gIIjvV9dFSoKZSCbB9knXahyhBq
 BrACmxyW+znOSw6K70Cs6rhFZoHG2EcARy+PlDrRAuM8QoMLg4I6j2Aa1389yLrEdijyCOpGkgdk
 JvWPTuocA6BV6BXj+ZVmIsGVqAIwBB7O/JadpLqs8LmbQd2cu3Wit4NojPFgsKN6MIjFMqEwxUfg
 J7+q3PkBeO0zG+gAuHAzSKjTKDcmeoryiy8Ivg2+pjee+49Hiyd05QAAACV0RVh0ZGF0ZTpjcmVh
 dGUAMjAyMi0wOC0wNVQxMTo0Njo1MiswMDowMHMVS5oAAAAldEVYdGRhdGU6bW9kaWZ5ADIwMjIt
 MDgtMDVUMTE6NDY6NTIrMDA6MDACSPMmAAAAAElFTkSuQmCC
X-Now-Playing: Keith Jarrett's _The =?UTF-8?Q?K=C3=B6ln?= Concert_: "Part I"
Date: Fri, 05 Aug 2022 14:01:53 +0200
Message-ID: <871qtuc30u.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 @@CONTACT_ADDRESS@@ for details.
 Content preview: Philip Kaludercic <philipk@HIDDEN> writes: > +During
 complex
 computations that might at any step, one can combine a Missing a word or
 two here? 
 Content analysis details:   (-2.9 points, 5.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -1.0 ALL_TRUSTED            Passed through trusted hosts only via SMTP
 -1.9 BAYES_00               BODY: Bayes spam probability is 0 to 1%
 [score: 0.0000]
X-Spam-Score: -2.3 (--)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

Philip Kaludercic <philipk@HIDDEN> writes:

> +During complex computations that might at any step, one can combine a

Missing a word or two here?

> +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.

> +@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.





Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Po Lu <luangruo@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Fri, 05 Aug 2022 13:52:01 +0000
Resent-Message-ID: <handler.56974.B56974.16597074699157 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Philip Kaludercic <philipk@HIDDEN>
Cc: 56974 <at> debbugs.gnu.org, Eli Zaretskii <eliz@HIDDEN>
Received: via spool by 56974-submit <at> debbugs.gnu.org id=B56974.16597074699157
          (code B ref 56974); Fri, 05 Aug 2022 13:52:01 +0000
Received: (at 56974) by debbugs.gnu.org; 5 Aug 2022 13:51:09 +0000
Received: from localhost ([127.0.0.1]:56763 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oJxjI-0002Nc-UG
	for submit <at> debbugs.gnu.org; Fri, 05 Aug 2022 09:51:09 -0400
Received: from sonic312-23.consmr.mail.ne1.yahoo.com ([66.163.191.204]:43801)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <luangruo@HIDDEN>) id 1oJxjG-0002N7-Jw
 for 56974 <at> debbugs.gnu.org; Fri, 05 Aug 2022 09:51:07 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048;
 t=1659707459; bh=h1Jg4IjW0phP0+riaUyEaPtZNFPZ88ctVGAv/SvPl+g=;
 h=From:To:Cc:Subject:References:Date:In-Reply-To:From:Subject:Reply-To;
 b=cGqNMxtwGjK8xfDIq9qiMSzLzTeNqIZQ8l/nR6Cq1EFT0GrNKKoTxlI1FSGG0Ip7yf2q7uQ9dhLnrZqWc7PZ3Zma27TsHsC7BUeUGhHvJiNrKKODpb1GeqPoNDimCgzckMdp/bgo8XGHkXsrvQDJTVIiv4JMCLX9Hmyz+euV3ncQS8uSJnxaHeqO/mSME/gSWvwPPyp81Hh6FmeymLqx8bjWm4GroHfReofx0aFI2dA9A1P5I8YMFLkXsstTUtEBfiz5RkiqbX0V9zL+lO1ZW8gzcKYiQmU4rOSEctZayyS8fSu9bgDBw1yianxNyL6fFMFf9acm39dWyFzqh5QHOA==
X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048;
 t=1659707459; bh=bf7sj1RtwDP8Wly1gcefb2StIiHGJowQjKBHDYqiHb3=;
 h=X-Sonic-MF:From:To:Subject:Date:From:Subject;
 b=KhFeA4O2TG1+S9EROniwRjHCAw0dHNsMeQELc1f8dWG6EqC518mh+X5BnZFDZ3Kubb5eDqRUXaRwXzGj+nx/WSm5UDPVSjE0XkLsGhVkAQT01fAqbalmXDkGklL95BTfOZ1dtfrl536omhR7CKEiBE19HsZKYfvD8rL8pIV1EhSRywo+sI68WbBpAfeO4XexgE64ldwtTt1xbEM6PGSj2wWVRu/ROFwhiJ4+yTXAh3KpbBbPvaNoZVKE4xPdSHa5LTJtSSLHdDtTYocQwFd+SvZbfJayX8u7RFgJwm9ompdOXAKwyM/xk92DVt1nSACewi83LKWdm6fjivlfnGZNTg==
X-YMail-OSG: o53dIQcVM1nus6WBElotkoi.vymw6IIo0jeOP..rm0KsGE82laviGw_y2hW0PQK
 yMNj6fwIkdHRO5xikHyovJLUjpLhu4f3tgaPPaQXVn.Iiq2FFNIgBKbfThDsXHEqQx2QDpjyRay3
 UX8N8jdFseIEtXxdqLdXsy9OYphOkPPeCMiQ1xdF0OJcz4YByEDRzWOoWys7kcxeN2Xpr5_33wL3
 ask9w868ZfPAx3glihwlV7I2SNatJErz4TWDTt18OhVK7mg83i.UjeC.qAml3hsvXnFeAwh_7V51
 3aBbRqp1zCm6.ze273W3GOW0ZG_1XDLs36n2jR8AvkgiY_Z9XSeFSvnDMWZFE7b4thYBXBh1yhUR
 6nnXSLOl_n.BuxtbjpqHvWIWaM8el5Ei5ekRSwVDL2ioOWMChcgdujPfWwFJ6gbeR9g1DkjZJPw_
 2WP4TFgEs81MGLYIsIEgCi3OAK0OcgyNsWvvn2sxTDmWv1OmqxHDEI83e1UbLgBhKfZZ6z4lC5aC
 DqwoMtGxMc0NgNRCnw77UBxyQaZfVFYWHVhLodJjXdO1dE2lP9m0uWq2UtlcMNdinSo0HHhbngMb
 TCgU88Vea8SRVE7cUJUCGdYPZYRbJyAyGEuktTV75I63LZ2GtHvpZka9f_Sa5PKcxxuh.e6uA1Uk
 ja6hNjATAqWpgm0n7nv_mIkOylDQ5SIIZOthKM7oqoDNbofbZwl73ETFCEccTItEGrNArUWnxY5J
 d8B.26Ye_PhRfcL7HvjgUxhMC_oqKsImOj.LgCZ7VrrBu08CsFIJzz8S2tr4iyspH4wgjLVTVL3N
 pOnA.8g_Jut2IWBCvRnTWzXY3IRIIkRkcE1cnUnp6cwyD9nAil3L622a9Xv4wxeO1gqBqzelFqya
 K.0eeakYiMaikG0cOhjp.lu4gsrf9_9MSt3YqxRBdxELZDg3yjR4pENcifBK0K7cnnIdlUFSnXpz
 H6IjCYDRMeDFS71HTGnyNco3FeuEgX5.KOc3gWSLxBShF3Zg_hHHNDQY_dGrzABR8Bwcwx0wR6tB
 e2PKUTCWydHBqflIXfosYTDS5BxlLMP.7lNboBESBo3GmPmqwtX9TiFOKAATHV9PmxMkyM33xCE.
 owgaeoi2zyRaGloE5lXq._LTXGk_2mDygJ_izS70G9J.Nnm2uNecVvsbSfaBe3gBjGfHjxW7SAcg
 27qbCgqWjZxJHAx3TdVIt9k7ZlquKRZeA3Ix74Zif16JHXNCbDMp5CiDAf4_NV5iADp7TZoWbJon
 AIavWWWiHgoO3.d11zUnnjQO1Kv54OrqEJefOsPvM3VwcMIngBcvXLW3MaAZ2g0ckxY2H.NM6SdB
 PuvqUEbGz9JJATVO.ZdySubPuZ_q01ls1KS5Hw9DA6uAMxrQm7l2A.4H5T_nhkMuLiBIj1bsFGO9
 bU7yDwrcAK3ZuygmGiqCFaxg2I4nbelfZowcbMpaNlSYBAzgpc5aM5EPRmZgTjZxPEG2gxQIs0vn
 uYt.EtEC7PxNT45PZ79zvTJ43NlBIZQJRVUDnRMhi1EeO6FA1zYyAL8jY17pwBvzNKj6Xcw1OiE9
 ucaLf0JTUnVGCQUtgncLY7kd2Eeebj2wfkzWBNTJQAPEDCstO0RkTVoEX_QPTyYxNO.BKw5IYLAx
 _MV9Tz6B0EOr7efRS1Bv0.t_VcG72Dg3qQ0hQIF6iPZeLNjrggjv7Ov82M63V3eCtm.uTzv04OQ9
 jwJeWiqMLAthkhyaBJlPmFvGyAEIqeiv8BiLiCqoIt.rgiEKbR0M3d.c92HAOexLE51zaZ8OFqXr
 0v40tqFDmJnX7xHygHaLu.TQzgls2xoF8xtMhVZ1Io8Tw87MrgytR6xuJMTcj5sT1jOhu.iQkBPH
 TTnMZ6uVah43LdixdS8MsSDQde3cmMR.uTHe.LhP7IPhyqVGYs1F_adr82X4JpKYJdaXLzkXXVYu
 ENVVQ1wikUHX7ukHmKg5zPqNaDT1H7hlacjQS1vFDocQ1pJ5af5oIi_mb2pWve1rKq9wxVAU_Sww
 Sisug9KwSjVGLjQj.L3odd.R2jGs7Hm5amxW3Ggq8osQHxztY917H6Ezz1zZvnPhDGte6ZbsOEuu
 jBL.nXwWx_ue_cIUqtxSkJri0ImVQC69Od.z0LNBqJ7vT7hBQkN.MHSS2uQS6HnctSP61aF.ZpPv
 IbCwRJ_vgQChsNi4zJMXySWY9yf62Vni3Nm9COnPowWRub7v1KvuA_6tJ8Jj.VtKHq_aOznFySiI
 61JI1e.EmFpt7IbszNfFC0DysHFIF9bHGKgRCNstJZusTFDCGGkKaTDzpbQOPc08w
X-Sonic-MF: <luangruo@HIDDEN>
Received: from sonic.gate.mail.ne1.yahoo.com by
 sonic312.consmr.mail.ne1.yahoo.com with HTTP; Fri, 5 Aug 2022 13:50:59 +0000
Received: by hermes--canary-production-sg3-6f58cd9b5-q5dg5 (Yahoo Inc. Hermes
 SMTP Server) with ESMTPA ID 495cfbba496594a59a79ddd850eb29c8; 
 Fri, 05 Aug 2022 13:50:53 +0000 (UTC)
From: Po Lu <luangruo@HIDDEN>
References: <87o7x0jgz7.fsf@HIDDEN> <83les42lfd.fsf@HIDDEN>
 <87a68jjbdn.fsf@HIDDEN>
Date: Fri, 05 Aug 2022 21:50:47 +0800
In-Reply-To: <87a68jjbdn.fsf@HIDDEN> (Philip Kaludercic's message of "Fri, 
 05 Aug 2022 09:19:32 +0000")
Message-ID: <87mtci6bpk.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.91 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Mailer: WebService/1.1.20491
 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo
Content-Length: 179
X-Spam-Score: 0.0 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

Philip Kaludercic <philipk@HIDDEN> writes:

> * control.texi (Conditionals): Add if-let*, if-let, when-let*

This should be:

> * doc/lispref/control.texi (Conditionals): ...




Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Michael Heerdegen <michael_heerdegen@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Sat, 06 Aug 2022 01:46:02 +0000
Resent-Message-ID: <handler.56974.B56974.165975031610434 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Lars Ingebrigtsen <larsi@HIDDEN>
Cc: 56974 <at> debbugs.gnu.org, Philip Kaludercic <philipk@HIDDEN>, Eli Zaretskii <eliz@HIDDEN>
Received: via spool by 56974-submit <at> debbugs.gnu.org id=B56974.165975031610434
          (code B ref 56974); Sat, 06 Aug 2022 01:46:02 +0000
Received: (at 56974) by debbugs.gnu.org; 6 Aug 2022 01:45:16 +0000
Received: from localhost ([127.0.0.1]:60796 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oK8sO-0002iE-8u
	for submit <at> debbugs.gnu.org; Fri, 05 Aug 2022 21:45:16 -0400
Received: from mout.web.de ([212.227.17.12]:34405)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <michael_heerdegen@HIDDEN>) id 1oK8sL-0002hw-GI
 for 56974 <at> 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
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
From: Michael Heerdegen <michael_heerdegen@HIDDEN>
In-Reply-To: <871qtuc30u.fsf@HIDDEN> (Lars Ingebrigtsen's message of "Fri,
 05 Aug 2022 14:01:53 +0200")
References: <87o7x0jgz7.fsf@HIDDEN> <83les42lfd.fsf@HIDDEN>
 <87a68jjbdn.fsf@HIDDEN> <871qtuc30u.fsf@HIDDEN>
Date: Sat, 06 Aug 2022 03:45:05 +0200
Message-ID: <871qtuno0u.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:+BCcy75iSnjKcx4q1zuXUUD70xGr0YrXTyj82lsktrTJ3h9jX1Q
 6JtZtcbLYjkPnuf/NCfIs8Ky72SMmxkj2cslqRHbxLFWAqOZHGBo2AdPQyrARBGU9aAgJm7
 Q2oPRERW3Ad28+lML3n3UWZACOfQL7Z6v4Av99B8c8Jkz5ZFQ2JvQOJO2Xr4cydrWqZsY71
 +dNtrd8tEmZkzTjiMSlNg==
X-Spam-Flag: NO
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+FsdFq52qs7NX9eSy1USd4oXGNNmFHimm3F7238tjsy4Ho95SAFZ7tNY2
 d5F5HP2EzolLecZIOxpnfCP35SEEX5w/19Hhn7dtLNAs4g/d3ddfYeYZKoxpBN8YHkg3UHnQ+
 rmuUhtBWsXwsDPfDwNMA8LWglxDCXgSMRIeKR5r+jHYLgJufYWSOa3f+faQf7QBN6957KmvxB
 fURvZuXlNFLH1CBv12kYA2v0fZcwAA+/Wlw0q/zh+sKkbIzz9QYSHi9NjCIHN0DEfbq1dViXc
 NosgLrVx2YlJ41rKBE+x/q6WQIUNGklnrx8xo5EkOFAqDjX+MsRQscBdJ/Y7wcNJkplVf5GKf
 co02gv1ZSHLEwNL3gEwy+J8ugYuMYLVNdGzYJ1Ayge8mwrf+7P0oo0Geg==
X-Spam-Score: 0.0 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

Lars Ingebrigtsen <larsi@HIDDEN> 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.




Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Lars Ingebrigtsen <larsi@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Sat, 06 Aug 2022 12:20:02 +0000
Resent-Message-ID: <handler.56974.B56974.1659788394623 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Michael Heerdegen <michael_heerdegen@HIDDEN>
Cc: 56974 <at> debbugs.gnu.org, Philip Kaludercic <philipk@HIDDEN>, Eli Zaretskii <eliz@HIDDEN>
Received: via spool by 56974-submit <at> debbugs.gnu.org id=B56974.1659788394623
          (code B ref 56974); Sat, 06 Aug 2022 12:20:02 +0000
Received: (at 56974) by debbugs.gnu.org; 6 Aug 2022 12:19:54 +0000
Received: from localhost ([127.0.0.1]:32965 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oKImY-00009z-Fi
	for submit <at> debbugs.gnu.org; Sat, 06 Aug 2022 08:19:54 -0400
Received: from quimby.gnus.org ([95.216.78.240]:46478)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@HIDDEN>) id 1oKImW-00009l-UW
 for 56974 <at> debbugs.gnu.org; Sat, 06 Aug 2022 08:19:53 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org;
 s=20200322; h=Content-Type:MIME-Version:Message-ID:Date:References:
 In-Reply-To:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding:
 Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender:
 Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=fax2F2Xk5xuWor2Xltlbb1eIIPiN/mAVYdL4Nl8+dms=; b=W4dVvoFBWEbQBnbvO6Gi7n/d5P
 8N5i9VkeADp5RvFMeFnsARMMWuR+x2GhtRQjDRnBJjZyxM6FH+0XiVpCbSL9AFzW0Bem3MO3n9pwb
 EPe2eiuIWw5vU12xtz2ftY0LzG915H+PwoFZe8vJyGOCMeCfz772yfY8hhODB55vQmfM=;
Received: from 2.151.51.97.tmi.telenormobil.no ([2.151.51.97] helo=joga)
 by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.92) (envelope-from <larsi@HIDDEN>)
 id 1oKImO-0003kR-7K; Sat, 06 Aug 2022 14:19:46 +0200
From: Lars Ingebrigtsen <larsi@HIDDEN>
In-Reply-To: <871qtuno0u.fsf@HIDDEN> (Michael Heerdegen's message of "Sat, 06
 Aug 2022 03:45:05 +0200")
References: <87o7x0jgz7.fsf@HIDDEN> <83les42lfd.fsf@HIDDEN>
 <87a68jjbdn.fsf@HIDDEN> <871qtuc30u.fsf@HIDDEN>
 <871qtuno0u.fsf@HIDDEN>
Date: Sat, 06 Aug 2022 14:19:43 +0200
Message-ID: <87tu6p5zts.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 @@CONTACT_ADDRESS@@ for details.
 Content preview:  Michael Heerdegen <michael_heerdegen@HIDDEN> writes: > 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? 
 Content analysis details:   (-2.9 points, 5.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -1.0 ALL_TRUSTED            Passed through trusted hosts only via SMTP
 0.0 TVD_RCVD_IP            Message was received from an IP address
 -1.9 BAYES_00               BODY: Bayes spam probability is 0 to 1%
 [score: 0.0000]
X-Spam-Score: -2.3 (--)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

Michael Heerdegen <michael_heerdegen@HIDDEN> writes:

> 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?

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.)





Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Michael Heerdegen <michael_heerdegen@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Sun, 07 Aug 2022 02:16:02 +0000
Resent-Message-ID: <handler.56974.B56974.165983855527645 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Lars Ingebrigtsen <larsi@HIDDEN>
Cc: 56974 <at> debbugs.gnu.org, Philip Kaludercic <philipk@HIDDEN>, Eli Zaretskii <eliz@HIDDEN>
Received: via spool by 56974-submit <at> debbugs.gnu.org id=B56974.165983855527645
          (code B ref 56974); Sun, 07 Aug 2022 02:16:02 +0000
Received: (at 56974) by debbugs.gnu.org; 7 Aug 2022 02:15:55 +0000
Received: from localhost ([127.0.0.1]:35729 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oKVpa-0007Bo-LS
	for submit <at> debbugs.gnu.org; Sat, 06 Aug 2022 22:15:55 -0400
Received: from mout.web.de ([212.227.15.14]:33939)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <michael_heerdegen@HIDDEN>) id 1oKVpZ-0007Bb-2U
 for 56974 <at> debbugs.gnu.org; Sat, 06 Aug 2022 22:15:53 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de;
 s=dbaedf251592; t=1659838546;
 bh=AS8gZGIcicTdlZ3PswrHuF54kGMIwCSLxetQTrFHAok=;
 h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date;
 b=iGgTAgbCX+t0P4/oyoefyv442Zt41WjovnJnV4vgZFkIMAaF2astJ7nlNyj70+ZsF
 IkqM/v4PtXM1aqZkSmM5JjSW7ghtsieDuwErBDWZ4j3KUM7EQdUOQ/6YdfIv7mGNDf
 aawv6QVLlncxbVpkdZpkZSC9OgvDmj/kg+fr4EKU=
X-UI-Sender-Class: c548c8c5-30a9-4db5-a2e7-cb6cb037b8f9
Received: from drachen.dragon ([84.57.248.18]) by smtp.web.de (mrweb006
 [213.165.67.108]) with ESMTPSA (Nemesis) id 1Ma0Tg-1nxTAk0C9M-00WP5z; Sun, 07
 Aug 2022 04:15:46 +0200
From: Michael Heerdegen <michael_heerdegen@HIDDEN>
In-Reply-To: <87tu6p5zts.fsf@HIDDEN> (Lars Ingebrigtsen's message of "Sat,
 06 Aug 2022 14:19:43 +0200")
References: <87o7x0jgz7.fsf@HIDDEN> <83les42lfd.fsf@HIDDEN>
 <87a68jjbdn.fsf@HIDDEN> <871qtuc30u.fsf@HIDDEN>
 <871qtuno0u.fsf@HIDDEN> <87tu6p5zts.fsf@HIDDEN>
Date: Sun, 07 Aug 2022 04:15:42 +0200
Message-ID: <87fsi8re7l.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Provags-ID: V03:K1:TvWJoSpk3RX76UJK8mJ3x4XA5+j9pleGwltG7EDNFh0pcy4kAXL
 garGykjAcmlTOPcNLibWIhjXNlDjj6LWZVNUFj8VaVXXu+GK5c3l6CcGBMD1Jz1NTIiLp+l
 Zf0WgzqlaNTRx7m190mVbiU9WgRSjHJdEC8kY4XuC7+rgZA2r7WzqZdWOroLXNrSPt0J6Zk
 HUpz6ITIP/5YOpoxzrtgA==
X-Spam-Flag: NO
X-UI-Out-Filterresults: notjunk:1;V03:K0:Mkm5eJ8ePy0=:i3H+vl+GUpa6Vfx7I4yOb/
 ogukYiCnMeXF3ynND+NMf+VN2Dc4QRRMcOzvoBVXqujGTvQzWDwWTPFqkh8gI+6QAWtOJXkfc
 vhcUsjJOBr2412fyLlfX4xqSx8oXJckLsDB/m7rjKG6T3zBtndJPpbSQ9MKqgzLqy4Nd4PBI/
 ose2mE92Y+Z/zP5Xgk3sLb6nMQbaFup+7v18q+uMghvsBeQuHBSfuHy4l+osjSy01gFbbpYfO
 2Gc7zZ3cRLe2KvpDdYfHWpgeKBMKPVoMDdhOQMIYsmjAZGzQx47COxgBSMaNtSH6ph4LB4JMe
 /Um0VKhsd+4Mzru52ALMrwxKAXz+W/pyVKn9VwTW0F+MF+qx1R8yRYptkpmciRJsRkNQdXOPF
 UTBfEp7F3ayKz31hYD4yexHpS3jmQGLfD32Hqyb36FQA593L4+Lca9SFbXX5YBKd6kqLJCgqy
 Re9ZrMyoCQsLfEQjZkK6eww6ADhCRLp2se21czL1i5etVks4xi8/XXmuMpkG9mWSMWOxtaEp8
 5mBPQv1WukFqmrbv7/B8M/dW80OTAAkvc1xBLGb1gScf1m4VU7MeOqKBd2tEEo1zpBtK/PhF6
 mYoYk0PWSnrajXEXO+t+hrnFt26Bg0d4a66PmMI+xBMqzlM9YubkTSU91Qk+8y/BJIdSSdbk0
 ctUyufpmJ05pDlQyoV4YI8JmOYzDHZFTLFOwDAiUDZcZq3zWv5HA5j1w6RcCToN8U9q5rnhvI
 FRGgxguE4lTTNideTX5T6cxGNbJeMWlP4+VTKx7rdN6B3UTTzvtHgikagQkqh3YvOSpb932nc
 R6WcQCgsglQDHPTffu5Y8ljud4SRVeQcDOi0FIJzAboFEN57DUYtZ46Twe33+seon+ael7tUi
 /oI3OSsjGPbRIQwYGRcASTWOMtVQ/HteRq30G52GYvKpDr/ElkVFMAVtnz9ZHXP76wUHe2Ul/
 QxmSXA778Dis9LYfdJ0CMhQVk7eN7d7ygQgJoaRZHfR4IDf7rxkUX/IN/Aw3+Kd9uYusON0do
 5bkpMyp3gWoImQw2RgsRaJiT0kl+qpxlBKJxFTkQ32RQWq0PICb8A7VY8sd2V4xKc6icHiLBK
 UnzFcTzTaP+X4mYK/Ll2kHSR+DlyQ7rRqOaCNTZZjuwzftuCpBStsKakw==
X-Spam-Score: -0.7 (/)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)

Lars Ingebrigtsen <larsi@HIDDEN> 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.

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...

Michael.




Message sent to bug-gnu-emacs@HIDDEN:


X-Loop: help-debbugs@HIDDEN
Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros
Resent-From: Lars Ingebrigtsen <larsi@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-gnu-emacs@HIDDEN
Resent-Date: Sun, 07 Aug 2022 12:52:02 +0000
Resent-Message-ID: <handler.56974.B56974.165987669818905 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
X-GNU-PR-Message: followup 56974
X-GNU-PR-Package: emacs
X-GNU-PR-Keywords: 
To: Michael Heerdegen <michael_heerdegen@HIDDEN>
Cc: 56974 <at> debbugs.gnu.org, Philip Kaludercic <philipk@HIDDEN>, Eli Zaretskii <eliz@HIDDEN>
Received: via spool by 56974-submit <at> debbugs.gnu.org id=B56974.165987669818905
          (code B ref 56974); Sun, 07 Aug 2022 12:52:02 +0000
Received: (at 56974) by debbugs.gnu.org; 7 Aug 2022 12:51:38 +0000
Received: from localhost ([127.0.0.1]:36157 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1oKfkn-0004ur-Pk
	for submit <at> debbugs.gnu.org; Sun, 07 Aug 2022 08:51:38 -0400
Received: from quimby.gnus.org ([95.216.78.240]:56746)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <larsi@HIDDEN>) id 1oKfkm-0004ud-1h
 for 56974 <at> debbugs.gnu.org; Sun, 07 Aug 2022 08:51:36 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnus.org;
 s=20200322; h=Content-Type:MIME-Version:Message-ID:Date:References:
 In-Reply-To:Subject:Cc:To:From:Sender:Reply-To:Content-Transfer-Encoding:
 Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender:
 Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe:
 List-Subscribe:List-Post:List-Owner:List-Archive;
 bh=bhYsRCdWpA8Mrab9enbvLOYmDJgAgymaof8MRm4c7/8=; b=ebyIjJTxqmzxqSxpeykSogkhaq
 YQ8wWis22Sc/5RqBhnMld8p0hJESfI033XOA9SPi3v8DgHdwcPdQY9PjFvU6hgqDHU0xgNm8SNDvR
 nDm9LWxtiYsykR7jhqRCWI/WlOqVm0l9lb2GdLEB8uMi0czJvlaW9PFxYpaYBfnnitgE=;
Received: from [84.212.220.105] (helo=joga)
 by quimby.gnus.org with esmtpsa (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.92) (envelope-from <larsi@HIDDEN>)
 id 1oKfkd-0006Zg-33; Sun, 07 Aug 2022 14:51:29 +0200
From: Lars Ingebrigtsen <larsi@HIDDEN>
In-Reply-To: <87fsi8re7l.fsf@HIDDEN> (Michael Heerdegen's message of "Sun, 07
 Aug 2022 04:15:42 +0200")
References: <87o7x0jgz7.fsf@HIDDEN> <83les42lfd.fsf@HIDDEN>
 <87a68jjbdn.fsf@HIDDEN> <871qtuc30u.fsf@HIDDEN>
 <871qtuno0u.fsf@HIDDEN> <87tu6p5zts.fsf@HIDDEN>
 <87fsi8re7l.fsf@HIDDEN>
Date: Sun, 07 Aug 2022 14:51:26 +0200
Message-ID: <87mtcg2p4h.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux)
MIME-Version: 1.0
Content-Type: text/plain
X-Spam-Report: Spam detection software, running on the system "quimby.gnus.org",
 has NOT identified this incoming email as spam.  The original
 message has been attached to this so you can view it or label
 similar future email.  If you have any questions, see
 @@CONTACT_ADDRESS@@ for details.
 Content preview: Michael Heerdegen <michael_heerdegen@HIDDEN> writes: >
 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... Content analysis details:   (-2.9 points, 5.0 required)
 pts rule name              description
 ---- ---------------------- --------------------------------------------------
 -1.0 ALL_TRUSTED            Passed through trusted hosts only via SMTP
 -1.9 BAYES_00               BODY: Bayes spam probability is 0 to 1%
 [score: 0.0000]
X-Spam-Score: -2.3 (--)
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

Michael Heerdegen <michael_heerdegen@HIDDEN> writes:

> 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...

There may be code problems in making when-let* and when-let synonymous
(for those that are using the outdated forms), so that's not easy to do.
But since we shouldn't document the differences, they're identical in
that way.






Last modified: Sun, 7 Aug 2022 13:00:02 UTC

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