diff options
author | Corinna Vinschen <corinna@vinschen.de> | 2019-03-04 16:03:32 +0300 |
---|---|---|
committer | Corinna Vinschen <corinna@vinschen.de> | 2019-03-04 16:03:32 +0300 |
commit | c18f7d72dc5554b1e12f035fcf7d66be25ee3881 (patch) | |
tree | 0be76ce19b27f59c74fb04bae73d94cff4577e47 | |
parent | 38dde5f4c4c2e33dfe6dfb9d1bc593d13d85a290 (diff) |
Cygwin: doc: update case-sensitive dirs description
Since we have to disable automatic case-sensitive mkdir again,
change documentation accordingly.
Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
-rw-r--r-- | winsup/doc/specialnames.xml | 25 |
1 files changed, 19 insertions, 6 deletions
diff --git a/winsup/doc/specialnames.xml b/winsup/doc/specialnames.xml index f27836032..1120f86b1 100644 --- a/winsup/doc/specialnames.xml +++ b/winsup/doc/specialnames.xml @@ -230,13 +230,26 @@ feature available via <literal>Programs and Features</literal> -> turning <literal>WSL</literal> on and performing the compulsory reboot, case-sensitive directories are activated.</para> -<para>With <literal>WSL</literal> activated and starting with Cygwin 3.0, -Cygwin's <command>mkdir</command> system call will automatically create all +<para>Of course, there's a drawback. While these case-sensitive directories +work like charm on the local machine, there are massive interoperability +problems when trying to access these directories from remote machines at +the time of writing this. We opened a bug report for that at +<ulink url="https://github.com/Microsoft/WSL/issues/3885">Microsoft's WSL issue tracker</ulink>, +if you're interested in the details.</para> + +<note><para>If you want case-sensitivity and need interoperability with remote +machines, better stick to switching the kernel to case-sensitivity as +outlined in <xref linkend="pathnames-casesensitive"></xref></para></note> + +<para>With <literal>WSL</literal> activated and starting with Cygwin 3.0.0, +Cygwin's <command>mkdir</command> system call automatically created all directories below the Cygwin installation directory as case-sensitive. -Directories created outside the Cygwin installation tree will be left -alone. However, you can use Cygwin's new <xref linkend="chattr"></xref> tool -with the <literal>-C</literal> option to control case-sensitivity of -directories on NTFS filesystems.</para> +With Cygwin 3.0.2, this feature had been disabled again for hopefully +obvious reasons.</para> + +<para>However, you can still use Cygwin's new +<xref linkend="chattr"></xref> tool with the <literal>-C</literal> option +to control case-sensitivity of directories on NTFS filesystems.</para> <para>Please keep in mind that switching <emphasis>off</emphasis> case-sensitivity on a directory has a condition attached to it: If |