flagutil: fixed package docs to match golint recommendations
flagutil: make code docs golint compliant