Re: CVS commit: src/lib/libc/stdio

[Jukka Ruohonen <jruohonen%iki.fi@localhost>]

On Wed, May 05, 2010 at 01:03:49PM +1000, Luke Mewburn wrote:
> On Tue, May 04, 2010 at 07:43:12AM +0000, Jukka Ruohonen wrote:
>   | Remove the list of functions.
>   | 
>   | This list was updated only two times in nearly two decades.
>   | 
>   | (If people need to learn the standard I/O functions in C, it would be 
> better
>   | to mention K&R or some other textbook; if people need to know the list of
>   | functions, it would be better to point out the location of the standard.)
> 
> I disagree; a list of all the public APIs for a given library in
> the main man page for that library is very useful.
> 
> Please revert this change.

I will rever it. 

With a hope that you or someone else will step up and maintain the page(s).
These lists are, in my opinion, something that should not waste the scare
documentation resources we have.

- Jukka.