Changeset 59594


Ignore:
Timestamp:
Oct 17, 2009, 4:24:35 PM (10 years ago)
Author:
ryandesign@…
Message:

Update, clarify and correct some "maintainers" stuff.

Location:
trunk/doc-new/guide/xml
Files:
2 edited

Legend:

Unmodified
Added
Removed
  • trunk/doc-new/guide/xml/portfile-keywords.xml

    r32717 r59594  
    109109
    110110      <listitem>
    111         <para>A port's maintainer is a person or persons who take
    112         responsibility for keeping the port up-to-date, and the maintainer
    113         keyword lists maintainer email addresses(s). However, many maintainers
    114         wish to hide these addresses from spambots; to do so follow these
    115         conventions:</para>
     111        <para>A port's maintainers are the people who have agreed to take
     112        responsibility for keeping the port up-to-date. Most ports have only a
     113        single maintainer, but some ports have two or more comaintainers. The
     114        <literal>maintainers</literal> keyword lists the maintainers' email
     115        addresses, preferrably in the obfuscated form which hides them
     116        from spambots:</para>
    116117
    117118        <itemizedlist>
     
    122123
    123124          <listitem>
    124             <para>For addresses in other domains, say
     125            <para>For addresses in other domains, e.g.
    125126            <email>account@example.org</email>, use the convention
    126127            example.org:account to specify the address.</para>
     
    135136        <programlisting>maintainers         jdoe \
    136137                    example.org:julesverne</programlisting>
     138
     139        <note>
     140          <para>The address <email>nomaintainer</email> designates a port that
     141          is not maintained by anybody and may be modified by any committer.
     142          Feel free to claim maintainership of a nomaintainer port if desired.
     143          The address <email>openmaintainer</email> designates a port that has
     144          a maintainer who allows minor changes to be committed without his or
     145          her prior approval.</para>
     146        </note>
    137147      </listitem>
    138148    </varlistentry>
  • trunk/doc-new/guide/xml/portfiledev.xml

    r59593 r59594  
    188188        <para>Port maintainers</para>
    189189
    190         <para>A port's maintainer is a person or persons who take
    191         responsibility for keeping the port up-to-date, and the maintainer
    192         keyword lists maintainer email addresses(s). To hide these addresses
    193         from spambots, see the more full explanation of the <link
    194         linkend="reference.keywords.maintainers">maintainer keyword</link> in
     190        <para>A port's maintainers are the people who have agreed to take
     191        responsibility for keeping the port up-to-date. The
     192        <literal>maintainers</literal> keyword lists the maintainers' email
     193        addresses, preferrably in the obfuscated form which hides them
     194        from spambots. For more, see the full explanation of the <link
     195        linkend="reference.keywords.maintainers">maintainers keyword</link> in
    195196        the <link linkend="reference.keywords">Global Keywords</link> section
    196197        of the <link linkend="reference">Portfile Reference</link>
    197198        chapter.</para>
    198199
    199         <programlisting>maintainers         julesverne@example.org</programlisting>
    200 
    201         <note>
    202           <para>The address <email>nomaintainer@macports.org</email>, or in
    203           hidden form <email>nomaintainer</email>, designates a port that may
    204           be modified by any committer.</para>
    205         </note>
     200        <programlisting>maintainers         jdoe \
     201                    example.org:julesverne</programlisting>
    206202      </listitem>
    207203
Note: See TracChangeset for help on using the changeset viewer.