[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[Guile-commits] 01/06: doc: Add reference to Guile Hall in the manual.

From: Ludovic Courtès
Subject: [Guile-commits] 01/06: doc: Add reference to Guile Hall in the manual.
Date: Wed, 27 May 2020 16:48:40 -0400 (EDT)

civodul pushed a commit to branch master
in repository guile.

commit f55740f0cd31e125dfd267a5be36373b14365793
Author: Alex Sassmannshausen <>
AuthorDate: Sun May 24 23:18:32 2020 +0200

    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 <>
 doc/ref/guile.texi        |  1 +
 doc/ref/scheme-using.texi | 26 ++++++++++++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/doc/ref/guile.texi b/doc/ref/guile.texi
index f91d08f..9f3fe2d 100644
--- a/doc/ref/guile.texi
+++ b/doc/ref/guile.texi
@@ -228,6 +228,7 @@ on that make up Guile's application programming interface 
(API), see
 * Using Guile in Emacs::        Guile and Emacs.
 * Using Guile Tools::           A guild of scheming wizards.
 * Installing Site Packages::    Installing Scheme code.
+* Distributing Guile Code::     Building and distributing your code.
 @end menu
 @include scheme-intro.texi
diff --git a/doc/ref/scheme-using.texi b/doc/ref/scheme-using.texi
index ac265fc..9022eb9 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{, 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
 @c Local Variables:
 @c TeX-master: "guile.texi"
 @c End:

reply via email to

[Prev in Thread] Current Thread [Next in Thread]