* new-features.sgml (ov-new1.7.12): Create. Move mountinfo here.

	Add /dev notice.
	* pathnames.sgml (pathnames-posixdevices): Rephrase to account for
	/dev change in 1.7.12.

3 files changed, 41 insertions, 15 deletions

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index e19de178d..ab58c5cd9 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,5 +1,12 @@
 2012-03-27  Corinna Vinschen  <corinna@vinschen.de>
 
+	* new-features.sgml (ov-new1.7.12): Create.  Move mountinfo here.
+	Add /dev notice.
+	* pathnames.sgml (pathnames-posixdevices): Rephrase to account for
+	/dev change in 1.7.12.
+
+2012-03-27  Corinna Vinschen  <corinna@vinschen.de>
+
 	* new-features.sgml (ov-new1.7.11): Add mountinfo.
 
 2012-03-01  Yaakov Selkowitz  <yselkowitz@users.sourceforge.net>
diff --git a/winsup/doc/new-features.sgml b/winsup/doc/new-features.sgml
index 534b3f9f6..a5216f8a8 100644
--- a/winsup/doc/new-features.sgml
+++ b/winsup/doc/new-features.sgml
@@ -1,5 +1,22 @@
 <sect1 id="ov-new1.7"><title>What's new and what changed in Cygwin 1.7</title>
 
+<sect2 id="ov-new1.7.12"><title>What's new and what changed from 1.7.11 to 1.7.12</title>
+
+<itemizedlist mark="bullet">
+
+<listitem><para>
+Cygwin now automatically populates the /dev directory with all existing
+POSIX devices.
+</para></listitem>
+
+<listitem><para>
+Add virtual /proc/PID/mountinfo file.
+</para></listitem>
+
+</itemizedlist>
+
+</sect2>
+
 <sect2 id="ov-new1.7.11"><title>What's new and what changed from 1.7.10 to 1.7.11</title>
 
 <itemizedlist mark="bullet">
@@ -19,10 +36,6 @@ unavailable, don't show it in the cygdrive directory listing.
 </para></listitem>
 
 <listitem><para>
-Add virtual /proc/PID/mountinfo file.
-</para></listitem>
-
-<listitem><para>
 Raise default stacksize of pthreads from 512K to 1 Meg.  It can still be
 changed using the pthread_attr_setstacksize call.
 </para></listitem>
diff --git a/winsup/doc/pathnames.sgml b/winsup/doc/pathnames.sgml
index 5506eeb36..e2a031581 100644
--- a/winsup/doc/pathnames.sgml
+++ b/winsup/doc/pathnames.sgml
@@ -689,19 +689,25 @@ Read on for more information.</para>
 </sect2>
 
 <sect2 id="pathnames-posixdevices"> <title>POSIX devices</title>
-<para>There is no need to create a POSIX <filename>/dev</filename> 
-directory as Cygwin automatically simulates it internally. 
-These devices cannot be seen with the command <command>ls /dev/</command>
-although commands such as <command>ls /dev/tty</command> work fine.
-If you want to be able to see all well-known devices in
-<filename>/dev/</filename>, you can use Igor Pechtchanski's
-<ulink
-url="http://cygwin.com/ml/cygwin/2004-03/txt00028.txt">create_devices.sh</ulink>
-script.  This script does not add the raw disk devices, though.  Again,
-it's not necessary to see an existing device in /dev to access it.  The script
-is just for the fun of it.
+<para>While there is no need to create a POSIX <filename>/dev</filename> 
+directory, the directory is automatically created as part of a Cygwin
+installation.  It's existence is often a prerequisit to run certain
+applications which create symbolic links, fifos, or UNIX sockets in
+<filename>/dev</filename>.  Also, the directories <filename>/dev/shm</filename>
+and <filename>/dev/mqueue</filename> are required to exist to use named POSIX
+semaphores, shared memory, and message queues, so a system without a real
+<filename>/dev</filename> directory is functionally crippled.
 </para>
 
+<para>Apart from that, Cygwin automatically simulates POSIX devices
+internally.  Up to Cygwin 1.7.11, these devices couldn't be seen with the
+command <command>ls /dev/</command> although commands such as
+<command>ls /dev/tty</command> worked fine.  Starting with Cygwin 1.7.12,
+the <filename>/dev</filename> directory is automagically populated with
+existing POSIX devices by Cygwin in a way comparable with a
+<ulink url="http://en.wikipedia.org/wiki/Udev">udev</ulink> based virtual
+<filename>/dev</filename> directory under Linux.</para>
+
 <para>
 Cygwin supports the following character devices commonly found on POSIX systems:
 </para>