You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by rb...@apache.org on 2012/04/14 19:59:32 UTC
svn commit: r1326165 - /httpd/site/trunk/xdocs/docs-project/svn.xml

Author: rbowen
Date: Sat Apr 14 17:59:31 2012
New Revision: 1326165

URL: http://svn.apache.org/viewvc?rev=1326165&view=rev
Log:
Oops. This needs to be in svn.

Added:
    httpd/site/trunk/xdocs/docs-project/svn.xml

Added: httpd/site/trunk/xdocs/docs-project/svn.xml
URL: http://svn.apache.org/viewvc/httpd/site/trunk/xdocs/docs-project/svn.xml?rev=1326165&view=auto
==============================================================================
--- httpd/site/trunk/xdocs/docs-project/svn.xml (added)
+++ httpd/site/trunk/xdocs/docs-project/svn.xml [utf-8] Sat Apr 14 17:59:31 2012
@@ -0,0 +1,69 @@
+<?xml version="1.0"?>
+<document>
+  <properties>
+    <title>Documentation Project: Subversion</title>
+  </properties>
+<body>
+<section>
+<title>Documentation Project: Subversion</title>
+
+<p>The documentation of the Apache HTTP Server is in the same Subversion
+revision control repository as the code. If you wish to work on the
+documentation, you can check out the entire source code repository, or
+just the documentation.</p>
+
+<p>To check out the entire repository, you'll do the following:</p>
+
+<example>
+svn checkout https://svn.apache.org/repos/asf/httpd/httpd/trunk httpd-trunk<br/>
+svn checkout https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x httpd-2.4
+</example>
+
+<p>By checking out both trunk and 2.4, you'll be able to submit patches
+against both the development version, and the current latest released
+version.</p>
+
+<p>To check out just the documentation portion of the repository, append
+'<code>/docs</code>' to the end of the checkout URLs shown above. This
+will give you a much smaller checkout, but perhaps you'll lack some of
+the resources you might need to verify your documenation changes.</p>
+
+</section>
+
+<section>
+<title>Creating a patch</title>
+
+<p>Once you have a checkout, creating a patch takes three steps.</p>
+
+<ol>
+<li><p>Edit the file that you wish to modify. Make the desired changes,
+and then save your changes.</p></li>
+<li><p>At the command line, type the following to create a patch
+file:</p>
+<example>
+svn diff &gt; patch.txt
+</example>
+</li>
+<li><p>Send email to the <code>docs@httpd.apache.org</code> mailing list
+and attach <code>patch.txt</code>.</p></li>
+</ol>
+
+<p>If you have more than one changed file, you can supply the file name
+on the <code>svn diff</code> command line, in order to just record the
+changes in one file.</p>
+
+<example>
+svn diff mod_rewrite.xml &gt; mod_rewrite_patch.txt
+</example>
+
+</section>
+
+<section><title>See Also</title>
+
+<p>See also the document on <a href="docsformat.html">documentation
+format and transformation</a> for details about verifying that your
+changes are complient with our documentation format and standards.</p>
+</section>
+
+</body>
+</document>