libs/newlib-cygwin
libs/newlib-cygwin
4
0
Fork 0
mirror of git://sourceware.org/git/newlib-cygwin.git synced 2025-01-31 19:40:33 +08:00
Code Issues Projects Releases Wiki Activity

Cygwin: doc: update case-sensitive dirs description

Browse Source 
Since we have to disable automatic case-sensitive mkdir again,
change documentation accordingly.

Signed-off-by: Corinna Vinschen <corinna@vinschen.de>
This commit is contained in:
Corinna Vinschen 2019-03-04 14:03:32 +01:00
parent 38dde5f4c4
commit c18f7d72dc
1 changed files with 19 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
winsup/doc/specialnames.xml
View File

@ -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