Svn checkout

From Stellarium Wiki
Revision as of 20:43, 19 June 2010 by Matthewg42 (Talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Note: On 2010-06-17 Stellarium switched from Subversion to Bazaar located on the Launchpad servers. You probably want to look at this page instead if you want to check out current development code.

Between 2006-08-27 and 2010-06-17, Stellarium used Subversion on the sourceforge site for it's revision control system. All Subversion revisions were imported into Bazaar.

Before 2006-08-27, Stellarium used CVS on the sourceforge site for it's revision control system. 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.

Contents

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:

Checking out Stellarium sourcecode

Command Line Subversion client

It’s easy-peasy:

  1. Open a termainal / console / whatever for your OS, and change directory to where you want the code to go.
  2. Execute the following 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.

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:
https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk/stellarium

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
    https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk/stellarium
    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
Namespaces
Variants
Actions
in this wiki
other languages
Toolbox