Documentation tips

[nkh]

Hi, have a look at how a man page standard looks like, it's all nice with the animation but it's so noisy one barely finds the doc.

luckily you display a synopsis when something wrong is input, that should go to a --help function

unfortunately that synopsis disappears, after having grabbed and cleared the screen (please don't)