April 17th, 2007 mysurface
The aim of this tutorial is to guide beginners for using svn command linewith simple examples.
- Aug 08, 2012.
- Download the SVN tools and setup a server yourself. This is the traditional way to get started as the server is run on your own machine. However, managing this yourself can become difficult and risk-prone, especially should you wish to start granting other people access to collaborate in your SVN repository.
This post is not going to focus on svn installation, as the installation isavailable anywhere, let me list some links for you in case you are actuallylooking for installation.
Subversion Installation References
Installing Subversion (svn) on Linux (Debian Stable) Setting up Subversion and websvn on Debian How To Configure Web Access To Subversion Repositories Using Apache Install SVN with Web Access on Ubuntu
If you are looking for svn reference in man pages, you have gone to thewrong place. To check the references of svn commands, simple do this:
This will make svn list all the available functions, to get the functionreference, let say checkout
The same thing goes to other svn related commands, such as svnadmin
When using something like TortoiseSVN, you can use it's repo-browser to browse repositories and do stuff. One thing you can do is create directories in the repository. Normally you would have to checkout the repo, then create and add the directories and finally commit them to accomplish this.
First of all what is repository? It is a core file for svn, or you can callit a centralized svn backup database. After created it, it is just adirectory with its files. IMPORTANT! Do NOT try to modify or add somethinginto the repository, unless you know what are you doing.
To create a svn repo, let say I wanna create a repo to store all myprogramming codes, I do this
Remember try to use absolute path for everything, sometimes the relativepath is not going to work.
How to import my existing directories into the new repo?
-m stand for log message, the first revision was created with log as 'Initial import'. You need to specified URL for the repo, URL is the standard argument for svn. Therefore for local file, you need to specified with file://
Another way of listing all the files and folder in the tree view, I use svnlook
The difference between svn list and svnlook tree is one expect URL anotherone do not.
Tortoisesvn Repo Browser
Part 2 will covers how to checkout, track changes, commit, add or deletefiles and message logs.
This is the most critical part of svn and also the most common part of svncommand line. A lots of open source development projects provided the wayfor user to check out their latest code through the internet.
You need to check out in order to commit the changes to svn repolater. Refers back to the previous post, where I import entire directory/home/mysurface/programming to programming_repo. I am going to checkout tothe same folder. If you are skeptical of doing this, you may want to backupthe directory first.
Now checkout to programming, mkdir is not needed, as svn will create thedirectory for you if it is doesn't exist.
co is the shortform of checkout.
Svn Browser Windows
Okay, lets just compare both folder with diff and store the result into afile comp.diff
Diff will list the folder in common, and also the differences. Checkcomp.diff, as it tracks the additional folder .svn that only exist inprogramming/. Again, do NOT modified or delete this folder.
Are you convinced to remove your programming-bk/ ? Make sure you keep therepo safe and you can check out the same data anytime, at any place.
You can even checkout only a specific folder from your repo. e.g.
This will only check out a folder at current directory.
Single file can't be checkout like directories, but you can extract themfrom repository by svn export
Svn Web Browser
First of all, you track what files had changed,
It will list files which have changed, with some attributes besides thefilename. Common attributes are M, ?, A … M is modified, A is newly added(how to add refers later section), ? indicate the file is added into localdirectory but not added into repo.
Secondly, you want to track the differences between the previous revisionand the working one. Lets assume color.c has changed,
I really don't like svn diff 's result. Fortunately, I found a simple bashscript what makes vimdiff as the compare tool. The script was written byErik C. Thauvin, you can get it from here.http://vc.thauvin.net/svn/linux/svndiff/svndiff.sh?view=markup
I name it as svndiff and place it at /usr/bin, change the mode to executable.
Now, I can simply do this,
To close the vimdiff, type :qa
You can commit with -m to place your log message if it is short. But if itis long, I suggest you to make use of your default editor. I am a vim user,therefore I add a line into my ~/.bashrc
Now I can commit with this:
ci is the shortform of checkin as in 'check in', or commit. Write the logmessage and close save vim :x , I am done. The same way as checkout, you canchoose to commit one file or any folder.
The file won't be committed if you don't add it into repo. Therefore youneed to add it manually if you want it to goes into your repo. Let say youwanna add a new file color2.cc
Delete does the same way, if you only delete file at your working directory,it won't reflects the changes to our repo.
The simplest way is doing just,
It will list all logs, start from latest revision. That is reallyirritating! You can limit it to 3 latest revision log by doing this
If you wanna check for specific revision, specified with -r,
I find something awkward, let say I have done svn delete at revision 3(latest), and revision 2 is the changes of the deleted file at revision3. When I do svn log, by right it should show all 3 logs, but It only showsfor revision 1. It means the svn log will only shows the log if the file isexist, bear in mind.
How to update the working directory into the latest revision?
Update to specific revision?
I think thats all for normal use of svn commands, further reading athttp://svnbook.red-bean.com/.
Tortoise Svn Download Repo
*Tags*: svn tutorial, subversion, svn howto, source version control
Mac Svn Free
documented on: 2007-09-21