GNU bug report logs - #60103
28.2; Doc string of `previous-history-element'

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 60103 in the body.
You can then email your comments to 60103 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: "bug-gnu-emacs <at> gnu.org" <bug-gnu-emacs <at> gnu.org>
Subject: 28.2; Doc string of `previous-history-element'
Date: Thu, 15 Dec 2022 21:05:31 +0000

The doc string says this:

  Puts previous element of the minibuffer history in the minibuffer.
  With argument N, it uses the Nth previous element.

That second line makes it sound like arg N is optional.  It's not -
there is no _without_ argument N.

In GNU Emacs 28.2 (build 2, x86_64-w64-mingw32)
 of 2022-09-13 built on AVALON
Windowing system distributor 'Microsoft Corp.', version 10.0.19044
System Description: Microsoft Windows 10 Pro (v10.0.2009.19044.2251)

Configured using:
 'configure --with-modules --without-dbus --with-native-compilation
 --without-compress-install CFLAGS=-O2'

Configured features:
ACL GIF GMP GNUTLS HARFBUZZ JPEG JSON LCMS2 LIBXML2 MODULES NATIVE_COMP
NOTIFY W32NOTIFY PDUMPER PNG RSVG SOUND THREADS TIFF TOOLKIT_SCROLL_BARS
XPM ZLIB

(NATIVE_COMP present but libgccjit not available)

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 60103 <at> debbugs.gnu.org
Subject: Re: bug#60103: 28.2; Doc string of `previous-history-element'
Date: Fri, 16 Dec 2022 17:33:10 +0200

> From: Drew Adams <drew.adams <at> oracle.com>
> Date: Thu, 15 Dec 2022 21:05:31 +0000
> 
> The doc string says this:
> 
>   Puts previous element of the minibuffer history in the minibuffer.
>   With argument N, it uses the Nth previous element.
> 
> That second line makes it sound like arg N is optional.  It's not -
> there is no _without_ argument N.

What do you mean by "no _without_"?  This command is bound to M-p in
the minibuffer, and I can definitely invoke it as "just" M-n,
_without_ any prefix argument.

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

From: Drew Adams <drew.adams <at> oracle.com>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: "60103 <at> debbugs.gnu.org" <60103 <at> debbugs.gnu.org>
Subject: RE: [External] : Re: bug#60103: 28.2; Doc string of
 `previous-history-element'
Date: Fri, 16 Dec 2022 17:53:34 +0000

> > The doc string says this:
> >
> >   Puts previous element of the minibuffer history in the minibuffer.
> >   With argument N, it uses the Nth previous element.
> >
> > That second line makes it sound like arg N is optional.  It's not -
> > there is no _without_ argument N.
> 
> What do you mean by "no _without_"?  This command is bound to M-p in
> the minibuffer, and I can definitely invoke it as "just" M-n,
> _without_ any prefix argument.

I mean "without argument N", not "without a prefix
arg".

It's not possible to invoke the function without
providing argument N - it's not optional.

If you want to say something like "With numeric
prefix argument N..." then that would be fine.

Thx.

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 60103-done <at> debbugs.gnu.org
Subject: Re: [External] : Re: bug#60103: 28.2; Doc string of
 `previous-history-element'
Date: Fri, 16 Dec 2022 20:48:19 +0200

> From: Drew Adams <drew.adams <at> oracle.com>
> CC: "60103 <at> debbugs.gnu.org" <60103 <at> debbugs.gnu.org>
> Date: Fri, 16 Dec 2022 17:53:34 +0000
> 
> > > The doc string says this:
> > >
> > >   Puts previous element of the minibuffer history in the minibuffer.
> > >   With argument N, it uses the Nth previous element.
> > >
> > > That second line makes it sound like arg N is optional.  It's not -
> > > there is no _without_ argument N.
> > 
> > What do you mean by "no _without_"?  This command is bound to M-p in
> > the minibuffer, and I can definitely invoke it as "just" M-n,
> > _without_ any prefix argument.
> 
> I mean "without argument N", not "without a prefix
> arg".
> 
> It's not possible to invoke the function without
> providing argument N - it's not optional.
> 
> If you want to say something like "With numeric
> prefix argument N..." then that would be fine.

That's what I did (the original doc string didn't mention the prefix
argument explicitly, but clearly alluded to that when it said
"argument").

Previous Next

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