Hi again folks, here's a clarification of the default encoding of Guile
source files. I've basically made the two pages match in their message,
please let me know if anything is incorrect.
This also includes a minor spelling correction.
From 6a2555db257faaf784d2e7ad78b361377114ed11 Mon Sep 17 00:00:00 2001
From: Colin Woodbury <co...@fosskers.ca>
Date: Sat, 3 Dec 2022 11:42:41 +0900
Subject: [PATCH] doc: Clarify file encoding details regarding UTF-8
Since UTF-8 is stated as the default assumed encoding, this point has
been emphasized.
This also fixes a minor spelling mistake.
---
doc/ref/api-evaluation.texi | 4 ++--
doc/ref/scheme-scripts.texi | 4 ++--
2 files changed, 4 insertions(+), 4 deletions(-)
diff --git a/doc/ref/api-evaluation.texi b/doc/ref/api-evaluation.texi
index df7623f87..464694d8c 100644
--- a/doc/ref/api-evaluation.texi
+++ b/doc/ref/api-evaluation.texi
@@ -1080,7 +1080,7 @@ three arguments.
@cindex source file encoding
@cindex primitive-load
@cindex load
-Scheme source code files are usually encoded in ASCII or UTF-8, but the
+Scheme source code files are usually encoded in UTF-8 or ASCII, but the
built-in reader can interpret other character encodings as well. When
Guile loads Scheme source code, it uses the @code{file-encoding}
procedure (described below) to try to guess the encoding of the file.
@@ -1125,7 +1125,7 @@ ASCII.
There might be a scenario in which one would want to read non-ASCII
code from a port, such as with the function @code{read}, instead of
with @code{load}. If the port's character encoding is the same as the
-encoding of the code to be read by the port, not other special
+encoding of the code to be read by the port, no other special
handling is necessary. The port will automatically do the character
encoding conversion. The functions @code{setlocale} or by
@code{set-port-encoding!} are used to set port encodings
diff --git a/doc/ref/scheme-scripts.texi b/doc/ref/scheme-scripts.texi
index 221c8ba20..4019c6540 100644
--- a/doc/ref/scheme-scripts.texi
+++ b/doc/ref/scheme-scripts.texi
@@ -62,8 +62,8 @@ operating system never reads this far, but Guile treats this as the end
of the comment begun on the first line by the @samp{#!} characters.
@item
-If this source code file is not ASCII or ISO-8859-1 encoded, a coding
-declaration such as @code{coding: utf-8} should appear in a comment
+If this source code file is not UTF-8 or ASCII encoded, a coding
+declaration such as @code{coding: iso-8859-1} should appear in a comment
somewhere in the first five lines of the file: see @ref{Character
Encoding of Source Files}.
--
2.38.1