GNU bug report logs - #52202
29.0.50; try-completion, all-completions support for a list of strings COLLECTION is not documented in their docstrings

Previous Next

Full log

Message #17 received at 52202 <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Matt Armstrong <matt <at> rfc20.org>
Cc: 52202 <at> debbugs.gnu.org
Subject: Re: 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 05:36:45 +0200

> From: Matt Armstrong <matt <at> rfc20.org>
> Cc: 52202 <at> debbugs.gnu.org
> Date: Tue, 30 Nov 2021 12:39:45 -0800
> 
> Eli Zaretskii <eliz <at> gnu.org> writes:
> 
> >> From: Matt Armstrong <matt <at> rfc20.org>
> >> Date: Tue, 30 Nov 2021 11:18:05 -0800
> >> 
> >> Attached is a docstring patch against the emacs-28 branch for this
> >> issue.
> >
> > Thanks, but ... all these changes just to say that a list of strings
> > can also be a COLLECTION?  This looks like a complete rewrite, and
> > comparing it with the existing doc string is a lot of work.  Is the
> > current doc string really that awful and requires such a complete
> > rewrite?  Why can't we get away with a smaller, simpler change (that
> > would be easier to review and approve)?
> 
> Thanks Eli, I can sympathize with respect to the review difficulty, but
> I couldn't find a simple edit that did a good job.  It is more than just
> "list of strings", but I did not realize when I filed the bug.  This
> became clear only after I started reading code and trying to document
> the current behavior.

Can you list the aspects which the current doc string doesn't
describe, or describes inaccurately or incorrectly?

Thanks.

Previous Next

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