From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Tomas Volf <~@wolfsden.cz> Newsgroups: gmane.lisp.guile.bugs Subject: bug#71300: [PATCH v4] doc: Document SRFI 64. Date: Sun, 22 Sep 2024 14:30:16 +0200 Message-ID: <877cb3hnvr.fsf@wolfsden.cz> References: <20240601021743.808-1-maxim.cournoyer@gmail.com> <20240915042603.8529-1-maxim.cournoyer@gmail.com> Mime-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="14048"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Cc: 71300@debbugs.gnu.org, Filip =?UTF-8?Q?=C5=81ajszczak?= , Maxime Devos To: Maxim Cournoyer Original-X-From: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Sun Sep 22 14:31:09 2024 Return-path: Envelope-to: guile-bugs@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 1ssLk5-0003Sa-As for guile-bugs@m.gmane-mx.org; Sun, 22 Sep 2024 14:31:09 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ssLjh-0001eM-2K; Sun, 22 Sep 2024 08:30:45 -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 1ssLje-0001Vx-DB for bug-guile@gnu.org; Sun, 22 Sep 2024 08:30:42 -0400 Original-Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ssLje-000667-3s for bug-guile@gnu.org; Sun, 22 Sep 2024 08:30:42 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=Ayu/cSC5y/ej4PyTb5l7aJcrh4wuxM37h7TQUIcag3k=; b=iFE8lNlk4Cqrq6rINYIfyEwRcfnSbWllMAAtvi3sdlPzdtdC4Pxh0xC04rLbbJeWp9dgwzBons6eJDw4TwF/V78daP0Ugch88O2ovzxo/CKmozlFVOfihDSpeAVf14wZfcmP/QTnrcz6ZdzBJqq1ab/vpVbOFCP6YXE9pHTljlil5fYJOtysfQhiN51cfNM3S/KyabYSxU/nFyakDBKVRaqwZRClzO/T2Uni/DhRRIpVZ4ftnVAuBGV80T5EJsgGzc7miGXkip0lMOSi5cilx4wQvj7JHzoHShOUlNyLJEx9tVIOazOn4l1UrI4cLTOSiBYYwzAW/TUuqqJjs+kKZg==; Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ssLjy-0007so-CD for bug-guile@gnu.org; Sun, 22 Sep 2024 08:31:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Tomas Volf <~@wolfsden.cz> Original-Sender: "Debbugs-submit" Resent-CC: bug-guile@gnu.org Resent-Date: Sun, 22 Sep 2024 12:31:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 71300 X-GNU-PR-Package: guile X-GNU-PR-Keywords: patch Original-Received: via spool by 71300-submit@debbugs.gnu.org id=B71300.172700824530272 (code B ref 71300); Sun, 22 Sep 2024 12:31:02 +0000 Original-Received: (at 71300) by debbugs.gnu.org; 22 Sep 2024 12:30:45 +0000 Original-Received: from localhost ([127.0.0.1]:41059 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssLjg-0007sC-NQ for submit@debbugs.gnu.org; Sun, 22 Sep 2024 08:30:44 -0400 Original-Received: from wolfsden.cz ([37.205.8.62]:33710) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from <~@wolfsden.cz>) id 1ssLjd-0007s1-N6 for 71300@debbugs.gnu.org; Sun, 22 Sep 2024 08:30:43 -0400 Original-Received: by wolfsden.cz (Postfix, from userid 104) id 7703332705F; Sun, 22 Sep 2024 12:30:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1727008218; bh=1KS/oMzL6bRdtdQNNnAXMIA1jD6wfDt96TwcwtWlpnc=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=eJ8/B9zaT1VXuIuKfYlw/gIx28ym5aEVKgc2U4TWFd0+pUAaa4CC/gqG/KO1zbYyr NxSMvo1rdC/u2AsNb3ySTD8/RnPjHAX1nrsyLk2unKrp83UePPlLOLBnf7WefnvVM9 Pcvx/uZ0QZf2YOUDZ9fY8WWE7Bev4aHonAtWYT/oxoZ8QtDw+agi4rZhRiFvErFsCd ST4BXcl6qgkCcC8tfJVpBZriNqb2bIcKbOrN73Q3DrKz/gsy7uTUnUNwWWpdnLwssd xbIES4sA+UGUVXJ+5HTQKrNFTFit3PC7G7Vr5tlXAyqiC42KEor3Gxeu1AFlAxcGgs vV4cH4laUfb4igqchmhj+Ex83Ir32yuxuFcXR2S4yTOHWie04tYA/l9CVgVDIDjt0Y A6K6J5JTylpY2bBRd0xwTitwgi+KLcfcitPoRqD7eTLDeQcB3m7De4qXDHefAWr6sM 2W0ky0dTDUVM+NXfhLx96xZ7ur7ib0yxaBEpB9guUTHMEvy5Fcib2lAoLwTQy5p+Jw CVpphs9zrUPiXZYmys9d1zcVszG7HRYgUuXcW4q5nkcoM8gPlZw2O9RrwuW10UQRJ7 KOnOS9+Wh5xDQjAUiiJleDZBpJBBR3gYybDnwThR5MApW6xGj2v175ZhKVFHznupG0 5fBO7usgqqYG0Ffr28JSCr/U= Original-Received: from localhost (unknown [128.0.188.242]) by wolfsden.cz (Postfix) with ESMTPSA id 3536B3269D5; Sun, 22 Sep 2024 12:30:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=wolfsden.cz; s=mail; t=1727008218; bh=1KS/oMzL6bRdtdQNNnAXMIA1jD6wfDt96TwcwtWlpnc=; h=From:To:Cc:Subject:In-Reply-To:References:Date; b=eJ8/B9zaT1VXuIuKfYlw/gIx28ym5aEVKgc2U4TWFd0+pUAaa4CC/gqG/KO1zbYyr NxSMvo1rdC/u2AsNb3ySTD8/RnPjHAX1nrsyLk2unKrp83UePPlLOLBnf7WefnvVM9 Pcvx/uZ0QZf2YOUDZ9fY8WWE7Bev4aHonAtWYT/oxoZ8QtDw+agi4rZhRiFvErFsCd ST4BXcl6qgkCcC8tfJVpBZriNqb2bIcKbOrN73Q3DrKz/gsy7uTUnUNwWWpdnLwssd xbIES4sA+UGUVXJ+5HTQKrNFTFit3PC7G7Vr5tlXAyqiC42KEor3Gxeu1AFlAxcGgs vV4cH4laUfb4igqchmhj+Ex83Ir32yuxuFcXR2S4yTOHWie04tYA/l9CVgVDIDjt0Y A6K6J5JTylpY2bBRd0xwTitwgi+KLcfcitPoRqD7eTLDeQcB3m7De4qXDHefAWr6sM 2W0ky0dTDUVM+NXfhLx96xZ7ur7ib0yxaBEpB9guUTHMEvy5Fcib2lAoLwTQy5p+Jw CVpphs9zrUPiXZYmys9d1zcVszG7HRYgUuXcW4q5nkcoM8gPlZw2O9RrwuW10UQRJ7 KOnOS9+Wh5xDQjAUiiJleDZBpJBBR3gYybDnwThR5MApW6xGj2v175ZhKVFHznupG0 5fBO7usgqqYG0Ffr28JSCr/U= In-Reply-To: <20240915042603.8529-1-maxim.cournoyer@gmail.com> (Maxim Cournoyer's message of "Sun, 15 Sep 2024 13:25:46 +0900") X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: bug-guile@gnu.org List-Id: "Bug reports for GUILE, GNU's Ubiquitous Extension Language" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Original-Sender: bug-guile-bounces+guile-bugs=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.lisp.guile.bugs:10984 Archived-At: --=-=-= Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Maxim Cournoyer writes: > This is an import of the 'Abstract', 'Rationale', and 'Specification' > sections from the upstream specification text, with some manual > adjustment. > > * doc/ref/srfi-modules.texi (SRFI 64): New subsection. I think important question to ask here is whether this manual section documents SRFI-64 or what Guile ships as SRFI-64. Current implementation shipped by Guile has many quirks that do not conform to the specification. > +@c This SRFI 64 documentation was "snarfed" from upstream specification > +@c HTML document using the 'snarfi' script. Based on this I believe it describes the specification. I think either of those is fine (albeit describing the Guile's flavor would be preferred), but is should be stated (that the behavior described by the manual does not match the implementation shipped). Have a nice day, Tomas =2D-=20 There are only two hard things in Computer Science: cache invalidation, naming things and off-by-one errors. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iQJCBAEBCgAsFiEEt4NJs4wUfTYpiGikL7/ufbZ/wakFAmbwDdgOHH5Ad29sZnNk ZW4uY3oACgkQL7/ufbZ/wakEiA/+ObTsNxHZ1tSqFvkrthq1b00NwLo/DvGSyAXP YUxqocrJhmSLlWUW7UqvXbqe8bb4naC8AjtP1ZT/HUKRU7heUEafFVDDx/1WQGzB pMBbLbyfaEEm5GSG31w2E1pDugrKlwPfLsiAgjCF28QOb0VaMcdIfg98xZYTq2sL sJPVG12Km7RrMjiMUxqozWhZ+AHh5brpK7w9xM6klOGCmJyJc/69sORfbIK0DTkV citwxI9DvmNAuSOCG14Qqf8ok6dq0CC0Q/7BG1k61AJpmyoVDxW1kV9n8gwfqJ/a pT0XPjNDC4ABhdzR1RX7hOIryhlA65bFeleIeDy7gXssMiNhSkzzsKjAeMJP7ruo y9sdg3eyGWc4cSkTxOvInnPQVWN2z5udwX55NCJeMBaprTUWcEqOiyZ1ZwizzLFU bCQ/YZmH/8MJluMxaGpaGxWCLOBNvXA6aJ3WSG0I8RPm9CPMqugD+Wbi5QLHElqZ 7tqJtwN+LKzJmPJlcLDWVm78xoKn2LQD/do79lNBio6rPq8iW2Q43ctmNJiGXYO2 4tSgMESQ4RMZGhatiLMycpPjSP99ReZd4cDqCbMInk/lhi2Md3ujtBxWpxzwRMu/ pDh4fHTSINcWF3WCkCkJHAhGX4aXm0RLkvLH4pAmeMybddbFUYbfIjw243Hpekgw HlxBxnc= =kWWR -----END PGP SIGNATURE----- --=-=-=--