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=n0kXLPGYn+r4RgImG2Qw5ZYVD2FVxhQn9ls6lK1PfV6
	3RQFNSe0WjFBzCTXGYUPC0hDwnyC5dY0lGwmew0Ptc4L+iVVJaMhPlb4d9VsmvOP
	g419wh2EkeHGGAmNdBT7LoRjFIYnkfm1pKNzzS/XUCiVBrp05IlqpxqUXQocvcR4
	=
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=awc/XQ0hj2yNjUvgE0QnbNTgnwc=; b=Xwb/sFABe/e84LF6w
	QZHpvNow0BaEcDfkBd7WY1IvGPiD1iwLFLe05slOFKRU/g+o9bYtcC3B4DYtb0bP
	zC5LbL/ckdUL+tXkKbKTlKDh+q1Olo1nuxFEI5W+6BCLE8BZG4DFJABWCNzDQirs
	Ho8x1bQ9THnkN1+3OmiHV4B4JY=
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=-0.8 required=5.0 tests=AWL,BAYES_50,RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.2
X-HELO:	out4-smtp.messagingengine.com
Message-ID:	<55706200.1000205@dronecode.org.uk>
Date:	Thu, 04 Jun 2015 15:34:40 +0100
From:	Jon TURNEY <jon DOT turney AT dronecode DOT org DOT uk>
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>
In-Reply-To:	<0D835E9B9CD07F40A48423F80D3B5A702E8EB187@USA7109MB022.na.xerox.net>

On 04/06/2015 14:09, Nellis, Kenneth wrote:
> From: Marco Atzeri
>> <snip>
>> It looks a man-db issue, it misinterprets the ' at the begin
>> of the phrase.
>>
>> Adding a single space before works fine.
>
> Perhaps preferred would be to highlight the name with .B:
>
> $ diff -u before after
> --- before      2015-06-04 08:37:08.693623000 -0400
> +++ after       2015-06-04 08:47:17.078420500 -0400
> @@ -10,7 +10,8 @@
>            const struct tm *restrict TIMP);
>
>   .SH DESCRIPTION
> -'strftime' converts a 'struct tm' representation of the time (at TIMP)
> +.B strftime
> +converts a 'struct tm' representation of the time (at TIMP)
>   into a null-terminated string, starting at S and occupying no more than
>   MAXSIZE characters.
>

It might well be that starting a line with ' is not valid troff markup.

Thanks for the patch.

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

[1] 
https://github.com/jon-turney/cygwin/commit/f957adfea38022bd3ab076ca77871b53be0ef654


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

- Raw text -