add Pod::Weaver plugin
fix synopsis to match current code style
add some basic docs
remove extra POD that Pod::Weaver will generate