Last updated December 24, 2009 01:42, by Paul
[[Home|» Project Kenai Documentation and Training]] [[Howdoi|» How Do I ...]] [[SourceControl#About_Subversion|» Source Code Management]]
<h2>Using Subversion on Microsoft Windows Systems</h2>
Once you have a <a href="SourceControl#About_Subversion">Subversion client</a> installed on your local system, you can check out code and check it back into your project repository. For full instructions on using Subversion, see [http://svnbook.red-bean.com/]. <br/><br/>
__TOC__
===Using HTTPS With Command-Line Subversion===
The following instructions for https access using command-line Subversion should get you started.
# 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'' that has a repository named ''subversion'', the URL for the repository would look like this:<br/><tt><nowiki>https://kenai.com/svn/bluebird~subversion</nowiki></tt>
# Change directories to the location on your local machine where the repository will be checked out. For example:<br/><tt> > cd \myproj</tt>
# Check out the server repository into a new directory. In the following command, Subversion creates the <tt>bluebird-svn</tt> directory for you. <br/><tt> > svn co <nowiki>https://kenai.com/svn/bluebird~subversion</nowiki> bluebird-svn</tt><br/>'''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.
# Copy a file to the local directory and then add it in subversion.<br/><tt> > cp helloworld.java bluebird-svn</tt><br/><tt> > cd bluebird-svn</tt><br/><tt> > svn add helloworld.java</tt>
#You see the following acknowledgment, which means that the file has been added and is ready to be checked in:<br/><tt> A helloworld.java</tt>
# Update your local working copy (in case someone has checked files in while you were working):<br/><tt> > svn update</tt>
# Check the file into your project repository on the server:<br/><tt> > svn commit helloworld.java -m"First commit to bluebird repository"</tt>
# 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.
# When the system accepts your entries, you see the following responses for the initial <tt>helloworld.java</tt> checkin:<br/><tt> Adding helloworld.java</tt><br/><tt> Transmitting file data.</tt><br/><tt> Committed revision 1.</tt>
===Using SSH With Command-Line Subversion===
This section assumes you have set up an SSH key and you've configured Cygwin to use the key, as described on the following two pages:
* [[Winsshwithputty|Generating and Using an SSH Key on a Microsoft Windows Machine]]
* [[Usingsvn-winsshsetup|Setting Up Cygwin to Use SSH on a Microsoft Windows Machine]]
The following instructions for SSH access using command-line Subversion should get you started.
# 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'' that has a repository named ''subversion'', the URL for the repository would look like this:<br/> <tt><nowiki>svn+ssh://</nowiki></tt>''your-username''<tt>@svn.kenai.com/bluebird~subversion</tt>
# Run Cygwin. All the following commands would be entered in the Cygwin shell.
# Change directories to the location on your local machine where the repository will be checked out. For example:<br/><tt> > cd /myproj</tt>
# Check out the server repository into a new directory. In the following command, Subversion creates the <tt>bluebird-svn</tt> directory for you. <br/><tt> > svn co <nowiki>svn+ssh://</nowiki></tt>''your-username''<tt>@svn.kenai.com/bluebird~subversion bluebird-svn</tt><br/>'''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.
# Copy a file to the local directory and then add it in subversion.<br/><tt> > cp helloworld.java bluebird-svn</tt><br/><tt> > cd bluebird-svn</tt><br/><tt> > svn add helloworld.java</tt>
#You see the following acknowledgment, which means that the file has been added and is ready to be checked in:<br/><tt> A helloworld.java</tt>
# Update your local working copy (in case someone has checked files in while you were working):<br/><tt> > svn update</tt>
# Check the file into your project repository on the server:<br/><tt> > svn commit helloworld.java -m"First commit to bluebird repository"</tt>
# When the system accepts your entries, you see the following responses for the initial <tt>helloworld.java</tt> checkin:<br/><tt> Adding helloworld.java</tt><br/><tt> Transmitting file data.</tt><br/><tt> Committed revision 1.</tt>





