SVN (Subversion)

SVN (Subversion)

The SVN integration included in GForge AS allows for full integration with GForge, including: creating blank repositories when a Project is created; adding users and groups to the SVN repository so the users can commit changes to code; enforcing the requirement of a Tracker Item ID on commit if chosen by the Project Administrator; linking commits to Tracker Items, so the changed files and other commit information displays on the Commits tab of the Tracker Item; emailing differences of commits to the commits mailing list if the Project Administrator chooses; and displaying commits on the Activity Report for the Project.

The SVN tab displays files, directories, and revisions that currently exist in the repository.

Access Info Directions to checkout files with command line instructions.

Browse This page displays the web interface for SVN. GForge can automatically create blank repositories for projects that choose to use SVN, or administrators can create an external repository and link it to GForge using the external SCM scripts provided. You can browse the repository to make quick references to the code without opening another application.

Statistics History detailing the number of commits and files added to the repository.

SVN Reference Click to display the SVN user manual

Index of Shows the directory in the repository that you are viewing.

Files Shown Number of files in the Index.

Directory Revision The current revision number.

Sticky Revision You can browse the contents of a repository at a point in its past history by choosing a Sticky Revision from the forms at the top of directory and log pages. When set, directory and log pages only show revisions preceding the specified point in history.

Set Commits the new revision number to the database.

File Name of the file.

Rev Version of the file.

Age Age of the file.

Author User that created the file.

Last Log Entry Last time the file was updated.

Access Info

Click the Access Info to display access information to use the repository.


Browsing the SVN Repository

This page displays the web interface for SVN repositories. GForge administrators create Projects and (SVN) repositories. You can browse the repository to make quick references to the code without opening another application.

Browsing the SVN tree provides a view into the current status of this Project’s code. You may also view the complete histories of any file in the repository.

To browse the SVN repository:

  1. Navigate to the Project that contains the code you desire to browse.
  2. Click the SVN tab.
  3. Click the Browse link.
  4. Click the File name.


Statistics

Statistics displays information about the SVN of this Project.


User Developer that the Statistic is about.

Adds Number of times the developer added to the SCM.

Commits Number of commits by the user.

Linking a Commit to a Tracker Item

Commits can be linked to a Tracker Item by referencing the Tracker Item ID in the commit message. For example, this command will link your changes to Tracker Item #1000:

svn commit -m "[#1000] linking this change to defect"

Click the Commits tab in the Tracker Item view the changed files.

 Linking a Commit to other Plugin Items

Commits also can be linked to Documents, Releases and Wiki Pages by referencing the id in the commit message preceded by any of the following section modificators

  • Documents: d
  • Release items: r
  • Wiki Pages: w

For example: svn commit -m "[#d1000] linking this change to document"

Click the Associations tab in the Document view to see the references.