#1147583 developers-reference: reference _sanitycheck fails to create a link in section 5.8

#1147583#5
Date:
2026-09-13 11:12:12 UTC
From:
To:
Dear Maintainer,

In §5.8 of the rendered versions of the developers-reference documents,
the reference "_sanitycheck" is included literally instead of creating a
link because of the leading underscore, e.g. in the online version [1].

From the source pkgs.rst:

  .. _sanitycheck:

  [...]

  8. Verify that the new package builds correctly and if so carry out the checks
   in :ref:`_sanitycheck`.

Which leads to many instances of the following in the buildd log, per
language and per output type:

  /build/reproducible-path/developers-reference-14.15/source/pkgs.rst:605: WARNING: undefined label: '_sanitycheck' [ref.ref]

AFAIK, the correct form is :ref:`sanitycheck`.


[1] https://www.debian.org/doc/manuals/developers-reference/pkgs.en.html#new-upstream-versions