doc: vastly improve optparse LDocs.

* lib/std/optparse.lua: Vastly improve optparse LDocs.
* NEWS: Update.

Signed-off-by: Gary V. Vaughan <gary@gnu.org>