X-Recipient: archive-cygwin AT delorie DOT com
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=
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; 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; s=default; bh=s4PZm1cAX
	39b/+szVB0ECwwz00s=; b=jjq8bme5FNPtnuFd04yu20P3nLG/KKRtzBhh3YfcD
	dcV+xc9sXMygBH6uf/82hwoFa3HKjtj+wszF2eaj8xtDDWFFH9/uytjMShCIyugx
	Pg1jYpa265/6btlELkbfUFxII4VQhPw3G5NTZOX95yo7N8fdFFhXOuWeEz2OhX3q
	b4=
Mailing-List: contact cygwin-help AT cygwin DOT com; run by ezmlm
List-Id: <cygwin.cygwin.com>
List-Subscribe: <mailto:cygwin-subscribe AT cygwin DOT com>
List-Archive: <http://sourceware.org/ml/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-help AT cygwin DOT com>, <http://sourceware.org/ml/#faqs>
Sender: cygwin-owner AT cygwin DOT com
Mail-Followup-To: cygwin AT cygwin DOT com
Delivered-To: mailing list cygwin AT cygwin DOT com
Authentication-Results: sourceware.org; auth=none
X-Virus-Found: No
X-Spam-SWARE-Status: No, score=-2.2 required=5.0 tests=AWL,BAYES_00,RP_MATCHES_RCVD,SPF_HELO_PASS,SPF_PASS autolearn=ham version=3.3.2 spammy=strikes
X-HELO: limerock04.mail.cornell.edu
X-CornellRouted: This message has been Routed already.
To: cygwin <cygwin AT cygwin DOT com>
From: Ken Brown <kbrown AT cornell DOT 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
X-PMX-Cornell-Gauge: Gauge=XXXXX
X-PMX-CORNELL-AUTH-RESULTS: dkim-out=none;
X-IsSubscribed: yes

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