errors are now printed and linked in the document
definitions with ::, .q vs .py.q, --safe, <...> is now prefix
some documentation