Project setup with SVN

Changelogic
Svn Project Setup

One of the most popular SVN repository layout schemes is the one where the working code is stored in project subdirectory named “trunk”, and branches and tags are represented as copies of it or each other under subdirectories “branches” and “tags”, respectively:
svn://<host>/</p><project>/trunk
svn://<host>/<project>/branches
svn://<host>/<project>/tags

SVN adheres to this scheme well. The important distinction is that the working code is not stored under the subdirectory “trunk”, but under the special branch “latest” under the branches subdirectory:
svn://<host>/</p><project>/branches/latest

Remember, it's all about conventions, there is no physical distincion between branches and tags in Subversion.

Existing code with compatible repository layout

1. Assuming You have the latest code under subdirectory “trunk”, create the special branch “latest”:

svn copy -m “Creating branch latest” svn://<host>/<project>/trunk svn://<host>/<project>/branches/latest

2. Checkout the newly-created branch, add Changelogic supporting files to it, and commit.

svn checkout svn://<host>/<project>/branches/latest <project>
cd <project>
Download changelogic-build.xml, changelogic-project.properties and changelogic-personal.properties from Supporting files, and adjust them as needed. Then add changelogic-build.xml and changelogic-project.properties. Do not add changelogic-personal.properties – this file has to be local for every developer. If your project doesn't have build.xml by default, add this file also to the repository.
svn add changelogic-build.xml changelogic-project.properties
svn commit -m “Added supporting files”
cd ..

3. Create the base version tag “ver-1_1_1_0”:

svn copy -m “Creating base version tag” svn://<host>/<project>/branches/latest svn://<host>/<project>/tags/ver-1_1_1_0

4. Create empty tag. Changelogic will look for this when diff calculations involve non-existent left-hand sides:

svn mkdir -m “Creating empty tag” svn://<host>/<project>/tags/empty

To verify the correctness of setup, You may check out the contents of tag “ver-1_1_1_0” and see if the Supporting files are there.

Existing code with incompatible repository layout, or with no layout at all

1. Create the project directory, and the subdirectories “branches” and “tags”:

svn mkdir -m “Creating project directory” svn://<host>/<project>
svn mkdir -m “Creating branches subdirectory” svn://<host>/<project>/branches
svn mkdir -m “Creating tags subdirectory” svn://<host>/<project>/tags

2. Create the special branch “latest”, and get Your working code into it:

svn mkdir -m"Creating branch latest" svn://<host>/<project>/branches/latest
cd <path to local project directory>
svn import -m “Populating branch latest” ./ svn://<host>/<project>/branches/latest

3. Follow the steps from 2 to 4 from the section above.