From c18f7d72dc5554b1e12f035fcf7d66be25ee3881 Mon Sep 17 00:00:00 2001 From: Corinna Vinschen Date: Mon, 4 Mar 2019 14:03:32 +0100 Subject: [PATCH] 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 --- winsup/doc/specialnames.xml | 25 +++++++++++++++++++------ 1 file 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 Programs and Features -> turning WSL on and performing the compulsory reboot, case-sensitive directories are activated. -With WSL activated and starting with Cygwin 3.0, -Cygwin's mkdir system call will automatically create all +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 +Microsoft's WSL issue tracker, +if you're interested in the details. + +If you want case-sensitivity and need interoperability with remote +machines, better stick to switching the kernel to case-sensitivity as +outlined in + +With WSL activated and starting with Cygwin 3.0.0, +Cygwin's mkdir 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 tool -with the -C option to control case-sensitivity of -directories on NTFS filesystems. +With Cygwin 3.0.2, this feature had been disabled again for hopefully +obvious reasons. + +However, you can still use Cygwin's new + tool with the -C option +to control case-sensitivity of directories on NTFS filesystems. Please keep in mind that switching off case-sensitivity on a directory has a condition attached to it: If