minor edits to documentation

The comment for `main` is huge. It didn't look that great when rendered
into a document so I added a few break tags. Now it's legible in the
code and generated documents.