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:message-id:date:from:mime-version:to:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	 q=dns; s=default; b=v8dNzRsu25WlpbSFSN4k12ABQRVgSgA1wc1q2eU1V3j
	h1AbabN3h0WRQ4ogV5nq+aQSMHyYg1UFnHA8ldJVkYxeIhCL21DFYLPvOeZEL5ap
	fGqaUzYU/AUDigTbXAkt+29f2oEQDh7C3d4m5CnfgVny70lkq75M5huhWH8MX3CY
	=
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:message-id:date:from:mime-version:to:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	 s=default; bh=3dGLHQVgztTH0+4DXeE5LGgRMYw=; b=gWDLzIuaUzM5Wq0nR
	ZEmqQdHP0b3ru7p+yVPNN3XQyfDwpGzUT22fvPcEGtnxlj0asCM3VbrL/amItBa6
	nk8z+WRnc2nHNyEjnqmy0wBOUno5eJXuT1Jm0YeRAjBMPBRDg0uYQszvvo5MI40P
	8Xp1gicQShUNWu7HpsQV5NcMkQ=
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
X-Spam-SWARE-Status: No, score=-4.4 required=5.0 tests=AWL,BAYES_00,KHOP_THREADED,RP_MATCHES_RCVD autolearn=ham version=3.3.1
Message-ID: <518C55BD.7020807@etr-usa.com>
Date: Thu, 09 May 2013 20:04:45 -0600
From: Warren Young <warren AT etr-usa DOT com>
User-Agent: Mozilla/5.0 (Windows NT 6.2; WOW64; rv:17.0) Gecko/20130328 Thunderbird/17.0.5
MIME-Version: 1.0
To: Cygwin-L <cygwin AT cygwin DOT com>
Subject: Re: Cygwin manpages clobbered
References: <5F8AAC04F9616747BC4CC0E803D5907D0AF787B3 AT MLBXv04 DOT nih DOT gov>
In-Reply-To: <5F8AAC04F9616747BC4CC0E803D5907D0AF787B3@MLBXv04.nih.gov>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit

On 5/9/2013 13:37, Lavrentiev, Anton (NIH/NLM/NCBI) [C] wrote:
>
> I'm using stock Cygwin 1.7.18-1, and tried to read manpages about Cygwin
> path conversion routines, cygwin_conv_path() et al.  The output does not
> appear formatted properly,

This appears to be a very old problem.

Here's what I know so far, after some time spent looking into it:

0. You're talking about /usr/share/man/man3/cygwin_conv_path.3.gz, which 
was probably generated from winsup/cygwin/path.sgml in the Cygwin source 
tree through a processing chain that remains obscure to me.

1. That file comes from the cygwin-doc package, which was last built 
about three years ago.  Further, the source file in question hasn't been 
touched since December 2009.

2. If you zless the raw man page file, you can see that the problem is 
in the generated file.  That rules out the other pieces in the chain 
between raw bits on the disk and your eyes: mintty, groff, $PAGER, etc.

There's rumblings from the powers that be that such documentation might 
be generated differently soon, so we're at a good point to talk about 
fixing this.

While you wait for those of us in charge of the docs to figure out how 
we want to proceed, I suggest you use the web version.  That function's 
documented here: http://cygwin.com/cygwin-api/func-cygwin-conv-path.html

As you can see, the web and man pages look to have come from the same 
source; they differ almost entirely in formatting.  I did see *one* 
content difference.  My guess is that this is because the cygwin-doc 
package was generated from output files generated before April 2010, 
whereas the web pages get rebuilt much more often.

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