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>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit

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