2012-10-25 21:44:27 +00:00
|
|
|
|
-*- mode: org; coding: utf-8; -*-
|
|
|
|
|
|
|
2013-01-17 22:53:29 +00:00
|
|
|
|
#+TITLE: Hacking GNU Guix and Its Incredible Distro
|
2012-10-25 21:44:27 +00:00
|
|
|
|
|
2016-07-23 10:48:51 +00:00
|
|
|
|
Copyright © 2012, 2013, 2014, 2016 Ludovic Courtès <ludo@gnu.org>
|
2015-06-10 11:39:54 +00:00
|
|
|
|
Copyright © 2015 Mathieu Lirzin <mthl@openmailbox.org>
|
2017-01-03 06:19:25 +00:00
|
|
|
|
Copyright © 2017 Leo Famulari <leo@famulari.name>
|
2012-10-25 21:44:27 +00:00
|
|
|
|
|
|
|
|
|
|
Copying and distribution of this file, with or without modification,
|
|
|
|
|
|
are permitted in any medium without royalty provided the copyright
|
|
|
|
|
|
notice and this notice are preserved.
|
|
|
|
|
|
|
2015-06-10 11:39:54 +00:00
|
|
|
|
* Contributing
|
2012-10-25 21:44:27 +00:00
|
|
|
|
|
2015-06-10 11:39:54 +00:00
|
|
|
|
See the manual for useful hacking informations, either by running
|
2013-07-13 20:55:36 +00:00
|
|
|
|
|
2015-06-10 11:39:54 +00:00
|
|
|
|
info -f doc/guix.info "(guix) Contributing"
|
2013-07-18 22:07:03 +00:00
|
|
|
|
|
2015-06-10 11:39:54 +00:00
|
|
|
|
or by checking the [[http://www.gnu.org/software/guix/manual/guix.html#Contributing][web copy of the manual]].
|
2013-08-30 21:46:58 +00:00
|
|
|
|
|
2013-06-04 08:29:57 +00:00
|
|
|
|
* Commit Access
|
|
|
|
|
|
|
|
|
|
|
|
For frequent contributors, having write access to the repository is
|
|
|
|
|
|
convenient. When you deem it necessary, feel free to ask for it on the
|
|
|
|
|
|
mailing list. When you get commit access, please make sure to follow the
|
2013-08-26 20:23:53 +00:00
|
|
|
|
policy below (discussions of the policy can take place on guix-devel@gnu.org.)
|
2013-06-04 08:29:57 +00:00
|
|
|
|
|
2013-08-26 20:23:53 +00:00
|
|
|
|
Non-trivial patches should always be posted to guix-devel@gnu.org (trivial
|
2013-06-04 08:29:57 +00:00
|
|
|
|
patches include fixing typos, etc.)
|
|
|
|
|
|
|
|
|
|
|
|
For patches that just add a new package, and a simple one, it’s OK to commit,
|
2013-06-09 22:00:33 +00:00
|
|
|
|
if you’re confident (which means you successfully built it in a chroot setup,
|
|
|
|
|
|
and have done a reasonable copyright and license auditing.) Likewise for
|
2014-05-11 10:11:09 +00:00
|
|
|
|
package upgrades, except upgrades that trigger a lot of rebuilds (for example,
|
|
|
|
|
|
upgrading GnuTLS or GLib.) We have a mailing list for commit notifications
|
2013-06-09 22:00:33 +00:00
|
|
|
|
(guix-commits@gnu.org), so people can notice. Before pushing your changes,
|
|
|
|
|
|
make sure to run ‘git pull --rebase’.
|
2013-06-04 08:29:57 +00:00
|
|
|
|
|
2016-07-23 10:48:51 +00:00
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
|
|
git config commit.gpgsign true
|
|
|
|
|
|
git config user.signingkey CABBA6EA1DC0FF33
|
2016-07-05 18:29:56 +00:00
|
|
|
|
|
2017-01-03 06:19:25 +00:00
|
|
|
|
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'.
|
|
|
|
|
|
|
2013-08-26 20:23:53 +00:00
|
|
|
|
For anything else, please post to guix-devel@gnu.org and leave time for a
|
2013-06-04 08:29:57 +00:00
|
|
|
|
review, without committing anything. If you didn’t receive any reply
|
|
|
|
|
|
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.
|
