Dev:Subversion

From Synfig Studio :: Documentation
Revision as of 02:35, 24 January 2008 by PaulWise (Talk | contribs) (use the daily-updated tarball, show how to completely ignore dirs and how to rename dirs safely)

Jump to: navigation, search

Build instructions has instructions for checking the source code out of subversion in 3 separate projects, but what if you want a single project?

The easy way is to download the tarball mentioned on the Source code page. Extract it, and it creates a subversion working directory called 'synfig' which contains ETL, synfig and synfigstudio. 'cd' into it and run 'svn up' to update it to the latest version.

Here's how I achieved it. The following steps will create a new directory called 'code' in the current directory, and put everything inside there. It's quite long, because I reproduce a bit of the output. If you just want to see the commands, just to the 'Summary' at the bottom of this page.

Run this 'co' command. As soon as you see some output, hit control-c to stop it:

/tmp$ svn co http://svn.voria.com/code code
A    code/ETL
A    code/ETL/releases
A    code/ETL/trunk
  C-c svn: Caught signal

Notice that subversion was putting all the ETL files inside code/ETL/trunk. We don't want the 'trunk' directory, or any other tags or branches, so we use 'switch' to tell it that. Let the command complete:

/tmp$ svn switch http://svn.voria.com/code/ETL/trunk code/ETL/
D    code/ETL/releases
D    code/ETL/trunk
A    code/ETL/ETL.pbproj
[...]
A    code/ETL/ETL.prj
 U   code/ETL
Updated to revision 440.

Then issue the 'update' command, and again interrupt it when it starts pulling in files:

/tmp$ svn update code
A    code/synfig-studio
A    code/synfig-studio/trunk
A    code/synfig-studio/trunk/synfigstudio.mime.in
  C-c svn: Caught signal

Again, use 'switch' to tell svn we only want the trunk:

/tmp$ svn switch http://svn.voria.com/code/synfig-studio/trunk code/synfig-studio/
D    code/synfig-studio/trunk
A    code/synfig-studio/synfigstudio.mime.in
[...]
A    code/synfig-studio/bootstrap
 U   code/synfig-studio/
Updated to revision 440.

And repeat again for synfig-core:

/tmp$ svn update code
A    code/synfig-core
A    code/synfig-core/trunk
A    code/synfig-core/trunk/synfig-core.xcodeproj
  C-c svn: Caught signal

Use switch to select only synfig-core's trunk:

/tmp$ svn switch http://svn.voria.com/code/synfig-core/trunk code/synfig-core/
D    code/synfig-core/trunk
A    code/synfig-core/synfig-core.xcodeproj
[...]
A    code/synfig-core/examples/candy.sif
 U   code/synfig-core
Updated to revision 440.

If you want to use different names for the directories (the tarball names for example), after doing the svn switch stuff, edit code/.svn/entries and change the names:

mv code/synfig-core code/synfig
mv code/synfig-studio code/synfigstudio
chmod u+w code/.svn/entries
nano code/.svn/entries
[..change synfig-core to synfig and synfig-studio to synfigstudio...]

Supposing there are some subdirectories which you don't want at all. For example, the next up is synfig-docs. Use control-c again to interrupt the update as soon as it gets started:

/tmp$ svn update code
A    code/synfig-docs
A    code/synfig-docs/trunk
A    code/synfig-docs/trunk/en
  C-c svn: Caught signal

Instead of switching to the trunk, this time we'll switch to 'code/empty', which is an empty directory. This will result in the whole of the synfig-docs/ being ignored:

/tmp$ svn switch http://svn.voria.com/code/empty code/synfig-docs/

D    code/synfig-docs/trunk
Updated to revision 440.

Proceed in the same manner for the remaining directories. I didn't want either of the OSX trees, so I switched those to 'empty' too:

/tmp$ svn update code
A    code/gtkmm-osx
A    code/gtkmm-osx/trunk
A    code/gtkmm-osx/trunk/gtkmm-meta.mpkg
  C-c svn: Caught signal
/tmp$ svn switch http://svn.voria.com/code/empty code/gtkmm-osx/
D    code/gtkmm-osx/trunk
Updated to revision 440.
/tmp$ svn update code
A    code/synfig-osx
A    code/synfig-osx/trunk
A    code/synfig-osx/trunk/launcher
  C-c svn: Caught signal
/tmp$ svn switch http://svn.voria.com/code/empty code/synfig-osx/
D    code/synfig-osx/trunk
Updated to revision 440.
/tmp$ svn update code
A    code/autobuild
A    code/autobuild/trunk
A    code/autobuild/trunk/Makefile
A    code/empty
Updated to revision 440.

Since svn switch leaves the directories there, and you may not want that, you can simply delete the directories and files you don't want from code/.svn/entries:

rm -rf code/autobuild code/empty code/gtkmm-osx code/synfig-osx code/synfig-docs code/.valgrind code/.gitignore
chmod u+w code/.svn/entries
nano code/.svn/entries
[..delete the unneeded files/dirs..]

Finally, we're finished. 'du' shows us that only ETL, core, and studio have a significant amount of content:

/tmp$ du -sk code/*
44	code/autobuild
16	code/empty
3604	code/ETL
16	code/gtkmm-osx
95628	code/synfig-core
16	code/synfig-docs
16	code/synfig-osx
15420	code/synfig-studio
/tmp$

Summary:

$ svn co http://svn.voria.com/code
hit Control-C when output begins
$ svn switch http://svn.voria.com/code/ETL/trunk code/ETL/
$ svn update code
hit Control-C when output begins
$ svn switch http://svn.voria.com/code/synfig-studio/trunk code/synfig-studio/
$ svn update code
hit Control-C when output begins
$ svn switch http://svn.voria.com/code/synfig-core/trunk code/synfig-core/
$ svn update code
hit Control-C when output begins
$ svn switch http://svn.voria.com/code/empty code/synfig-docs/
$ svn update code
hit Control-C when output begins
$ svn switch http://svn.voria.com/code/empty code/gtkmm-osx/
$ svn update code
hit Control-C when output begins
$ svn switch http://svn.voria.com/code/empty code/synfig-osx/
$ svn update code