From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Philip Kaludercic Newsgroups: gmane.emacs.bugs Subject: bug#56974: 29.0.50; Missing documentation for former subr-x macros Date: Thu, 04 Aug 2022 13:06:20 +0000 Message-ID: <87o7x0jgz7.fsf@posteo.net> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="35899"; mail-complaints-to="usenet@ciao.gmane.io" To: 56974@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Thu Aug 04 15:17:59 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 1oJajf-00097m-3j for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 04 Aug 2022 15:17:59 +0200 Original-Received: from localhost ([::1]:52736 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oJaje-0002ZW-4S for geb-bug-gnu-emacs@m.gmane-mx.org; Thu, 04 Aug 2022 09:17:58 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:46480) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oJaZ4-0005FW-8K for bug-gnu-emacs@gnu.org; Thu, 04 Aug 2022 09:07:02 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:33573) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oJaZ3-0000bF-V8 for bug-gnu-emacs@gnu.org; Thu, 04 Aug 2022 09:07:01 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oJaZ3-0000du-Pj for bug-gnu-emacs@gnu.org; Thu, 04 Aug 2022 09:07:01 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Philip Kaludercic Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 04 Aug 2022 13:07:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 56974 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.16596184022440 (code B ref -1); Thu, 04 Aug 2022 13:07:01 +0000 Original-Received: (at submit) by debbugs.gnu.org; 4 Aug 2022 13:06:42 +0000 Original-Received: from localhost ([127.0.0.1]:51555 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oJaYj-0000dI-U0 for submit@debbugs.gnu.org; Thu, 04 Aug 2022 09:06:42 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:47634) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oJaYg-0000d9-Nb for submit@debbugs.gnu.org; Thu, 04 Aug 2022 09:06:41 -0400 Original-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 ) id 1oJaYf-00057W-07 for bug-gnu-emacs@gnu.org; Thu, 04 Aug 2022 09:06:38 -0400 Original-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 ) id 1oJaYb-0000YE-TJ for bug-gnu-emacs@gnu.org; Thu, 04 Aug 2022 09:06:36 -0400 Original-Received: from submission (posteo.de [185.67.36.169]) by mout02.posteo.de (Postfix) with ESMTPS id 6CD5D240104 for ; 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== Original-Received: from customer (localhost [127.0.0.1]) by submission (posteo.de) with ESMTPSA id 4Lz8BC2RXwz6tp2 for ; Thu, 4 Aug 2022 15:06:26 +0200 (CEST) Autocrypt: addr=philipk@posteo.net; prefer-encrypt=nopreference; keydata= mDMEYHHqUhYJKwYBBAHaRw8BAQdAp3GdmYJ6tm5McweY6dEvIYIiry+Oz9rU4MH6NHWK0Ee0QlBo aWxpcCBLYWx1ZGVyY2ljIChnZW5lcmF0ZWQgYnkgYXV0b2NyeXB0LmVsKSA8cGhpbGlwa0Bwb3N0 ZW8ubmV0PoiQBBMWCAA4FiEEDM2H44ZoPt9Ms0eHtVrAHPRh1FwFAmBx6lICGwMFCwkIBwIGFQoJ CAsCBBYCAwECHgECF4AACgkQtVrAHPRh1FyTkgEAjlbGPxFchvMbxzAES3r8QLuZgCxeAXunM9gh io0ePtUBALVhh9G6wIoZhl0gUCbQpoN/UJHI08Gm1qDob5zDxnIHuDgEYHHqUhIKKwYBBAGXVQEF AQEHQNcRB+MUimTMqoxxMMUERpOR+Q4b1KgncDZkhrO2ql1tAwEIB4h4BBgWCAAgFiEEDM2H44Zo Pt9Ms0eHtVrAHPRh1FwFAmBx6lICGwwACgkQtVrAHPRh1Fw1JwD/Qo7kvtib8jy7puyWrSv0MeTS g8qIxgoRWJE/KKdkCLEA/jb9b9/g8nnX+UcwHf/4VfKsjExlnND3FrBviXUW6NcB Received-SPF: pass client-ip=185.67.36.66; envelope-from=philipk@posteo.net; 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-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:238736 Archived-At: 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))