diff options
| -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 |