gtkdoc-mkdb: Add support for (nullable) and (optional) annotations

These deprecate and replace (allow-none), which was ill-defined for
(out) parameters.

This includes some updated unit tests.

Including a wording contribution from Evan Nemerson
<evan@coeus-group.com>.

https://bugzilla.gnome.org/show_bug.cgi?id=730777