DomainKey-Signature: a=rsa-sha1; c=nofws; d=sourceware.org; h=list-id
	:list-unsubscribe:list-subscribe:list-archive:list-post
	:list-help:sender:to:from:subject:message-id:date:mime-version
	:content-type:content-transfer-encoding; q=dns; s=default; b=Shh
	sxpBU0of75ZSfg7EFDNim0taEzjZKZ64/WdES9S+/zgQm6XDHVerg5zDtz+6M1Hj
	pxWfV0ihjEIxC3eSPqW7za0tXInFoIpvrOkovG1rg5wwG8Ejlw9zw1yaAkjtYSuH
	IK+kx42YfGNnyW6EsdEsasV5mzYQRhIsxX663SkY=
Mailing-List: contact cygwin-help@cygwin.com; run by ezmlm
Sender: cygwin-owner@cygwin.com
Mail-Followup-To: cygwin@cygwin.com
To: cygwin <cygwin@cygwin.com>
From: Ken Brown <kbrown@cornell.edu>
Subject: The Cygwin User Guide on path names
Message-ID: <6a728c0c-81e8-b92b-8344-476d736e2306@cornell.edu>
Date: Tue, 23 Aug 2016 12:16:14 -0400
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.2.0
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit

The section on path names in the user guide 
(https://cygwin.com/cygwin-ug-net/using.html#using-pathnames) strikes me 
as misleading when it says in the first sentence, "Cygwin supports both 
POSIX- and Win32-style paths."  I think it would be better to say "The 
Cygwin DLL" and to emphasize that Cygwin applications do *not* 
necessarily support Win32 paths.  See

   https://www.cygwin.com/ml/cygwin/2016-08/msg00409.html

for a recent example where this has come up.  It's also come up in 
connection with git and emacs and probably many other applications.

The documentation also says, "The usage of Win32 paths, though possible, 
is deprecated...."  I wonder if this should be strengthened to say 
something like, "The usage of Win32 paths, though possible, is strongly 
deprecated and may be removed in a future release of Cygwin."

I'll be glad to prepare a documentation patch.

Ken

--
Problem reports:       http://cygwin.com/problems.html
FAQ:                   http://cygwin.com/faq/
Documentation:         http://cygwin.com/docs.html
Unsubscribe info:      http://cygwin.com/ml/#unsubscribe-simple