atk-adaptor: document atk_bridge_adaptor_init return messages

Right now the only way to know what means what the method returns is checking for the code.

FWIW, return 0 when everything is ok is somewhat counter-intuitive, but at this point, probably it would be better to not change it.