Improve comments.

Add additional comments that show examples of how some methods
work.  Remove comments that were added to satisfy rdoc.  Such
comments are good for libraries but not useful for applications;
just read the code.

[ci skip]
Rename SettingsParser#parse to #parse?
Replace 'if ! something' with 'unless something'.