.gir file format needs extensive documentation
Submitted by Adam Dingle
Link to original bug (#701442)
Description
The gobject-introspection documentation has a razor-thin overview of the .gir file format, but it appears that most elements and attributes are completely undocumented. We should greatly expand this documentation to explain all elements and attributes which can appear in a .gir file.