Typical Layout[edit | edit source]
This is the top of the Subversion repository. trunk/ ......... The latest development sources. When people say "Get the head of trunk", they mean the latest revision of this directory tree. branches/ ...... Various development branches. Typically a branch contains a complete copy of trunk/, even if the changes are isolated to one subdirectory. Note that branch copies are generally removed after they've been merged back into trunk, so what's in branches/ now does not reflect all the branches that have ever been created. [http://svnbook.red-bean.com/nightly/en/svn-book.html#svn.branchmerge.whatis What is a branch?] tags/ .......... Snapshots of releases. As a general policy, we don't change these after they're created; if something needs to change, we move it to branches and work on it there.
Moving things[edit | edit source]
When you move things around, you affect the downstream editors/working copies. Editors may need to update their working copies using svn switch. And you may need to alter the authorization configuration of the repo so that those editors still have access to the same project sources.
Use the --relocate option only when rewriting the URL portion:
svn switch -v --relocate file:///var/svn/myrepo/widgets http://svn.example.com/myrepo/widgets
If you make a mistake, it could cause you to have to do a clean checkout.
Most switches should only involve path changes. A more programmatic approach would be a command like:
svn switch `cat .svn/entries |grep http |cut -d -f 2` http://svn.example.com/myrepo/widgets
Anyway, to find out where a working copy is pointing to, you can simply run svn info
$ svn info Path: . URL: http://svn.example.com/myrepo/widgets Repository UUID: 4341fff5-530e-0410-bccg-gf26c29f061c Revision: 3047 Node Kind: directory Schedule: normal Last Changed Author: buddysum Last Changed Rev: 1975 Last Changed Date: 2006-08-31 12:11:23 -0400 (Thu, 31 Aug 2006)
Repository Layout Example[edit | edit source]
vendorsrc drupal current 4.6 4.7 5.5 6.6 websvn current mediawiki current phpmyadmin current websites www.example.com branches tags trunk www cms (svn:externals http://svn.example.com/svn/myproject/vendorsrc/drupal/6.6) wiki (svn:externals http://svn.example.com/svn/myproject/vendorsrc/mediawiki/current)