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: [PATCH] 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         | 7 +++++++
 winsup/doc/new-features.sgml | 4 ++++
 winsup/doc/textbinary.sgml   | 7 ++++++-
 3 files changed, 17 insertions(+), 1 deletion(-)

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index ca4b196a8..f2e49999a 100644
--- a/winsup/doc/ChangeLog
+++ b/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.
diff --git a/winsup/doc/new-features.sgml b/winsup/doc/new-features.sgml
index 97c2809c2..8cef1f9b5 100644
--- a/winsup/doc/new-features.sgml
+++ b/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>
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>