Cleanup docstrings

Cleanup docstrings to conform PEP-8 and PEP-257. The linkage
was also improved.

Change-Id: I1d02a3487930f845c36883a272a777d7e65b6ee2
Reviewed-on: http://review.couchbase.org/25972
Reviewed-by: Matt Ingenthron <matt@couchbase.com>
Tested-by: Matt Ingenthron <matt@couchbase.com>
Reviewed-by: Volker Mische <volker.mische@gmail.com>
Tested-by: Volker Mische <volker.mische@gmail.com>
PYCBC-94: Add option for connection cache

Change-Id: Iee2451a24e9d327ee6f3214201de17cbaaab9dae
Reviewed-on: http://review.couchbase.org/25991
Reviewed-by: Matt Ingenthron <matt@couchbase.com>
Reviewed-by: Volker Mische <volker.mische@gmail.com>
Tested-by: Volker Mische <volker.mische@gmail.com>
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>
PYCBC-95: Don't require username/passwords

Change-Id: I3c4becf61c3419eb96763fb9419ceb794a5e6b9f
Reviewed-on: http://review.couchbase.org/25993
Reviewed-by: Mordechai Nunberg <mnunberg@haskalah.org>
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>
PYCBC-96: Expose lcb errors

Change-Id: I545791f36ef0478063ae3df7594d2b89e4990a20
Reviewed-on: http://review.couchbase.org/25995
Reviewed-by: Volker Mische <volker.mische@gmail.com>
Reviewed-by: Mordechai Nunberg <mnunberg@haskalah.org>
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>
PYCBC-97: Support host list

Change-Id: I205078590029687f10ce05531072c288ac61c944
Reviewed-on: http://review.couchbase.org/25996
Reviewed-by: Matt Ingenthron <matt@couchbase.com>
Reviewed-by: Volker Mische <volker.mische@gmail.com>
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>
Release GIL during lcb_wait

Fixes potential issues if a thread is blocked on a long-running IO
operation

Change-Id: I8b6991c4d88b6ec04864e43ad3721d21d21be10d
Reviewed-on: http://review.couchbase.org/26094
Reviewed-by: Mordechai Nunberg <mnunberg@haskalah.org>
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>
PYCBC-103: Pure C API Rewrite (WIP)

Just look over the APIs and generate docs for the time being, I'm still
making changes. I might split this up a bit

Change-Id: Ib71a9cd7bdf28c1d29daa0188ad2d66be38bca66