update swig api docs for clarity, completion, examples