From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 16514 invoked by alias); 4 Mar 2019 13:14:31 -0000 Mailing-List: contact cygwin-cvs-help@cygwin.com; run by ezmlm Precedence: bulk List-Id: List-Subscribe: List-Post: List-Help: , Sender: cygwin-cvs-owner@cygwin.com Received: (qmail 16403 invoked by uid 9078); 4 Mar 2019 13:14:31 -0000 Date: Mon, 04 Mar 2019 13:14:00 -0000 Message-ID: <20190304131431.16400.qmail@sourceware.org> Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Corinna Vinschen To: cygwin-cvs@sourceware.org Subject: [newlib-cygwin] Cygwin: doc: update case-sensitive dirs description X-Act-Checkin: newlib-cygwin X-Git-Author: Corinna Vinschen X-Git-Refname: refs/heads/master X-Git-Oldrev: 38dde5f4c4c2e33dfe6dfb9d1bc593d13d85a290 X-Git-Newrev: c18f7d72dc5554b1e12f035fcf7d66be25ee3881 X-SW-Source: 2019-q1/txt/msg00212.txt.bz2 https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=c18f7d72dc5554b1e12f035fcf7d66be25ee3881 commit c18f7d72dc5554b1e12f035fcf7d66be25ee3881 Author: Corinna Vinschen Date: Mon Mar 4 14:03:32 2019 +0100 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 Diff: --- 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 f278360..1120f86 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