GNU bug report logs - #916
23.0.60; doc string of dired-get-marked-files

Previous Next

Package: emacs;

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

Date: Sun, 7 Sep 2008 17:25:05 UTC

Severity: normal

Done: Chong Yidong <cyd <at> stupidchicken.com>

Bug is archived. No further changes may be made.

Full log

Message #10 received at 916-done <at> emacsbugs.donarmstrong.com (full text, mbox):

From: Chong Yidong <cyd <at> stupidchicken.com>
To: "Drew Adams" <drew.adams <at> oracle.com>
Cc: 916-done <at> debbugs.gnu.org
Subject: Re: 23.0.60; doc string of dired-get-marked-files
Date: Wed, 22 Oct 2008 16:39:40 -0400

> The doc string says this about optional arg ARG:
> 
> Optional second argument arg specifies files near point
>  instead of marked files.  If arg is an integer, use the next arg files.
>   If arg is otherwise non-nil, use file.  Usually arg comes from
>   the command's prefix arg.
> 
> This is not correct, or at least it is incomplete.

It is correct, because of the word "instead": if ARG is non-nil, it
modifies the behavior of the function.

I fixed the doc string to make this distinction clearer, and to prevent
similar confusion.
This bug report was last modified 16 years and 245 days ago.

Previous Next

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