On Wed, 23 Apr 2008, Michael Kerrisk wrote:
Hi Reuben,
On Wed, Apr 23, 2008 at 1:04 AM, Reuben Thomas <[EMAIL PROTECTED]> wrote:
Package: manpages-dev
Version: 2.79-2
Severity: minor
In the DESCRIPTION section, "utimes()" has an outdented heading, but
"utime()" does not. By comparison with other similar man pages it seems
the most consistent thing would be to remove the heading for utimes().
There are some other pages that are like this, e.g., poll.2,
epoll_wait.2.
In that case, there are two inconsistencies: that between pages like this
and pages not like this, and that within the pages, between the functions
that have headings and those that don't.
I suggest you pick a preferred style. I'd be happy to have a look for pages
that don't currently match your preferred style, and submit patches. Since
it's not a major problem, it doesn't matter if not all the pages that need
fixing are found in the first pass.
I find having headings makes the pages that deal with multiple functions
more legible, so I'd be happy to add them for the first function in each
case, and to multi-function pages that currently lack any per-function
headings.
--
http://rrt.sc3d.org/ | sad, a. the efforts of musical debutantes (Bierce)
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
