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

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 11056 in the body.
You can then email your comments to 11056 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: Randy Yates <randy.yates <at> ti.com>
To: <bug-gnu-emacs <at> gnu.org>
Subject: 23.3; GNUS documentation error
Date: Wed, 21 Mar 2012 10:34:53 -0500

C-h k B m


In GNU Emacs 23.3.2 (x86_64-unknown-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2011-04-13 on dflbhrhel4-64.dal.design.ti.com
Windowing system distributor `The X.Org Foundation', version 11.0.60802000
configured using `configure  '--with-pop' '--prefix=/apps/free/emacs/23.3''

Important settings:
  value of $LC_ALL: C
  value of $LC_COLLATE: nil
  value of $LC_CTYPE: nil
  value of $LC_MESSAGES: nil
  value of $LC_MONETARY: nil
  value of $LC_NUMERIC: nil
  value of $LC_TIME: nil
  value of $LANG: C
  value of $XMODIFIERS: nil
  locale-coding-system: nil
  default enable-multibyte-characters: t

Major mode: Summary

Minor modes in effect:
  show-paren-mode: t
  tooltip-mode: t
  mouse-wheel-mode: t
  file-name-shadow-mode: t
  global-font-lock-mode: t
  font-lock-mode: t
  blink-cursor-mode: t
  auto-encryption-mode: t
  auto-compression-mode: t
  column-number-mode: t
  line-number-mode: t
  transient-mark-mode: t

Recent input:
y <return> m a k e SPC i t SPC w o r t h SPC l e a 
v i n g SPC N C . C-a C-x C-s C-e C-p C-n C-p C-e C-n 
C-a C-x C-s C-n C-p C-e SPC C-a C-x C-s C-e <return> 
<return> - - R a n d y <return> C-a C-x C-s C-p C-p 
C-p C-p C-p C-p C-p C-p C-n C-n C-n C-f C-f C-f C-f 
C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f 
C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f 
C-f C-f C-f C-f C-f C-f C-f C-f C-f C-f C-d C-a C-x 
C-s C-n C-n C-p C-e <C-backspace> n o t C-a C-n C-e 
C-a C-x C-s C-p C-p C-p C-n C-n C-n C-p C-f C-f C-f 
C-f C-f C-d t w o C-f C-f C-f C-f C-f C-f C-f C-f C-f 
C-f C-f C-f C-f C-f C-f C-f C-f C-b C-d i e s C-a C-x 
C-s C-n C-a C-x C-s C-x k <return> C-x k <return> q 
C-p C-u <return> 4 0 <return> C-n C-n <down> <down> 
<down> <down> <down> <down> <down> <down> <up> # # 
C-h k B m C-x o C-n C-n C-n C-n C-n C-n C-n C-n C-n 
C-n C-n C-p q C-h a m a r k <return> C-x o C-s g n 
u s <return> C-a C-s m o v e C-s C-s C-s C-s C-s C-s 
C-s C-s C-s C-s C-s C-s C-s C-s C-s C-s C-s C-s C-s 
C-s C-s C-g C-g M-v C-v q C-x o C-h k B r C-h k B m 
q C-g B m C-g C-g M-x r e p o r t - e m a c s - b u 
g <return>

Recent messages:
Mark saved where search started
Quit
Type C-x 4 C-o RET to restore the other window.
Expiring articles...
imap: Connecting to imap.mail.ti.com...
Opening STARTTLS connection to `imap.mail.ti.com:143'...done
imap: Connecting with STARTTLS...
imap: Connecting to imap.mail.ti.com...failed
Unable to open server nnimap+OutlookServer, go offline? (y or n) 
Quit [2 times]
Quit

Load-path shadows:
None found.

Features:
(shadow emacsbug multi-isearch apropos help-mode view newcomment mailalias
smtpmail gnus-cite ansi-color mail-extr gnus-async gnus-bcklg sort byte-opt
bytecomp byte-compile parse-time timezone gnus-ml disp-table nnfolder utf-7 utf7
auth-source starttls nnimap imap nndraft nnmh gnus-agent gnus-srvr gnus-score
score-mode nnvirtual gnus-msg gnus-art mm-uu mml2015 pgg pgg-parse pgg-def
epg-config mm-view smime dig nntp gnus-cache gnus-sum nnoo gnus-group gnus-undo
nnmail mail-source format-spec gnus-start gnus-spec gnus-int gnus-range message
ecomplete rfc822 mml mml-sec password-cache mm-decode mm-bodies mm-encode
mailcap mail-parse rfc2231 rfc2047 rfc2045 qp ietf-drums mailabbrev gmm-utils
mailheader canlock sha1 hex-util hashcash gnus-win gnus gnus-ems nnheader
gnus-util netrc time-date mail-utils mm-util mail-prsvr package paren delsel
cus-start cus-load vc vc-dispatcher derived ediff-merg ediff-diff ediff-wind
ediff-help ediff-util ediff-mult ediff-init ediff clearcase advice help-fns
advice-preload tq executable dired comint ring arrivedsafely color-theme edmacro
kmacro wid-edit cl cl-19 sendmail regexp-opt reporter easymenu tooltip
ediff-hook vc-hooks lisp-float-type mwheel x-win x-dnd font-setting tool-bar dnd
fontset image fringe lisp-mode register page menu-bar rfn-eshadow timer select
scroll-bar mldrag mouse jit-lock font-lock syntax facemenu font-core frame cham
georgian utf-8-lang misc-lang vietnamese tibetan thai tai-viet lao korean
japanese hebrew greek romanian slovak czech european ethiopic indian cyrillic
chinese case-table epa-hook jka-cmpr-hook help simple abbrev loaddefs button
minibuffer faces cus-face files text-properties overlay md5 base64 format env
code-pages mule custom widget hashtable-print-readable backquote
make-network-process font-render-setting x-toolkit x multi-tty emacs)

-- 
Greetings New User! Your email address and a clever or insightful
quote or saying should be placed in this file before posting news
or sending mail.

Hi Folks,

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.

? Then each of the subsequent cases define what the "group" is based on the
parameters. This way the statement is true for all cases of input parameters.

I read the first sentence and concluded that function wasn't what I needed. I
then spent 10 minutes in #emacs figuring out it DOES do what I need (move marked
articles).

randy.yates <at> ti.com
yates <at> digitalsignallabs.com

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

From: Lars Magne Ingebrigtsen <larsi <at> gnus.org>
To: Randy Yates <randy.yates <at> ti.com>
Cc: 11056-close <at> debbugs.gnu.org
Subject: Re: bug#11056: 23.3; GNUS documentation error
Date: Tue, 10 Apr 2012 22:33:36 +0200

> 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.

The second line says

If N is a positive number, move the N next articles.

and so on.

-- 
(domestic pets only, the antidote for overdose, milk.)
  bloggy blog http://lars.ingebrigtsen.no/

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.