Package: guile Version: 3.0.10 Severity: minor Tags: patch There are a couple typos of missing brackets/parentheses in the documentation (for example in the PDF on page 127 under integer-expt or in the first code block of page 601).
As I don't know texinfo (only (La)TeX), I don't know if this patch is correct, but at least it should be trivial for someone who knows what they're doing to write a correct one based on it: >From 60f0c00557603bbfbc018c9ae37b55754d5d2c3e Mon Sep 17 00:00:00 2001 From: Matthias Kaak <zvavy...@zvavybir.eu> 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 <zvavy...@zvavybir.eu> --- 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}. @@ -1721,7 +1721,7 @@ when @var{count} is negative. This is an ``arithmetic'' shift. @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. 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. -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. 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. 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. 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, (cons 1 '()) (cons 2 '(1)) -(cons 3 '(2 1) +(cons 3 '(2 1)) @result{} (3 2 1) @end example -- 2.45.2 (PS: The bug-reporting documentation under https://debbugs.gnu.org/Reporting.html and https://www.gnu.org/software/guile/contribute/ contradict each other about which e-mail address this report should be sent to. I hope I choose the/a correct one.)