From: Matt Armstrong <matt@rfc20.org>
To: Lars Ingebrigtsen <larsi@gnus.org>
Cc: 52202@debbugs.gnu.org
Subject: bug#52202: 29.0.50; try-completion, all-completions support for a list of strings COLLECTION is not documented in their docstrings
Date: Wed, 01 Dec 2021 11:49:19 -0800 [thread overview]
Message-ID: <87y25414xs.fsf@rfc20.org> (raw)
In-Reply-To: <87v909asf2.fsf@gnus.org>
Lars Ingebrigtsen <larsi@gnus.org> writes:
> Matt Armstrong <matt@rfc20.org> writes:
>
>> Then I realized that the lisp reference manual is in good shape. This
>> patch copies text almost verbatim from it. So, the diff is both large
>> but hopefully not hard to verify in review.
>
> In these cases, we usually just say "See (elisp)Section" in the doc
> strings, and leave the description of the complex data structures to
> the manual.
I can see it both ways.
Eli suggested that a complete docstring would be more handy (up thread),
and I now think this might be achievable with simpler edits, so absent a
different consensus I'll go that direction for now.
prev parent reply other threads:[~2021-12-01 19:49 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-11-30 16:59 bug#52202: 29.0.50; try-completion, all-completions support for a list of strings COLLECTION is not documented in their docstrings Matt Armstrong
2021-11-30 19:18 ` bug#52202: [PATCH] " Matt Armstrong
2021-11-30 19:30 ` Eli Zaretskii
2021-11-30 20:39 ` bug#52202: 29.0.50; " Matt Armstrong
2021-12-01 3:36 ` Eli Zaretskii
2021-12-01 19:43 ` Matt Armstrong
2021-12-01 3:57 ` Lars Ingebrigtsen
2021-12-01 19:49 ` Matt Armstrong [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=87y25414xs.fsf@rfc20.org \
--to=matt@rfc20.org \
--cc=52202@debbugs.gnu.org \
--cc=larsi@gnus.org \
/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.