On Wed, Feb 06, 2019 at 08:49:38AM +0100, Markus Heiser wrote:

Am 06.02.19 um 05:27 schrieb Tobin C. Harding:

quoted

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]

quoted

quoted

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/

quoted

Note to self, always do clean build for docs patches.  Thanks.

quoted

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,

..

quoted

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.