Cvs checkout

From Stellarium Wiki
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. See Svn_checkout for how to check out the subversion codebase.

CVS is a system that provides a centralised storage system for files - a repository. CVS allows users from multiple locations to download (check out) files from the repository, modify them, and upload the changes (commit). CVS 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 CVS 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 CVS repository at Sourceforge. Source code can be accessed by anyone, although only developers can commit changes back into CVS.

For more detailed information about CVS see the Wikipedia CVS 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 CVS 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 CVS repository, you need a piece of software called a CVS client. There are many CVS clients available:

Name Operating system Notes
cvs Unix; Linux; Mac; Windows (via cygwin) This is the original command-line CVS client. Most tutorials you will find on the net use this CVS client and so it's probably the easiest to get going with, so long as you can use the command line. It's really not that hard, honest.
Cervisia Linux/KDE Graphical CVS client.
Tortoise CVS Windows Integrates with Explorer. Looks nice and easy to use from the screenshots, but there aren't so many tutorials (if you find a good one, add it below).
CvsGui Linux; Mac; Windows Graphical wapper to cvs command line program.
WinCVS Windows Command line cvs very much like Tortoise CVS but smaller program. No manual but there is a command list. Works from Windows XP command prompt
Please add more if you know some nice ones. Free/Open Source implementation preferred!

CVS tutorials

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

  • Add
  • Some
  • Tutorial
  • Links


One thing to note is that CVS transfers it's data over TCP/2401. You may need to open this port in your firewall before you can get the CVS version of Stellarium.

Checking out Stellarium sourcecode

Command Line CVS client

It's easy-peasy:

cvs login
cvs -z3 co -P 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 CVS

If anyone cares to elaborate here, please do.

Personal tools
in this wiki
other languages