Welcome to mirror list, hosted at ThFree Co, Russian Federation.

cygwin.com/git/newlib-cygwin.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCorinna Vinschen <corinna@vinschen.de>2020-04-03 22:44:00 +0300
committerCorinna Vinschen <corinna@vinschen.de>2020-04-03 22:44:00 +0300
commit44fe41a766b1f4dbb6d2f16523aea3507d10b6ef (patch)
tree8054357c09aa5584d68969de99c9e7844b0f45d6 /winsup/doc/faq-using.xml
parent44da5e4b8c89bfcee79eb83fd3b7142720489940 (diff)
Cygwin: docs: revamp docs explaining symlinks
The descriptions of symlink handling are a bit dated, so revamp them and add the new WSL symlink type. Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
Diffstat (limited to 'winsup/doc/faq-using.xml')
-rw-r--r--winsup/doc/faq-using.xml14
1 files changed, 8 insertions, 6 deletions
diff --git a/winsup/doc/faq-using.xml b/winsup/doc/faq-using.xml
index 4fca00525..4c6d8c76d 100644
--- a/winsup/doc/faq-using.xml
+++ b/winsup/doc/faq-using.xml
@@ -853,7 +853,7 @@ because they do not always work on Samba drives. Also, mounts are
faster to process because no disk access is required to resolve them.
</para>
<para>Note that non-cygwin applications will not observe Cygwin mounts (or
-symlinks for that matter). For example, if you use WinZip to unpack the
+most symlinks for that matter). For example, if you use WinZip to unpack the
tar distribution of a Cygwin package, it may not get installed to the
correct Cygwin path. <emphasis>So don't do this!</emphasis>
</para>
@@ -967,10 +967,10 @@ set you're using in future.</para>
<question><para>Why don't symlinks work on Samba-mounted filesystems?</para></question>
<answer>
-<para>Symlinks are marked with "system" file attribute. Samba does not
-enable this attribute by default. To enable it, consult your Samba
-documentation and then add these lines to your samba configuration
-file:
+<para>Default symlinks on Samba are marked with DOS SYSTEM file
+attribute. Samba does not enable this attribute by default. To enable
+it, consult your Samba documentation and then add these lines to your
+samba configuration file:
</para>
<screen>
map system = yes
@@ -980,8 +980,10 @@ file:
<para>Note that the 0775 can be anything as long as the 0010 bit is set.
</para>
<para>Alternatively, use Windows shortcuts as symlinks. See the CYGWIN
-environment variable option "winsymlinks"
+environment variable option "winsymlinks:lnk"
<ulink url="https://cygwin.com/cygwin-ug-net/using-cygwinenv.html"/>
+Note that Samba does not support reparse points so some methods to
+create symlinks are just not available.
</para>
</answer></qandaentry>