Skip to content
Snippets Groups Projects
Commit 514a9ebc authored by André Anjos's avatar André Anjos :speech_balloon:
Browse files

[doc] Re-enable nitpicky mode; Fix broken docs

parent cd9e8d49
No related branches found
No related tags found
1 merge request!38Nitpicky documentation
...@@ -119,7 +119,7 @@ class DataFormat(object): ...@@ -119,7 +119,7 @@ class DataFormat(object):
storage (object): A simple object that provides information about file storage (object): A simple object that provides information about file
paths for this dataformat paths for this dataformat
errors (list of str): A list containing errors found while loading this errors (list): A list strings containing errors found while loading this
dataformat. dataformat.
data (dict): The original data for this dataformat, as loaded by our JSON data (dict): The original data for this dataformat, as loaded by our JSON
......
...@@ -71,7 +71,7 @@ class LoopChannel(object): ...@@ -71,7 +71,7 @@ class LoopChannel(object):
""" Setup the channel internals """ Setup the channel internals
Parameters: Parameters:
algorithm (:py:class:`algorithm.Algorithm`) : algorithm for which algorithm (:py:class:`.algorithm.Algorithm`) : algorithm for which
the communication channel is setup. the communication channel is setup.
prefix (str) : Folder were the prefix is located. prefix (str) : Folder were the prefix is located.
......
...@@ -348,7 +348,7 @@ class LoopMessageHandler(MessageHandler): ...@@ -348,7 +348,7 @@ class LoopMessageHandler(MessageHandler):
""" Setup the loop internals """ Setup the loop internals
Parameters: Parameters:
algorithm (:py:class:`algorithm.Algorithm`) : algorithm for which algorithm (:py:class:`.algorithm.Algorithm`) : algorithm for which
the communication channel is setup. the communication channel is setup.
prefix (str) : Folder were the prefix is located. prefix (str) : Folder were the prefix is located.
...@@ -364,7 +364,7 @@ class LoopMessageHandler(MessageHandler): ...@@ -364,7 +364,7 @@ class LoopMessageHandler(MessageHandler):
""" Set the executor for validation """ Set the executor for validation
Parameters: Parameters:
executor (:py:class:`.Executor`) : Loop executor executor (:py:class:`.loop.LoopExecutor`) : Loop executor
""" """
self.executor = executor self.executor = executor
...@@ -376,7 +376,8 @@ class LoopMessageHandler(MessageHandler): ...@@ -376,7 +376,8 @@ class LoopMessageHandler(MessageHandler):
Syntax: val Syntax: val
Parameters: Parameters:
result (:py:class:`dataformat.DataFormat`) : Result to be validated. result (:py:class:`beat.backend.python.dataformat.DataFormat`) :
Result to be validated.
""" """
result = result.encode("utf-8") result = result.encode("utf-8")
......
...@@ -30,7 +30,7 @@ extensions = [ ...@@ -30,7 +30,7 @@ extensions = [
] ]
# Be picky about warnings # Be picky about warnings
nitpicky = False nitpicky = True
# Ignores stuff we can't easily resolve on other project's sphinx manuals # Ignores stuff we can't easily resolve on other project's sphinx manuals
nitpick_ignore = [] nitpick_ignore = []
...@@ -257,7 +257,8 @@ def member_function_test(app, what, name, obj, skip, options): ...@@ -257,7 +257,8 @@ def member_function_test(app, what, name, obj, skip, options):
if len(name) > 1 and name[0] == '_': if len(name) > 1 and name[0] == '_':
# test if this private function should be allowed # test if this private function should be allowed
if name not in accepted_private_functions: if name not in accepted_private_functions:
# omit privat functions that are not in the list of accepted private functions # omit private functions that are not in the list of accepted private
# functions
return skip return skip
else: else:
# test if the method is documented # test if the method is documented
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment