Documentation update needed

[brampf]

Since with all the syntactic sugar and especially with the changes made with the new parser, the documentation needs an update. Especially on

• Reading whole files
• Reading / writing header keywords