Ask Your Question

Revision history [back]

click to hide/show revision 1
initial version

Unable to build documentation

I have successfully build Opencv2.4.4, with cmake -D CMAKE_BUILD_TYPE=RELEASE ...

Now, a couple of days later, I want to build documentation for offline reading. After rerunning cmake, I notice the following output:

-- 
--   Documentation:
--     Build Documentation:         NO
--     Sphinx:                      NO
--     PdfLaTeX compiler:           /usr/bin/pdflatex
--

I couldn't find anywhere a list of valid options for cmake, so I had a look inside the file CMakeLists.txt, where I notice that the corresponding option seems to be called BUILD_DOCS.

So I try again cmake:

cmake -D BUILD_DOCS=YES -D CMAKE_BUILD_TYPE=RELEASE ..

or even:

cmake -D BUILD_DOCS=ON -D CMAKE_BUILD_TYPE=RELEASE ..

But, no, the cmake output keeps saying it won't build doc. And funnily , it seems that this option should be enabled by default (line 154) :

OCV_OPTION(BUILD_DOCS "Create build rules for OpenCV Documentation" ON )

However, after checking indepth the Cmakelists.txt file (line 807), it seems that is is indeed possible to build html and pdf versions of doc ?

So my questions are:

  • Is is possible to build doc without Sphinx ?
  • If yes, how can I force cmake to generate the "doc" target ?

(And, yes, in the meanwhile I got the online pdf files, but the question remains.)

Unable to build documentation

I have successfully build Opencv2.4.4, with with:

cmake -D CMAKE_BUILD_TYPE=RELEASE ...

..

Now, a couple of days later, I want to build documentation for offline reading. After rerunning cmake, I notice the following output:

-- 
--   Documentation:
--     Build Documentation:         NO
--     Sphinx:                      NO
--     PdfLaTeX compiler:           /usr/bin/pdflatex
--

I couldn't find anywhere a list of valid options for cmake, so I had a look inside the file CMakeLists.txt, where I notice that the corresponding option seems to be called BUILD_DOCS.

So I try again cmake:

cmake -D BUILD_DOCS=YES -D CMAKE_BUILD_TYPE=RELEASE ..

or even:

cmake -D BUILD_DOCS=ON -D CMAKE_BUILD_TYPE=RELEASE ..

But, no, the cmake output keeps saying it won't build doc. And funnily , it seems that this option should be enabled by default (line 154) :

OCV_OPTION(BUILD_DOCS "Create build rules for OpenCV Documentation" ON )

However, after checking indepth the Cmakelists.txt file (line 807), it seems that is is indeed possible to build html and pdf versions of doc ?

So my questions are:

  • Is is possible to build doc without Sphinx ?
  • If yes, how can I force cmake to generate the "doc" target ?

(And, yes, in the meanwhile I got the online pdf files, but the question remains.)