Klaus Klein <kle...@kleink.org> wrote: > > Log Message: > > Add a small summary parge for struct tm from <time.h>. Cf. timeval(3). > > This exhibits something particularly well that's been bugging me for > quite a while about such documentation changes: I think documenting > the implementation's structure layouts in section 3 is wrong, at least > when supposedly portable interfaces are concerned. Those interested > in structure member poking will look at the header file anyway, and, > by being that specific, such documentation creates the obligation to > keep the redundant definition in sync.
I agree with Klaus on this point. -- Mindaugas