tech-kern archive

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index][Old Index]

Re: proplib documentantion enhancements

2008/1/5, David Holland <>:
> On Sat, Jan 05, 2008 at 09:46:04AM +0000, Iain Hibbert wrote:
>  > I have no objections though I think code snippets might bulk out the
>  > manpages a bit much - if there were some regression testing code perhaps
>  > that could be alluded to instead?
> I don't think it's a good idea to train users to look at regression
> tests for code samples; test code tends to be evil, and when it's not
> evil often it's doing things that are subtly wrong or nonsensical,
> because such code (being unexpected) often triggers bugs.
> /usr/share/examples seems like a better place.
> --
> David A. Holland

1) I'll start with some conservative patches aiming at functions' return values.
2) Then, I'll come up with a few code snippets written in a didactic
manner for inclusion in /usr/share/examples. If there are objections,
I can always put them in our wiki.

I'll need some time, because I am doing my mandatory military service
in parallel.

Thank you all for the replies.

Stathis Kamperis

Home | Main Index | Thread Index | Old Index