forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r357259 - /forrest/trunk/site-author/content/xdocs/contrib.xml
Date Sat, 17 Dec 2005 00:16:02 GMT
Author: crossley
Date: Fri Dec 16 16:15:55 2005
New Revision: 357259

URL: http://svn.apache.org/viewcvs?rev=357259&view=rev
Log:
Update the notes on patch submission.
Techniques suggested by Richard Calmbach and Ross Gardler.

Modified:
    forrest/trunk/site-author/content/xdocs/contrib.xml

Modified: forrest/trunk/site-author/content/xdocs/contrib.xml
URL: http://svn.apache.org/viewcvs/forrest/trunk/site-author/content/xdocs/contrib.xml?rev=357259&r1=357258&r2=357259&view=diff
==============================================================================
--- forrest/trunk/site-author/content/xdocs/contrib.xml (original)
+++ forrest/trunk/site-author/content/xdocs/contrib.xml Fri Dec 16 16:15:55 2005
@@ -178,21 +178,35 @@
 
     <section id="patch">
      <title>How to prepare and contribute patches</title>
-     <p>If you use the current development version of Forrest, then do
+     <p>If you use the current development version of Forrest via Subversion,
+       then do
        '<code>svn update; svn status</code>' to see what files that you
        have changed.
        Do '<code>svn diff > mypatch.txt</code>' to make a patch which
        includes every change. To make a patch for a specific file, do
        <code>svn diff src/documentation/content/xdocs/faq.xml > faq.xml.diff</code>'.
+       It is better to prepare the patch from the $FORREST_HOME directory
+       so that it contains a definite path to the document. However, be careful
+       that the patch does not contain other work-in-progress.
+     </p>
+     <p>
        For more information about working with SVN, see
        <link href="http://svnbook.red-bean.com/">Version Control with
        Subversion</link> - the opensource SVN book.
-      </p>
-      <p>If you use a downloaded released version of Forrest, then do
-        '<code>diff -u faq.xml.orig faq.xml > faq.xml.diff</code>'
+     </p>
+     <p>
+       If you use a downloaded released version of Forrest (or don't use SVN),
+       then use the 'diff' command of your operating system:
+        '<code>diff -u faq.xml.orig faq.xml > mypatch.txt</code>' (better
+       to do that from $FORREST_HOME directory). If you want to use the most
+       recent version of the documentation then grab its source file directly
+       from the
+       <link href="http://svn.apache.org/repos/asf/forrest/trunk/site-author/content/xdocs/">SVN
server</link>
+       (and tell us which Revision number you used).
       </p>
       <note>Please send all contributions via our
         <link href="site:bugs">issue tracker</link>.
+       and specify the Forrest version or svn version of the source.
       </note>
       <p>
         It is always a good idea to check the Forrest



Mime
View raw message