gtkdoc-scan: track doc-comemnts in headers and use for section-docs

We track which symbols are docuemnted in the headers and use that to place gobject related
entries in the appropriate subsection.