[28035] trunk/doc/guide/new/xml/portfiledev.xml

[source_changes at macosforge.org]

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

Log Message:
-----------
Remove the redundant explanation of maintainer email address hiding; the explanation
is in the Portfile Reference section where it is more appropriate, so just refer to it.

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

Modified: trunk/doc/guide/new/xml/portfiledev.xml
===================================================================
--- trunk/doc/guide/new/xml/portfiledev.xml	2007-08-18 20:24:33 UTC (rev 28034)
+++ trunk/doc/guide/new/xml/portfiledev.xml	2007-08-18 20:27:14 UTC (rev 28035)
@@ -96,7 +96,7 @@
         <para>Insert a URL pointing to the local repository location before
         the rsync URL as shown.</para>
 
-        <programlisting>file:///Users/joebob/ports
+        <programlisting>file:///Users/julesverne/ports
 rsync://rsync.macports.org/release/ports
 </programlisting>
 
@@ -115,7 +115,7 @@
         inside a directory that reflect the port's primary category (the first
         category entry in the <filename>Portfile</filename>).</para>
 
-        <programlisting><prompt>%%</prompt> <userinput>cd /Users/joebob</userinput>
+        <programlisting><prompt>%%</prompt> <userinput>cd /Users/julesverne</userinput>
 <prompt>%%</prompt> <userinput>mkdir -p ports/games/bestevergame</userinput>
 <prompt>%%</prompt> <userinput>cd ports/games/bestevergame</userinput>
 <prompt>%%</prompt> <userinput>touch Portfile</userinput></programlisting>
@@ -127,10 +127,10 @@
         repository's directory to install it into the
         <filename>Portindex</filename>.</para>
 
-        <programlisting>%% <userinput>cd /Users/joebob/ports</userinput>
+        <programlisting>%% <userinput>cd /Users/julesverne/ports</userinput>
 %% <userinput>portindex</userinput></programlisting>
 
-        <screen>Creating software index in /Users/joebob/ports
+        <screen>Creating software index in /Users/julesverne/ports
 Adding port games/bestevergame
 
 Total number of ports parsed:   1 
@@ -201,32 +201,14 @@
       <listitem>
         <para>Port maintainers</para>
 
-        <para>A port's maintainer is a person who takes responsibility for
-        keeping the port up-to-date. 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). To hide these addresses
+        from spambots, see the more full explanation of the maintainer keyword
+        in the Portfile Reference section.</para>
 
-        <itemizedlist>
-          <listitem>
-            <para>For addresses in domain @macports.org, simply omit the
-            domain name.</para>
-          </listitem>
+        <programlisting>maintainers       julesverne at somedomain.org</programlisting>
 
-          <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>
-
         <note>
           <para>The address <email>nomaintainer at macports.org</email>
           designates a port that may be modified by any committer.</para>
@@ -310,7 +292,7 @@
 name                    rrdtool
 version                 1.2.23
 categories              net
-maintainers             joebob
+maintainers             julesverne
 description             Round Robin Database
 long_description        RRDtool is a system to store and display time-series data
 homepage                http://people.ee.ethz.ch/~oetiker/webtools/rrdtool/

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