Improvements to documentation and annotations

Most important changes are

• Marked sync constructors as constructor for gir
• Docs need a first line that acts like a header
• Document non documented objects
• indentation bigger than 4 spaces in docs are read as quotes, this is fixed