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

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

[Dr. Arne Babenhauserheide]

[-- Attachment #1.1: Type: text/plain, Size: 250 bytes --]

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 ...).


[-- Attachment #1.2: 0001-doc-reference-ice-9-scheme-and-srfi.patch --]
[-- Type: text/x-patch, Size: 1352 bytes --]

From 929f5075be5d21c552e91931aca4a68fde348e21 Mon Sep 17 00:00:00 2001
From: Arne Babenhauserheide <arne_bab@web.de>
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


[-- Attachment #1.3: Type: text/plain, Size: 312 bytes --]


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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 1125 bytes --]

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

[Dr. Arne Babenhauserheide via Bug reports for GUILE, GNU's Ubiquitous Extension Language]

[-- Attachment #1.1: Type: text/plain, Size: 152 bytes --]

Hi,

Following my answer in the discussion (after checking the non-ice-9
prefixes), this may be a better representation of the modules Guile
provides:


[-- Attachment #1.2: 0001-doc-reference-ice-9-scheme-and-srfi.patch --]
[-- Type: text/x-patch, Size: 1629 bytes --]

From 6838e4da9712425e7e45805a73731bb399d90a86 Mon Sep 17 00:00:00 2001
From: Arne Babenhauserheide <arne_bab@web.de>
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 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/ref/tour.texi b/doc/ref/tour.texi
index c0ecb1699..91eb10bb9 100644
--- a/doc/ref/tour.texi
+++ b/doc/ref/tour.texi
@@ -210,6 +210,16 @@ 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 prefixes based on their origin:
+
+@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{rnrs} and @code{scheme} include modules from the RnRS standard (@url{https://standards.scheme.org/}). @xref{R7RS Support} and @xref{R6RS Support}
+@item @code{srfi} includes Scheme Requests For Implementation; SRFI’s (@url{https://srfi.schemers.org/}). @xref{SRFI Support}
+@item Some larger features have their own prefix. These include @code{web} (@pxref{Web}), @code{oop} (@xref{GOOPS}), @code{sxml} (@pxref{SXML}), and @code{language} (@pxref{Other Languages}).
+@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


[-- Attachment #1.3: Type: text/plain, Size: 101 bytes --]


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

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 1125 bytes --]

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

[Ludovic Courtès]

Hello,

"Dr. Arne Babenhauserheide" <arne_bab@web.de> skribis:

> From 6838e4da9712425e7e45805a73731bb399d90a86 Mon Sep 17 00:00:00 2001
> From: Arne Babenhauserheide <arne_bab@web.de>
> 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.

Good idea!

> +Most provided modules use prefixes based on their origin:
> +
> +@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}

s/guile/Guile/

Also: please leave two spaces after an end-of-sentence period and add a
semicolon at the end of the line.

> +@item @code{rnrs} and @code{scheme} include modules from the RnRS standard (@url{https://standards.scheme.org/}). @xref{R7RS Support} and @xref{R6RS Support}

s/RnRS standard/Scheme standards/

Likewise, semicolon at the end of the line

> +@item @code{srfi} includes Scheme Requests For Implementation; SRFI’s (@url{https://srfi.schemers.org/}). @xref{SRFI Support}

Rather:

  … includes @uref{https://srfi.schemers.org/, Scheme Requests for
  Implementation or ``SRFIs''} (@pxref{SRFI Support});

> +@item Some larger features have their own prefix. These include @code{web} (@pxref{Web}), @code{oop} (@xref{GOOPS}), @code{sxml} (@pxref{SXML}), and @code{language} (@pxref{Other Languages}).

s/@xref{GOOPS}/@pxref{GOOPS}/ (since it’s in parentheses)

Fine with me with these changes!

Ludo’.