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: Re: Doc patches outstanding Date: Tue, 17 Jan 2023 07:21:04 +0100 Message-ID: <87r0vtoevp.fsf@web.de> References: <87zgbug0ao.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="40410"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: mu4e 1.8.11; emacs 28.1 Cc: guile-devel@gnu.org To: Jean Abou Samra Original-X-From: guile-devel-bounces+guile-devel=m.gmane-mx.org@gnu.org Tue Jan 17 07:27:37 2023 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 1pHfRY-000AIe-52 for guile-devel@m.gmane-mx.org; Tue, 17 Jan 2023 07:27:36 +0100 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1pHfR4-0000fw-0z; Tue, 17 Jan 2023 01:27:06 -0500 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 1pHfR0-0000fb-23 for guile-devel@gnu.org; Tue, 17 Jan 2023 01:27:02 -0500 Original-Received: from mout.web.de ([212.227.17.11]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1pHfQu-0002fg-Nh for guile-devel@gnu.org; Tue, 17 Jan 2023 01:27:01 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=web.de; s=s29768273; t=1673936814; bh=wkz6lzg8AA+Ki7TGewFhbOrt62y0i5NbjXjVYofEN5Y=; h=X-UI-Sender-Class:References:From:To:Cc:Subject:Date:In-reply-to; b=UPtLtdwQGEC8tAdagM5bjuYVciW+oNVqwpNRTKDxrM4J6puA5zk46Dot0bhI+joWT SYI3Vphez2yJNXpZQ3qGJvpA32yPXjKU6NhQzhzy9pUXwaNJDi7FUq2zCoeNhrQoL4 uMeNkGZ7MH9A3NFWgPNTPgRLi9jyJR1vmdUWvt0NZN+aYSChC+lIKqiYrW+nXbfTV+ 4G9Oj5IoCz+UdvM416KQ9fCYX0rS6iM+Hvn5PDxbdzWjuJXxaMk5Us9Lx8gR6+Tfog mA1FaHd1leYq+ebIzk2vEzwqLPNGPlQJbB2gapaw6Jk2w8xIdRLiKejKbat0Zx38gA BPm9wGpQyEzHw== X-UI-Sender-Class: 814a7b36-bfc1-4dae-8640-3722d8ec6cd6 Original-Received: from fluss ([84.149.95.143]) by smtp.web.de (mrweb105 [213.165.67.124]) with ESMTPSA (Nemesis) id 1M8kEV-1pMK8V1EzR-004P12; Tue, 17 Jan 2023 07:26:54 +0100 In-reply-to: X-Provags-ID: V03:K1:yrVwhOM9ez1n8ilna2MLIJ+K96sU63dkvgKg7Nglr6v28Wh5EN9 JhqSD6FfWrLVYUgwdhoo/LBhNJTrbZr2+6BAHWc7oKHuA9N2r0yy2/B7YR6LhxXRAXB9//D MQbesyAsVPyhXiVCTuyULKYr8lr3JFT0S8tCtZWoyRTjF3mEW/SLiGppWCQNDLEnj7c+GXT DTKtSxOFvpnGB1REvh0Lw== UI-OutboundReport: notjunk:1;M01:P0:NEnijt5+Z0A=;BTtJBo3KSWnBHJ/WZM4vl2mF8rJ rzp4Z3VU1Ma7iHHjZ+7+zD5IgS7+4dyO9LIbOPnP5a679dFzCKz/5kbqNyu0xvTeTtY8UZAf6 O46UyZSGEQ8fTvzExifK/pQgdST+5NvaA64mSNZwmnu2ZcG81HyELH8Kt4XCRNUCohactyCPP RlVjr3v5C2ElZatraOH3yM0WQHGRVy99jzVeY5YVBhteb9Yhptc2DAPHZ/q+Ug3LyOGncXwWC zKFpPOxqsLyoTHr/A/8Bp4kMwp44mILseb+YKg4yg2G7m1JuP9OzmRxX50BZV853IS+EgeGJf AtZKwpJawLJjIVMysdSVKDblQIj7NpyjHWkOkumonl8YPNBE2T5SYn8JvfuhK4RKlWs6mvIVs MqXplb0vq2q8KWPnrdYUSLwX8gC3253OGpdAOCaC/K1Ef/S4az2TGTKgrntWS7Nr6iZEhc0xq PcQ9eApHUWf3ed0pgjGRAo63SBAf8Iv3xxXxLfARfbUbhstA0OTsyfVJFxjlg+FneRGfPvneB vyFYxq/5KPpDbXX3ilaqf/y5Ppcu+ZCvAyDChnZG7t5Qb6fv4fzd8L+0Zz5vT45lwYduDKj6w vUtyQL3K3By1zVVHI0P+ukt4P4Nn5xcJ63tFfGT5jxeRo6l0lMzt7GKhCdskuzTh2XQzMCYv5 XCAVtEkNDrFx8QX+oKYexJogWyiimBFSpx0xXNdA97m1mNnI4ImLLrblVlMDle1KQ/wL3juHd uGSfRf9s3S4QGah6Vp3IoCtHkUhp1TQgaims1LQl3fVP6r1FCKZ9eSQknl+ngFhLgIBAtiSt Received-SPF: pass client-ip=212.227.17.11; 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:21591 Archived-At: --==-=-= Content-Type: multipart/mixed; boundary="=-=-=" --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Hello Jean, Jean Abou Samra writes: > Thank you for applying the first one nevertheless. I am attaching > patch files for the other two, that should work better. They are applied and pushed now =E2=80=94 thank you, and thank you for your= patience! For the eval-when-example I wrote a small change to the wording, because I found that the example actually runs in Guile 3.0.8, but retrieves the runtime value of the date-time instead of the compile-time value. Can you have a look? If it=E2=80=99s good to go from your side, I=E2=80=99d= push it. Subject: [PATCH] doc: More precise eval-when example description * doc/ref/api-macros.texi: replace "will not work in a file" by "will cause problems in a file", because the example actually executes at runtime, so it works, but not as intended. =2D-- doc/ref/api-macros.texi | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/ref/api-macros.texi b/doc/ref/api-macros.texi index a353719cb..ea4e85d3f 100644 =2D-- a/doc/ref/api-macros.texi +++ b/doc/ref/api-macros.texi @@ -1239,7 +1239,7 @@ the procedure should be made available at expansion-t= ime. For example, the following code tries to embed a compilation timestamp in the compiled bytecode using a macro that expands to the date as a string literal. It will work at a REPL, but =2Dnot in a file, as it cannot be byte-compiled: +will cause problems in a file, as it cannot be byte-compiled: =20 @example (use-modules (srfi srfi-19)) --=-=-= Content-Type: text/x-patch Content-Disposition: inline; filename=0001-doc-More-precise-eval-when-example-description.patch Content-Transfer-Encoding: quoted-printable From=2039fc107c76c48287b84abc2a51d6b3f778817560 Mon Sep 17 00:00:00 2001 From: Arne Babenhauserheide Date: Tue, 17 Jan 2023 07:17:56 +0100 Subject: [PATCH] doc: More precise eval-when example description * doc/ref/api-macros.texi: replace "will not work in a file" by "will cause problems in a file", because the example actually executes at runtime, so it works, but not as intended. =2D-- doc/ref/api-macros.texi | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/ref/api-macros.texi b/doc/ref/api-macros.texi index a353719cb..ea4e85d3f 100644 =2D-- a/doc/ref/api-macros.texi +++ b/doc/ref/api-macros.texi @@ -1239,7 +1239,7 @@ the procedure should be made available at expansion-t= ime. For example, the following code tries to embed a compilation timestamp in the compiled bytecode using a macro that expands to the date as a string literal. It will work at a REPL, but =2Dnot in a file, as it cannot be byte-compiled: +will cause problems in a file, as it cannot be byte-compiled: =20 @example (use-modules (srfi srfi-19)) =2D-=20 2.38.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+sFAmPGP6sQHGFybmVfYmFi QHdlYi5kZQAKCRAT741FJAPD6yEIEACllsQNJymL/zG6oY/LfxQtLEBvtHHWa90t I6rXssRa9Lzo5WuKgrCv6fMb/SIxsUbH1eMfeIkc7ceurN+ccgk9+HZYzRBjQWvA 5UnLC7wH46fArxwlTUQt57C0UBpd30D3LJsvlOW696J9VJcy+XtXzFLk84oodmWf b9aVx+3K/FuAHaFK+m5e8Vrci38sB4bX3zBf4IZgjb3jrlg+mf4uStDuJUuhm083 /kp8i/H2OW+e2yg82Xye2Kum+nNtJsEDUoBhE4m3dt2Csy44jBuONbiplvu1pTc5 p5NWfvFUjrGI3zxp7rhCGOjVair1fugzJmWD+E0TjMQfkC4lgMRD7cbd2G4a39ch LQa1y/sGdIuUDYvjN3q4XOXmTRpVfd4edSj0LD/JPCp062dtY3FTmTM11vIGw1P/ p3lfSVnS84AXT8KfO1kmE0iascubP9p7uhJlwyaSdIE4Or9IbVqsA644DBVXixkg EEG03yUbgcMfwC/QH9XDQSYyVlRhA0SbX7G8stKsUmXI8kWxJ/Dt9Qhwrp5MRw7d ZF5QPJqljGO99soyU+khTwEmRLgFR/41TSd+s/GRkZcKmKjyqlsTrbN9X23aU39s bfaz88pT/H9Bikgl2IvHkxPogUBEBa9Xar2K9V3GR6JjjGzuY6bySeo0fZzCiKMW VRdJP5N7IojEBAEBCAAuFiEE3Si95tmHXKvOSosd3M8NswvBBUgFAmPGP6sQHGFy bmVfYmFiQHdlYi5kZQAKCRDczw2zC8EFSIQhBACZxcbqwhe39AtgFcPiob0BY/gz rSmWPcmdsH8tVFjI52Hr4+158m8Q56ee1LCdjTcPPnAdEQ+cYxsEaTLYN+Rshlsn WKxkKvFi8pnbs5RB/XUicRZFVDTmoodoN+IpLWBwIjxYBg6lZZtW5c+RvB5tfdCu 7HIKSBmp01VAlApRRw== =Spgm -----END PGP SIGNATURE----- --==-=-=--