From 7dd1af00ad9e434ff3f60c6626fd30997c4a2dc0 Mon Sep 17 00:00:00 2001 From: Antoine Pitrou Date: Wed, 3 Nov 2010 18:32:54 +0000 Subject: =?UTF-8?q?Issue=20#10285:=20explain=20the=20`flag`=20return=20fie?= =?UTF-8?q?ld=20better=20in=20NNTP.list().=20Patch=20by=20Julien=20=C3=89l?= =?UTF-8?q?ie.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Doc/library/nntplib.rst | 13 +++++++++++-- Misc/ACKS | 1 + 2 files changed, 12 insertions(+), 2 deletions(-) diff --git a/Doc/library/nntplib.rst b/Doc/library/nntplib.rst index 0f0b7d2..77845c8 100644 --- a/Doc/library/nntplib.rst +++ b/Doc/library/nntplib.rst @@ -188,8 +188,17 @@ response indicates an error, the method raises one of the above exceptions. list of tuples representing all the groups available from this NNTP server. Each tuple has the form ``(group, last, first, flag)``, where *group* is a group name, *last* and *first* are the last and first article - numbers, and *flag* is ``'y'`` if posting is allowed, ``'n'`` if not, - and ``'m'`` if the newsgroup is moderated. (Note the ordering: *last*, *first*.) + numbers, and *flag* usually takes one of these values: + + * ``y``: Local postings and articles from peers are allowed. + * ``m``: The group is moderated and all postings must be approved. + * ``n``: No local postings are allowed, only articles from peers. + * ``j``: Articles from peers are filed in the junk group instead. + * ``x``: No local postings, and articles from peers are ignored. + * ``=foo.bar``: Articles are filed in the ``foo.bar`` group instead. + + If *flag* has another value, then the status of the newsgroup should be + considered unknown. This command will often return very large results. It is best to cache the results offline unless you really need to refresh them. diff --git a/Misc/ACKS b/Misc/ACKS index d9e3f33..c52ec4e 100644 --- a/Misc/ACKS +++ b/Misc/ACKS @@ -238,6 +238,7 @@ Grant Edwards John Ehresman Eric Eisner Andrew Eland +Julien Élie Lance Ellinghaus David Ely Jeff Epler -- cgit v0.12