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:reply-to:mime-version:to
	:subject:references:in-reply-to:content-type
	:content-transfer-encoding; q=dns; s=default; b=mV4pyxO/bM2gf0I6
	ir9dgwzsA3T3PXbdfTMPs5JNkLr4YyhQBXcrkT4cNga2Sg1PUXUkcqvDZFyyqd+f
	cX7sFciuTrowk6tB2LfNNR7R/IXmPWMunlX2XNpQBtQVMobZKkoX3in6kGlOy2iX
	mUvMfosp87nbcZPTvnueC9zOR64=
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:reply-to:mime-version:to
	:subject:references:in-reply-to:content-type
	:content-transfer-encoding; s=default; bh=Jjzm9pVHiuQPh+Hmjte9Yr
	Rsrdg=; b=IGUcRkPYztCDtujx28Yu8B4yjcfzbMs1+Z+zkLl5kROU++5O6wB7KH
	oMYMc0bT3TcvFforHR8V88qZ0xLoh4liTMndoii7+5RHb8ilc0lRpUJm5+SMJKXZ
	IlNGJ/2cVh5/j6sNXTv7dAj/so+KT8jdM4GuOekMKI9212r/5cdFg=
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.1 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.2
X-HELO: out4-smtp.messagingengine.com
Message-ID: <55719567.7090608@dronecode.org.uk>
Date: Fri, 05 Jun 2015 13:26:15 +0100
From: Jon TURNEY <jon DOT turney AT dronecode DOT org DOT uk>
Reply-To: cygwin AT cygwin DOT com
User-Agent: Mozilla/5.0 (Windows NT 6.3; WOW64; rv:31.0) Gecko/20100101 Thunderbird/31.7.0
MIME-Version: 1.0
To: cygwin AT cygwin DOT com
Subject: Re: strftime man page is garbled
References: <556FEFA8 DOT 6010100 AT gmail DOT com> <0D835E9B9CD07F40A48423F80D3B5A702E8EB187 AT USA7109MB022 DOT na DOT xerox DOT net> <55706200 DOT 1000205 AT dronecode DOT org DOT uk> <557065AC DOT 2030500 AT redhat DOT com>
In-Reply-To: <557065AC.2030500@redhat.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit

On 04/06/2015 15:50, Eric Blake wrote:
> On 06/04/2015 08:34 AM, Jon TURNEY wrote:
>
>> Unfortunately, the manpages in cygwin-doc are automatically generated
>> from the newlib .info pages by a perl script (See newlibinfo2man.pl in [1])
>>
>> I'm not sure if these man pages are much use now that we have
>> man-pages-posix
>
> GNU/Linux systems have two sections: 'man 3' for system writeup, and
> 'man 3p' for POSIX pages. This is useful, because in many instances, the
> system writeup has more details about Linux-specific extensions, while
> the 3p page is more useful for limiting usage to just portable aspects.
>   Having both sets shouldn't hurt, if we have a way to easily open from
> either set.

Ok.

I don't think the approach of trying to convert the .info is ever going 
to lead to particularly good results, though.  Perhaps this would be 
better implemented as part of newlib, operating on the .texinfo output 
of, or as part of makedoc.


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