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].

winsup/doc/ChangeLog

@@ -1,3 +1,10 @@
+2010-07-19  Eric Blake  <eblake@redhat.com>
+
+	* 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].
+
 2010-06-27  Yaakov Selkowitz  <yselkowitz@users.sourceforge.net>
 
 	* Makefile.in: Use "xmlto pdf" instead of docbook2pdf.

winsup/doc/new-features.sgml

@@ -30,6 +30,10 @@ strings.  locale(1) prints these values just as on Linux.  nl_langinfo(3)
 allows to fetch them.
 </para></listitem>
 
+<listitem><para>
+New interfaces mkostemp(3) and mkostemps(3) are added.
+</para></listitem>
+
 </itemizedlist>
 
 </sect2>

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>