Re: Documentation/media/uapi/cec/ sporadically unnecessarily rebuilding

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



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



[Index of Archives]     [Kernel Newbies]     [Security]     [Netfilter]     [Bugtraq]     [Linux FS]     [Yosemite Forum]     [MIPS Linux]     [ARM Linux]     [Linux Security]     [Linux RAID]     [Samba]     [Video 4 Linux]     [Device Mapper]     [Linux Resources]

  Powered by Linux