Issue #10285: explain the `flag` return field better in NNTP.list().

Patch by Julien Élie.

diff --git a/Doc/library/nntplib.rst b/Doc/library/nntplib.rst
index 0f0b7d2b80f112337cb166e47cc956121e4803fa..77845c8cf229a271ab09d51a1651955cffb9cc4b 100644 (file)
--- 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 d9e3f33fc7d08ed2d94a247c49f9e4cd7dc4724a..c52ec4e4f18d5d6208386872c0de151da4dcdc75 100644 (file)
--- 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