Re: [ANN] Guile Hall 0.3.0 released

[Catonano <catonano@gmail.com>]

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

Il giorno gio 21 mag 2020 alle ore 12:03 Alex Sassmannshausen <
alex.sassmannshausen@gmail.com> ha scritto:

> Heya,
>
> On Thu, 2020-05-21 at 12:00 +0200, Catonano wrote:
> >
> >
> > Il giorno mer 20 mag 2020 alle ore 17:58 Catonano <catonano@gmail.com
> > > ha scritto:
> > >
> > > Ok this is the last revision for today
> > > Now I'm gonna do something else, really ! 😀
> > >
> >
> >
> > So, today is another day and I have a new update
> >
> > I'm watching this talk
> >
> https://peertube.social/videos/watch/8f27a614-aa63-4811-af6a-b9e11effc399
> >
> > and it made up my mind that in this patch I'm intermingling reference
> > type content and tutorial type content
> >
> > Guile desperately lacks some good tutorial and how to materials
> >
> > Because, as the person on the video says, programmers tend to assume
> > that what people want is information
> >
> > But the solution is not to spray the reference manual with bit of
> > tutorials here and there
> >
> > Because, according to the person talking, that decreases the quality
> > of both reference and tutorials
> >
> > Today I'm a bit busy but I'll submit a proper patch maybe tomorrow
>
> I think these are very good points.  I think that's where the
> difference between the Guix Manual and the Cookbook come from.
>
> The Guile manual is definitely a reference manual! :-)
>
> I'll await your update tomorrow.
>
> Alex
>
>
here we go

[-- Attachment #2: 0001-added-a-reference-to-guile-hall-in-the-manual.patch --]
[-- Type: text/x-patch, Size: 1498 bytes --]

From b79615f3058225ff086ceef5b3dd6537958b3fcd 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 to guile-hall in the manual

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

diff --git a/doc/ref/scheme-using.texi b/doc/ref/scheme-using.texi
index ac265fcca..a43ab0364 100644
--- a/doc/ref/scheme-using.texi
+++ b/doc/ref/scheme-using.texi
@@ -282,7 +282,7 @@ Run the optimizer on a piece of code and print the result.
 @deffn {REPL Command} disassemble exp
 Disassemble a compiled procedure.
 @end deffn
-
+  
 @deffn {REPL Command} disassemble-file file
 Disassemble a file.
 @end deffn
@@ -744,6 +744,25 @@ using a CPAN-like system.
 A complete list of guild scripts can be had by invoking @code{guild
 list}, or simply @code{guild}.
 
+@menu
+* guile-hall::
+@end menu
+
+
+@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.
+
 
 @node Installing Site Packages
 @section Installing Site Packages
-- 
2.25.1