strftime man page is garbled
Jon TURNEY
jon.turney@dronecode.org.uk
Thu Jun 4 14:34:00 GMT 2015
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
More information about the Cygwin
mailing list