added module descriptions

Signed-off-by: Leonardo de Moura <leonardo@microsoft.com>

src/ast/pattern/pattern_inference_params.cpp

@@ -0,0 +1,32 @@
+/*++
+Copyright (c) 2012 Microsoft Corporation
+
+Module Name:
+
+    pattern_inference_params.h
+
+Abstract:
+
+    <abstract>
+
+Author:
+
+    Leonardo de Moura (leonardo) 2012-12-02.
+
+Revision History:
+
+--*/
+#include"pattern_inference_params.h"
+#include"pattern_inference_params_helper.hpp"
+
+void pattern_inference_params::updt_params(params_ref const & _p) {
+    pattern_inference_params_helper p(_p);
+    m_pi_max_multi_patterns      = p.max_multi_patterns();
+    m_pi_block_loop_patterns     = p.block_loop_patterns();
+    m_pi_arith                   = static_cast<arith_pattern_inference_kind>(p.arith());
+    m_pi_use_database            = p.use_database();
+    m_pi_arith_weight            = p.arith_weight();
+    m_pi_non_nested_arith_weight = p.non_nested_arith_weight();
+    m_pi_pull_quantifiers        = p.pull_quantifiers();
+    m_pi_warnings                = p.warnings();
+}

src/ast/pattern/pattern_inference_params.h

@@ -19,7 +19,7 @@ Revision History:
 #ifndef _PATTERN_INFERENCE_PARAMS_H_
 #define _PATTERN_INFERENCE_PARAMS_H_
 
-#include"pattern_inference_params_helper.hpp"
+#include"params.h"
 
 enum arith_pattern_inference_kind {
     AP_NO,           // do not infer patterns with arithmetic terms
@@ -45,17 +45,7 @@ struct pattern_inference_params {
         updt_params(p);
     }
 
-    void updt_params(params_ref const & _p) {
-        pattern_inference_params_helper p(_p);
-        m_pi_max_multi_patterns      = p.max_multi_patterns();
-        m_pi_block_loop_patterns     = p.block_loop_patterns();
-        m_pi_arith                   = static_cast<arith_pattern_inference_kind>(p.arith());
-        m_pi_use_database            = p.use_database();
-        m_pi_arith_weight            = p.arith_weight();
-        m_pi_non_nested_arith_weight = p.non_nested_arith_weight();
-        m_pi_pull_quantifiers        = p.pull_quantifiers();
-        m_pi_warnings                = p.warnings();
-    }
+    void updt_params(params_ref const & _p);
 };
 
 #endif /* _PATTERN_INFERENCE_PARAMS_H_ */

src/ast/pattern/pattern_inference_params_helper.pyg

@@ -1,5 +1,6 @@
 def_module_params(class_name='pattern_inference_params_helper',
                   module_name='pi',
+                  description='pattern inference (heuristics) for universal formulas (without annotation)',
                   export=True,
                   params=(('max_multi_patterns', UINT, 0, 'when patterns are not provided, the prover uses a heuristic to infer them, this option sets the threshold on the number of extra multi-patterns that can be created; by default, the prover creates at most one multi-pattern when there is no unary pattern'),
                           ('block_loop_patterns', BOOL, True, 'block looping patterns during pattern inference'),