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,gmane.lisp.guile.bugs 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@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="12641"; mail-complaints-to="usenet@ciao.gmane.io" To: guile-devel@gnu.org, bug-guile@gnu.org Original-X-From: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Sat Jul 20 15:12:10 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 1sV9sg-00037D-1p for guile-devel@m.gmane-mx.org; Sat, 20 Jul 2024 15:12:10 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1sV9sN-0003S1-CH; Sat, 20 Jul 2024 09:11:51 -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 1sV9sJ-0003Rg-ND; Sat, 20 Jul 2024 09:11:47 -0400 Original-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 ) 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@web.de; 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 Original-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 X-Provags-ID: V03:K1:6LloQ95pkLfBRu8BM+VD0RSHymWEKk87bFR8N6AveyXDnxDOOR0 EcIDZoFg3csVt/lfebSsX0cgIoxeecX/WAJw9xsilgsxLlWVBZVyeV9RHFAyfNddMmYRt9b zltyvyBKDw8S0uZmcJX+tGcc2J1+hrtVRA2V9tNkRUS+PnYj+3oDEwOoz3PMl338L8ocSx2 VN1Kab9BlPu+X6IBzC78A== 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/ERI Received-SPF: pass client-ip=212.227.17.12; envelope-from=arne_bab@web.de; 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-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:22591 gmane.lisp.guile.bugs:10905 Archived-At: --==-=-= 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 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----- --==-=-=--