diff options
| author | Christopher Faylor <me@cgf.cx> | 2005-03-06 02:46:54 +0000 |
|---|---|---|
| committer | Christopher Faylor <me@cgf.cx> | 2005-03-06 02:46:54 +0000 |
| commit | 57a64c15da30be80bb7c9cec0f040fa720cd60f4 (patch) | |
| tree | a542eec0e4b33d37f344e2559ee35e2c2906392b /winsup/doc/textbinary.sgml | |
| parent | 3016669b4b99c161cd0a8c83e2607627f2aeabbb (diff) | |
| download | cygnal-57a64c15da30be80bb7c9cec0f040fa720cd60f4.tar.gz cygnal-57a64c15da30be80bb7c9cec0f040fa720cd60f4.tar.bz2 cygnal-57a64c15da30be80bb7c9cec0f040fa720cd60f4.zip | |
* pathnames.sgml: Clarify binmode/textmode behavior slightly.
* textbinary.sgml: Ditto.
Diffstat (limited to 'winsup/doc/textbinary.sgml')
| -rw-r--r-- | winsup/doc/textbinary.sgml | 26 |
1 files changed, 12 insertions, 14 deletions
diff --git a/winsup/doc/textbinary.sgml b/winsup/doc/textbinary.sgml index 24b2a4c96..15994185a 100644 --- a/winsup/doc/textbinary.sgml +++ b/winsup/doc/textbinary.sgml @@ -35,15 +35,15 @@ are to be opened when the mode is not specified explicitly. The rules are evolving, this section gives the design goals.</para> <orderedlist numeration="loweralpha"> <listitem> -<para>If the file appears to reside on a file system that is mounted -(i.e. if its pathname starts with a directory displayed by -<command>mount</command>), then the default is specified by the mount -flag. If the file is a symbolic link, the mode of the target file system -applies.</para> +<para>If the filename is specified as a POSIX path and it appears to +reside on a file system that is mounted (i.e. if its pathname starts +with a directory displayed by <command>mount</command>), then the +default is specified by the mount flag. If the file is a symbolic link, +the mode of the target file system applies.</para> </listitem> <listitem> -<para>If the file appears to reside on a file system that is not mounted -(as can happen when the path contains a drive letter), the default is binary. +<para>If the file is specified via a MS-DOS pathname (i.e., it contains a +backslash or a colon), the default is binary. </para> </listitem> <listitem> @@ -55,9 +55,11 @@ in binary mode if any of the following conditions hold:</para> <orderedlist numeration="arabic" spacing="compact"> <listitem><para>binary mode is specified in the open call</para> </listitem> -<listitem><para><envar>CYGWIN</envar> contains <literal>binmode</literal></para> +<listitem><para>the filename is a MS-DOS filename +</listitem> +<listitem><para>the file resides on a binary mounted partition</para> </listitem> -<listitem><para>the file resides in a binary mounted partition</para> +<listitem><para><envar>CYGWIN</envar> contains <literal>binmode</literal></para> </listitem> <listitem><para>the file is not a disk file</para> </listitem> @@ -66,11 +68,7 @@ in binary mode if any of the following conditions hold:</para> </listitem> <listitem> -<para>When a Cygwin program is launched by a shell, its standard input, -output and error are in binary mode if the <envar>CYGWIN</envar> variable -contains <literal>tty</literal>, else in text mode, except if they are piped -or redirected.</para> -<para> When redirecting, the Cygwin shells uses rules (a-c). For +<para> When redirecting, the Cygwin shells uses rules (a-e). For these shells the relevant value of <envar>CYGWIN</envar> is that at the time the shell was launched and not that at the time the program is executed. Non-Cygwin shells always pipe and redirect with binary mode. With |