On Mon, 25 Feb 2013 23:28:11 +0100 "Michael Kerrisk (man-pages)" <mtk.manpages@xxxxxxxxx> wrote: > > 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. -- To unsubscribe from this list: send the line "unsubscribe linux-api" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html