» Project Kenai Documentation and Training    » How Do I ...    » Source Code Management

Using Subversion on UNIX and Mac Systems

Once you have a Subversion client installed on your local system, you can check out code and check it back into your project repository. You can use either standard command-line Subversion and https, or you can use SSH for faster and more secure access to the repository. For full instructions on using Subversion, see http://svnbook.red-bean.com/.

Using HTTPS With Command-Line Subversion

The following instructions for command-line Subversion should get you started with https access.

1. To check out the source code for a project, you need to know the name of the project and the name of the source repository. For example, for a project named bluebird with a repository named subversion, the URL for HTTPS access to the repository would look like this:
   https://kenai.com/svn/bluebird~subversion
2. Change directories to the location on your local machine where the repository will be checked out. For example:
    > cd ~
3. Check out the server repository into a new directory. In the following command, Subversion creates the bluebird-svn directory for you.
    > svn co https://kenai.com/svn/bluebird~subversion bluebird-svn
   Note: Checking out the source for a project by using a URL like the one above pulls down all the branches and tags, in addition to the trunk code. If there's already code in the repository, you might want to specify a subdirectory to select just the trunk or a branch or tag.
4. Copy a file to the local directory and then add it in subversion.
    > cp helloworld.java bluebird-svn
    > cd bluebird-svn
    > svn add helloworld.java
   
   You see the following acknowledgment, which means that the file has been added and is ready to be checked in:
    A         helloworld.java
5. Update your local working copy (in case someone has checked files in while you were working):
    > svn update
6. Check the file into your project repository on the server:
    > svn commit helloworld.java -m"First commit to bluebird repository"
7. When prompted for your password, enter your project password. If the userid doesn't match your password, you're prompted for the project userid and then the password.
8. When the system accepts your entries, you see the following responses for the initial helloworld.java checkin:
    Adding         helloworld.java
    Transmitting file data.
    Committed revision 1.

Using SSH With Command-Line Subversion

1. Before using SSH with Project Kenai, you have to generate an SSH key pair and save the public key to the SSH Keys tab in your user profile. For more information on generating SSH keys, see Generating an SSH Key.
2. To check out the source code for a project, you need to know the name of the project and the name of the source repository. For example, for a project named bluebird with a repository named subversion, the URL for SSH access to the repository would look like this:
    svn+ssh://your-username@svn.kenai.com/bluebird~subversion
3. Change directories to the location on your local machine where the repository will be checked out. For example:
    > cd ~
4. Check out the server repository into a new directory. In the following command, Subversion creates the bluebird-svn directory for you.
    > svn co svn+ssh://your-username@svn.kenai.com/bluebird~subversion bluebird-svn
   Note: Checking out the source for a project by using a URL like the one above pulls down all the branches and tags, in addition to the trunk code. If there's already code in the repository, you might want to specify a subdirectory to select just the trunk or a branch or tag.
5. Copy a file to the local directory and then add it in subversion.
    > cp helloworld.java bluebird-svn
    > cd bluebird-svn
    > svn add helloworld.java
   
   You see the following acknowledgment, which means that the file has been added and is ready to be checked in:
    A         helloworld.java
6. Update your local working copy (in case someone has checked files in while you were working):
    > svn update
7. Check the file into your project repository on the server:
    > svn commit helloworld.java -m"First commit to bluebird repository"
8. When the system accepts your entries, you see the following responses for the initial helloworld.java checkin:
    Adding         helloworld.java
    Transmitting file data.
    Committed revision 1.