From c6dbd5059454c0221a145cec5a74613fd2bccea7 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Ludovic=20Court=C3=A8s?= 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 1000a6e748..1e9f5cda81 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: