| <sect1 id="repo-convs-layout"> |
| |
| <title>Repository Layout</title> |
| |
| <para> |
| &TCAR; is supported by <ulink |
| url="http://subversion.tigris.org/">Subversion</ulink>, a |
| version control system which allows you to keep old versions |
| of files and directories (usually source code), keep a log of |
| who, when, and why changes occurred, etc., like CVS, RCS or |
| SCCS. |
| </para> |
| |
| <para> |
| &TCAR; is made of one <quote>source repository</quote> and |
| many <quote>working copies</quote> of that source repository. |
| The working copies are independent one another, can be |
| distributed all around the world and provide a local place for |
| designers, documentors, translators and programmers to perform |
| their work in a descentralized way. The source repository, on |
| the other hand, provides a central place for all independent |
| working copies to interchange data and provides the |
| information required to permit extracting previous versions of |
| files at any time. |
| </para> |
| |
| <para> |
| The first level of directories in the repository provides |
| organization through a convenctional <quote>trunk</quote>, |
| <quote>branches</quote> and <quote>tags</quote> layout. In |
| this configuration the <filename |
| class="directory">trunk</filename> directory is where main |
| changes take place, the <filename |
| class="directory">tags</filename> directory is where frozen |
| copies of <filename class="directory">trunk</filename> changes |
| are placed in for releasing, and the <filename |
| class="directory">branches</filename> directory is an |
| intermediate place between <filename |
| class="directory">trunk</filename> and <filename |
| class="directory">tags</filename> states where changes take |
| place before being merged into <filename |
| class="directory">trunk</filename> and finally released into |
| <filename class="directory">tags</filename>. |
| </para> |
| |
| <para> |
| The second level of directories in the repository provides |
| organization for repository work lines, as described in <xref |
| linkend="repo-convs-worklines" />. |
| </para> |
| |
| <para> |
| All other subsequent levels of directories in the repository, |
| from third level on, are created to organize specific concepts |
| related to the work line they are in. |
| </para> |
| |
| </sect1> |