Svn checkout

From Stellarium Wiki
(Difference between revisions)
Jump to: navigation, search
(Subversion tutorials: + book)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
'''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 checkout|CVS]].'''  
+
'''Note:  On 2010-06-17 Stellarium switched from Subversion to Bazaar located on the Launchpad serversYou probably want to look at [[Bzr checkout|this page]] instead if you want to check out current development code.'''
  
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.
+
'''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 checkout|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.
 
Stellarium uses Subversion to manage the source code for the project.
Line 9: Line 13:
 
For more detailed information about Subversion see the [http://en.wikipedia.org/wiki/Subversion_(software) Wikipedia Subversion article].
 
For more detailed information about Subversion see the [http://en.wikipedia.org/wiki/Subversion_(software) 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.
+
'''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==
 
==What you need==
Line 34: Line 38:
 
==Checking out Stellarium sourcecode==
 
==Checking out Stellarium sourcecode==
 
===Command Line Subversion client===
 
===Command Line Subversion client===
It's easy-peasy:
+
It’s easy-peasy:
* Open a termainal / console / whatever for your OS, and change directory to where you want the code to go.
+
# Open a termainal / console / whatever for your OS, and change directory to where you want the code to go.
* Execute this command:
+
# Execute the following command:
 
  <nowiki>svn co https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk/stellarium stellarium</nowiki>
 
  <nowiki>svn co https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk/stellarium stellarium</nowiki>
  
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.
+
That’s it you  should now have a new directory, '''stellarium''' which contains the source code. If you’re a newbie, see the <code>INSTALL</code> file in that directory, or consult [[Compilation on Linux]] to find out how to build the code.
  
 
===Tortoise SVN===
 
===Tortoise SVN===
Line 46: Line 50:
 
* Now right click on the directory and select "SVN Checkout..."
 
* Now right click on the directory and select "SVN Checkout..."
 
* In the "URL of repository:" text box put in:
 
* In the "URL of repository:" text box put in:
  <nowiki>https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk</nowiki>
+
  <nowiki>https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk/stellarium</nowiki>
  
 
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.
 
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====
====Absolute beginners guide to TortoiseSVN====
+
*Open the TortoiseSVN website, http://tortoisesvn.net/
Create a folder on your hard disk for the installation file to reside (Tortoise-svn)
+
*Click on the "Download" link in the menu at the top of the page
Log onto http://tortoisesvn.net/
+
*Scroll down to “Download Application”
      Download
+
*Click on the installer link (32bit)
          Scroll down to “Download Application”
+
*The SourceForge.net download page will open. Download the installer and save it to your computer.
          Click on the installer (32bit)
+
*Run this installation file to install TortoiseSVN  
          Download
+
*When complete restart the computer
    From the latest file releases click on Application “Download”
+
*Create a folder on your hard disk for the source code to reside (Stellarium-svn)
    From the window Right click on
+
*Right-click on this folder and select “SVN Checkout...” from the menu.
                      TortoiseSVN-1.4.1.7992-win32-svn-1.4.2.msi
+
*A window will come up. Enter in the URL window
            and save target to your selected folder.
+
*:<pre><nowiki>https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk/stellarium</nowiki></pre>
 
+
*:and in the checkout directory the folder you created for it.
Run this installation file to install TortoiseSVN  
+
*Click OK.
    When complete restart the computer
+
*The file will download (about 38 MB at the moment). Expanded size 81MB.
    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
+
      <nowiki>https://stellarium.svn.sourceforge.net/svnroot/stellarium/trunk</nowiki>
+
      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
+

Latest revision as of 20:43, 19 June 2010

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

[edit] 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!

[edit] 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:

[edit] Checking out Stellarium sourcecode

[edit] 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.

[edit] 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.

[edit] 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