Received: (at 72208) by debbugs.gnu.org; 26 Oct 2024 17:27:49 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Oct 26 13:27:49 2024
Received: from localhost ([127.0.0.1]:42436 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1t4kZp-0000OM-7M
for submit <at> debbugs.gnu.org; Sat, 26 Oct 2024 13:27:49 -0400
Received: from eggs.gnu.org ([209.51.188.92]:43844)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <ludo@HIDDEN>) id 1t4kZm-0000O2-Tr
for 72208 <at> debbugs.gnu.org; Sat, 26 Oct 2024 13:27:47 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.90_1) (envelope-from <ludo@HIDDEN>)
id 1t4kZ9-0000J2-28; Sat, 26 Oct 2024 13:27:07 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To:
From; bh=qE9jfdg5J53yDayIThFIwNmSkl9l4zQVknn4X+YLyM0=; b=ZwJNCjO+zO4SHwOg6Llc
SH9frTTsCePhEiMQFcooappBGUtFvqqPAhriRh6Af2rjOXIGCwoyM/NvOm+ef4eLJMCW9dAT21/rp
RLdh3y6Rh0IcaW4X6LRxg8DM8V2KtzAIfuaQlnMA1uQnfhX+dZBwnvUKh5CLwtcspvRwWXwIHWCjF
6hxJOnIOy6VOJPFjIHvR1KYsdnboe9Hx/fFdDcwQjDQFvdsn1fSLxwFXxRIbgvyyqf9NDA2/BAR1m
lnC7nR2s1JRIheodUOJjiCk+HS4lqczTxqoNj4B2GUBCnJZ9lBKIsI22aJKq8IHt/ZSajkJWDK3oK
lYc5lwfnV5taVA==;
From: =?utf-8?Q?Ludovic_Court=C3=A8s?= <ludo@HIDDEN>
To: "Dr. Arne Babenhauserheide" <arne_bab@HIDDEN>
Subject: Re: bug#72208: [PATCH] doc: tour: note the top-level modules ice-9,
scheme, and srfi
In-Reply-To: <87y15wjeca.fsf@HIDDEN> (Arne Babenhauserheide's message of "Sat,
20 Jul 2024 17:03:01 +0200")
References: <87plr8ky2a.fsf@HIDDEN>
<handler.72208.B.17214811119924.ack <at> debbugs.gnu.org>
<87y15wjeca.fsf@HIDDEN>
Date: Sat, 26 Oct 2024 19:27:04 +0200
Message-ID: <87a5eqvkpj.fsf@HIDDEN>
User-Agent: Gnus/5.13 (Gnus v5.13)
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 72208
Cc: 72208 <at> debbugs.gnu.org, guile-devel@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)
Hello,
"Dr. Arne Babenhauserheide" <arne_bab@HIDDEN> skribis:
> From 6838e4da9712425e7e45805a73731bb399d90a86 Mon Sep 17 00:00:00 2001
> From: Arne Babenhauserheide <arne_bab@HIDDEN>
> 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 standa=
rd (@url{https://standards.scheme.org/}). @xref{R7RS Support} and @xref{R6R=
S Support}
s/RnRS standard/Scheme standards/
Likewise, semicolon at the end of the line
> +@item @code{srfi} includes Scheme Requests For Implementation; SRFI=E2=
=80=99s (@url{https://srfi.schemers.org/}). @xref{SRFI Support}
Rather:
=E2=80=A6 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{we=
b} (@pxref{Web}), @code{oop} (@xref{GOOPS}), @code{sxml} (@pxref{SXML}), an=
d @code{language} (@pxref{Other Languages}).
s/@xref{GOOPS}/@pxref{GOOPS}/ (since it=E2=80=99s in parentheses)
Fine with me with these changes!
Ludo=E2=80=99.
bug-guile@HIDDEN:bug#72208; Package guile.
Full text available.
Received: (at 72208) by debbugs.gnu.org; 20 Jul 2024 15:03:15 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jul 20 11:03:15 2024
Received: from localhost ([127.0.0.1]:53748 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1sVBcB-0006Kw-7O
for submit <at> debbugs.gnu.org; Sat, 20 Jul 2024 11:03:15 -0400
Received: from mout.web.de ([212.227.15.3]:51937)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <arne_bab@HIDDEN>) id 1sVBc9-0006Kf-2G
for 72208 <at> debbugs.gnu.org; Sat, 20 Jul 2024 11:03:14 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=web.de;
s=s29768273; t=1721487785; x=1722092585; i=arne_bab@HIDDEN;
bh=y3Ct1wsoSOdoL5kmS1jzeHA5sPzeovuGgQf76VgvMP0=;
h=X-UI-Sender-Class:From:To:Cc:Subject:In-Reply-To:References:Date:
Message-ID:MIME-Version:Content-Type:cc:content-transfer-encoding:
content-type:date:from:message-id:mime-version:reply-to:subject:
to;
b=wQECyb5HBBYqgyDmbCI64PjIEbjfnfaXx36Ny8GCEPY2nh1GejfvXgEDRieHE5Rp
kqQ2EwlUQuk3uvOL52reIaNqXga5+R0OEUey4Z5xgm7wVs0ayVEE+N7dCn07dkv6H
XtlcYHOnyrOMLoqEDdIZcm+RKZSrjtV4FSpFKqsG0l1TC7Rti7aaIgR2VFo7RKNGI
U0Pf+qFUkgThpcQ0MpUmxSnwxUdTYORFi3nFGRgcOBsKl0r7D3atrZNQoX4sh+RTx
9L8cJRXM32yXoiutYsM1fX2z0U1lFWPVCPbNjz6cAt3K2JBdq+/WQXSeN68YJaqC8
hsyLhso5UCIPDxUtpg==
X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6
Received: from fluss ([84.165.21.10]) by smtp.web.de (mrweb005
[213.165.67.108]) with ESMTPSA (Nemesis) id 1MAtwr-1sbYK81PaL-007qGa; Sat, 20
Jul 2024 17:03:05 +0200
From: "Dr. Arne Babenhauserheide" <arne_bab@HIDDEN>
To: 72208 <at> debbugs.gnu.org
Subject: bug#72208 [PATCH] doc: tour: note the top-level modules ice-9,
scheme, and srfi
In-Reply-To: <handler.72208.B.17214811119924.ack <at> debbugs.gnu.org> (GNU bug
Tracking System's message of "Sat, 20 Jul 2024 13:12:02 +0000")
References: <87plr8ky2a.fsf@HIDDEN>
<handler.72208.B.17214811119924.ack <at> debbugs.gnu.org>
Date: Sat, 20 Jul 2024 17:03:01 +0200
Message-ID: <87y15wjeca.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="==-=-=";
micalg=pgp-sha256; protocol="application/pgp-signature"
X-Provags-ID: V03:K1:iAVn0w7sgmLpfhizLeq8pHVPPmV+v9WJu+RpTInKDu1JZkfaVnf
AbZU6K6SRym1QhVN7tS+wo2EN3LNgqNYEtBScrZOLesns1O3K+zVPQBJqK9/6RUH/2mUR9a
+1iiHvJQVpm7SIzaJEt5Rf/jVjdbfgOaBh+/Ff+nkeM6fe6wkUwnSeDm9TEnB/A8mk4YOmX
3nVLIPnM40s7PCvxp5wcw==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:EmZrlE27wvc=;ZAUdXwqG5eYA0ZRLEiGKL9EHKJq
z1dO7tLjQT9QlXealvzod6LXz1lpGd21vELt9aSmqmo7tBFgSHsZkqeYWlFdQFK6FP5/Jaj0U
c6Nd4hzWR4iQk6CjinleMB7LRy7F2hXTa9VOD8vUPhlH15g+QzbGtg8rjWs3qPLB/X5hzmZPG
/uGNRdW8Ow812ypv5ePHlUGov38+guZfuaTGYE7VoroKHe+Wi3sTsGld1y6/RD1J/InIQDqet
4X5sz0dHUF4vFfb5dDEMAUPJ1+1UvogiEvnQscvh6eqjP/iM/BMYahbvFToZGhnj+LatULAbh
YIxyj+MLjmubklHVYskhgtU874kH5fj+HlXhM5jZMM5y+lPsRGuga1jpN5aefwBgerdggo0Bj
3SFGibB6UvutJaC9OZRceWPy6j/ntYBIjTosq9l26GMlna/T+w7oqi7sc7T2WjZmfzneF18l/
Dia1jV04ELizjNLmsQqe/rQ0Zj5pvsltm6NkeIUOCpe3DfCSMz5Szq+TuoqjNGjGl6LQ08CDJ
fM7dBgrMzE99dUN8kxsca7fwEUV2P0XTGsaabUJlTJ7JR393z7MJdVLLKtfVniZppNCXGaVSj
uB2J72epkKTwRaBnFMc6UQ7JyES32FbsTu8N2w7zPOAbrF65b2tVbdJOC57CaSY9XjgbN3RT9
iRmGCtYmG/LzdX67a0Q0Xe/1gVfpICeJHzf+U32bhJSY8XzqdnilCQA/Krzt6S/oR3il+UR4H
ct/kY3aQKpQZ2xSxIccL4tmNXnMvdpagv7EXvRDoVehePVFrqslmP6689G5+vBxWi4vHYqMbL
LDsiY0AmftTnbhcpptREQBSa2fTGMyo8oqdeRQgZdMZ/I=
X-Spam-Score: -0.7 (/)
X-Debbugs-Envelope-To: 72208
Cc: guile-devel@HIDDEN
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.7 (-)
--==-=-=
Content-Type: multipart/mixed; boundary="=-=-="
--=-=-=
Content-Type: text/plain
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:
--=-=-=
Content-Type: text/x-patch; charset=utf-8
Content-Disposition: inline;
filename=0001-doc-reference-ice-9-scheme-and-srfi.patch
Content-Transfer-Encoding: quoted-printable
From=206838e4da9712425e7e45805a73731bb399d90a86 Mon Sep 17 00:00:00 2001
From: Arne Babenhauserheide <arne_bab@HIDDEN>
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.
=2D--
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
=2D-- a/doc/ref/tour.texi
+++ b/doc/ref/tour.texi
@@ -210,6 +210,16 @@ processing or command line parsing. Additionally, the=
re exist many
Guile modules written by other Guile hackers, but which have to be
installed manually.
=20
+Most provided modules use prefixes based on their origin:
+
+@itemize @bullet
+@item @code{ice-9} includes guile-specific modules: the standard library o=
f 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=E2=80=
=99s (@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
=2D-=20
2.45.1
--=-=-=
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Best wishes,
Arne
=2D-=20
Unpolitisch sein
hei=C3=9Ft politisch sein,
ohne es zu merken.
draketo.de
--=-=-=--
--==-=-=
Content-Type: application/pgp-signature; name="signature.asc"
-----BEGIN PGP SIGNATURE-----
iQJEBAEBCAAuFiEE801qEjXQSQPNItXAE++NRSQDw+sFAmab0aYQHGFybmVfYmFi
QHdlYi5kZQAKCRAT741FJAPD60yfD/9OtRIj98c/cU89D/CDOz6yR2qXVwdTWTOR
ev127ADlsSRkvrxmX6Li49bWIzhYQGtg31pM2agYZ4vwD76rrOYoGZ793w3SltMu
Lm11UtP28+umAprBMis7IOKGPLnVbMHkO6wTYthvwwtyJ0ExRDeRh6DeXY6odibL
TjIjVcDNexRENGGyLBhaxpFHznhRPrV9SmQPBQphZqMnNMI4+dClFr6pAoa3JNny
nooQoCwUxYNSgpA53PFJGHrlEm07oee+AOcrRbJL7r1a33w2aQ46dTz5nBWSrelq
PDV6WtDZH8g02NVSgv8eW3jrAHo9wza3Ne57AGaiZpzXWatFeVv7uZ7Pe8Rb8hf/
B7N2u4H3Bi3hZj6A39xIxltEZzyMdQsZws3uGjFM9mEj/y37u5pAVNgODNyaxbmb
SljNb8/Qa+RoVM3ct68Gy4ffezl982trJcucFRaCGiY3FF4kx8sGuOHXPZuzFtUh
8rOmVYb3pkW5ZRwpYxVcvEIAC90bt+Jb6DZsLmHTfregWFyZyAIOPg0DplOVa8CM
1XlrgcjsU4KQWQ/ZX7cvzRpea3Iuyjt5QQ+8qvfI9/P1xHZqYZuu4fR7szws+A16
yflT4ZTHGGc+gNb0n/IVzQBTu0couMeUYg1vCosV5rI9KTA+8C/KQAc6pSIVCxRz
8qZLAUZJKojEBAEBCAAuFiEE3Si95tmHXKvOSosd3M8NswvBBUgFAmab0aYQHGFy
bmVfYmFiQHdlYi5kZQAKCRDczw2zC8EFSAh/A/wNxvTXlSyz9Sv21WkPTfurZv5g
5WWPWkBzwXZXGriZNZWK9QD7TitjcEwT1nSfpmUmQ7WoeD8yP09Z+FEumwIhGqo+
ACvF4W5i3/D4OJIqHW2MYUwB236T1jp15JQnR7/xGHJtbv3WBn1QGVZu5aWNt1ZD
T3ikDQpaptztWGpWMQ==
=GoMT
-----END PGP SIGNATURE-----
--==-=-=--
bug-guile@HIDDEN:bug#72208; Package guile.
Full text available.
Received: (at submit) by debbugs.gnu.org; 20 Jul 2024 13:11:51 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Sat Jul 20 09:11:51 2024
Received: from localhost ([127.0.0.1]:51929 helo=debbugs.gnu.org)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
id 1sV9sM-0002Zz-JS
for submit <at> debbugs.gnu.org; Sat, 20 Jul 2024 09:11:50 -0400
Received: from lists.gnu.org ([209.51.188.17]:44878)
by debbugs.gnu.org with esmtp (Exim 4.84_2)
(envelope-from <arne_bab@HIDDEN>) id 1sV9sK-0002Zq-Fn
for submit <at> debbugs.gnu.org; Sat, 20 Jul 2024 09:11:49 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10])
by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.90_1) (envelope-from <arne_bab@HIDDEN>)
id 1sV9sJ-0003Rg-ND; Sat, 20 Jul 2024 09:11:47 -0400
Received: from mout.web.de ([212.227.17.12])
by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
(Exim 4.90_1) (envelope-from <arne_bab@HIDDEN>)
id 1sV9sG-0007mr-T3; Sat, 20 Jul 2024 09:11:46 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=web.de;
s=s29768273; t=1721481102; x=1722085902; i=arne_bab@HIDDEN;
bh=Ui4uQCPRKY9a/pIiyVDQG7GzNhWadYVe+XzFarhyKXY=;
h=X-UI-Sender-Class:From:To:Subject:Date:Message-ID:MIME-Version:
Content-Type:cc:content-transfer-encoding:content-type:date:from:
message-id:mime-version:reply-to:subject:to;
b=p9XkZoDqRI6cIdsyB52vuBQx5919ab4yseSoAkDxPP8iL3MytLf32IY9beFtz426
U+V2iYLFLeuBH20++LlzU0/COQMbWXosX0FBxwxGvABXCD6urP550/jDeVNWE542k
bF49U6Fv0OqrLbkECCm8+Xviz7yZpW5TJJ46EmlZXixUGJG71bw2lclUdKuW6eqNY
Ju5fZfKso3hE7TJGQ52QhFXBXpI8fA+rLm0DMw1h2onG+eQqsN1Lg2LW4A3+wBM7l
uJgmeEi45Vr9iFG3oG4ilSKFSOzWGkqNCZIOw75ljaqfowEuLKfhuf3XTYze9w2nK
M5aEAMOgYHr3M/ihRQ==
X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6
Received: from fluss ([84.165.21.10]) by smtp.web.de (mrweb106
[213.165.67.124]) with ESMTPSA (Nemesis) id 1Mfc8o-1rpDLq3Bto-00fVti; Sat, 20
Jul 2024 15:11:42 +0200
From: "Dr. Arne Babenhauserheide" <arne_bab@HIDDEN>
To: guile-devel@HIDDEN, bug-guile@HIDDEN
Subject: [PATCH] doc: tour: note the top-level modules ice-9, scheme, and srfi
Date: Sat, 20 Jul 2024 15:11:41 +0200
Message-ID: <87plr8ky2a.fsf@HIDDEN>
MIME-Version: 1.0
Content-Type: multipart/signed; boundary="==-=-=";
micalg=pgp-sha256; protocol="application/pgp-signature"
X-Provags-ID: V03:K1:6LloQ95pkLfBRu8BM+VD0RSHymWEKk87bFR8N6AveyXDnxDOOR0
EcIDZoFg3csVt/lfebSsX0cgIoxeecX/WAJw9xsilgsxLlWVBZVyeV9RHFAyfNddMmYRt9b
zltyvyBKDw8S0uZmcJX+tGcc2J1+hrtVRA2V9tNkRUS+PnYj+3oDEwOoz3PMl338L8ocSx2
VN1Kab9BlPu+X6IBzC78A==
X-Spam-Flag: NO
UI-OutboundReport: notjunk:1;M01:P0:TfseFhAG4/o=;lpD5VNs4lZJjBDXMA/a4wD+blxW
iHJMU9odMV3hYDMjI4FYVd6Ry+PUjVQF2VKJpx7k5tn9vbJZPve0QSE8iLiPe9za4iSd+c7Dt
OQYsJYeUdjBgO+HpS4K/4MJgz7gtbDqHmQwF9krV7QOR3lPC+83LNcpcbhhnAhyKvmqoYm8Y4
CO/YsQmdfB2F4Gk7moJuuCZJBCg+A7PXCRyWlOu3WvpXL8vV8GlLRtW8edB+P9CP5+KFqKyRZ
M1YJZyCDUAPmB3XpSnzBlQ/8E09hd+M4WXf5Hnp8bs50dbTSrsPAp+G/yMSSOa4ZfUCjzR3On
iGadbf8LzXunXQEFP7fWBwF9kMqQjSBHoqN5gErQ5S/Y4KukhCc/mM/poSORGMjJs8Ioxn3lG
ALzrNuazOWpBTXdWz+LanrSmUQB2aB5tujc8QNiGGs5aCGA/ZgTZm71Etmv9x7h4uH92i8F8l
LYUWsm030uXoIq+OQm6Q3dHrt1/UqnGgSyq1vxwdomjoC08G4cFRI7/j1Xr5lFh0gNrlRrYM2
1F3xUe6CiaWNiEfuCV/iiglzSaQkxrWa8+OHtAWEM6ZL2cTjPJR/jHL0oL3Vdvh1y0+blO9d/
FkwEff2EubdyxcEbuAm3wOiE2aMiz0gxLJ90wKlHVuME5Qa8hObuBfesdcgSi7iincvL7JL4E
+UnzEknfe+9EEupIIAni44qkngIfkBboK6XDHSMcVGcc8RRHnM8Kr/3vM7PXcFj3s7N0XxkrT
0s+rJtnuLYwtJNj8N6sA1rQoOZQY64vjAXPFxCiKqyubFKOJE7wswolOvDYZpD6MGQfv/ERIy
pzVGGpzN52bxgyEdjSSUhOJA==
Received-SPF: pass client-ip=212.227.17.12; envelope-from=arne_bab@HIDDEN;
helo=mout.web.de
X-Spam_score_int: -20
X-Spam_score: -2.1
X-Spam_bar: --
X-Spam_report: (-2.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,
RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_NONE=0.001,
SPF_PASS=-0.001 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-Spam-Score: -1.3 (-)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>,
<mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -2.3 (--)
--==-=-=
Content-Type: multipart/mixed; boundary="=-=-="
--=-=-=
Content-Type: text/plain
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 ...).
--=-=-=
Content-Type: text/x-patch; charset=utf-8
Content-Disposition: inline;
filename=0001-doc-reference-ice-9-scheme-and-srfi.patch
Content-Transfer-Encoding: quoted-printable
From=20929f5075be5d21c552e91931aca4a68fde348e21 Mon Sep 17 00:00:00 2001
From: Arne Babenhauserheide <arne_bab@HIDDEN>
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.
=2D--
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
=2D-- a/doc/ref/tour.texi
+++ b/doc/ref/tour.texi
@@ -210,6 +210,15 @@ processing or command line parsing. Additionally, the=
re exist many
Guile modules written by other Guile hackers, but which have to be
installed manually.
=20
+Most provided modules use one of three different prefixes:
+
+@itemize @bullet
+@item @code{ice-9} includes guile-specific modules: the standard library o=
f 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=E2=80=
=99s: @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
=2D-=20
2.45.1
--=-=-=
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
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
=2D-=20
Unpolitisch sein
hei=C3=9Ft politisch sein,
ohne es zu merken.
draketo.de
--=-=-=--
--==-=-=
Content-Type: application/pgp-signature; name="signature.asc"
-----BEGIN PGP SIGNATURE-----
iQJEBAEBCAAuFiEE801qEjXQSQPNItXAE++NRSQDw+sFAmabt44QHGFybmVfYmFi
QHdlYi5kZQAKCRAT741FJAPD68xcEACKeJzbgQD6C2i5VxPm/LucmYsW7bT1tOEL
4mWLiSIPFF5DZkOf9sEeNDLz5Yc4mcbLqqaXK63wk4LV9JC0LLq1Ut53QALriNgO
pkeIiHU1nUmgxKypZx3Huwpk1zC6T/eO21rxmuSItwiTvMFKwSO9Gpz6DZVdUfUj
YOWYXiDdcVTG9E42xp3FujLrFa1e1swdFX3Yvbu36v/64uvjdN6fjU5pF9U+2503
wQo4o2Q5MPOXefE2qfvg0qbXqlxjZnBr4OSKBa18xBNKyZD1RiIzjIMvIqv2eAvk
iz9YS0onJCyXrRINg9UZ6kaEFFUIWzGxkHhMKVfzO4rAQvhOHeDYpCiLqfgFrPxG
Ir/dNIZUgICvk8Wc29seYKaoa4Kg47FfCQ7gdvvwG1yVNbPG/Avsy/dfcyYS+7+E
uOioO6zTRbsm5h70HhI9NxA6YU3y7Z9POttkIX4xVUystbyy/XU3/lIVoIrGzRVC
8q517VfeB6jXxwR8J/IyLTZ8nOEiUYffEN/lBQcyornIBFdnA0ypVS5bXk/gb6/G
mgAuMut03FgOzKejOUUHyuYGWyDSVI7rZwx0ZwnGMruVUPnh0MMzH+90VcUICkO3
BN4XZG7VwJ4ecXrwdyXSYEI3JlkYfdT3178co6b6H38qELcqcZSMZbgge8w1YRzn
+7PzeLJ21YjEBAEBCAAuFiEE3Si95tmHXKvOSosd3M8NswvBBUgFAmabt44QHGFy
bmVfYmFiQHdlYi5kZQAKCRDczw2zC8EFSJFUA/0cSdjm/8IKkXy0Z6H+QRPMWZUz
DR2lUb4J6CZSitf9RxVZjgn978GxEMyqgWxThHCCnR9s4voETNcLYGR5snMQpxem
ZN1ChY0aKdPq+Un/JwLco2UzbFOxwhCe5XUN3N5NcJIYU2/vHc2aadeIyQY1ilyk
myO0EB32nvGsOmDsrw==
=VGBg
-----END PGP SIGNATURE-----
--==-=-=--
"Dr. Arne Babenhauserheide" <arne_bab@HIDDEN>:bug-guile@HIDDEN.
Full text available.bug-guile@HIDDEN:bug#72208; Package guile.
Full text available.
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997 nCipher Corporation Ltd,
1994-97 Ian Jackson.