[cmake-developers] [CMake 0014821]: Man page generation with sphinx-1.1.3 fails

[Mantis Bug Tracker]

The following issue has been SUBMITTED. 
====================================================================== 
http://public.kitware.com/Bug/view.php?id=14821 
====================================================================== 
Reported By:                Heiko Becker
Assigned To:                
====================================================================== 
Project:                    CMake
Issue ID:                   14821
Category:                   Documentation
Reproducibility:            always
Severity:                   minor
Priority:                   normal
Status:                     new
====================================================================== 
Date Submitted:             2014-03-21 04:15 EDT
Last Modified:              2014-03-21 04:15 EDT
====================================================================== 
Summary:                    Man page generation with sphinx-1.1.3 fails
Description: 
When I try to build cmake-3.0.0-rc2 the build fails with the error message below
when generating the man pages. It's successful if I build it with sphinx-1.2.2.
Can this be fixed or should cmake just check for a newer version of sphinx?

[ 99%] Built target ctest
make -f Utilities/Sphinx/CMakeFiles/documentation.dir/build.make
Utilities/Sphinx/CMakeFiles/documentation.dir/depend
make[2]: Entering directory
'/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2'
cd /var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2 &&
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Bootstrap.cmk/cmake
-E cmake_depends "Unix Makefiles"
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Utilities/Sphinx
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Utilities/Sphinx
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Utilities/Sphinx/CMakeFiles/documentation.dir/DependInfo.cmake
--color=
Scanning dependencies of target documentation
make[2]: Leaving directory
'/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2'
make -f Utilities/Sphinx/CMakeFiles/documentation.dir/build.make
Utilities/Sphinx/CMakeFiles/documentation.dir/build
make[2]: Entering directory
'/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2'
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Bootstrap.cmk/cmake
-E cmake_progress_report
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/CMakeFiles
97
[100%] sphinx-build man: see Utilities/Sphinx/build-man.log
cd
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Utilities/Sphinx
&& python2 /usr/bin/sphinx-build -c
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Utilities/Sphinx
-d
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Utilities/Sphinx/doctrees
-b man
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Help
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Utilities/Sphinx/man
> build-man.log
Making output directory...
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2/Help/release/index.rst::
WARNING: document isn't included in any toctree

Exception occurred:
  File "/usr/lib64/python2.7/site-packages/docutils/writers/manpage.py", line
865, in dedent
    self._indent.pop()
IndexError: pop from empty list
The full traceback has been saved in
/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/temp/sphinx-err-juRMDo.log, if
you want to report the issue to the developers.
Please also report this if it was a user error, so that a better error message
can be provided next time.
Either send bugs to the mailing list at
<http://groups.google.com/group/sphinx-dev/>,
or report them in the tracker at
<http://bitbucket.org/birkenfeld/sphinx/issues/>. Thanks!
Utilities/Sphinx/CMakeFiles/documentation.dir/build.make:54: recipe for target
'Utilities/Sphinx/doc_format_man' failed
make[2]: Leaving directory
'/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2'
CMakeFiles/Makefile2:1811: recipe for target
'Utilities/Sphinx/CMakeFiles/documentation.dir/all' failed
make[1]: Leaving directory
'/var/tmp/paludis/build/sys-devel-cmake-3.0.0-rc2/work/cmake-3.0.0-rc2'
Makefile:150: recipe for target 'all' failed
make[2]: *** [Utilities/Sphinx/doc_format_man] Error 1
make[1]: *** [Utilities/Sphinx/CMakeFiles/documentation.dir/all] Error 2
make: *** [all] Error 2
====================================================================== 

Issue History 
Date Modified    Username       Field                    Change               
====================================================================== 
2014-03-21 04:15 Heiko Becker   New Issue                                    
======================================================================