> --- Ursprüngliche Nachricht ---
> Von: Jesse Barnes <[email protected]>
> An: "Michael Kerrisk" <[email protected]>
> Kopie: [email protected], [email protected]
> Betreff: Re: man-pages-2.22 is released
> Datum: Mon, 6 Feb 2006 14:51:36 -0800
>
> On Monday, February 6, 2006 11:59 am, Michael Kerrisk wrote:
> > This is a request to kernel developers: if you make a change
> > to a kernel-userland interface, or observe a discrepancy
> > between the manual pages and reality, would you please send
> > me (at [email protected] ) one of the following
> > (in decreasing order of preference):
>
> Wouldn't it be easier for you to keep them up to date if sections 2, 4,
> and parts of 5 were included in the kernel source tree? Documentation
> updates could be enforced as part of the patch process--all you'd have
> to do is NAK patches that modified userland interfaces if they didn't
> contain documentation updates (and I'm sure others would help you with
> that task).
Life is not so simple, as I think we discussed when you made
a similar comment after my man-pages-2.08 release. Maybe the
system can be improved still. Currently Andrew Morton is being
rather good about CCing me on patches that are likely to need
man-pages changes. (Thanks Andrew!)
> Likewise with the glibc stuff. Doesn't it belong with the glibc project?
> Wouldn't that make more sense, both from a packaging and maintenance
> perspective?
Not really -- glibc has a differnt philosophy about documentation
(less focus on historical information and less comparison
with other Unix systems, as far as I can see), and uses info(1),
not man(1).
> Either way, thanks a lot for keeping the pages in good shape, it's much
> appreciated.
You're welcome. Several people help. More help is
always welcome.
Cheers,
Michael
--
Michael Kerrisk
maintainer of Linux man pages Sections 2, 3, 4, 5, and 7
Want to help with man page maintenance?
Grab the latest tarball at
ftp://ftp.win.tue.nl/pub/linux-local/manpages/,
read the HOWTOHELP file and grep the source
files for 'FIXME'.
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/
[Index of Archives]
[Kernel Newbies]
[Netfilter]
[Bugtraq]
[Photo]
[Stuff]
[Gimp]
[Yosemite News]
[MIPS Linux]
[ARM Linux]
[Linux Security]
[Linux RAID]
[Video 4 Linux]
[Linux for the blind]
[Linux Resources]
