[Python-checkins] r86140 - in python/branches/py3k: Doc/library/nntplib.rst Misc/ACKS
python-checkins at python.org
Wed Nov 3 19:32:54 CET 2010
Date: Wed Nov 3 19:32:54 2010
New Revision: 86140
Issue #10285: explain the `flag` return field better in NNTP.list().
Patch by Julien Élie.
--- python/branches/py3k/Doc/library/nntplib.rst (original)
+++ python/branches/py3k/Doc/library/nntplib.rst Wed Nov 3 19:32:54 2010
@@ -188,8 +188,17 @@
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.
--- python/branches/py3k/Misc/ACKS (original)
+++ python/branches/py3k/Misc/ACKS Wed Nov 3 19:32:54 2010
@@ -238,6 +238,7 @@
More information about the Python-checkins