summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorEric Blake <eblake@redhat.com>2010-07-19 18:25:41 +0000
committerEric Blake <eblake@redhat.com>2010-07-19 18:25:41 +0000
commit2693eddb3291848e0c2193f01d2ffb16639d08a8 (patch)
tree723e63bf721094b4ffa6b3b8990f1e1ef7eaa919
parent3083fa9447f7a98bf23562097cf82746fe9d9c5b (diff)
downloadcygnal-2693eddb3291848e0c2193f01d2ffb16639d08a8.tar.gz
cygnal-2693eddb3291848e0c2193f01d2ffb16639d08a8.tar.bz2
cygnal-2693eddb3291848e0c2193f01d2ffb16639d08a8.zip
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].
-rw-r--r--winsup/doc/ChangeLog7
-rw-r--r--winsup/doc/new-features.sgml4
-rw-r--r--winsup/doc/textbinary.sgml7
3 files changed, 17 insertions, 1 deletions
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>