Move the documentation to the `help` function

[amtoine]

Right now, a great part of the documentation of each script is located in its header. This is not very useful as the user mainly has access to the --help switch.

This issue proposes to move all the documentation to the help function, activated by the --help switch.