GNU bug report logs - #25603
24.5; doc of `woman'

Previous Next

Package: emacs;

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

Date: Wed, 1 Feb 2017 17:36:01 UTC

Severity: wishlist

Tags: fixed

Found in version 24.5

Fixed in version 25.2

Done: npostavs <at> users.sourceforge.net

Bug is archived. No further changes may be made.

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

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

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#25603; Package emacs. (Wed, 01 Feb 2017 17:36:01 GMT) Full text and rfc822 format available.
Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Wed, 01 Feb 2017 17:36:01 GMT) Full text and rfc822 format available.

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
Subject: 24.5; doc of `woman'
Date: Wed, 1 Feb 2017 09:35:13 -0800 (PST)

The doc string says this:

 The directory expansions and topics are cached for
 speed, but a non-nil interactive argument forces the caches to be
 updated (e.g. to re-interpret the current directory).

That ("a non-nil interactive argument") is not the way Emacs talks about
the prefix argument.  The doc should say that if you use a prefix
argument then the cached is updated.

Essentially, "non-nil interactive argument" should be "prefix argument".

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'
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#25603; Package emacs. (Sat, 18 Feb 2017 19:03:02 GMT) Full text and rfc822 format available.

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

From: npostavs <at> users.sourceforge.net
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 25603 <at> debbugs.gnu.org
Subject: Re: bug#25603: 24.5; doc of `woman'
Date: Sat, 18 Feb 2017 14:03:26 -0500

tags 25603 fixed
close 25603 25.2
quit

Drew Adams <drew.adams <at> oracle.com> writes:

> The doc string says this:
>
>  The directory expansions and topics are cached for
>  speed, but a non-nil interactive argument forces the caches to be
>  updated (e.g. to re-interpret the current directory).
>
> That ("a non-nil interactive argument") is not the way Emacs talks about
> the prefix argument.  The doc should say that if you use a prefix
> argument then the cached is updated.
>
> Essentially, "non-nil interactive argument" should be "prefix argument".

Fixed [1: ec4226d810].

1: 2017-02-18 13:34:37 -0500 ec4226d81074751c105264a3a3383c48d0a05e41
  * lisp/woman.el (woman): Fix docstring prefix arg description.
Added tag(s) fixed. Request was from npostavs <at> users.sourceforge.net to control <at> debbugs.gnu.org. (Sat, 18 Feb 2017 19:03:02 GMT) Full text and rfc822 format available.
bug marked as fixed in version 25.2, send any further explanations to 25603 <at> debbugs.gnu.org and Drew Adams <drew.adams <at> oracle.com> Request was from npostavs <at> users.sourceforge.net to control <at> debbugs.gnu.org. (Sat, 18 Feb 2017 19:03:03 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Sun, 19 Mar 2017 11:24:03 GMT) Full text and rfc822 format available.
This bug report was last modified 8 years and 91 days ago.

Previous Next

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