Bug#1017094: false positive source-is-missing for gtk-doc generated html documentation
On Mon, Aug 29, 2022 at 11:59:40PM +0200, Bastian Germann wrote: > In general, it is not a good idea to have line length it as the only > heuristic for checking source-is-missing on HTML files. I have seen this on > many packages that I have dealt with in the last few months and all of them > were false positives. I think this may be https://bugs.debian.org/1019980, but I filed that separately just in case I'm wrong. -- Colin Watson (he/him) [cjwat...@debian.org]
Bug#1017094: false positive source-is-missing for gtk-doc generated html documentation
In general, it is not a good idea to have line length it as the only heuristic for checking source-is-missing on HTML files. I have seen this on many packages that I have dealt with in the last few months and all of them were false positives.
Bug#1017094: false positive source-is-missing for gtk-doc generated html documentation
Package: lintian Version: 2.115.2 Severity: important lintian issues the following error for network-manager E: network-manager source: source-is-missing [docs/api/html/gdbus-org.freedesktop.NetworkManager.SecretAgent.html] E: network-manager source: source-is-missing [docs/api/html/gdbus-org.freedesktop.NetworkManager.html] E: network-manager source: source-is-missing [docs/api/html/index.html] E: network-manager source: source-is-missing [docs/api/html/ix01.html] E: network-manager source: source-is-missing [docs/api/html/nm-dbus-types.html] E: network-manager source: source-is-missing [docs/api/html/nm-settings-dbus.html] E: network-manager source: source-is-missing [docs/api/html/nm-settings-nmcli.html] E: network-manager source: source-is-missing [docs/api/html/nmcli.html] E: network-manager source: source-is-missing [docs/api/html/settings-802-11-wireless-security.html] E: network-manager source: source-is-missing [docs/api/html/settings-802-11-wireless.html] E: network-manager source: source-is-missing [docs/api/html/settings-802-1x.html] E: network-manager source: source-is-missing [docs/api/html/settings-802-3-ethernet.html] E: network-manager source: source-is-missing [docs/api/html/settings-connection.html] E: network-manager source: source-is-missing [docs/api/html/settings-hostname.html] E: network-manager source: source-is-missing [docs/api/html/settings-ipv4.html] E: network-manager source: source-is-missing [docs/api/html/settings-ipv6.html] E: network-manager source: source-is-missing [docs/api/html/settings-match.html] E: network-manager source: source-is-missing [docs/api/html/settings-sriov.html] E: network-manager source: source-is-missing [docs/api/html/settings-team-port.html] E: network-manager source: source-is-missing [docs/api/html/settings-team.html] E: network-manager source: source-is-missing [docs/api/html/settings-vlan.html] E: network-manager source: source-is-missing [docs/api/html/settings-wireguard.html] E: network-manager source: source-is-missing [docs/libnm/html/NMClient.html] E: network-manager source: source-is-missing [docs/libnm/html/NMConnection.html] While the package does ship pre-generated html files, the build is done with --enable-gtk-doc to regenerate the html. And the source files are right there: $ ls docs/api/ dbus-org.freedesktop.NetworkManager.AccessPoint.xml dbus-org.freedesktop.NetworkManager.Device.xml dbus-org.freedesktop.NetworkManager.AgentManager.xml dbus-org.freedesktop.NetworkManager.DHCP4Config.xml dbus-org.freedesktop.NetworkManager.Connection.Active.xml dbus-org.freedesktop.NetworkManager.DHCP6Config.xml dbus-org.freedesktop.NetworkManager.Device.Adsl.xml dbus-org.freedesktop.NetworkManager.DnsManager.xml dbus-org.freedesktop.NetworkManager.Device.Bluetooth.xml dbus-org.freedesktop.NetworkManager.IP4Config.xml dbus-org.freedesktop.NetworkManager.Device.Bond.xml dbus-org.freedesktop.NetworkManager.IP6Config.xml dbus-org.freedesktop.NetworkManager.Device.Bridge.xml dbus-org.freedesktop.NetworkManager.PPP.xml dbus-org.freedesktop.NetworkManager.Device.Dummy.xml dbus-org.freedesktop.NetworkManager.SecretAgent.xml dbus-org.freedesktop.NetworkManager.Device.Generic.xml dbus-org.freedesktop.NetworkManager.Settings.Connection.xml dbus-org.freedesktop.NetworkManager.Device.Infiniband.xml dbus-org.freedesktop.NetworkManager.Settings.xml dbus-org.freedesktop.NetworkManager.Device.IPTunnel.xml dbus-org.freedesktop.NetworkManager.VPN.Connection.xml dbus-org.freedesktop.NetworkManager.Device.Macsec.xml dbus-org.freedesktop.NetworkManager.VPN.Plugin.xml dbus-org.freedesktop.NetworkManager.Device.Macvlan.xml dbus-org.freedesktop.NetworkManager.xml dbus-org.freedesktop.NetworkManager.Device.Modem.xml html dbus-org.freedesktop.NetworkManager.Device.OlpcMesh.xmlMakefile.am dbus-org.freedesktop.NetworkManager.Device.Statistics.xml Makefile.in dbus-org.freedesktop.NetworkManager.Device.Team.xmlmeson.build dbus-org.freedesktop.NetworkManager.Device.Tun.xml network-manager-docs.xml dbus-org.freedesktop.NetworkManager.Device.Veth.xml NetworkManager-overrides.txt dbus-org.freedesktop.NetworkManager.Device.Vlan.xml NetworkManager-sections.txt dbus-org.freedesktop.NetworkManager.Device.Vxlan.xml settings-spec.xml dbus-org.freedesktop.NetworkManager.Device.WifiP2P.xml settings-spec.xsl dbus-org.freedesktop.NetworkManager.Device.Wired.xml version.xml dbus-org.freedesktop.NetworkManager.Device.WireGuard.xml version.xml.in dbus-org.freedesktop.NetworkManager.Device.Wireless.xml -- System Information: Debian Release: bookworm/sid APT prefers unstable APT policy: (500, 'unstable'), (200, 'experimental') Architecture: amd64 (x86_64) Foreign Architectures: i386 Kernel: Linux 5.18.0-4-amd64 (SMP w/4 CPU threads; PREEMPT) Kernel taint flags: TAINT_FIRMWARE_WORKAROUND Locale: LANG=de_DE.UTF-8, LC_CTYPE=de_DE.UTF-8