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

[Ludovic Courtès]

civodul pushed a commit to branch master
in repository guile.

commit f55740f0cd31e125dfd267a5be36373b14365793
Author: Alex Sassmannshausen <alex@komputilo.eu>
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 <ludo@gnu.org>
---
 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{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: