GNU bug report logs - #11056
23.3; GNUS documentation error

Previous Next

Full log

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

From: Randy Yates <randy.yates <at> ti.com>
To: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
Cc: 11056-close <at> debbugs.gnu.org
Subject: Re: bug#11056: 23.3; GNUS documentation error
Date: Wed, 11 Apr 2012 13:54:45 -0500

Lars Magne Ingebrigtsen <larsi <at> gnus.org> writes:

>> I didn't fill in any of the above since this is simply a complaint about the
>> documentation string for the gnus-summary-move-article function and its
>> relatives. 
>
>> The first sentence of that docstring states: 
>
>>   Move the current article to a different newsgroup.
>
>> That sentence is false, depending on the parameters passed. 
>
>> Why couldn't it read
>
>>   Move a group of articles to a different newsgroup.
>
> It says that, because that's what all these commands do if you just call
> them without any parameters.

And if you do call them with parameters, that statement is false. Quintilian,
1950 years ago, wrote, "One should not aim at being possible to understand,
but at being impossible to misunderstand." 
-- 
Randy Yates
DSP Engineer
Texas Instruments/MCU SmartGrid
214-479-0962 (W)
919-720-2916 (C)

Previous Next

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