* 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.

winsup/doc/ChangeLog

@@ -1,3 +1,10 @@
+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.

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">
@@ -18,10 +35,6 @@ creating the cygdrive directory.  If Windows claims the drive is
 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.

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> 
+<para>While there is no need to create a POSIX <filename>/dev</filename> 
-directory as Cygwin automatically simulates it internally. 
+directory, the directory is automatically created as part of a Cygwin
-These devices cannot be seen with the command <command>ls /dev/</command>
+installation.  It's existence is often a prerequisit to run certain
-although commands such as <command>ls /dev/tty</command> work fine.
+applications which create symbolic links, fifos, or UNIX sockets in
-If you want to be able to see all well-known devices in
+<filename>/dev</filename>.  Also, the directories <filename>/dev/shm</filename>
-<filename>/dev/</filename>, you can use Igor Pechtchanski's
+and <filename>/dev/mqueue</filename> are required to exist to use named POSIX
-<ulink
+semaphores, shared memory, and message queues, so a system without a real
-url="http://cygwin.com/ml/cygwin/2004-03/txt00028.txt">create_devices.sh</ulink>
+<filename>/dev</filename> directory is functionally crippled.
-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>
 
+<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>