r10274 - in /www/src: 50.committing.en.page 60.releasing.en.page

[samm-guest at users.alioth.debian.org]

Author: samm-guest
Date: Sun Apr 22 17:05:54 2007
New Revision: 10274

URL: http://svn.debian.org/wsvn/pkg-gnome/?sc=1&rev=10274
Log:
Flesh out the committing page, push the releasing info to a separate page

Added:
    www/src/60.releasing.en.page
Modified:
    www/src/50.committing.en.page

Modified: www/src/50.committing.en.page
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/50.committing.en.page?rev=10274&op=diff
==============================================================================
--- www/src/50.committing.en.page (original)
+++ www/src/50.committing.en.page Sun Apr 22 17:05:54 2007
@@ -3,10 +3,41 @@
 inMenu: true
 ---
 
-committing (changelog, regenerated @debian/control@, debcommit)
+After you have finished your changes, it is time to save your work back to
+pkg-gnome's Subversion repository.
 
-also add info for those without commit access (mail output of @svn diff@ to bts)
+First of all, make sure you updated @debian/changelog at . It is possible to do
+this by hand, but why would you want to when you have @debchange@ from the
+"@devscripts@":http://packages.debian.org/devscripts package?
 
-h3. Releasing and tagging
+If you have not used @debchange@ before, put the following in your
+@~/.devscripts@ config file:
 
-TODO  Any guidelines here?
+ DEBCHANGE_RELEASE_HEURISTIC=changelog
+
+Now, run @debchange@ (or @dch@ for short). It will add a new entry to
+ at debian/changelog@ and open up your editor so you can add a description of your
+changes. You can change the editor it uses by setting the @EDITOR@ environment
+variable.
+
+Note that the @distribution@ of the new entry is @UNRELEASED at --that's intended
+(in fact, it's the effect of making the above change to your @~/.devscripts@
+file).
+
+h2. If you have commit access
+
+It is time to commit! For this we use the @debcommit@ command from the
+"@devscripts@":http://packages.debian.org/devscripts package. It will generate
+a commit message based on the entries you just added to @debian/changelog@,
+and then commit your changes.
+
+If you are on the IRC channel, you will notice that the CIA bot blurts out a
+summary of your commit. The full changes will also be mailed to the
+"pkg-gnome-commits":http://lists.alioth.debian.org/mailman/listinfo/pkg-gnome-commits
+mailing list.
+
+h2. If you don't have commit access
+
+Not a problem! Run @svn diff@ to have subversion output your changes in patch
+format. Please mail the output to the bug tracking system so that it can be
+reviewed and incorporated.

Added: www/src/60.releasing.en.page
URL: http://svn.debian.org/wsvn/pkg-gnome/www/src/60.releasing.en.page?rev=10274&op=file
==============================================================================
--- www/src/60.releasing.en.page (added)
+++ www/src/60.releasing.en.page Sun Apr 22 17:05:54 2007
@@ -1,0 +1,3 @@
+h3. Releasing and tagging
+
+TODO  Any guidelines here?