<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!-- Created by texi2html 1.76 -->
<!--
Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people <dev@texi2html.cvshome.org>
Send bugs and suggestions to <users@texi2html.cvshome.org>
-->
<head>
<title>Crystal Space 1.2.1: 7.4 SVN Etiquette Guidelines</title>
<meta name="description" content="Crystal Space 1.2.1: 7.4 SVN Etiquette Guidelines">
<meta name="keywords" content="Crystal Space 1.2.1: 7.4 SVN Etiquette Guidelines">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html 1.76">
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
pre.display {font-family: serif}
pre.format {font-family: serif}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: serif; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: serif; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.sansserif {font-family:sans-serif; font-weight:normal;}
ul.toc {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="SVN-Guide"></a>
<a name="0"></a>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="Coding-Style.html#0" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="Porting.html#0" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="Contributing.html#0" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="Contributing.html#0" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="Glossary.html#0" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="index.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="cs_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="cs_Index.html#0" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="cs_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<hr size="1">
<h2 class="section"> 7.4 <small>SVN</small> Etiquette Guidelines </h2>
<p>Since Crystal Space has enough developers to warrant the use of <small>SVN</small> to
manage its code base, there are some rules you need to keep in mind if you
are going to be making changes of any sort to the <small>SVN</small> source tree.
</p>
<p>The repository for Crystal Space is located at
<tt>‘https://svn.sourceforge.net/svnroot/crystal/CS’</tt>. The latest bleeding
edge version can be found in the <tt>‘trunk’</tt> subdirectory, assorted branches
in <tt>‘branches’</tt>.
</p>
<p>For further instructions, please refer to the following document:
</p>
<p><a href="http://sourceforge.net/svn/?group_id=649">http://sourceforge.net/svn/?group_id=649</a>
</p>
<p>Checkout the <tt>‘https://svn.sourceforge.net/svnroot/crystal/CS/trunk’</tt> to
download the source code. See the documentation for your <small>SVN</small> client on
how to do this.
</p>
<p>If you do not have a developer account, you will be able to check out files,
but will not be able to commit any changes.
</p>
<p>If you do have developer account, check out the source code as outlined above.
<small>SVN</small> will ask you for a password the first time you commit a change. You
need to specify your SourceForge username when first committing a change:
</p>
<table><tr><td> </td><td><pre class="example">svn ci --username <SF username>
</pre></td></tr></table>
<p>Having a developer account implies you will be able to make changes to the
code. You should read the rest of this document before making any changes.
</p>
<p>Below are some guidelines you should follow before committing files. Also be
sure to read the important portability guidelines in the <cite>Portability</cite>
section. See section <a href="Portability.html#0">Portability</a>.
</p>
<ol>
<li>
Always perform an <samp>‘update’</samp> before committing new or changed files, and
then rebuild <em>everything</em> from scratch after updating. <em>Do not rely
on dependencies!</em> If there were any conflicts during the update, resolve them.
If there were any merges, examine them to ensure that the merged code still
accurately reflects your changes.
</li><li>
If you worked on the engine internals or on the renderers, run <code>walktest</code>
using <tt>‘flarge’</tt> and visit various locations which exercise the engine's
features, such as the doughnut in the street and the foggy corridor.
</li><li>
If it works, commit <em>everything</em> you have modified, not just parts of
your modifications. If you have created new files, please be certain that you
have used the <small>SVN</small> <samp>‘add’</samp> command before committing in order to ensure
that the new files actually get added to the repository.
</li><li>
Do another <samp>‘update’</samp> after committing everything. Take a look at the
output to see if you really committed everything you intended to commit.
</li><li>
Do another rebuild to ensure your changes didn't collide with somebody else's
recent changes.
</li><li>
For large and important modifications, post a description of your changes to
the main mailing list, <a href="mailto:crystal-main@lists.sourceforge.net">crystal-main@lists.sourceforge.net</a>. This is
especially important if your changes may have affected other ports which must
be updated by other developers as a consequence.
</li></ol>
<p>This might look overdone to some people, but you should remember that we are
all working together with the same source. A bug in your code can cripple the
entire project.
</p>
<p>One final thing to remember is that you should <em>never</em> commit files that
you <em>know</em> will stop the progress of other developers. The <small>SVN</small>
repository is the place to commit completed code, not code that needs
debugging because you can't find a certain bug. Other developers should not
have to stop and track down your bugs just so they can proceed with their own
coding. When you've committed code, please monitor the mailing list regularly
for any signs that you've caused a problem somewhere. This is part of the
responsibility that goes with the ability to commit code.
</p>
<hr size="1">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="Coding-Style.html#0" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="Porting.html#0" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="Contributing.html#0" title="Beginning of this chapter or previous chapter"> << </a>]</td>
<td valign="middle" align="left">[<a href="Contributing.html#0" title="Up section"> Up </a>]</td>
<td valign="middle" align="left">[<a href="Glossary.html#0" title="Next chapter"> >> </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="index.html#SEC_Top" title="Cover (top) of document">Top</a>]</td>
<td valign="middle" align="left">[<a href="cs_toc.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="cs_Index.html#0" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="cs_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<p>
<font size="-1">
This document was generated using <a href="http://texi2html.cvshome.org/"><em>texi2html 1.76</em></a>.
</font>
<br>
</p>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
bad97183153701b09df5fae1052b1c30
>
files
>
4296
