Package: debhelper Version: 13.15.3 Severity: minor Dear Maintainer, while updating the strings in the debhelper documentation the l10 documentation team noticed a few issues in the text which I report in the attached text file. Some issues are related to the presentation of text in the final documents. Others are simple typos. A few sentences are unclear.
Just for reference: The update of the german translation has been reported in a separate report as https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1069112. The remarks listed below appear in the po template as FIXME, too. In case the documentation is updated I will be happy to update the translation accordingly. Thank you very much for maintaining this huge project, Christoph Brinkhaus
1. Issue: s/source/B<source>/ Explanation: The fix should correct the appearance to be bold. Occurance: debhelper.pod:517 Current string: "Note that debhelper does not provide debhelper-compat for experimental or " "beta compatibility levels; packages experimenting with those compatibility " "levels should put the compat level in the B<X-DH-Compat> field of the source " "stanza of the F<debian/control> file (or, if only for selected commands, the " "B<DH_COMPAT> environment variable)." 2. Issue: s/source/B<source>/ Explanation: The fix should correct the appearance to be bold. Occurance: debhelper-compat-upgrade-checklist.pod:271 Current string: "The F<debian/compat> file is no longer accepted as a source for specifying " "the debhelper compat level. Put the compat level in the B<X-DH-Compat> field " "of the source stanza of F<debian/control>." 3. Issue: s/autoconf/B<autoconf>/ Explanation: The fix should correct the appearance to be bold. Occurance: debhelper-compat-upgrade-checklist.pod:827 Current string: "Multiarch support. In particular, B<dh_auto_configure> passes multiarch " "directories to autoconf in --libdir and --libexecdir." 4. Issue: s/autoconf/B<autoconf>/ Explanation: The fix should correct the appearance to be bold. Occurance: debhelper-compat-upgrade-checklist.pod:844 Current string: "B<dh_auto_configure> does not include the source package name in --" "libexecdir when using autoconf." 5. Issue: s/that has/that have/ Explanation: The fix should correct singular/plural Occurance: debhelper-compat-upgrade-checklist.pod:107 Current string: "I<< This item only applies to source packages that has exactly one " "B<Package> stanza in F<debian/control>. >>" 6. Issue: s/This change changes/This change/ Explanation: There should be one word as "change" only. Occurance: debhelper-compat-upgrade-checklist.pod:198 Current string: "Note: This change changes will cause false-positives from an unfixed " "B<lintian>. Please check L<https://bugs.debian.org/1067653> for B<lintian> " "support for this change." 7. Issue: would no longer installs → no longer installs Explanation: Make the description more precise. Occurance: debhelper-compat-upgrade-checklist.pod:504 Current string: "The B<dh_installdeb> tool would no longer installs the maintainer provided " "F<conffiles> file as it was deemed unnecessary. However, the B<remove-on-" "upgrade> from dpkg/1.20 made the file relevant again and B<dh_installdeb> " "now installs it again in compat levels 12+." 8. Issue s/can emulate it/can get an emulation of it/ (or emulate it) Explanation: I am not 100% sure, but it should make the description more precise. Occurance: debhelper-compat-upgrade-checklist.pod:637 Current string: "The B<perl-makemaker> and B<perl-build> build systems no longer pass B<-I.> " "to perl. Packages that still need this behaviour can emulate it by using " "the B<PERL5LIB> environment variable. E.g. by adding B<export PERL5LIB=.> " "in their debian/rules file (or similar)." 9. Issue: First sentence does not make sense to me. Explanation: If possible please re-phrase to make it clear. Occurance: dh_strip:78 Current string: "Debug symbols will be retained, but split into an independent file in F<usr/" "lib/debug/> in the package build directory. B<--dbg-package> is easier to " "use than this option, but this option is more flexible."
