Document mkostemp and mkostemps.

* textbinary.sgml (textbin-devel): Document temp file behavior.
(textbin-issue): Use sed rather than cat as an example of a
default-mode application.
* new-features.sgml (ov-new1.7.6): Document mkostemp[s].

1 files changed, 6 insertions, 1 deletions

diff --git a/winsup/doc/textbinary.sgml b/winsup/doc/textbinary.sgml
index 98aa2b1ae..7f4aae5fb 100644
--- a/winsup/doc/textbinary.sgml
+++ b/winsup/doc/textbinary.sgml
@@ -23,7 +23,7 @@ standard input and output) as text.  All other programs (such as
 would use binary mode.  In practice with Cygwin, programs that deal
 explicitly with object files specify binary mode (this is the case of
 <command>od</command>, which is helpful to diagnose CR problems).  Most
-other programs (such as <command>cat</command>, <command>cmp</command>,
+other programs (such as <command>sed</command>, <command>cmp</command>,
 <command>tr</command>) use the default mode.</para>
 
 </sect2>
@@ -113,6 +113,11 @@ specified with the flag <literal>O_BINARY</literal> and text mode with
 <literal>O_TEXT</literal>. These symbols are defined in
 <filename>fcntl.h</filename>.</para>
 
+<para>The <function>mkstemp()</function> and <function>mkstemps()</function>
+calls force binary mode.  Use <function>mkostemp()</function> or
+<function>mkostemps()</function> with the same flags
+as <function>open()</function> for more control on temporary files.</para>
+
 <para>In the <function>fopen()</function> and <function>popen()</function>
 function calls, binary mode can be specified by adding a <literal>b</literal>
 to the mode string. Text mode is specified by adding a <literal>t</literal>