[PATCH] Clarify file encoding details regarding UTF-8

[Colin Woodbury <colin@fosskers.ca>]

[-- Attachment #1: Type: text/plain, Size: 240 bytes --]

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.

[-- Attachment #2: 0001-doc-Clarify-file-encoding-details-regarding-UTF-8.patch --]
[-- Type: text/x-patch, Size: 2398 bytes --]

From 6a2555db257faaf784d2e7ad78b361377114ed11 Mon Sep 17 00:00:00 2001
From: Colin Woodbury <colin@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