--- title: 'Mailing List Instructions' navtitle: 'Instructions & FAQ' nav1: get-involved nav2: ml nav3: ml-instructions nav3-show: true nav3-weight: 30 layout: page-nav3 body_class: nav-align-h2 --- ## Subscribing One interacts with _mlmmj_ via email. To subscribe to a list, send an empty email to: `listname+subscribe@lists.gentoo.org`
Note
Replace listname with the actual name of the list that you want to subscribe to.
Example: gentoo-user+subscribe@lists.gentoo.org to subscribe to the gentoo-user mailing list.
You will then recieve a subscription confirmation request (double opt-in) from the list manager, that you must reply to if you wish to subscribe.
## Posting Once subscribed to the list, you can post to it by sending an email to: `listname@lists.gentoo.org` ## Unsubscribing To unsubscribe from a list, send an empty email to: `listname+unsubscribe@lists.gentoo.org`
Note
You must use the identical address that you subscribed with to unsubscribe successfully. If your email address is now forwarded/rewritten beyond your control, please contact the list owner via listname+owner@lists.gentoo.org with a request for manual removal. You will then recieve a unsubscription confirmation request (double opt-in) from the list manager, that you must reply to if you wish to be unsubscribed.
## Digest Lists 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: `listname+subscribe-digest@lists.gentoo.org`
`listname+unsubscribe-digest@lists.gentoo.org` 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: `listname+subscribe-nomail@lists.gentoo.org`
`listname+unsubscribe-nomail@lists.gentoo.org` ## More Functions You can learn more about the capabilities of mlmmj by sending an empty mail to the following address: `listname+help@lists.gentoo.org` ## Moderated Lists Very few of the Gentoo lists are moderated: only the `-announce` lists are fully moderatored. 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: `listname+moderators@lists.gentoo.org` ## FAQ ### 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? To reduce spam, all of our lists are configured to only allow posts from official subscriber email addresses. Fortunately, mlmmj supports "nomail" subscriptions, allowing you to register alternate email addresses that can be used only for posting to the list. Here's an example of how this works: Let's say you subscribed to the gentoo-dev list as `jim@home.com`, but you'd also like to post to the list using your `james@work.com` email address. To do this, send a message (as `james@work.com`) to `gentoo-dev+subscribe-nomail@lists.gentoo.org`. You should then be allowed to post to gentoo-dev using both your home and work email addresses. 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 /dev/null. You will not receive any bounce message from our servers. This prevents spammers from forging your address to get a bounce delivered to you. ### I want to switch from regular delivery to digest delivery. How do I do this? Unsubscribe from the normal list and then subscribe to the digest list. For list `listname`, this would be done by sending empty emails to the following two addresses: `listname+unsubscribe@lists.gentoo.org`
`listname+subscribe-digest@lists.gentoo.org` ### How do I use procmail to filter Gentoo mailing list messages? To filter incoming mail arriving from list `listname`, use the following procmail recipe: :0: * ^List-Id:.*listname\.gentoo\.org Mail/listname This is identical to how you'd filter incoming _Mailman_ mailing list manager emails. ### Miscellaneous list policies 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 recieving 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: text/plain, multipart with text/plain before text/html, text/html. MIME is acceptable and widely used. 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. 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.
Note
Note: For general email list etiquette, these guidelines are an excellent primer.
### My question isn't answered above, whom do I ask for help? If you need additional help beyond the above, please [file a bug](http://bugs.gentoo.org/enter_bug.cgi?product=Gentoo%20Infrastructure&version=unspecified&component=Mailing%20Lists&rep_platform=All&op_sys=Linux&priority=P2&bug_severity=normal&bug_status=NEW&alias=&bug_file_loc=http%3A%2F%2F&short_desc=&comment=&commentprivacy=0&keywords=&dependson=&blocked=&bit-25=1&maketemplate=Remember%20values%20as%20bookmarkable%20template&form_name=enter_bug&assigned_to=infra-bugs%40gentoo.org), or contact `listname+owner@lists.gentoo.org`. ## Privacy policy & disclaimer 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. All emails sent to the lists are distributed both to the list subscribers and copied to the [Gentoo Archives](http://archives.gentoo.org), for people to browse or search without the need to be subscribed. 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. 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. These policies are based on the [policies of the Debian mailing lists](http://www.debian.org/MailingLists/disclaimer).