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

[source_changes at macosforge.org]

Revision: 28034
          http://trac.macosforge.org/projects/macports/changeset/28034
Author:   markd at macports.org
Date:     2007-08-18 13:24:33 -0700 (Sat, 18 Aug 2007)

Log Message:
-----------
Refine the explanation of maintainer email address hiding.

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 19:51:43 UTC (rev 28033)
+++ trunk/doc/guide/new/xml/portfileref.xml	2007-08-18 20:24:33 UTC (rev 28034)
@@ -830,9 +830,11 @@
           <term>maintainers</term>
 
           <listitem>
-            <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>
+            <para>A port's maintainer is a person or persons who take
+            responsibility for keeping the port up-to-date, and the maintainer
+            keyword lists maintainer email addresses(s). However, many
+            maintainers wish to hide these addresses from spambots; to do so
+            follow these conventions:</para>
 
             <itemizedlist>
               <listitem>
@@ -847,12 +849,12 @@
               </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
+            <para>In the example below, the maintainer email addresses
+            <email>jdoe at macports.org</email> and
+            <email>julesverne at somedomain.org</email> are hidden using these
             convention.</para>
 
-            <programlisting>maintainers       joebob \
+            <programlisting>maintainers       jdoe \
                   somedomain.org:julesverne</programlisting>
           </listitem>
         </varlistentry>

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