GNU bug report logs - #47833
27.2; Incomplete list of optional arguments in the docstring of `map-y-or-n-p'

Previous Next

Full log

Message #13 received at 47833-done <at> debbugs.gnu.org (full text, mbox):

From: Eli Zaretskii <eliz <at> gnu.org>
To: Glenn Morris <rgm <at> gnu.org>
Cc: 47833-done <at> debbugs.gnu.org, mardani29 <at> yahoo.es
Subject: Re: bug#47833: 27.2;
 Incomplete list of optional arguments in the docstring of
 `map-y-or-n-p'
Date: Sat, 17 Apr 2021 11:26:24 +0300

> From: Glenn Morris <rgm <at> gnu.org>
> Date: Fri, 16 Apr 2021 22:03:15 -0400
> Cc: 47833 <at> debbugs.gnu.org
> 
> > -Takes args PROMPTER ACTOR LIST, and optional args HELP and ACTION-ALIST.
> > +Takes args PROMPTER ACTOR LIST, and optional args HELP,
> > +ACTION-ALIST and NO-CURSOR-IN-ECHO-AREA.
> 
> I suggest instead removing the sentence, which does nothing other than
> list the arguments. describe-function displays the argument list anyway.

Indeed.

The doc string of that function and its description in the ELisp
manual "needed work", so I fixed them on the emacs-27 branch, and I'm
marking this bug done.

Previous Next

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