summaryrefslogtreecommitdiffstats
path: root/Doc/lib
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2007-05-11 11:04:26 (GMT)
committerGeorg Brandl <georg@python.org>2007-05-11 11:04:26 (GMT)
commitc5207c84252538259b1521aaca4171051e913cc7 (patch)
treefc19f164a6e7292095f9c9e383e7322178d0bf11 /Doc/lib
parentbc1b5f1669ea1a1aec83e84531892b75d76d6e7c (diff)
downloadcpython-c5207c84252538259b1521aaca4171051e913cc7.zip
cpython-c5207c84252538259b1521aaca4171051e913cc7.tar.gz
cpython-c5207c84252538259b1521aaca4171051e913cc7.tar.bz2
Patch #1714700: clarify os.linesep vs. tfiles opened in text mode.
(backport)
Diffstat (limited to 'Doc/lib')
-rw-r--r--Doc/lib/libos.tex9
1 files changed, 6 insertions, 3 deletions
diff --git a/Doc/lib/libos.tex b/Doc/lib/libos.tex
index 9783c14..2454e57 100644
--- a/Doc/lib/libos.tex
+++ b/Doc/lib/libos.tex
@@ -2009,9 +2009,12 @@ Also available via \module{os.path}.
\begin{datadesc}{linesep}
The string used to separate (or, rather, terminate) lines on the
-current platform. This may be a single character, such as \code{'\e
-n'} for \POSIX{} or \code{'\e r'} for Mac OS, or multiple characters,
-for example, \code{'\e r\e n'} for Windows.
+current platform. This may be a single character, such as
+\code{'\e n'} for \POSIX{} or \code{'\e r'} for Mac OS, or multiple
+characters, for example, \code{'\e r\e n'} for Windows.
+Do not use \var{os.linesep} as a line terminator when writing files
+opened in text mode (the default); use a single \code{'\e n'} instead,
+on all platforms.
\end{datadesc}
\begin{datadesc}{devnull}