@@ -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@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> doc-new/guide/xml/portfile-keywords.xml @@ -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@example.org</programlisting> - - <note> - <para>The address <email>nomaintainer@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> doc-new/guide/xml/portfiledev.xml 5e5db48bcfc9b9b81b4a122a50f6bd51f38724a8 Ryan Schmidt ryandesign@macports.org http://github.com/kballard/macports/commit/4fe5110c1176140c05db33c3b7aa0e579f07c894 4fe5110c1176140c05db33c3b7aa0e579f07c894 2009-10-17T09:24:35-07:00 2009-10-17T09:24:35-07:00 Update, clarify and correct some "maintainers" stuff. git-svn-id: http://svn.macports.org/repository/macports/trunk@59594 d073be05-634f-4543-b044-5fe20cf6d1d6 3ef1d65d22d3004509df73e655c27853ef08817c Ryan Schmidt ryandesign@macports.org