On Wed, Feb 06, 2019 at 08:49:38AM +0100, Markus Heiser wrote: > Am 06.02.19 um 05:27 schrieb Tobin C. Harding: > > Seems we either change them all or none of them. > > Both are OK .. from the spec ... > > "Simple reference names are single words consisting of alphanumerics plus > isolated (no two adjacent) internal hyphens, underscores, periods, colons > and plus signs; no whitespace or other characters are allowed." [1] > > > >> Many errors are not reported again in rebuilds. > > > > It's more than that. Seems that no .o files means dependencies are not > > the same in docs directories to *usual* source code directories, as in > > this example, a file with an outdated label was not rebuilt since it > > wasn't touched. > > Right, this is what they call the 'doctree' files (see [2] for build > phases), one for every source file. ATM they are located in the hidden > folder 'output/.doctree'. OT here, just to mentioning: this will result in > the folder being exported at the end, e.g. kernel.org: > > https://www.kernel.org/doc/html/latest/.doctrees/ > > > Note to self, always do clean build for docs patches. Thanks. > > > >> To reproduce this error run 'make cleandocs htmldocs' first. Then you will see > >> this error message (I'am on current docs-next from Jon using Sphinx v1.8.3 ): > >> > >> Documentation/core-api/mm-api.rst:22: WARNING: undefined label: \ > >> memory-allocation (if the link has no caption ...) > > > > Can confirm I also get this warning, > .. > > With patch reverted, on docs-next, I've got 0 'undefined labels' > > warnings. > > Thanks for verification. > > [1] http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#reference-names > [2] http://www.sphinx-doc.org/en/master/extdev/index.html#build-phases > > > -- Markus -- > Thanks Markus, I appreciate the information. Tobin.
