Re: [PATCH] ptrace: add ability to retrieve signals without removing from a queue (v2)

On Mon, 25 Feb 2013 23:28:11 +0100
"Michael Kerrisk (man-pages)" [off-list ref] wrote:

quoted

Please, document the interface *completely* so that others can review
the design and can then check that the implementation matches that
design.  As it stands, we're reduced to mind-reading.

+1.

I suddenly feel less lonely.

Andrey, please don't assume that people have read past mails. Even if
they have, they're forgetful. Don't make people hunt down old mails to
try to put the pieces together. The changelog should include a full
description of the interface, and also the sample user-space code that
you showed at some point in another mail.

If there's sample userspace code, there are all sorts of good reasons
for putting that into tools/testing/selftests/your-name-here/

That may help you get better
review, and it will certainly help make a better man page.