civodul pushed a commit to branch master in repository guile. commit f55740f0cd31e125dfd267a5be36373b14365793 Author: Alex Sassmannshausen <a...@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 <l...@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: