[tor-commits] [stem/master] Fix documentation formatting

atagar at torproject.org atagar at torproject.org
Sun Aug 26 20:36:53 UTC 2012


commit 51a00e9a3a2f2fa10277759616582d4acd2942a3
Author: Ravi Chandra Padmala <neenaoffline at gmail.com>
Date:   Thu Aug 23 00:05:10 2012 +0530

    Fix documentation formatting
---
 stem/control.py |   34 +++++++++++++++++-----------------
 1 files changed, 17 insertions(+), 17 deletions(-)

diff --git a/stem/control.py b/stem/control.py
index 8d59682..84a9df1 100644
--- a/stem/control.py
+++ b/stem/control.py
@@ -553,8 +553,8 @@ class Controller(BaseController):
       * default if one was provided and our call failed
     
     :raises:
-      :class:`stem.socket.ControllerError` if the call fails and we weren't provided a default response
-      :class:`stem.socket.InvalidArguments` if the 'param' requested was invalid
+      * :class:`stem.socket.ControllerError` if the call fails and we weren't provided a default response
+      * :class:`stem.socket.InvalidArguments` if the 'param' requested was invalid
     """
     
     start_time = time.time()
@@ -691,8 +691,8 @@ class Controller(BaseController):
       * default if one was provided and our call failed
     
     :raises:
-      :class:`stem.socket.ControllerError` if the call fails and we weren't provided a default response
-      :class:`stem.socket.InvalidArguments` if the configuration option requested was invalid
+      * :class:`stem.socket.ControllerError` if the call fails and we weren't provided a default response
+      * :class:`stem.socket.InvalidArguments` if the configuration option requested was invalid
     """
     
     # Config options are case insensitive and don't contain whitespace. Using
@@ -743,8 +743,8 @@ class Controller(BaseController):
       * default if one was provided and our call failed
     
     :raises:
-      :class:`stem.socket.ControllerError` if the call fails and we weren't provided a default response
-      :class:`stem.socket.InvalidArguments` if the configuration option requested was invalid
+      * :class:`stem.socket.ControllerError` if the call fails and we weren't provided a default response
+      * :class:`stem.socket.InvalidArguments` if the configuration option requested was invalid
     """
     
     start_time = time.time()
@@ -829,9 +829,9 @@ class Controller(BaseController):
     :param str,list value: value to set the parameter to
     
     :raises:
-      :class:`stem.socket.ControllerError` if the call fails
-      :class:`stem.socket.InvalidArguments` if configuration options requested was invalid
-      :class:`stem.socket.InvalidRequest` if the configuration setting is impossible or if there's a syntax error in the configuration values
+      * :class:`stem.socket.ControllerError` if the call fails
+      * :class:`stem.socket.InvalidArguments` if configuration options requested was invalid
+      * :class:`stem.socket.InvalidRequest` if the configuration setting is impossible or if there's a syntax error in the configuration values
     """
     
     self.set_options({param: value}, False)
@@ -843,9 +843,9 @@ class Controller(BaseController):
     :param str params: configuration option to be reset
     
     :raises:
-      :class:`stem.socket.ControllerError` if the call fails
-      :class:`stem.socket.InvalidArguments` if configuration options requested was invalid
-      :class:`stem.socket.InvalidRequest` if the configuration setting is impossible or if there's a syntax error in the configuration values
+      * :class:`stem.socket.ControllerError` if the call fails
+      * :class:`stem.socket.InvalidArguments` if configuration options requested was invalid
+      * :class:`stem.socket.InvalidRequest` if the configuration setting is impossible or if there's a syntax error in the configuration values
     """
     
     self.set_options(dict([(entry, None) for entry in params]), True)
@@ -875,9 +875,9 @@ class Controller(BaseController):
     :param bool reset: issues a RESETCONF, returning None values to their defaults if True
     
     :raises:
-      :class:`stem.socket.ControllerError` if the call fails
-      :class:`stem.socket.InvalidArguments` if configuration options requested was invalid
-      :class:`stem.socket.InvalidRequest` if the configuration setting is impossible or if there's a syntax error in the configuration values
+      * :class:`stem.socket.ControllerError` if the call fails
+      * :class:`stem.socket.InvalidArguments` if configuration options requested was invalid
+      * :class:`stem.socket.InvalidRequest` if the configuration setting is impossible or if there's a syntax error in the configuration values
     """
     
     start_time = time.time()
@@ -952,8 +952,8 @@ class Controller(BaseController):
     Saves the current configuration options into the active torrc file.
     
     :raises:
-      :class:`stem.socket.ControllerError` if the call fails
-      :class:`stem.socket.OperationFailed` if the client is unable to save the configuration file
+      * :class:`stem.socket.ControllerError` if the call fails
+      * :class:`stem.socket.OperationFailed` if the client is unable to save the configuration file
     """
     
     response = self.msg("SAVECONF")





More information about the tor-commits mailing list