std: Improve option docs

Various improvements. There's a lot more that can be done.