← Back to branch summary

~barry/mailman/events-and-web

« back to all changes in this revision

Viewing changes to src/mailman/handlers/docs/rfc-2369.rst

  • Committer: Barry Warsaw
  • Date: 2012-04-28 02:32:22 UTC
  • Revision ID: barry@list.org-20120428023222-53owunvh9yw5ewv3
 * List-Post should be NO when posting is not allowed. (LP: #987563)

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/mailman/handlers/docs/rfc-2369.rst
59
59
Messages which Mailman generates itself, such as user or owner notifications,
60
60
have a reduced set of `List-` headers.  Specifically, there is no `List-Post`,
61
61
`List-Archive` or `Archived-At` header.
 
62
..
62
63
 
63
64
    >>> mlist.include_rfc2369_headers = True
64
 
    >>> mlist.include_list_post_header = False
65
65
    >>> msg = message_from_string("""\
66
66
    ... From: aperson@example.com
67
67
    ...
68
68
    ... """)
 
69
 
69
70
    >>> process(mlist, msg, dict(reduced_list_headers=True))
70
71
    >>> list_headers(msg)
71
72
    ---start---
84
85
Discussion lists, to which any subscriber can post, also have a `List-Post`
85
86
header which contains the `mailto:` URL used to send messages to the list.
86
87
 
 
88
    >>> mlist.include_rfc2369_headers = True
87
89
    >>> mlist.include_list_post_header = True
88
90
    >>> msg = message_from_string("""\
89
91
    ... From: aperson@example.com
101
103
        <mailto:test-leave@example.com>
102
104
    ---end---
103
105
 
 
106
Some mailing lists are announce, or one-way lists, not discussion lists.
 
107
Because the general membership cannot post to these mailing lists, the list
 
108
owner can set a flag which adds a special `List-Post` header value, according
 
109
to RFC 2369.
 
110
 
 
111
    >>> mlist.include_list_post_header = False
 
112
    >>> msg = message_from_string("""\
 
113
    ... From: aperson@example.com
 
114
    ...
 
115
    ... """)
 
116
    >>> process(mlist, msg, {})
 
117
    >>> list_headers(msg)
 
118
    ---start---
 
119
    list-help: <mailto:test-request@example.com?subject=help>
 
120
    list-id: <test.example.com>
 
121
    list-post: NO
 
122
    list-subscribe: <http://lists.example.com/listinfo/test@example.com>,
 
123
        <mailto:test-join@example.com>
 
124
    list-unsubscribe: <http://lists.example.com/listinfo/test@example.com>,
 
125
        <mailto:test-leave@example.com>
 
126
    ---end---
 
127
 
104
128
 
105
129
List-Id header
106
130
==============
108
132
If the mailing list has a description, then it is included in the ``List-Id``
109
133
header.
110
134
 
 
135
    >>> mlist.include_list_post_header = True
111
136
    >>> mlist.description = 'My test mailing list'
112
137
    >>> msg = message_from_string("""\
113
138
    ... From: aperson@example.com