Package: developers-reference
Version: 14.15
Severity: minor

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


-- System Information:
Debian Release: forky/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Foreign Architectures: arm64, armhf, i386

Kernel: Linux 7.2-amd64 (SMP w/24 CPU threads; PREEMPT)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), 
LANGUAGE=en_GB:en
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

developers-reference depends on no packages.

Versions of packages developers-reference recommends:
ii  debian-policy            4.7.4.1
ii  libjs-jquery             3.7.1+dfsg+~3.5.33-1
ii  libjs-sphinxdoc          9.1.0-7
ii  sensible-utils           0.0.26
ii  sphinx-rtd-theme-common  3.1.0+dfsg-2

Versions of packages developers-reference suggests:
ii  chromium [www-browser]     152.0.7977.82-1
pn  doc-base                   <none>
ii  firefox [www-browser]      155.0.1-1
ii  firefox-esr [www-browser]  140.15.0esr-1
ii  hv3 [www-browser]          3.0~fossil20110109-9
ii  lynx [www-browser]         2.9.3-2

-- no debconf information

Reply via email to