[v3] unified TOC for docs, phase 1

[Benjamin Kosnik]

> I was planning on submitting the attached patch but since you're
> obviously working with the docs now, it might conflict or fail to
> apply soon, so I'll just post it here.  It fixes some 3.x-era
> anachronisms, and some more blatant lies (the example showing how to
> include the extension headers is wrong, since it handles 4.0 the same
> as 3.0, the minimum binutils needed to build is waaaaay out of date
> etc)

Looks good.

Thanks for holding your nose and wading through this stuff for me.

> Would you like me to try and apply bits of this, or would you rather
> take bits and merge them with your re-worked tree?

By all means please try to apply this.

Everything I have is in now. I hope to finish the api.html docs, and
then proceed on per phaze 2 in January.

-benjamin