Re: [ANN] Guile Hall 0.3.0 released

[Catonano <catonano@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 347 bytes --]

Il giorno dom 17 mag 2020 alle ore 22:48 Alex Sassmannshausen <
alex.sassmannshausen@gmail.com> ha scritto:

Absolutely, thanks for offering!  Happy to give your draft a once over
> if you want!
>

So, here's the patch

is it leaning a bit too much on the use case illustration ?

Should it be a bit dryer to conform with the rest of the manual ?

[-- Attachment #2: guile-hall.patch --]
[-- Type: text/x-patch, Size: 2211 bytes --]

From b931125e04180305f7728c5f41e42e837974178b Mon Sep 17 00:00:00 2001
From: Adriano <catonano@gmail.com>
Date: Mon, 18 May 2020 17:44:15 +0200
Subject: [PATCH] added a reference t guile-hall in the manual

---
 doc/ref/scheme-using.texi | 50 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 50 insertions(+)

diff --git a/doc/ref/scheme-using.texi b/doc/ref/scheme-using.texi
index ac265fcca..dfe298904 100644
--- a/doc/ref/scheme-using.texi
+++ b/doc/ref/scheme-using.texi
@@ -744,6 +744,56 @@ using a CPAN-like system.
 A complete list of guild scripts can be had by invoking @code{guild
 list}, or simply @code{guild}.
 
+@node guile-hall
+@subsection Bootstrapping projects and distributing them
+
+There's a tool that doesn't come bundled with Guile
+and yet it can be very useful in the common experience of using Guile.
+
+It's @uref{https://gitlab.com/a-sassmannshausen/guile-hall, guile-hall}
+
+When you start a new project guile-hall creates a folder
+containing a scaffold of your new project.
+
+In such scaffold the Autotools setup will be already instrumented,
+you don't need to take care of it yourself.
+
+Under the hood, guile-hall uses the Autoconf macros provided by Guile
+so the Autotools setup of your project will be able to test, for example,
+if a certain Guile library is available or if Guile itself is available and
+in which version.
+
+In this way you'll be able to call make to
+
+@itemize @bullet
+@item
+build your project
+@item
+run the unit tests
+@item
+create a distribution package (a .tar.gz file)
+@end itemize
+
+This covers 2 different needs.
+
+On one sie it assists you in working on your project
+by allowing you to conveniently build it and run the unit tests.
+
+On another side, when you're ready it will produce
+a manufact that lends itself to be easily distributed.
+
+GNU/Linux distributions will be able to easily
+distribute your project.
+
+But also people running a distribution that doesn't offer your project yet
+will be able to build and run it, provided they are acquainted with the
+usual process
+
+@example
+./configure
+make
+make install
+@end example
 
 @node Installing Site Packages
 @section Installing Site Packages
-- 
2.25.1