add descriptions to parameters
update
comment
better stderr formatting