summaryrefslogtreecommitdiff
path: root/doc/ref
diff options
context:
space:
mode:
Diffstat (limited to 'doc/ref')
-rw-r--r--doc/ref/api-evaluation.texi7
-rw-r--r--doc/ref/api-io.texi6
2 files changed, 11 insertions, 2 deletions
diff --git a/doc/ref/api-evaluation.texi b/doc/ref/api-evaluation.texi
index e50a51546..cd5a6588a 100644
--- a/doc/ref/api-evaluation.texi
+++ b/doc/ref/api-evaluation.texi
@@ -666,14 +666,17 @@ and @code{UTF-32} may not be used because they are not compatible with
ASCII.
@cindex read
-@cindex set-port-encoding!
+@cindex encoding
+@cindex port encoding
+@findex set-port-encoding!
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
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.
+@code{set-port-encoding!} are used to set port encodings
+(@pxref{Ports}).
If a port is used to read code of unknown character encoding, it can
accomplish this in three steps. First, the character encoding of the
diff --git a/doc/ref/api-io.texi b/doc/ref/api-io.texi
index 83a2fd79c..a5ffa2319 100644
--- a/doc/ref/api-io.texi
+++ b/doc/ref/api-io.texi
@@ -111,6 +111,12 @@ Sets the character encoding that will be used to interpret all port
I/O. @var{enc} is a string containing the name of an encoding.
@end deffn
+@defvr {Scheme Variable} %default-port-encoding
+A fluid containing containing @code{#f} or the name of the encoding to
+be used by default for newly created ports (@pxref{Fluids and Dynamic
+States}). The value @code{#f} is equivalent to @code{"ISO-8859-1"}.
+@end defvr
+
New ports are created with the encoding appropriate for the current
locale if @code{setlocale} has been called or ISO-8859-1 otherwise,
and this procedure can be used to modify that encoding.