ClassRooms/DownloadSources

Back to ClassRooms

Teacher information
Time : 30 minutes (presentation + questions)

Pre-requisites: be able to use the shell Bash.

Level : beginner

Goal
Install subversion and download OOo4Kids (or OOoLight), or other like OOo sources.

Introduction
To download OOo4Kids (or OOoLight) source code, you'll have to install Subversion.

Subversion, commonly abbreviated as SVN, is a command line tool dedicated to the versioning control like CVS does.

Another tool, named tortoise is a graphical tool. Could be used too (but we won't describe its use there)

OOo4Kids and OOoLight sources

 * Linux: install subversion the way of your distribution (synaptic, apt-get, urpmi ... and so on)
 * Mac OS X ( 10.4 and superior) : subversion is normaly shipped with Xcode. In the opposite case, install it using Darwin port or Fink.
 * Windows : install subversion using Cygwin, and the right repository.

At this point, we suppose subversion is installed, and works.

Instructions for Anonymous developers
You don't have write access, and you don't care :)

Adullact (main) repository
Open a Terminal, change the directory for your prefered one, and verify you have more than 12 GB available for the full build.

Then, do : svn co -r874 svn://svn.adullact.net/svnroot/ooo4kids1/trunk OOo4Kids1.0

If your connexion is fast, the source should be there in ~20 minutes max, and the $SRC_ROOT, means the subdir containing the whole tree will be OOo4Kids1.0

Note: OOo4Kids 1.0 is r874, and the supported locales are : ar, de, es, fi, fr, it, nb, nl, pt, sl, zh-CN and zh-TW. If you choose another revision, things might not work as expected.

Basics with subversion

 * the repository is a centralized machine, containing the reference of the source code, including control versioning. It is defined as an URL, but following svn protocol.
 * Every time a developer modifies something in the repository code, his action is called a commit, associated to a version number, to keep the story of the source code (and eventualy revers some changes).
 * Every commit is associated to a changeset version number.
 * co means : checkout
 * -r874 means revision 874
 * the dir containing all the sources, is named "$SRC_ROOT". For instance it will be OOo4Kids1.0, but you can use whatever name of your choice instead.
 * Once configure will be done, you can't rename $SRC_ROOT, nor move the tree elsewhere : redo configure is mandatory in one of the previous mentionned cases.

Other options for the command line :

cd a Directory (inside the OOo4Kids tree). svn info : will return the current version number and some usefull information

c means changeset, and you can retrieve the diff for a given commit

e.g. : svn diff aModuleName -cr844 svn://svn.adullact.net/svnroot/ooo4kids1/trunk > my_diff.diff

Will return you the diff of the commit made between r843 and r844, and redirect the output in my_diff.diff

Additional information
See Download OOo4Kids sources on the wiki