On 04/09/2013 08:11 PM, Mike Frysinger wrote:
On Tuesday 09 April 2013 14:08:18 Peter Schiffer wrote:
My aim here is, that when I'm opening man page in section 2, the first
thing I'm expecting to see is syscall signature. In clone(2), it's not
even clear that this is a library call.
err, the very first sentence of the first paragraph says it's exactly this:
clone() creates a new process, in a manner similar to fork(2). It is
actually a library function layered on top of the underlying clone()
system call, hereinafter referred to as sys_clone. A description of
sys_clone is given toward the end of this page.
-mike
Yeah, I know. But you have to read the description to know that.
Problem is, that if you are familiar with the call, you won't read the
description (for example, if you just forgot the signature).
Another real world example: we work with many experienced developers
used to other Unices, so, you can try to imagine how unfortunate for
them this can be.
Also, we are afraid that this doesn't have to complain with the Common
Criteria. Every syscall has to be documented, so when I'm looking for
the documentation of clone(2) syscall in the clone(2) man page, I'm
expecting that it will be the main topic in the page, and in the
synopsis.
I'm just trying to prevent possible misunderstandings, and if possible,
make the page little bit more clearer..
peter
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
