This is the mail archive of the
libc-alpha@sourceware.org
mailing list for the glibc project.
Re: For review: memusage(1) man page
- From: "Michael Kerrisk (man-pages)" <mtk dot manpages at gmail dot com>
- To: ams at gnu dot org, Jan Chaloupka <jchaloup at redhat dot com>
- Cc: mtk dot manpages at gmail dot com, linux-man at vger dot kernel dot org, libc-alpha at sourceware dot org, myllynen at redhat dot com, drepper at gmail dot com, pschiffe at redhat dot com
- Date: Tue, 22 Jul 2014 08:10:18 +0200
- Subject: Re: For review: memusage(1) man page
- Authentication-results: sourceware.org; auth=none
- References: <53C8E244 dot 2080901 at redhat dot com> <E1X84Kh-00041J-2z at fencepost dot gnu dot org>
On 07/18/2014 11:20 AM, Alfred M. Szmidt wrote:
> memusage command is no documented. My collegue (95%) and I (5%)
> have written a man page for it. All informations come from
> inspecting the script code. This is the first script, others are
> memusagestat (1) and mtrace(1).
>
> This, memusagestat, and mtrace should rather be put into the glibc
> manual. mtrace is already (though partially) documented there, and
> much of the details regarding the mtrace functions. Having the
> corresponding commands documented would be awesome though.
> .
I must say that this is an odd position to take. While it would be
nice to have documentation in the glibc manual, the glibc developers
did not bother to add anything to the manual when writing these
interfaces, so it hardly seems like anyone else is obligated to do
so (assuming that person wanted to even jump the CLA hurdle...).
In any case, man pages does (good) pages that describe the
libc interfaces (including commands).
Cheers,
Michael
--
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/