From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: Alex Sassmannshausen Newsgroups: gmane.lisp.guile.user Subject: Re: [ANN] Guile Hall 0.3.0 released Date: Sun, 24 May 2020 23:22:51 +0200 Message-ID: <87pnatc9jo.fsf@gmail.com> References: <87k11bdh0k.fsf@gmail.com> <874ksfd2d0.fsf@gmail.com> <877dxaefr8.fsf@gmail.com> <87y2pqcmox.fsf@gmail.com> <79722626938f0660f261154a697ccd16198744e3.camel@gmail.com> Reply-To: alex.sassmannshausen@gmail.com Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="11176"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: mu4e 1.2.0; emacs 26.3 Cc: Guile User , Ludovic =?utf-8?Q?Court=C3=A8s?= To: Catonano Original-X-From: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Sun May 24 23:23:08 2020 Return-path: Envelope-to: guile-user@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jcy5L-0002rW-Mh for guile-user@m.gmane-mx.org; Sun, 24 May 2020 23:23:07 +0200 Original-Received: from localhost ([::1]:47544 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jcy5K-0007Yp-P2 for guile-user@m.gmane-mx.org; Sun, 24 May 2020 17:23:06 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:47042) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1jcy5B-0007YU-L6 for guile-user@gnu.org; Sun, 24 May 2020 17:22:57 -0400 Original-Received: from mail-ej1-x635.google.com ([2a00:1450:4864:20::635]:43981) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1jcy5A-0001T5-JL; Sun, 24 May 2020 17:22:57 -0400 Original-Received: by mail-ej1-x635.google.com with SMTP id a2so18613417ejb.10; Sun, 24 May 2020 14:22:55 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=references:user-agent:from:to:cc:subject:reply-to:in-reply-to:date :message-id:mime-version; bh=THnV9uuwqg4gOiTTan0XanLmMK6YLiALBPkYvczZkJU=; b=R83qrxqjsGh4zVgINfzlKehEwtRjyNjov1mqpCTKiwZY+eYTZEu1rR8nlAWV3ikKJr /Z5gSRI2kepJs2gAWQkKHWjY75eg6Aq3955fZQBNPCVL7tiqjSr/AdVIoks0KuC5vbu3 3gVAPcFdvOlhxlKCJ9WUAxjYK2Q45Z9bGTI7b1BjCOK8TOyteTA/4stxBTtG8QwnlzpN QnO8SHEToNh0WRYre9w/YFXAXlx5Nc3y1uTbVgJi038Wq27Q2wS8jPDpEeXu5pA2XpeB gi40+U1YUoCnAWC/OmSjfdReLD/9W7kXHvVw+UWvbc4cfLBO2U5403BdKLbPOq6kSCmp 7PSg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:references:user-agent:from:to:cc:subject :reply-to:in-reply-to:date:message-id:mime-version; bh=THnV9uuwqg4gOiTTan0XanLmMK6YLiALBPkYvczZkJU=; b=BiL5g3MFwm6b7ifmITS11vsLq8IUSUS/eupRlVefdbFjuKpDc46u3jkcqGGvI7S+k9 vQae4a0QbXtEOnbDAz39szf4Mu+dvLLfC7J5wjNDfzm69tCAVG4uNZHQz6GeaOS0lizB dITSSxJzIq0ZVLlGIhrrlPmuC1nb5RZ+dr8iUh5VuE2IaSciulPElDQ1vTBQEJUQIe6J 0hhVYJ8SXb2MDttXmgYYXF8neBXLKu/O3QuzRhAmQJitMvvgFYC5j4DGzsg++Mx1Bic9 I87Al4NW4USljj7CCTjeVswACkbOXb1GaATB7kktkuY5ixZ/Sv4kn1gQEFH5pWcx+jVk wMrQ== X-Gm-Message-State: AOAM533V6DHuPkSTfb5/fDKFqD2OgajQmzr7t3Qc7IDghs/3YS2Q1f6a 9bSXa/sbzT6DtNlA4NK4OFB4xSmFL10= X-Google-Smtp-Source: ABdhPJyyke+vSXwOYYlaEDqf1EJmQt1tDWQekeCYi1gl41y+Khd5MDhHcQO/jts4gOPM2bf9Z9i/jQ== X-Received: by 2002:a17:906:2455:: with SMTP id a21mr15922197ejb.73.1590355373606; Sun, 24 May 2020 14:22:53 -0700 (PDT) Original-Received: from watership ([2a02:a03f:643c:5900:f200:b379:1817:18a7]) by smtp.gmail.com with ESMTPSA id u20sm14067804edy.80.2020.05.24.14.22.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 24 May 2020 14:22:52 -0700 (PDT) In-reply-to: Received-SPF: pass client-ip=2a00:1450:4864:20::635; envelope-from=alex.sassmannshausen@gmail.com; helo=mail-ej1-x635.google.com X-detected-operating-system: by eggs.gnu.org: No matching host in p0f cache. That's all we know. X-Spam_score_int: -10 X-Spam_score: -1.1 X-Spam_bar: - X-Spam_report: (-1.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, FREEMAIL_REPLYTO=1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001 autolearn=_AUTOLEARN X-Spam_action: no action X-BeenThere: guile-user@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: General Guile related discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-user-bounces+guile-user=m.gmane-mx.org@gnu.org Original-Sender: "guile-user" Xref: news.gmane.io gmane.lisp.guile.user:16506 Archived-At: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hey Catonano, Sorry it took a bit longer for me to get around to it. I liked the style of your text. I've taken the liberty to expand on it some more =E2=80=94 but I'm happy to go with your version if you / the maintainers prefer. Also, I changed references from guile-hall to Hall. Whilst the name of the folder etc is guile-hall, the project itself is called Hall, or Guile Hall to make it part of the Guile family :-) I would love for this section to be added to the Guile manual. Wdyt? --=-=-= Content-Type: text/x-diff Content-Disposition: attachment; filename=0001-Added-a-reference-to-Guile-Hall-in-the-manual.patch >From 3f8c9fca63e3ddeb6f051d9d16e0c21b8cce8a30 Mon Sep 17 00:00:00 2001 From: Alex Sassmannshausen Date: Sun, 24 May 2020 23:18:32 +0200 Subject: [PATCH] Added a reference to Guile Hall in the manual. * doc/ref/scheme-using.texi: Add a section on Hall. --- doc/ref/scheme-using.texi | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/doc/ref/scheme-using.texi b/doc/ref/scheme-using.texi index ac265fcca..55ce778d2 100644 --- a/doc/ref/scheme-using.texi +++ b/doc/ref/scheme-using.texi @@ -744,6 +744,30 @@ using a CPAN-like system. A complete list of guild scripts can be had by invoking @code{guild list}, or simply @code{guild}. +@menu +* Hall:: +@end menu + + +@node Hall +@subsection Bootstrapping projects and distributing them + +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 commandline 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. + +In addition, the scaffold will include your basic Autotools setup, so +you don't have to take care of that yourself. 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. @node Installing Site Packages @section Installing Site Packages -- 2.23.0 --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Alex Catonano writes: > Il giorno gio 21 mag 2020 alle ore 12:03 Alex Sassmannshausen ha scritto: > > Heya, > > On Thu, 2020-05-21 at 12:00 +0200, Catonano wrote: > >=20 > >=20 > > Il giorno mer 20 mag 2020 alle ore 17:58 Catonano > > ha scritto: > > >=20 > > > Ok this is the last revision for today > > > Now I'm gonna do something else, really ! =F0=9F=98=80 > > >=20 > >=20 > >=20 > > So, today is another day and I have a new update > >=20 > > I'm watching this talk > > https://peertube.social/videos/watch/8f27a614-aa63-4811-af6a-b9e11effc= 399 > >=20 > > and it made up my mind that in this patch I'm intermingling reference > > type content and tutorial type content > >=20 > > Guile desperately lacks some good tutorial and how to materials > >=20 > > Because, as the person on the video says, programmers tend to assume > > that what people want is information > >=20 > > But the solution is not to spray the reference manual with bit of > > tutorials here and there > >=20 > > Because, according to the person talking, that decreases the quality > > of both reference and tutorials > >=20 > > 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 --=-=-=--