From c6dbd5059454c0221a145cec5a74613fd2bccea7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= <ludo@gnu.org>
Date: Mon, 21 Jan 2013 21:35:03 +0100
Subject: [PATCH] doc: Add "The Perfect Setup" in 'HACKING'.

* HACKING (The Perfect Setup): New section.
---
 HACKING | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/HACKING b/HACKING
index 1000a6e748e..1e9f5cda812 100644
--- 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:
-- 
GitLab