doc: Add note about .dir-locals.el.

* HACKING (Coding Style): Mention special indentation rules and
  .dir-locals.el.
This commit is contained in:
Ludovic Courtès 2013-08-30 23:53:13 +02:00
parent e1c5a8357a
commit 1a2e649561
1 changed files with 8 additions and 3 deletions

11
HACKING
View File

@ -115,9 +115,14 @@ In general, we follow the [[http://mumble.net/~campbell/scheme/style.txt][Riastr
to describe the conventions mostly used in Guiles code too. It is very to describe the conventions mostly used in Guiles code too. It is very
thoughtful and well written, so please do read it. thoughtful and well written, so please do read it.
In addition, we require all top-level procedures to carry a docstring. This Some special forms introduced in Guix, such as the substitute* macro, have
requirement can be relaxed for simple private procedures in the (guix build …) special indentation rules. These are defined in the .dir-locals.el file,
name space, though. which Emacs automatically uses. If you do not use Emacs, please make sure to
let your editor know the rules.
We require all top-level procedures to carry a docstring. This requirement
can be relaxed for simple private procedures in the (guix build …) name space,
though.
Procedures should not have more than four positional parameters. Use keyword Procedures should not have more than four positional parameters. Use keyword
parameters for procedures that take more than four parameters. parameters for procedures that take more than four parameters.