some fix to comments and usage
some documentation added