MantisBT - CMake
View Issue Details
IDProjectCategoryView StatusDate SubmittedLast Update
0014821CMakeDocumentationpublic2014-03-21 04:152014-10-06 10:32
ReporterHeiko Becker 
Assigned To 
PrioritynormalSeverityminorReproducibilityalways
StatusclosedResolutionno change required 
PlatformLinuxOSExherboOS Version
Product Version 
Target VersionFixed in Version 
Summary0014821: Man page generation with sphinx-1.1.3 fails
DescriptionWhen 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
Steps To Reproduce
Additional Information
TagsNo tags attached.
Relationships
Attached Files
Issue History
Date ModifiedUsernameFieldChange
2014-03-21 04:15Heiko BeckerNew Issue
2014-03-21 09:08Brad KingNote Added: 0035461
2014-03-21 09:11Brad KingNote Added: 0035462
2014-03-21 10:47Heiko BeckerNote Added: 0035465
2014-03-21 10:49Brad KingStatusnew => resolved
2014-03-21 10:49Brad KingResolutionopen => no change required
2014-10-06 10:32Robert MaynardNote Added: 0036950
2014-10-06 10:32Robert MaynardStatusresolved => closed

Notes
(0035461)
Brad King   
2014-03-21 09:08   
This is due to a combination of the docutils version and the sphinx version:

 https://bitbucket.org/birkenfeld/sphinx/issue/998/docutils-010-will-break-sphinx-manpage [^]
(0035462)
Brad King   
2014-03-21 09:11   
I was able to reproduce the reported error just by building a single document containing a ".. note::" directive. I bisected the Sphinx history to:

 https://bitbucket.org/birkenfeld/sphinx/commits/ffb145b7884fc926d6a68f4aaeede1d4964f727c [^]

which resolves the issue.
(0035465)
Heiko Becker   
2014-03-21 10:47   
Indeed, that patch fixes it. Thank you for the information.
(0036950)
Robert Maynard   
2014-10-06 10:32   
Closing resolved issues that have not been updated in more than 4 months.