| 1 |
<?php include 'HEADER.php'; ?> |
|---|
| 2 |
<!-- HEADER ends --> |
|---|
| 3 |
|
|---|
| 4 |
<h1><a href="/contribute.html">Contribute</a> - SVN</h1> |
|---|
| 5 |
<p>The Cherokee source code is available via SVN. Anyone can check out the sources via SVN, but only certain people have the ability to check in.</p> |
|---|
| 6 |
<p>Briefly, SVN is a system tool used to store and maintain files and a history of their changes over time. The Cherokee source code and related files are kept on a SVN server at cherokee-project.com. More on SVN at <a href="http://subversion.tigris.org/">subversion.tigris.org</a></p> |
|---|
| 7 |
|
|---|
| 8 |
<h2>Browsing the sources</h2> |
|---|
| 9 |
<p>Though SVN repositories are most commonly accessed using a special piece of software called a <a href="http://subversion.tigris.org">SVN client</a>, we also provide a web-based interface to view SVN repositories. Browsing the SVN tree gives you a great view into the current status of this project's code. You may also view the complete histories of any file in the repository.</p> |
|---|
| 10 |
<p>If all you need is to browse the sources, you can go to <a href="http://svn.cherokee-project.com/"> http://svn.cherokee-project.com/</a></p> |
|---|
| 11 |
|
|---|
| 12 |
<h2>Checking out the sources</h2> |
|---|
| 13 |
<p>To list the available modules, type:</p> |
|---|
| 14 |
<blockquote><pre class="shell">svn list svn://svn.cherokee-project.com/</pre></blockquote> |
|---|
| 15 |
<p>To check out the sources for the first time from the repository, use this command:</p> |
|---|
| 16 |
<blockquote><pre class="shell">svn co svn://svn.cherokee-project.com/cherokee/trunk cherokee</pre></blockquote> |
|---|
| 17 |
<h2>Updating the sources</h2> |
|---|
| 18 |
<p>To update your sources every day, you use this command:</p> |
|---|
| 19 |
<blockquote><pre class="shell">svn up cherokee</pre></blockquote> |
|---|
| 20 |
|
|---|
| 21 |
<h2>Ignoring directories or files</h2> |
|---|
| 22 |
<p>Subversion stores ignored files per directory. To edit the ignored files of the directory you are currently in, do</p> |
|---|
| 23 |
<blockquote><pre class="shell">svn propedit svn:ignore .</pre></blockquote> |
|---|
| 24 |
<p>that will launch your editor, write there the names of the files you want to ignore, one file per line. Once you are done, do a commit so the ignored list file gets updated on the server.</p> |
|---|
| 25 |
<p>You can also list the properties:</p> |
|---|
| 26 |
<blockquote><pre class="shell">svn proplist .</pre></blockquote> |
|---|
| 27 |
|
|---|
| 28 |
<h2>Write Access</h2> |
|---|
| 29 |
<p>If you have write access in the Cherokee SVN repository I assume you know how to use it properly. If not, <a href="http://svnbook.red-bean.com/" target="_self">read this book</a>.</p> |
|---|
| 30 |
<h2>Subversion Commits Mailing List</h2> |
|---|
| 31 |
<p>We also have a mailing list set up that will notify you when new commits are made. Join cherokee-commits@cherokee-project.com by entering your email address at the <a href="http://www.cherokee-project.com/cgi-bin/mailman/listinfo/cherokee-commits">subscription page</a>. Then you'll know when to update.</p> |
|---|
| 32 |
|
|---|
| 33 |
<!-- FOOTER begins --> |
|---|
| 34 |
<?php include 'FOOTER.php'; ?> |
|---|
| 35 |
|
|---|