libostree: Remove private header file from ostree.h

Was breaking pkgsys-ostree.
libostree: Document and annotate some methods to quash g-ir-scanner warnings

Since warnings are bad.  Introspection is good.