Update release and package instructions

1 files changed, 36 insertions, 26 deletions

diff --git a/docs/release_howto.txt b/docs/release_howto.txt
index 97f322e..db877e0 100644
--- a/docs/release_howto.txt
+++ b/docs/release_howto.txt
@@ -1,7 +1,10 @@
-''' This is the fedora release process of the sugar packages sugar(shell), 
-sugar-toolkit and sugar-base described in a pytish way
+''' This is the release process of the sugar tarballs sugar(shell), 
+sugar-toolkit and sugar-base described in a pytish way and
+instructions for sugar packagers
 '''
 
+# Release sugar tarballs
+
 for package in [sugar, sugar-toolkit, sugar-base, sugar-artwork]:
     # Release a new version in git
     Pull the latest sources.
@@ -30,34 +33,41 @@ for package in [sugar, sugar-toolkit, sugar-base, sugar-artwork]:
     Check that the package has been uploaded fine: \
         http://download.sugarlabs.org/sources/sucrose/glucose/$name/$name-$version
 
-    # Build and release a new rpm
-    # more info on fedora packaging: 
-    #     http://fedoraproject.org/wiki/PackageMaintainers/UpdatingPackageHowTo
-    # request permissions to contribute to the fedora package: 
-    #     https://admin.fedoraproject.org/pkgdb/packages/name/[package]
+# Package sugar for Fedora
+# - For announcements of the Sucrose release subscribe at the sugar-devel 
+#   mailing list; you can filter for the [ANNOUNCE] tag
+# - Uploaded tarballs can be found at: 
+#   glucose: http://download.sugarlabs.org/sources/sucrose/glucose/$name/$name-$version
+#   fructose: http://download.sugarlabs.org/sources/sucrose/fructose/$name/$name-$version
+#   more about the taxonomy: http://sugarlabs.org/go/Taxonomy
+	
+# more info on fedora packaging: 
+#     http://fedoraproject.org/wiki/PackageMaintainers/UpdatingPackageHowTo
+# request permissions to contribute to the fedora package: 
+#     https://admin.fedoraproject.org/pkgdb/packages/name/[package]
 
-    if not cvs_package:
-        # Get sugar from fedora cvs:
-        CVSROOT=:ext:erikos@cvs.fedoraproject.org:/cvs/pkgs cvs co [package]
-        cd cvs_package
-    else:
-        cd cvs_package
-        cvs update
+if not cvs_package:
+    # Get sugar from fedora cvs:
+    CVSROOT=:ext:erikos@cvs.fedoraproject.org:/cvs/pkgs cvs co [package]
+    cd cvs_package
+else:
+    cd cvs_package
+    cvs update
 
-    cd current release
-    make new-sources FILES="[tarball-created-with-make_distcheck]"
+cd current release
+make new-sources FILES="[tarball-created-with-make_distcheck]"
 
-    # Change the version in the spec
-    Bump the release number
-    Edit the Changelog
-    # verify your changes
-    cvs diff -u
-    make srpm
+# Change the version in the spec
+Bump the release number
+Edit the Changelog
+# verify your changes
+cvs diff -u
+make srpm
 
-    make clog
-    cvs commit -F clog
+make clog
+cvs commit -F clog
 
-    make tag
-    make build
+make tag
+make build
 
 # Do the same for the other branches e.g. devel