Svn checkout

From Stellarium Wiki
Revision as of 16:09, 16 October 2007 by Matthewg42 (Talk | contribs)
Jump to: navigation, search

Note: Since 2006-08-27, Stellarium has switched from using CVS to Subversion. To get the most recent development versions of the source code, you should check out from the subversion repository (as described here). Older code is still available via CVS.

Subversion is a system that provides a centralised storage system for files - a repository. Subversion allows users from multiple locations to download (check out) files from the repository, modify them, and upload the changes (commit). Subversion keeps track of all the changes that have ever been made to a file, so it's possible to go back to an old version if required, and to log how files have changed over time.

Stellarium uses Subversion to manage the source code for the project.

If you want to see what the current development version of Stellarium is like, you can get the "work in progress" version of the source code from the Stellarium Subversion repository at Sourceforge. Source code can be accessed by anyone, although only developers can commit changes back into Subversion.

For more detailed information about Subversion see the Wikipedia Subversion article.

Important Note: The development version of Stellarium is a work in progress. It may be that at the time you download it, the sourcecode does not function as expected, and might not even compile. Please don't flood the forums and bug report areas with build problems for the Subversion version of Stellarium. If there is a build problem, your best bet is to try to figure out the problem yourself from the error messages your compiler spits out. Non-developers will have a tough time with this, so their best bet might be to wait a week or two and check out the code again.


What you need

To fetch files from a Subversion repository, you need a piece of software called a Subversion client. There are many Subversion clients available:

Name Operating system Notes
svn Unix; Linux; Mac; Windows (via cygwin) This is the command-line Subversion client.
kdesvn Linux/KDE Graphical Subversion client.
Tortoise SVN Windows Integrates with Explorer. Looks nice and easy to use from the screenshots. See the website for more info.
Please add more if you know some nice ones. Free/Open Source implementation preferred!

Subversion tutorials

Subveresion does quite a lot of stuff other than allowing downloading of files. If you're interested in using Subversion as a developer, you might find one of these tutorials useful:

  • [1]
  • (add more please!)

Checking out Stellarium sourcecode

Command Line Subversion client

It's easy-peasy:

  • Open a termainal / console / whatever for your OS, and change directory to where you want the code to go.
  • Execute this command:
svn co stellarium

That's it - you should now have a new directory, stellarium which contains the source code. If you're See the INSTALL file in that directory, or consult Compilation_on_Linux to find out how to build the code.

Tortoise SVN

It's also easy-peasy:

  • Create a directory where you want to put the source.
  • Now right click on the directory and select "SVN Checkout..."
  • In the "URL of repository:" text box put in:

That's it - you should now have all source files in your dierctory. If you're a newbie See the INSTALL file in that directory, or consult Compilation_on_Linux to find out how to build the code.

Absolute beginners guide to TortoiseSVN

Create a folder on your hard disk for the installation file to reside (Tortoise-svn)

Log onto

         Scroll down to “Download Application”
         Click on the installer (32bit)
    From the latest file releases click on Application “Download”
    From the window Right click on 
           and save target to your selected folder.

Run this installation file to install TortoiseSVN

    When complete restart the computer
    Create a folder on your hard disk for the source code to reside (Stellarium-svn)
    Click on this folder then “files”
    From the pull down menu select “SVN-checkout”
    A window will come up. Enter in the URL window
     and in the checkout directory the folder you created for it.
    Click OK

The file will download (about 38 MB at the moment). Expanded size 81MB

Personal tools
in this wiki
other languages