From 09309bd2277894f6bc15fbee0208cd1b3dd5f8f6 Mon Sep 17 00:00:00 2001
From: Amir MOHAMMADI <amir.mohammadi@idiap.ch>
Date: Fri, 12 Jan 2018 14:31:53 +0100
Subject: [PATCH] Fix sphinx warnings

---
 bob/pad/base/database/PadBioFileDB.py | 47 +++++++++++++++++----------
 1 file changed, 29 insertions(+), 18 deletions(-)

diff --git a/bob/pad/base/database/PadBioFileDB.py b/bob/pad/base/database/PadBioFileDB.py
index d065b3d..ead9b10 100644
--- a/bob/pad/base/database/PadBioFileDB.py
+++ b/bob/pad/base/database/PadBioFileDB.py
@@ -1,5 +1,5 @@
 """
-Implementation of high-level interfaces for FileList-based databases that can be 
+Implementation of high-level interfaces for FileList-based databases that can be
 used by both verification and PAD experiments.
 """
 
@@ -111,23 +111,34 @@ class HighBioDatabase(BioDatabase):
 
     def objects(self, protocol=None, purposes=None, model_ids=None, groups=None, **kwargs):
         """
-        Maps objects method of PAD databases into objects method of Verification database
-
-        :param protocol: To distinguish two vulnerability scenarios, protocol name should have either
-        '-licit' or '-spoof' appended to it. For instance, if DB has protocol 'general', the named passed to this method
-        should be 'general-licit', if we want to run verification experiments on bona fide data only, but it should be
-         'general-spoof', if we want to run it for spoof scenario (the probes are attacks).
-
-        :param purposes: This parameter is passed by the ``bob.bio.base`` verification experiment
-
-        :param model_ids: This parameter is passed by the ``bob.bio.base`` verification experiment
-
-        :param groups: We map the groups from ('world', 'dev', 'eval') used in verification experiments to
-        ('train', 'dev', 'eval')
-
-        :param kwargs: The rest of the parameters valid for a given database
-
-        :return: Set of BioFiles that verification experiments expect.
+        Maps objects method of PAD databases into objects method of
+        Verification database
+
+        Parameters
+        ----------
+        protocol : str
+            To distinguish two vulnerability scenarios, protocol name should
+            have either '-licit' or '-spoof' appended to it. For instance, if
+            DB has protocol 'general', the named passed to this method should
+            be 'general-licit', if we want to run verification experiments on
+            bona fide data only, but it should be 'general-spoof', if we want
+            to run it for spoof scenario (the probes are attacks).
+        purposes : [str]
+            This parameter is passed by the ``bob.bio.base`` verification
+            experiment
+        model_ids : [object]
+            This parameter is passed by the ``bob.bio.base`` verification
+            experiment
+        groups : [str]
+            We map the groups from ('world', 'dev', 'eval') used in
+            verification experiments to ('train', 'dev', 'eval')
+        **kwargs
+            The rest of the parameters valid for a given database
+
+        Returns
+        -------
+        [object]
+            Set of BioFiles that verification experiments expect.
 
         """
         # convert group names from the conventional names in verification experiments to the internal database names
-- 
GitLab