Gentoo Wiki




Sometimes when you are building a project you will want to link in a repository from another project. Perhaps a library supplied by another project or a complete other project that runs as a subset of your own.

In any case you have 2 options when placing this project into your own. You can copy their project into your own and personally make sure you update it on a regular basis (i.e. the hard way). Or you can use the svn:externals property to link into your project (the easy way).

Getting Started

Step one

Create a basic repository, or use an existing one.

Step two

make a directory in your project where you want the external repository to go (or use an existing one). For this example we will use /repos/externals

Step three

run svn propedit svn:externals /repos/externals and add something similar to the following: patTemplate

Warning: any directory you specify for an svn:externals checkout should not already exist in your repository. If it does, you will get an error like the following:
svn: Working copy 'sharedproject' locked
svn: run 'svn cleanup' to remove locks

That's it you're all set. run an svn up and it will download the external repository into /repos/externals/patTemplate and automatically re-check this repository on every update.

Setting a revision number

When linking an external library it is generally best practice to link a specific revision. you can do this by making your line in the svn:externals property patTemplate -r113

Retrieved from ""

Last modified: Wed, 03 Sep 2008 23:49:00 +0000 Hits: 1,789