[28012] trunk/doc/guide/new/xml/portfileref.xml

[source_changes at macosforge.org]

Revision: 28012
          http://trac.macosforge.org/projects/macports/changeset/28012
Author:   markd at macports.org
Date:     2007-08-17 18:15:48 -0700 (Fri, 17 Aug 2007)

Log Message:
-----------
Add information on hiding email addresses to reference section as well.

Modified Paths:
--------------
    trunk/doc/guide/new/xml/portfileref.xml

Modified: trunk/doc/guide/new/xml/portfileref.xml
===================================================================
--- trunk/doc/guide/new/xml/portfileref.xml	2007-08-18 01:15:03 UTC (rev 28011)
+++ trunk/doc/guide/new/xml/portfileref.xml	2007-08-18 01:15:48 UTC (rev 28012)
@@ -830,9 +830,30 @@
           <term>maintainers</term>
 
           <listitem>
-            <para>The email address(es) of the Portfile maintainer(s).</para>
+            <para>The email address(es) of the Portfile maintainer(s). To
+            avoid spam, email addresses are often hidden. To hide email
+            addresses from spambots, use these conventions.</para>
 
-            <programlisting>maintainers    openmaintainer at macports.org jdoe at macports.org</programlisting>
+            <itemizedlist>
+              <listitem>
+                <para>For addresses in domain @macports.org, simply omit the
+                domain name.</para>
+              </listitem>
+
+              <listitem>
+                <para>For addresses in other domains, say
+                <email>samj at somedomain.org</email>, use the convention
+                somedomain.org:samj to specify the address.</para>
+              </listitem>
+            </itemizedlist>
+
+            <para>In the example below, the email addresses
+            <email>joebob at macports.org</email> and
+            <email>julesverne at somedomain.org</email> are hidden using this
+            convention.</para>
+
+            <programlisting>maintainers       joebob \
+                  somedomain.org:julesverne</programlisting>
           </listitem>
         </varlistentry>
 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/macports-changes/attachments/20070817/cabc90bb/attachment.html