[etoys-dev] [SVN][739] Release-HowTo: add section about the subversion repo

[commits at etoys.squeak.org]

Repository: http://etoys.squeak.org/svn

Revision: 739
Author:   bf
Date:     2011-05-29 17:33:35 +0000 (Sun, 29 May 2011)
Log Message:
-----------
Release-HowTo: add section about the subversion repo

Modified Paths:
--------------
    trunk/Documentation/Release-HowTo.txt

-------------- next part --------------
Modified: trunk/Documentation/Release-HowTo.txt
===================================================================
--- trunk/Documentation/Release-HowTo.txt	2011-05-29 17:32:54 UTC (rev 738)
+++ trunk/Documentation/Release-HowTo.txt	2011-05-29 17:33:35 UTC (rev 739)
@@ -62,14 +62,55 @@
 Monticello, and store a new update map. Each update map should be
 published as change set, too.
 
-2. Create the release image
-----------------------------
+2. The subversion repository
+-----------------------------
 
-_to be written_
+The files making up an Etoys release are stored in our subversion
+repository:
 
-3. Update projects, translations, etc.
---------------------------------------
+    http://etoys.squeak.org/svn/
 
+You need to check out the "trunk" branch once:
+
+    svn checkout http://etoys.squeak.org/svn/trunk EtoysRepo
+
+After an initial checkout, update to the latest version:
+
+    cd EtoysRepo
+    svn update
+
+This will download the latest versions of committed files. After
+updating, you should find these directories in EtoysRepo:
+
+* _Artwork_: icon files etc. in their "source" format
+* _Documentation_: this file
+* _Etoys_: the cross-platform files, e.g image, sources/changes,
+  example projects, font packages (.sar), compiled translations (.mo),
+  converted QuickGuides (.sexp.gz)
+* _QuickGuides-Projects_: the "source" QuickGuides in .pr format
+* _VM_: the virtual machines for each platform
+* _installers_: the installer files and build scripts for each platform
+* _po_: the sources of translation files. The translation server pootle
+  at http://translate.sugarlabs.org/ commits directly into this
+  directory. Do **not** commit po files here, this will confuse pootle
+  and require the pootle admins to manually resolve the conflicts.
+
+__Every change you want to be in the release needs to be committed to
+this repository!__ In particular, the "Etoys" directory will be
+installed on the user's machine exactly as it appears in the
+repository.
+
+When committing changed files, please check carefully you are not
+accidentally uploading files that should not be in the release. Always
+check the list of files about to be committed.
+
+A excellent free manual for operating subversion is at
+
+        http://svnbook.red-bean.com/
+
+3. Create the release image and files
+-------------------------------------
+
 _to be written_
 
 4. Build installers