put symbols in the sections.txt into the right sections (so that we dont get wrong...

put symbols in the sections.txt into the right sections (so that we dont get wrong undocumented symbols) added TITLE ...

Original commit message from CVS:
put symbols in the sections.txt into the right sections (so that we dont get wrong undocumented symbols)
added TITLE tags where they were missing
fixed section names so that gtk-doc introspection works
fixed typos in api docs and docbook docs
added some thoughts about new interfaces (to personal notes)