From 2693eddb3291848e0c2193f01d2ffb16639d08a8 Mon Sep 17 00:00:00 2001
From: Eric Blake <eblake@redhat.com>
Date: Mon, 19 Jul 2010 18:25:41 +0000
Subject: 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/textbinary.sgml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

(limited to 'winsup/doc/textbinary.sgml')

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>
-- 
cgit v1.2.3