add "Script usage" section and bugfixes