New docs for OPTIONS

[Glen Barber]

Hi Chris,

On Sat, May 26, 2012 at 09:13:10PM +0100, Chris Rees wrote:
> Would anyone mind giving it a check and approving it please?  Bapt
> plans to commit the code later this week, and it'd be great to have
> approval by then!
> 

I think this looks good.

If there are no objections from anyone on docs@ to your patch, please
commit it with my approval after bapt commits his changes.

Glen