summaryrefslogtreecommitdiff
path: root/doc/ref/scheme-using.texi
diff options
context:
space:
mode:
authorAlex Sassmannshausen <alex@komputilo.eu>2020-05-24 23:18:32 +0200
committerLudovic Courtès <ludo@gnu.org>2020-05-27 22:14:56 +0200
commitf55740f0cd31e125dfd267a5be36373b14365793 (patch)
treea1d726900e0a601e64032836b203cfbb2e40f8d9 /doc/ref/scheme-using.texi
parentdb4af31e0922e00921f43ac25cbaeef71f8f51f3 (diff)
downloadguile-f55740f0cd31e125dfd267a5be36373b14365793.tar.gz
doc: Add reference to Guile Hall in the manual.
* doc/ref/scheme-using.texi (Distributing Guile Code): New node. Co-authored-by: Ludovic Courtès <ludo@gnu.org>
Diffstat (limited to 'doc/ref/scheme-using.texi')
-rw-r--r--doc/ref/scheme-using.texi26
1 files changed, 26 insertions, 0 deletions
diff --git a/doc/ref/scheme-using.texi b/doc/ref/scheme-using.texi
index ac265fcca..9022eb953 100644
--- a/doc/ref/scheme-using.texi
+++ b/doc/ref/scheme-using.texi
@@ -804,6 +804,32 @@ installed on your system in @code{/usr/}, then the extensions dir will
be @code{/usr/lib/guile/@value{EFFECTIVE-VERSION}/extensions}.
+@node Distributing Guile Code
+@section Distributing Guile Code
+
+@cindex distribution, of Guile projects
+There's a tool that doesn't come bundled with Guile and yet can be very
+useful in your day to day experience with it. This tool is
+@uref{https://gitlab.com/a-sassmannshausen/guile-hall, Hall}.
+
+Hall helps you create, manage, and package your Guile projects through a
+simple command-line interface. When you start a new project, Hall
+creates a folder containing a scaffold of your new project. It contains
+a directory for your tests, for your libraries, for your scripts and for
+your documentation. This means you immediately know where to put the
+files you are hacking on.
+
+@cindex build system, for Guile code
+In addition, the scaffold will include your basic ``Autotools'' setup,
+so you don't have to take care of that yourself (@pxref{The GNU Build
+System,,, autoconf, Autoconf: Creating Automatic Configuration Scripts},
+for more information on the GNU ``Autotools''). Having Autotools set up
+with your project means you can immediately start hacking on your
+project without worrying about whether your code will work on other
+people's computers. Hall can also generate package definitions for the
+GNU@tie{}Guix package manager, making it easy for Guix users to install
+it.
+
@c Local Variables:
@c TeX-master: "guile.texi"
@c End: