a lot of small corrections to bring down the number of undocumented functions, reported by the script; added em.cpp sample

doc/check_docs.py

@@ -17,13 +17,13 @@ opencv_hdr_list = [
 
 opencv_module_list = [
 "core",
-#"imgproc",
-#"calib3d",
-#"features2d",
-#"video",
-#"objdetect",
-#"highgui",
-#"ml"
+"imgproc",
+"calib3d",
+"features2d",
+"video",
+"objdetect",
+"highgui",
+"ml"
 ]
 
 class RSTParser(object):
@@ -49,6 +49,7 @@ class RSTParser(object):
                 continue
             rst_decl = None
             if "(" in l:
+                l = l.replace("cv::", "")
                 rst_decl = self.parser.parse_func_decl_no_wrap(l)
                 fname = rst_decl[0]
             else:
@@ -94,6 +95,9 @@ class RSTParser(object):
             fname = rst_decl[0]
             hdr_decls = self.fmap.get(fname, [])
             if not hdr_decls:
+                fname = fname.replace("cv.", "")
+                hdr_decls = self.fmap.get(fname, [])
+            if not hdr_decls:    
                 print "Documented function %s (%s) in %s:%d is not in the headers" % (fdecl, rst_decl[0].replace(".", "::"), docname, lineno)
                 continue
             decl_idx = 0
@@ -103,7 +107,7 @@ class RSTParser(object):
                     continue
                 idx = 0
                 for a in hd[3]:
-                    if a[0] != rst_decl[3][idx][0]:
+                    if a[0] != rst_decl[3][idx][0] and a[0].replace("cv::", "") != rst_decl[3][idx][0]:
                         break
                     idx += 1
                 if idx == len(hd[3]):
@@ -162,6 +166,9 @@ class RSTParser(object):
                 
             for d in decls:
                 dstr = self.decl2str(d)
+                # special hack for ML: skip old variants of the methods
+                if name == "ml" and ("CvMat" in dstr):
+                    continue
                 if dstr not in wlist_decls:
                     misscount += 1
                     print "%s %s(%s)" % (d[1], d[0].replace(".", "::"), ", ".join([a[0] + " " + a[1] for a in d[3]]))

doc/check_docs_whitelist.txt

@@ -14,6 +14,7 @@
 #    full declaration into the file
 #
 
+######################################### core #####################################
 cv::Mat::MSize
 cv::Mat::MStep
 cv::MatConstIterator
@@ -22,5 +23,59 @@ cv::Algorithm
 cv::_InputArray
 cv::_OutputArray
 
-CvLevMarq
+######################################## imgproc ###################################
+CvLSHOperations
+cv::FilterEngine
+cv::BaseFilter
+cv::BaseRowFilter
+cv::BaseColumnFilter
+cv::Moments
 
+######################################## calib3d ###################################
+CvLevMarq
+Mat cv::findFundamentalMat( InputArray points1, InputArray points2, OutputArray mask, int method=FM_RANSAC, double param1=3., double param2=0.99)
+Mat findHomography( InputArray srcPoints, InputArray dstPoints, OutputArray mask, int method=0, double ransacReprojThreshold=3);
+
+########################################## ml ######################################
+
+CvBoostTree
+CvForestTree
+CvSVMKernel
+CvSVMSolver
+CvDTreeTrainData
+CvERTreeTrainData
+CvKNearest::CvKNearest
+CvKNearest::clear
+CvDTree::CvDTree
+CvDTree::clear
+CvDTree::read
+CvDTree::write
+CvEM::CvEM
+CvEM::clear
+CvEM::read
+CvEM::write
+CvSVM::CvSVM
+CvSVM::clear
+CvSVM::read
+CvSVM::write
+CvRTrees::CvRTrees
+CvRTrees::clear
+CvRTrees::read
+CvRTrees::write
+CvBoost::CvBoost
+CvBoost::clear
+CvBoost::read
+CvBoost::write
+CvGBTrees::CvGBTrees
+CvGBTrees::clear
+CvGBTrees::read
+CvGBTrees::write
+CvNormalBayesClassifier::CvNormalBayerClassifier
+CvNormalBayesClassifier::clear
+CvNormalBayesClassifier::read
+CvNormalBayesClassifier::write
+CvANN_MLP::CvANN_MLP
+CvANN_MLP::clear
+CvANN_MLP::read
+CvANN_MLP::write
+CvTrainTestSplit

doc/conf.py

@@ -258,7 +258,7 @@ latex_use_parts = False
 #latex_appendices = []
 
 # If false, no module index is generated.
-#latex_domain_indices = True
+latex_domain_indices = True
 
 
 # -- Options for manual page output --------------------------------------------