This is the mail archive of the
cygwin-cvs@cygwin.com
mailing list for the Cygwin project.
[newlib-cygwin] Add a section describing peculiarities of how Cygwin creates NTFS symlinks
- From: Corinna Vinschen <corinna at sourceware dot org>
- To: cygwin-cvs at sourceware dot org
- Date: 26 Nov 2015 09:27:35 -0000
- Subject: [newlib-cygwin] Add a section describing peculiarities of how Cygwin creates NTFS symlinks
https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=c33794d202fe76b156ec8753408eb95aa39cc417
commit c33794d202fe76b156ec8753408eb95aa39cc417
Author: David Macek <david.macek.0@gmail.com>
Date: Tue Nov 24 23:59:01 2015 +0100
Add a section describing peculiarities of how Cygwin creates NTFS symlinks
First take on how to describe dereferencing of Cygwin-only symlinks path
components when creating NTFS symlinks.
Note that I haven't tried building the documentation, so I don't know if
the added paragraph breaks anything. Hopefully not.
* pathnames.xml: Add a section describing peculiarities of how Cygwin
creates NTFS symlinks.
Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
Diff:
---
winsup/doc/ChangeLog | 5 +++++
winsup/doc/pathnames.xml | 3 +++
2 files changed, 8 insertions(+)
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 9185f21..ec9f40f 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,5 +1,10 @@
2015-11-24 David Macek <david.macek.0@gmail.com>
+ * pathnames.xml: Add a section describing peculiarities of how Cygwin
+ creates NTFS symlinks.
+
+2015-11-24 David Macek <david.macek.0@gmail.com>
+
* faq-using.xml: Add Forefront TMG to the BLODA.
2015-11-21 Corinna Vinschen <corinna@vinschen.de>
diff --git a/winsup/doc/pathnames.xml b/winsup/doc/pathnames.xml
index cdbf9fa..9077303 100644
--- a/winsup/doc/pathnames.xml
+++ b/winsup/doc/pathnames.xml
@@ -407,6 +407,9 @@ these two settings, see <xref linkend="using-cygwinenv"></xref>.
On AFS, native symlinks are the only supported type of symlink due to
AFS lacking support for DOS attributes. This is independent from the
<literal>winsymlinks</literal> setting.</para>
+<para>Creation of native symlinks follows special rules to ensure the links
+are usable outside of Cygwin. This includes dereferencing any Cygwin-only
+symlinks that lie in the target path.</para>
</listitem>
<listitem>