Using Subversion on Unix

Some notes on using Subversion from the command line on Unix (including Linux) systems:

You don't need to do any extra work to access the repository when you're logged in on Io. Access to the repository is controlled in the same way as access to any other file. So if you can use TortoiseSVN to access a repository on Io remotely, you'll be able to access it when you log in to Io.
To check out the repository, use "cd" to go to the directory where you want the files placed (which could simply be your home directory) and type
```
        svn co file:///home/svn/respository
```
where repository is the name of your repository. Note you can type
```
        ls /home/svn
```
to see the full list of repositories.
To update and modify the repository, cd to the appropriate directory and type one or more of
- svn update
- svn add files
- svn commit
The svn commit command will start up an editor to enter your message; a useful option is -m. This allows you to set the comment for the revision directly:
```
        svn commit -m "reformatted code"
```
The quotes are required.
Other useful commands include
- svn help
  - lists all Subversion commands
- svn mv
  - rename a subversion file or move a file within subversion directories (within the same project)
- svn resolved file
  - mark conflicts in file as being resolved
You can create your own repository in your home directory. Type
```
        svnadmin create XYZ
```
to create a repository called XYZ in your current directory. Suppose your username is "tammy" and you want to create a repository named "homework" in in a subdirectory "etc"; then you'd type
1. cd
2. (if etc doesn't exist): mkdir etc
3. (to keep the repository hidden from others): chmod og-rwx etc
4. cd etc
5. svnadmin create homework
Note the chmod step might not be necessary depending on the permissions of your home directory.
To access a copy from your home directory:
1. cd
2. svn co file:///home/t/tammy/etc/homework
  (Note the /t is because tammy starts with a t; your home directory will be based on your username.)
3. chmod og-rwx homework
  (Just to make sure others can't access the files.)
To access it from some other computer, use the URL
```
        svn+ssh://tammy@io.uwplatt.edu/home/t/tammy/etc/homework
```
Others will not be able to access the repository unless you grant them access using chmod or access control lists. You can use access control lists (see the man pages on setfacl and getfacl) to share your repository with others. Note the user will need to have a login on Io; if they don't, contact the system administrators (currently hasker and scanlan). The system administrators can also set up groups to simplify access when warranted.