Multiple changes:

Improved code comments and user documentation
Handle list arguments
Added TO DO item
Incremented version (for in-line docs, finally)
Adjusted vertical alignment
Improved SYNOPSIS