summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorPierre-Antoine Rault <par@rigelk.eu>2014-03-09 17:10:27 +0100
committerLudovic Courtès <ludo@gnu.org>2014-03-10 23:43:31 +0100
commit5ff3c4b8207eb2fbbc48c9f429ccb65690def5ee (patch)
treec7a540ad358d8efd0d56e859cbd8ec32bfbfff01 /doc
parent8a1f6a7e02afbe63dfa1193282c8b6807b845db2 (diff)
downloadgnu-guix-5ff3c4b8207eb2fbbc48c9f429ccb65690def5ee.tar
gnu-guix-5ff3c4b8207eb2fbbc48c9f429ccb65690def5ee.tar.gz
doc: Update packaging guidelines.
* HACKING (Submitting Patches): Mention 'git send-mail'. * doc/guix.texi (Packaging Guidelines): More details on how to prepare a package module. (Contributing): Add reference to #guix channel on Freenode. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi17
1 files changed, 13 insertions, 4 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 150747f445..701b5400f8 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -2270,6 +2270,15 @@ called @code{gnew}, you may run this command from the Guix build tree:
Using @code{--keep-failed} makes it easier to debug build failures since
it provides access to the failed build tree.
+If the package is unknown to the @command{guix} command, it may be that
+the source file contains a syntax error, or lacks a @code{define-public}
+clause to export the package variable. To figure it out, you may load
+the module from Guile to get more information about the actual error:
+
+@example
+./pre-inst-env guile -c '(use-modules (gnu packages gnew))'
+@end example
+
Once your package builds correctly, please send us a patch
(@pxref{Contributing}). Well, if you need help, we will be happy to
help you too. Once the patch is committed in the Guix repository, the
@@ -2784,10 +2793,10 @@ deco,,, dmd, GNU dmd Manual}).
@chapter Contributing
This project is a cooperative effort, and we need your help to make it
-grow! Please get in touch with us on @email{guix-devel@@gnu.org}. We
-welcome ideas, bug reports, patches, and anything that may be helpful to
-the project. We particularly welcome help on packaging
-(@pxref{Packaging Guidelines}).
+grow! Please get in touch with us on @email{guix-devel@@gnu.org} and
+@code{#guix} on the Freenode IRC network. We welcome ideas, bug
+reports, patches, and anything that may be helpful to the project. We
+particularly welcome help on packaging (@pxref{Packaging Guidelines}).
Please see the
@url{http://git.savannah.gnu.org/cgit/guix.git/tree/HACKING,