\"article id\" in description of NNTP objects

[felixwiemann]

BPO	1015140
Nosy	@birkenfeld, @birkenfeld, @rhettinger

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/birkenfeld'
closed_at = <Date 2005-07-17.20:27:53.000>
created_at = <Date 2004-08-24.10:26:33.000>
labels = ['docs']
title = '\\"article id\\" in description of NNTP objects'
updated_at = <Date 2005-07-17.20:27:53.000>
user = 'https://bugs.python.org/felixwiemann'

bugs.python.org fields:

activity = <Date 2005-07-17.20:27:53.000>
actor = 'georg.brandl'
assignee = 'georg.brandl'
closed = True
closed_date = None
closer = None
components = ['Documentation']
creation = <Date 2004-08-24.10:26:33.000>
creator = 'felixwiemann'
dependencies = []
files = []
hgrepos = []
issue_num = 1015140
keywords = []
message_count = 5.0
messages = ['22199', '22200', '22201', '22202', '22203']
nosy_count = 4.0
nosy_names = ['georg.brandl', 'georg.brandl', 'rhettinger', 'felixwiemann']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = None
status = 'closed'
superseder = None
type = None
url = 'https://bugs.python.org/issue1015140'
versions = []

[felixwiemann]

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.

[felixwiemann]

Logged In: YES
user_id=1014490

Same problem for the docstrings in the source file
Lib/nntplib.py.

[rhettinger]

Logged In: YES
user_id=80475

Patches are welcome. If you have a link to authoritive
guidance, that would be nice also.

[felixwiemann]

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

[birkenfeld]

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