Living and writing documentation at Documatt, small team of programmers that write documentation too.
Sphinx build failed with error similar to the following:
index.rst:4: WARNING: undefined label: foo (if the link has no caption the label must precede a section header)
Reference :ref: points to non-existing label.
:ref:
The document contains :ref: reference to cmd-options label, but a label doesn’t exist in the document either project.
cmd-options
Welcome ======= For full list, see :ref:`cmd-options`.
Add missing label .. _cmd-options: before respective place.
.. _cmd-options:
Welcome! ======== See also :ref:`cmd-options`. .. _cmd-options: Commandline options ------------------- Foo has many many many options.
Label may be added even in different document, e.g. reference.rst.
reference.rst
Reference ========== ...a lot of text... .. _cmd-options: Commandline options -------------------- Foo has many many many options.