From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: "Dr. Arne Babenhauserheide" Newsgroups: gmane.lisp.guile.devel Subject: bug#72208 [PATCH] doc: tour: note the top-level modules ice-9, scheme, and srfi Date: Sat, 20 Jul 2024 17:03:01 +0200 Message-ID: <87y15wjeca.fsf@web.de> References: <87plr8ky2a.fsf@web.de> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="==-=-="; micalg=pgp-sha256; protocol="application/pgp-signature" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="13202"; mail-complaints-to="usenet@ciao.gmane.io" Cc: guile-devel@gnu.org To: 72208@debbugs.gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Sat Jul 20 17:03:39 2024 Return-path: Envelope-to: guile-devel@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 1sVBcY-0003DB-KB for guile-devel@m.gmane-mx.org; Sat, 20 Jul 2024 17:03:38 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sVBcF-0002Z9-OW; Sat, 20 Jul 2024 11:03:19 -0400 Original-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 ) id 1sVBcE-0002Yv-6F for guile-devel@gnu.org; Sat, 20 Jul 2024 11:03:18 -0400 Original-Received: from mout.web.de ([212.227.15.3]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1sVBcC-0003r0-BV for guile-devel@gnu.org; Sat, 20 Jul 2024 11:03:17 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=web.de; s=s29768273; t=1721487785; x=1722092585; i=arne_bab@web.de; 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 Original-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 In-Reply-To: (GNU bug Tracking System's message of "Sat, 20 Jul 2024 13:12:02 +0000") X-Provags-ID: V03:K1:iAVn0w7sgmLpfhizLeq8pHVPPmV+v9WJu+RpTInKDu1JZkfaVnf AbZU6K6SRym1QhVN7tS+wo2EN3LNgqNYEtBScrZOLesns1O3K+zVPQBJqK9/6RUH/2mUR9a +1iiHvJQVpm7SIzaJEt5Rf/jVjdbfgOaBh+/Ff+nkeM6fe6wkUwnSeDm9TEnB/A8mk4YOmX 3nVLIPnM40s7PCvxp5wcw== 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+vBxWi4vHYqMb Received-SPF: pass client-ip=212.227.15.3; envelope-from=arne_bab@web.de; helo=mout.web.de X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_DNSWL_LOW=-0.7, 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-BeenThere: guile-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Developers list for Guile, the GNU extensibility library" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Original-Sender: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.lisp.guile.devel:22595 Archived-At: --==-=-= 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 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----- --==-=-=--