[59594] trunk/doc-new/guide/xml

[ryandesign at macports.org]

Revision: 59594
          http://trac.macports.org/changeset/59594
Author:   ryandesign at macports.org
Date:     2009-10-17 09:24:35 -0700 (Sat, 17 Oct 2009)
Log Message:
-----------
Update, clarify and correct some "maintainers" stuff.

Modified Paths:
--------------
    trunk/doc-new/guide/xml/portfile-keywords.xml
    trunk/doc-new/guide/xml/portfiledev.xml

Modified: trunk/doc-new/guide/xml/portfile-keywords.xml
===================================================================
--- trunk/doc-new/guide/xml/portfile-keywords.xml	2009-10-17 16:05:21 UTC (rev 59593)
+++ trunk/doc-new/guide/xml/portfile-keywords.xml	2009-10-17 16:24:35 UTC (rev 59594)
@@ -108,11 +108,12 @@
       <term>maintainers</term>
 
       <listitem>
-        <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>
+        <para>A port's maintainers are the people who have agreed to take
+        responsibility for keeping the port up-to-date. Most ports have only a
+        single maintainer, but some ports have two or more comaintainers. The
+        <literal>maintainers</literal> keyword lists the maintainers' email
+        addresses, preferrably in the obfuscated form which hides them
+        from spambots:</para>
 
         <itemizedlist>
           <listitem>
@@ -121,7 +122,7 @@
           </listitem>
 
           <listitem>
-            <para>For addresses in other domains, say
+            <para>For addresses in other domains, e.g.
             <email>account at example.org</email>, use the convention
             example.org:account to specify the address.</para>
           </listitem>
@@ -134,6 +135,15 @@
 
         <programlisting>maintainers         jdoe \
                     example.org:julesverne</programlisting>
+
+        <note>
+          <para>The address <email>nomaintainer</email> designates a port that
+          is not maintained by anybody and may be modified by any committer.
+          Feel free to claim maintainership of a nomaintainer port if desired.
+          The address <email>openmaintainer</email> designates a port that has
+          a maintainer who allows minor changes to be committed without his or
+          her prior approval.</para>
+        </note>
       </listitem>
     </varlistentry>
 
@@ -182,4 +192,4 @@
       </listitem>
     </varlistentry>
   </variablelist>
-</section>
\ No newline at end of file
+</section>

Modified: trunk/doc-new/guide/xml/portfiledev.xml
===================================================================
--- trunk/doc-new/guide/xml/portfiledev.xml	2009-10-17 16:05:21 UTC (rev 59593)
+++ trunk/doc-new/guide/xml/portfiledev.xml	2009-10-17 16:24:35 UTC (rev 59594)
@@ -187,22 +187,18 @@
       <listitem>
         <para>Port maintainers</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). To hide these addresses
-        from spambots, see the more full explanation of the <link
-        linkend="reference.keywords.maintainers">maintainer keyword</link> in
+        <para>A port's maintainers are the people who have agreed to take
+        responsibility for keeping the port up-to-date. The
+        <literal>maintainers</literal> keyword lists the maintainers' email
+        addresses, preferrably in the obfuscated form which hides them
+        from spambots. For more, see the full explanation of the <link
+        linkend="reference.keywords.maintainers">maintainers keyword</link> in
         the <link linkend="reference.keywords">Global Keywords</link> section
         of the <link linkend="reference">Portfile Reference</link>
         chapter.</para>
 
-        <programlisting>maintainers         julesverne at example.org</programlisting>
-
-        <note>
-          <para>The address <email>nomaintainer at macports.org</email>, or in
-          hidden form <email>nomaintainer</email>, designates a port that may
-          be modified by any committer.</para>
-        </note>
+        <programlisting>maintainers         jdoe \
+                    example.org:julesverne</programlisting>
       </listitem>
 
       <listitem>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20091017/c9630a04/attachment.html>