[Docs] Fix formatting of exported docstrings

deluge/core/core.py

@@ -472,7 +472,6 @@ class Core(component.Component):
 
         Returns:
             str: The torrent_id or None.
-
         """
         try:
             filedump = b64decode(filedump)

deluge/core/rpcserver.py

@@ -62,10 +62,19 @@ def export(auth_level=AUTH_LEVEL_DEFAULT):
     def wrap(func, *args, **kwargs):
         func._rpcserver_export = True
         func._rpcserver_auth_level = auth_level
-        doc = func.__doc__
-        func.__doc__ = '**RPC Exported Function** (*Auth Level: %s*)\n\n' % auth_level
-        if doc:
-            func.__doc__ += doc
+
+        rpc_text = '**RPC exported method** (*Auth level: %s*)' % auth_level
+
+        # Append the RPC text while ensuring correct docstring formatting.
+        if func.__doc__:
+            if func.__doc__.endswith('    '):
+                indent = func.__doc__.split('\n')[-1]
+                func.__doc__ += '\n{}'.format(indent)
+            else:
+                func.__doc__ += '\n\n'
+            func.__doc__ += rpc_text
+        else:
+            func.__doc__ = rpc_text
 
         return func
 

deluge/ui/console/modes/basemode.py

@@ -109,7 +109,7 @@ class BaseMode(CursesStdIO, component.Component):
         do_read(self) - Handle user input
         refresh(self) - draw the mode to the screen
         add_string(self, row, string) - add a string of text to be displayed.
-                                        see method for detailed info
+        see method for detailed info
 
         The init method of a subclass *must* call BaseMode.__init__
 

docs/source/conf.py

@@ -125,6 +125,9 @@ extensions = [
     'sphinx.ext.coverage',
 ]
 
+napoleon_include_init_with_doc = True
+napoleon_use_rtype = False
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']