crossley 02/01/30 06:19:13
Modified: src/documentation/xdocs contrib.xml
Log:
Clarify patch submission procedure. Better URL for OpenSP validating parser.
Revision Changes Path
1.3 +6 -5 xml-cocoon2/src/documentation/xdocs/contrib.xml
Index: contrib.xml
===================================================================
RCS file: /home/cvs/xml-cocoon2/src/documentation/xdocs/contrib.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- contrib.xml 20 Jan 2002 23:59:38 -0000 1.2
+++ contrib.xml 30 Jan 2002 14:19:13 -0000 1.3
@@ -360,8 +360,9 @@
<p>
When you are sure about your proposed patch, then please submit it
via Bugzilla, rather than as email to <code>cocoon-dev</code>.
- Be sure to add [Patch] to the summary line, as this enables the automatic
- patch alert system to keep track of it.
+ Be sure to add [PATCH] to the summary line, as this enables the automatic
+ patch alert system to keep track of it. If you do not follow this procedure,
+ then unfortunately your patch may be over-looked.
</p>
<p>
@@ -409,7 +410,7 @@
</li>
<li>
Prepend your email subject line with a marker when that is appropriate,
- e.g. <code>[Patch]</code>, <code>[Proposal]</code>,
+ e.g. <code>[Vote]</code>, <code>[Proposal]</code>,
<code>[RT]</code> (Random Thought which quickly blossom into research
topics :-), <code>[STATUS]</code> (development status of a certain
facility).
@@ -419,11 +420,11 @@
matter, use a
<link href="http://www.oasis-open.org/cover/";>validating parser</link>
(one that is tried and true is
- <link href="http://www.jclark.com/sp/";>SP/nsgmls</link>).
+ <link href="http://openjade.sourceforge.net/";>OpenSP/onsgmls</link>).
This procedure will detect errors without having to go through the whole
<code>build docs</code> process to find them. Do not expect Cocoon
or the build system to detect the validation errors for you - they can
- do it, but that is not their purpose. (Anyway, nsgmls validation error
+ do it, but that is not their purpose. (Anyway, onsgmls validation error
messages are more informative.)
</li>
<li>
----------------------------------------------------------------------
In case of troubles, e-mail: [EMAIL PROTECTED]
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
