Subject: bug#72208: [PATCH] doc: tour: note the top-level modules ice-9, scheme, and srfi

From: "Dr. Arne Babenhauserheide" <[email-masked]>
Date: Sat, 20 Jul 2024 15:11:41 +0200

Hi,

the attached patch is a companion to the thread "The Guile junk drawer
and a C plea" in guile-devel.

Its goal is to ensure that newcomers learn early about the main module
prefixes provided by Guile: (scheme ...), (srfi ...), and (ice-9 ...).

From 929f5075be5d21c552e91931aca4a68fde348e21 Mon Sep 17 00:00:00 2001
From: Arne Babenhauserheide <[email-masked]>
Date: Sat, 20 Jul 2024 15:03:15 +0200
Subject: [PATCH] doc: reference ice-9, scheme, and srfi

* doc/ref/tour.texi (Using Modules): reference ice-9, scheme, and srfi.
---
 doc/ref/tour.texi | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/ref/tour.texi b/doc/ref/tour.texi
index c0ecb1699..7142394a5 100644
--- a/doc/ref/tour.texi
+++ b/doc/ref/tour.texi
@@ -210,6 +210,15 @@ processing or command line parsing.  Additionally, there exist many
 Guile modules written by other Guile hackers, but which have to be
 installed manually.
 
+Most provided modules use one of three different prefixes:
+
+@itemize @bullet
+@item @code{ice-9} includes guile-specific modules: the standard library of Guile. @xref{Status, History of ice-9, History of ice-9}
+@item @code{scheme} includes modules from the RnRS standard: @url{https://standards.scheme.org/}.
+@item @code{srfi} includes Scheme Requests For Implementation; SRFI’s: @url{https://srfi.schemers.org/}.
+@end itemize
+
+
 Here is a sample interactive session that shows how to use the
 @code{(ice-9 popen)} module which provides the means for communicating
 with other processes over pipes together with the @code{(ice-9
-- 
2.45.1

There may be more places where it could be useful to add references, so
newcomers are guided to easily know their way around what Guile
provides. This is the most obvious place I found, so I started there.

Best wishes,
Arne
-- 
Unpolitisch sein
heißt politisch sein,
ohne es zu merken.
draketo.de