GNU bug report logs - #25406
24.5; doc string of `Info-history'

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Mon, 9 Jan 2017 16:40:01 UTC

Severity: wishlist

Found in version 24.5

Done: Stefan Kangas <stefan <at> marxist.se>

Bug is archived. No further changes may be made.

Full log


View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Stefan Kangas <stefan <at> marxist.se>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#25406: closed (24.5; doc string of `Info-history')
Date: Fri, 02 Aug 2019 14:03:02 +0000
[Message part 1 (text/plain, inline)]
Your message dated Fri, 2 Aug 2019 16:02:00 +0200
with message-id <CADwFkmkxP-o41LTaVi_txAvRjk3xP103FDVYF8NLHN+XoadfQA <at> mail.gmail.com>
and subject line Re: bug#25406: 24.5; doc string of `Info-history'
has caused the debbugs.gnu.org bug report #25406,
regarding 24.5; doc string of `Info-history'
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
25406: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=25406
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems
[Message part 2 (message/rfc822, inline)]
From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.5; doc string of `Info-history'
Date: Mon, 9 Jan 2017 08:39:13 -0800 (PST)
The doc string of `Info-find-emacs-command-nodes' refers you to variable
`Info-history' for the format of the locations.

But the doc for `Info-history' says nothing about FILENAME, NODENAME,
and BUFFERPOS.

Instead, those are described in `Info-find-emacs-command-nodes'.

Something is backwards here, and/or missing.  Why refer to "the format
used in the variable `Info-history' if consulting that variable tells
you less about the format that what you are told before sending you
there?

Also, the language in the last sentence of the doc string for
`Info-find-emacs-command-nodes' is not so good.  I'm guessing that
this might be what is really meant:

 ", where BUFFERPOS is the line number
 of the first element of the returned list (which is treated specially
 in `Info-goto-emacs-command-node'), and 0 for the other elements of
 the list."

But why the parenthetical remark, and what it really means, I have
no idea.


In GNU Emacs 24.5.1 (i686-pc-mingw32)
 of 2015-04-11 on LEG570
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/usr --host=i686-pc-mingw32'


[Message part 3 (message/rfc822, inline)]
From: Stefan Kangas <stefan <at> marxist.se>
To: Eli Zaretskii <eliz <at> gnu.org>, 25406-done <at> debbugs.gnu.org
Cc: Drew Adams <drew.adams <at> oracle.com>
Subject: Re: bug#25406: 24.5; doc string of `Info-history'
Date: Fri, 2 Aug 2019 16:02:00 +0200
Eli Zaretskii <eliz <at> gnu.org> writes:

> > From: Stefan Kangas <stefan <at> marxist.se>
> > Date: Fri, 5 Jul 2019 14:17:39 +0200
> > Cc: Drew Adams <drew.adams <at> oracle.com>, 25406 <at> debbugs.gnu.org
> >
> > It seems to me that the conclusion here is to do nothing.  Can we close
> > this bug report or am I missing something?
>
> I'm fine with closing it.

OK, closed.

Thanks,
Stefan Kangas


This bug report was last modified 5 years and 297 days ago.

Previous Next


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