docs/53326: [patch] New handbook section about filtering on the mailing lists

[Simon L.Nielsen]

>Number:         53326
>Category:       docs
>Synopsis:       [patch] New handbook section about filtering on the mailing lists
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          update
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 14 14:10:11 PDT 2003
>Closed-Date:
>Last-Modified:
>Originator:     Simon L. Nielsen
>Release:        FreeBSD 4.8-STABLE i386
>Organization:
>Environment:
>Description:
Lately I have several times seen email's where people have tried to
attach files to the FreeBSD mailing lists, but where the attachments
have been stripped by the mailing lists software.  Therefor I thought
it would be nice with some documentation about which types of
attachments are allowed on the FreeBSD mailing lists.

I have made a section describing this, based input from David
Wolfskill <david at catwhisker.org> with his postmaster at freebsd.org hat.
>How-To-Repeat:
>Fix:
--- doc-mailinglist-filtering.patch begins here ---
Index: eresources/chapter.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/books/handbook/eresources/chapter.sgml,v
retrieving revision 1.123
diff -u -d -r1.123 chapter.sgml
--- eresources/chapter.sgml	21 May 2003 16:35:12 -0000	1.123
+++ eresources/chapter.sgml	14 Jun 2003 20:50:47 -0000
@@ -1202,6 +1202,76 @@
 
       </variablelist>
     </sect2>
+    <sect2 id="eresources-mailfiltering">
+      <title>Filtering on the mailing lists</title>
+
+      <para>The &os; mailing lists are filtered in multiple ways to
+        avoid spam, viruses, and other unwanted emails to be
+        distributed on the mailing lists.  The filtering actions
+        described in this section does not cover all the filtering
+        mechanisms used to protect the mailing lists.</para>
+
+      <para>Only certain types of attachments are allowed on the
+	mailing lists.  All attachments with a MIME content type not
+	found in the list below, will be stripped before an email is
+	distributed on the mailing lists.</para>
+
+      <itemizedlist>
+	<listitem>
+	  <para>application/octet-stream</para>
+	</listitem>
+
+	<listitem>
+	  <para>application/pdf</para>
+	</listitem>
+
+	<listitem>
+	  <para>application/pgp-signature</para>
+	</listitem>
+
+	<listitem>
+	  <para>application/x-pkcs7-signature</para>
+	</listitem>
+
+	<listitem>
+	  <para>message/rfc822</para>
+	</listitem>
+
+	<listitem>
+	  <para>multipart/alternative</para>
+	</listitem>
+
+	<listitem>
+	  <para>multipart/related</para>
+	</listitem>
+
+	<listitem>
+	  <para>multipart/signed</para>
+	</listitem>
+
+	<listitem>
+	  <para>text/html</para>
+	</listitem>
+
+	<listitem>
+	  <para>text/plain</para>
+	</listitem>
+
+	<listitem>
+	  <para>text/x-patch</para>
+	</listitem>
+      </itemizedlist>
+
+      <note>
+	<para>Some of the mailing lists might allow attachments of
+	  other MIME content types, but the above list should be
+	  applicable for most for the mailing lists.</para>
+      </note>
+
+      <para>If an email contain both a HTML and a plain text version,
+	the HTML part will be removed.  If an email contain only a
+	HTML version, it will be converted to plain text.</para>
+    </sect2>
   </sect1>
 
   <sect1 id="eresources-news">
--- doc-mailinglist-filtering.patch ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted: