update and tweaks docs and sphinx conf

docs/conf.py

@@ -52,7 +52,7 @@ master_doc = 'index'
 from steam import __version__, __author__
 
 project = u'steam'
-copyright = u'2016, %s' % __author__
+copyright = u'2019, %s' % __author__
 author = __author__
 
 # The version info for the project you're documenting, acts as replacement for
@@ -295,7 +295,7 @@ texinfo_documents = [
 intersphinx_mapping = {
     'python': ('https://docs.python.org/3.6', None),
     'gevent': ('http://www.gevent.org', None),
-    'requests': ('http://docs.python-requests.org/en/master', None),
+    'requests': ('https://2.python-requests.org/en/master/', None),
     }
 
 # AUTODOC

steam/client/__init__.py

@@ -236,14 +236,15 @@ class SteamClient(CMClient, BuiltinBase):
     def wait_msg(self, event, timeout=None, raises=None):
         """Wait for a message, similiar to :meth:`.wait_event`
 
-        :param event: :class:`.EMsg' or job id
+        :param event: event id
+        :type  event: :class:`.EMsg` or job id
         :param timeout: seconds to wait before timeout
         :type  timeout: :class:`int`
-        :param raises: On timeout when ``False` returns :class:`None`, else raise :class:`gevent.Timeout`
+        :param raises: On timeout when ``False`` returns :class:`None`, else raise :class:`gevent.Timeout`
         :type  raises: :class:`bool`
         :return: returns a message or :class:`None`
         :rtype: :class:`None`, or `proto message`
-        :raises: ``gevent.Timeout``
+        :raises: :class:`gevent.Timeout`
         """
         resp = self.wait_event(event, timeout, raises)
 
@@ -251,8 +252,7 @@ class SteamClient(CMClient, BuiltinBase):
             return resp[0]
 
     def send(self, message, body_params=None):
-        """.. versionchanged:: 0.8.4
+        """Send a message to CM
-        Send a message to CM
 
         :param message: a message instance
         :type  message: :class:`.Msg`, :class:`.MsgProto`
@@ -268,8 +268,7 @@ class SteamClient(CMClient, BuiltinBase):
             CMClient.send(self, message)
 
     def send_job(self, message, body_params=None):
-        """.. versionchanged:: 0.8.4
+        """Send a message as a job
-        Send a message as a job
 
         .. note::
             Not all messages are jobs, you'll have to find out which are which
@@ -305,8 +304,7 @@ class SteamClient(CMClient, BuiltinBase):
         return "job_%d" % jobid
 
     def send_job_and_wait(self, message, body_params=None, timeout=None, raises=False):
-        """.. versionchanged:: 0.8.4
+        """Send a message as a job and wait for the response.
-        Send a message as a job and wait for the response.
 
         .. note::
             Not all messages are jobs, you'll have to find out which are which
@@ -317,11 +315,11 @@ class SteamClient(CMClient, BuiltinBase):
         :type  body_params: dict
         :param timeout: (optional) seconds to wait
         :type  timeout: :class:`int`
-        :param raises: (optional) On timeout if ``False`` return ``None``, else raise ``gevent.Timeout``
+        :param raises: (optional) On timeout if ``False`` return ``None``, else raise :class:`gevent.Timeout`
         :type  raises: :class:`bool`
         :return: response proto message
         :rtype: :class:`.Msg`, :class:`.MsgProto`
-        :raises: ``gevent.Timeout``
+        :raises: :class:`gevent.Timeout`
         """
         job_id = self.send_job(message, body_params)
         response = self.wait_event(job_id, timeout, raises=raises)
@@ -330,8 +328,7 @@ class SteamClient(CMClient, BuiltinBase):
         return response[0].body
 
     def send_message_and_wait(self, message, response_emsg, body_params=None, timeout=None, raises=False):
-        """.. versionchanged:: 0.8.4
+        """Send a message to CM and wait for a defined answer.
-        Send a message to CM and wait for a defined answer.
 
         :param message: a message instance
         :type  message: :class:`.Msg`, :class:`.MsgProto`
@@ -341,11 +338,11 @@ class SteamClient(CMClient, BuiltinBase):
         :type  body_params: dict
         :param timeout: (optional) seconds to wait
         :type  timeout: :class:`int`
-        :param raises: (optional) On timeout if ``False`` return ``None``, else raise ``gevent.Timeout``
+        :param raises: (optional) On timeout if ``False`` return ``None``, else raise :class:`gevent.Timeout`
         :type  raises: :class:`bool`
         :return: response proto message
         :rtype: :class:`.Msg`, :class:`.MsgProto`
-        :raises: ``gevent.Timeout``
+        :raises: :class:`gevent.Timeout`
         """
         self.send(message, body_params)
         response = self.wait_event(response_emsg, timeout, raises=raises)

steam/client/builtins/leaderboards.py

@@ -23,7 +23,7 @@ class Leaderboards(object):
         :param name: leaderboard name
         :type  name: :class:`str`
         :return: leaderboard instance
-        :rtype: :class:`SteamLeaderboard`
+        :rtype: :class:`.SteamLeaderboard`
         :raises: :class:`LookupError` on message timeout or error
         """
         message = MsgProto(EMsg.ClientLBSFindOrCreateLB)
@@ -108,7 +108,7 @@ class SteamLeaderboard(object):
         :type  end: :class:`int`
         :param data_request: data being requested
         :type  data_request: :class:`steam.enums.common.ELeaderboardDataRequest`
-        :param steam_ids: list of steam ids when using :prop:`.ELeaderboardDataRequest.Users`
+        :param steam_ids: list of steam ids when using :attr:`.ELeaderboardDataRequest.Users`
         :type  steamids: :class:`list`
         :return: a list of entries, see ``CMsgClientLBSGetLBEntriesResponse``
         :rtype: :class:`list`

steam/webauth.py

@@ -10,7 +10,7 @@ The session can be used to access ``steamcommunity.com``, ``store.steampowered.c
     Keep in mind if you are trying to write robust code.
 
 .. note::
-    If you are using :class:`.SteamClient` take a look at :meth:`.get_web_session()`
+    If you are using :class:`.SteamClient` take a look at :meth:`.SteamClient.get_web_session()`
 
 .. note::
     If you need to authenticate as a mobile device for things like trading confirmations