gnu: Add r-all.

[jackhill/guix/guix.git] / HACKING

diff --git a/HACKING b/HACKING
index 46a7249..2f0f93f 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -2,9 +2,10 @@
 
 #+TITLE: Hacking GNU Guix and Its Incredible Distro
 
 
 #+TITLE: Hacking GNU Guix and Its Incredible Distro
 

-Copyright © 2012, 2013, 2014, 2016, 2017 Ludovic Courtès <ludo@gnu.org>
+Copyright © 2012, 2013, 2014, 2016, 2017, 2019 Ludovic Courtès <ludo@gnu.org>

 Copyright © 2015, 2017 Mathieu Lirzin <mthl@gnu.org>
 Copyright © 2017 Leo Famulari <leo@famulari.name>
 Copyright © 2015, 2017 Mathieu Lirzin <mthl@gnu.org>
 Copyright © 2017 Leo Famulari <leo@famulari.name>

+Copyright © 2017 Arun Isaac <arunisaac@systemreboot.net>

 
   Copying and distribution of this file, with or without modification,
   are permitted in any medium without royalty provided the copyright
 
   Copying and distribution of this file, with or without modification,
   are permitted in any medium without royalty provided the copyright


@@ -26,7 +27,7 @@ mailing list.  When you get commit access, please make sure to follow the
 policy below (discussions of the policy can take place on guix-devel@gnu.org.)
 
 Non-trivial patches should always be posted to guix-patches@gnu.org (trivial
 policy below (discussions of the policy can take place on guix-devel@gnu.org.)
 
 Non-trivial patches should always be posted to guix-patches@gnu.org (trivial

-patches include fixing typos, etc.)  This mailing list fills the
+patches include fixing typos, etc.).  This mailing list fills the

 patch-tracking database at [[https://bugs.gnu.org/guix-patches]]; see
 "Contributing" in the manual for details.
 
 patch-tracking database at [[https://bugs.gnu.org/guix-patches]]; see
 "Contributing" in the manual for details.
 


@@ -40,15 +41,21 @@ make sure to run ‘git pull --rebase’.
 
 All commits that are pushed to the central repository on Savannah must be
 signed with an OpenPGP key, and the public key should be uploaded to your user
 
 All commits that are pushed to the central repository on Savannah must be
 signed with an OpenPGP key, and the public key should be uploaded to your user

-account on Savannah and to public key servers, such as ‘pgp.mit.edu’.  To
-configure Git to automatically sign commits, run:
+account on Savannah and to public key servers, such as
+‘keys.openpgp.org’.  To configure Git to automatically sign commits,
+run:

 
   git config commit.gpgsign true
   git config user.signingkey CABBA6EA1DC0FF33
 
 
   git config commit.gpgsign true
   git config user.signingkey CABBA6EA1DC0FF33
 

-You can prevent yourself from accidentally pushing unsigned commits to Savannah
-by using the pre-push Git hook called 'pre-push'. It's located at
-'etc/git/pre-push'.
+You can prevent yourself from accidentally pushing unsigned commits to
+Savannah by using the pre-push Git hook called located at ‘etc/git/pre-push’:
+
+  cp etc/git/pre-push .git/hooks/pre-push
+
+When pushing a commit on behalf of somebody else, please add a Signed-off-by
+line at the end of the commit log message (e.g. with ‘git am --signoff’).
+This improves tracking of who did what.

 
 For anything else, please post to guix-patches@gnu.org and leave time for a
 review, without committing anything.  If you didn’t receive any reply
 
 For anything else, please post to guix-patches@gnu.org and leave time for a
 review, without committing anything.  If you didn’t receive any reply


@@ -56,3 +63,12 @@ after two weeks, and if you’re confident, it’s OK to commit.
 
 That last part is subject to being adjusted, allowing individuals to commit
 directly on non-controversial changes on parts they’re familiar with.
 
 That last part is subject to being adjusted, allowing individuals to commit
 directly on non-controversial changes on parts they’re familiar with.

+
+* Using emacs-debbugs
+
+Bug reports and patches are tracked using debbugs. If you are on emacs, you
+can use emacs-debbugs.
+
+List all open bug reports on guix-patches with
+
+C-u M-x debbugs-gnu <RET> <RET> guix-patches <RET> n y