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 (SVN) 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:
|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!|
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:
- A Novices Tutorial on Subversion by Sean Russell
- Version Control with Subversion (free online book)
- (add more please!)
Checking out Stellarium sourcecode
Command Line Subversion client
- Open a termainal / console / whatever for your OS, and change directory to where you want the code to go.
- Execute this command:
svn co https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk/stellarium stellarium
That's it - you should now have a new directory, stellarium which contains the source code. 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.
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
- Open the TortoiseSVN website, http://tortoisesvn.net/
- Click on the "Download" link in the menu at the top of the page
- Scroll down to “Download Application”
- Click on the installer link (32bit)
- The SourceForge.net download page will open. Download the installer and save it to your computer.
- 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)
- Right-click on this folder and select “SVN Checkout...” from the menu.
- 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.