doc: various improvements

- more logical order for g_markup functions
- fix short description of GMarkup
- GMarkupParser: specify that some parameters are NULL-terminated.
- g_string_new (NULL); is possible.
- g_string_free (NULL, ...); is not possible.
- other trivial fixes.