The README is getting quite big, so it would be good to start moving some of the more detailed content elsewhere.

I think the "table of contents" can stay - but the detailed reference with information on all flags, etc. can move.