restructure legacy directive section

This is now a table and more compact. Hopefully also makes it
clear that these should no longer be used.
Merge branch 'v7-stable' into v8-stable
Merge branch 'v8-stable'