Fix doc warnings/errors

Change-Id: Idd6feeb66d58bc562853d3a82831645ef2d5ccf6

doc/source/conf.py

@@ -76,7 +76,7 @@ version = release.split('-')[0]
 #
 # This is also used if you do content translation via gettext catalogs.
 # Usually you set "language" from the command line for these cases.
-language = None
+language = "en"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
@@ -211,7 +211,7 @@ epub_exclude_files = ['search.html']
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {'https://docs.python.org/': None}
+intersphinx_mapping = {'https://docs.python.org/3/': None}
 
 from frappy.lib.classdoc import class_doc_handler
 

frappy/rwhandler.py

@@ -195,10 +195,12 @@ class CommonWriteHandler(WriteHandler):
     """decorator for common write handler
 
     calls the wrapped write method function with values as an argument.
+
     - values[pname] returns the to be written value
     - values['key'] returns a value taken from writeDict
       or, if not available return obj.key
     - values.as_tuple() returns a tuple with the items in the same order as keys
+
     """
 
     def wrap(self, key):