GNU logs - #73561, boring messages

Message sent to bug-guile@HIDDEN:

Subject: bug#73561: Couple of typos in the documentation
Resent-From: zvavybir <zvavybir@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-guile@HIDDEN
Resent-Date: Mon, 30 Sep 2024 05:10:02 +0000
Resent-Message-ID: <handler.73561.B.172767296414409 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 73561 <at> debbugs.gnu.org
Date: Sun, 29 Sep 2024 21:24:47 +0000
From: zvavybir <zvavybir@HIDDEN>
Message-ID: <et57fcynaYnDDqeECDNwtC-s5SkFPNXeqErTlLQ_UTzBOIu1Vba6PQdZKpaHrR5kgLHMQqOsHDyf1p9k61HMxIEOxplEeHrZPha2AD8_F0c=@zvavybir.eu>
Feedback-ID: 92606187:user:proton
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

Package: guile
Version: 3.0.10
Severity: minor
Tags: patch

There are a couple typos of missing brackets/parentheses in the documentati=
on (for example in the PDF on page 127 under integer-expt or in the first c=
ode block of page 601).

As I don't know texinfo (only (La)TeX), I don't know if this patch is corre=
ct, but at least it should be trivial for someone who knows what they're do=
ing to write a correct one based on it:

From 60f0c00557603bbfbc018c9ae37b55754d5d2c3e Mon Sep 17 00:00:00 2001
From: Matthias Kaak <zvavybir@HIDDEN>
Date: Sun, 29 Sep 2024 21:01:00 +0000
Subject: [PATCH] Fixed a couple of typos in the documentation

* doc/ref/api-data.texi: Added missing brackets of exponents in math
  mode
* doc/ref/api-io.texi: Added missing brackets of exponents in math mode
* doc/ref/srfi-modules.texi: Added missing closing parenthesis

Signed-off-by: Matthias Kaak <zvavybir@HIDDEN>
---
 doc/ref/api-data.texi     | 8 ++++----
 doc/ref/api-io.texi       | 2 +-
 doc/ref/srfi-modules.texi | 2 +-
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/doc/ref/api-data.texi b/doc/ref/api-data.texi
index b2473d1f9..d089b355a 100644
--- a/doc/ref/api-data.texi
+++ b/doc/ref/api-data.texi
@@ -214,8 +214,8 @@ rational is also real, and every real number is also a =
complex number
 In addition to the classification into integers, rationals, reals and
 complex numbers, Scheme also distinguishes between whether a number is
 represented exactly or not.  For example, the result of
-@m{2\sin(\pi/4),2*sin(pi/4)} is exactly @m{\sqrt{2},2^(1/2)}, but Guile
-can represent neither @m{\pi/4,pi/4} nor @m{\sqrt{2},2^(1/2)} exactly.
+@m{2\sin(\pi/4),2*sin(pi/4)} is exactly @m{\sqrt{2},2^{1/2}}, but Guile
+can represent neither @m{\pi/4,pi/4} nor @m{\sqrt{2},2^{1/2}} exactly.
 Instead, it stores an inexact approximation, using the C type
 @code{double}.
=20
@@ -1721,7 +1721,7 @@ when @var{count} is negative.  This is an ``arithmeti=
c'' shift.
=20
 @deffn {Scheme Procedure} round-ash n count
 @deffnx {C Function} scm_round_ash (n, count)
-Return @math{round(n * 2^count)}.
+Return @math{round(n * 2^{count})}.
 @var{n} and @var{count} must be exact integers.
=20
 With @var{n} viewed as an infinite-precision twos-complement
@@ -1781,7 +1781,7 @@ zero bit in twos complement form.
 Return @var{n} raised to the power @var{k}.  @var{k} must be an exact
 integer, @var{n} can be any number.
=20
-Negative @var{k} is supported, and results in @m{1/n^|k|, 1/n^abs(k)}
+Negative @var{k} is supported, and results in @m{1/n^{|k|}, 1/n^{abs(k)}}
 in the usual way.  @math{@var{n}^0} is 1, as usual, and that includes
 @math{0^0} is 1.
=20
diff --git a/doc/ref/api-io.texi b/doc/ref/api-io.texi
index 79bc9e9d6..a53e1555f 100644
--- a/doc/ref/api-io.texi
+++ b/doc/ref/api-io.texi
@@ -1096,7 +1096,7 @@ See also @ref{Ports and File Descriptors, open}, for =
an interface
 to the Unix @code{open} system call.
=20
 All file access uses the ``LFS'' large file support functions when
-available, so files bigger than 2 gibibytes (@math{2^31} bytes) can be
+available, so files bigger than 2 gibibytes (@math{2^{31}} bytes) can be
 read and written on a 32-bit system.
=20
 Most systems have limits on how many files can be open, so it's
diff --git a/doc/ref/srfi-modules.texi b/doc/ref/srfi-modules.texi
index 02da3e2f2..6d4d233b7 100644
--- a/doc/ref/srfi-modules.texi
+++ b/doc/ref/srfi-modules.texi
@@ -550,7 +550,7 @@ following shows a list reversal and the calls it makes,
=20
 (cons 1 '())
 (cons 2 '(1))
-(cons 3 '(2 1)
+(cons 3 '(2 1))
 @result{} (3 2 1)
 @end example
=20
--=20
2.45.2


(PS: The bug-reporting documentation under https://debbugs.gnu.org/Reportin=
g.html and https://www.gnu.org/software/guile/contribute/ contradict each o=
ther about which e-mail address this report should be sent to.  I hope I ch=
oose the/a correct one.)

Message sent:

Content-Disposition: inline
Content-Transfer-Encoding: quoted-printable
MIME-Version: 1.0
X-Mailer: MIME-tools 5.505 (Entity 5.505)
Content-Type: text/plain; charset=utf-8
X-Loop: help-debbugs@HIDDEN
From: help-debbugs@HIDDEN (GNU bug Tracking System)
To: zvavybir <zvavybir@HIDDEN>
Subject: bug#73561: Acknowledgement (Couple of typos in the documentation)
Message-ID: <handler.73561.B.172767296414409.ack <at> debbugs.gnu.org>
References: <et57fcynaYnDDqeECDNwtC-s5SkFPNXeqErTlLQ_UTzBOIu1Vba6PQdZKpaHrR5kgLHMQqOsHDyf1p9k61HMxIEOxplEeHrZPha2AD8_F0c=@zvavybir.eu>
X-Gnu-PR-Message: ack 73561
X-Gnu-PR-Package: guile
X-Gnu-PR-Keywords: patch
Reply-To: 73561 <at> debbugs.gnu.org
Date: Mon, 30 Sep 2024 05:10:02 +0000

Thank you for filing a new bug report with debbugs.gnu.org.

This is an automatically generated reply to let you know your message
has been received.

Your message is being forwarded to the package maintainers and other
interested parties for their attention; they will reply in due course.

Your message has been sent to the package maintainer(s):
 bug-guile@HIDDEN

If you wish to submit further information on this problem, please
send it to 73561 <at> debbugs.gnu.org.

Please do not send mail to help-debbugs@HIDDEN unless you wish
to report a problem with the Bug-tracking system.

--=20
73561: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=3D73561
GNU Bug Tracking System
Contact help-debbugs@HIDDEN with problems

Message sent to bug-guile@HIDDEN:

Subject: bug#73561: Acknowledgement (Couple of typos in the documentation)
Resent-From: zvavybir <zvavybir@HIDDEN>
Original-Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
Resent-CC: bug-guile@HIDDEN
Resent-Date: Mon, 30 Sep 2024 13:18:01 +0000
Resent-Message-ID: <handler.73561.B73561.172770226617039 <at> debbugs.gnu.org>
Resent-Sender: help-debbugs@HIDDEN
To: 73561 <at> debbugs.gnu.org
Date: Mon, 30 Sep 2024 13:16:59 +0000
From: zvavybir <zvavybir@HIDDEN>
Message-ID: <xBzqeZ2F8tOTYolnibFaGmGta1mZVeGUYfJymG39qXKbnSxJzs9LAq1iFss8F-AJmHP0OXtTHIQrWhofQ0YZnncxPwnmMRR4AeG0Go05KR0=@zvavybir.eu>
In-Reply-To: <handler.73561.B.172767296414409.ack <at> debbugs.gnu.org>
References: <et57fcynaYnDDqeECDNwtC-s5SkFPNXeqErTlLQ_UTzBOIu1Vba6PQdZKpaHrR5kgLHMQqOsHDyf1p9k61HMxIEOxplEeHrZPha2AD8_F0c=@zvavybir.eu>
 <handler.73561.B.172767296414409.ack <at> debbugs.gnu.org>
Feedback-ID: 92606187:user:proton
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Precedence: list
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>

Found two more typos today:

From 0c090dcfe3b156436f35b52e4492575b71cf621f Mon Sep 17 00:00:00 2001
From: Matthias Kaak <zvavybir@HIDDEN>
Date: Mon, 30 Sep 2024 13:10:43 +0000
Subject: [PATCH] Fixed a couple typos in the documentation

* doc/ref/apu-scheduling.texi: Fixed one typo of "if" from "ff"
* doc/ref/apu-undocumented.texi: Fixed one typo of "if" from "ff"

Signed-off-by: Matthias Kaak <zvavybir@HIDDEN>
---
 doc/ref/api-scheduling.texi   | 2 +-
 doc/ref/api-undocumented.texi | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/ref/api-scheduling.texi b/doc/ref/api-scheduling.texi
index d79808049..af95ead39 100644
--- a/doc/ref/api-scheduling.texi
+++ b/doc/ref/api-scheduling.texi
@@ -80,7 +80,7 @@ Once @var{body} or @var{handler} returns, the return valu=
e is made the
=20
 @deffn {Scheme Procedure} thread? obj
 @deffnx {C Function} scm_thread_p (obj)
-Return @code{#t} ff @var{obj} is a thread; otherwise, return
+Return @code{#t} if @var{obj} is a thread; otherwise, return
 @code{#f}.
 @end deffn
=20
diff --git a/doc/ref/api-undocumented.texi b/doc/ref/api-undocumented.texi
index 2967c95f4..63491c9fb 100644
--- a/doc/ref/api-undocumented.texi
+++ b/doc/ref/api-undocumented.texi
@@ -202,7 +202,7 @@ they are printed in turn, each one followed by a newlin=
e.
=20
 @deffn {Scheme Procedure} valid-object-procedure? proc
 @deffnx {C Function} scm_valid_object_procedure_p (proc)
-Return @code{#t} ff @var{proc} is a procedure that can be used with @code{=
set-object-procedure}.  It is always valid to use a closure constructed by =
@code{lambda}.
+Return @code{#t} if @var{proc} is a procedure that can be used with @code{=
set-object-procedure}.  It is always valid to use a closure constructed by =
@code{lambda}.
 @end deffn
=20
 @deffn {Scheme Procedure} %get-pre-modules-obarray
--=20
2.45.2

Last modified: Sun, 12 Jan 2025 05:45:02 UTC

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997 nCipher Corporation Ltd, 1994-97 Ian Jackson.