aboutsummaryrefslogtreecommitdiff
blob: 35b42a1369c751a42efa4e6f9584d71d1910e4d3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
---
section: "get-involved"
title: "Mailing list instructions"
date: 2020-09-04T17:25:33+02:00
draft: false
url: "/get-involved/mailing-lists/instructions.html"
---

<div class="row">
    <div class="col-xs-12 col-md-3 col-lg-3">
        <div class="nav flex-column nav-pills gentoo-nav" aria-orientation="vertical">
            <a class="nav-link" href="/get-involved/mailing-lists/" aria-selected="true">Mailing lists</a>
            <a class="nav-link" href="/get-involved/mailing-lists/all-lists.html" aria-selected="false">All mailing lists</a>
            <a class="nav-link active" href="/get-involved/mailing-lists/instructions.html" aria-selected="false">Instructions and FAQs</a>
        </div>
    </div>
    <div class="col-xs-12 col-md-9 col-lg-9">
        <h2 id="subscribing">Subscribing</h2>

        <p>One interacts with <em>mlmmj</em> via email. To subscribe to a list, send an empty email to:</p>

        <p><code class="language-plaintext highlighter-rouge">listname+subscribe@lists.gentoo.org</code></p>

        <div class="alert alert-info">
            <strong>Note</strong>
            <br>
            Replace <code>listname</code> with the actual name of the list that you want to subscribe to.
            <br>
            Example: <code>gentoo-user+subscribe@lists.gentoo.org</code> to subscribe to the gentoo-user mailing list.
            <br>
            You will then receive a subscription confirmation request (double opt-in) from the list manager, that you must reply to if you wish to subscribe.
        </div>

        <h2 id="posting">Posting</h2>

        <p>Once subscribed to the list, you can post to it by sending an email to:</p>

        <p><code class="language-plaintext highlighter-rouge">listname@lists.gentoo.org</code></p>

        <p>If you are not subscribed, your mail will be silently dropped. See the <a href="i-subscribed-to-a-list-using-my-home-email-address-but-i-cant-post-to-the-list-from-work-what-do-i-do-to-fix-this">"Nomail"</a> section below for a further discussion.</p>

        <h2 id="unsubscribing">Unsubscribing</h2>

        <p>To unsubscribe from a list, send an empty email to:</p>

        <p><code class="language-plaintext highlighter-rouge">listname+unsubscribe@lists.gentoo.org</code></p>

        <div class="alert alert-info">
            <strong>Note</strong>
            <br>
            You must use the <strong>identical address</strong> that you subscribed with to unsubscribe successfully.
            If your email address is now forwarded/rewritten beyond your control,
            please contact the list owner via <code>listname+owner@lists.gentoo.org</code> with a request for manual removal.
            You will then receive a unsubscription confirmation request (double opt-in) from the list manager, that you must reply to if you wish to be unsubscribed.
        </div>

        <h2 id="digest-lists">Digest lists</h2>

        <p>All of our lists also have a corresponding digest list.
            Digest lists will mail a single email to you every couple of days, rather than individual emails for each post.
            If you are subscribed to the digest variant and wish to be unsubscribed, you must specifically unsubscribe from the digest variant.
            Using the email address that you wish to (un)subscribe, send an empty email to the following addresses to subscribe and unsubscribe from mailing lists respectively:</p>

        <p><code class="language-plaintext highlighter-rouge">listname+subscribe-digest@lists.gentoo.org</code><br>
            <code class="language-plaintext highlighter-rouge">listname+unsubscribe-digest@lists.gentoo.org</code></p>

        <p>Some users may want to post to the list, but not actually receive mail from it (such as those who read lists via an alternate method, such as gmane).
            These users may subscribe to the "nomail" option of each list:</p>

        <p><code class="language-plaintext highlighter-rouge">listname+subscribe-nomail@lists.gentoo.org</code><br>
            <code class="language-plaintext highlighter-rouge">listname+unsubscribe-nomail@lists.gentoo.org</code></p>

        <h2 id="more-functions">More functions</h2>

        <p>You can learn more about the capabilities of mlmmj by sending an empty mail to the following address:</p>

        <p><code class="language-plaintext highlighter-rouge">listname+help@lists.gentoo.org</code></p>

        <h2 id="moderated-lists">Moderated lists</h2>

        <p>Very few of the Gentoo lists are moderated: only the <code class="language-plaintext highlighter-rouge">-announce</code> lists are fully moderated.
            Additionally, some of our high-traffic lists have moderators in place for spam and unsubscribe requests (matching mail via regex).
            The moderators can be reached by emailing:</p>

        <p><code class="language-plaintext highlighter-rouge">listname+moderators@lists.gentoo.org</code></p>

        <h2 id="faq">FAQ</h2>

        <h3 id="i-subscribed-to-a-list-using-my-home-email-address-but-i-cant-post-to-the-list-from-work-what-do-i-do-to-fix-this">"Nomail": I subscribed to a list using my home email address, but I can’t post to the list from work. What do I do to fix this?</h3>

        <p>To reduce spam, all of our lists are configured to only allow posts from official subscriber email addresses. Mail from addresses that are not subscribed is silently dropped.</p>

        <p>It is possible to subscribe for posting-only: mlmmj supports "nomail" subscriptions, allowing you to register alternate email addresses that can be used only for posting to the list.</p>

        <p>Here’s an example of how this works:</p>
        <ol>
            <li>
                Let’s say you subscribed to the gentoo-dev list as <code class="language-plaintext highlighter-rouge">jim@home.com</code>, but you’d also like to post to the list using your <code class="language-plaintext highlighter-rouge">james@work.com</code> email address.
            </li>
            <li>
            To do this, send a message (as <code class="language-plaintext highlighter-rouge">james@work.com</code>) to <code class="language-plaintext highlighter-rouge">gentoo-dev+subscribe-nomail@lists.gentoo.org</code>.
            </li>
            <li>
            You should then be allowed to post to gentoo-dev using both your home and work email addresses.
            </li>
        </ol>

        <p>In line with the original spam reduction goal, if you post to the list from a non-subscribed address, your mail will be delivered to <code>/dev/null</code>.
            You will not receive any bounce message from our servers. This prevents spammers from forging your address to get a bounce delivered to you.</p>

        <h3 id="i-want-to-switch-from-regular-delivery-to-digest-delivery-how-do-i-do-this">I want to switch from regular delivery to digest delivery. How do I do this?</h3>

        <p>Unsubscribe from the normal list and then subscribe to the digest list.
            For list <code class="language-plaintext highlighter-rouge">listname</code>, this would be done by sending empty emails to the following two addresses:</p>

        <p><code class="language-plaintext highlighter-rouge">listname+unsubscribe@lists.gentoo.org</code><br>
            <code class="language-plaintext highlighter-rouge">listname+subscribe-digest@lists.gentoo.org</code></p>

        <h3 id="how-do-i-use-procmail-to-filter-gentoo-mailing-list-messages">How do I use procmail to filter Gentoo mailing list messages?</h3>

        <p>To filter incoming mail arriving from list <code class="language-plaintext highlighter-rouge">listname</code>, use the following <kbd>procmail</kbd> recipe:</p>

        <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>:0:
* ^List-Id:.*listname\.gentoo\.org
Mail/listname
</code></pre></div></div>

        <p>This is identical to how you’d filter incoming <em>Mailman</em> mailing list manager emails.</p>

        <h3 id="miscellaneous-list-policies">Miscellaneous list policies</h3>

        <p>HTML email is discouraged, but not forbidden (there are some MUA, specifically web-based that make it very hard to disable HTML entirely).
            Beware that some users may have their receiving side configured to hide HTML entirely, so it might look like you are ignored, especially if you sent HTML-only email.
            In order of preference, you should endeavour to send: <tt>text/plain</tt>, multipart with <tt>text/plain</tt> before <tt>text/html</tt>, <tt>text/html</tt>.
            MIME is acceptable and widely used.</p>

        <p>Please do not send any vacation or out of office messages to the list.
            In the interests of reducing list spam, if you set any auto-responding message that goes to the lists, we will unsubscribe your account from ALL lists.
            Any previously subscribed addresses that send mail server messages to the lists will also be removed.</p>

        <p>Do not cross-post when sending messages to a list!
            Sending the same message to more than one list at a time leads to fragmentation of the thread when some people reply on one list, and some on another list.
            There’s no guarantee that the recipients of your message are on both lists.
            Choose just one list when sending a message.</p>

        <div class="alert alert-info">
            <strong>Note</strong>
            <br>
            Note: For general email list etiquette, <a href="https://www.ietf.org/rfc/rfc1855.txt">these guidelines</a> are an excellent primer.
        </div>

        <h3 id="my-question-isnt-answered-above-whom-do-i-ask-for-help">My question isn’t answered above, whom do I ask for help?</h3>

        <p>If you need additional help beyond the above, please <a href="https://bugs.gentoo.org/enter_bug.cgi?product=Gentoo%20Infrastructure&amp;version=unspecified&amp;component=Mailing%20Lists&amp;rep_platform=All&amp;op_sys=Linux&amp;priority=P2&amp;bug_severity=normal&amp;bug_status=NEW&amp;alias=&amp;bug_file_loc=https%3A%2F%2F&amp;short_desc=&amp;comment=&amp;commentprivacy=0&amp;keywords=&amp;dependson=&amp;blocked=&amp;bit-25=1&amp;maketemplate=Remember%20values%20as%20bookmarkable%20template&amp;form_name=enter_bug&amp;assigned_to=infra-bugs%40gentoo.org">file a bug</a>, or contact <code class="language-plaintext highlighter-rouge">listname+owner@lists.gentoo.org</code>.</p>

        <h2 id="privacy-policy-and-disclaimer">Privacy policy and disclaimer</h2>

        <p>The mailing lists are public forums, except for lists explicitly otherwise.
            For lists explicitly marked private or restricted, all of the following except web archives are applicable.</p>

        <p>All emails sent to the lists are distributed both to the list subscribers and copied to the <a href="https://archives.gentoo.org">Gentoo Archives</a>,
            for people to browse or search without the need to be subscribed.</p>

        <p>There may be other places where lists are distributed — please make sure you never send any confidential or unlicensed material to the lists.
            This includes things like e-mail addresses.
            Of particular note is the fact that spammers, viruses, worms etc have been known to abuse e-mail addresses posted to our mailing lists.</p>

        <p>Gentoo maintains the mailing lists in good faith and will take steps to curb all noticed abuse and maintain uninterrupted normal service.
            At the same time, Gentoo is not responsible for all mailing list posts or anything that may happen in relation to them.</p>

        <p>These policies are based on the <a href="https://www.debian.org/MailingLists/disclaimer">policies of the Debian mailing lists</a>.</p>

    </div>
</div>