This is the mail archive of the
cygwin
mailing list for the Cygwin project.
Re: strftime man page is garbled
- From: Jon TURNEY <jon dot turney at dronecode dot org dot uk>
- To: cygwin at cygwin dot com
- Date: Thu, 04 Jun 2015 15:34:40 +0100
- Subject: Re: strftime man page is garbled
- Authentication-results: sourceware.org; auth=none
- References: <556FEFA8 dot 6010100 at gmail dot com> <0D835E9B9CD07F40A48423F80D3B5A702E8EB187 at USA7109MB022 dot na dot xerox dot 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