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>