cvs: phpdoc /howto howto.ent working.xml
| From: | Dan Scott | Date: | Mon, 04 Apr 2005 18:19:34 +0000 |
| Subject: | cvs: phpdoc /howto howto.ent working.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969367404@lists.php.net to get a copy of this message | ||
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">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.51 $ -->
+<!-- $Revision: 1.52 $ -->
<refentry id="function.func-name">
<refnamediv>
<refname>func_name</refname>
@@ -653,7 +653,7 @@
<title>A <filename>reference.xml</filename> skeleton</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.51 $ -->
+<!-- $Revision: 1.52 $ -->
<reference id="ref.extname">
<title>Extname &Functions;</title>
<titleabbrev>Extname</titleabbrev>
@@ -720,7 +720,7 @@
<title>A <filename>configure.xml</filename> skeleton</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.51 $ -->
+<!-- $Revision: 1.52 $ -->
<section id="extname.installation">
&reftitle.install;
<para>
@@ -761,7 +761,7 @@
<title>A <filename>constants.xml</filename> skeleton</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.51 $ -->
+<!-- $Revision: 1.52 $ -->
<section id="extname.constants">
&reftitle.constants;
&extension.constants;
@@ -811,7 +811,7 @@
<title>A <filename>ini.xml</filename> skeleton</title>
<programlisting role="xml">
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.51 $ -->
+<!-- $Revision: 1.52 $ -->
<section id="extname.configuration">
&reftitle.runtime;
&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/">