Daggerstab: How to get Stellarium's code moved to How to get Stellarium's source code

2010-10-11T08:04:12Z

How to get Stellarium's code moved to How to get Stellarium's source code

Daggerstab at 08:03, 11 October 2010

2010-10-11T08:03:53Z

Daggerstab: /* Subversion */ fixed link

2010-10-11T08:03:03Z

Subversion: fixed link

Daggerstab: nicely structured documentation page

2010-10-11T08:02:08Z

nicely structured documentation page

New page

To get Stellarium's source code, you can choose between several different sources, depending on what exactly you need.

If you are unfamiliar with revision control systems like Bazaar, Subversion (SVN) or CVS, you can start by reading {{wikipedia-en|revision control|Wikipedia's article on revision control}} and continue to their websites (linked below). In short, revision control means that code can be stored online in a central location (a ''repository'') as a series of changes (''revisions'') and a copy of its state at any time can be requested.

== Source packages ==
The source code of Stellarium releases is available as source packages for Linux, compressed in .tar.gz format. Due to the nature of the packaging script, the code in the packages can be used to build Stellarium on all three platforms (this is valid for at least the 0.10.* series).

The source packages are available from [http://sourceforge.net/projects/stellarium/files/ Stellarium's downloads page at SourceForge], in the [http://sourceforge.net/projects/stellarium/files/Stellarium-sources/ "Stellarium-sources"] folder.

Tarballs (.tar.gz files) can be opened by any decent file archiving application. Windows users can use the free/open-source [http://www.7-zip.org/ 7Zip].

== Revision control ==
Stellarium has gone through three different revision control systems through its history, which means that its code is in three public repositories on two different websites (SourceForge and Launchpad). Starting from the most recent:

*'''Bazaar''' (BZR) - [http://bazaar.canonical.com website], [http://wiki.bazaar.canonical.com/Download download]. The Windows packages includes TortoiseBazaar that integrates in Windows Explorer (just like TortoiseSVN) and Bazaar Explorer, so you won't have to use the command line. Bazaar Explorer is included also in the Mac OS X installer.
*'''Subversion''' (SVN) - [http://subversion.apache.org/ website], [http://subversion.apache.org/packages.html downloads].[http://tortoisesvn.tigris.org/ TortoiseSVN] is a nice client for Windows that allows avoiding the command line..
*'''CVS''' - [http://www.nongnu.org/cvs/ website]. [http://www.tortoisecvs.org/ TortoiseCVS] is a client for Windows that allows avoiding the command line. (But you didn't expect that, did you?)

===Development version===
Since June 2010, Stellarium's "trunk" (the main code) is in a Bazaar repository hosted at Launchpad:
* [http://code.launchpad.net/stellarium Main page], [http://code.launchpad.net/~stellarium/stellarium/trunk trunk branch] ([http://bazaar.launchpad.net/~stellarium/stellarium/trunk/files code browser for the trunk branch])
* [[Bzr checkout|Instructions on how to check out the code with Bazaar]]

Launchpad allows anonymous users to check out (download) code. This will allow you to create patches and submit them.

If you want to create a personal Bazaar branch that can be merged with the trunk, you need to register in Launchpad. Here is what such a user branch looks like: [http://code.launchpad.net/~daggerstab/stellarium/comets-asteroids-importer].

====Plug-ins====
The trunk code contains the code of the plug-ins that come with Stellarium, as they are statically linked at build time. Their code can be found in the "plugins" sub-directory ([http://bazaar.launchpad.net/~stellarium/stellarium/trunk/files/head%3A/plugins/ code browser for /trunk/plugins]). As of October 2010, this includes:
* [[AngleMeasure plugin|Angle Measure]]
* [[CompassMarks plugin|Compass Marks]]
* HelloStelModule (not packaged: example plug-in)
* [[LogBook plugin|Log Book]] (not packaged in 0.10.5: work in progress)
* [[Oculars plugin|Oculars]]
* [[Satellites plugin|Satellites]]
* [[TelescopeControl plugin|Telescope Control]]
* [[TextUserInterface plugin|Text User Interface]]

In theory, these plug-ins can be built as stand-alone plug-ins (that are separate dynamically linked libraries and are loaded on runtime), but the last time [[User:Daggerstab|I]] tried to do it I was not able to.

The code for some example '''stand-alone plug-ins''' can be found in the old Subversion repository at SourceForge: [http://stellarium.svn.sourceforge.net/viewvc/stellarium/trunk/extmodules/ Code browser for /trunk/extmodules]. Only that directory can be checked out with:

svn co https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk/extmodules stellarium-plugins

As of October 2010, this includes:
* '''ExampleDialog''' - demonstrates displaying a window in Stellarium and adding a button to the bottom toolbar
* '''ExamplePainter''' - demonstrates painting on the screen
* AddRemoveLandscapes - obsolete, this feature was incorporated in the trunk after 0.10.5 in a much more mature form
* KeyBindings - obsolete, just an experimental plug-in
* VirGO - obsolete, old repository for VirGO

[http://archive.eso.org/cms/tools-documentation/visual-archive-browser VirGO] is a plug-in developed for the European Southern Observatory. As a separate project, is has its own project page in Launchpad ([http://launchpad.net/virgo VirGO in Launchpad]) with its own code repository.

===Old repositories===
====Subversion====
Between August 2006 and June 2010, Stellarium used a Subversion code repository hosted at SourceForge. It is still online for archive purposes:
* [http://sourceforge.net/projects/stellarium/develop Main page], [http://stellarium.svn.sourceforge.net/viewvc/stellarium/ code browser]
* [[Svn checkout|Instructions on how to check out code with Subversion]]

Old releases before 0.10.5, including 0.10.5, are available in the "tags" directory: [http://stellarium.svn.sourceforge.net/viewvc/stellarium/tags/ code browser for /tags]

See also the explanation about [[#plug-ins|plugins]] above.

====CVS====
Before the end of August 2006, Stellarium used a CVS code repository hosted at SourceForge. It is still online for archive purposes:
* [http://stellarium.cvs.sourceforge.net/viewvc/stellarium/ Code browser]
* [[Cvs checkout|Instructions on how to check out code with CVS]]

==See also==
*

[[Category:Development]]

@@ Line 1: / Line 1: @@
 To get Stellarium's source code, you can choose between several different sources, depending on what exactly you need.
-If you are unfamiliar with revision control systems like Bazaar, Subversion (SVN) or CVS, you can start by reading {{wikipedia-en|revision control|Wikipedia's article on revision control}} and continue to their websites (linked below). In short, revision control means that code can be stored online in a central location (a ''repository'') as a series of changes (''revisions'') and a copy of its state at any time can be requested.
+If you are unfamiliar with revision control systems like Bazaar, Subversion (SVN) or CVS, you can start by reading {{wikipedia-en|revision control|Wikipedia's article on revision control}} and continue to their websites (linked below). There are also pages with instructions on using them in this wiki (again, linked below). In short, revision control means that code can be stored online in a central location (a ''repository'') as a series of changes (''revisions'') and a copy of its state at any time can be requested.
 == Source packages ==

@@ Line 60: / Line 60: @@
 Old releases before 0.10.5, including 0.10.5, are available in the "tags" directory: [http://stellarium.svn.sourceforge.net/viewvc/stellarium/tags/ code browser for /tags]
-See also the explanation about [[#plug-ins|plugins]] above.
+See also the explanation about [[#Plug-ins|plugins]] above.
 ====CVS====

How to get Stellarium's source code - Revision history

Daggerstab: How to get Stellarium's code moved to How to get Stellarium's source code

Daggerstab at 08:03, 11 October 2010

Daggerstab: /* Subversion */ fixed link

Daggerstab: nicely structured documentation page