From 4da8ebe2882eb2b08dca38685ecea0ef07d1f5cc Mon Sep 17 00:00:00 2001
From: Corinna Vinschen <corinna@vinschen.de>
Date: Mon, 30 Aug 2010 13:19:39 +0000
Subject: [PATCH] 	* new-features.sgml (ov-new1.7.7): Document change to
 binmode/textmode 	link libs. 	* textbinary.sgml (textbin-devel):
 Ditto.

---
 winsup/doc/ChangeLog         |  6 ++++++
 winsup/doc/new-features.sgml |  6 ++++++
 winsup/doc/textbinary.sgml   | 24 ++++++++++++++++--------
 3 files changed, 28 insertions(+), 8 deletions(-)

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 3e231b5e4..fe47e959e 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,9 @@
+2010-08-30  Corinna Vinschen  <corinna@vinschen.de>
+
+	* new-features.sgml (ov-new1.7.7): Document change to binmode/textmode
+	link libs.
+	* textbinary.sgml (textbin-devel): Ditto.
+
 2010-08-28  Corinna Vinschen  <corinna@vinschen.de>
 
 	* new-features.sgml (ov-new1.7.7): Document change to avoid DLL
diff --git a/winsup/doc/new-features.sgml b/winsup/doc/new-features.sgml
index e459d5ffa..fdaa01ac4 100644
--- a/winsup/doc/new-features.sgml
+++ b/winsup/doc/new-features.sgml
@@ -17,6 +17,12 @@ Make sure to follow the Microsoft security advisory concerning DLL hijacking.
 See the <ulink url="http://www.microsoft.com/technet/security/advisory/2269637.mspx">Microsoft Security Advisory (2269637) "Insecure Library Loading Could Allow Remote Code Execution"</ulink> for details.
 </para></listitem>
 
+<listitem><para>
+Allow to link against -lbinmode instead of /lib/binmode.o.  Same for
+-ltextmode, -ltextreadmode and -lautomode. 
+See <xref linkend="textbin-devel"></xref> for details.
+</para></listitem>
+
 </itemizedlist>
 
 </sect2>
diff --git a/winsup/doc/textbinary.sgml b/winsup/doc/textbinary.sgml
index 7f4aae5fb..6e6e83025 100644
--- a/winsup/doc/textbinary.sgml
+++ b/winsup/doc/textbinary.sgml
@@ -142,38 +142,46 @@ in your project, like this:</para>
   $ gcc my_tiny_app.c /lib/binmode.o -o my_tiny_app
 </screen>
 
+<para>Starting with Cygwin 1.7.7, you can use the even simpler:</para>
+
+<screen>
+  $ gcc my_tiny_app.c -lbinmode -o my_tiny_app
+</screen>
+
 <para>This adds code which sets the default open mode for all files
 opened by <command>my_tiny_app</command> to binary for reading and
 writing.</para>
 
-<para>Cygwin provides the following object files to set the default open mode
-just by linking an application against them:</para>
+<para>Cygwin provides the following libraries and object files to set the
+default open mode just by linking an application against them:</para>
 
 <itemizedlist mark="bullet">
 
 <listitem>
 <screen>
-/lib/automode.o      -  Open files for reading in textmode
-                        Open files for writing in binary mode
+/lib/libautomode.a      -  Open files for reading in textmode,
+/lib/automode.o            open files for writing in binary mode
 </screen>
 </listitem>
 
 <listitem>
 <screen>
-/lib/binmode.o       -  Open files for reading and writing in binary mode
+/lib/libbinmode.a       -  Open files for reading and writing in binary mode
+/lib/binmode.o
 </screen>
 </listitem>
 
 <listitem>
 <screen>
-/lib/textmode.o      -  Open files for reading and writing in textmode
+/lib/libtextmode.a      -  Open files for reading and writing in textmode
+/lib/textmode.o
 </screen>
 </listitem>
 
 <listitem>
 <screen>
-/lib/textreadmode.o  -  Open files for reading in textmode
-                        Keep default behaviour for writing.
+/lib/libtextreadmode.a  -  Open files for reading in textmode,
+/lib/textreadmode.o        keep default behaviour for writing.
 </screen>
 </listitem>