[lib] MCLSolutions: Fix doc; add module doc

library/cadbiom/models/clause_constraints/mcl/MCLSolutions.py

@@ -39,8 +39,19 @@
 ##
 ## Contributor(s): Geoffroy Andrieux - IRISA/IRSET
 ##
-"""
-Various solution representations
+"""Classes used to store solver answers.
+
+RawSolution:
+    Contain a solution got from SAT solver with all variable parameters
+    from the unfolder.
+
+DimacsFrontierSol:
+    A numerical representation of *frontier values and timings* from a raw solution.
+
+FrontierSolution:
+    Provides is a wrapper for a symbolic
+    representation (human readable) of activated frontiers defined in
+    RawSolution and DimacsFrontierSol objects.
 """
 # Standard imports
 from __future__ import print_function
@@ -406,11 +417,11 @@ class RawSolution(object):
 
 
 class FrontierSolution(object):
-    """Class for symbolic frontier and timings representation (built from a raw solution)
+    """Class for symbolic (human readable) frontiers and timings representation
 
-    The class FrontierSolution provides objects wrapping a symbolic
-    representation (human readable) of activated frontiers for RawSolution and
-    DimacsFrontierSol objects.
+    The class FrontierSolution provides is a wrapper for a symbolic
+    representation (human readable) of activated frontiers defined in
+    RawSolution and DimacsFrontierSol objects.
 
     Attributes:
         - The main attributes are activated_frontier which is a set of
@@ -612,7 +623,7 @@ class FrontierSolution(object):
 class DimacsFrontierSol(object):
     """Class for solution frontier and timings representation
 
-    DimacsFrontierSol is a numeric representation of *frontier values and timings*
+    DimacsFrontierSol is a numerical representation of *frontier values and timings*
     from a raw solution.
 
     Attributes: