btrfs-progs icon indicating copy to clipboard operation
btrfs-progs copied to clipboard

Documentation build error

Open realwakka opened this issue 3 years ago • 1 comments
trafficstars

I'm using ubuntu 20.04 LTS and sphinx 1.8.5. When I tried to compile documentation, I got this error messages below.

Sphinx error:
master file /root/git/btrfs-progs/Documentation/contents.rst not found
make[1]: *** [Makefile:37: man] Error 2
make: *** [Makefile:438: build-Documentation] Error 2

This error resolved with adding one line for conf.py

master_doc = 'index'

It seems that it's same problem with this link https://stackoverflow.com/questions/56336234/build-fail-sphinx-error-contents-rst-not-found

realwakka avatar Jul 30 '22 15:07 realwakka

self answer. Because of sphinx version. I used sphinx 1.8.5. It uses 'contents' as index. And it's default configuration changed in version 2.0. I think there no need to patch for this.

https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-root_doc

realwakka avatar Aug 06 '22 01:08 realwakka