* cygwinenv.sgml (cygwinenv-implemented-options): Try to make

	compatibility new symlinks vs. old Cygwin clearer.

diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index ed656af..27cf8f1 100644 (file)
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,8 @@
+2010-01-12  Corinna Vinschen  <corinna@vinschen.de>
+
+       * cygwinenv.sgml (cygwinenv-implemented-options): Try to make
+       compatibility new symlinks vs. old Cygwin clearer.
+
 2010-01-10  Corinna Vinschen  <corinna@vinschen.de>
 
        * pathnames.sgml (mount-table): Add info that posix=0 is default for

diff --git a/winsup/doc/cygwinenv.sgml b/winsup/doc/cygwinenv.sgml
index afd5392..23e4d64 100644 (file)
--- a/winsup/doc/cygwinenv.sgml
+++ b/winsup/doc/cygwinenv.sgml
@@ -142,10 +142,12 @@ variables.  The current list of always uppercased variables is:</para>
 symlinks as Windows shortcuts with a special header and the R/O attribute
 set. If not set, Cygwin creates symlinks as plain files with a magic number,
 a path and the system attribute set. Defaults to not set since plain
-file symlinks are faster to write and faster to read.  The new style of
-plain file symlinks is incompatible with older Cygwin releases because
-the new symlinks use UTF-16 to encode the target filename, while the
-old symlinks used the current ANSI or OEM charset.</para>
+file symlinks are faster to write and faster to read.</para>
+
+<para>Please note that symlinks created under Cygwin 1.7 or later are
+not readable by older Cygwin releases because the new symlinks use UTF-16
+to encode the target filename, while the old symlinks used the current
+ANSI or OEM charset.</para>
 </listitem>
 
 </itemizedlist>