[Python-checkins] r55258 - python/trunk/Doc/lib/libos.tex

[georg.brandl]

Author: georg.brandl
Date: Fri May 11 13:04:26 2007
New Revision: 55258

Modified:
   python/trunk/Doc/lib/libos.tex
Log:
Patch #1714700: clarify os.linesep vs. tfiles opened in text mode.
 (backport)

Modified: python/trunk/Doc/lib/libos.tex
==============================================================================
--- python/trunk/Doc/lib/libos.tex	(original)
+++ python/trunk/Doc/lib/libos.tex	Fri May 11 13:04:26 2007
@@ -2009,9 +2009,12 @@
 
 \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}