"Documentation by paper"

[Richard Kenner]

    And still Kenner states the obvious again and again instead of
    helping.  Note that you do a similar thing.  _That_ is my point.

There's no way anybody other than the original author can "help" with the
missing documentation because the documentation, to be useful, must contain
things that *aren't* in the code, and nobody else can know those things.

Moreover, the reason I complain about things is that I don't understand them
because they aren't sufficiently documented (note that none of these to date
have involved tree-ssa code since I haven't looked at it yet).  Given that I
can't understand it, how can I possibly "help" with documenting it?

That's why it's so critical that we enforce standards before code is
committed into the main tree.