GNU bug report logs - #73561
Couple of typos in the documentation

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: guile; Severity: minor; Reported by: zvavybir <zvavybir@HIDDEN>; Keywords: patch; dated Mon, 30 Sep 2024 05:10:02 UTC; Maintainer for guile is bug-guile@HIDDEN.

Message received at 73561 <at> debbugs.gnu.org:


Received: (at 73561) by debbugs.gnu.org; 30 Sep 2024 13:17:46 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Sep 30 09:17:46 2024
Received: from localhost ([127.0.0.1]:45012 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1svGHZ-0004Ql-Ny
	for submit <at> debbugs.gnu.org; Mon, 30 Sep 2024 09:17:46 -0400
Received: from mail-4022.proton.ch ([185.70.40.22]:11309)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <zvavybir@HIDDEN>) id 1svGHU-0004Qe-AA
 for 73561 <at> debbugs.gnu.org; Mon, 30 Sep 2024 09:17:44 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zvavybir.eu;
 s=protonmail2; t=1727702221; x=1727961421;
 bh=tzQBSGWYNqqP79cfKT8aVPit91lBSH/SYts++h8s6+k=;
 h=Date:To:From:Subject:Message-ID:In-Reply-To:References:
 Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID:
 Message-ID:BIMI-Selector;
 b=FEyg3ClCM+w0MFUIT8Gu3OC9B2te/PNSHqWeHpRLLRvacPZPmYDGjGWmCkvNrVtQX
 y61WYQfRxgjwpyKsN+uqJjx90IB/rtK0XSvBMLq566H6Z7ErBSC+VoG7zCnrrWmPTH
 XydaQNQ/SQndTuwHMX7yIIy9KM7hWQDG0MWjyTX1eZ4UdhQXIYz85KtpmAjPo2YQR+
 qvqteCmRQciuQl7ehyYX2bNRTjgGx/gC1mTj4/Z1nLdx/y02lLk0MjDAu5hM3Kvd85
 fe4eVNQOZltH26urw9YG6TAOQwumx6mz/PgcUZpX/HhPTN4fy7xpmvdrvzE9pq1woX
 GlMVAl0GWQfKg==
Date: Mon, 30 Sep 2024 13:16:59 +0000
To: 73561 <at> debbugs.gnu.org
From: zvavybir <zvavybir@HIDDEN>
Subject: Re: bug#73561: Acknowledgement (Couple of typos in the documentation)
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
X-Pm-Message-ID: 0c2876b57a989ae2e249fb4f9cb497793b6b741f
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: 73561
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

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





Information forwarded to bug-guile@HIDDEN:
bug#73561; Package guile. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 30 Sep 2024 05:09:24 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Mon Sep 30 01:09:24 2024
Received: from localhost ([127.0.0.1]:44397 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1sv8ew-0003kL-Pl
	for submit <at> debbugs.gnu.org; Mon, 30 Sep 2024 01:09:24 -0400
Received: from mail-4317.proton.ch ([185.70.43.17]:31443)
 by debbugs.gnu.org with esmtp (Exim 4.84_2)
 (envelope-from <zvavybir@HIDDEN>) id 1sv1Q4-0003K0-BA
 for submit <at> debbugs.gnu.org; Sun, 29 Sep 2024 17:25:35 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=zvavybir.eu;
 s=protonmail2; t=1727645092; x=1727904292;
 bh=ILv5Hbd5S0Pb3TpM69zMrlj4iI4auB/MZXtvr2BKJtw=;
 h=Date:To:From:Subject:Message-ID:Feedback-ID:From:To:Cc:Date:
 Subject:Reply-To:Feedback-ID:Message-ID:BIMI-Selector;
 b=JZgkNJprOEOPe4ImdbtiggnMfaDAMsDzzPJXjG7jlC0b3PuUWA+rYY6NTsGrdH9ub
 eZQzQ+uEsIzuqbevvKnF/1EV0k5I/rRTSjMir1u0jXoqxT1Nb0iOOQ0YaIUQeljEiz
 6oIpbM3kpgym++2g6oHAWMbiXe/I3xdPCv5Rab0Hi4wTjIP5xJFEkXrcx2Pmsje5Ui
 E16kIILxGhNEkd8jCeXe0hhyXUsGh756EhHDdE9uhFkezpQl9OOvf2Vhzy3AuejhD6
 PoPg/1jk9bly3uTvrGzpzxpESHT4VU1n1XD5v9KiSAIB6DOecdJ35AX0DQQ8RkoNtQ
 RxgaiokoBZcqQ==
Date: Sun, 29 Sep 2024 21:24:47 +0000
To: "submit <at> debbugs.gnu.org" <submit <at> debbugs.gnu.org>
From: zvavybir <zvavybir@HIDDEN>
Subject: Couple of typos in the documentation
Message-ID: <et57fcynaYnDDqeECDNwtC-s5SkFPNXeqErTlLQ_UTzBOIu1Vba6PQdZKpaHrR5kgLHMQqOsHDyf1p9k61HMxIEOxplEeHrZPha2AD8_F0c=@zvavybir.eu>
Feedback-ID: 92606187:user:proton
X-Pm-Message-ID: d90741e83715aec24b80cd73aa9d30e687887d5c
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: submit
X-Mailman-Approved-At: Mon, 30 Sep 2024 01:09:21 -0400
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

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.)




Acknowledgement sent to zvavybir <zvavybir@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-guile@HIDDEN. Full text available.
Report forwarded to bug-guile@HIDDEN:
bug#73561; Package guile. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
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.