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

Change-Id: Ib71a9cd7bdf28c1d29daa0188ad2d66be38bca66
Reviewed-on: http://review.couchbase.org/26234
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>
Reviewed-by: Pavel Paulau <pavel.paulau@gmail.com>
Reviewed-by: Mordechai Nunberg <mnunberg@haskalah.org>
PYCBC-107: Support dict_keys

Change-Id: Id1968d3e536ffb00603c40792c136f6c8250994f
Reviewed-on: http://review.couchbase.org/26276
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>
Reviewed-by: Mordechai Nunberg <mnunberg@haskalah.org>
PYCBC-61: Get-And-Lock (and unlock)

Change-Id: I994f3b0c8c277bfb368bf688faae040fc8e94c79
Reviewed-on: http://review.couchbase.org/26277
Reviewed-by: Volker Mische <volker.mische@gmail.com>
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>
PYCBC-106: Expose server list

Change-Id: Icf0b466e088315d9b95fe10e8a5ed15c3dbe35af
Reviewed-on: http://review.couchbase.org/26281
Reviewed-by: Volker Mische <volker.mische@gmail.com>
Reviewed-by: Mordechai Nunberg <mnunberg@haskalah.org>
Tested-by: Mordechai Nunberg <mnunberg@haskalah.org>