[PHP-DOC] cvs: phpdoc /howto howto.ent working.xml

[Dan Scott]

dbs             Mon Apr  4 14:19:34 2005 EDT

  Modified files:              
    /phpdoc/howto       working.xml howto.ent 
  Log:
  Add links to useful note-editing resources.
  
  
http://cvs.php.net/diff.php/phpdoc/howto/working.xml?r1=1.51&r2=1.52&ty=u
Index: phpdoc/howto/working.xml
diff -u phpdoc/howto/working.xml:1.51 phpdoc/howto/working.xml:1.52
--- phpdoc/howto/working.xml:1.51       Sun Apr  3 08:22:56 2005
+++ phpdoc/howto/working.xml    Mon Apr  4 14:19:33 2005
@@ -494,7 +494,7 @@
     <title>A function skeleton (<filename>func-name.xml</filename>)</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.51 $ --&gt;
+&lt;!-- $Revision: 1.52 $ --&gt;
 &lt;refentry id="function.func-name"&gt;
  &lt;refnamediv&gt;
   &lt;refname&gt;func_name&lt;/refname&gt;
@@ -653,7 +653,7 @@
     <title>A <filename>reference.xml</filename> skeleton</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.51 $ --&gt;
+&lt;!-- $Revision: 1.52 $ --&gt;
 &lt;reference id="ref.extname"&gt;
  &lt;title&gt;Extname &amp;Functions;&lt;/title&gt;
  &lt;titleabbrev&gt;Extname&lt;/titleabbrev&gt;
@@ -720,7 +720,7 @@
     <title>A <filename>configure.xml</filename> skeleton</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.51 $ --&gt;
+&lt;!-- $Revision: 1.52 $ --&gt;
 &lt;section id="extname.installation"&gt;
  &amp;reftitle.install;
  &lt;para&gt;
@@ -761,7 +761,7 @@
     <title>A <filename>constants.xml</filename> skeleton</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.51 $ --&gt;
+&lt;!-- $Revision: 1.52 $ --&gt;
 &lt;section id="extname.constants"&gt;
  &amp;reftitle.constants;
  &amp;extension.constants;
@@ -811,7 +811,7 @@
     <title>A <filename>ini.xml</filename> skeleton</title>
     <programlisting role="xml">
 &lt;?xml version="1.0" encoding="iso-8859-1"?&gt;
-&lt;!-- $Revision: 1.51 $ --&gt;
+&lt;!-- $Revision: 1.52 $ --&gt;
 &lt;section id="extname.configuration"&gt;
  &amp;reftitle.runtime;
  &amp;extension.runtime;
@@ -1537,14 +1537,14 @@
   <para>
    There is also a list named <literal>doc-license</literal>, which is
    set up for those who would like to get involved in the process of
-   deciding who can do what with the PHP manual. The common rule is that
-   additionaly to the rules set forth in the license, we try to get people
-   publishing modified versions of the manual to put back some improvements
+   deciding who can do what with the PHP manual. The common rule is that,
+   in addition to the rules set forth in the license, we try to get people
+   publishing modified versions of the manual to contribute some improvements
    into the manual, fix errors they find, etc. You can subscribe to this
-   list with the usual way (you can find out from the info above).
+   list as described at <xref linkend="chapter-maillist"/>.
   </para>
   <para>
-   Finnaly, the doc.php.net site is forming on the <literal>doc-web</literal>
+   Finally, the doc.php.net site is forming on the <literal>doc-web</literal>
    mailing list. This site is supposed to be the meeting point for 
documentation
    authors of any of the projects developed on PHP.net.
   </para>
@@ -1892,6 +1892,31 @@
    These are some guidelines to follow when editing user notes in the manual.
   </para>
   <para>
+   To begin editing user notes in the manual, you must have CVS commit access
+   to the manual, and you must either:
+   <itemizedlist>
+    <listitem>
+     <para>
+      Subscribe to the <literal>php-notes</literal> mailing list or newsgroup
+      as described at <xref linkend="chapter-maillist"/>. As a user submits a
+      new user note, it will appear as a message on the mailing list with
+      links in the footer of the email that enable you to delete, edit, or
+      reject that particular note.
+     </para>
+    </listitem>
+    <listitem>
+     <para>
+      Log on to the server at
+      <ulink url='&url.notes.admin;'>&url.notes.admin;</ulink> using your
+      CVS user ID and password. The user notes administration interface
+      enables you to search for user notes that match particular strings
+      and edit or change the status of particular notes directly through the
+      Web interface.
+     </para>
+    </listitem>
+   </itemizedlist>
+  </para>
+  <para>
    The thing that seems to confuse the most people is the difference between
    'rejecting' and 'deleting' a note.  Basically, they both remove the note
    from the manual, but 'rejecting' sends the user an email about the rejection
http://cvs.php.net/diff.php/phpdoc/howto/howto.ent?r1=1.27&r2=1.28&ty=u
Index: phpdoc/howto/howto.ent
diff -u phpdoc/howto/howto.ent:1.27 phpdoc/howto/howto.ent:1.28
--- phpdoc/howto/howto.ent:1.27 Sun Apr  3 08:22:56 2005
+++ phpdoc/howto/howto.ent      Mon Apr  4 14:19:34 2005
@@ -91,6 +91,7 @@
 <!ENTITY url.status.hu       "http://toye.php.net/~rasmus/status.php?l=hu";>
 <!ENTITY url.revcheck.it     "http://www.php.net/it/rev";>
 <!ENTITY url.user-notes      
"http://cvs.php.net/co.php/php-master-web/manage/user-notes.php";>
+<!ENTITY url.notes.admin     "http://master.php.net/manage/user-notes.php";>
 
 <!-- For Misc section -->
 <!ENTITY url.rtfs           "http://www.fooassociates.com/rtfs/";>