client.shared: Update documentation

Translate old tags (@param, @params, @type and @attr) to use the format required by Sphinx,
which requires colon (:param, :params, etc.).

Signed-off-by: Ruda Moura <rmoura@redhat.com>