doc: move AtkRegistry section to the source file

So now is properly scanned by gtk-doc
doc: split API reference on categories
doc: add some forgotten symbols

atk-unused.txt now contains 6 symbols (from 14). Those 6 are not
relevant for documentation.