diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog index 0075f86be..152c18df5 100644 --- a/winsup/doc/ChangeLog +++ b/winsup/doc/ChangeLog @@ -1,3 +1,8 @@ +2002-12-18 Christopher Faylor + + * overview2.sgml: Remove CTRL-Z discussion. + * cygwinenv.sgml: Expand on CYGWIN=binmode. + 2002-11-10 Christopher Faylor * how-programming.texinfo: Document _WIN32 more fully. diff --git a/winsup/doc/cygwinenv.sgml b/winsup/doc/cygwinenv.sgml index bb391a592..c8c00f914 100644 --- a/winsup/doc/cygwinenv.sgml +++ b/winsup/doc/cygwinenv.sgml @@ -10,9 +10,15 @@ by prefixing with no . (no)binmode - if set, non-disk (e.g. pipe and COM ports) file opens default to binary mode -(no CR/LF/Ctrl-Z translations) instead of text mode. -Defaults to set (binary mode). This option must be set -before starting a Cygwin shell to have an effect on redirection. +(no CRLF translation) instead of text mode. Defaults to set (binary +mode). By default, devices are opened in binary mode, so this option +has little effect on normal cygwin operations. + +It does affect two things, however. For non-NTFS filesystems, this +option will control the line endings for standard output/input/error +for redirection from the Windows command shell. It will also affect +the default translation mode of a pipe, although most shells set the +pipe to binary by default. Warning!If set in 12/98 b20.1, all files always open in binary mode. diff --git a/winsup/doc/overview2.sgml b/winsup/doc/overview2.sgml index 755b4c42c..04b6b35e7 100644 --- a/winsup/doc/overview2.sgml +++ b/winsup/doc/overview2.sgml @@ -171,9 +171,7 @@ sources. Unfortunately, UNIX and Win32 use different end-of-line terminators in text files. Consequently, carriage-return newlines have to be translated on -the fly by Cygwin into a single newline when reading in text mode. The -control-z character is interpreted as a valid end-of-file character for a -similar reason. +the fly by Cygwin into a single newline when reading in text mode. This solution addresses the compatibility requirement at the expense of violating the POSIX standard that states that text and binary mode will be