Fix doc comment errors and warnings

Fix some comments that were mismatched with actual params to silence
g-ir-scanner warnings.
Implement GIO initable interface

The connection should now be created with i3ipc_connection_new. This
function throws an error if the initialization failed.