Getting Started/Sources/Snapshots - Revision history

AnneW at 18:10, 13 July 2012

2012-07-13T18:10:21Z

Odysseus at 12:18, 5 June 2011

2011-06-05T12:18:32Z

Odysseus at 23:04, 19 March 2011

2011-03-19T23:04:58Z

Tampakrap: Undo revision 18523 by 81.139.15.56 (Talk)

2008-01-14T07:29:27Z

Undo revision 18523 by 81.139.15.56 (Talk)

Tampakrap: /* Get the snapshot */

2007-12-21T14:19:57Z

‎Get the snapshot

Dhaumann at 16:51, 13 August 2007

2007-08-13T16:51:48Z

Mpyne: Clarify that Svn snapshots really are Subversion checkouts near the beginning.

2007-05-19T01:31:57Z

Clarify that Svn snapshots really are Subversion checkouts near the beginning.

Mpyne: Add information on using svn switch to the snapshots page.

2007-05-19T01:24:10Z

Add information on using svn switch to the snapshots page.

Mpyne: Add page describing using module snapshots to perform the initial checkout.

2007-05-19T00:49:47Z

Add page describing using module snapshots to perform the initial checkout.

New page

{{TutorialBrowser|

series=Getting Started|

name=Getting the Source using Snapshots|

next=[[../../Build/KDE4|Building KDE4]]|

reading=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]|
}}

If you are trying to checkout a KDE source module, then there is a way to make the normally slow process of the initial checkout happen a lot quicker, thanks to automatically generated snapshots of the KDE source repository, which are stored in convenient archived form in the KDE FTP system. This page describes how to perform a checkout using a module snapshot.

{{note|This procedure only works if the module you want has nightly snapshots generated (most do), and if you want the '''trunk''' version of the module.}}

== Get the snapshot ==

First go to [http://download.kde.org/ The KDE Mirror Redirector] and choose the best FTP server for your location. Usually this will be a server in your country/state. Click on the link for the FTP server and navigate to the {{path|snapshots}} directory. In this directory will be a large list of KDE modules which are archived.

You want to download the module with the name in the following format: '''kdemodule-svn.tar.bz2'''. Go ahead and save this archive to your hard disk somewhere. You'll need to be able to reach this location from the command line later.

{{note|It is important to get the module with the '''-svn''' in the file name. There are other types of snapshots also in the same directory for each module. But only modules with '''-svn''' contain the necessary information to allow for completing a checkout.}}

== The Recipe ==

Now for the checkout, go ahead and open a terminal shell and perform the following steps:

cs # [[Getting_Started/Increased_Productivity_in_KDE4_with_Scripts/.bashrc|cs is not a typo]]
tar xvjf /path/to/kdemodule-svn.tar.bz2
cd kdemodule
svn revert -R . # This step restores the missing files.
svn up # This step updates the source to the latest code, and is optional.

== Extra Tidbits ==

That's it! You've got a valid KDE module checkout now. Some things to keep in mind:

* Each module snapshot contains a special README.svn-nightly file containing information on how to use the snapshot. You've already performed the svn revert and update steps.
* The modules are already setup to update from the KDE anonymous Subversion repository (svn://anonsvn.kde.org/). If this is not correct for you (i.e. you're a developer), then you can use the svn switch command to fix the checkout as described in the README.svn-nightly file.
* If you want to keep the module up to date in the future, just run svn up as you would for any other Subversion checkout. You do not have to continue downloading snapshots just to update the module, and to do so would be inefficient and slow.

[[Category:Build KDE]]

← Older revision		Revision as of 18:10, 13 July 2012
Line 1:		Line 1:
−	~~{{Template:I18n/Language Navigation Bar\|Getting Started/Sources/Snapshots}}~~	+
	{{TutorialBrowser\|		{{TutorialBrowser\|

← Older revision		Revision as of 16:51, 13 August 2007
Line 1:		Line 1:
		+	{{Template:I18n/Language Navigation Bar\|Getting Started/Sources/Snapshots}}
	{{TutorialBrowser\|		{{TutorialBrowser\|

← Older revision		Revision as of 01:31, 19 May 2007
Line 11:		Line 11:

	If you are trying to checkout a KDE source module, then there is a way to make the normally slow process of the initial checkout happen a lot quicker, thanks to automatically generated snapshots of the KDE source repository, which are stored in convenient archived form in the KDE FTP system. This page describes how to perform a checkout using a module snapshot.		If you are trying to checkout a KDE source module, then there is a way to make the normally slow process of the initial checkout happen a lot quicker, thanks to automatically generated snapshots of the KDE source repository, which are stored in convenient archived form in the KDE FTP system. This page describes how to perform a checkout using a module snapshot.
		+
		+	Keep in mind that these snapshots are '''real Subversion checkouts''', containing all of the required Subversion metadata. This procedure can in fact be the quickest way to checkout a module, thanks to the abundance of FTP mirrors.

	{{note\|This procedure only works if the module you want has nightly snapshots generated (most do), and if you want the '''trunk''' version of the module.}}		{{note\|This procedure only works if the module you want has nightly snapshots generated (most do), and if you want the '''trunk''' version of the module.}}

@@ Line 11: / Line 11: @@
 }}
-If you are trying to checkout a KDE source module, then there is a way to make the normally slow process of the initial checkout happen a lot quicker, thanks to automatically generated snapshots of the KDE source repository, which are stored in convenient archived form in the KDE FTP system.  This page describes how to perform a checkout using a module snapshot.
+If you are trying to checkout or clone a KDE source module, then there is a way to make the normally slow process of the initial checkout happen a lot quicker, thanks to automatically generated snapshots of the KDE source repository, which are stored in convenient archived form in the KDE FTP system.  This page describes how to perform a checkout or clone using a module snapshot.
-Keep in mind that these snapshots are '''real Subversion checkouts''', containing all of the required Subversion metadata.  This procedure can in fact be the quickest way to checkout a module, thanks to the abundance of FTP mirrors.
+Keep in mind that these snapshots are '''real''' Subversion checkouts or Git Clones, containing all of the required Subversion or Git metadata.  This procedure can in fact be the quickest way to checkout a module, thanks to the abundance of FTP mirrors.
-{{note|This procedure only works if the module you want has nightly snapshots generated (most do), and if you want the '''trunk''' version of the module.}}
+{{note|For Subversion this procedure only works if the module you want has nightly snapshots generated (most do), and if you want the '''trunk''' version of the module.  For Git snapshots are always generated and contain all unstable and stable branches.}}
-== Get the snapshot ==
+== Git ==
 First go to [http://download.kde.org/ The KDE Mirror Redirector] and choose the best FTP server for your location.  Usually this will be a server in your country/state.  Click on the link for the FTP server and navigate to the {{path|snapshots}} directory.  In this directory will be a large list of KDE modules which are archived.
@@ Line 25: / Line 37: @@
 {{note|It is important to get the module with the '''-svn''' in the file name.  There are other types of snapshots also in the same directory for each module.  But only modules with '''-svn''' contain the necessary information to allow for completing a checkout.}}
-== The Recipe ==
+=== The Recipe ===
 Now for the checkout, go ahead and open a terminal shell and perform the following steps:
@@ Line 35: / Line 47: @@
   svn up          # This step updates the source to the latest code, and is optional.
-== Extra Tidbits ==
+=== Extra Tidbits ===
 That's it!  You've got a valid KDE module checkout now.  Some things to keep in mind:

@@ Line 6: / Line 6: @@
 name=Getting the Source using Snapshots|
-next=[[../../Build/KDE4|Building KDE4]]|
+next=[[../../Build|Building KDE]]|
-reading=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]<br>[[../../Increased_Productivity_in_KDE4_with_Scripts|Increased Productivity in KDE4 with Scripts]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]|
+reading=[[../../Sources/Anonymous_SVN|Anonymous SVN Quickstart Guide]]<br>[[Development/Tutorials/CMake |Introduction to CMake]]|
 }}

@@ Line 38: / Line 38: @@
 * Each module snapshot contains a special README.svn-nightly file containing information on how to use the snapshot.  You've already performed the svn revert and update steps.
 * The modules are already setup to update from the KDE anonymous Subversion repository (svn://anonsvn.kde.org/).  If this is not correct for you (i.e. you're a developer), then you can use the svn switch command to fix the checkout as described in the README.svn-nightly file.
 * If you want to keep the module up to date in the future, just run svn up as you would for any other Subversion checkout.  You do not have to continue downloading snapshots just to update the module, and to do so would be inefficient and slow.
 [[Category:Build KDE]]