Exploring source code in Subversion

Help index
- Working with Subversion

When you begin work on a project, it's a good idea to learn how the project files are organized. Each project's web content files are located in the myproject/trunk/www directory by default. Other project source modules are created and organized by the project owner or project members with version control write permissions.

You will have occasion to use one or more of the following methods of exploring your project's source code in Subversion:

Click Subversion in the left navigation pane. In the Browse source code section of the Version control page, click around and familiarize yourself with the structure of the project's source repository.
When you click a file, you can view the revision history for that file. Selecting a revision number displays that revision of the file. Each revision includes a link to display differences between that revision and the previous one. A form at the bottom of the file revision history page allows you to display differences between arbitrary revisions.
Search for specific strings in log messages by clicking Advanced search in the left navigation bar and selecting Subversion revision properties under Project tools to search.
Search the commits@yourproject discussion. Whenever someone commits a change to code in your repository, an email is sent to commits@yourproject.domain. It is standard procedure to have the project members subscribe to this list to increase their awareness of each other's activities.

Repository structure

CollabNet creates an independent Subversion repository for each project. The default layout that follows standard Subversion practice. As with any Subversion repository, we recommend that your project store its main codebase in /trunk, and then use the svn copy command to copy the /trunk directory to the /branches and /tags area to create branches and tags.

      /branches/
            README

      /tags/
            README

      /trunk/
            www/
               cn-project-pages/
               index.html

      README

Note: The /trunk/www area is a special directory. Any commits to this area will cause an immediate update to the front page of your project.

If you started your project with a project template, the /trunk/www/cn-project-pages directory represents your project's main web site.
If you started your project without a project template, the /trunk/www/index.html file represents your project's main website.

Related information

Top | Help index