docs: add (nullable) annotations to many return values

These are just for functions which mention %NULL in the Returns:
section, as well as methods which were previously marked as nullable
in the Vala bindings.