"Documentation by paper"

[Richard Kenner]

    While I have no wish to discourage anyone from improving the
    documentation (and I'm curious how many people on this thread
    are actually doing so), I think you exaggerate the dangers.
    "block" means different things to FE people and BE people,
    and there are places where it isn't obvious which is meant until
    you grovel through the code a bit, and we've all been coping with
    it for years.

And that's a *good thing* that we should seek to emulate in the future?

As I said, the lack of good definition of "block" and "edge" as used in
the CFG code makes that code very inaccessable and very hard to maintain
since it's not clear what the intent of a lot of the code is.

This most certainly needs to be cleaned up!