fix up gtk-doc

fix various problems:

- out of date IGNORE in doc/reference/Makefile.am
- name clashes between private .h and public