Em Mon, 24 Oct 2016 12:04:31 +0300 Jani Nikula <jani.nikula@xxxxxxxxx> escreveu: > I think I saw some of this in the past [1], but then couldn't reproduce > it after all. Now I'm seeing it again. Sporadically > Documentation/media/uapi/cec/ gets rebuilt on successive runs of make > htmldocs, even when nothing has changed. > > Output of 'make SPHINXOPTS="-v -v" htmldocs' attached for both cases. > > Using Sphinx (sphinx-build) 1.4.6 I notice some erratic behavior like that too, when I was writing the admin-guide and process books... Sometimes, Sphinx decide to rebuild everything (media, gpu, etc) without a good reason. Also, sometimes, I was forced to run make cleandocs, as just touching at an rst file or at a file parsed by kernel-doc is not enough. The only safe way to be sure that the documentation will be OK and won't take too long to build is to use: make cleandocs; make DOCBOOKS="" SPHINXDIRS="admin-guide process" SPHINXOPTS="-j11" htmldocs It will generate warnings, though, due to the cross-references between admin-guide and process books. Due to that, after testing for individual changes, I run: make cleandocs; make DOCBOOKS="" SPHINXOPTS="-j11" htmldocs To check those references. I didn't see any improvement for that on Sphinx 1.4.7 or 1.4.8. Thanks, Mauro -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
