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