Re: CVS commit: src

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

On Tue, Apr 12, 2011 at 09:56:27PM +0200, Klaus Klein wrote:
> Just to make it clear again, it's really just the structure
> definitions being documented verbatim I'm taking issue with.

I agree with this and Iain's earlier comment about using a wording such as
"[...] has at least the following members" (this is usually the wording used
in the standards as well).

> Those are appropriate for an ABI document, but as far as programmers'
> documentation is concerned it seems to me like too much effort spent
> to enable its readers to shoot themselves in their feet. :-)

But we are here talking about structures, objects, or types usually defined
already by the C language (or ISO) itself. These are expected to change
once or twice in decade (if even that), unlike some NetBSD specific header
or structure that may change at will (even though that too is a bad practice).

And to use mktime(3), you must know the "tm" structure.

- Jukka.