Rename gobjectenumtypes.[ch] to glib-enumtypes.[ch]

As suggested on !481 (comment 451086).

Helps GNOME/gobject-introspection/issues/267.

Also includes some bonus man page improvements.