From: "Basil L. Contovounesios" <contovob@tcd.ie>
To: "T.V Raman" <raman@google.com>
Cc: emacs-devel@gnu.org
Subject: Re: when-let, if-let in elisp texinfo manual?
Date: Sun, 27 Jun 2021 16:34:37 +0100 [thread overview]
Message-ID: <87k0mfnwxe.fsf@tcd.ie> (raw)
In-Reply-To: <24792.36388.548122.790658@google.com> (T.V Raman's message of "Sun, 27 Jun 2021 07:41:40 -0700")
"T.V Raman" <raman@google.com> writes:
> when-let, if-let from subr-x dont appear to be documented in the
> texinfo manual; should they be?
It used to be the case that subr-x functions were deliberately not
documented in the manual:
https://lists.gnu.org/r/emacs-devel/2014-01/msg00994.html
https://lists.gnu.org/r/emacs-devel/2019-04/msg01222.html
A few seem to have snuck in since then:
- string-clean-whitespace
- string-fill
- string-limit
- string-lines
- string-pad
- string-chop-newline
- replace-region-contents
Yet the manual makes no mention of subr-x as a non-preloaded library
(though some definitions like if-let and when-let are now autoloaded).
So a bit more consistency would indeed be nice, e.g. via autoloading all
definitions documented in the manual, trimming recently added but less
important subr-x definitions from the manual, etc.
--
Basil
prev parent reply other threads:[~2021-06-27 15:34 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-06-27 14:41 when-let, if-let in elisp texinfo manual? T.V Raman
2021-06-27 15:34 ` Basil L. Contovounesios [this message]
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87k0mfnwxe.fsf@tcd.ie \
--to=contovob@tcd.ie \
--cc=emacs-devel@gnu.org \
--cc=raman@google.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.