Bug#579964: lintian: Perplexing explanation of debian-rules-calls-debhelper-in-odd-order
Package: lintian
Version: 2.4.1
Severity: normal
$ echo "W: fool source: debian-rules-calls-debhelper-in-odd-order dh_makeshlibs (line 43)" | lintian-info
W: phaseshift source: debian-rules-calls-debhelper-in-odd-order dh_makeshlibs (line 43)
N:
N: One of the targets in the debian/rules file for this package calls
N: debhelper programs in an odd order. Normally, dh_makeshlibs should be
N: called before dh_shlibdeps or dh_installdeb, dh_shlibdeps should be
N: called before dh_gencontrol, and all should be called before
N: dh_builddeb. Calling them in the wrong order may cause incorrect or
N: missing package files and metadata.
N:
N: Severity: normal, Certainty: certain
N:
SUGGESTION
To my regret, I cannot read from the wording what would be the correct
ordering of the commands. The words "before" and "..before" don't
visualize in my mind. There is too much going on. I'd rather read from
left to right (pkg1, pkg2 ...) and I'm unable to map the terms of
"before" to their representatives.
Perhpas the the paragraph could be rephrased:
The correct order is: 1) ....
or 2) .... or 3) ....
Or use some notation like:
A [B | C] D ...
-- System Information:
Debian Release: squeeze/sid
APT prefers testing
APT policy: (990, 'testing'), (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.32-trunk-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_DK.UTF-8, LC_CTYPE=en_DK.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages lintian depends on:
ii binutils 2.20.1-8 The GNU assembler, linker and bina
ii diffstat 1.47-1 produces graph of changes introduc
ii dpkg-dev 1.15.7.1 Debian package development tools
ii file 5.04-2 Determines file type using "magic"
ii gettext 0.17-10 GNU Internationalization utilities
ii intltool-debian 0.35.0+20060710.1 Help i18n of RFC822 compliant conf
ii libapt-pkg-perl 0.1.24 Perl interface to libapt-pkg
ii libclass-accessor-perl 0.34-1 Perl module that automatically gen
ii libipc-run-perl 0.89-1 Perl module for running processes
ii libparse-debianchangel 1.1.1-2 parse Debian changelogs and output
ii libtimedate-perl 1.2000-1 collection of modules to manipulat
ii liburi-perl 1.54-1 module to manipulate and access UR
ii locales 2.10.2-6 Embedded GNU C Library: National L
ii man-db 2.5.7-2 on-line manual pager
ii perl [libdigest-sha-pe 5.10.1-12 Larry Wall's Practical Extraction
lintian recommends no packages.
Versions of packages lintian suggests:
pn binutils-multiarch <none> (no description available)
ii libtext-template-perl 1.45-1 Text::Template perl module
ii man-db 2.5.7-2 on-line manual pager
-- no debconf information
Reply to: