Restore gluster::client; improve docs

Also added an examples directory, with some practical examples of how to
use this module.