You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by sk...@apache.org on 2005/05/22 06:09:45 UTC
svn commit: r171280 -
/jakarta/commons/proper/commons-build/trunk/xdocs/svninfo.xml
Author: skitching
Date: Sat May 21 21:09:45 2005
New Revision: 171280
URL: http://svn.apache.org/viewcvs?rev=171280&view=rev
Log:
Information about accessing subversion.
Added:
jakarta/commons/proper/commons-build/trunk/xdocs/svninfo.xml
Added: jakarta/commons/proper/commons-build/trunk/xdocs/svninfo.xml
URL: http://svn.apache.org/viewcvs/jakarta/commons/proper/commons-build/trunk/xdocs/svninfo.xml?rev=171280&view=auto
==============================================================================
--- jakarta/commons/proper/commons-build/trunk/xdocs/svninfo.xml (added)
+++ jakarta/commons/proper/commons-build/trunk/xdocs/svninfo.xml Sat May 21 21:09:45 2005
@@ -0,0 +1,136 @@
+<?xml version="1.0"?>
+<!--
+Copyright 2005 The Apache Software Foundation
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+-->
+<document>
+
+ <properties>
+ <author email="commons-dev@jakarta.apache.org">The Jakarta Commons Documentation Team</author>
+ <title>Source Repositories</title>
+ </properties>
+
+<body>
+
+<section name="Download the Source">
+
+<p>
+Most users of the source code probably don't need to have day to
+day access to the source code as it changes. For these users we
+provide easy to unpack source code downloads. See the "download"
+link on the jakarta commons page.
+</p>
+
+</section>
+
+<section name="Access the Version Control System (quick info)">
+<p>
+Enter the following URL into a web browser to browse the latest source code,
+or pass that same url to a subversion client application to check the code out
+to your local machine, after replacing {component-name} with the appropriate
+value.
+<pre>
+ http://svn.apache.org/repos/asf/jakarta/commons/proper/{component-name}/trunk
+</pre>
+</p>
+<p>
+Alternatively, enter the following URL into a web browser to browse the latest
+source code including history and commit information. Note that despite the
+name "viewcvs" appearing in this link, the information <i>is</i> from the
+ASF Subversion repository.
+<pre>
+ http://svn.apache.org/viewcvs/jakarta/commons/proper/{component-name}/trunk
+</pre>
+</p>
+</section>
+
+<section name="Access the Version Control System (details)">
+<p>
+The root url of the ASF Subversion repository is <b>http://svn.apache.org/repos/asf/</b>
+for read-only access and <b>https://svn.apache.org/repos/asf/</b> for committers.
+</p>
+<p>
+The URLs for direct access to the commons section of that repository are:
+<ul>
+<li>
+ <a href="http://svn.apache.org/repos/asf/jakarta/commons">
+ http://svn.apache.org/repos/asf/jakarta/commons
+ </a>
+ for non-committers, and
+</li>
+<li>
+ <a href="https://svn.apache.org/repos/asf/jakarta/commons">
+ https://svn.apache.org/repos/asf/jakarta/commons
+ </a>
+ for committers.
+</li>
+</ul>
+</p>
+<p>
+The "proper" subdirectory leads to the code for official commons components.
+The "sandbox" subdirectory leads to the code for experimental commons components.
+</p>
+<p>
+Subdirectories "trunks-proper" and "trunks-sandbox" are special directories that
+should be ignored by most users; they have Subversion "external attributes"
+associated with them so that when checking out those directories using a subversion
+client application, the directory created actually contains the "trunk" directory
+of every commons or sandbox project. This is useful for special purposes such as
+building the commons website. Most users can ignore these directories and access
+the trunk of a project via the "proper" or "sandbox" directory.
+</p>
+<p>
+You can directly browse the <i>latest</i> version of ASF the code in Subversion by entering
+one of the above URLs into a standard web browser. Once you have found a directory of
+interest, you can pass the same URL to a subversion client in order to check
+out the files locally.
+</p>
+
+<p>
+As an alternative, you can browse the repository (including access to file history)
+via one of the links below. Once you have found a file or directory of
+interest, replace the url prefix "http://svn.apache.org/viewcvs" with the
+appropriate subversion root url (see above).
+<ul>
+<li><a href="http://svn.apache.org/viewcvs/jakarta/commons/proper">browse components via viewer</a></li>
+<li><a href="http://svn.apache.org/viewcvs/jakarta/commons/sandbox">browse sandbox via viewer</a></li>
+</ul>
+</p>
+
+<p><b>Important!</b> When checking out a directory in subversion, ensure that you
+do not check out one that has "tags" and "branches" subdirectories, as this will
+result in getting a complete copy of the code for every branch and tag ever made.
+If you want the latest code, you generally want the directory {component-name}/trunk,
+though you should check the project directory structure first via one of the methods
+listed above, as different projects may use different internal directory structures.</p>
+
+<p>
+For more information on connecting to the ASF Subversion repository, see the
+Subversion section of the
+<a href="http://www.apache.org/dev/version-control.html">
+ Jakarta version control page
+</a>.
+</p>
+
+</section>
+
+<section name="About Subversion">
+<p>
+Subversion is an open-source version control system designed to be "a better CVS".
+More information about subversion can be found at
+<a href="http://subversion.tigris.org/">the tigris subversion site</a>.
+</p>
+</section>
+
+</body>
+</document>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org