doc: Add "The Perfect Setup" in 'HACKING'.
authorLudovic Courtès <ludo@gnu.org>
Mon, 21 Jan 2013 20:35:03 +0000 (21:35 +0100)
committerLudovic Courtès <ludo@gnu.org>
Mon, 21 Jan 2013 23:17:42 +0000 (00:17 +0100)
* HACKING (The Perfect Setup): New section.

HACKING

diff --git a/HACKING b/HACKING
index 1000a6e..1e9f5cd 100644 (file)
--- a/HACKING
+++ b/HACKING
@@ -23,6 +23,23 @@ Similarly, for a Guile session using the Guix modules:
 The ‘pre-inst-env’ script sets up all the environment variables
 necessary to support this.
 
+* The Perfect Setup
+
+The Perfect Setup to hack on Guix is basically the perfect setup used
+for Guile hacking (info "(guile) Using Guile in Emacs").  First, you
+need more than an editor, you need [[http://www.gnu.org/software/emacs][Emacs]], empowered by the wonderful
+[[http://nongnu.org/geiser/][Geiser]].
+
+Geiser allows for interactive and incremental development from within
+Emacs: code compilation and evaluation from within buffers, access to
+on-line documentation (docstrings), context-sensitive completion, M-. to
+jump to an object definition, a REPL to try out your code, and more.
+
+To actually edit the code, Emacs already has a neat Scheme mode.  But in
+addition to that, you must not miss [[http://www.emacswiki.org/emacs/ParEdit][Paredit]].  It provides facilities to
+directly operate on the syntax tree, such as raising an s-expression or
+wrapping it, swallowing or rejecting the following s-expression, etc.
+
 * Adding new packages
 
 Package recipes in Guix look like this: