Improve documentation of `glome.h`

[burgerdev]

Instead of single sentences, the public functions should document all their parameters, especially wrt ownership, and describe the scenario where the function is appropriate.