Comment 5 for bug 160414

- I think it belongs into section 8.
- synopsis formatting should use standard formatting for the meta variables
- Could the description be a bit more verbose about the purpose, and when you have to run the script?
- OPTIONS should not replicate the CLI argument structure
- sentences should end in a period