On Mon, 25 Feb 2013 23:28:11 +0100 "Michael Kerrisk (man-pages)" <mtk.manpa...@gmail.com> 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-kernel" in the body of a message to majord...@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/
