[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Guile-commits] 01/06: doc: Add reference to Guile Hall in the manual.
From: |
Ludovic Courtès |
Subject: |
[Guile-commits] 01/06: doc: Add reference to Guile Hall in the manual. |
Date: |
Wed, 27 May 2020 16:48:40 -0400 (EDT) |
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:
- [Guile-commits] branch master updated (db4af31 -> 4310567), Ludovic Courtès, 2020/05/27
- [Guile-commits] 02/06: GUILE_PKG bails out when 'pkg-config' is missing, Ludovic Courtès, 2020/05/27
- [Guile-commits] 03/06: doc: Reword unclear sentence about programs., Ludovic Courtès, 2020/05/27
- [Guile-commits] 06/06: doc: Fix a few typos in vm section., Ludovic Courtès, 2020/05/27
- [Guile-commits] 04/06: doc: Rephrase documentation of 'thunk?'., Ludovic Courtès, 2020/05/27
- [Guile-commits] 05/06: doc: Fix typos in the manual., Ludovic Courtès, 2020/05/27
- [Guile-commits] 01/06: doc: Add reference to Guile Hall in the manual.,
Ludovic Courtès <=