Bugs item #1015140, was opened at 2004-08-24 12:26
Message generated for change (Comment added) made by birkenfeld
You can respond by visiting:
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1015140&group_id=5470
Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: Documentation
Group: None
>Status: Closed
>Resolution: Fixed
Priority: 5
Submitted By: Felix Wiemann (felixwiemann)
>Assigned to: Reinhold Birkenfeld (birkenfeld)
Summary: "article id" in description of NNTP objects
Initial Comment:
lib/nntp-objects.html uses the term "article id"
several times. This term is ambiguous though. Either
"article number" or "message id" should be used.
----------------------------------------------------------------------
>Comment By: Reinhold Birkenfeld (birkenfeld)
Date: 2005-07-17 22:27
Message:
Logged In: YES
user_id=1188172
Corrected in docs and docstrings as
Lib/nntplib.py r1.40, r1.39.2.1
Doc/lib/libnntplib.tex r1.33, r1.32.2.1
----------------------------------------------------------------------
Comment By: Felix Wiemann (felixwiemann)
Date: 2004-08-30 22:13
Message:
Logged In: YES
user_id=1014490
> Patches are welcome.
I don't have enough time (and I don't care enough) to write
a patch for this, currently.
> If you have a link to authoritive
> guidance, that would be nice also.
The only occurence of the case-insensitive regex
'article.id' in all RFCs is in RFC 977, which says:
223 n a article retrieved - request text separately
(n = article number, a = unique article id)
(Here, it probably means message-id.)
There are frequent occurences of 'article number' and
'message-id' in the NNTP related RFCs 977 and 2980.
So 'article id' probably should be avoided, as it is
ambiguous. (The docs sometimes use it in the sense of
'message-id' and sometimes as 'article number', from what I
could see.)
----------------------------------------------------------------------
Comment By: Raymond Hettinger (rhettinger)
Date: 2004-08-29 10:20
Message:
Logged In: YES
user_id=80475
Patches are welcome. If you have a link to authoritive
guidance, that would be nice also.
----------------------------------------------------------------------
Comment By: Felix Wiemann (felixwiemann)
Date: 2004-08-29 10:11
Message:
Logged In: YES
user_id=1014490
Same problem for the docstrings in the source file
Lib/nntplib.py.
----------------------------------------------------------------------
You can respond by visiting:
https://sourceforge.net/tracker/?func=detail&atid=105470&aid=1015140&group_id=5470
_______________________________________________
Python-bugs-list mailing list
Unsubscribe:
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com
