2 years ago

#66078

test-img

Willy

Sphinx: "man_pages" config value references unknown document <filename>

I am a beginner so maybe this question sounds stupid.

Anyway, I have a make.bat file which you can pass in the builder name to use and it invokes below command:

set SPHINXBUILD=sphinx-build
set SOURCEDIR=source
set BUILDDIR=build

%SPHINXBUILD% -M %1 %SOURCEDIR% %BUILDDIR% %SPHINXOPTS% %O%

So when I type:

make.bat man

...it is executed and at the end it says:

The manual pages are in build\man.

...but it seems it is not working properly since build\man folder is empty. Also a lot of warning messages are comming up:

WARNING: "man_pages" config value references unknown document man\filename

I have a directory called man which contains a lot of filename.rst files.

So why man pages are not being generated within build\man folder?

Additional info:

In conf.py I have set man_pages as below:

man_pages = [
    (str(fn.parent / fn.stem), fn.stem, '', '', '1')
    for fn in pathlib.Path('man').glob('*.rst')
    ]

Note: If I type make.bat html it works ok and all the content is generated within build\html folder.

python

python-sphinx

pathlib

0 Answers

Your Answer

Accepted video resources