Issue 1:
(This is a suggestion, so I took the freedom to erase all the bug related template code.)

The code below was tested with binding version 2.4.12.2 and the source code example was from git HEAD.

Currently the doc string only contains a terse syntax description. E.g.

import cv2
print cv2.setUseOptimized.__doc__
setUseOptimized(onoff) -> None

But if you look at the h-file declaration for the corresponding function you have:

/** @brief Enables or disables the optimized code.

The function can be used to dynamically turn on and off optimized code (code that uses SSE2, AVX,
and other instructions on the platforms that support it). It sets a global flag that is further
checked by OpenCV functions. Since the flag is not checked in the inner OpenCV loops, it is only
safe to call the function on the very top level in your application where you can be sure that no
other OpenCV function is currently executed.

By default, the optimized code is enabled unless you disable it in CMake. The current status can be
retrieved using useOptimized.
@param onoff The boolean flag specifying whether the optimized code should be used (onoff=true)
or not (onoff=false).
*/
CV_EXPORTS_W void setUseOptimized(bool onoff);

I suggest to add to the python wrapper generator parsing of the entire doxygen string and conversion of its text to standard python strings. This will simplify interactive work as it will not be necessary to turn away from ipython (or any other doc sensitive IDE) in order to look up a description of what a function or method does.

Issue 2:
Transferred from http://code.opencv.org/issues/1215

|| Andrey Kamaev on 2011-07-11 14:43
|| Priority: Normal
|| Affected: branch 'master' (3.0-dev)
|| Category: documentation
|| Tracker: Bug
|| Difficulty: Medium
|| PR:
|| Platform: Any / Any

Undocumented functions/methods in API exported to java/python

Here is list of undocumented methods reported by gen_javadoc.py script:
<pre>
gen_javadoc error: could not find documentation for RotatedRect_ (module: core)
gen_javadoc error: could not find documentation for DMatch::distance (module: features2d)
gen_javadoc error: could not find documentation for DMatch::DMatch() (module: features2d)
gen_javadoc error: could not find documentation for DMatch::DMatch(_queryIdx,_trainIdx,_distance) (module: features2d)
gen_javadoc error: could not find documentation for DMatch::DMatch(_queryIdx,_trainIdx,_imgIdx,_distance) (module: features2d)
gen_javadoc error: could not find documentation for findCirclesGridDefault(image,patternSize,centers,flags) (module: calib3d)
gen_javadoc error: could not find documentation for findCirclesGridDefault(image,patternSize,centers) (module: calib3d)
gen_javadoc error: could not find documentation for getValidDisparityROI(roi1,roi2,minDisparity,numberOfDisparities,SADWindowSize) (module: calib3d)
gen_javadoc error: could not find documentation for rectify3Collinear(cameraMatrix1,distCoeffs1,cameraMatrix2,distCoeffs2,cameraMatrix3,distCoeffs3,imgpt1,imgpt3,imageSize,R12,T12,R13,T13,R1,R2,R3,P1,P2,P3,Q,alpha,newImgSize,roi1,roi2,flags) (module: calib3d)
gen_javadoc error: could not find documentation for validateDisparity(disparity,cost,minDisparity,numberOfDisparities,disp12MaxDisp) (module: calib3d)
gen_javadoc error: could not find documentation for validateDisparity(disparity,cost,minDisparity,numberOfDisparities) (module: calib3d)
gen_javadoc error: could not find documentation for StereoSGBM::operator()(left,right,disp) (module: calib3d)
gen_javadoc error: could not find documentation for PCABackProject(data,mean,eigenvectors,result) (module: core)
gen_javadoc error: could not find documentation for PCACompute(data,mean,eigenvectors,maxComponents) (module: core)
gen_javadoc error: could not find documentation for PCACompute(data,mean,eigenvectors) (module: core)
gen_javadoc error: could not find documentation for PCAProject(data,mean,eigenvectors,result) (module: core)
gen_javadoc error: could not find documentation for SVBackSubst(w,u,vt,rhs,dst) (module: core)
gen_javadoc error: could not find documentation for SVDecomp(src,w,u,vt,flags) (module: core)
gen_javadoc error: could not find documentation for SVDecomp(src,w,u,vt) (module: core)
gen_javadoc error: could not find documentation for batchDistance(src1,src2,dist,dtype,nidx,normType,K,mask,update,crosscheck) (module: core)
gen_javadoc error: could not find documentation for batchDistance(src1,src2,dist,dtype,nidx,normType,K) (module: core)
gen_javadoc error: could not find documentation for batchDistance(src1,src2,dist,dtype,nidx) (module: core)
gen_javadoc error: could not find documentation for extractChannel(src,dst,coi) (module: core)
gen_javadoc error: could not find documentation for getBuildInformation() (module: core)
gen_javadoc error: could not find documentation for getNumberOfCPUs() (module: core)
gen_javadoc error: could not find documentation for hconcat(src,dst) (module: core)
gen_javadoc error: could not find documentation for insertChannel(src,dst,coi) (module: core)
gen_javadoc error: could not find documentation for randShuffle_(dst,iterFactor) (module: core)
gen_javadoc error: could not find documentation for randShuffle_(dst) (module: core)
gen_javadoc error: could not find documentation for vconcat(src,dst) (module: core)
gen_javadoc error: could not find documentation for moveWindow(winname,x,y) (module: highgui)
gen_javadoc error: could not find documentation for resizeWindow(winname,width,height) (module: highgui)
gen_javadoc error: could not find documentation for getGaborKernel(ksize,sigma,theta,lambd,gamma,psi,ktype) (module: imgproc)
gen_javadoc error: could not find documentation for getGaborKernel(ksize,sigma,theta,lambd,gamma) (module: imgproc)
gen_javadoc error: could not find documentation for initWideAngleProjMap(cameraMatrix,distCoeffs,imageSize,destImageWidth,m1type,map1,map2,projType,alpha) (module: imgproc)
gen_javadoc error: could not find documentation for initWideAngleProjMap(cameraMatrix,distCoeffs,imageSize,destImageWidth,m1type,map1,map2) (module: imgproc)
gen_javadoc error: could not find documentation for intersectConvexConvex(_p1,_p2,_p12,handleNested) (module: imgproc)
gen_javadoc error: could not find documentation for intersectConvexConvex(_p1,_p2,_p12) (module: imgproc)
gen_javadoc error: could not find documentation for Moments (module: imgproc)
gen_javadoc error: could not find documentation for Moments::Moments() (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::Subdiv2D() (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::Subdiv2D(rect) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::edgeDst(edge,dstpt) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::edgeDst(edge) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::edgeOrg(edge,orgpt) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::edgeOrg(edge) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::findNearest(pt,nearestPt) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::findNearest(pt) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::getEdge(edge,nextEdgeType) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::getEdgeList(edgeList) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::getTriangleList(triangleList) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::getVertex(vertex,firstEdge) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::getVertex(vertex) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::getVoronoiFacetList(idx,facetList,facetCenters) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::initDelaunay(rect) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::insert(pt) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::insert(ptvec) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::locate(pt,edge,vertex) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::nextEdge(edge) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::rotateEdge(edge,rotate) (module: imgproc)
gen_javadoc error: could not find documentation for Subdiv2D::symEdge(edge) (module: imgproc)
gen_javadoc error: could not find documentation for CvANN_MLP::clear() (module: ml)
gen_javadoc error: could not find documentation for CvBoost::clear() (module: ml)
gen_javadoc error: could not find documentation for CvDTree::CvDTree() (module: ml)
gen_javadoc error: could not find documentation for CvDTree::clear() (module: ml)
gen_javadoc error: could not find documentation for CvERTrees::CvERTrees() (module: ml)
gen_javadoc error: could not find documentation for CvERTrees::train(trainData,tflag,responses,varIdx,sampleIdx,varType,missingDataMask,params) (module: ml)
gen_javadoc error: could not find documentation for CvERTrees::train(trainData,tflag,responses) (module: ml)
gen_javadoc error: could not find documentation for CvNormalBayesClassifier::clear() (module: ml)
gen_javadoc error: could not find documentation for CvRTParams::CvRTParams() (module: ml)
gen_javadoc error: could not find documentation for CvRTrees::CvRTrees() (module: ml)
gen_javadoc error: could not find documentation for CvRTrees::clear() (module: ml)
gen_javadoc error: could not find documentation for CvSVM::clear() (module: ml)
gen_javadoc error: could not find documentation for EM (module: ml)
gen_javadoc error: could not find documentation for EM::EM(nclusters,covMatType,termcrit) (module: ml)
gen_javadoc error: could not find documentation for EM::EM() (module: ml)
gen_javadoc error: could not find documentation for EM::clear() (module: ml)
gen_javadoc error: could not find documentation for EM::isTrained() (module: ml)
gen_javadoc error: could not find documentation for EM::predict(sample,probs,likelihood) (module: ml)
gen_javadoc error: could not find documentation for EM::predict(sample) (module: ml)
gen_javadoc error: could not find documentation for EM::train(samples,labels,probs,likelihoods) (module: ml)
gen_javadoc error: could not find documentation for EM::train(samples) (module: ml)
gen_javadoc error: could not find documentation for EM::trainE(samples,means0,covs0,weights0,labels,probs,likelihoods) (module: ml)
gen_javadoc error: could not find documentation for EM::trainE(samples,means0) (module: ml)
gen_javadoc error: could not find documentation for EM::trainM(samples,probs0,labels,probs,likelihoods) (module: ml)
gen_javadoc error: could not find documentation for EM::trainM(samples,probs0) (module: ml)
gen_javadoc error: could not find documentation for HOGDescriptor (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::HOGDescriptor() (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::HOGDescriptor(_winSize,_blockSize,_blockStride,_cellSize,_nbins,_derivAperture,_winSigma,_histogramNormType,_L2HysThreshold,_gammaCorrection,_nlevels) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::HOGDescriptor(_winSize,_blockSize,_blockStride,_cellSize,_nbins) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::HOGDescriptor(filename) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::checkDetectorSize() (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::compute(img,descriptors,winStride,padding,locations) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::compute(img,descriptors) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::computeGradient(img,grad,angleOfs,paddingTL,paddingBR) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::computeGradient(img,grad,angleOfs) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::detect(img,foundLocations,weights,hitThreshold,winStride,padding,searchLocations) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::detect(img,foundLocations,weights) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::detectMultiScale(img,foundLocations,foundWeights,hitThreshold,winStride,padding,scale,finalThreshold,useMeanshiftGrouping) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::detectMultiScale(img,foundLocations,foundWeights) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::getDaimlerPeopleDetector() (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::getDefaultPeopleDetector() (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::getDescriptorSize() (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::getWinSigma() (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::load(filename,objname) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::load(filename) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::save(filename,objname) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::save(filename) (module: objdetect)
gen_javadoc error: could not find documentation for HOGDescriptor::setSVMDetector(_svmdetector) (module: objdetect)
</pre>

History

Alexander Shishkov on 2012-03-21 20:28

- Target version deleted ()

Alexander Shishkov on 2012-03-22 14:27

- Priority changed from Normal to Low

Alexander Shishkov on 2012-03-25 20:46

- Assignee deleted (Vadim Pisarevsky)

Alexander Shishkov on 2012-04-05 12:44

- Target version deleted ()

Andrey Kamaev on 2012-04-06 20:45

- Description changed from Here is list of undocumented methods
reported by gen_javadoc.py script: <p... to Here is list of
undocumented methods reported by gen_javadoc.py script: <p... More

Kirill Kornyakov on 2012-05-11 16:49

We should probably consider this issue.
- Target version set to 3.0
- Assignee set to Andrey Pavlenko

Maksim Shabunin on 2015-04-27 15:06

After moving to doxygen, documentation for python and java is not generated anymore. This process should be reworked from scratch.
- Affected version set to branch 'master' (3.0-dev)
- Difficulty set to Medium
- Operating System set to Any
- HW Platform set to Any
- Target version changed from 3.0 to 3.1
- Priority changed from Low to Normal
- Assignee changed from Andrey Pavlenko to Maksim Shabunin