Documentation (user and code) tweaks

Just some clarifications, improved pod, etc about the
optgroups feature and behavior.