aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Macek <david.macek.0@gmail.com>2015-11-24 23:59:01 +0100
committerCorinna Vinschen <corinna@vinschen.de>2015-11-26 10:23:36 +0100
commitc33794d202fe76b156ec8753408eb95aa39cc417 (patch)
tree60b168de7ef05e5aaf56a7757767875b6dc74c6e
parent76b5c03bd726a70251d6b9e85961f62a0810fd8a (diff)
downloadnewlib-c33794d202fe76b156ec8753408eb95aa39cc417.zip
newlib-c33794d202fe76b156ec8753408eb95aa39cc417.tar.gz
newlib-c33794d202fe76b156ec8753408eb95aa39cc417.tar.bz2
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>
-rw-r--r--winsup/doc/ChangeLog5
-rw-r--r--winsup/doc/pathnames.xml3
2 files changed, 8 insertions, 0 deletions
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>