summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--Doc/library/functions.rst11
1 files changed, 8 insertions, 3 deletions
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 744a99f..b5a4fb8 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -666,9 +666,14 @@ are always available. They are listed here in alphabetical order.
Other common values are ``'w'`` for writing (truncating the file if it
already exists), and ``'a'`` for appending (which on *some* Unix systems,
means that *all* writes append to the end of the file regardless of the
- current seek position). In text mode, if *encoding* is not specified the
- encoding used is platform dependent. (For reading and writing raw bytes use
- binary mode and leave *encoding* unspecified.) The available modes are:
+ current seek position).
+
+ In text mode, if *encoding* is not specified the encoding used is the same as
+ returned by :func:`locale.getpreferredencoding`, if the :mod:`locale` module
+ is available, else ASCII. For reading and writing raw bytes, use binary mode
+ and leave *encoding* unspecified.
+
+ The available modes are:
========= ===============================================================
Character Meaning