diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000000000000000000000000000000000000..3cca0bfa8f9e901d8edad7348d32a3c14867266c --- /dev/null +++ b/.editorconfig @@ -0,0 +1,11 @@ +root = true + +[*] +end_of_line = lf +insert_final_newline = true + +[*.py] +indent_style = space + +[*.{pl,pm}] +indent_style = tab diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 688aed767eacc34e0ea05272c4f401fb6875c9ae..791c2eaac89566749e500779573e06f4f93dadc5 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -69,7 +69,7 @@ Here are some guidelines that may be useful: costs. * Helpers / tools should generally *do the right thing* by default - (subject to backwards compatibility). If most people neeed some + (subject to backwards compatibility). If most people need some particular option to make the tool work for them, then the default should be changed (again, subject to backwards compatibility). diff --git a/Makefile b/Makefile index d0b40796377920a31535b8a15807c5474c2c1247..76036b7c17f363fbccb16510537e489bca50859c 100644 --- a/Makefile +++ b/Makefile @@ -65,7 +65,7 @@ LANGS= LANG_TARGETS = endif -build: $(LANG_TARGETS) version debhelper.7 debhelper-obsolete-compat.7 $(MANPAGES) +build: $(LANG_TARGETS) version debhelper.7 debhelper-compat-upgrade-checklist.7 debhelper-obsolete-compat.7 $(MANPAGES) po4a-stamp: @@ -85,6 +85,9 @@ translated-%-stamp: po4a-stamp $(MAKEMANLIST) `find $$dir -type f -maxdepth 1 -name "dh_*.pod" | LC_ALL=C sort` | \ $(POD2MAN) $(POD2MAN_FLAGS) --name="debhelper" --section=7 > debhelper.$$lang.7; \ fi; \ + if [ -e $$dir/debhelper-compat-upgrade-checklist.pod ]; then \ + $(POD2MAN) $(POD2MAN_FLAGS) --name="debhelper" --section=7 $$dir/debhelper-compat-upgrade-checklist.pod > debhelper-compat-upgrade-checklist.$$lang.7; \ + fi ; \ if [ -e $$dir/debhelper-obsolete-compat.pod ]; then \ $(POD2MAN) $(POD2MAN_FLAGS) --name="debhelper" --section=7 $$dir/debhelper-obsolete-compat.pod > debhelper-obsolete-compat.$$lang.7; \ fi @@ -105,7 +108,7 @@ debhelper.7: debhelper.pod $(MAKEMANLIST) $(COMMANDS) | \ $(POD2MAN) $(POD2MAN_FLAGS) --name="debhelper" --section=7 > $@ -debhelper-obsolete-compat.7: debhelper-obsolete-compat.pod +%.7: %.pod $(POD2MAN) $(POD2MAN_FLAGS) --name="debhelper" --section=7 $^ > $@ clean: @@ -137,4 +140,4 @@ install: install -m 0644 lib/Debian/Debhelper/DH/*.pm $(DESTDIR)$(PERLLIBDIR)/DH test: version - MAKEFLAGS= HARNESS_OPTIONS=j$(TEST_JOBS) ./run perl -MTest::Harness -e 'runtests grep { ! /CVS/ && ! /\.svn/ && -f && -x && m/\.t$$/ } @ARGV' t/* t/*/* + MAKEFLAGS= prove -lrj$(TEST_JOBS) --timer t diff --git a/autoscripts/postinst-icons b/autoscripts/postinst-icons index aa2eed0e5c1b9c7f255164137606f7a0be983c27..802134bf1c0388d707a18c329b8d7cefb279e0ed 100644 --- a/autoscripts/postinst-icons +++ b/autoscripts/postinst-icons @@ -1,5 +1,5 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - if which update-icon-caches >/dev/null 2>&1 ; then + if command -v update-icon-caches >/dev/null; then update-icon-caches #DIRLIST# fi fi diff --git a/autoscripts/postinst-init b/autoscripts/postinst-init index 535b40c388acb7b30591e9fc73d4ab4e440ffe95..8da1a734d8160ed328060304638370e09e601a84 100644 --- a/autoscripts/postinst-init +++ b/autoscripts/postinst-init @@ -1,5 +1,5 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - if [ -x "/etc/init.d/#SCRIPT#" ]; then + if [ -z "${DPKG_ROOT:-}" ] && [ -x "/etc/init.d/#SCRIPT#" ]; then update-rc.d #SCRIPT# #INITPARMS# >/dev/null invoke-rc.d #INVOKE_RCD_PARAMS##SCRIPT# start || #ERROR_HANDLER# fi diff --git a/autoscripts/postinst-init-restart b/autoscripts/postinst-init-restart index 19dff68a18671dca4aa2082957b9df2b9c84b5f5..d52182b4f21f52d81ca6b5710403e970323dc7c8 100644 --- a/autoscripts/postinst-init-restart +++ b/autoscripts/postinst-init-restart @@ -1,5 +1,5 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - if [ -x "/etc/init.d/#SCRIPT#" ]; then + if [ -z "${DPKG_ROOT:-}" ] && [ -x "/etc/init.d/#SCRIPT#" ]; then update-rc.d #SCRIPT# #INITPARMS# >/dev/null if [ -n "$2" ]; then _dh_action=restart diff --git a/autoscripts/postinst-init-tmpfiles b/autoscripts/postinst-init-tmpfiles index f2582933bc548a09f1920f5d2d91c9035825a38e..b9f7191145bb47ef6aa60ddac64daf54f3f333a1 100644 --- a/autoscripts/postinst-init-tmpfiles +++ b/autoscripts/postinst-init-tmpfiles @@ -1,7 +1,5 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - # In case this system is running systemd, we need to ensure that all - # necessary tmpfiles (if any) are created before starting. - if [ -d /run/systemd/system ] ; then - systemd-tmpfiles --create #TMPFILES# >/dev/null || true + if [ -x "$(command -v systemd-tmpfiles)" ]; then + systemd-tmpfiles ${DPKG_ROOT:+--root="$DPKG_ROOT"} --create #TMPFILES# >/dev/null || true fi fi diff --git a/autoscripts/postinst-menu b/autoscripts/postinst-menu index b56a34622bb97ececbb6f133bdae86fb6752ba66..08c14eafc0e630272a2a67db40bf46404d922e38 100644 --- a/autoscripts/postinst-menu +++ b/autoscripts/postinst-menu @@ -1,3 +1,3 @@ -if [ "$1" = "configure" ] && [ -x "`which update-menus 2>/dev/null`" ]; then +if [ "$1" = "configure" ] && [ -x "`command -v update-menus`" ] && [ -x "$DPKG_ROOT`command -v update-menus`" ]; then update-menus fi diff --git a/autoscripts/postinst-menu-method b/autoscripts/postinst-menu-method index c56d625894930d89f58ca573ae81638b4fedf098..deec0341c99d2f0b5b47e06a83bee3e4c125c1bf 100644 --- a/autoscripts/postinst-menu-method +++ b/autoscripts/postinst-menu-method @@ -1,7 +1,7 @@ inst=/etc/menu-methods/#PACKAGE# if [ -f $inst ]; then chmod a+x $inst - if [ -x "`which update-menus 2>/dev/null`" ]; then + if [ -x "`command -v update-menus`" ] && [ -x "$DPKG_ROOT`command -v update-menus`" ]; then update-menus fi fi diff --git a/autoscripts/postinst-systemd-dont-enable b/autoscripts/postinst-systemd-dont-enable index 6ecec6282b6f0af81ecbbb5de8e4d6810d879daa..8cd2bf44a94c6c623d26ea37be37d358b8961524 100644 --- a/autoscripts/postinst-systemd-dont-enable +++ b/autoscripts/postinst-systemd-dont-enable @@ -1,6 +1,6 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then if deb-systemd-helper debian-installed #UNITFILE#; then - # This will only remove masks created by d-s-h on package removal. + # The following line should be removed in trixie or trixie+1 deb-systemd-helper unmask #UNITFILE# >/dev/null || true if deb-systemd-helper --quiet was-enabled #UNITFILE#; then diff --git a/autoscripts/postinst-systemd-enable b/autoscripts/postinst-systemd-enable index c0b2574e64bc42972033ba3597cc73485ab2f839..d06c2fe2917901bf20f5e0ba44cc5dc922ac412b 100644 --- a/autoscripts/postinst-systemd-enable +++ b/autoscripts/postinst-systemd-enable @@ -1,5 +1,5 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - # This will only remove masks created by d-s-h on package removal. + # The following line should be removed in trixie or trixie+1 deb-systemd-helper unmask #UNITFILE# >/dev/null || true # was-enabled defaults to true, so new installations run enable. diff --git a/autoscripts/postinst-systemd-restartnostart b/autoscripts/postinst-systemd-restartnostart index d3f199cfdb3f7576916141ec6966938de9b5f4bb..ebba20b87cc9808c9c57d7bc7120692c93fc1bae 100644 --- a/autoscripts/postinst-systemd-restartnostart +++ b/autoscripts/postinst-systemd-restartnostart @@ -1,5 +1,5 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - if [ -d /run/systemd/system ]; then + if [ -z "${DPKG_ROOT:-}" ] && [ -d /run/systemd/system ]; then systemctl --system daemon-reload >/dev/null || true if [ -n "$2" ]; then deb-systemd-invoke #RESTART_ACTION# #UNITFILES# >/dev/null || true diff --git a/autoscripts/postinst-systemd-start b/autoscripts/postinst-systemd-start index 6a24ad875357bc2d1fbbfd878375a1ad41a1e42a..9072c534ad2759ce18515a193bcb875882367d0e 100644 --- a/autoscripts/postinst-systemd-start +++ b/autoscripts/postinst-systemd-start @@ -1,5 +1,5 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - if [ -d /run/systemd/system ]; then + if [ -z "${DPKG_ROOT:-}" ] && [ -d /run/systemd/system ]; then systemctl --system daemon-reload >/dev/null || true deb-systemd-invoke start #UNITFILES# >/dev/null || true fi diff --git a/autoscripts/postinst-systemd-user-dont-enable b/autoscripts/postinst-systemd-user-dont-enable index 0837257ffefa5dca7af2c154c11fcb41a972a578..a916f2ff37b176735e17ad78876e0640b0330d7d 100644 --- a/autoscripts/postinst-systemd-user-dont-enable +++ b/autoscripts/postinst-systemd-user-dont-enable @@ -1,15 +1,17 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - if deb-systemd-helper --user debian-installed #UNITFILE# ; then - # This will only remove masks created by d-s-h on package removal. - deb-systemd-helper --user unmask #UNITFILE# >/dev/null || true + if [ -z "${DPKG_ROOT:-}" ]; then + if deb-systemd-helper --user debian-installed #UNITFILE# ; then + # The following line should be removed in trixie or trixie+1 + deb-systemd-helper --user unmask #UNITFILE# >/dev/null || true - if deb-systemd-helper --quiet --user was-enabled #UNITFILE# ; then - # Create new symlinks, if any. - deb-systemd-helper --user enable #UNITFILE# >/dev/null || true + if deb-systemd-helper --quiet --user was-enabled #UNITFILE# ; then + # Create new symlinks, if any. + deb-systemd-helper --user enable #UNITFILE# >/dev/null || true + fi fi - fi - # Update the statefile to add new symlinks (if any), which need to be cleaned - # up on purge. Also remove old symlinks. - deb-systemd-helper --user update-state #UNITFILE# >/dev/null || true + # Update the statefile to add new symlinks (if any), which need to be cleaned + # up on purge. Also remove old symlinks. + deb-systemd-helper --user update-state #UNITFILE# >/dev/null || true + fi fi diff --git a/autoscripts/postinst-systemd-user-enable b/autoscripts/postinst-systemd-user-enable index b16f61fba23fc39e9e73d0bb8d1d25f94f08f45a..b400c849ac24a0a665d1aef87ae24d5d9d387248 100644 --- a/autoscripts/postinst-systemd-user-enable +++ b/autoscripts/postinst-systemd-user-enable @@ -1,15 +1,17 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - # This will only remove masks created by d-s-h on package removal. - deb-systemd-helper --user unmask #UNITFILE# >/dev/null || true + if [ -z "${DPKG_ROOT:-}" ] ; then + # The following line should be removed in trixie or trixie+1 + deb-systemd-helper --user unmask #UNITFILE# >/dev/null || true - # was-enabled defaults to true, so new installations run enable. - if deb-systemd-helper --quiet --user was-enabled #UNITFILE# ; then - # Enables the unit on first installation, creates new - # symlinks on upgrades if the unit file has changed. - deb-systemd-helper --user enable #UNITFILE# >/dev/null || true - else - # Update the statefile to add new symlinks (if any), which need to be - # cleaned up on purge. Also remove old symlinks. - deb-systemd-helper --user update-state #UNITFILE# >/dev/null || true + # was-enabled defaults to true, so new installations run enable. + if deb-systemd-helper --quiet --user was-enabled #UNITFILE# ; then + # Enables the unit on first installation, creates new + # symlinks on upgrades if the unit file has changed. + deb-systemd-helper --user enable #UNITFILE# >/dev/null || true + else + # Update the statefile to add new symlinks (if any), which need to be + # cleaned up on purge. Also remove old symlinks. + deb-systemd-helper --user update-state #UNITFILE# >/dev/null || true + fi fi fi diff --git a/autoscripts/postinst-systemd-user-restart b/autoscripts/postinst-systemd-user-restart new file mode 100644 index 0000000000000000000000000000000000000000..5b84939107981516d94d2a23aa88f2870bbd1047 --- /dev/null +++ b/autoscripts/postinst-systemd-user-restart @@ -0,0 +1,6 @@ +if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then + if [ -z "${DPKG_ROOT:-}" ] && [ -d /run/systemd/system ]; then + systemctl --global daemon-reload >/dev/null || true + deb-systemd-invoke --user restart #UNITFILES# >/dev/null || true + fi +fi diff --git a/autoscripts/postinst-sysusers b/autoscripts/postinst-sysusers index 7784e5325c78e650d9b083370b5d3d83d8bcfd7d..fdd27d6d7cffcac789bf428b607d9e27a401a0de 100644 --- a/autoscripts/postinst-sysusers +++ b/autoscripts/postinst-sysusers @@ -1,3 +1,3 @@ if [ "$1" = "configure" ] || [ "$1" = "abort-upgrade" ] || [ "$1" = "abort-deconfigure" ] || [ "$1" = "abort-remove" ] ; then - systemd-sysusers #CONFILE_BASENAME# + systemd-sysusers ${DPKG_ROOT:+--root="$DPKG_ROOT"} #CONFILE_BASENAME# fi diff --git a/autoscripts/postinst-xfonts b/autoscripts/postinst-xfonts index 96390e4e04ea162dc8fee6b20b89d11db38cede8..93ca535dc8051ba8279593750d2c04c1c4fc1cc5 100644 --- a/autoscripts/postinst-xfonts +++ b/autoscripts/postinst-xfonts @@ -1,3 +1,3 @@ -if which update-fonts-dir >/dev/null 2>&1; then +if command -v update-fonts-dir >/dev/null; then #CMDS# fi diff --git a/autoscripts/postrm-icons b/autoscripts/postrm-icons index 9e00f03978dc2bcf09081043460fa8e601534874..c77c52a6a54148ff5a4cad288db90491da65efa5 100644 --- a/autoscripts/postrm-icons +++ b/autoscripts/postrm-icons @@ -1,3 +1,3 @@ -if which update-icon-caches >/dev/null 2>&1 ; then +if command -v update-icon-caches >/dev/null; then update-icon-caches #DIRLIST# fi diff --git a/autoscripts/postrm-init b/autoscripts/postrm-init index 1c29298256bdcf9ca800b7214520cdf058a1d95d..6b8134188b50acd04e6686dba0414b47367438fa 100644 --- a/autoscripts/postrm-init +++ b/autoscripts/postrm-init @@ -1,3 +1,6 @@ -if [ "$1" = "purge" ] ; then +if [ "$1" = "remove" ] && [ -x "/etc/init.d/#SCRIPT#" ] ; then + chmod -x "/etc/init.d/#SCRIPT#" >/dev/null || true +fi +if [ -z "${DPKG_ROOT:-}" ] && [ "$1" = "purge" ] ; then update-rc.d #SCRIPT# remove >/dev/null fi diff --git a/autoscripts/postrm-menu b/autoscripts/postrm-menu index a180558d70b4c67f0429c422926c13691a72180c..4c4b00c536ea999b1300c957dde405ed2833bc8c 100644 --- a/autoscripts/postrm-menu +++ b/autoscripts/postrm-menu @@ -1 +1 @@ -if [ -x "`which update-menus 2>/dev/null`" ]; then update-menus ; fi +if [ -x "`command -v update-menus`" ] && [ -x "$DPKG_ROOT`command -v update-menus`" ]; then update-menus ; fi diff --git a/autoscripts/postrm-menu-method b/autoscripts/postrm-menu-method index ffa1e4862bd35a3cf125f351d701f28033e4dff8..bcbdf47e1088af8ab7629c8d5e5ee10db11ec13c 100644 --- a/autoscripts/postrm-menu-method +++ b/autoscripts/postrm-menu-method @@ -1,3 +1,3 @@ inst=/etc/menu-methods/#PACKAGE# if [ "$1" = "remove" ] && [ -f "$inst" ]; then chmod a-x $inst ; fi -if [ -x "`which update-menus 2>/dev/null`" ]; then update-menus ; fi +if [ -x "`command -v update-menus`" ] && [ -x "$DPKG_ROOT`command -v update-menus`" ]; then update-menus ; fi diff --git a/autoscripts/postrm-systemd b/autoscripts/postrm-systemd index d95013b632d35494f96bae0e62fd43fde997569c..a782f3afed827212a3d553fbf0b1baf60ed19efd 100644 --- a/autoscripts/postrm-systemd +++ b/autoscripts/postrm-systemd @@ -1,12 +1,5 @@ -if [ "$1" = "remove" ]; then - if [ -x "/usr/bin/deb-systemd-helper" ]; then - deb-systemd-helper mask #UNITFILES# >/dev/null || true - fi -fi - if [ "$1" = "purge" ]; then if [ -x "/usr/bin/deb-systemd-helper" ]; then deb-systemd-helper purge #UNITFILES# >/dev/null || true - deb-systemd-helper unmask #UNITFILES# >/dev/null || true fi fi diff --git a/autoscripts/postrm-systemd-reload-only b/autoscripts/postrm-systemd-reload-only index c251c34840e9e0c4a57a3c6ab5aeaaed6cb95f23..dac15c3094b0510814fb6d85ce3d1db8b8b27130 100644 --- a/autoscripts/postrm-systemd-reload-only +++ b/autoscripts/postrm-systemd-reload-only @@ -1,3 +1,3 @@ -if [ -d /run/systemd/system ] && [ "$1" = remove ]; then +if [ "$1" = remove ] && [ -d /run/systemd/system ] ; then systemctl --system daemon-reload >/dev/null || true fi diff --git a/autoscripts/postrm-systemd-user b/autoscripts/postrm-systemd-user index bf48d1a3cc937e2ff82e04fbbf4db5f40e7906a3..0745d6fef8187bf8601db299fb514424d88648b7 100644 --- a/autoscripts/postrm-systemd-user +++ b/autoscripts/postrm-systemd-user @@ -1,12 +1,5 @@ -if [ "$1" = "remove" ]; then - if [ -x "/usr/bin/deb-systemd-helper" ] ; then - deb-systemd-helper --user mask #UNITFILES# >/dev/null || true - fi -fi - if [ "$1" = "purge" ]; then - if [ -x "/usr/bin/deb-systemd-helper" ] ; then + if [ -z "${DPKG_ROOT:-}" ] && [ -x "/usr/bin/deb-systemd-helper" ] ; then deb-systemd-helper --user purge #UNITFILES# >/dev/null || true - deb-systemd-helper --user unmask #UNITFILES# >/dev/null || true fi fi diff --git a/autoscripts/postrm-systemd-user-reload-only b/autoscripts/postrm-systemd-user-reload-only new file mode 100644 index 0000000000000000000000000000000000000000..8f41121bc1928e4e9a13a7ba20bf164c774a634f --- /dev/null +++ b/autoscripts/postrm-systemd-user-reload-only @@ -0,0 +1,3 @@ +if [ -z "${DPKG_ROOT:-}" ] && [ "$1" = remove ] && [ -d /run/systemd/system ] ; then + systemctl --global daemon-reload >/dev/null || true +fi diff --git a/autoscripts/postrm-ucf b/autoscripts/postrm-ucf index da3757269f77846268e8976fd7600fb9bedb5ba0..ff2f32c670e8eeb683e637e474c454b40a8cd96b 100644 --- a/autoscripts/postrm-ucf +++ b/autoscripts/postrm-ucf @@ -3,10 +3,10 @@ if [ "$1" = "purge" ]; then rm -f "#UCFDEST#$ext" done - if [ -x "`which ucf 2>/dev/null`" ]; then + if [ -x "`command -v ucf`" ]; then ucf --purge "#UCFDEST#" fi - if [ -x "`which ucfr 2>/dev/null`" ]; then + if [ -x "`command -v ucfr`" ]; then ucfr --purge #PACKAGE# "#UCFDEST#" fi fi diff --git a/autoscripts/postrm-xfonts b/autoscripts/postrm-xfonts index cd476a3ddc42c5f550a8fd12dd85599266f474c4..57610dcd513a7341632857228fbccc7598151d3b 100644 --- a/autoscripts/postrm-xfonts +++ b/autoscripts/postrm-xfonts @@ -1,3 +1,3 @@ -if [ -x "`which update-fonts-dir 2>/dev/null`" ]; then +if [ -x "`command -v update-fonts-dir`" ]; then #CMDS# fi diff --git a/autoscripts/preinst-init-chmod b/autoscripts/preinst-init-chmod new file mode 100644 index 0000000000000000000000000000000000000000..4001b827e9a2632623b4d9ae983aa5edf74c0605 --- /dev/null +++ b/autoscripts/preinst-init-chmod @@ -0,0 +1,3 @@ +if [ "$1" = "install" ] && [ -n "$2" ] && [ -e "/etc/init.d/#SCRIPT#" ] ; then + chmod +x "/etc/init.d/#SCRIPT#" >/dev/null || true +fi diff --git a/autoscripts/preinst-init-stop b/autoscripts/preinst-init-stop new file mode 100644 index 0000000000000000000000000000000000000000..1cb017591d77ea3d07e0188538f76d8fd596469a --- /dev/null +++ b/autoscripts/preinst-init-stop @@ -0,0 +1,3 @@ +if [ -z "${DPKG_ROOT:-}" ] && [ "$1" = upgrade ] && [ -x "/etc/init.d/#SCRIPT#" ] ; then + invoke-rc.d #INVOKE_RCD_PARAMS##SCRIPT# stop || #ERROR_HANDLER# +fi diff --git a/autoscripts/preinst-systemd-stop b/autoscripts/preinst-systemd-stop new file mode 100644 index 0000000000000000000000000000000000000000..f4255100a464c892d184ec487f969b9a95e7419b --- /dev/null +++ b/autoscripts/preinst-systemd-stop @@ -0,0 +1,3 @@ +if [ -z "${DPKG_ROOT:-}" ] && [ "$1" = upgrade ] && [ -d /run/systemd/system ] ; then + deb-systemd-invoke stop #UNITFILES# >/dev/null || true +fi diff --git a/autoscripts/prerm-init b/autoscripts/prerm-init index f8707b9c5a203764dfcd809ba5158e9ce2c05d1d..94fbcf1835813638820566347751510f784d589d 100644 --- a/autoscripts/prerm-init +++ b/autoscripts/prerm-init @@ -1,3 +1,3 @@ -if [ -x "/etc/init.d/#SCRIPT#" ]; then +if [ -z "${DPKG_ROOT:-}" ] && [ -x "/etc/init.d/#SCRIPT#" ]; then invoke-rc.d #INVOKE_RCD_PARAMS##SCRIPT# stop || #ERROR_HANDLER# fi diff --git a/autoscripts/prerm-init-norestart b/autoscripts/prerm-init-norestart index 97f2174addd399be845aca0f4c73ee94fd4332ae..a9408ebe301b9d8d9cc21a2b8597236caba62c77 100644 --- a/autoscripts/prerm-init-norestart +++ b/autoscripts/prerm-init-norestart @@ -1,3 +1,3 @@ -if [ -x "/etc/init.d/#SCRIPT#" ] && [ "$1" = remove ]; then +if [ -z "${DPKG_ROOT:-}" ] && [ "$1" = remove ] && [ -x "/etc/init.d/#SCRIPT#" ] ; then invoke-rc.d #INVOKE_RCD_PARAMS##SCRIPT# stop || #ERROR_HANDLER# fi diff --git a/autoscripts/prerm-systemd b/autoscripts/prerm-systemd index d85223f75a1a6d8848a6d28664f8fcace358f044..2810349d308496446e0408920f73fccbe102a25f 100644 --- a/autoscripts/prerm-systemd +++ b/autoscripts/prerm-systemd @@ -1,3 +1,3 @@ -if [ -d /run/systemd/system ]; then +if [ -z "${DPKG_ROOT:-}" ] && [ -d /run/systemd/system ]; then deb-systemd-invoke stop #UNITFILES# >/dev/null || true fi diff --git a/autoscripts/prerm-systemd-restart b/autoscripts/prerm-systemd-restart index 13b0388e21053b154df966b917f3380021fc770f..17ee105a98dae9694b1fb6f1cc622de9c8923c46 100644 --- a/autoscripts/prerm-systemd-restart +++ b/autoscripts/prerm-systemd-restart @@ -1,3 +1,3 @@ -if [ -d /run/systemd/system ] && [ "$1" = remove ]; then +if [ -z "${DPKG_ROOT:-}" ] && [ "$1" = remove ] && [ -d /run/systemd/system ] ; then deb-systemd-invoke stop #UNITFILES# >/dev/null || true fi diff --git a/autoscripts/prerm-systemd-user-stop b/autoscripts/prerm-systemd-user-stop new file mode 100644 index 0000000000000000000000000000000000000000..beab3941328754a1de047d0d0e172e0b73cc2d78 --- /dev/null +++ b/autoscripts/prerm-systemd-user-stop @@ -0,0 +1,3 @@ +if [ -z "${DPKG_ROOT:-}" ] && [ "$1" = remove ] && [ -d /run/systemd/system ] ; then + deb-systemd-invoke --user stop #UNITFILES# >/dev/null || true +fi diff --git a/debhelper-compat-upgrade-checklist.pod b/debhelper-compat-upgrade-checklist.pod new file mode 100644 index 0000000000000000000000000000000000000000..c55b1bd77a7d1e25ac1fe1f3034a59900aa01500 --- /dev/null +++ b/debhelper-compat-upgrade-checklist.pod @@ -0,0 +1,775 @@ +=encoding UTF-8 + +=head1 NAME + +debhelper-compat-upgrade-checklist - Upgrade checklist for supported debhelper compat levels + +=head1 SYNOPSIS + +This document is an upgrade checklist of all the supported debhelper compat levels. It also +lists all the support debhelper compat levels. + +Information about how to declare the compat level is in L<debhelper(7)/COMPATIBILITY LEVELS>. + +If you are upgrading from a (now) obsolete compat level, then please refer to +L<debhelper-obsolete-compat(7)>. + +=head1 DESCRIPTION + +=head2 Upgrade checklist for supported compatibility levels + +These are the available compatibility levels: + +=over 4 + +=item v15 + +This compatibility level is still open for development; use with caution. + +Changes from v14 are: + +=over 8 + +=item - + +The B<dh_auto_install> tool no longer defaults to B<< --destdir=debian/I<package> >> +for source packages only producing a single binary. If this behaviour is wanted, +the package should explicitly activate the B<single-binary> dh addon (e.g., by adding +B<dh-sequence-single-binary> to B<Build-Depends>) or pass B<--destdir> to +B<dh_auto_install>. + +The rationale for this change to avoid "surprises" when adding a second binary package +later. Previously, debhelper would silently change behaviour often resulting in empty +binary packages being uploaded to the archive by mistake. With the new behaviour, +the B<single-binary> addon will detect the mismatch and warn the maintainer of what is +about to happen. + +=back + +=item v14 + +This compatibility level is still open for development; use with caution. + +Changes from v13 are: + +=over 8 + +=item - + +The B<cmake> buildsystem now passes +B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some +reproducibility issues. + +=item - + +The tool B<dh_installsysusers> is now included in the default sequence. This +helper tool will process systemd sysusers files. + +=item - + +Use of the B<dh_gconf> command in override and hook targets now causes +an error. The B<dh_gconf> command has been a no-op for years and was +removed in debhelper 13.4. + +=item - + +The B<dh> sequencer will warn if the B<single-binary> addon is implicitly activated to +warn maintainers of the pending compat 15 change in B<dh_auto_install>. + +Maintainers are urged to either explicitly activate the B<single-binary> addon to +preserve the existing behaviour (e.g., by adding B<dh-sequence-single-binary> to +Build-Depends), or explicitly passing B<--destdir> to B<dh_auto_install> if used and +then passing B<--without single-binary> to B<dh> (the latter to silence the warning). + +The rationale for this change to avoid "surprises" when adding a second binary package +later. Previously, debhelper would silently change behaviour often resulting in empty +binary packages being uploaded to the archive by mistake. With the new behaviour, +the B<single-binary> addon will detect the mismatch and warn the maintainer of what is +about to happen. + +=item - + +The B<dh_installalternatives> tool will now be run after B<dh_link> rather than after +B<dh_installinitramfs> in the default B<dh> sequence. + +=item - + +The B<dh_installpam> tool will now install PAM configuration files under +F<< /usr/lib/pam.d/I<package> >> instead of F<< /etc/pam.d/I<package> >>. + +Please consider using the "rm_conffile" feature from +L<dh_installdeb(1)> to ensure the proper removal of previous PAM files. + +=item - + +The B<meson+ninja> and B<cmake> build systems now use B<meson install> and +B<cmake --install>, respectively, instead of B<ninja install> and B<make install> +in the L<dh_auto_install(1)> call. Any override of B<dh_auto_install> that +passes extra parameters to the upstream build system should be reviewed. + +=back + +=item v13 + +This is the recommended mode of operation. + +Changes from v12 are: + +=over 8 + +=item - + +The B<meson+ninja> build system now uses B<meson test> instead of +B<ninja test> when running the test suite. Any override of +B<dh_auto_test> that passes extra parameters to upstream test runner +should be reviewed as B<meson test> is not command line compatible +with B<ninja test>. + +=item - + +All debhelper like tools based on the official debhelper library +(including B<dh> and the official B<dh_*> tools) no longer accepts +abbreviated command parameters. At the same time, B<dh> now +optimizes out calls to redundant B<dh_*> helpers even when passed +long command line options. + +=item - + +The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, +B<dh_makeshlibs>, B<dh_shlibdeps>) are now only run for arch dependent +packages by default (i.e. they are excluded from B<*-indep> targets +and are passed B<-a> by default). If you need them for B<*-indep> +targets, you can add an explicit Build-Depends on +B<dh-sequence-elf-tools>. + +=item - + +The third-party B<gradle> build system (from B<gradle-debian-helper> +package) now runs the upstream-provided test suite automatically. To +suppress such behavior, override B<dh_auto_test>. + +=item - + +The B<dh_installman> tool now aborts if it sees conflicting +definitions of a manpage. This typically happens if the upstream +build system is installing a compressed version and the package lists +an uncompressed version of the manpage in F<< +debian/I<package>.manpages >>. Often the easiest fix is to remove the +manpage from F<< debian/I<package>.manpages >> (assuming both versions +are identical). + +=item - + +The B<dh_auto_*> helpers now reset the environment variables B<HOME> +and common B<XDG_*> variable. Please see description of the +environment variables in L</ENVIRONMENT> for how this is handled. + +I<This feature changed between debhelper 13 and debhelper 13.2.> + +=item - + +The B<dh> command will now error if an override or hook target for an +obsolete command are present in F<debian/rules> +(e.g. B<override_dh_systemd_enable:>). + +=item - + +The B<dh_missing> command will now default to B<--fail-missing>. This +can be reverted to a non-fatal warning by explicitly passing +B<--list-missing> like it was in compat 12. + +If you do not want the warning either, please omit the call to +B<dh_missing>. If you use the B<dh> command sequencer, then you can +do this by inserting an empty override target in the +F<debian/rules> file of the relevant package. As an example: + + # Disable dh_missing + override_dh_missing: + +=item - + +The B<dh> command sequencer now runs B<dh_installtmpfiles> in the +default sequence. The B<dh_installtmpfiles> takes over handling of +tmpfiles.d configuration files. Related functionality in +B<dh_installsystemd> is now disabled. + +Note that B<dh_installtmpfiles> responds to +F<< debian/I<package>.tmpfiles >> where B<dh_installsystemd> used +a name without the trailing "s". + +=item - + +Many B<dh_*> tools now support limited variable expansion via the +B<${foo}> syntax. In many cases, this can be used to reference paths +that contain either spaces or L<dpkg-architecture(1)> values. While +this can reduce the need for L<dh-exec(1)> in some cases, it is B<not> +a replacement L<dh-exec(1)> in general. If you need filtering, +renaming, etc., the package will still need L<dh-exec(1)>. + +Please see L</Substitutions in debhelper config files> for syntax and +available substitution variables. To B<dh_*> tool writers, substitution +expansion occurs as a part of the B<filearray> and B<filedoublearray> +functions. + +=item - + +The B<dh> command sequencer will now skip all hook and override targets +for B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> +lists the relevant B<nocheck> / B<nostrip> options. + +Any package relying on these targets to always be run should instead +move relevant logic out of those targets. E.g. non-test related +packaging code from B<override_dh_auto_test> would have to be moved to +B<execute_after_dh_auto_build> or B<execute_before_dh_auto_install>. + +=item - + +The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> +to L<cmake(1)> to speed up automatic installation process. If for some reason +you need previous behavior, override the flag: + + dh_auto_configure -- -DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ... + +=back + +=item v12 + +Changes from v11 are: + +=over 8 + +=item - + +The B<dh_makeshlibs> tool now generates shlibs files with versioned +dependency by default. This means that B<-VUpstream-Version> +(a.k.a. B<-V>) is now the default. + +If an unversioned dependency in the shlibs file is wanted, this can be +obtained by passing B<-VNone> instead. However, please see +L<dh_makeshlibs(1)> for the caveat of unversioned dependencies. + +=item - + +The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) instead. + +=item - + +Invoking B<dh_clean -k> now causes an error instead of a deprecation +warning. + +=item - + +The B<--no-restart-on-upgrade> option in B<dh_installinit> has been removed. +Please use the new name B<--no-stop-on-upgrade> + +=item - + +There was a bug in the B<doit> (and similar) functions from +L<Debian::Debhelper::Dh_Lib> that made them spawn a shell in one +particular circumstance. This bug is now removed and will cause +helpers that rely on the bug to fail with a "command not found"-error. + +=item - + +The B<--list-missing> and B<--fail-missing> in B<dh_install> has been +removed. Please use B<dh_missing> and its corresponding options, +which can also see the files installed by other helpers. + +=item - + +The B<dh_installinit> helper no longer installs configuration for +the upstart init system. Instead, it will abort the build if it +finds an old upstart configuration file. The error is there to +remind the package maintainer to ensure the proper removal of the +conffiles shipped in previous versions of the package (if any). + +=item - + +The B<dh_installdeb> tool will do basic validation of some +L<dpkg-maintscript-helper(1)> commands and will error out if the +commands appear to be invalid. + +=item - + +The B<dh_missing> tool will now default to B<--list-missing>. + +=item - + +The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-gensymbols(1)> +if the ELF binary has a SONAME (containing ".so"). + +=item - + +The B<dh_compress> tool no longer compresses examples (i.e. anything installed +in F<</usr/share/doc/I<package>/examples>>.) + +=item - + +The standard sequence in B<dh> now includes B<dh_dwz> and +B<dh_installinitramfs> by default. This makes the B<dwz> and +B<installinitramfs> sequences obsolete and they will now fail with an +error. If you want to skip these commands, then please insert an +empty override target for them in F<debian/rules> +(e.g. I<override_dh_dwz:>) + +=item - + +The build systems B<meson> and B<autoconf> no longer explicitly set +the B<--libexecdir> variable and thus relies on the build system +default - which should be B</usr/libexec> (per FHS 3.0, adopted in +Debian Policy 4.1.5). + +If a particular upstream package does not use the correct default, the +parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. +via the following example: + + override_dh_auto_configure: + dh_auto_configure -- --libexecdir=/usr/libexec + +Note the B<--> before the B<--libexecdir> parameter. + +=item - + +B<Retroactively removed in debhelper/13.5>: + +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+. + +=item - + +The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for +handling systemd services that have a sysvinit alternative. Both tools +must now be used in such a case to ensure the service is properly started +under both sysvinit and systemd. + +If you have an override for B<dh_installinit> (e.g. to call it with +B<--no-start>) then you will probably need one for +B<dh_installsystemd> as well now. + +This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for +B<< init-system-helpers (>= 1.54~) >>. Please ensure that the package +lists B<${misc:Pre-Depends}> in its B<Pre-Depends> field before +upgrading to compat 12. + +=item - + +The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults on +honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev +packages and not only during the building process. Please set +B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See +B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples. + +=item - + +B<dh_installsystemduser> is now included in the B<dh> standard +sequence by default. + +=item - + +The B<python-distutils> buildsystem is now removed. Please use the +third-party build system B<pybuild> instead. + +=back + +=item v11 + +This mode is discouraged. + +The compat 11 is discouraged for new packages as it suffers from +feature interaction between L<dh_installinit> and L<dh_installsystemd> +causing services to not run correctly in some cases. Please consider +using compatibility mode 10 or 12 instead. More details about the +issue are available in Debian#887904 and +L<https://lists.debian.org/debian-release/2019/04/msg01442.html>. + +Changes from v10 are: + +=over 8 + +=item - + +B<dh_installinit> no longer installs F<service> or F<tmpfile> files, +nor generates maintainer scripts for those files. Please use the new +B<dh_installsystemd> helper. + +=item - + +The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been +replaced by the new B<dh_installsystemd> helper. For the same reason, +the B<systemd> sequence for B<dh> has also been removed. If you need +to disable the B<dh_installsystemd> helper tool, please use an empty +override target. + +Please note that the B<dh_installsystemd> tool has a slightly +different behaviour in some cases (e.g. when using the B<--name> +parameter). + +=item - + +B<dh_installdirs> no longer creates debian/I<package> directories +unless explicitly requested (or it has to create a subdirectory in +it). + +The vast majority of all packages will be unaffected by this change. + +=item - + +The B<makefile> buildsystem now passes B<INSTALL="install +--strip-program=true"> to L<make(1)>. Derivative buildsystems +(e.g. B<configure> or B<cmake>) are unaffected by this change. + +=item - + +The B<autoconf> buildsystem now passes B<--runstatedir=/run> to +F<./configure>. + +=item - + +The B<cmake> buildsystem now passes +B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to L<cmake(1)>. + +=item - + +B<dh_installman> will now prefer detecting the language from the +path name rather than the extension. + +=item - + +B<dh_auto_install> will now only create the destination +directory it needs. Previously, it would create the package build +directory for all packages. This will not affect packages that only +build with debhelper commands, but it may expose bugs in commands not +included in debhelper. + +=item - + +The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, +and B<dh_installman> now error out if their config has a pattern that +does not match anything or reference a path that does not exist. + +Known exceptions include building with the B<nodoc> profile, where the +above tools will silently permit failed matches where the patterns +are used to specify documentation. + +=item - + +The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, +and B<dh_installman> now accept the parameter B<--sourcedir> with same +meaning as B<dh_install>. Furthermore, they now also fall back to +F<debian/tmp> like B<dh_install>. + +Migration note: A bug in debhelper 11 up to 11.1.5 made +B<dh_installinfo> incorrectly ignore B<--sourcedir>. + +=item - + +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). + +=item - + +The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by +B<dh> or any of the B<dh_auto_*> tools. It was added as a temporary +work around to avoid a lot of packages failing to build at the same +time. + +Note this item will eventually become obsolete as upstream intends +to drop support for the B<PERL_USE_UNSAFE_INC> environment variable. +When perl drops support for it, then this variable will be removed +retroactively from existing compat levels as well. + +=item - + +The B<dh_makeshlibs> helper will now exit with an error if objdump +returns a non-zero exit from analysing a given file. + +=item - + +The B<dh_installdocs> and B<dh_installexamples> tools may now install +I<most> of the documentation in a different path to comply with the +recommendation from Debian policy §12.3 (since version 3.9.7). + +Note that if a given source package only contains a single binary +package in F<debian/control> or none of the packages are I<-doc> +packages, then this change is not relevant for that source package and +you can skip to the next change. + +By default, these tools will now attempt to determine a "main package +for the documentation" (called a I<doc-main-package> from here on) for +every I<-doc> package. If they find such a I<doc-main-package>, they +will now install the documentation into the path F<< +/usr/share/doc/I<doc-main-package> >> in the given doc package. +I.e. the path can change but the documentation is still shipped in the +I<-doc> package. + +The B<--doc-main-package> option can be used when the auto-detection +is insufficient or to reset the path to its previous value if there is +a reason to diverge from Debian policy recommendation. + +Some documentation will not be affected by this change. These +exceptions include the copyright file, changelog files, README.Debian, +etc. These files will still be installed in the path F<< +/usr/share/doc/I<package> >>. + +=item - + +The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename +patterns to determine which files to process. Instead, they open the +file and look for an ELF header to determine if a given file is an +shared object or an ELF executable. + +This change may cause the tools to process more files than previously. + +=back + +=item v10 + +Changes from v9 are: + +=over 8 + +=item - + +B<dh_installinit> will no longer install a file named debian/I<package> +as an init script. + +=item - + +B<dh_installdocs> will error out if it detects links created with +--link-doc between packages of architecture "all" and non-"all" as it +breaks binNMUs. + +=item - + +B<dh_installdeb> no longer installs a maintainer-provided +debian/I<package>.shlibs file. This is now done by B<dh_makeshlibs> +instead. + +=item - + +B<dh_installwm> refuses to create a broken package if no man page +can be found (required to register for the x-window-manager alternative). + +=item - + +Debhelper will default to B<--parallel> for all buildsystems that +support parallel building. This can be disabled by using either +B<--no-parallel> or passing B<--max-parallel> with a value of 1. + +=item - + +The B<dh> command will not accept any of the deprecated "manual +sequence control" parameters (B<--before>, B<--after>, etc.). Please +use override targets instead. + +B<Retroactively applied to earlier compat levels>: B<dh> no longer +accepts any of these since debhelper/12.4. + +=item - + +The B<dh> command will no longer use log files to track which commands +have been run. The B<dh> command I<still> keeps track of whether it +already ran the "build" sequence and skip it if it did. + +The main effects of this are: + +=over 4 + +=item - + +With this, it is now easier to debug the I<install> or/and I<binary> +sequences because they can now trivially be re-run (without having to +do a full "clean and rebuild" cycle) + +=item - + +The main caveat is that B<dh_*> now only keeps track of what happened +in a single override target. When all the calls to a given B<dh_cmd> +command happens in the same override target everything will work as +before. + +Example of where it can go wrong: + + override_dh_foo: + dh_foo -pmy-pkg + + override_dh_bar: + dh_bar + dh_foo --remaining + +In this case, the call to B<dh_foo --remaining> will I<also> include +I<my-pkg>, since B<dh_foo -pmy-pkg> was run in a separate override +target. This issue is not limited to B<--remaining>, but also includes +B<-a>, B<-i>, etc. + +=back + +=item - + +The B<dh_installdeb> command now shell-escapes the lines in the +F<maintscript> config file. This was the original intent but it did +not work properly and packages have begun to rely on the incomplete +shell escaping (e.g. quoting file names). + +=item - + +The B<dh_installinit> command now defaults to +B<--restart-after-upgrade>. For packages needing the previous +behaviour, please use B<--no-restart-after-upgrade>. + +=item - + +The B<autoreconf> sequence is now enabled by default. Please pass +B<--without autoreconf> to B<dh> if this is not desirable for a given +package + +=item - + +The B<systemd> sequence is now enabled by default. Please pass +B<--without systemd> to B<dh> if this is not desirable for a given +package. + +=item - + +B<Retroactively removed>: B<dh> no longer creates the package build +directory when skipping running debhelper commands. This will not +affect packages that only build with debhelper commands, but it may +expose bugs in commands not included in debhelper. + +This compatibility feature had a bug since its inception in +debhelper/9.20130516 that made it fail to apply in compat 9 and +earlier. As there has been no reports of issues caused by this bug in +those ~5 years, this item have been removed rather than fixed. + +=back + +=item v9 + +Changes from v8 are: + +=over 8 + +=item - + +Multiarch support. In particular, B<dh_auto_configure> passes +multiarch directories to autoconf in --libdir and --libexecdir. + +=item - + +dh is aware of the usual dependencies between targets in debian/rules. +So, "dh binary" will run any build, build-arch, build-indep, install, +etc targets that exist in the rules file. There's no need to define an +explicit binary target with explicit dependencies on the other targets. + +=item - + +B<dh_strip> compresses debugging symbol files to reduce the installed +size of -dbg packages. + +=item - + +B<dh_auto_configure> does not include the source package name +in --libexecdir when using autoconf. + +=item - + +B<dh> does not default to enabling --with=python-support + +(Obsolete: As the B<dh_pysupport> tool was removed from Debian +stretch. Since debhelper/10.3, B<dh> no longer enables this sequence +add-on regardless of compat level) + +=item - + +All of the B<dh_auto_>I<*> debhelper programs and B<dh> set +environment variables listed by B<dpkg-buildflags>, unless +they are already set. + +=item - + +B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and +LDFLAGS to perl F<Makefile.PL> and F<Build.PL> + +=item - + +B<dh_strip> puts separated debug symbols in a location based on their +build-id. + +=item - + +Executable debhelper config files are run and their output used as the +configuration. + +=back + +This mode is deprecated. + +=item v8 + +Changes from v7 are: + +=over 8 + +=item - + +Commands will fail rather than warning when they are passed unknown options. + +=item - + +B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it +generates shlibs files for. So B<-X> can be used to exclude libraries. +Also, libraries in unusual locations that B<dpkg-gensymbols> would not +have processed before will be passed to it, a behavior change that +can cause some packages to fail to build. + +=item - + +B<dh> requires the sequence to run be specified as the first parameter, and +any switches come after it. Ie, use "B<dh $@ --foo>", not "B<dh --foo $@>". + +=item - + +B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to F<Makefile.PL>. + +=back + +This mode is deprecated. + +=item v7 + +This mode is deprecated. + +This is the lowest supported compatibility level. + +If you are upgrading from an earlier compatibility level, please +review L<debhelper-obsolete-compat(7)>. + +=back + +=head1 SEE ALSO + +=over 4 + +=item L<debhelper-obsolete-compat(7)> + +Upgrading from a (now) obsolete compatibility level? This document covers the +upgrade checklist up to the earliest supported level. + +=item L<debhelper(7)> + +General information about the debhelper framework. This document also covers +how to declare your chosen debhelper compat level. + +=back + +=head1 AUTHORS + +Niels Thykier <niels@thykier.net> + +Joey Hess + +=cut diff --git a/debhelper-obsolete-compat.pod b/debhelper-obsolete-compat.pod index 4c98ac3ee38f495c5769164d0f7dedfd2d10589e..965c89474c0dcc075f8450d5beee7a6fb7e734b7 100644 --- a/debhelper-obsolete-compat.pod +++ b/debhelper-obsolete-compat.pod @@ -18,45 +18,93 @@ changes. =over 4 -=item v1 +=item v7 -This is the original debhelper compatibility level, and so it is the default -one. In this mode, debhelper will use F<debian/tmp> as the package tree -directory for the first binary package listed in the control file, while using -debian/I<package> for all other packages listed in the F<control> file. +This is the lowest supported compatibility level. -This mode is deprecated. +Changes from v6 are: -=item v2 +=over 8 -In this mode, debhelper will consistently use debian/I<package> -as the package tree directory for every package that is built. +=item - -This mode is deprecated. +B<dh_install>, will fall back to looking for files in F<debian/tmp> if it doesn't +find them in the current directory (or wherever you tell it look using +B<--sourcedir>). This allows B<dh_install> to interoperate with B<dh_auto_install>, +which installs to F<debian/tmp>, without needing any special parameters. -=item v3 +=item - -This mode works like v2, with the following additions: +B<dh_clean> will read F<debian/clean> and delete files listed there. + +=item - + +B<dh_clean> will delete toplevel F<*-stamp> files. + +=item - + +B<dh_installchangelogs> will guess at what file is the upstream changelog if +none is specified. + +=back + +=item v6 + +Changes from v5 are: =over 8 =item - -Debhelper config files support globbing via B<*> and B<?>, when appropriate. To -turn this off and use those characters raw, just prefix with a backslash. +Commands that generate maintainer script fragments will order the +fragments in reverse order for the F<prerm> and F<postrm> scripts. =item - -B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call B<ldconfig>. +B<dh_installwm> will install a slave manpage link for F<x-window-manager.1.gz>, +if it sees the man page in F<usr/share/man/man1> in the package build +directory. =item - -Every file in F<etc/> is automatically flagged as a conffile by B<dh_installdeb>. +B<dh_builddeb> did not previously delete everything matching +B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as +B<CVS:.svn:.git>. Now it does. + +=item - + +B<dh_installman> allows overwriting existing man pages in the package build +directory. In previous compatibility levels it silently refuses to do this. =back This mode is deprecated. +=item v5 + +Changes from v4 are: + +=over 8 + +=item - + +Comments are ignored in debhelper config files. + +=item - + +B<dh_strip --dbg-package> now specifies the name of a package to put debugging +symbols in, not the packages to take the symbols from. + +=item - + +B<dh_installdocs> skips installing empty files. + +=item - + +B<dh_install> errors out if wildcards expand to nothing. + +=back + =item v4 Changes from v3 are: @@ -86,32 +134,44 @@ B<dh_link> will correct existing links to conform with policy. This mode is deprecated. -=item v5 - -This is the lowest supported compatibility level. +=item v3 -Changes from v4 are: +This mode works like v2, with the following additions: =over 8 =item - -Comments are ignored in debhelper config files. +Debhelper config files support globbing via B<*> and B<?>, when appropriate. To +turn this off and use those characters raw, just prefix with a backslash. =item - -B<dh_strip --dbg-package> now specifies the name of a package to put debugging -symbols in, not the packages to take the symbols from. +B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call B<ldconfig>. =item - -B<dh_installdocs> skips installing empty files. +Every file in F<etc/> is automatically flagged as a conffile by B<dh_installdeb>. -=item - +=back -B<dh_install> errors out if wildcards expand to nothing. +This mode is deprecated. -=back +=item v2 + +In this mode, debhelper will consistently use debian/I<package> +as the package tree directory for every package that is built. + +This mode is deprecated. + +=item v1 + +This is the original debhelper compatibility level, and so it is the default +one. In this mode, debhelper will use F<debian/tmp> as the package tree +directory for the first binary package listed in the control file, while using +debian/I<package> for all other packages listed in the F<control> file. + +This mode is deprecated. =back diff --git a/debhelper.pod b/debhelper.pod index 9b00ec7ea8df405a498e77fc72dc9ba66156a6a6..29a37f7f4ac59ad6e2bb6714c69fc6aa2fc346ef 100644 --- a/debhelper.pod +++ b/debhelper.pod @@ -274,7 +274,10 @@ The following command line options are supported by all debhelper programs. =item B<-v>, B<--verbose> -Verbose mode: show all commands that modify the package build directory. +Verbose mode: show commands that modify the package build directory. + +Note that verbose mode may also output other "internal" commands that do not +directly affect the package build directory. =item B<--no-act> @@ -432,8 +435,8 @@ B<--no-parallel>. =item B<--reload-all-buildenv-variables> -By default, L<dh(1)> will compute several environment (e.g. by using -L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> +By default, L<dh(1)> will compute several environment variables (e.g. by +using L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> tool recompute them. When passing this option, the concrete B<dh_auto_*> tool will ignore @@ -475,7 +478,7 @@ is manually specified with the B<--buildsystem> option. From time to time, major non-backwards-compatible changes need to be made to debhelper, to keep it clean and well-designed as needs change and its author gains more experience. To prevent such major changes from breaking -existing packages, the concept of debhelper compatibility levels was +existing packages, the concept of debhelper compatibility levels was introduced. You must tell debhelper which compatibility level it should use, and it modifies its behavior in various ways. @@ -493,12 +496,11 @@ bugfix within a compatibility level). Note that debhelper does not provide debhelper-compat for experimental or beta compatibility levels; packages experimenting with those compatibility levels -should use F<debian/compat> or B<DH_COMPAT>. +should use F<debian/compat> (or, if only for selected commands, B<DH_COMPAT>). Prior versions of debhelper required specifying the compatibility level in the file F<debian/compat>, and current debhelper still supports this for backward -compatibility, though a package may not specify a compatibility level via -multiple methods at once. To use this method, F<debian/compat> should contain +compatibility. To use this method, the F<debian/compat> file should contain the compatibility level as a single number, and no other content. If you specify the compatibility level by this method, your package will also need a versioned build dependency on a version of the debhelper package equal to (or @@ -508,6 +510,18 @@ F<debian/control> has: Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#~) +Note that you must use either the build-dependency on debhelper-compat or +the F<debian/compat> file. Whenever possible, the debhelper-compat +build-dependency is recommended. + +If needed be, the B<DH_COMPAT> environment variable can be used to override +the compat level for a given command. The feature is mostly useful for +either temporarily upgrading a few commands to a new compat level or +keeping a few commands on a lower compat level. The feature is best used +sparingly as it effectively introduces special-cases into the +F<debian/rules> file that may be surprising to maintainers or reviewers +(or, in the long term, to yourself). + Unless otherwise indicated, all debhelper documentation assumes that you are using the most recent compatibility level, and in most cases does not indicate if the behavior is different in an earlier compatibility level, so @@ -517,738 +531,8 @@ levels. =head2 Supported compatibility levels -These are the available compatibility levels: - -=over 4 - -=item v5 - -This is the lowest supported compatibility level. - -If you are upgrading from an earlier compatibility level, please -review L<debhelper-obsolete-compat(7)>. - -This mode is deprecated. - -=item v6 - -Changes from v5 are: - -=over 8 - -=item - - -Commands that generate maintainer script fragments will order the -fragments in reverse order for the F<prerm> and F<postrm> scripts. - -=item - - -B<dh_installwm> will install a slave manpage link for F<x-window-manager.1.gz>, -if it sees the man page in F<usr/share/man/man1> in the package build -directory. - -=item - - -B<dh_builddeb> did not previously delete everything matching -B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as -B<CVS:.svn:.git>. Now it does. - -=item - - -B<dh_installman> allows overwriting existing man pages in the package build -directory. In previous compatibility levels it silently refuses to do this. - -=back - -This mode is deprecated. - -=item v7 - -Changes from v6 are: - -=over 8 - -=item - - -B<dh_install>, will fall back to looking for files in F<debian/tmp> if it doesn't -find them in the current directory (or wherever you tell it look using -B<--sourcedir>). This allows B<dh_install> to interoperate with B<dh_auto_install>, -which installs to F<debian/tmp>, without needing any special parameters. - -=item - - -B<dh_clean> will read F<debian/clean> and delete files listed there. - -=item - - -B<dh_clean> will delete toplevel F<*-stamp> files. - -=item - - -B<dh_installchangelogs> will guess at what file is the upstream changelog if -none is specified. - -=back - -This mode is deprecated. - -=item v8 - -Changes from v7 are: - -=over 8 - -=item - - -Commands will fail rather than warning when they are passed unknown options. - -=item - - -B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it -generates shlibs files for. So B<-X> can be used to exclude libraries. -Also, libraries in unusual locations that B<dpkg-gensymbols> would not -have processed before will be passed to it, a behavior change that -can cause some packages to fail to build. - -=item - - -B<dh> requires the sequence to run be specified as the first parameter, and -any switches come after it. Ie, use "B<dh $@ --foo>", not "B<dh --foo $@>". - -=item - - -B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to F<Makefile.PL>. - -=back - -This mode is deprecated. - -=item v9 - -Changes from v8 are: - -=over 8 - -=item - - -Multiarch support. In particular, B<dh_auto_configure> passes -multiarch directories to autoconf in --libdir and --libexecdir. - -=item - - -dh is aware of the usual dependencies between targets in debian/rules. -So, "dh binary" will run any build, build-arch, build-indep, install, -etc targets that exist in the rules file. There's no need to define an -explicit binary target with explicit dependencies on the other targets. - -=item - - -B<dh_strip> compresses debugging symbol files to reduce the installed -size of -dbg packages. - -=item - - -B<dh_auto_configure> does not include the source package name -in --libexecdir when using autoconf. - -=item - - -B<dh> does not default to enabling --with=python-support - -(Obsolete: As the B<dh_pysupport> tool was removed from Debian -stretch. Since debhelper/10.3, B<dh> no longer enables this sequence -add-on regardless of compat level) - -=item - - -All of the B<dh_auto_>I<*> debhelper programs and B<dh> set -environment variables listed by B<dpkg-buildflags>, unless -they are already set. - -=item - - -B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and -LDFLAGS to perl F<Makefile.PL> and F<Build.PL> - -=item - - -B<dh_strip> puts separated debug symbols in a location based on their -build-id. - -=item - - -Executable debhelper config files are run and their output used as the -configuration. - -=back - -This mode is deprecated. - -=item v10 - -Changes from v9 are: - -=over 8 - -=item - - -B<dh_installinit> will no longer install a file named debian/I<package> -as an init script. - -=item - - -B<dh_installdocs> will error out if it detects links created with ---link-doc between packages of architecture "all" and non-"all" as it -breaks binNMUs. - -=item - - -B<dh_installdeb> no longer installs a maintainer-provided -debian/I<package>.shlibs file. This is now done by B<dh_makeshlibs> -instead. - -=item - - -B<dh_installwm> refuses to create a broken package if no man page -can be found (required to register for the x-window-manager alternative). - -=item - - -Debhelper will default to B<--parallel> for all buildsystems that -support parallel building. This can be disabled by using either -B<--no-parallel> or passing B<--max-parallel> with a value of 1. - -=item - - -The B<dh> command will not accept any of the deprecated "manual -sequence control" parameters (B<--before>, B<--after>, etc.). Please -use override targets instead. - -B<Retroactively applied to earlier compat levels>: B<dh> no longer -accepts any of these since debhelper/12.4. - -=item - - -The B<dh> command will no longer use log files to track which commands -have been run. The B<dh> command I<still> keeps track of whether it -already ran the "build" sequence and skip it if it did. - -The main effects of this are: - -=over 4 - -=item - - -With this, it is now easier to debug the I<install> or/and I<binary> -sequences because they can now trivially be re-run (without having to -do a full "clean and rebuild" cycle) - -=item - - -The main caveat is that B<dh_*> now only keeps track of what happened -in a single override target. When all the calls to a given B<dh_cmd> -command happens in the same override target everything will work as -before. - -Example of where it can go wrong: - - override_dh_foo: - dh_foo -pmy-pkg - - override_dh_bar: - dh_bar - dh_foo --remaining - -In this case, the call to B<dh_foo --remaining> will I<also> include -I<my-pkg>, since B<dh_foo -pmy-pkg> was run in a separate override -target. This issue is not limited to B<--remaining>, but also includes -B<-a>, B<-i>, etc. - -=back - -=item - - -The B<dh_installdeb> command now shell-escapes the lines in the -F<maintscript> config file. This was the original intent but it did -not work properly and packages have begun to rely on the incomplete -shell escaping (e.g. quoting file names). - -=item - - -The B<dh_installinit> command now defaults to -B<--restart-after-upgrade>. For packages needing the previous -behaviour, please use B<--no-restart-after-upgrade>. - -=item - - -The B<autoreconf> sequence is now enabled by default. Please pass -B<--without autoreconf> to B<dh> if this is not desirable for a given -package - -=item - - -The B<systemd> sequence is now enabled by default. Please pass -B<--without systemd> to B<dh> if this is not desirable for a given -package. - -=item - - -B<Retroactively removed>: B<dh> no longer creates the package build -directory when skipping running debhelper commands. This will not -affect packages that only build with debhelper commands, but it may -expose bugs in commands not included in debhelper. - -This compatibility feature had a bug since its inception in -debhelper/9.20130516 that made it fail to apply in compat 9 and -earlier. As there has been no reports of issues caused by this bug in -those ~5 years, this item have been removed rather than fixed. - -=back - -=item v11 - -This mode is discouraged. - -The compat 11 is discouraged for new packages as it suffers from -feature interaction between L<dh_installinit> and L<dh_installsystemd> -causing services to not run correctly in some cases. Please consider -using compatibility mode 10 or 12 instead. More details about the -issue are available in Debian#887904 and -L<https://lists.debian.org/debian-release/2019/04/msg01442.html>. - -Changes from v10 are: - -=over 8 - -=item - - -B<dh_installinit> no longer installs F<service> or F<tmpfile> files, -nor generates maintainer scripts for those files. Please use the new -B<dh_installsystemd> helper. - -=item - - -The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been -replaced by the new B<dh_installsystemd> helper. For the same reason, -the B<systemd> sequence for B<dh> has also been removed. If you need -to disable the B<dh_installsystemd> helper tool, please use an empty -override target. - -Please note that the B<dh_installsystemd> tool has a slightly -different behaviour in some cases (e.g. when using the B<--name> -parameter). - -=item - - -B<dh_installdirs> no longer creates debian/I<package> directories -unless explicitly requested (or it has to create a subdirectory in -it). - -The vast majority of all packages will be unaffected by this change. - -=item - - -The B<makefile> buildsystem now passes B<INSTALL="install ---strip-program=true"> to L<make(1)>. Derivative buildsystems -(e.g. B<configure> or B<cmake>) are unaffected by this change. - -=item - - -The B<autoconf> buildsystem now passes B<--runstatedir=/run> to -F<./configure>. - -=item - - -The B<cmake> buildsystem now passes -B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to L<cmake(1)>. - -=item - - -B<dh_installman> will now prefer detecting the language from the -path name rather than the extension. - -=item - - -B<dh_auto_install> will now only create the destination -directory it needs. Previously, it would create the package build -directory for all packages. This will not affect packages that only -build with debhelper commands, but it may expose bugs in commands not -included in debhelper. - -=item - - -The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, -and B<dh_installman> now error out if their config has a pattern that -does not match anything or reference a path that does not exist. - -Known exceptions include building with the B<nodoc> profile, where the -above tools will silently permit failed matches where the patterns -are used to specify documentation. - -=item - - -The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, -and B<dh_installman> now accept the parameter B<--sourcedir> with same -meaning as B<dh_install>. Furthermore, they now also fall back to -F<debian/tmp> like B<dh_install>. - -Migration note: A bug in debhelper 11 up to 11.1.5 made -B<dh_installinfo> incorrectly ignore B<--sourcedir>. - -=item - - -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). - -=item - - -The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by -B<dh> or any of the B<dh_auto_*> tools. It was added as a temporary -work around to avoid a lot of packages failing to build at the same -time. - -Note this item will eventually become obsolete as upstream intends -to drop support for the B<PERL_USE_UNSAFE_INC> environment variable. -When perl drops support for it, then this variable will be removed -retroactively from existing compat levels as well. - -=item - - -The B<dh_makeshlibs> helper will now exit with an error if objdump -returns a non-zero exit from analysing a given file. - -=item - - -The B<dh_installdocs> and B<dh_installexamples> tools may now install -I<most> of the documentation in a different path to comply with the -recommendation from Debian policy §12.3 (since version 3.9.7). - -Note that if a given source package only contains a single binary -package in F<debian/control> or none of the packages are I<-doc> -packages, then this change is not relevant for that source package and -you can skip to the next change. - -By default, these tools will now attempt to determine a "main package -for the documentation" (called a I<doc-main-package> from here on) for -every I<-doc> package. If they find such a I<doc-main-package>, they -will now install the documentation into the path F<< -/usr/share/doc/I<doc-main-package> >> in the given doc package. -I.e. the path can change but the documentation is still shipped in the -I<-doc> package. - -The B<--doc-main-package> option can be used when the auto-detection -is insufficient or to reset the path to its previous value if there is -a reason to diverge from Debian policy recommendation. - -Some documentation will not be affected by this change. These -exceptions include the copyright file, changelog files, README.Debian, -etc. These files will still be installed in the path F<< -/usr/share/doc/I<package> >>. - -=item - - -The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename -patterns to determine which files to process. Instead, they open the -file and look for an ELF header to determine if a given file is an -shared object or an ELF executable. - -This change may cause the tools to process more files than previously. - -=back - -=item v12 - -Changes from v11 are: - -=over 8 - -=item - - -The B<dh_makeshlibs> tool now generates shlibs files with versioned -dependency by default. This means that B<-VUpstream-Version> -(a.k.a. B<-V>) is now the default. - -If an unversioned dependency in the shlibs file is wanted, this can be -obtained by passing B<-VNone> instead. However, please see -L<dh_makeshlibs(1)> for the caveat of unversioned dependencies. - -=item - - -The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) instead. - -=item - - -Invoking B<dh_clean -k> now causes an error instead of a deprecation -warning. - -=item - - -The B<--no-restart-on-upgrade> option in B<dh_installinit> has been removed. -Please use the new name B<--no-stop-on-upgrade> - -=item - - -There was a bug in the B<doit> (and similar) functions from -L<Debian::Debhelper::Dh_Lib> that made them spawn a shell in one -particular circumstance. This bug is now removed and will cause -helpers that rely on the bug to fail with a "command not found"-error. - -=item - - -The B<--list-missing> and B<--fail-missing> in B<dh_install> has been -removed. Please use B<dh_missing> and its corresponding options, -which can also see the files installed by other helpers. - -=item - - -The B<dh_installinit> helper no longer installs configuration for -the upstart init system. Instead, it will abort the build if it -finds an old upstart configuration file. The error is there to -remind the package maintainer to ensure the proper removal of the -conffiles shipped in previous versions of the package (if any). - -=item - - -The B<dh_installdeb> tool will do basic validation of some -L<dpkg-maintscript-helper(1)> commands and will error out if the -commands appear to be invalid. - -=item - - -The B<dh_missing> tool will now default to B<--list-missing>. - -=item - - -The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-gensymbols(1)> -if the ELF binary has a SONAME (containing ".so"). - -=item - - -The B<dh_compress> tool no longer compresses examples (i.e. anything installed -in F<</usr/share/doc/I<package>/examples>>.) - -=item - - -The standard sequence in B<dh> now includes B<dh_dwz> and -B<dh_installinitramfs> by default. This makes the B<dwz> and -B<installinitramfs> sequences obsolete and they will now fail with an -error. If you want to skip these commands, then please insert an -empty override target for them in F<debian/rules> -(e.g. I<override_dh_dwz:>) - -=item - - -The build systems B<meson> and B<autoconf> no longer explicitly set -the B<--libexecdir> variable and thus relies on the build system -default - which should be B</usr/libexec> (per FHS 3.0, adopted in -Debian Policy 4.1.5). - -If a particular upstream package does not use the correct default, the -parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. -via the following example: - - override_dh_auto_configure: - dh_auto_configure -- --libexecdir=/usr/libexec - -Note the B<--> before the B<--libexecdir> parameter. - -=item - - -The B<dh_installdeb> tool no longer installs the maintainer provided -F<conffiles> file. The file has mostly been obsolete since -compatibility level 3, where B<dh_installdeb> began to automatically -compute the resulting F<conffiles> control file. - -=item - - -The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for -handling systemd services that have a sysvinit alternative. Both tools -must now be used in such a case to ensure the service is properly started -under both sysvinit and systemd. - -If you have an override for B<dh_installinit> (e.g. to call it with -B<--no-start>) then you will probably need one for -B<dh_installsystemd> as well now. - -This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for -B<< init-system-helpers (>= 1.54~) >>. Please ensure that the package -lists B<${misc:Pre-Depends}> in its B<Pre-Depends> field before -upgrading to compat 12. - -=item - - -The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults on -honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev -packages and not only during the building process. Please set -B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See -B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples. - -=item - - -B<dh_installsystemduser> is now included in the B<dh> standard -sequence by default. - -=item - - -The B<python-distutils> buildsystem is now removed. Please use the -third-party build system B<pybuild> instead. - -=back - -=item v13 - -This is the recommended mode of operation. - -Changes from v12 are: - -=over 8 - -=item - - -The B<meson+ninja> build system now uses B<meson test> instead of -B<ninja test> when running the test suite. Any override of -B<dh_auto_test> that passes extra parameters to upstream test runner -should be reviewed as B<meson test> is not command line compatible -with B<ninja test>. - -=item - - -All debhelper like tools based on the official debhelper library -(including B<dh> and the official B<dh_*> tools) no longer accepts -abbreviated command parameters. At the same time, B<dh> now -optimizes out calls to redundant B<dh_*> helpers even when passed -long command line options. - -=item - - -The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, -B<dh_makeshlibs>, B<dh_shlibdeps>) are now only run for arch dependent -packages by default (i.e. they are excluded from B<*-indep> targets -and are passed B<-a> by default). If you need them for B<*-indep> -targets, you can add an explicit Build-Depends on -B<dh-sequence-elf-tools>. - -=item - - -The third-party B<gradle> build system (from B<gradle-debian-helper> -package) now runs the upstream-provided test suite automatically. To -suppress such behavior, override B<dh_auto_test>. - -=item - - -The B<dh_installman> tool now aborts if it sees conflicting -definitions of a manpage. This typically happens if the upstream -build system is installing a compressed version and the package lists -an uncompressed version of the manpage in F<< -debian/I<package>.manpages >>. Often the easiest fix is to remove the -manpage from F<< debian/I<package>.manpages >> (assuming both versions -are identical). - -=item - - -The B<dh_auto_*> helpers now reset the environment variables B<HOME> -and common B<XDG_*> variable. Please see description of the -environment variables in L</ENVIRONMENT> for how this is handled. - -I<This feature changed between debhelper 13 and debhelper 13.2.> - -=item - - -The B<dh> command will now error if an override or hook target for an -obsolete command are present in F<debian/rules> -(e.g. B<override_dh_systemd_enable:>). - -=item - - -The B<dh_missing> command will now default to B<--fail-missing>. This -can be reverted to a non-fatal warning by explicitly passing -B<--list-missing> like it was in compat 12. - -If you do not want the warning either, please omit the call to -B<dh_missing>. If you use the B<dh> command sequencer, then you can -do this by inserting an empty override target in the -F<debian/rules> file of the relevant package. As an example: - - # Disable dh_missing - override_dh_missing: - -=item - - -The B<dh> command sequencer now runs B<dh_installtmpfiles> in the -default sequence. The B<dh_installtmpfiles> takes over handling of -tmpfiles.d configuration files. Related functionality in -B<dh_installsystemd> is now disabled. - -Note that B<dh_installtmpfiles> responds to -F<< debian/I<package>.tmpfiles >> where B<dh_installsystemd> used -a name without the trailing "s". - -=item - - -Many B<dh_*> tools now support limited variable expansion via the -B<${foo}> syntax. In many cases, this can be used to reference paths -that contain either spaces or L<dpkg-architecture(1)> values. While -this can reduce the need for L<dh-exec(1)> in some cases, it is B<not> -a replacement L<dh-exec(1)> in general. If you need filtering, -renaming, etc., the package will still need L<dh-exec(1)>. - -Please see L</Substitutions in debhelper config files> for syntax and -available substitution variables. To B<dh_*> tool writers, substitution -expansion occurs as a part of the B<filearray> and B<filedoublearray> -functions. - -=item - - -The B<dh> command sequencer will now skip all hook and override targets -for B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> -lists the relevant B<nocheck> / B<nostrip> options. - -Any package relying on these targets to always be run should instead -move relevant logic out of those targets. E.g. non-test related -packaging code from B<override_dh_auto_test> would have to be moved to -B<execute_after_dh_auto_build> or B<execute_before_dh_auto_install>. - -=item - - -The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> -to L<cmake(1)> to speed up automatic installation process. If for some reason -you need previous behavior, override the flag: - - dh_auto_configure -- -DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ... - -=back - -=item v14 - -This compatibility level is still open for development; use with caution. - -Changes from v13 are: - -=over 8 - -=item - - -The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> -and B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some reproducibility -issues. - -This can cause issues with running binaries directly from the build directories -as they might now require a manually set B<LD_LIBRARY_PATH>. If you need to -override this change, we recommend that you try to pass the -B<-DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the problem (leaving -B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). This should undo the need for -B<LD_LIBRARY_PATH> and avoid the reproducibility issues on Linux, where B<$ORIGIN> -is supported by the runtime linkers. - -=item - - -The tool B<dh_installsysusers> is now included in the default sequence. - -=back - -=back +The list of supported compatibility levels and the related upgrade check +list has moved to L<debhelper-compat-upgrade-checklist(7)>. =head1 NOTES @@ -1398,17 +682,18 @@ example, "B<export DH_VERBOSE>". =item B<DH_VERBOSE> -Set to B<1> to enable verbose mode. Debhelper will output every command it -runs. Also enables verbose build logs for some build systems like autoconf. +Set to a non-empty value to enable verbose mode. Please see the B<-v> / B<--verbose> +option for details. =item B<DH_QUIET> -Set to B<1> to enable quiet mode. Debhelper will not output commands calling +Set to a non-empty value to enable quiet mode. Debhelper will not output commands calling the upstream build system nor will dh print which subcommands are called and depending on the upstream build system might make that more quiet, too. This makes it easier to spot important messages but makes the output quite useless as buildd log. -Ignored if DH_VERBOSE is also set. + +Ignored if DH_VERBOSE is also set or B<-v> / B<--verbose> is passed. =item B<DH_COMPAT> @@ -1511,7 +796,7 @@ inside F<debian/rules> to change the behaviour of debhelper. Instead, where the package maintainer need these features, they should look disabling the relevant feature directly (e.g. by overriding the concrete tools). -=item B<DEB_MAINT_BUILD_OPTIONS> +=item B<DEB_BUILD_MAINT_OPTIONS> This is a dpkg specific environment variable (see e.g. L<dpkg-buildflags(1)>). The debhelper tool suite silently ignores it. @@ -1578,9 +863,19 @@ Additionally, the tools will also ignore if declared documentation is This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is working with documentation. +=item B<notrimdch> + +I<This value will change the content of the debs being built. The .deb +packages built when this is set is therefore not bit-for-bit reproducible +with a regular build in the general case.> + +This value will cause L<dh_installchangelogs(1)> to act as if it +had been passed the B<--no-trim> option, forcing it to forgo removing +older entries from changelogs. + =item B<noautodbgsym>, B<noddebs> -I<The official name is autodbgsym. The noddebs variant is accepted +I<The official name is noautodbgsym. The noddebs variant is accepted for historical reasons.> This value causes debhelper to skip the generation of automatically @@ -1606,7 +901,9 @@ upstream builds to be terse (i.e. reduce verbosity in their output). This is subject to the upstream and the debhelper build system supporting such features. -This value affects most B<dh_auto_*> tools. +This value affects most B<dh_auto_*> tools directly. For commands +provided by the debhelper package, it also causes the tools to act like +the B<DH_QUIET> environment variable was non-empty. =back @@ -1620,6 +917,10 @@ implementation details of the tool. =over 4 +=item L<debhelper-compat-upgrade-checklist(7)> + +List of supported compat levels and an upgrade checklist for each of them. + =item F</usr/share/doc/debhelper/examples/> A set of example F<debian/rules> files that use debhelper. diff --git a/debian/changelog b/debian/changelog index 24ca8e27e6de73911e2a3c778cb4c089606591bd..0aca382fc7ef3a485b645c9f860e5b299e34866f 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,3 +1,540 @@ +debhelper (13.11.4) unstable; urgency=medium + + [ Peter Pentchev ] + * meson.pm: Pass --destdir to `meson install`. (Closes: #1027014) + + -- Niels Thykier <niels@thykier.net> Mon, 02 Jan 2023 14:54:26 +0000 + +debhelper (13.11.3) unstable; urgency=medium + + * Dh_Lib.pm: Have addsubstvars check the value for newlines (Closes: #1026014) + * Stop using (fake)root for mkdirs again. + Should have been removed as a part of the clean up in the previous + upload but was overlooked causing breakage in packages still having + `Rules-Requires-Root: binary-targets`. (Closes: #1026125) + * PROGRAMMING.md: Fix typos + + -- Niels Thykier <niels@thykier.net> Thu, 15 Dec 2022 09:07:38 +0000 + +debhelper (13.11.2) unstable; urgency=medium + + [ Niels Thykier ] + * Dh_Lib.pm: Remove unused third parameter from install_dh_config_file + * makefile.pm: Provide hook for subclasses to reuse cross-build support + (Closes: #1024296) + * Dh_Lib.pm: Revert change where `install_{file,prog,lib}` would use chown. + The problem that prompted this change was not caused by debhelper but + by fakeroot (#1024544) and the change in debhelper would not even + function as a work around in this case. Accordingly, the extra + complexity is not worth it and has been reverted. + + [ Jakub Wilk ] + * Dh_Lib.pm: Fix typo in warning message about dherroron + + -- Niels Thykier <niels@thykier.net> Wed, 14 Dec 2022 20:32:18 +0000 + +debhelper (13.11.1) unstable; urgency=medium + + * Team upload. + * Fix missed 3 to 4 arguments conversion in _install_file_to_path call. + (Closes: #1024520) + + -- Axel Beckert <abe@debian.org> Mon, 21 Nov 2022 00:56:24 +0100 + +debhelper (13.11) unstable; urgency=medium + + [ Gioele Barabucci ] + * dh_installchangelogs: Ensure that at least four old entries are preserved + (Closes: #1021467) + + [ Andrea Pappacoda ] + * meson.pm: Use `meson setup` in the configure step rather than just `meson`. + + [ Niels Thykier ] + * Put newest compat level first in documentation + * Rename debhelper config files to include package name + * dh_installdebconf: Fix typo in manual page + * Dh_Lib.pm: `qx_cmd` support env/chdir changes like `doit` (Closes: #1016354) + * Remove obsolete compat checks in the code + * dh_dwz: Ensure dwz multifile is owned by root:root when root should be used + * dh_builddeb: Always pass `--root-owner-group` to `dpkg-deb` for dbgsym packages. + * Dh_Lib.pm: Provide `mkdirs` to create (non-package) directories. + * Dh_Lib.pm: Make `install_dir` chown created directories when root should be + used for debhelper's own commands. This fixes #1024261 for packages that only + use debhelper itself. However, third-party debhelper tools may still cause + packages with incorrect ownership for now if they are run after `dh_fixperms` + (or `dh_fixperms` is omitted). + * Dh_Lib.pm: Ensure `install_{file,prog,lib}` uses chown when root should be used. + Previously, they would skip the `chown` call and rely on `dh_fixperms` + or `dpkg-deb` to fix the ownership. However, that could cause issues + when the helper was run after `dh_fixperms` and install files that + `dpkg-deb` would not reset ownership of. + + -- Niels Thykier <niels@thykier.net> Sun, 20 Nov 2022 20:02:12 +0000 + +debhelper (13.10.1) unstable; urgency=medium + + * Team upload. + + [ Luca Boccassi ] + * dh_installsysusers: make output reproducible + + [ Jakub Wilk ] + * dh_assistant: Suggest json_pp as JSON formatter + + [ Niels Thykier ] + * dh_assistant: Fix typo of active-compat-level + * dh_installchangelogs: Fix typo of performed + + -- Luca Boccassi <bluca@debian.org> Fri, 28 Oct 2022 10:48:06 +0100 + +debhelper (13.10) unstable; urgency=medium + + [ Luca Boccassi ] + * Install `installsysusers` sequence (to match the provide). + + [ Gioele Barabucci ] + * dh_installchangelogs: Trim old Debian changelog entries + automatically. Distributions can disable this by using + `DEB_BUILD_OPTIONS=notrimdch`. + * dh_installchangelogs.t: Force locale to be `C.UTF-8` to + avoid generating invalid changelog entries under + non-default locales. + + [ Andrea Pappacoda ] + * meson.pm: Stop providing `MESON_TESTTHREADS` environment + variable for the install target. Said variable only + applies for testing. + * cmake.pm: Use `cmake --install` in compat 14. + (Closes: #1020732) + * docs/PROGRAMMING{,.md}: Rewrite PROGRAMMING into markdown. + + [ Michael Biebl ] + * dh_installsystemduser: Stop masking user units on package + removal. They should never have been masked in the first + place. See #1021027. + * dh_installinit: Remove executable bit of init scripts on + package removal (via preinst). Related to #1021027. + * dh_installsystemd: Stop masking system units on package + removal. This is no longer necessary with the init scripts + getting their exec bit cleared on package removal. + (Closes: #1021027) + + [ Niels Thykier ] + * Dh_Lib.pm: Add `package_type` as a function (extracted + from `is_udeb`). + * Dh_Getopt.pm: Fix duplicated `warning` in output for a + particular warning. + * dh_assistant: Provide a new `detect-hook-targets` command. + * dh: Recommend using `dh_assistant detect-hook-targets` for + checking whether hook targets are correct. + * dh: Hoist `nodoc` and `nocheck` from `DEB_BUILD_PROFILES` + into `DEB_BUILD_OPTIONS` when they are present in the former + and absent in the latter. Emit a warning when doing so to + aid the user, so they know why this does not work when they + are later building a package that does not use dh. + (Closes: #979401) + * dh: Provide a warning when cross building an `nocheck` is + absent from `DEB_BUILD_OPTIONS` to cross builders, who are + not experienced with Debian's requirements for + cross-building. The warning also recommends activating the + `cross` build profile and provides a way to disable the + warning without using `nocheck` (for the special case, where + people have a system that can run host binaries). + * Dh_Lib.pm: Fix bug where `addsubstvars` would not respect + the `--no-act` parameter. + * dh_perl: For scripts that are detected as perl scripts + that would trigger a dependency, normalize the shebang line to + use the same perl as debhelper is run under (/usr/bin/perl + in Debian, YMMV in derivatives). (Closes: #904409) + * dh_assistant: Provide new `log-installed-files` command to + help users and third-party tools record which files they have + installed. Third-party tools should use the + `--on-behalf-of-cmd` to have their tool name recorded. + (Closes: #972724) + * dh_installexamples: Explicitly recommend `examples/*` over + `examples` as content for the `debian/<pkg>.examples` file + to avoid the triggering `.../examples/examples` case. + (Closes: #1000384) + * debhelper.pod: Clarify the documentation around `-v` + + `--verbose` vs. `DH_VERBOSE` vs. `DH_QUIET` and `terse` + from `DEB_BUILD_OPTIONS`. Notably, clarify that `-v` + and `DH_VERBOSE` provides the same functionality and + that they do not cause *all* commands to be shown. + (Closes: #1002464) + + [ Translations ] + * Update Portuguese translation (Américo Monteiro) + (Closes: #1019231) + + -- Niels Thykier <niels@thykier.net> Sat, 08 Oct 2022 18:13:35 +0000 + +debhelper (13.9.1) unstable; urgency=medium + + [ Niels Thykier ] + * autoscripts/postinst-init-tmpfiles: Re-instate runtime check + before running `systemd-tmpfiles`. However, explicitly check + for `systemd-tmpfiles` rather than asserting the system was + booted by systemd. This resolves #1013969 without requiring + a strict dependency as originally suggested by Guilhem Moulin + in #1013969. + * dh_installtmpfiles: Remove the `systemd | systemd-tmpfiles` + dependency as it is no longer required. (Closes: #1017441) + * dh_installsystemd: Ditto. + * dh_installinit: Ditto. + + [ Johannes Schauer Marin Rodrigues ] + * autoscripts/postinst-init-tmpfiles: Only pass `--root` to systemd + when `DPKG_ROOT` is present (as `--root=/` is different from + omitting `--root` entirely). + * autoscripts/postinst-sysusers: Ditto + + -- Niels Thykier <niels@thykier.net> Tue, 30 Aug 2022 15:24:43 +0000 + +debhelper (13.9) unstable; urgency=medium + + [ Gioele Barabucci ] + * d/control: Provide dh-sequence-installsysusers. + + [ Andreas Hübner ] + * debhelper.pod: Add missing word "variables". + + [ Niels Thykier ] + * Dh_Lib.pm: Fix in addsubstvar where a value was added when + it should not have been. (Closes: #1015263) + + -- Niels Thykier <niels@thykier.net> Sun, 14 Aug 2022 12:34:54 +0000 + +debhelper (13.8) unstable; urgency=medium + + [ Niels Thykier ] + * dh_perl: Fix incorrect binary versioning caused by a regression + in 13.3. Thanks to Niko Tyni for reporting the issue. + (Closes: #997961) + * d/control: Bump Standards-Version to 4.6.1 - no changes required. + * root_sequence.pm: Run `dh_installsysusers` before + `dh_installtmpfiles` (only affects compat 14 or later). Thanks + to Nicholas Brown for the suggestion. (Closes: #1011099) + * autoscripts/postinst-init-tmpfiles: Remove runtime check on the + system having systemd as init system. + * dh_installtmpfiles: Replace runtime check on the system running + under systemd in generated `postinst` script with a dependency + on `systemd | systemd-tmpfiles` added to `${misc:Depends}`. + Thanks to Guilhem Moulin for the suggestion. (Closes: #1013969) + * dh_installsystemd: Ditto. + * dh_installinit: Ditto. + * debhelper-compat-upgrade-checklist.pod: Correct description for + the addition of dh_installsysusers in compat 14. + * meson.pm: Use `meson install` instead of `ninja install` for + dh_auto_install in compat 14. Thanks to Andrea Pappacoda for + the suggestion. (Closes: #1006805) + + [ Max-Julian Pogner ] + * Dh_Lib.pm: Remove double semi-colon. (Closes: #1010591) + * Dh_Lib.pm: _strip_spaces now explicitly returns undef on undef + argument. + (Closes: #1010594) + + [ Andrea Pappacoda ] + * cmake.pm: Set FETCHCONTENT_FULLY_DISCONNECTED to true. This + ensures that the `FetchContent` module does not attempt to + use internet connection. + + [ Vagrant Cascadian ] + * debhelper-compat-upgrade-checklist.pod: Update documentation + for compat 14 change. (Closes: #1011404) + + [ Ferenc Wágner ] + * debhelper.pod: Correct link to the new upgrade checklist. + (Closes: #1012777) + + [ Luca Boccassi ] + * dh_installman: Avoid false positive language detection on + shared libs. + + [ Translations ] + * Update Portuguese translation (Américo Monteiro) + (Closes: #1011256) + + -- Niels Thykier <niels@thykier.net> Sun, 03 Jul 2022 09:04:23 +0000 + +debhelper (13.7.1) unstable; urgency=medium + + * debhelper.pod: Fix several typos. Thanks to Guillem Jover + for pointing them out and proposing corrections. + * dh_installalternatives: Correct a file check that caused + false-positive rejections of valid alternatives files. Thanks to + Hiroyuki YAMAMORI for reporting the bug and providing an initial + patch. (Closes: #1009844) + + -- Niels Thykier <niels@thykier.net> Wed, 20 Apr 2022 06:17:57 +0000 + +debhelper (13.7) unstable; urgency=medium + + [ Niels Thykier ] + * dh_installalternatives: Improve validation of alternative files to + catch some "obvious" copy-waste mistakes. + * dh: Invoke dh_installalternatives after dh_link in compat 14 or + later. Thanks to Colin Watson for the suggestion. + (Closes: #1002800) + * cmake.pm: Drop -DCMAKE_SKIP_RPATH=on in compat v14. Thanks to + Vagrant Cascadian for the suggestion and the investigative work on + this topic. (Closes: #1004939) + * debhelper-compat-upgrade-checklist.pod: New file. + * debhelper.pod: Move list of supported compat levels and the related + upgrade checklist into debhelper-compat-upgrade-checklist.pod. + This means you now need `man 7 debhelper-compat-upgrade-checklist` + to see the upgrade checklist. + * dh_installdebconf: Support -D/--define command line parameters + (mirroring those from dh_installdeb). + * Dh_Lib.pm: Cope with "?=" as assignment operator in substvars files + to be future proof with (possible) planned addition of "optional + substvars. At the moment, debhelper will still always use "=" when + adding a substvar but it will now preserve "?=" operator if an + existing substvar is modified. + + [ Guillem Jover ] + * autoconf.pm: Add support for autotest test suites by passing the + TESTSUITEFLAGS environment variable to `make test`. + + [ Dave Jones ] + * Rewrite handling of stop services to use the `preinst` when using + --no-restart-after-upgrade. This fixes a regression caused by + the fix for #989155. (Closes: #994204) + + [ Johannes Schauer Marin Rodrigues ] + * dh_installmenu: Respect DPKG_ROOT when checking for update-menus. + Note this implementation assumes update-menus is present both + inside and outside the chroot to activate. If it is absent on + either side, the update-menus call is skipped. + + [ Gioele Barabucci ] + * dh_installsysusers: Invoke systemd-sysusers even when DPKG_ROOT + is set (relying on `--root`). + * dh_installpam: In compat 14, install pam snippets into + `/usr/lib/pam.d` instead of `/etc/pam.d`. Remember to remove + (now) obsolete conffiles when you bump to compat 14. + + [ Andreas Hübner ] + * debhelper.pod: Correct spelling of DEB_BUILD_MAINT_OPTIONS. + + -- Niels Thykier <niels@thykier.net> Sun, 17 Apr 2022 09:42:46 +0000 + +debhelper (13.6) unstable; urgency=medium + + [ Niels Thykier ] + * dh_assistant: Avoid creating `debian/.debhelper` when the + which-build-system sub command is invoked. Thanks to + Jelmer Vernooij for spotting that bug. + * dh_assistant: Add new active-compat-level command, which + outputs information about which compat level is declared + and active. It also tells how the compat level was + declared. + * Dh_Lib.pm: Add new function, get_non_binnmu_date_epoch, + only needed for dh_strip_nondeterminism. + * dh_installcron: Add support for `cron.yearly` packaging + file. Thanks to Martin-Éric Racine for the suggestion. + (Closes: #1000363) + * Dh_Lib.pm: Remove support for compat 5 and 6. + * debhelper.pod,debhelper-obsolete-compat.pod: Update to + reflect the new status for compat 5 and 6. + + [ Guillem Jover ] + * dh: Add missing _ in execute_after example in POD. + + [ Sandro Tosi ] + * dh_compress: Exclude .woff and .woff2 by default. + + [ Translations ] + * Update Portuguese translation (Américo Monteiro) + (Closes: #1000719) + + -- Niels Thykier <niels@thykier.net> Mon, 20 Dec 2021 12:55:03 +0000 + +debhelper (13.5.2) unstable; urgency=medium + + [ Niels Thykier ] + * dh_installsystemd: Revert change to deploy systemd files into + usr/lib/systemd. (Closes: #993316, #993759) + * dh_installinit: Ditto. + * dh_systemd_enable: Ditto. + * dh_systemd_start: Ditto. + * SequencerUtil.pm: Remove duplicate "-a" option to some commands. + Thanks to Christoph Berg for reporting the issue. + (Closes: #971761) + * dh_installdeb: Revert the change to rewrite `rm_conffiles` into + `remove-on-upgrade` due to it causing bugs in non-trivial cases. + (Closes: #994919) + + [ Christoph Berg ] + * dh_installtmpfiles: Add missing option name in POD documentation. + + -- Niels Thykier <niels@thykier.net> Thu, 23 Sep 2021 16:44:25 +0000 + +debhelper (13.5.1) unstable; urgency=medium + + [ Paul Wise ] + * cmake.pm: make it possible to override dh provided ctest arguments + + [ Niels Thykier ] + * cmake.pm: Add missing import which broke cmake related builds. + Thanks to Boyuan Yang for reporting the issue. + (Closes: #993345) + + -- Niels Thykier <niels@thykier.net> Tue, 31 Aug 2021 05:43:35 +0000 + +debhelper (13.5) unstable; urgency=medium + + * dh_installdeb: Install debian/conffiles in compat 12+ again + (undoing the compat 12 change saying dh_installdeb would ignore + this file). The file can now be using for the activating the + `remove-on-upgrade` feature from dpkg 1.20. + * dh_installdeb: Automatically rewrite `rm_conffiles` into the + new `remove-on-upgrade` feature from dpkg when possible. + * cmake.pm: Pass `ARGS+=--verbose` to make when running tests + in the cmake+make variant except when "terse" is in + DEB_BUILD_OPTIONS. Thanks to Paul Wise for the suggestion. + (Closes: #992623) + * python_support.pm: Remove obsolete dh addon. It did nothing + but warn and nothing used it anymore. + * dh: Document debhelper provided dh addon sequences. + * single_binary.pm: New dh addon ("single-binary") that explicitly + activates the "single binary" work flow, where dh_auto_install + uses debian/<pkg> as default --destdir when there is only a + single binary package. It will error out if used in a + source package building multiple binary packages. + * dh: Activate "single-binary" addon by default in compat levels + up to and including compat 14 when the source package only lists + one binary package in debian/control. In compat 14, emit a warning + when this happens implicitly requesting users to explicitly enable + or disable the addon for single binary source packages to avoid + surprises in compat 15. + * dh_auto_install: In compat 15, remove special-case default for + --destdir for single binary source packages. If the previous + default is desired, please use the "single-binary" dh addon or + explicitly pass --destdir to dh_auto_install. + (Closes: #971432) + * debian/control: Provide dh-sequence-single-binary. + * debhelper.pod: Document the dh_auto_install will change behaviour + in compat 15 for single binary packages and dh will warning about + that in compat 14. + * dh_assistant: New tool for assisting third-party tools. At the + moment, it primarily supports introspection related features but + will hopefully be extended to support more use cases. + (Closes: #984900) + + -- Niels Thykier <niels@thykier.net> Mon, 30 Aug 2021 19:50:42 +0000 + +debhelper (13.4.1) unstable; urgency=medium + + [ Clint Adams ] + * autoscripts/*: Replace `which` with `command -v`. + + [ Simon McVittie ] + * dh_installsystemd: Only merge /lib/systemd/system into /usr + for now. (Closes: #992554) + * dh_systemd_enable: Ditto. + + [ Johannes Schauer Marin Rodrigues ] + * autoscripts/postinst-init-nostart: Call invoke-rc.d when + a non-empty DPKG_ROOT is used. (Closes: #992556) + + -- Niels Thykier <niels@thykier.net> Sat, 21 Aug 2021 09:01:00 +0000 + +debhelper (13.4+nmu1) unstable; urgency=high + + [ Sean Whitton ] + * Non-maintainer upload. + * Replace "use v5.28" with "use v5.24" in Dh_Lib.pm. + The change to "use v5.28" in 13.4 broke the test to distinguish 0755 + from "0755" in the reset_perm_and_owner function, breaking builds. + Thanks Adrian Bunk and Ansgar for help isolating the problem. + + [ Niels Thykier ] + * debian/changelog: Correct bug number in the 13.4 entry. + + -- Sean Whitton <spwhitton@spwhitton.name> Tue, 17 Aug 2021 13:34:02 -0700 + +debhelper (13.4) unstable; urgency=medium + + [ Dimitri John Ledkov ] + * dh_dwz: run in parallel across packages. (Closes: !47) + + [ Andrej Shadura ] + * Dh_Buildsystems.pm: Add bmake and mkcmake as third-party + build systems. (Closes: !46) + + [ Guillem Jover ] + * Dh_Buildsystems.pm: Add golang as a third-party build + system. (Closes: #981106) + + [ Niels Thykier ] + * autoscripts/*: Add support for DPKG_ROOT in systemd, tmpusers, + sysusers and init related snippets. Based on an initial patch + from Helmut Grohne. (Closes: #983566) + * autoscripts/*: Reorder conditions in some scripts to avoid + doing a redundant stat call when a script parameter can decide + to skip it. + * dh_gconf: Remove the command as it does nothing. + (Closes: #908845) + * doc/TODO: Remove reference to dh_gconf. + * root_sequence.pm: Remove dh_gconf from root sequence and declare + it as obsolete (causing errors from compat 14 if still referenced + in hook targets). + * man/po4a/po4a.cfg: Remove dh_gconf from translations. + * AddonAPI.pm: The declare_command_obsolete command now accepts an + "$error_compat" parameter to enable addons to choose which compat + level that will trigger an error (though it must be minimum 13). + * doc/PROGRAMMING: Update docs to reflect API change. + * debhelper.pod: Document that referencing dh_gconf in hook targets + will cause an error in compat 14. + * dh_fixperms: Correct permissions of files beneath usr/libexec to + be executable. (Closes: #980325) + * dh_installtmpfiles: Only register tmpfiles ending with ".conf" as + tmpfiles in /usr/lib/tmpfiles.d and /etc/tmpfiles.d. This ensures + that dh_installtmpfiles gracefully copes with e.g. README files + provided by systemd upstream. (Closes: #986329) + * dh_installsystemd: Ditto (but only relevant in compat 12 or + earlier) + * cmake.pm: Pass -DCMAKE_FIND_USE_PACKAGE_REGISTRY=OFF to cmake in + addition to -DCMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY=ON as the + former is intended to replace the latter. Thanks to Raul Tambre + for reporting the issue. (Closes: #988973) + * Dh_Lib.pm: Bump version requirement to v5.28 to reflect the actual + requirements (the code was using v5.28 features). Thanks to + Sérgio Basto for reporting the issue. + * dh_missing: Ditto. + * autoscripts/postinst-init,autoscripts/postinst-systemd-start: Use + "restart" instead of "start" when starting the services. This + ensures a smooth transition from --restart-after-upgrade to + --no-restart-after-upgrade in dh_installinit and dh_installsystemd. + Thanks to Ryan Tandy for reporting the issue. + (Closes: #989155) + * dh_installsystemd: Remove usage of autoscripts/postinst-systemd-restart + * dh_installinit: Remove usage of autoscripts/postinst-init-restart + * autoscripts/autoscripts/postinst-systemd-restart: Removed. + * autoscripts/postinst-init-restart: Removed + * dh_installsystemd: Prefer /usr/lib/systemd/ to /lib/systemd. + (Closes: #987989) + * dh_systemd_enable: Ditto. + * dh_systemd_start: Ditto. + * dh_installinit: Ditto. + * dh_installsystemd: Merge /lib/systemd into /usr/lib/systemd if both + are present in the package staging directory (preferring the latter + in case of conflicts). (Closes: #987989) + * dh_systemd_enable: Ditto. + + [ Dominic Hargreaves ] + * perl_build.pm,perl_makemaker.pm: Make debhelper use the same perl + as it runs under (via Perl's $^X variable) when invoking the + upstream build system. (Closes: !40, #966396) + + [ Axel Beckert ] + * Always generate unique doc-base file names based on package name and + document ID. (Closes: #980903) + + -- Niels Thykier <niels@thykier.net> Tue, 17 Aug 2021 16:32:34 +0000 + debhelper (13.3.4) unstable; urgency=medium [ Jakub Wilk ] diff --git a/debian/compat b/debian/compat index 8351c19397f4fcd5238d10034fa7fa384f14d580..60d3b2f4a4cd5f1637eba020358bfe5ecb5edcf2 100644 --- a/debian/compat +++ b/debian/compat @@ -1 +1 @@ -14 +15 diff --git a/debian/control b/debian/control index 445c9d9878426adc642f07543cff7e2411abd6b3..4a63b296d5905039fde369c37f37d361e594ddd5 100644 --- a/debian/control +++ b/debian/control @@ -4,12 +4,12 @@ Priority: optional Maintainer: Debhelper Maintainers <debhelper@packages.debian.org> Uploaders: Niels Thykier <niels@thykier.net>, Build-Depends: dpkg-dev (>= 1.18.0~), + libtest-pod-perl <pkg.debhelper.ci>, + man-db <pkg.debhelper.ci>, perl:any, po4a, - man-db <pkg.debhelper.ci>, - libtest-pod-perl <pkg.debhelper.ci>, Rules-Requires-Root: no -Standards-Version: 4.5.1 +Standards-Version: 4.6.1 Testsuite: autopkgtest-pkg-perl Vcs-Git: https://salsa.debian.org/debian/debhelper.git Vcs-Browser: https://salsa.debian.org/debian/debhelper @@ -31,12 +31,12 @@ Depends: autotools-dev, dpkg-dev (>= 1.18.2~), dwz (>= 0.12.20190711), file (>= 3.23), + libdebhelper-perl (= ${source:Version}), libdpkg-perl (>= 1.17.14), man-db, - libdebhelper-perl (= ${source:Version}), po-debconf, ${misc:Depends}, - ${perl:Depends} + ${perl:Depends}, Breaks: # To ensure cmake understands -DCMAKE_INSTALL_RUNSTATEDIR=/run as used in compat 11 # - Can be dropped (with the caveat that cmake packages may behave differently @@ -48,12 +48,14 @@ Breaks: # The qmake cross wrapper was introduced in 5.9.2+dfsg-5, but got some important # fixes in the subsequent uploads. It is only needed for cross-building. # qt5-qmake (<< 5.9.2+dfsg-8), -Suggests: dh-make -Provides: ${dh:CompatLevels}, - dh-sequence-dwz, +Suggests: dh-make, +Provides: dh-sequence-dwz, dh-sequence-elf-tools, dh-sequence-installinitramfs, + dh-sequence-installsysusers, + dh-sequence-single-binary, dh-sequence-systemd, + ${dh:CompatLevels}, Multi-Arch: foreign Description: helper programs for debian/rules A collection of programs that can be used in a debian/rules file to @@ -67,9 +69,9 @@ Package: libdebhelper-perl Section: perl Architecture: all Depends: ${misc:Depends}, - ${perl:Depends} -Replaces: debhelper (<< 12.6~) -Breaks: debhelper (<< 12.6~) + ${perl:Depends}, +Replaces: debhelper (<< 12.6~), +Breaks: debhelper (<< 12.6~), Multi-Arch: foreign Description: debhelper perl modules A collection of programs that can be used in a debian/rules file to diff --git a/debian/docs b/debian/debhelper.docs similarity index 100% rename from debian/docs rename to debian/debhelper.docs diff --git a/debian/examples b/debian/debhelper.examples similarity index 100% rename from debian/examples rename to debian/debhelper.examples diff --git a/debian/manpages b/debian/debhelper.manpages similarity index 100% rename from debian/manpages rename to debian/debhelper.manpages diff --git a/debian/gbp.conf b/debian/gbp.conf new file mode 100644 index 0000000000000000000000000000000000000000..703e45fe46e0c15eb1733d9f7b9baf12359bfcd3 --- /dev/null +++ b/debian/gbp.conf @@ -0,0 +1,6 @@ +[DEFAULT] +debian-branch = main + +[dch] +multimaint-merge = true +ignore-regex = (Signed-off|Acked|Tested|Reviewed)-by:|Fix-For:|Fixes: diff --git a/debian/rules b/debian/rules index 6c018456a2105701c1d02f8e6dc7733fa9f14010..fb4e5201aa75841b9a6715709112b8bb01737e43 100755 --- a/debian/rules +++ b/debian/rules @@ -15,7 +15,7 @@ PERL ?= perl ./run dh $@ --without autoreconf --with build-stamp # Disable as they are unneeded (and we can then be sure debhelper -# builds without needing autotools-dev, dh-strip-nondetermism etc.) +# builds without needing autotools-dev, dh-strip-nondeterminism etc.) override_dh_update_autotools_config override_dh_strip_nondeterminism: execute_before_dh_install: diff --git a/debian/source/options b/debian/source/options new file mode 100644 index 0000000000000000000000000000000000000000..edbbfb5bad7d1b1379bc15dae5172977c9f0e4fd --- /dev/null +++ b/debian/source/options @@ -0,0 +1,2 @@ +tar-ignore +tar-ignore=debhelper/.idea diff --git a/dh b/dh index 5dcaa3a9571b3da7935f0631fe117648c344e43f..c1c511bd4a625a3cd1159cc362cbec0bdbca7036 100755 --- a/dh +++ b/dh @@ -65,15 +65,16 @@ examples below. The override and hook targets can also be defined to run only when building architecture dependent or architecture independent packages. Use targets with names like B<override_>I<dh_command>B<-arch> -and B<execute_after>I<dh_command>B<-indep>. +and B<execute_after_>I<dh_command>B<-indep>. This feature is available since debhelper 8.9.7 (for override targets) and 12.8 (for hook targets). =head2 Completely empty targets -As a special optimization, B<dh> will skip a target if it is completely empty. -This is mostly useful for override targets, where the command will simply be +As a special optimization, B<dh> will skip a target if it is +completely empty and does not depend on any other target. This is +mostly useful for override targets, where the command will simply be skipped without the overhead of invoking a dummy target. Note that the target has to be completely empty for this to work: @@ -90,8 +91,48 @@ Note that the target has to be completely empty for this to work: =head2 Verifying targets are picked up by dh -If you want to confirm that B<dh> has seen an override or a hook target, you -can use the following command as an example: +As of debhelper 13.10, you can use L<dh_assistant(1)> to see which override +and hook targets will be seen by B<dh>. Here is an example run of L<dh_assistant(1)> +along with its output: + + $ dh_assistant detect-hook-targets + { + "commands-not-in-path": [ + "dh_foo" + ], + "hook-targets": [ + { + "command": "dh_strip_nondeterminism", + "is-empty": true, + "package-section-param": null, + "target-name": "override_dh_strip_nondeterminism" + }, + { + "command": "dh_foo", + "is-empty": false, + "package-section-param": "-a", + "target-name": "override_dh_foo-arch" + } + ] + } + +The B<commands-not-in-path> is useful for spotting mistakes in the hook target +names. A non-empty value implies one of more hook targets are related to a command +that is either not installed or no command with that name exists at all. It is +generally worth double checking these. + +Additionally, the B<is-empty> attribute for each hook target can be used for seeing +whether a hook target triggers the L</Completely empty targets> optimization. + +If you are interested in the other attributes, please read the L<dh_assistant(1)> +for the details. + +=head3 Verifying targets are picked up by dh (when debhelper is older than 13.10) + + + +On older versions of debhelper, you have to use B<dh> with B<--no-act>. +You can use the following command as an example: $ dh binary --no-act | grep dh_install | head -n5 dh_installdirs @@ -421,6 +462,80 @@ when building only documentation. execute_after_dh_fixperms-arch: chmod 4755 debian/foo/usr/bin/foo +=head1 DEBHELPER PROVIDED DH ADDONS + +The primary purpose of B<dh> addons is to provide easy integration with +third-party provided features for debhelper. However, debhelper itself +also provide a few sequences that can be useful in some cases. These +are documented in this list: + +=over 4 + +=item build-stamp + +A special addon for controlling whether B<dh> (in compat 10 or later) +will create stamp files to tell whether the build target has been run +successfully. See L</INTERNALS> for more details. + +This addon is active by default but can disabled by using +B<dh $@ --without build-stamp> + +=item dwz (obsolete) + +Adds L<dh_dwz(1)> to the sequence in compat level 11 or below. Obsolete +in compat 12 or later. + +=item elf-tools + +This addon adds tools related to ELF files to the sequence such as +L<dh_strip(1)> and L<dh_shlibdeps(1)> + +This addon is I<conditionally> active by default for architecture +specific packages - that is, it is skipped for arch:all packages. +In the special case where you need these tools to work on arch:all +packages, you can use B<--with elf-tools> to activate it +unconditionally. + +=item installinitramfs (obsolete) + +Adds L<dh_installinitramfs(1)> to the sequence in compat level 11 or below. +Obsolete in compat 12 or later. + +=item root-sequence (internal) + +This is reserved for internal usage. + +=item single-binary + +A special-purpose addon that makes debhelper run in "single binary" mode. + +When active, it will pass B<< --destdir=debian/I<package>/ >> to +L<dh_auto_install(1)>. This makes every file "installed" by the upstream +build system part of the (only) binary package by default without having +to use other helpers such as L<dh_install(1)>. + +The addon will refuse to activate when the source package lists 2 or more +binary packages in F<debian/control> as a precaution. + +Before compat 15. this behaviour was the default when there was only a single +binary package listed in F<debian/control>. In compat 15 and later, this +addon must explicitly be activated for this feature to work. + +The rationale for requiring this as an explicit choice is that if it is +implicit then debhelper will silently change behaviour on adding a new +binary package. This has caused many RC bugs when maintainers renamed +a binary and added transitional packages with the intention of supporting +seamless upgrades. The result would often be two empty binary packages that +were uploaded to archive with users frustrated as their "upgrade" removed +their programs. + +=item systemd (obsolete) + +Adds L<dh_systemd_enable(1)> and L<dh_systemd_start(1)> to the sequence in +compat level 10 or below. Obsolete in compat 11 or later. + +=back + =head1 INTERNALS If you're curious about B<dh>'s internals, here's how it works under the hood. @@ -635,6 +750,22 @@ if (! exists($Debian::Debhelper::DH::SequenceState::sequences{$sequence})) { parse_dh_cmd_options(@ARGV_orig); +_hoist_profile_into_dbo('nodoc'); +_hoist_profile_into_dbo('nocheck'); + +if (is_cross_compiling() && !get_buildoption('nocheck') && !get_buildoption('crossbuildcanrunhostbinaries')) { + warning('Running tests during cross-builds is not supported in the general case (except for special cases or by'); + warning('using emulation)'); + warning('If the build fails, please consider rebuilding with DEB_BUILD_OPTIONS=nocheck.'); + if (!is_build_profile_active('cross')) { + warning('Additionally, you might have to set the "cross" profile. For dpkg-buildpackage, you do this by'); + warning('passing the -Pcross option. Check the documentation of your build tool for how to set'); + warning('DEB_BUILD_PROFILES if you use another build tool that does not auto-configure cross-building for you'); + } + warning('If you have setup the relevant support for running cross-compiled binaries and want to silence this'); + warning('warning, please use DEB_BUILD_OPTIONS=crossbuildcanrunhostbinaries') +} + # Figure out at what point in the sequence to start for each package. my (%logged, %startpoint, $completed_sequences); @@ -729,6 +860,14 @@ sub reject_obsolete_params { } } +sub _hoist_profile_into_dbo { + my ($name) = @_; + if (is_build_profile_active($name) && !get_buildoption($name)) { + $ENV{'DEB_BUILD_OPTIONS'} //= ''; + $ENV{'DEB_BUILD_OPTIONS'} .= ' ' . $name; + warning("Copying ${name} into DEB_BUILD_OPTIONS: It was in DEB_BUILD_PROFILES and but not in DEB_BUILD_OPTIONS"); + } +} =head1 SEE ALSO diff --git a/dh_assistant b/dh_assistant new file mode 100755 index 0000000000000000000000000000000000000000..27b87035df8deaa7109e814d69f451138d724732 --- /dev/null +++ b/dh_assistant @@ -0,0 +1,576 @@ +#!/usr/bin/perl + +=head1 NAME + +dh_assistant - tool for supporting debhelper tools and provide introspection + +=cut + +use strict; +use warnings; +use Debian::Debhelper::Dh_Lib; +use JSON::PP (); + +=head1 SYNOPSIS + +B<dh_assistant> B<I<command>> [S<I<additional options>>] + +=head1 DESCRIPTION + +B<dh_assistant> is a debhelper program that provides introspection into the +debhelper stack to assist third-party tools (e.g. linters) or third-party +debhelper implementations not using the debhelper script API (e.g., because +they are not written in Perl). + +=head1 COMMANDS + +The B<dh_assistant> supports the following commands: + +=head2 active-compat-level (JSON) + +B<Synopsis>: B<dh_assistant> B<active-compat-level> + +Outputs information about which compat level the package is using. + +For packages without valid debhelper compatibility information (whether missing, ambiguous, +not supported or simply invalid), this command operates on a "best effort" basis and may abort +when error instead of providing data. + +The returned JSON dictionary contains the following key-value pairs: + +=over 4 + +=item active-compat-level + +The compat level that debhelper will be using. This is the same as B<DH_COMPAT> when present +or else B<declared-compat-level>. This can be B<null> when no compat level can be detected. + +=item declared-compat-level + +The compat level that the package declared as its default compat level. This can be B<null> +if the package does not declare any compat level at all. + +=item declared-compat-level-source + +Defines how the compat level was declared. This is null (for the same reason as +B<declared-compat-level>) or one of: + +=over 4 + +=item debian/compat + +The compatibility level was declared in the first line F<debian/compat> file. + +=item Build-Depends: debhelper-compat (= <C>) + +The compatibility was declared in the F<debian/control> via a build dependency on the +B<< debhelper-compat (= <C>) >> package in the B<Build-Depends> field. In the output, +the B<C> is replaced by the actual compatibility level. A full example value would be: + + Build-Depends: debhelper-compat (= 13) + +=back + +=back + +=head2 supported-compat-levels (JSON, CRFA) + +B<Synopsis>: B<dh_assistant> B<supported-compat-levels> + +Outputs information about which compat levels, this build of debhelper knows +about. + +This command accepts no options or arguments. + +=head2 which-build-system (JSON) + +B<Synopsis>: B<dh_assistant> B<which-build-system> [S<I<build step>>] [S<I<build system options>>] + +Output information about which build system would be used for a particular build step. The build step +must be one of B<configure>, B<build>, B<test>, B<install> or B<clean> and must be the first argument +after B<which-build-system> when provided. If omitted, it defaults to B<configure> as it is the +most reliable step to use auto-detection on in a clean source directory. Note that build steps do not +always agree when using auto-detection - particularly if the B<configure> step has not been run. + +Additionally, the B<clean> step can also provide "surprising" results for builds that rely on +a separate build directory. In such cases, debhelper will return the first build system that +uses a separate build directory rather than the one build system that B<configure> would detect. +This is generally a cosmetic issue as both build systems are all basically a glorified +B<rm -fr builddir> and more precise detection is functionally irrelevant as far as debhelper is +concerned. + +The option accepts all debhelper build system arguments - i.e., options you can pass to all of +the B<dh_auto_*> commands plus (for the B<install> step) the B<--destdir> option. These options +affect the output and auto-detection in various ways. Passing B<-S> or B<--buildsystem> +overrides the auto-detection (as it does for B<dh_auto_*>) but it still provides introspection +into the chosen build system. + +Things that are useful to know about the output: + +=over 4 + +=item * + +The key B<build-system> is the build system that would be used by debhelper for the given +step (with the given options, debhelper compat level, environment variables and the given +working directory). When B<-S> and B<--buildsystem> are omitted, this is the result of +debhelper's auto-detection logic. + +The value is valid as a parameter for the B<--buildsystem> option. + +The special value B<none> is used to denote that no build system would be used. This value +is not present in B<--list> parameter for the B<dh_auto_*> commands, but since debhelper/12.9 +the value is accepted for the B<--buildsystem> option. + +Note that auto-detection is subject to limitations in regards to third-party build systems. +While debhelper I<does> support auto-detecting some third-party build systems, they must be +installed for the detection to work. If they are not installed, the detection logic silently +skips that build system (often resulting in B<build-system> being B<none> in the output). + +=item * + +The B<build-directory> and B<buildpath> values serve different but related purposes. The +B<build-directory> generally mirrors the B<--builddirectory> option where as B<buildpath> +is the output directory that debhelper will use. Therefore the former will often be null +when B<--builddirectory> has not been passed while the latter will generally not be null +(except when B<build-system> is B<none>). + +=item * + +The B<dest-directory> (B<--destdir>) is undefined for all build steps except the B<install> build +step (will be output as null or absent). For the same reason, B<--destdir> should only be +passed for B<install> build step. + +Note that if not specified, this value is currently null by default. + +=item * + +The B<parallel> value is subject to B<DEB_BUILD_OPTIONS>. Notably, if that does not include +the B<parallel> keyword, then B<parallel> field in the output will always be 1. + +=item * + +Most fields in the output I<can> be null. Particular if there is no build system is detected +(or when B<--buildsystem=none>). Additionally, many of the fields can be null even if there +is a build system if the build system does not use/set/define that variable. + +=back + +=head2 detect-hook-targets (JSON) + +B<Synopsis>: B<dh_assistant> B<detect-hook-targets> + +Detects possible override targets and hook targets that L<dh(1)> might use (provided that the +relevant command is in the sequence). + +The detection is based on scanning the rules file for any target that I<might look> like a hook +target and can therefore list targets that are in fact not hook targets (or are but will never +be triggered for other reasons). + +The detection uses a similar logic for scanning the rules file and is therefore subject to +makefile conditionals (i.e., the truth value of makefile conditionals can change whether a hook +target is visible in the output of this command). In theory, you would have to setup up the +environment to look like it would during a build for getting the most accurate output. Though, +a lot of packages will not have conditional hook targets, so the "out of the box" behaviour +will work well in most cases. + +The output looks something like this: + + { + "commands-not-in-path": [ + "dh_foo" + ], + "hook-targets": [ + { + "command": "dh_strip_nondeterminism", + "is-empty": true, + "package-section-param": null, + "target-name": "override_dh_strip_nondeterminism" + }, + { + "command": "dh_foo", + "is-empty": false, + "package-section-param": "-a", + "target-name": "override_dh_foo-arch" + } + ] + } + +In more details: + +=over 4 + +=item commands-not-in-path + +This attribute lists all the commands related to hook targets, which B<dh_assistant> could B<not> +find in PATH. These are usually caused by either the command not being installed on the system +where B<dh_assistant> is run or by the command not existing at all. + +If you are using this command to verify an hook target is present, please double check that the +command is spelled correctly. + +=item hook-targets + +List over hook targets found along with additional information about them. + +=over 4 + +=item command + +Attribute that lists which command this hook target is related too. + +=item target-name + +The actual target name detected in the F<debian/rules> file. + +=item is-empty + +A boolean that determines whether L<dh(1)> will optimize the hook out at runtime (see "Completely empty targets" in +L<dh(1)>). Note that empty override targets will still cause L<dh(1)> to skip the original command. + +=item package-section-param + +This attribute defines what package selection parameter should be passed to B<dh_*> commands used +in the hook target. It can either be B<-a>, B<-i> or (if no parameter should be used) C<null>. + +=back + +=back + +This command accepts no options or arguments. + +=head2 log-installed-files + +B<Synopsis>: B<dh_assistant> B<< -pI<pkg> >> I<[--on-behalf-of-cmd=dh_foo]> B<path ...> + +Mark one or more paths as installed for a given package. This is useful for telling L<dh_missing(1)> that the +paths have been installed manually. + +The B<--on-behalf-of-cmd> option can be used by third-party tools to have B<dh_assistant> list them as the +installer of the provided paths. The convention is to use the basename of the tool itself as its name +(e.g. B<dh_install>). + +Please keep in mind that: + +=over 4 + +=item * + +B<No> glob or substitution expansion is done by B<dh_assistant> on the provided paths. If you want to use globs, +have the shell perform the expansion first. + +=item * + +Paths must be given as relative to the source root directory (e.g., F<debian/tmp/...>) + +=item * + +You I<can> provide a directory. If you do, the directory and anything recursively below it will be considered +as installed. Note that it is fine to provide the directory even if paths inside of it has been excluded as long +as the directory is fully "covered". + +=item * + +Do not worry about providing the same filename twice in different invocations to B<dh_assistant> due to B<-arch> / +B<-indep> overrides. While it will be recorded multiple internally, L<dh_missing(1)> will deduplicate when it +parses the records. + +=back + +Note this command only I<marks> paths as installed. It does not actually install them - the caller should ensure +that the paths are in fact handled (or installed). + +=head1 COMMAND TAGS + +Most commands have one or more of the following "tags" associated with them. Their +meaning is defined here. + +=over 4 + +=item JSON + +The command provides JSON output. See L</JSON OUTPUT> for details. + +=item CRFA + +I<Mnemonic "Can be Run From Anywhere"> + +Most commands must be run inside a source package root directory (a directory +containing F<debian/control>) because debhelper will need the package metadata +to lookup the information. Any command with this tag are exempt from this +requirement and is expected to work regardless of where they are run. + +=back + +=head1 JSON OUTPUT + +Most commands uses JSON format as output. Consumers need to be aware that: + +=over 4 + +=item * + +Additional keys may be added at any time. For backwards compatibility, the absence +of a key should in general be interpreted as null unless another default is documented +or would be "obvious" for that case. + +=item * + +Many keys can be null/undefined in special cases. As an example, some information may +be unavailable when this command is run directly from the debhelper source (git repository). + +=back + +The output will be prettified when stdout is detected as a terminal. If +you need to pipe the output to a pager/file (etc.) and still want it +prettified, please use an external JSON formatter. An example of this: + + dh_assistant supported-compat-levels | json_pp | less + +=cut + +my $JSON_ENCODER = JSON::PP->new->utf8; + +# Prettify if we think the user is reading this. +$JSON_ENCODER = $JSON_ENCODER->pretty->space_before(0)->canonical if -t STDOUT; + +# We never use the log file for this tool +inhibit_log(); + +my %COMMANDS = ( + 'help' => \&_do_help, + '-h' => \&_do_help, + '--help' => \&_do_help, + 'active-compat-level' => \&active_compat_level, + 'supported-compat-levels' => \&supported_compat_levels, + 'which-build-system' => \&which_build_system, + 'detect-hook-targets' => \&detect_hook_targets, + 'log-installed-files' => \&log_installed_files_cmd, +); + +my ($COMMAND) = shift(@ARGV); +for my $arg (@ARGV) { + if ($arg eq '--help' or $arg eq '-h') { + $COMMAND = 'help'; + last; + } +} + + +sub _do_help { + my $me = basename($0); + print <<"EOF"; +${me}: Tool for supporting debhelper tools and provide introspection + +Usage: ${me} <command> [... addition arguments or options ...] + +The following commands are available: + help Show this help + active-compat-level Output information about which compat level is declared/active (JSON) + supported-compat-levels Output information about supported compat levels (JSON, CRFA) + which-build-system Determine which build system will be used (JSON) + detect-hook-targets Detect and output possible override and hook targets (JSON) + log-installed-files Mark one or more paths as "installed" so dh_missing is aware (BLD) + +Command tags: + + * JSON The command provides JSON output. + * CRFA Command does not need to be run from a package source directory + (Mnemonic "Can be Run From Anywhere") + * BLD The command is intended to be used as a part of a package build. + It may leave artifacts behind that will need a dh_clean invocation to remove. + + +Its primary purpose is to provide support for third-party debhelper implementations +not using the debhelper script API or provide introspection for third-party tools +(e.g., linters). Unless stated otherwise, commands must be run inside a source +package root directory - that is, the directory containing "debian/control". + +Most commands use JSON output. When stdout is a TTY, the JSON will be prettified. +See the manpage if you want formatting in other cases. +EOF + return; +} + +sub _assert_debian_control_exists { + return if -f 'debian/control'; + require Cwd; + my $cwd = Cwd::getcwd(); + warning("$cwd does not look like a package source directory (expected $cwd/debian/control to exist and be a file)"); + error("$COMMAND must be run inside a package source directory"); + return; +} + +sub _output { + my ($kvpairs) = @_; + print $JSON_ENCODER->encode($kvpairs); + return; +} + +sub active_compat_level { + if (@ARGV) { + error("$COMMAND: No arguments supported (please remove everything after the command)"); + } + _assert_debian_control_exists(); + my ($active_compat, $declared_compat, $declared_compat_source) = Debian::Debhelper::Dh_Lib::get_compat_info(); + if (not defined($declared_compat_source)) { + $declared_compat = undef; + $active_compat = undef if not exists($ENV{DH_COMPAT}); + } + my %compat_info = ( + 'active-compat-level' => $active_compat, + 'declared-compat-level' => $declared_compat, + 'declared-compat-level-source' => $declared_compat_source, + ); + _output(\%compat_info); + return; +} + +sub supported_compat_levels { + if (@ARGV) { + error("$COMMAND: No arguments supported (please remove everything after the command)"); + } + my %compat_levels = ( + 'MIN_COMPAT_LEVEL' => Debian::Debhelper::Dh_Lib::MIN_COMPAT_LEVEL, + 'LOWEST_NON_DEPRECATED_COMPAT_LEVEL' => Debian::Debhelper::Dh_Lib::LOWEST_NON_DEPRECATED_COMPAT_LEVEL, + 'LOWEST_VIRTUAL_DEBHELPER_COMPAT_LEVEL' => Debian::Debhelper::Dh_Lib::LOWEST_VIRTUAL_DEBHELPER_COMPAT_LEVEL, + 'MAX_COMPAT_LEVEL' => Debian::Debhelper::Dh_Lib::MAX_COMPAT_LEVEL, + 'HIGHEST_STABLE_COMPAT_LEVEL' => Debian::Debhelper::Dh_Lib::HIGHEST_STABLE_COMPAT_LEVEL, + 'MIN_COMPAT_LEVEL_NOT_SCHEDULED_FOR_REMOVAL' => Debian::Debhelper::Dh_Lib::MIN_COMPAT_LEVEL_NOT_SCHEDULED_FOR_REMOVAL, + ); + _output(\%compat_levels); + return; +} + +sub which_build_system { + my ($opt_buildsys, $destdir); + my $first_argv = @ARGV ? $ARGV[0] : ''; + my %options = ( + # Emulate dh_auto_install's --destdir + "destdir=s" => \$destdir, + ); + _assert_debian_control_exists(); + # We never want the build system initialization to modify anything (e.g. create "HOME") + $dh{NO_ACT} = 1; + require Debian::Debhelper::Dh_Buildsystems; + Debian::Debhelper::Dh_Buildsystems::buildsystems_init(options => \%options); + my @non_options = grep { !m/^-/ } @ARGV; + my $step = @non_options ? $non_options[0] : 'configure'; + if (@non_options && $first_argv =~ m/^-/) { + error("$COMMAND: If the build step is provided, it must be before any options"); + } + if (@non_options > 1) { + error("$COMMAND: At most one positional argument is supported"); + } + if (defined($destdir) and $step ne 'install') { + warning("$COMMAND: --destdir is not defined for build step \"$step\". Ignoring option") + } + { + no warnings qw(once); + $opt_buildsys = $Debian::Debhelper::Dh_Buildsystems::opt_buildsys; + } + my $build_system = Debian::Debhelper::Dh_Buildsystems::load_buildsystem($opt_buildsys, $step); + my %result = ( + 'build-system' => defined($build_system) ? $build_system->NAME : 'none', + 'for-build-step' => $step, + 'source-directory' => defined($build_system) ? $build_system->get_sourcedir : undef, + 'build-directory' => defined($build_system) ? $build_system->get_builddir : undef, + 'dest-directory' => defined($build_system) ? $destdir : undef, + 'buildpath' => defined($build_system) ? $build_system->get_buildpath : undef, + 'parallel' => defined($build_system) ? $build_system->get_parallel : undef, + 'upstream-arguments' => $dh{U_PARAMS}, + ); + _output(\%result); + return; +} + +sub _in_path { + my ($cmd) = @_; + for my $dir (split(':', $ENV{PATH})) { + return 1 if -x "${dir}/${cmd}"; + } + return 0; +} + +sub detect_hook_targets { + if (@ARGV) { + error("$COMMAND: No arguments supported (please remove everything after the command)"); + } + _assert_debian_control_exists(); + require Debian::Debhelper::SequencerUtil; + Debian::Debhelper::SequencerUtil::rules_explicit_target('does-not-matter'); + my ($explicit_targets, %result, @targets, @unverifiable_commands, %seen_cmds); + { + no warnings qw(once); + $explicit_targets = \%Debian::Debhelper::SequencerUtil::EXPLICIT_TARGETS; + } + while (my ($target, $non_empty) = each(%{$explicit_targets})) { + next if $target !~ m{^(?:execute_before_|execute_after_|override_)(\S+?)(-indep|-arch)?$}; + my ($command, $archness) = ($1, $2); + my $param; + if ($archness) { + $param = ($archness eq '-arch') ? '-a' : '-i' ; + } + my $target_info = { + 'target-name' => $target, + 'command' => $command, + 'package-section-param' => $param, + 'is-empty' => $non_empty ? JSON::PP::false : JSON::PP::true, + }; + push(@targets, $target_info); + push(@unverifiable_commands, $command) if not exists($seen_cmds{$command}) and not _in_path($command); + $seen_cmds{$command} = 1; + } + $result{'hook-targets'} = \@targets; + $result{'commands-not-in-path'} = \@unverifiable_commands; + _output(\%result); +} + +sub log_installed_files_cmd { + my $on_behalf_of = 'manually-via-dh_assistant'; + init( + options => { + 'on-behalf-of-cmd=s' => \$on_behalf_of, + }, + inhibit_log => 1, + ); + if (index($on_behalf_of, '/') >= 0) { + error('The value for --on-behalf-of-cmd must not contain slashes'); + } + if (@{$dh{DOPACKAGES}} != 1) { + error('The log-installed-files command must act on exactly one package (use -p<pkg> to define which)'); + } + my $package = $dh{DOPACKAGES}[0]; + for my $arg (@ARGV) { + $arg =~ tr:/:/:s; + if (! -e $arg) { + warning("The path ${arg} does not exist - double check it is correct. Note: it will recorded anyway."); + } + } + log_installed_files({ + 'package' => $package, + 'tool_name' => $on_behalf_of, + }, @ARGV); +} + +if (not defined($COMMAND)) { + error('Usage: ' . basename($0) . ' <command>'); +} +my $handler = $COMMANDS{$COMMAND}; +if (not defined($handler)) { + warning("Arguments/options must not be the first argument (except for --help)") + if $COMMAND =~ m/^-/; + error("Unknown command: $COMMAND"); +} + +$handler->(); + +=head1 SEE ALSO + +L<debhelper(7)> + +This program is a part of debhelper. + +=cut + +1; diff --git a/dh_auto_install b/dh_auto_install index 2ca1377536ca1fdcda1e2a3654ee828338ce30d9..420fdfd6af8483927d600f44087627240fd5eb09 100755 --- a/dh_auto_install +++ b/dh_auto_install @@ -29,11 +29,17 @@ if the environment variable is set). If there is a F<setup.py> or F<Build.PL>, it is used. Note that the Ant build system does not support installation, so B<dh_auto_install> will not install files built using Ant. -Unless B<--destdir> option is specified, the files are installed into -debian/I<package>/ if there is only one binary package. In the multiple binary -package case, the files are instead installed into F<debian/tmp/>, and should be -moved from there to the appropriate package build directory using -L<dh_install(1)>. +In compat 15 or later, B<dh_auto_install> will use F<debian/tmp> as the default +B<--destdir> and should be moved from there to the appropriate package build +directory using L<dh_install(1)> or similar tools. Though if the B<single-binary> +addon for L<dh(1)> is activated, then it will pass an explicit +B<< --destdir=debian/I<package>/ >> to B<dh_auto_install>. + +For earlier compat levels then unless B<--destdir> option is +specified, the files are installed into debian/I<package>/ if there is only one +binary package. In the multiple binary package case, the files are instead +installed into F<debian/tmp/>, and should be moved from there to the +appropriate package build directory using L<dh_install(1)> or similar tools. B<DESTDIR> is used to tell make where to install the files. If the Makefile was generated by MakeMaker from a F<Makefile.PL>, it will @@ -76,7 +82,7 @@ buildsystems_init(options => { # If destdir is not specified, determine it automatically if (!$destdir) { my @allpackages=getpackages(); - if (@allpackages > 1) { + if (@allpackages > 1 or not compat(14)) { $destdir="debian/tmp"; } else { diff --git a/dh_builddeb b/dh_builddeb index 7d36fa3ebad35e7512a17f3fc1cd6ca6a8f1d10d..aca17f6da26c22a9d244c4c745d8428a0a1ed80b 100755 --- a/dh_builddeb +++ b/dh_builddeb @@ -80,7 +80,7 @@ sub build_and_rename_deb { my ($package, $destdir, $cmd, $rename_sub) = @_; my $build_dir = "debian/.debhelper/scratch-space/build-${package}"; my ($dpkg_filename, $desired_filename); - install_dir($build_dir); + mkdirs($build_dir); doit(@${cmd}, $build_dir); opendir(my $fd, $build_dir) or error("opendir($build_dir) failed: $!"); for my $name (readdir($fd)) { @@ -107,6 +107,8 @@ sub build_and_rename_deb { my @items; my @dpkg_options; push(@dpkg_options, '--root-owner-group') if not should_use_root(); +my @dbgsym_dpkg_options = ('--root-owner-group'); + for my $package (@{$dh{DOPACKAGES}}) { push(@items, [$package, 0]); @@ -131,7 +133,7 @@ on_items_in_parallel(\@items, sub { if ($dbgsym) { my $dbgsym_tmpdir = dbgsym_tmpdir($package); - my @cmd = ("dpkg-deb", @dpkg_options, @{$dh{U_PARAMS}}, + my @cmd = ("dpkg-deb", @dbgsym_dpkg_options, @{$dh{U_PARAMS}}, "--build", $dbgsym_tmpdir); if (DBGSYM_PACKAGE_TYPE eq DEFAULT_PACKAGE_TYPE) { doit(@cmd, $dh{DESTDIR}); @@ -142,15 +144,7 @@ on_items_in_parallel(\@items, sub { next; } if (exists $ENV{DH_ALWAYS_EXCLUDE} && length $ENV{DH_ALWAYS_EXCLUDE}) { - if (! compat(5)) { - complex_doit("find $tmp $dh{EXCLUDE_FIND} | xargs rm -rf"); - } - else { - # Old broken code here for compatibility. Does not - # remove everything. - complex_doit("find $tmp -name $_ | xargs rm -rf") - foreach split(":", $ENV{DH_ALWAYS_EXCLUDE}); - } + complex_doit("find $tmp $dh{EXCLUDE_FIND} | xargs rm -rf"); } if (! is_udeb($package)) { doit("dpkg-deb", @dpkg_options, @{$dh{U_PARAMS}}, "--build", $tmp, $dh{DESTDIR}.$dh{FILENAME}); diff --git a/dh_compress b/dh_compress index d90c0f2c0cfb94a01ba1e299f48da2b5b476278d..ac7268796376d86b7ae5b7e26e3d5656257f3afe 100755 --- a/dh_compress +++ b/dh_compress @@ -137,6 +137,7 @@ on_pkgs_in_parallel { ! -iname ".htaccess" ! -iname "*.css" \\ ! -iname "*.xz" ! -iname "*.lz" ! -iname "*.lzma" \\ ! -iname "*.haddock" ! -iname "*.hs" \\ + ! -iname "*.woff" ! -iname "*.woff2" \\ ! -iname "*.svg" ! -iname "*.svgz" ! -iname "*.js" \\ ! -name "index.sgml" ! -name "objects.inv" ! -name "*.map" \\ ! -name "*.devhelp2" ! -name "search_index.json" \\ diff --git a/dh_dwz b/dh_dwz index 72c6bc5af819f9284d50484b88b573460f842a9c..1334ee09f6c135c89b407169514563b5e81819e5 100755 --- a/dh_dwz +++ b/dh_dwz @@ -110,7 +110,8 @@ sub testfile { return; } -for my $package (@{$dh{DOPACKAGES}}) { +on_items_in_parallel(\@{$dh{DOPACKAGES}}, sub { +foreach my $package (@_) { my $tmp = tmpdir($package); next if not -d $tmp; @@ -134,13 +135,14 @@ for my $package (@{$dh{DOPACKAGES}}) { doit('dwz', @dwz_options, @{$dh{U_PARAMS}}, '--', @{$unique_files}); if ( -f "${tmp}/${m}") { doit($objcopy, '--compress-debug-sections', "${tmp}/${m}"); + reset_perm_and_owner(0644, "${tmp}/${m}"); } else { error("dwz failed to create a multifile as requested") if $create_multifile ne 'auto'; warning("No dwz multifile created, but not explicitly requested either so ignoring it."); warning("Common issues include no debug information at all (missing -g) and"); warning("compressed debug information (#931891)."); # Clean up after ourselves to avoid leaving empty directories in packages - doit('rmdir', '-p', '--ignore-fail-on-non-empty', "${tmp}/usr/lib/debug/.dwz/${ma_dir}"); + doit('rmdir', '-p', '--ignore-fail-on-non-empty', "${tmp}/${dwz_dir}"); } } else { xargs($unique_files, 'dwz', @{$dh{U_PARAMS}}, '--'); @@ -156,7 +158,7 @@ for my $package (@{$dh{DOPACKAGES}}) { # Make new hardlink. doit('ln', '-f', $target, $hardlink); } -} +}}); =head1 SEE ALSO diff --git a/dh_fixperms b/dh_fixperms index bbfd8b03ebb427cdf92aa4806346c9d89a18bad5..8c491bbc80ae9e369841808bde210c28480b3ea8 100755 --- a/dh_fixperms +++ b/dh_fixperms @@ -61,7 +61,7 @@ sub patterns2find_expr { my $vendorlib = substr $Config{vendorlib}, 1; my $vendorarch = substr $Config{vendorarch}, 1; my @executable_files_dirs = ( - qw{usr/bin bin usr/sbin sbin usr/games etc/init.d}, + qw{usr/bin bin usr/sbin sbin usr/games usr/libexec etc/init.d}, ); my @mode_0644_patterns = ( # Libraries and related files diff --git a/dh_gconf b/dh_gconf deleted file mode 100755 index 619ccb7361e109131729800f9746f271f7fc0495..0000000000000000000000000000000000000000 --- a/dh_gconf +++ /dev/null @@ -1,116 +0,0 @@ -#!/usr/bin/perl - -=head1 NAME - -dh_gconf - install GConf defaults files and register schemas (deprecated) - -=cut - -use strict; -use warnings; -use Debian::Debhelper::Dh_Lib; - -our $VERSION = DH_BUILTIN_VERSION; - -=head1 SYNOPSIS - -B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>] - -=head1 DESCRIPTION - -B<dh_gconf> is a debhelper program that is responsible for installing GConf -defaults files and registering GConf schemas. - -An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>. - -=head1 FILES - -=over 4 - -=item debian/I<package>.gconf-defaults - -Installed into F<usr/share/gconf/defaults/10_package> in the package build -directory, with I<package> replaced by the package name. - -=item debian/I<package>.gconf-mandatory - -Installed into F<usr/share/gconf/mandatory/10_package> in the package build -directory, with I<package> replaced by the package name. - -=back - -=head1 OPTIONS - -=over 4 - -=item B<--priority> I<priority> - -Use I<priority> (which should be a 2-digit number) as the defaults -priority instead of B<10>. Higher values than ten can be used by -derived distributions (B<20>), CDD distributions (B<50>), or site-specific -packages (B<90>). - -=back - -=cut - -init(options => { - "priority=s" => \$dh{PRIORITY}, -}); - -warning("Please migrate to dh_installgsettings; gconf + dh_gconf is scheduled for removal."); - -my $priority=10; -if (defined $dh{PRIORITY}) { - $priority=$dh{PRIORITY}; -} - -# PROMISE: DH NOOP WITHOUT gconf-mandatory gconf-defaults tmp(etc/gconf/schemas) tmp(usr/share/gconf/schemas) cli-options() - -foreach my $package (@{$dh{DOPACKAGES}}) { - my $tmp=tmpdir($package); - - my $mandatory = pkgfile($package, "gconf-mandatory"); - if ($mandatory ne '') { - install_dir("$tmp/usr/share/gconf/mandatory"); - install_file($mandatory, - "$tmp/usr/share/gconf/mandatory/${priority}_$package"); - } - my $defaults = pkgfile($package,"gconf-defaults"); - if ($defaults ne '') { - install_dir("$tmp/usr/share/gconf/defaults"); - install_file($defaults, "$tmp/usr/share/gconf/defaults/${priority}_$package"); - } - - my $old_schemas_dir = "$tmp/etc/gconf/schemas"; - my $new_schemas_dir = "$tmp/usr/share/gconf/schemas"; - - # Migrate schemas from /etc/gconf/schemas to /usr/share/gconf/schemas - if (-d $old_schemas_dir) { - install_dir($new_schemas_dir); - complex_doit("mv $old_schemas_dir/*.schemas $new_schemas_dir/"); - doit("rmdir","-p","--ignore-fail-on-non-empty",$old_schemas_dir); - } - - if (-d "$new_schemas_dir") { - # Get a list of the schemas - my $schemas = qx_cmd('find', $new_schemas_dir, '-type', 'f', '-name', '*.schemas', - '-printf', '%P'); - if ($schemas ne '') { - addsubstvar($package, "misc:Depends", "gconf2 (>= 2.28.1-2)"); - } - } -} - -=head1 SEE ALSO - -L<debhelper(7)> - -This program is a part of debhelper. - -=head1 AUTHOR - -Ross Burton <ross@burtonini.com> -Josselin Mouette <joss@debian.org> - -=cut diff --git a/dh_installalternatives b/dh_installalternatives index c984af085815893b3d67bc1e79a0c3cc1e578da7..7bfbae527ebf9eeb47c79ff784db5b18c3bf56fe 100755 --- a/dh_installalternatives +++ b/dh_installalternatives @@ -99,9 +99,16 @@ sub _parse_alternative_and_generate_maintscript { if (index($link_name, '/') > -1) { error(qq{Invalid link name "${link_name}" in "${alternatives_file}": Must not contain slash}); } - if ( ! -f "${tmpdir}/${impl_path}") { + my $actual_impl_path = "${tmpdir}/${impl_path}"; + if ( ! -l $actual_impl_path && ! -e _) { error(qq{Alternative "${impl_path}" for "${link_name}" in ${alternatives_file} does not exist in ${tmpdir}}); } + if ( -d $actual_impl_path) { + error(qq{Alternative "${impl_path}" for "${link_name}" in ${alternatives_file} is a directory}); + } + if ($link_name eq $impl_path) { + error(qq{The link name cannot be the same as the implementation path "${link_name}" (in "${alternatives_file}")}); + } $maintscript_options{'RM_OPTIONS'} = "--remove ${link_name} ${impl_path}"; $maintscript_options{'INSTALL_OPTIONS'} = "--install ${link_path} ${link_name} ${impl_path} ${priority}"; @@ -133,9 +140,14 @@ sub _parse_alternative_and_generate_maintscript { . qq{ for "${link_name}" in "${alternatives_file}"}); $error_with_def = 1; } + if ($dlink_name eq $dimpl_path) { + warning(qq{The link name cannot be the same as the implementation path for "${dlink_name}"} + . qq{ in "${alternatives_file}"}); + $error_with_def = 1; + } if ($trailing) { warning(qq{Trailing information for dependent link "${dlink_name}" for "${link_name}"} - . qq{ in "${alternatives_file}"}) if $trailing; + . qq{ in "${alternatives_file}"}); warning("Dependent links must consist of exactly 3 space-separated values"); $error_with_def = 1; } diff --git a/dh_installchangelogs b/dh_installchangelogs index 2f71833a4dfec70d7ad3a8c1acb1a1265c42a11b..49c3821ce05f255de77ee43df3d78a2947aa5156 100755 --- a/dh_installchangelogs +++ b/dh_installchangelogs @@ -9,12 +9,13 @@ dh_installchangelogs - install changelogs into package build directories use strict; use warnings; use Debian::Debhelper::Dh_Lib; +use Time::Piece; our $VERSION = DH_BUILTIN_VERSION; =head1 SYNOPSIS -B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] [I<upstream>] +B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] [B<--no-trim>] [I<upstream>] =head1 DESCRIPTION @@ -44,6 +45,11 @@ can be specified as a second parameter. When no plain text variant is specified, a short F<usr/share/doc/package/changelog> is generated, pointing readers at the html changelog file. +The B<debchange>-style Debian changelogs are trimmed to include only +entries more recent than the release date of I<oldstable>. +No trimming will be performed if the B<--no-trim> option is passed or +if the B<DEB_BUILD_OPTIONS> environment variable contains B<notrimdch>. + =head1 FILES =over 4 @@ -87,6 +93,11 @@ filename from being installed. Note that directory name of the changelog is also part of the match. +=item B<--no-trim> + +Install the full changelog, not its trimmed version that includes only +recent entries. + =item I<upstream> Install this file as the upstream changelog. @@ -95,63 +106,18 @@ Install this file as the upstream changelog. =cut -# For binNMUs the first changelog entry is written into an extra file to -# keep the packages coinstallable. -sub install_binNMU_changelog { - my ($package, $input_fn, $changelog_name)=@_; - - open (my $input, "<", $input_fn); - my $line=<$input>; - if (defined $line && $line =~ /\A\S.*;.*\bbinary-only=yes/) { - my $mask=umask 0022; - - my @stat=stat $input_fn or error("could not stat $input_fn: $!"); - my $tmp=tmpdir($package); - my $output_fn="$tmp/usr/share/doc/$package/$changelog_name"; - open my $output, ">", $output_fn - or error("could not open $output_fn for writing: $!"); - my $arch=package_binary_arch($package); - my $output_fn_binary="$output_fn.$arch"; - open my $output_binary, ">", $output_fn_binary - or error("could not open $output_fn_binary for writing: $!"); - - do { - print {$output_binary} $line - or error("Could not write to $output_fn_binary: $!"); - } while(defined($line=<$input>) && $line !~ /\A\S/); - close $output_binary or error("Couldn't close $output_fn_binary: $!"); - utime $stat[8], $stat[9], $output_fn_binary; - - do { - print {$output} $line - or error("Could not write to $output_fn: $!"); - } while(defined($line=<$input>)); - - close $input or error("Couldn't close $input_fn: $!"); - close $output or error("Couldn't close $output_fn: $!"); - utime $stat[8], $stat[9], $output_fn; - - if (should_use_root()) { - chown(0, 0, $output_fn, $output_fn_binary) or error("chown: $!"); - } - - umask $mask; - - return 1; - } - else { - close $input; - return 0; - } -} - init(options => { 'keep|k' => \$dh{K_FLAG}, + 'no-trim' => \$dh{NO_TRIM}, }); my $news_name="NEWS.Debian"; my $changelog_name="changelog.Debian"; +use constant CUTOFF_DATE_STR => "2019-07-06"; # oldstable = Debian 10 Buster +use constant CUTOFF_DATE => Time::Piece->strptime(CUTOFF_DATE_STR, "%Y-%m-%d"); +use constant MIN_NUM_ENTRIES => 4; + my $explicit_changelog = @ARGV ? 1 : 0; my $default_upstream = $ARGV[0]; my $default_upstream_text=$default_upstream; @@ -192,6 +158,107 @@ sub find_changelog { return; } +sub install_debian_changelog { + my ($changelog, $package, $arch, $tmp) = @_; + + if ($dh{NO_TRIM} || get_buildoption("notrimdch")) { + # Install the whole changelog. + install_file($changelog, "$tmp/usr/share/doc/$package/$changelog_name"); + return; + } + + local $ENV{LC_ALL} = "C.UTF-8"; + + my $changelog_trimmed = generated_file($package, "dh_installchangelogs.dch.trimmed"); + my $changelog_binnmu = generated_file($package, "dh_installchangelogs.dch.binnmu"); + + open(my $log1, "<", $changelog) or error("Cannot open($changelog): $!"); + open(my $log2, ">", $changelog_trimmed) or error("Cannot open($changelog_trimmed): $!"); + + my $error_in_changelog = 0; + my $is_binnmu = 0; + my $entry = ""; + my $entry_num = 0; + while (my $line=<$log1>) { + $entry .= $line; + + # Identify binNUM packages by binary-only=yes in the first line of the changelog. + if (($. == 1) && ($line =~ /\A\S.*;.*\bbinary-only=yes/)) { + $is_binnmu = 1; + } + + # Get out of binNMU mode once we are in the second entry (and throw away one empty line). + if ($is_binnmu && ($entry_num eq 1)) { + $is_binnmu = 0; + $entry_num = 0; + $entry = ""; + next; + } + + if ($line =~ /^\s*--\s+.*?\s+<[^>]*>\s+(?<timestamp>.*)$/) { + if ($is_binnmu && ($entry_num eq 0)) { + # For binNMUs the first changelog entry is written into an extra file to + # keep the packages coinstallable. + open(my $log_binnum, ">", $changelog_binnmu) or error("Cannot open($changelog_binnmu): $!"); + print($log_binnum $entry) or error("Cannot write($changelog_binnmu): $!"); + close($log_binnum) or error("Cannot close($changelog_binnmu): $!"); + + # Continue processing the rest of the changelog. + $entry = ""; + $entry_num++; + next; + } + + my $timestamp = $+{timestamp}; + $timestamp =~ s/^[A-Za-z]+, +//; + + my $entry_time; + eval { $entry_time = Time::Piece->strptime($timestamp, '%d %b %Y %T %z') }; + if (! defined $entry_time) { + $error_in_changelog = 1; + warning("Could not parse timestamp '$timestamp'. $changelog will not be trimmed."); + truncate($log2, 0) or error("Cannot truncate($changelog_trimmed): $!"); + last; + } + + # Stop processing the changelog if we reached the cut-off date and + # at least MIN_NUM_ENTRIES entries have been added. + if (($entry_time < CUTOFF_DATE) && ($entry_num >= MIN_NUM_ENTRIES)) { + last; + } + + # Append entry to trimmed changelog. + print($log2 $entry) or error("Cannot write($changelog_trimmed): $!"); + $entry = ""; + $entry_num++; + } + } + # If the whole changelog has not been read, then it has been trimmed. + my $has_been_trimmed = !eof($log1); + + close($log1) or error("Cannot close($changelog): $!"); + close($log2) or error("Cannot close($changelog_trimmed): $!"); + + if ($error_in_changelog) { + # If the changelog could not be trimmed, fall back to the full changelog. + warning("$changelog could not be trimmed. The full changelog will be installed."); + $changelog_trimmed = $changelog; + } elsif ($has_been_trimmed) { + # Otherwise add a comment stating that this changelog has been trimmed. + my $note = "\n"; + $note .= "# Older entries have been removed from this changelog.\n"; + $note .= "# To read the complete changelog use `apt changelog $package`.\n"; + open(my $log2, ">>", $changelog_trimmed) or error("Cannot open($changelog_trimmed): $!"); + print($log2 $note) or error("Cannot write($changelog_trimmed): $!"); + close($log2) or error("Cannot close($changelog_trimmed): $!"); + } + + install_file($changelog_trimmed, "$tmp/usr/share/doc/$package/$changelog_name"); + if (-s $changelog_binnmu) { + install_file($changelog_binnmu, "$tmp/usr/share/doc/$package/$changelog_name.$arch"); + } +} + on_pkgs_in_parallel { foreach my $package (@_) { next if is_udeb($package); @@ -249,10 +316,8 @@ on_pkgs_in_parallel { install_dir("$tmp/usr/share/doc/$package"); if (! $dh{NO_ACT}) { - if (! install_binNMU_changelog($package, $changelog, $changelog_name)) { - install_file($changelog, - "$tmp/usr/share/doc/$package/$changelog_name"); - } + my $arch = package_binary_arch($package); + install_debian_changelog($changelog, $package, $arch, $tmp); } if (-e $news) { diff --git a/dh_installcron b/dh_installcron index 41786c34cb66655e74e1a3b3d3799fd002ffcc21..9325b0ef1856ae0e9511b11464820a2958be495b 100755 --- a/dh_installcron +++ b/dh_installcron @@ -31,6 +31,8 @@ cron scripts. =item debian/I<package>.cron.monthly +=item debian/I<package>.cron.yearly + =item debian/I<package>.cron.hourly =item debian/I<package>.cron.d @@ -56,11 +58,11 @@ as the package name. init(); -# PROMISE: DH NOOP WITHOUT cron.hourly cron.daily cron.weekly cron.monthly cron.d cli-options() +# PROMISE: DH NOOP WITHOUT cron.hourly cron.daily cron.weekly cron.monthly cron.yearly cron.d cli-options() foreach my $package (@{$dh{DOPACKAGES}}) { my $tmp=tmpdir($package); - foreach my $type (qw{hourly daily weekly monthly}) { + foreach my $type (qw{hourly daily weekly monthly yearly}) { my $cron=pkgfile($package,"cron.$type"); if ($cron) { install_dir("$tmp/etc/cron.$type"); diff --git a/dh_installdeb b/dh_installdeb index 25ed4e828f3c1518d7bc61497967b90c613dd9f7..b9fd72bff59f9bb0bd97dbc525ebf6b5faa2a6bf 100755 --- a/dh_installdeb +++ b/dh_installdeb @@ -56,13 +56,13 @@ earlier. In compat 10, please use L<dh_makeshlibs(1)>. =item I<package>.conffiles -Historically, this file was needed to manually mark files files as -conffiles. However, it has become de facto obsolete since debhelper -automatically computed which files should be marked as conffiles. +This file will be installed into the F<DEBIAN> directory. The +provided file will be enriched by debhelper to include all the +B<conffiles> auto-detected by debhelper (the maintainer should +not list there as debhelper assumes it should handle that part). -In compatibility level up and including 11, this control file will be -installed into the F<DEBIAN> directory. In compatibility level 12 and -later, the file is silently ignored. +This file is primarily useful for using "special" entries such as +the B<< remove-on-upgrade >> feature from dpkg. =item I<package>.maintscript @@ -92,6 +92,13 @@ the commands listed in this file to catch common mistakes. The validation is enabled as a warning since compat 10 and as a hard error in compat 12. +Where possible, B<dh_installdeb> may choose to rewrite some or all +of the entries into equivalent features supported in dpkg without +relying on maintainer scripts at its sole discretion (examples +include rewriting B<rm_conffile> into dpkg's B<remove-on-upgrade>). +The minimum requirement for activating this feature is that debhelper +runs in compat 10 or later. + Supports substitution variables in compat 13 and later as documented in L<debhelper(7)>. @@ -249,6 +256,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } my $maintscriptfile=pkgfile($package, "maintscript"); + my @special_conffiles_entries; if ($maintscriptfile) { if (compat(9)) { foreach my $line (filedoublearray($maintscriptfile)) { @@ -277,26 +285,34 @@ foreach my $package (@{$dh{DOPACKAGES}}) { if (my $validator = $maintscript_validator{$cmd}) { $validator->($package, @{$line}); } + if (0) { # Disabled for now: #994919 + #994903 + my $current_conffile = $line->[1]; + push(@special_conffiles_entries, "remove-on-upgrade ${current_conffile}"); + addsubstvar($package, "misc:Pre-Depends", "dpkg (>= 1.20.6~)"); + next; + } push(@params, escape_shell(@{$line}) ); } - foreach my $script (qw{postinst preinst prerm postrm}) { - my $subst = sub { - my @res; - chomp; - for my $param (@params) { - my $line = $_; - $line =~ s{#PARAMS#}{$param}g; - push(@res, $line); - } - $_ = join("\n", @res) . "\n"; - }; - autoscript($package, $script, "maintscript-helper", $subst); + if (@params) { + foreach my $script (qw{postinst preinst prerm postrm}) { + my $subst = sub { + my @res; + chomp; + for my $param (@params) { + my $line = $_; + $line =~ s{#PARAMS#}{$param}g; + push(@res, $line); + } + $_ = join("\n", @res) . "\n"; + }; + autoscript($package, $script, "maintscript-helper", $subst); + } } } } # Install debian scripts. - my $package_subst = per_package_subst($package, \%PROVIDED_SUBST); + my $package_subst = debhelper_script_per_package_subst($package, \%PROVIDED_SUBST); foreach my $script (qw{postinst preinst prerm postrm}) { debhelper_script_subst($package, $script, $package_subst); } @@ -304,7 +320,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) { # Install non-executable files my @non_exec_files; # Removed in compat 12. - push(@non_exec_files, 'conffiles') if compat(11); + push(@non_exec_files, 'conffiles'); # In compat 10, we let dh_makeshlibs handle "shlibs". push(@non_exec_files, 'shlibs') if compat(9); foreach my $file (@non_exec_files) { @@ -315,6 +331,13 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } install_triggers($package, $tmp); + if (@special_conffiles_entries) { + open(my $fd, '>>', "$tmp/DEBIAN/conffiles"); + for my $line (@special_conffiles_entries) { + print {$fd} "${line}\n"; + } + close($fd); + } # Automatic conffiles registration: If it is in /etc, it is a # conffile. @@ -324,9 +347,10 @@ foreach my $package (@{$dh{DOPACKAGES}}) { if (-z "$tmp/DEBIAN/conffiles") { rm_files("$tmp/DEBIAN/conffiles"); } - else { - reset_perm_and_owner(0644, "$tmp/DEBIAN/conffiles"); - } + } + + if ( -f "$tmp/DEBIAN/conffiles") { + reset_perm_and_owner(0644, "$tmp/DEBIAN/conffiles"); } } @@ -392,23 +416,6 @@ sub _maybe_error { } } -sub per_package_subst { - my ($package, $provided_subst) = @_; - my %vars = %{$provided_subst}; - $vars{'PACKAGE'} = $package if not exists($vars{'PACKAGE'}); - for my $var (keys(%{$provided_subst})) { - if ($var !~ $Debian::Debhelper::Dh_Lib::MAINTSCRIPT_TOKEN_REGEX) { - warning("User defined token ${var} does not match ${Debian::Debhelper::Dh_Lib::MAINTSCRIPT_TOKEN_REGEX}"); - error("Invalid provided token ${var}: It cannot be substituted as it does not follow the token name rules"); - } - if ($var =~ m/^pkg[.]\Q${package}\E[.](.+)$/) { - my $new_key = $1; - $vars{$new_key} = $provided_subst->{$var}; - } - } - return \%vars; -} - =head1 SEE ALSO L<debhelper(7)> diff --git a/dh_installdebconf b/dh_installdebconf index 13dff7dcba151b0409d02b9e11f91afc885fbfa6..79d50d2899af0b5185795adf0eb6e79f656cfdd3 100755 --- a/dh_installdebconf +++ b/dh_installdebconf @@ -73,11 +73,114 @@ Do not modify F<postrm> script. Pass the params to B<po2debconf>. +=item B<-D>I<TOKEN=VALUE>, B<--define> I<TOKEN=VALUE> + +Define tokens to be replaced inside the maintainer scripts when +it is generated. Please note that the limitations described in +L</Limitations in token names> also applies to tokens defined +on the command line. Invalid token names will trigger an error. + +In the simple case, this parameter will cause B<< #I<TOKEN># >> +to be replaced by I<VALUE>. If I<VALUE> starts with a literal +I<@>-sign, then I<VALUE> is expected to point to a file +containing the actual value to insert. + +An explicit declared token with this parameter will replace built-in +tokens. + +Test examples to aid with the understanding: + + cat >> debian/config <<EOF + #SIMPLE# + #FILEBASED# + EOF + echo -n "Complex value" > some-file + dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file + +In this example, B<#SIMPLE#> will expand to B<direct> and B<#FILEBASED#> +will expand to B<Complex value>. + +It is also possible to set package-specific values for a given +token. This is useful when B<dh_installdebconf> is acting on multiple +packages that need different values for the same token. This is +done by prefixing the token name with B<< pkg.I<package-name>. >>. + +This can be used as in the following example: + + cat >> debian/foo.config <<EOF + # Script for #PACKAGE# + #TOKEN# + EOF + cat >> debian/bar.config <<EOF + # Script for #PACKAGE# + #TOKEN# + EOF + cat >> debian/baz.config <<EOF + # Script for #PACKAGE# + #TOKEN# + EOF + dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \ + --define pkg.baz.TOKEN=unique-baz-value + +In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo.config>, +to B<unique-bar-value> in F<debian/bar.config> and to B<unique-baz-value> +in F<debian/baz.config>. + +Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E.g. +you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.config> and it will +be replaced by B<unique-bar-value>. + =back +=head1 SUBSTITUTION IN MAINTAINER SCRIPTS + +The B<dh_installdebconf> will automatically replace the following tokens +inside a provided maintainer script (if not replaced via B<-D>/B<--define>): + +=over 4 + +=item #DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME># + +These tokens are replaced with the respective variable from +L<dpkg-architecture(1)>. In almost all cases, you will want +use the B<< #DEB_HOST_I<NAME> >> variant in a script to ensure +you get the right value when cross-building. + +On a best effort, tokens of this pattern that do not match +a variable in L<dpkg-architecture(1)> will be left as-is. + +=item #ENV.I<NAME># + +These tokens of this form will be replaced with value of the +corresponding environment variable. If the environment +variable is unset, the token is replaced with the empty +string. + +Note that there are limits on which names can be used (see +L</Limitations in token names>). + +=item #PACKAGE# + +This token is by default replaced by the package name, which will contain +the concrete script. + +=back + +=head2 Limitations in token names + +All tokens intended to be substituted must match the regex: #[A-Za-z0-9_.+]+# + +Tokens that do not match that regex will be silently ignored if found in the +script template. Invalid token names passed to B<-D> or B<--define> will +cause B<dh_installdebconf> to reject the command with an error in most cases. + =cut -init(); +my %PROVIDED_SUBST; + +init(options => { + 'define|D=s%' => \%PROVIDED_SUBST, +}); my @extraparams; if (defined($dh{U_PARAMS})) { @@ -94,7 +197,9 @@ foreach my $package (@{$dh{DOPACKAGES}}) { install_dir("$tmp/DEBIAN"); if (! is_udeb($package)) { - debhelper_script_subst($package, "config"); + # Install debian scripts. + my $package_subst = debhelper_script_per_package_subst($package, \%PROVIDED_SUBST); + debhelper_script_subst($package, "config", $package_subst); } if ($templates ne '') { diff --git a/dh_installdocs b/dh_installdocs index 0e28e529076422c7940de1ab64414e84a68a85ca..2e4529d123c6feebd0b5d32a04d16ee3d840278a 100755 --- a/dh_installdocs +++ b/dh_installdocs @@ -424,30 +424,13 @@ foreach my $package (getpackages()) { if (%doc_ids) { install_dir("$tmp/usr/share/doc-base/"); } - # check for duplicate document ids - my %used_doc_ids; - for my $fn (keys %doc_ids) { - $used_doc_ids{$doc_ids{$fn}}++; - } foreach my $fn (keys %doc_ids) { - # if this document ID is duplicated, we will install - # to usr/share/doc-base/packagename instead of - # usr/share/doc-base/doc_id. To allow for multiple - # conflicting doc-bases in a single package, we will - # install to usr/share/doc-base/packagename-extrabits - # if the doc-base file is - # packagename.doc-base.extrabits - if ($used_doc_ids{$doc_ids{$fn}} > 1) { - my $fn_no_docbase = $fn; - $fn_no_docbase =~ s/\.doc-base(?:\.(.*))?/ - if (defined $1 and length $1) {"-$1"} else {''}/xe; - install_file("debian/$fn", - "$tmp/usr/share/doc-base/$fn_no_docbase"); - } - else { - install_file("debian/$fn", - "$tmp/usr/share/doc-base/$doc_ids{$fn}"); - } + # To avoid issues with duplicated document IDs, we will always + # install to usr/share/doc-base/<packagename>.<doc_id> instead + # of just usr/share/doc-base/<packagename> or just + # usr/share/doc-base/<doc_id>. See #525821 and #980903. + install_file("debian/$fn", + "$tmp/usr/share/doc-base/$package.$doc_ids{$fn}"); } } diff --git a/dh_installexamples b/dh_installexamples index f0c0b4fb6372352bf385129a7beb9f54441bbe30..ce970ac8f36af9f52b44499565b96a07434aefc1 100755 --- a/dh_installexamples +++ b/dh_installexamples @@ -36,6 +36,10 @@ directory (or wherever you've told it to look using B<--sourcedir>). Lists example files or directories to be installed. +If upstream provides an F<examples> directory, you will often want to use B<examples/*> rather +than B<examples> in this file. The latter would create +F<< /usr/share/doc/I<package>/examples/examples >>, which is rarely what you want. + Supports substitution variables in compat 13 and later as documented in L<debhelper(7)>. diff --git a/dh_installinit b/dh_installinit index 2bf48f514ffd0fc7211fbffa2ae112c2a28b1899..13df43243bf599cc63ba597f9ac96ffcf549b35c 100755 --- a/dh_installinit +++ b/dh_installinit @@ -64,14 +64,13 @@ etc/init/I<package>.conf in the package build directory. =item debian/I<package>.service -If this exists, it is installed into lib/systemd/system/I<package>.service in +If this exists, it is installed into F<< lib/systemd/system/I<package>.service >> in the package build directory. Only used in compat levels 10 and below. =item debian/I<package>.tmpfile If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in the -package build directory. (The tmpfiles.d mechanism is currently only used -by systemd.) Only used in compat levels 10 and below. +package build directory. Only used in compat levels 10 and below. =back @@ -366,45 +365,31 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } if (! $dh{NOSCRIPTS}) { + my $replace = { + 'SCRIPT' => $script, + 'INITPARMS' => $params, + 'ERROR_HANDLER' => $dh{ERROR_HANDLER}, + 'INVOKE_RCD_PARAMS' => $update_rcd_params, + }; + autoscript($package, 'preinst', 'preinst-init-chmod', $replace, \%snippet_options); + if (! $dh{NO_START}) { if ($dh{RESTART_AFTER_UPGRADE}) { # update-rc.d, and restart (or # start if new install) script - autoscript($package, 'postinst', 'postinst-init-restart', - { - 'SCRIPT' => $script, 'INITPARMS' => $params, 'ERROR_HANDLER' => $dh{ERROR_HANDLER}, - 'INVOKE_RCD_PARAMS' => $update_rcd_params, - }, - \%snippet_options); + autoscript($package, 'postinst', 'postinst-init-restart', $replace, \%snippet_options); } else { # update-rc.d, and start script - autoscript($package, 'postinst', 'postinst-init', - { - 'SCRIPT' => $script, 'INITPARMS' => $params, 'ERROR_HANDLER' => $dh{ERROR_HANDLER}, - 'INVOKE_RCD_PARAMS' => $update_rcd_params, - }, - \%snippet_options); - } - - if ($dh{R_FLAG} || $dh{RESTART_AFTER_UPGRADE}) { - # stops script only on remove - autoscript($package, 'prerm', 'prerm-init-norestart', - { - 'SCRIPT' => $script, 'ERROR_HANDLER' => $dh{ERROR_HANDLER}, - 'INVOKE_RCD_PARAMS' => $update_rcd_params, - }, - \%snippet_options); - } - else { - # always stops script - autoscript($package, 'prerm', 'prerm-init', - { - 'SCRIPT' => $script, 'ERROR_HANDLER' => $dh{ERROR_HANDLER}, - 'INVOKE_RCD_PARAMS' => $update_rcd_params, - }, - \%snippet_options); + autoscript($package, 'postinst', 'postinst-init', $replace, \%snippet_options); } + + autoscript($package, 'preinst', 'preinst-init-stop', $replace, \%snippet_options) + unless ($dh{R_FLAG} || $dh{RESTART_AFTER_UPGRADE}); + + # stops script only on remove + autoscript($package, 'prerm', 'prerm-init-norestart', $replace, \%snippet_options); + # The --skip-systemd-native option requires # init-system-helpers (>= 1.54) and since we need it # from prerm we need init-system-helpers to have been @@ -414,9 +399,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } else { # just update-rc.d - autoscript($package,"postinst", "postinst-init-nostart", - { 'SCRIPT' => $script, 'INITPARMS' => $params, 'ERROR_HANDLER' => $dh{ERROR_HANDLER} }, - \%snippet_options); + autoscript($package,"postinst", "postinst-init-nostart", $replace, \%snippet_options); } # removes rc.d links diff --git a/dh_installman b/dh_installman index 67a2d62f75a22e1a9e48b43a14b86deabfad231d..015d439d2c10366b9def1d7cb5b2d6db89c51576 100755 --- a/dh_installman +++ b/dh_installman @@ -210,7 +210,7 @@ on_items_in_parallel(\@all_packages, sub { close($fd); # Failing that, we can try to get it from the filename. if (!$section) { - ($section) = $basename =~ m/\.([1-9]\S*)/; + ($section) = $basename =~ m/\.([1-9]\w*)$/; } # Now get the numeric component of the section. @@ -236,6 +236,10 @@ on_items_in_parallel(\@all_packages, sub { # language code to the filename, so detect that and # redirect to appropriate directory, stripping the code. ($langcode) = $basename =~ m/\.([a-z][a-z](?:_[A-Z][A-Z])?)\.(?:[1-9]|man)/; + # Avoid false positives such as /usr/share/man/man8/libnss_myhostname.so.2.8 + if (defined $langcode && $langcode eq 'so' && $basename =~ /^lib.*\.so(\.[0-9]+)*$/) { + $langcode = ''; + } } } elsif ($dh{LANGUAGE} ne 'C') { $langcode = $dh{LANGUAGE}; @@ -253,7 +257,6 @@ on_items_in_parallel(\@all_packages, sub { my $instpage = "$destdir$instname.$section"; next if -l $instpage; - next if -e _ && compat(5); install_dir($destdir); if ($gz) { diff --git a/dh_installpam b/dh_installpam index 54f670a0eb08bd60070619b401d8147eb67dc4d9..193e3344a808d7c9b550dfc810d5ff08ec80fb44 100755 --- a/dh_installpam +++ b/dh_installpam @@ -27,7 +27,11 @@ files used by PAM into package build directories. =item debian/I<package>.pam -Installed into etc/pam.d/I<package> in the package build directory. +Installed into usr/lib/pam.d/I<package> in the package build directory. + +Until compatibility level 14 this file was installed under +etc/pam.d/I<package>. Please consider using the "rm_conffile" feature from +L<dh_installdeb(1)> to ensure the proper removal of previous PAM files. =back @@ -38,7 +42,7 @@ Installed into etc/pam.d/I<package> in the package build directory. =item B<--name=>I<name> Look for files named debian/I<package>.I<name>.pam and install them as -etc/pam.d/I<name>, instead of using the usual files and installing them +usr/lib/pam.d/I<name>, instead of using the usual files and installing them using the package name. =back @@ -53,9 +57,14 @@ foreach my $package (@{$dh{DOPACKAGES}}) { my $tmp=tmpdir($package); my $pam=pkgfile($package,"pam"); + my $pamd_dir="/usr/lib/pam.d"; + if (compat(13)) { + $pamd_dir="/etc/pam.d"; + } + if ($pam ne '') { - install_dir("$tmp/etc/pam.d"); - install_file($pam,"$tmp/etc/pam.d/".pkgfilename($package)); + install_dir("$tmp/$pamd_dir"); + install_file($pam,"$tmp/$pamd_dir/".pkgfilename($package)); } } diff --git a/dh_installsystemd b/dh_installsystemd index 17f2bc83c5b633aade8d3423e3feb2a74ea3238b..aba9d783d0a9f88e362ee9e9978a177ee48b429a 100755 --- a/dh_installsystemd +++ b/dh_installsystemd @@ -312,7 +312,7 @@ if (compat(12)) { find({ wanted => sub { my $name = $File::Find::name; - return unless -f $name; + return if not -f $name or not $name =~ m{[.]conf$}; push(@tmpfiles, basename($name)); }, no_chdir => 1, }, @dirs) if @dirs; @@ -428,13 +428,13 @@ foreach my $package (@{$dh{DOPACKAGES}}) { autoscript($package, 'postinst', 'postinst-systemd-start', $replace, \%options); } - if ($dh{R_FLAG} || $dh{RESTART_AFTER_UPGRADE}) { - # stop service only on remove - autoscript($package, 'prerm', 'prerm-systemd-restart', $replace, \%options); - } elsif (!$dh{NO_START}) { - # always stop service - autoscript($package, 'prerm', 'prerm-systemd', $replace, \%options); - } + # stop service before upgrade, if requested + autoscript($package, 'preinst', 'preinst-systemd-stop', $replace, \%options) + unless ($dh{R_FLAG} || $dh{RESTART_AFTER_UPGRADE}); + + # stop service only on remove + autoscript($package, 'prerm', 'prerm-systemd-restart', $replace, \%options) + unless ($dh{NO_START}); # Run this with "default" order so it is always after other # service related autosnippets. diff --git a/dh_installsystemduser b/dh_installsystemduser index 44f3c8400f68db2355d56a00f696b596de793393..7ab7933c43607f6d5d535b1151ac29fa08beb31a 100755 --- a/dh_installsystemduser +++ b/dh_installsystemduser @@ -19,10 +19,10 @@ B<dh_installsystemduser> [S<I<debhelper options>>] [B<--no-enable>] [B<--name=>I =head1 DESCRIPTION B<dh_installsystemduser> finds the systemd user instance service files -installed by a package and generates F<postinst>, and F<prerm> code -blocks for enabling and disabling the corresponding systemd user -instance services, when the package is installed, updated, or -removed. These snippets are added to the maintainer scripts by +installed by a package and generates F<preinst>, F<postinst>, and F<prerm> +code blocks for enabling, disabling, starting, stopping, and restarting the +corresponding systemd user instance services, when the package is installed, +updated, or removed. These snippets are added to the maintainer scripts by L<dh_installdeb(1)>. L<deb-systemd-helper(1)> is used to enable and disable the systemd @@ -190,7 +190,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) { # Generate postinst and prerm code blocks to enable and disable units foreach my $package (@{$dh{DOPACKAGES}}) { - my (@args, @enable_units, %aliases); + my (@args, @start_units, @enable_units, %aliases); my $tmpdir = tmpdir($package); my @units = list_installed_user_units($tmpdir, \%aliases); @@ -240,9 +240,11 @@ foreach my $package (@{$dh{DOPACKAGES}}) { push @args, $_ for grep { !$seen{$_}++ } extract_key($path, 'Also'); push @enable_units, $name if contains_install_section($path); + push @start_units, $name; } @enable_units = map { quote($_) } sort(uniq(@enable_units)); + @start_units = map { quote($_) } sort(uniq(@start_units)); if (@enable_units) { # The generated maintainer script code blocks use the --user @@ -255,6 +257,24 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } autoscript($package, 'postrm', 'postrm-systemd-user', { 'UNITFILES' => join(' ', @enable_units) }); } + + if (@start_units and not compat(13)) { + # The generated maintainer script code blocks use the --user + # option that was added to deb-systemd-invoke in version 1.61. + addsubstvar($package, 'misc:Depends', 'init-system-helpers', ">= 1.61~"); + + my %options = ('snippet-order' => 'service'); + + # restart service after install/upgrade + autoscript($package, 'postinst', 'postinst-systemd-user-restart', { 'UNITFILES' => join(' ', @start_units) }, \%options); + + # stop service after removal + autoscript($package, 'prerm', 'prerm-systemd-user-stop', { 'UNITFILES' => join(' ', @start_units) }, \%options); + + # Run this with "default" order so it is always after other + # service related autosnippets. + autoscript($package, 'postrm', 'postrm-systemd-user-reload-only', { 'UNITFILES' => join(' ', @start_units) }); + } } =head1 SEE ALSO diff --git a/dh_installsysusers b/dh_installsysusers index 9536b66ad9958dd41df383ba0c0def1b7e2dcc20..faa4b8e5bc27305f88129caa3710997e309c09a6 100755 --- a/dh_installsysusers +++ b/dh_installsysusers @@ -87,16 +87,21 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } if (! $dh{NOSCRIPTS} && ($sysusers ne '' || -d $sysusers_targetdir)) { - my $has_sysuser = 0; + my @sysusers_files; opendir(my $dir_fd, $sysusers_targetdir) or error("opendir(${sysusers_targetdir}) failed: $!"); while (defined(my $entry = readdir($dir_fd))) { next if $entry eq '.' or $entry eq '..' or $entry !~ m{[.]conf$}; - autoscript($package, 'postinst', 'postinst-sysusers', { 'CONFILE_BASENAME' => $entry }); - $has_sysuser = 1; + push @sysusers_files, $entry; } closedir($dir_fd); - addsubstvar($package, "misc:Depends", "systemd | systemd-standalone-sysusers | systemd-sysusers") - if $has_sysuser; + + next if @sysusers_files == 0; + + # Sort list of files so postinst content doesn't change if readdir's output is not stable + @sysusers_files = sort @sysusers_files; + # Generate a single systemd-sysusers invocation and just pass all detected files together + autoscript($package, 'postinst', 'postinst-sysusers', { 'CONFILE_BASENAME' => "@sysusers_files" }); + addsubstvar($package, "misc:Depends", "systemd | systemd-standalone-sysusers | systemd-sysusers"); } } diff --git a/dh_installtmpfiles b/dh_installtmpfiles index eff4869b6d21b7a051b87b4d9d568dad3bcaa1aa..aa5ab7227f0537ff0804046884f7ed363bc13931 100755 --- a/dh_installtmpfiles +++ b/dh_installtmpfiles @@ -24,7 +24,7 @@ installing package maintainer supplied tmpfiles.d configuration files (e.g. for systemd-tmpfiles). It also finds the tmpfiles.d configuration files installed by a package -and generates F<postinst> code blocks for activting the tmpfiles.d +and generates F<postinst> code blocks for activating the tmpfiles.d configuration when the package is installed. These snippets are added to the maintainer scripts by L<dh_installdeb(1)>. @@ -33,6 +33,8 @@ to the maintainer scripts by L<dh_installdeb(1)>. =over 4 +=item B<--name=>I<name> + This option controls both a prefix used for lookng up maintainer provided tmpfiles.d configuration files (those mentioned in the L</FILES> section) and also the base name used for the installed version of the file. @@ -109,7 +111,7 @@ foreach my $package (@{$dh{DOPACKAGES}}) { find({ wanted => sub { my $name = $File::Find::name; - return unless -f $name; + return if not -f $name or not $name =~ m{[.]conf$}; push(@tmpfiles, basename($name)); }, no_chdir => 1, }, @dirs) if @dirs; diff --git a/dh_installwm b/dh_installwm index d3b4f7d5f6fbed8c8a33da06df63b2ab437edd13..d5e0599d7a74596e090b7f866233a5d48dc09a34 100755 --- a/dh_installwm +++ b/dh_installwm @@ -109,13 +109,11 @@ WM: foreach my $wm (@wm) { autoscript($package,"prerm","prerm-wm", { 'WM' => $wm }); my $wmman; - if (! compat(5)) { - foreach my $ext (".1", ".1x") { - $wmman="/usr/share/man/man1/".basename($wm).$ext; - if (-e "$tmp$wmman" || -e "$tmp$wmman.gz") { - autoscript($package,"postinst","postinst-wm", { 'WM' => $wm, 'WMMAN' => "${wmman}.gz" , 'PRIORITY' => $dh{PRIORITY} }); - next WM; - } + foreach my $ext (".1", ".1x") { + $wmman="/usr/share/man/man1/".basename($wm).$ext; + if (-e "$tmp$wmman" || -e "$tmp$wmman.gz") { + autoscript($package,"postinst","postinst-wm", { 'WM' => $wm, 'WMMAN' => "${wmman}.gz" , 'PRIORITY' => $dh{PRIORITY} }); + next WM; } } if (not compat(9) and not $nodocs) { diff --git a/dh_md5sums b/dh_md5sums index e1cc26a09f82b925339d191d021c8a6b6d96a026..8f928438d0b81143dda1d2a0e598b0e83f6f4f66 100755 --- a/dh_md5sums +++ b/dh_md5sums @@ -35,7 +35,7 @@ The md5sums file is installed with proper permissions and ownerships. =item B<-x>, B<--include-conffiles> Include conffiles in the md5sums list. Note that this information is -redundant since it is included elsewhere in Debian packages. +redundant since it is included in F</var/lib/dpkg/status> in Debian packages. =item B<-X>I<item>, B<--exclude=>I<item> diff --git a/dh_missing b/dh_missing index 7bdff6be2c52ac1267c8e80c581bba725a12d215..6524d1e695b18fcfda9b4f007dc69df1b8950bb9 100755 --- a/dh_missing +++ b/dh_missing @@ -6,7 +6,7 @@ dh_missing - check for missing files =cut -use v5.24; +use v5.28; use warnings; use Debian::Debhelper::Dh_Lib; diff --git a/dh_perl b/dh_perl index 7cfef5c65181bf9c79ff45c011b44bcfe2af80fa..62ffcaa5b04e3b6c2b8db81bf660f953d5bf2b62 100755 --- a/dh_perl +++ b/dh_perl @@ -11,6 +11,7 @@ use warnings; use Config; use File::Find; use Debian::Debhelper::Dh_Lib; +use constant DISTRO_PERL => $^X; our $VERSION = DH_BUILTIN_VERSION; @@ -128,10 +129,15 @@ foreach my $package (@{$dh{DOPACKAGES}}) { return unless -f and (-x _ or /\.pl$/); return unless open(my $fd, '<', $_); - if (read($fd, local $_, 32) and m%^#!\s*(/usr/bin/perl|/usr/bin/env\s+perl)\s%) { + my $path = $_; + my $rewrite_shebang = 0; + if (read($fd, local $_, 32) and m%^#!\s*(/usr/bin/perl|${\DISTRO_PERL}|/usr/bin/env\s+perl)\s%) { + my $actual_perl = $1; $deps |= PROGRAM; + $rewrite_shebang = 1 if ($actual_perl ne DISTRO_PERL); } close($fd); + rewrite_shebang($path) if $rewrite_shebang; }; find({ wanted => $check_script, @@ -151,8 +157,8 @@ foreach my $package (@{$dh{DOPACKAGES}}) { # no need to depend on an un-versioned perl-base -- it's # essential - addsubstvar($package, "perl:Depends", $perlarch) - unless $perl eq 'perl-base' && ! length($version); + addsubstvar($package, "perl:Depends", $perlarch, $version) + if $perl ne 'perl-base' || length($version); # add perlapi-<ver> for XS modules and other modules # installed into vendorarch @@ -171,6 +177,14 @@ foreach my $package (@{$dh{DOPACKAGES}}) { } } +sub rewrite_shebang { + my ($file) = @_; + doit($^X, '-p', '-i', '-e', + 's{#!\s*(/usr/bin/perl|' . quotemeta(DISTRO_PERL) . '|/usr/bin/env\s+perl)}{#! ' . DISTRO_PERL . '} if ($. == 1);', + $file); + return; +} + =head1 SEE ALSO L<debhelper(7)> diff --git a/dh_systemd_enable b/dh_systemd_enable index 017bdd24eb7f51aabf2ec43a15a3e0daeb730623..b5eaf4b559c8f7e59cbd5869a17d461805c4d078 100755 --- a/dh_systemd_enable +++ b/dh_systemd_enable @@ -44,39 +44,38 @@ arguments, e.g. B<dh_systemd_enable quota.service> and B<dh_systemd_enable =item debian/I<package>.service, debian/I<package>@.service -If this exists, it is installed into lib/systemd/system/I<package>.service (or -lib/systemd/system/I<package>@.service) in the package build directory. +If this exists, it is installed into F<< lib/systemd/system/I<package>.service >> (or +F<< lib/systemd/system/I<package>@.service >>) in the package build directory. =item debian/I<package>.tmpfile If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in the -package build directory. (The tmpfiles.d mechanism is currently only used -by systemd.) +package build directory. =item debian/I<package>.target, debian/I<package>@.target -If this exists, it is installed into lib/systemd/system/I<package>.target (or -lib/systemd/system/I<package>@.target) in the package build directory. +If this exists, it is installed into F<< lib/systemd/system/I<package>.target >> (or +F<< lib/systemd/system/I<package>@.target >>) in the package build directory. =item debian/I<package>.socket, debian/I<package>@.socket -If this exists, it is installed into lib/systemd/system/I<package>.socket (or -lib/systemd/system/I<package>@.socket) in the package build directory. +If this exists, it is installed into F<< lib/systemd/system/I<package>.socket >> (or +F<< lib/systemd/system/I<package>@.socket >>) in the package build directory. =item debian/I<package>.mount -If this exists, it is installed into lib/systemd/system/I<package>.mount +If this exists, it is installed into F<< lib/systemd/system/I<package>.mount >> in the package build directory. =item debian/I<package>.path, debian/I<package>@.path -If this exists, it is installed into lib/systemd/system/I<package>.path (or -lib/systemd/system/I<package>@.path) in the package build directory. +If this exists, it is installed into F<< lib/systemd/system/I<package>.path >> (or +F<< lib/systemd/system/I<package>@.path >>) in the package build directory. =item debian/I<package>.timer, debian/I<package>@.timer -If this exists, it is installed into lib/systemd/system/I<package>.timer (or -lib/systemd/system/I<package>@.timer) in the package build directory. +If this exists, it is installed into F<< lib/systemd/system/I<package>.timer >> (or +F<< lib/systemd/system/I<package>@.timer >>) in the package build directory. =back diff --git a/doc/PROGRAMMING b/doc/PROGRAMMING deleted file mode 100644 index 97cd40e5b0428af36790056304ff635dca964c62..0000000000000000000000000000000000000000 --- a/doc/PROGRAMMING +++ /dev/null @@ -1,598 +0,0 @@ -This file documents things you should know to write a new debhelper program. -Any program with a name that begins with dh_ should conform to these -guidelines (with the historical exception of dh_make). - -Standardization: ---------------- - -There are lots of debhelper commands. To make the learning curve shallower, -I want them all to behave in a standard manner: - -All debhelper programs have names beginning with "dh_". This is so we don't -pollute the name space too much. - -Debhelper programs should never output anything to standard output except -error messages, important warnings, and the actual commands they run that -modify files under debian/ (this last only if they are passed -v, and if you -output the commands, you should indent them with 1 tab). This is so we don't -have a lot of noise output when all the debhelper commands in a debian/rules -are run, so the important stuff is clearly visible. - -An exception to above rule are dh_auto_* commands and dh itself. They will -also print the commands interacting with the upstream build system and which -of the simple debhelper programs are called. (i.e. print what a traditional -non-dh(1) using debian/rules would print but nothing else). - -Debhelper programs should accept all options listed in the "SHARED -DEBHELPER OPTIONS" section of debhelper(7), including any long forms of -these options, like --verbose . If necessary, the options may be ignored. - -If debhelper commands need config files, they should use -debian/package.filename as the name of the config file (replace filename -with whatever your command wants), and debian/filename should also be -checked for config information for the first binary package in -debian/control. Also, debhelper commands should accept the same sort of -information that appears in the config files, on their command lines, if -possible, and apply that information to the first package they act on. -The config file format should be as simple as possible, generally just a -list of files to act on. - -Debhelper programs should never modify the debian/postinst, debian/prerm, -etc scripts. Instead, they can add lines to debian/postinst.debhelper, etc. -The autoscript() function (see below) is one easy way to do this. -dh_installdeb is an exception, it will run after the other commands and -merge these modifications into the actual postinst scripts. - -In general, files named debian/*.debhelper and all content in -debian/.debhelper are internal to debhelper, and their existence or -use should not be relied on by external programs such as the build -process of a package. These files will be deleted by dh_clean. - -Debhelper programs should default to doing exactly what policy says to do. - -There are always exceptions. Just ask me. - -Introducing Dh_Lib: ------------------- - -Dh_Lib is the library used by all debhelper programs to parse their -arguments and set some useful variables. It's not mandatory that your -program use Dh_Lib.pm, but it will make it a lot easier to keep it in sync -with the rest of debhelper if it does, so this is highly encouraged. - -Use Dh_Lib like this: - -use Debian::Debhelper::Dh_Lib; -our $VERSION = '1.0'; -init(); - -The init() function causes Dh_lib to parse the command line and do -some other initialization tasks. If present, $main::VERSION will be -used to determine the version of the tool (e.g. embedded into -autoscript snippets). - -Argument processing: -------------------- - -All debhelper programs should respond to certain arguments, such as -v, -i, --a, and -p. To help you make this work right, Dh_Lib.pm handles argument -processing. Just call init(). - -You can add support for additional options to your command by passing an -options hash to init(). The hash is then passed on the Getopt::Long to -parse the command line options. For example, to add a --foo option, which -sets $dh{FOO}: - -init(options => { foo => \$dh{FOO} }); - -After argument processing, some global variables are used to hold the -results; programs can use them later. These variables are elements of the -%dh hash. - -switch variable description --v VERBOSE should the program verbosely output what it is - doing? ---no-act NO_ACT should the program not actually do anything? --i,-a,-p,-N DOPACKAGES a space delimited list of the binary packages - to act on (in Dh_Lib.pm, this is an array) --i DOINDEP set if we're acting on binary independent - packages --a DOARCH set if we're acting on binary dependent - packages --n NOSCRIPTS if set, do not make any modifications to the - package's postinst, postrm, etc scripts. --o ONLYSCRIPTS if set, only make modifications to the - package's scripts, but don't look for or - install associated files. --X EXCLUDE exclude a something from processing (you - decide what this means for your program) - (This is an array) --X EXCLUDE_FIND same as EXCLUDE, except all items are put - into a string in a way that they will make - find find them. (Use ! in front to negate - that, of course) Note that this should - only be used inside complex_doit(), not in - doit(). --d D_FLAG you decide what this means to your program --P TMPDIR package build directory (implies only one - package is being acted on) --u U_PARAMS will be set to a string, that is typically - parameters your program passes on to some - other program. (This is an array) --V V_FLAG will be set to a string, you decide what it - means to your program --V V_FLAG_SET will be 1 if -V was specified, even if no - parameters were passed along with the -V --A PARAMS_ALL generally means that additional command line - parameters passed to the program (other than - those processed here), will apply to all - binary packages the program acts on, not just - the first ---mainpackage MAINPACKAGE controls which package is treated as the - main package to act on ---name NAME a name to use for installed files, instead of - the package name ---error-handler ERROR_HANDLER a function to call on error - -Any additional command line parameters that do not start with "-" will be -ignored, and you can access them later just as you normally would. - -Global variables: ----------------- - -The following keys are also set in the %dh hash when you call init(): - -MAINPACKAGE the name of the first binary package listed in - debian/control -FIRSTPACKAGE the first package we were instructed to act on. This package - typically gets special treatment; additional arguments - specified on the command line may effect it. - -Functions: ---------- - -Dh_Lib.pm also contains a number of functions you may find useful. - -doit([$options, ]@command) - Pass this function an array that is a command with arguments. - It will run the command (unless $dh{NO_ACT} is set), and - if $dh{VERBOSE} is set, it will also output the command to stdout. You - should use this function for almost all commands your program performs - that manipulate files in the package build directories. - - The $options argument (if passed) must be a hashref (added in debhelper 10.7). - The following key-value pairs can be used: - * stdout => A file name. The child process will have its STDOUT redirected - to that file. [debhelper (>= 10.7)] - * chdir => A directory. The child process will do a chdir into that - directory before executing the command. [debhelper (>= 10.9)] - * update_env => A hashref. Each key in it represents an environment variable - that should be set in the child (possibly replacing the existing value) - prior to the exec. If the value is undef, the environment variable will - be unset. Environment variables in %ENV but not listed in the update_env - hashref will be preserved as-is. [debhelper (>= 11.1)] - - This will *not* invoke a shell, so meta characters will not have any special - meaning. Use complex_doit for that (or emulate via "bash -c"). - NB: In compat 11 and below, there was a bug that would make doit fork a shell - in one special case. This is deprecated and will be removed in compat 12. - The detection code for this can be disabled by passing an empty hashref for - as $options. This will make doit unconditionally avoid forking a shell. -print_and_doit([$options, ]@command) - Like doit but will print unless $dh{QUIET} is set. See "Standardization" - above for when this is allowed to be called. -complex_doit($command) - Pass this function a string that is a shell command, it will run it - similarly to how doit() does. You can pass more complicated commands - to this (i.e. commands involving piping redirection), however, you - have to worry about things like escaping shell metacharacters. -verbose_print($message) - Pass this command a string, and it will echo it if $dh{VERBOSE} is set. -nonquiet_print($message) - Pass this command a string, and it will echo it unless $dh{QUIET} is set. - See "Standardization" above for when this is allowed to be called. -error($errormsg) - Pass this command a string, it will output it to standard error and - exit. -error_exitcode($cmd) - Pass this subroutine a string (representing a command line), it will - output a message describing that the command failed to standard error - and exit. Note that this relies on the value of $? to produce a - meaningful error message. Even if $? is 0, this /will/ still terminate - the program (although with a rather unhelpful message). -warning($message) - Pass this command a string, and it will output it to standard error - as a warning message. -tmpdir($dir) - Pass this command the name of a binary package, it will return the - name of the tmp directory that will be used as this package's - package build directory. Typically, this will be "debian/package". -compat($num) - Pass this command a number, and if the current compatibility level - is less than or equal to that number, it will return true. - Looks at DH_COMPAT to get the compatibility level. -pkgfile($package, $basename) - Pass this command the name of a binary package, and the base name of a - file, and it will return the actual filename to use. This is used - for allowing debhelper programs to have configuration files in the - debian/ directory, so there can be one config file per binary - package. The convention is that the files are named - debian/package.filename, and debian/filename is also allowable for - the $dh{MAINPACKAGE}. If the file does not exist, nothing is returned. - - If the *entire* behavior of a command, when run without any special - options, is determined by the existence of 1 or more pkgfiles, - or by the existence of a file or directory in a location in the - tmpdir, it can be marked as such, which allows dh to automatically - skip running it. Please see "Optimization techniques" below. - -pkgext($package) - Pass this command the name of a binary package, and it will return - the name to prefix to files in debian/ for this package. For the - $dh{MAINPACKAGE}, it returns nothing (there is no prefix), for the other - packages, it returns "package.". -isnative($package) - Pass this command the name of a package, it returns 1 if the package - is a native debian package. - As a side effect, $dh{VERSION} is set to the version number of the - package. -autoscript($package, $scriptname, $snippetname, $substparam) - Pass parameters: - - binary package to be affected - - script to add to - - filename of snippet. For testing purposes, you can set the - environment variable DH_DATAFILES containing a autoscripts - directory, which can be used to shadow the snippets provided - in /usr/share/debhelper/autoscripts (or to test newly added - snippets). - Older versions of debhelper (<< 13.1~) does not support - DH_DATAFILES. If you need to support debhelper (<< 13.1~) - then you can set DH_AUTOSCRIPTDIR to a directory containing - the snippets instead (note it should point to the autoscripts - directory unlike DH_DATAFILES). - - (optional) A substitution parameter, which is one of 3 types: - * sed commands to run on the snippet. E.g. s/#PACKAGE#/$PACKAGE/ - Note: Passed to the shell inside double quotes. - * a perl sub to invoke with $_ set to each line of the snippet - in turn. - * a hashref, where each key will substitute "#${key}#" with the - value that $key points to. [debhelper (>= 10.7)] - This command automatically adds shell script snippets to a debian - maintainer script (like the postinst or prerm). - Note that in v6 mode and up, the snippets are added in reverse - order for the removal scripts. -autotrigger($package, $trigger_type, $trigger_target) - This command automatically adds a trigger to the package. The - parameters: - - binary package to be affected - - the type of trigger (e.g. "activate-noawait") - - the target (e.g. "ldconfig" or "/usr/share/foo") -dirname($pathname) - Return directory part of pathname. -basename($pathname) - Return base of pathname, -addsubstvar($package, $substvar, $deppackage, $verinfo, $remove) - This function adds a dependency on some package to the specified - substvar in a package's substvar's file. It needs all these - parameters: - - binary package that gets the item - - name of the substvar to add the item to - - the package that will be depended on - - version info for the package (optional) (i.e. ">= 1.1") - - if this last parameter is passed, the thing that would be added - is removed instead. This can be useful to ensure that a debhelper - command is idempotent. (However, we generally don't bother, - and rely on the user calling dh_prep.) Note that without this - parameter, if you call the function twice with the same values it - will only add one item to the substvars file. -delsubstvar($package, $substvar) - This function removes the entire line for the substvar from the - package's shlibs file. -excludefile($filename) - This function returns true if -X has been used to ask for the file - to be excluded. -is_udeb($package) - Returns true if the package is marked as a udeb in the control - file. -getpackages($type) - Returns a list of packages in the control file. - Pass "arch" or "indep" to specify arch-dependent or - -independent. If $type is omitted, returns all - packages (including packages that are not built - for this architecture). Pass "both" to get the union - of "arch" and "indep" packages. - Note that "both" is *not* the same omitting the $type parameter. - As a side effect, populates %package_arches and %package_types with - the types of all packages (not only those returned). -get_source_date_epoch() - Return the value of $ENV{SOURCE_DATE_EPOCH} if exists. - Otherwise compute the value from the first changelog entry, - use it to set the ENV variable and return it. -inhibit_log() - Prevent logging the program's successful finish to - debian/*debhelper.log - - Since debhelper/12.9, this can be done by passing the inhibit_log - option with a value of 1 to init() instead. E.g. - init('inhibit_log' => 1); -load_log($package, $hashref) - Loads the log file for the given package and returns a list of - logged commands. - (Passing a hashref also causes it to populate the hash.) -write_log($cmd, $package ...) - Writes the log files for the specified package(s), adding - the cmd to the end. -restore_file_on_clean($file) - Store a copy of $file, which will be restored by dh_clean. - The $file *must* be a relative path to the package root and - *must* be a real regular file. Dirs, devices and symlinks - (and everything else) *cannot* be restored by this. - If $file is passed multiple times (e.g. from different programs) - only the first version is stored. - CAVEAT: This *cannot* undo arbitrary "rm -fr"'ing. The dir, - which is/was in $file, must be present when dh_clean is called. -make_symlink($src, $dest, $tmp) - Creates a Policy compliant system link called $dest pointing to - $src. If $tmp is given, then $tmp will be prefixed to $dest when - creating the actual symlink. -install_dh_config_file($src, $dest[, $mode]) - Installs $src into $dest with $mode (defaults to 0644). If - compat is 9 (or later) and $src is executable, $src will be - executed instead and its output will be used to generate the - $dest file. -install_dir(@dirs) - Create the directories denoted by the paths in @dirs and all - parent entries as well (as needed). It uses mode 0755. - If a directory listed in @dirs already exists, the function - silently skips that directory (similar to mkdir -p). -install_file($src, $dest) - Installs $src into $dest with mode 0644. The parent dir of - $dest must exist (can be created with install_dir). - This is intended for installing regular non-executable files. -install_prog($src, $dest) - Installs $src into $dest with mode 0755. The parent dir of - $dest must exist (can be created with install_dir). - This is intended for installing scripts or binaries. -install_lib($src, $dest) - Installs a library at the path $src into $dest. The parent - dir of $dest must exist (can be created with install_dir). - This is intended for installing libraries. -reset_perm_and_owner($mode, $path...) - Resets the ownership and mode (POSIX permissions) of $path - This is useful for files created directly by the script, but - it not necessary for files installed via the install_* - functions. - The file owner and group is set to "root:root". The change - is only done on the exact paths listed (i.e. it is *not* - recursive). - Mode should be passed as an integer (not a string). -open_gz($file) - Open $file, read from it as a gzip-compressed file and return - the file handle. - Depending on runtime features, it might be a pipe from an - external process (which will die with a "SIGPIPE" if you - do not consume all the input) -deprecated_functionality($warn_msg[, $rm_compat[, $rm_msg]]) - Emit $warn_msg as a deprecation warning, or error out if $rm_compat - is provided and equal to (or greater than) the active compat level. - The $rm_msg parameter can be used to provide a custom error message - in the latter case (if omitted, $warn_msg will be used in both cases). - The function will provide a separate diagnostic about which compat - level that will remove/removed the functionality if $rm_compat is - given. -log_installed_files($package, @paths) - Creates a logfile (in debian/.debhelper/generated) for the helper's - processing of $package, which installed the files listed in - @paths. This logfile will later be used by the dh_missing helper. - Paths should be relative to the package root (i.e. the directory - containing "debian/") and should not have superfluous segments - (e.g. avoid "foo/../bar" or "foo/./bar") - If a directory is listed, it and all paths recursively beneath is - also considered installed. -on_pkgs_in_parallel($code) - prototype: (&) - Short hand for on_items_in_parallel with $dh{DOPACKAGES} as - as list of packages. -on_items_in_parallel($item_list_ref, $code) - Splits all the items in $item_list_ref into a number of groups - based on the max parallel (as decided by DEB_BUILD_OPTIONS) - A subprocess is forked for each group (minimum 1 process will be - forked) and each subprocess will be given a group of items - to process. Each group is passed to the $code sub, which will - then process it and return normally on success. - Example: - my @all_packages = getpackages(); - on_items_in_parallel(\@all_packages, sub { - for my $package (@_) { - my $tmp=tmpdir($package); - my $pkgfile = pkgfile($package, 'foo'); - ...; - } - }); - my @work_list = compute_work_list(); - on_items_in_parallel(\@work_list, sub { - for my $item (@_) { - ...; - } - }); - - If there is an error, which should stop the build, please invoke - either "error()" or "error_exitcode". Alternatively, a trappable - error (e.g. "die($msg)") can also be used. - - Keep in mind that the sub will always be run in a subprocess, - so it cannot update global state. - -Sequence Addons: ---------------- - -The dh(1) command has a --with <addon> parameter that can be used to load -a sequence addon module named Debian::Debhelper::Sequence::<addon>. -These modules can add/remove commands to the dh command sequences, by -calling some functions from Dh_Lib: - -insert_before($existing_command, $new_command) - Insert $new_command in sequences before $existing_command - - Compatible with "arch-only"/"indep-only" modes if the command - appears only in a compatible sequence. - -insert_after($existing_command, $new_command) - Insert $new_command in sequences after $existing_command - - Compatible with "arch-only"/"indep-only" modes if the command - appears only in a compatible sequence. - -remove_command($existing_command) - Remove $existing_command from the list of commands to run - in all sequences. - - Cannot be used in "arch-only"/"indep-only" mode. - -add_command($new_command, $sequence) - Add $new_command to the beginning of the specified sequence. - If the sequence does not exist, it will be created. - - Compatible with "arch-only"/"indep-only" modes if $sequence - is an "-arch" or "-indep" sequence (respectively). - -add_command_options($command, $opt1, $opt2, ...) - Append $opt1, $opt2 etc. to the list of additional options which - dh passes when running the specified $command. These options are - not relayed to debhelper commands called via $command override. - - Cannot be used in "arch-only"/"indep-only" mode. - -remove_command_options($command) - Clear all additional $command options previously added with - add_command_options(). - - Cannot be used in "arch-only"/"indep-only" mode. - -remove_command_options($command, $opt1, $opt2, ...) - Remove $opt1, $opt2 etc. from the list of additional options which - dh passes when running the specified $command. - - Cannot be used in "arch-only"/"indep-only" mode. - -declare_command_obsolete($command) - Declare $command as obsolete, which make dh warn about leftover - override / hook targets. Note that $command MUST NOT be present - in the sequence! - - Cannot be used in "arch-only"/"indep-only" mode. - - -Optimization techniques: ------------------------- - -Most debhelper tools will have situations where they are not useful and can -be skipped. To support this, dh will look for a "NOOP PROMISE" as a part of -a comment in the command before running it. These promises have the form: - - # PROMISE: DH NOOP WITHOUT pkgfile-logged(pkgfileA) pkgfile-logged(pkgfileB) tmp(need/this) cli-options() - -The following keywords are defined: - - * pkgfile(X): The command might do something if debian/X (or debian/<package>.X) - exist for any of the packages it will be run for. If the debhelper tool - interacts with dh_missing, you always want to use pkgfile-logged(X) instead. - - * pkgfile-logged(X): Same as pkgfile(X) but it will also register which files - it handles so dh_missing can see it. - - * tmp(X): The command might do something if debian/<package>/X exists. - - * cli-options(--foo|--bar): The command might do something if *either* --foo - OR --bar are passed to the command. - - * cli-options(BUILDSYSTEM): The command is a build system command (dh_auto_*) - and will react to standard build system command line options. - - * cli-options(): Special variant of cli-options() to declare that command line - options will not affect whether the tool will do something. This enables - dh to skip commands even when passed custom options. Without an explicit - cli-option(...) hint, dh will assume the command might react to it. - -If the hint is present and ALL of the keywords imply that the command can be -skipped, dh will skip the command. - -Logging helpers and dh_missing: -------------------------------- - -Since debhelper 10.3, debhelper has had a helper called "dh_missing". It -takes over the "--list-missing" and "--fail-missing" options from dh_install -and as the advantage that it can "see" what other helpers have installed. - -Under the hood, this works by the helpers logging the source files -they (would) install to a hidden log file. When dh_missing is called, -it reads all these log files to determine which files have would been -installed and compare them to what is present. - -If you are writing a helper that need to integrate with dh_missing, -here is what you do: - -Dh_Lib-based helpers: -~~~~~~~~~~~~~~~~~~~~~ - - * Replace "@{$dh{DOPACKAGES}}" with "getpackages()" and use - "process_pkg($package)" to determine if the helper should actually - install anything. - * Call "log_installed_files" at least once per package (even on the ones - that are not to be acted on) with a list of source files that would be - installed. - - You can list entire directories even if there are files under - it that are ignored. - - Please call "log_installed_files" /even if/ the list is empty for that - packages. This enables dh_missing to see that the helper has been run - and nothing should be installed for that package. - - Prefer calling "log_installed_files" /exactly once/ per package as - this is what it is optimized for. - * If your helper has a PROMISE, it must use "pkgfile-logged(<file>)" - for its config files. (See #867246) - - CAVEAT: This requires a dependency on "debhelper (>= 10.2.5)". Prior - to that version, debhelper will wrongly optimize your helper out. - * Consider using dh_installman or dh_installexamples as examples. - -Other helpers: -~~~~~~~~~~~~~~ - - * The helper must compile a list of files it would have installed for - each package (even packages that are not acted on). The file list - should be relative to the source package root (e.g. - "debian/tmp/usr/bin/bar"). - - This list can also contain directories. They will be flagged as - installed along with their content (recursively). - * The helper must append to the file (create it if missing): - debian/.debhelper/generated/${package}/installed-by-${HELPER_NAME} - - Example: debian/.debhelper/generated/lintian/installed-by-dh_install - - The file should be created even if it is empty. This enables dh_missing - to see that the helper has been run and nothing would be installed for - that package. - * Please append to the file if it exists as the helper may be called multiple - times (once with -a and once with -i). It is completely fine if this leaves - duplicate entries as dh_missing will deduplicate these. - * If your helper has a PROMISE, it must use "pkgfile-logged(<file>)" - for its config files. (See #867246) - - CAVEAT: This requires a dependency on "debhelper (>= 10.2.5)". Prior - to that version, debhelper will wrongly optimize your helper out. - -Buildsystem Classes: --------------------- - -The dh_auto_* commands are frontends that use debhelper buildsystem -classes. These classes have names like Debian::Debhelper::Buildsystem::foo, -and are derived from Debian::Debhelper::Buildsystem, or other, related -classes. - -A buildsystem class needs to inherit or define these methods: DESCRIPTION, -check_auto_buildable, configure, build, test, install, clean. See the comments -inside Debian::Debhelper::Buildsystem for details. Note that this interface -is still subject to change. - -Note that third-party buildsystems will not automatically be used by -default. The package maintainer will either have to explicitly enable -it via the --buildsystem parameter OR the build system should be -registered in debhelper. The latter is currently needed to ensure a -stable and well-defined ordering of the build systems. - --- Joey Hess <joeyh@debian.org> diff --git a/doc/PROGRAMMING.md b/doc/PROGRAMMING.md new file mode 100644 index 0000000000000000000000000000000000000000..fd28b6a83c0681023975d5c96e88f3168a947065 --- /dev/null +++ b/doc/PROGRAMMING.md @@ -0,0 +1,694 @@ +# PROGRAMMING + +This file documents things you should know to write a new debhelper program. +Any program with a name that begins with `dh_` should conform to these +guidelines (with the historical exception of `dh_make`). + +## Standardization + +There are lots of debhelper commands. To make the learning curve shallower, +I want them all to behave in a standard manner: + +All debhelper programs have names beginning with `dh_`. This is so we don't +pollute the name space too much. + +Debhelper programs should never output anything to standard output except +error messages, important warnings, and the actual commands they run that +modify files under `debian/` (this last only if they are passed `-v`, and if you +output the commands, you should indent them with 1 tab). This is so we don't +have a lot of noise output when all the debhelper commands in a `debian/rules` +are run, so the important stuff is clearly visible. + +An exception to above rule are `dh_auto_*` commands and `dh` itself. They will +also print the commands interacting with the upstream build system and which +of the simple debhelper programs are called. (i.e. print what a traditional +non-[dh(1)] using `debian/rules` would print but nothing else). + +Debhelper programs should accept all options listed in the "SHARED +DEBHELPER OPTIONS" section of [debhelper(7)], including any long forms of +these options, like `--verbose`. If necessary, the options may be ignored. + +If debhelper commands need config files, they should use +`debian/package.filename` as the name of the config file (replace filename +with whatever your command wants), and `debian/filename` should also be +checked for config information for the first binary package in +`debian/control`. Also, debhelper commands should accept the same sort of +information that appears in the config files, on their command lines, if +possible, and apply that information to the first package they act on. +The config file format should be as simple as possible, generally just a +list of files to act on. + +Debhelper programs should never modify the `debian/postinst`, `debian/prerm`, +etc scripts. Instead, they can add lines to `debian/postinst.debhelper`, etc. +The `autoscript()` function (see below) is one easy way to do this. +`dh_installdeb` is an exception, it will run after the other commands and +merge these modifications into the actual postinst scripts. + +In general, files named `debian/*.debhelper` and all content in +`debian/.debhelper` are internal to debhelper, and their existence or +use should not be relied on by external programs such as the build +process of a package. These files will be deleted by `dh_clean`. + +Debhelper programs should default to doing exactly what policy says to do. + +There are always exceptions. Just ask me. + +## Introducing Dh_Lib + +`Dh_Lib` is the library used by all debhelper programs to parse their +arguments and set some useful variables. It's not mandatory that your +program use `Dh_Lib.pm`, but it will make it a lot easier to keep it in sync +with the rest of debhelper if it does, so this is highly encouraged. + +Use `Dh_Lib` like this: + + use Debian::Debhelper::Dh_Lib; + our $VERSION = '1.0'; + init(); + +The `init()` function causes `Dh_lib` to parse the command line and do +some other initialization tasks. If present, `$main::VERSION` will be +used to determine the version of the tool (e.g. embedded into +autoscript snippets). + +## Argument processing + +All debhelper programs should respond to certain arguments, such as `-v`, `-i`, +`-a`, and `-p`. To help you make this work right, `Dh_Lib.pm` handles argument +processing. Just call `init()`. + +You can add support for additional options to your command by passing an +options hash to `init()`. The hash is then passed on the `Getopt::Long` to +parse the command line options. For example, to add a `--foo` option, which +sets `$dh{FOO}`: + + init(options => { foo => \$dh{FOO} }); + +After argument processing, some global variables are used to hold the +results; programs can use them later. These variables are elements of the +`%dh` hash. + +| switch | variable | description | +|---------------------|-----------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| `-v` | `VERBOSE` | should the program verbosely output what it is doing? | +| `--no-act` | `NO_ACT` | should the program not actually do anything? | +| `-i`,`-a`,`-p`,`-N` | `DOPACKAGES` | a space delimited list of the binary packages to act on (in `Dh_Lib.pm`, this is an array) | +| `-i` | `DOINDEP` | set if we're acting on binary independent packages | +| `-a` | `DOARCH` | set if we're acting on binary dependent packages | +| `-n` | `NOSCRIPTS` | if set, do not make any modifications to the package's postinst, postrm, etc scripts. | +| `-o` | `ONLYSCRIPTS` | if set, only make modifications to the package's scripts, but don't look for or install associated files. | +| `-X` | `EXCLUDE` | exclude something from processing (you decide what this means for your program) (This is an array) | +| `-X` | `EXCLUDE_FIND` | same as `EXCLUDE`, except all items are put into a string in a way that they will make find find them. (Use `!` in front to negate that, of course) Note that this should only be used inside `complex_doit()`, not in `doit()`. | +| `-d` | `D_FLAG` | you decide what this means to your program | +| `-P` | `TMPDIR` | package build directory (implies only one package is being acted on) | +| `-u` | `U_PARAMS` | will be set to a string, that is typically parameters your program passes on to some other program. (This is an array) | +| `-V` | `V_FLAG` | will be set to a string, you decide what it means to your program | +| `-V` | `V_FLAG_SET` | will be 1 if `-V` was specified, even if no parameters were passed along with the `-V` | +| `-A` | `PARAMS_ALL` | generally means that additional command line parameters passed to the program (other than those processed here), will apply to all binary packages the program acts on, not just the first | +| `--mainpackage` | `MAINPACKAGE` | controls which package is treated as the main package to act on | +| `--name` | `NAME` | a name to use for installed files, instead of the package name | +| `--error-handler` | `ERROR_HANDLER` | a function to call on error | + +Any additional command line parameters that do not start with "`-`" will be +ignored, and you can access them later just as you normally would. + +## Global variables + +The following keys are also set in the `%dh` hash when you call `init()`: + +- `MAINPACKAGE` + + the name of the first binary package listed in `debian/control` + +- `FIRSTPACKAGE` + + the first package we were instructed to act on. This package + typically gets special treatment; additional arguments + specified on the command line may effect it. + +## Functions + +`Dh_Lib.pm` also contains a number of functions you may find useful. + +- `doit([$options, ]@command)` + + Pass this function an array that is a command with arguments. + It will run the command (unless `$dh{NO_ACT}` is set), and + if `$dh{VERBOSE}` is set, it will also output the command to stdout. You + should use this function for almost all commands your program performs + that manipulate files in the package build directories. + + The `$options` argument (if passed) must be a hashref (added in debhelper 10.7). + The following key-value pairs can be used: + + - `stdout` => A file name. The child process will have its STDOUT redirected + to that file. [debhelper (>= 10.7)] + - `chdir` => A directory. The child process will do a chdir into that + directory before executing the command. [debhelper (>= 10.9)] + - `update_env` => A hashref. Each key in it represents an environment variable + that should be set in the child (possibly replacing the existing value) + prior to the exec. If the value is undef, the environment variable will + be unset. Environment variables in `%ENV` but not listed in the `update_env` + hashref will be preserved as-is. [debhelper (>= 11.1)] + + This will *not* invoke a shell, so meta characters will not have any special + meaning. Use `complex_doit` for that (or emulate via `bash -c`). + NB: In compat 11 and below, there was a bug that would make `doit` fork a shell + in one special case. This is deprecated and will be removed in compat 12. + The detection code for this can be disabled by passing an empty hashref for + as `$options`. This will make doit unconditionally avoid forking a shell. + +- `print_and_doit([$options, ]@command)` + + Like `doit` but will print unless `$dh{QUIET}` is set. See "Standardization" + above for when this is allowed to be called. + +- `complex_doit($command)` + + Pass this function a string that is a shell command, it will run it + similarly to how `doit()` does. You can pass more complicated commands + to this (i.e. commands involving piping redirection), however, you + have to worry about things like escaping shell metacharacters. + +- `verbose_print($message)` + + Pass this command a string, and it will echo it if `$dh{VERBOSE}` is set. + +- `nonquiet_print($message)` + + Pass this command a string, and it will echo it unless `$dh{QUIET}` is set. + See "Standardization" above for when this is allowed to be called. + +- `error($errormsg)` + + Pass this command a string, it will output it to standard error and + exit. + +- `error_exitcode($cmd)` + + Pass this subroutine a string (representing a command line), it will + output a message describing that the command failed to standard error + and exit. Note that this relies on the value of `$?` to produce a + meaningful error message. Even if `$?` is `0`, this *will* still terminate + the program (although with a rather unhelpful message). + +- `warning($message)` + + Pass this command a string, and it will output it to standard error + as a warning message. + +- `tmpdir($dir)` + + Pass this command the name of a binary package, it will return the + name of the tmp directory that will be used as this package's + package build directory. Typically, this will be `debian/package`. + +- `compat($num)` + + Pass this command a number, and if the current compatibility level + is less than or equal to that number, it will return true. + Looks at `DH_COMPAT` to get the compatibility level. + +- `pkgfile($package, $basename)` + + Pass this command the name of a binary package, and the base name of a + file, and it will return the actual filename to use. This is used + for allowing debhelper programs to have configuration files in the + `debian/` directory, so there can be one config file per binary + package. The convention is that the files are named + `debian/package.filename`, and `debian/filename` is also allowable for + the `$dh{MAINPACKAGE}`. If the file does not exist, nothing is returned. + + If the *entire* behavior of a command, when run without any special + options, is determined by the existence of 1 or more pkgfiles, + or by the existence of a file or directory in a location in the + tmpdir, it can be marked as such, which allows dh to automatically + skip running it. Please see "Optimization techniques" below. + +- `pkgext($package)` + + Pass this command the name of a binary package, and it will return + the name to prefix to files in `debian/` for this package. For the + `$dh{MAINPACKAGE}`, it returns nothing (there is no prefix), for the other + packages, it returns `package.`. + +- `isnative($package)` + + Pass this command the name of a package, it returns 1 if the package + is a native debian package. + As a side effect, `$dh{VERSION}` is set to the version number of the + package. + +- `autoscript($package, $scriptname, $snippetname, $substparam)` + + Pass parameters: + - binary package to be affected + - script to add to + - filename of snippet. For testing purposes, you can set the + environment variable `DH_DATAFILES` containing a autoscripts + directory, which can be used to shadow the snippets provided + in `/usr/share/debhelper/autoscripts` (or to test newly added + snippets). + Older versions of debhelper (<< 13.1~) do not support + `DH_DATAFILES`. If you need to support debhelper (<< 13.1~) + then you can set `DH_AUTOSCRIPTDIR` to a directory containing + the snippets instead (note it should point to the autoscripts + directory unlike `DH_DATAFILES`). + + - (optional) A substitution parameter, which is one of 3 types: + - sed commands to run on the snippet, e.g. `s/#PACKAGE#/$PACKAGE/`. + Note: Passed to the shell inside double quotes. + - a perl sub to invoke with `$_` set to each line of the snippet + in turn. + - a hashref, where each key will substitute `#${key}#` with the + value that `$key` points to. [debhelper (>= 10.7)] + + This command automatically adds shell script snippets to a debian + maintainer script (like the postinst or prerm). + Note that in v6 mode and up, the snippets are added in reverse + order for the removal scripts. + +- `autotrigger($package, $trigger_type, $trigger_target)` + + This command automatically adds a trigger to the package. The + parameters: + - binary package to be affected + - the type of trigger (e.g. "activate-noawait") + - the target (e.g. `ldconfig` or `/usr/share/foo`) + +- `dirname($pathname)` + + Return directory part of pathname. + +- `basename($pathname)` + + Return base of pathname, + +- `addsubstvar($package, $substvar, $deppackage, $verinfo, $remove)` + + This function adds a dependency on some package to the specified + substvar in a package's substvar's file. It needs all these + parameters: + - binary package that gets the item + - name of the substvar to add the item to + - the package that will be depended on + - version info for the package (optional) (i.e. ">= 1.1") + - if this last parameter is passed, the thing that would be added + is removed instead. This can be useful to ensure that a debhelper + command is idempotent. (However, we generally don't bother, + and rely on the user calling `dh_prep`.) Note that without this + parameter, if you call the function twice with the same values it + will only add one item to the substvars file. + +- `delsubstvar($package, $substvar)` + + This function removes the entire line for the substvar from the + package's shlibs file. + +- `excludefile($filename)` + + This function returns true if `-X` has been used to ask for the file + to be excluded. + +- `is_udeb($package)` + + Returns true if the package is marked as a udeb in the control + file. + +- `getpackages($type)` + + Returns a list of packages in the control file. + Pass "arch" or "indep" to specify arch-dependent or + -independent. If `$type` is omitted, returns all + packages (including packages that are not built + for this architecture). Pass "both" to get the union + of "arch" and "indep" packages. + Note that "both" is *not* the same omitting the `$type` parameter. + As a side effect, populates `%package_arches` and `%package_types` with + the types of all packages (not only those returned). + +- `get_source_date_epoch()` + + Return the value of `$ENV{SOURCE_DATE_EPOCH}` if exists. + Otherwise compute the value from the first changelog entry, + use it to set the ENV variable and return it. + +- `inhibit_log()` + + Prevent logging the program's successful finish to + `debian/*debhelper.log` + + Since debhelper 12.9, this can be done by passing the `inhibit_log` + option with a value of 1 to `init()` instead. E.g. + + init('inhibit_log' => 1); + +- `load_log($package, $hashref)` + + Loads the log file for the given package and returns a list of + logged commands. + (Passing a hashref also causes it to populate the hash.) + +- `write_log($cmd, $package ...)` + + Writes the log files for the specified package(s), adding + the cmd to the end. + +- `restore_file_on_clean($file)` + + Store a copy of `$file`, which will be restored by `dh_clean`. + The `$file` *must* be a relative path to the package root and + *must* be a real regular file. Dirs, devices and symlinks + (and everything else) *cannot* be restored by this. + If `$file` is passed multiple times (e.g. from different programs) + only the first version is stored. + CAVEAT: This *cannot* undo arbitrary "rm -fr"'ing. The dir, + which the `$file` is/was in, must be present when `dh_clean` is + called. + +- `make_symlink($src, $dest, $tmp)` + + Creates a Policy compliant system link called `$dest` pointing to + `$src`. If `$tmp` is given, then `$tmp` will be prefixed to `$dest` + when creating the actual symlink. + +- `install_dh_config_file($src, $dest)` + + Installs `$src` into `$dest` using mode 0644. + If compat is 9 (or later) and `$src` is executable, `$src` will + be executed instead and its output will be used to generate the + `$dest` file. + +- `install_dir(@dirs)` / `mkdirs(@dirs)` + + Create the directories denoted by the paths in `@dirs` and all + parent entries as well (as needed). It uses mode 0755. + If a directory listed in `@dirs` already exists, the function + silently skips that directory (similar to `mkdir -p`). + + The `install_dir` function should be used for directories + installed in a final package while `mkdirs` should be used + for other directories. The difference is related to whether + the change will be shown via -v/--verbose or not. The + `mkdirs` function requires `debhelper (>= 13.11~)`. + +- `install_file($src, $dest)` + + Installs `$src` into `$dest` with mode 0644. The parent dir of + `$dest` must exist (can be created with `install_dir`). + This is intended for installing regular non-executable files. + +- `install_prog($src, $dest)` + + Installs `$src` into `$dest` with mode 0755. The parent dir of + `$dest` must exist (can be created with `install_dir`). + This is intended for installing scripts or binaries. + +- `install_lib($src, $dest)` + + Installs a library at the path `$src` into `$dest`. The parent + dir of `$dest` must exist (can be created with `install_dir`). + This is intended for installing libraries. + +- `reset_perm_and_owner($mode, $path...)` + + Resets the ownership and mode (POSIX permissions) of `$path` + This is useful for files created directly by the script, but + it not necessary for files installed via the `install_*` + functions. + The file owner and group is set to "root:root". The change + is only done on the exact paths listed (i.e. it is *not* + recursive). + Mode should be passed as an integer (not a string). + +- `open_gz($file)` + + Open `$file`, read from it as a gzip-compressed file and return + the file handle. + Depending on runtime features, it might be a pipe from an + external process (which will die with a "SIGPIPE" if you + do not consume all the input) + +- `deprecated_functionality($warn_msg[, $rm_compat[, $rm_msg]])` + + Emit `$warn_msg` as a deprecation warning, or error out if `$rm_compat` + is provided and equal to (or greater than) the active compat level. + The `$rm_msg` parameter can be used to provide a custom error message + in the latter case (if omitted, `$warn_msg` will be used in both cases). + The function will provide a separate diagnostic about which compat + level that will remove/removed the functionality if `$rm_compat` is + given. + +- `log_installed_files($package, @paths)` + + Creates a logfile (in `debian/.debhelper/generated`) for the helper's + processing of `$package`, which installed the files listed in + `@paths`. This logfile will later be used by the `dh_missing` helper. + Paths should be relative to the package root (i.e. the directory + containing `debian/`) and should not have superfluous segments + (e.g. avoid `foo/../bar` or `foo/./bar`). + If a directory is listed, it and all paths recursively beneath is + also considered installed. + +- `on_pkgs_in_parallel($code)` - prototype: (&) + + Short hand for `on_items_in_parallel` with `$dh{DOPACKAGES}` as + as list of packages. + +- `on_items_in_parallel($item_list_ref, $code)` + + Splits all the items in `$item_list_ref` into a number of groups + based on the max parallel (as decided by `DEB_BUILD_OPTIONS`) + A subprocess is forked for each group (minimum 1 process will be + forked) and each subprocess will be given a group of items + to process. Each group is passed to the `$code` sub, which will + then process it and return normally on success. + Example: + + my @all_packages = getpackages(); + on_items_in_parallel(\@all_packages, sub { + for my $package (@_) { + my $tmp=tmpdir($package); + my $pkgfile = pkgfile($package, 'foo'); + ...; + } + }); + my @work_list = compute_work_list(); + on_items_in_parallel(\@work_list, sub { + for my $item (@_) { + ...; + } + }); + + If there is an error, which should stop the build, please invoke + either `error()` or `error_exitcode`. Alternatively, a trappable + error (e.g. `die($msg)`) can also be used. + + Keep in mind that the sub will always be run in a subprocess, + so it cannot update global state. + +## Sequence Addons + +The [dh(1)] command has a `--with <addon>` parameter that can be used to load +a sequence addon module named `Debian::Debhelper::Sequence::<addon>`. +These modules can add/remove commands to the dh command sequences, by +calling some functions from `Dh_Lib`: + +- `insert_before($existing_command, $new_command)` + + Insert `$new_command` in sequences before `$existing_command` + + Compatible with "arch-only"/"indep-only" modes if the command + appears only in a compatible sequence. + +- `insert_after($existing_command, $new_command)` + + Insert `$new_command` in sequences after `$existing_command` + + Compatible with "arch-only"/"indep-only" modes if the command + appears only in a compatible sequence. + +- `remove_command($existing_command)` + + Remove `$existing_command` from the list of commands to run + in all sequences. + + Cannot be used in "arch-only"/"indep-only" mode. + +- `add_command($new_command, $sequence)` + + Add `$new_command` to the beginning of the specified sequence. + If the sequence does not exist, it will be created. + + Compatible with "arch-only"/"indep-only" modes if `$sequence` + is an "-arch" or "-indep" sequence (respectively). + +- `add_command_options($command, $opt1, $opt2, ...)` + + Append `$opt1`, `$opt2` etc. to the list of additional options which + dh passes when running the specified `$command`. These options are + not relayed to debhelper commands called via `$command` override. + + Cannot be used in "arch-only"/"indep-only" mode. + +- `remove_command_options($command)` + + Clear all additional `$command` options previously added with + `add_command_options()`. + + Cannot be used in "arch-only"/"indep-only" mode. + +- `remove_command_options($command, $opt1, $opt2, ...)` + + Remove `$opt1`, `$opt2` etc. from the list of additional options which + dh passes when running the specified `$command`. + + Cannot be used in "arch-only"/"indep-only" mode. + +- `declare_command_obsolete([$error_compat, ]$command)` + + Declare `$command` as obsolete, which make dh warn about leftover + override / hook targets. Note that `$command` *MUST NOT* be present + in the sequence! + + The `$error_compat` parameter defines the compat level where + referencing this command via a hook target will become an error. + This must be at least 13 (which is the default if omitted). + Be careful with using already closed compat levels as error compat + for new commands as it will cause FTBFS. + + Cannot be used in "arch-only"/"indep-only" mode. + +## Optimization techniques + +Most debhelper tools will have situations where they are not useful and can +be skipped. To support this, dh will look for a "NOOP PROMISE" as a part of +a comment in the command before running it. These promises have the form: + + # PROMISE: DH NOOP WITHOUT pkgfile-logged(pkgfileA) pkgfile-logged(pkgfileB) tmp(need/this) cli-options() + +The following keywords are defined: + +- `pkgfile(X)`: The command might do something if `debian/X` (or `debian/<package>.X`) + exist for any of the packages it will be run for. If the debhelper tool + interacts with `dh_missing`, you always want to use `pkgfile-logged(X)` instead. + +- `pkgfile-logged(X)`: Same as `pkgfile(X)` but it will also register which files + it handles so `dh_missing` can see it. + +- `tmp(X)`: The command might do something if `debian/<package>/X` exists. + +- `cli-options(--foo|--bar)`: The command might do something if *either* `--foo` + OR `--bar` are passed to the command. + +- `cli-options(BUILDSYSTEM)`: The command is a build system command (`dh_auto_*`) + and will react to standard build system command line options. + +- `cli-options()`: Special variant of `cli-options()` to declare that command + line options will not affect whether the tool will do something. This enables + dh to skip commands even when passed custom options. Without an explicit + `cli-option(...)` hint, dh will assume the command might react to it. + +If the hint is present and ALL of the keywords imply that the command can be +skipped, dh will skip the command. + +## Logging helpers and dh_missing + +Since debhelper 10.3, debhelper has had a helper called `dh_missing`. It +takes over the `--list-missing` and `--fail-missing` options from `dh_install` +and as the advantage that it can "see" what other helpers have installed. + +Under the hood, this works by the helpers logging the source files +they (would) install to a hidden log file. When `dh_missing` is called, +it reads all these log files to determine which files have would been +installed and compare them to what is present. + +If you are writing a helper that need to integrate with `dh_missing`, +here is what you do: + +### Dh_Lib-based helpers + +- Replace `@{$dh{DOPACKAGES}}` with `getpackages()` and use + `process_pkg($package)` to determine if the helper should actually + install anything. +- Call `log_installed_files` at least once per package (even on the ones + that are not to be acted on) with a list of source files that would be + installed. + - You can list entire directories even if there are files under + it that are ignored. + - Please call `log_installed_files` *even if* the list is empty for that + packages. This enables `dh_missing` to see that the helper has been run + and nothing should be installed for that package. + - Prefer calling `log_installed_files` *exactly once* per package as + this is what it is optimized for. +- If your helper has a `PROMISE`, it must use `pkgfile-logged(<file>)` + for its config files. (See [#867246]) + - CAVEAT: This requires a dependency on "debhelper (>= 10.2.5)". Prior + to that version, debhelper will wrongly optimize your helper out. +- Consider using `dh_installman` or `dh_installexamples` as examples. + +### Other helpers - via dh_assistant log-installed-files + +This process requires debhelper/13.10 or later. + +- The helper must compile a list of files it would have installed for + each package (even packages that are not acted on). The file list + should be relative to the source package root (e.g. + `debian/tmp/usr/bin/bar`). + - This list can also contain directories. They will be flagged as + installed along with their content (recursively). +- Invoke `dh_assistant log-installed-files --on-behalf-of-cmd=${HELPER_NAME} -p${package} ${PATHS}` + - Invoking `dh_assistant` when your tool has no paths to log is + still recommended to let dh_missing that your tool had nothing + to record. + - Prefer calling `dh_assistant log-installed-files` *exactly once* + per package per invocation of your tool as this is what it is + optimized for. +- If your helper has a PROMISE, it must use `pkgfile-logged(<file>)` + for its config files (see [#867246]). + +### Other helpers - manually + +- The helper must compile a list of files it would have installed for + each package (even packages that are not acted on). The file list + should be relative to the source package root (e.g. + `debian/tmp/usr/bin/bar`). + - This list can also contain directories. They will be flagged as + installed along with their content (recursively). +- The helper must append to the file (create it if missing): + `debian/.debhelper/generated/${package}/installed-by-${HELPER_NAME}` + - Example: `debian/.debhelper/generated/lintian/installed-by-dh_install` + - The file should be created even if it is empty. This enables `dh_missing` + to see that the helper has been run and nothing would be installed for + that package. +- Please append to the file if it exists as the helper may be called multiple + times (once with `-a` and once with `-i`). It is completely fine if this + leaves duplicate entries as dh_missing will deduplicate these. +- If your helper has a PROMISE, it must use `pkgfile-logged(<file>)` + for its config files (see [#867246]). + CAVEAT: This requires a dependency on "debhelper (>= 10.2.5)". Prior + to that version, debhelper will wrongly optimize your helper out. + +## Buildsystem Classes + +The `dh_auto_*` commands are frontends that use debhelper buildsystem +classes. These classes have names like `Debian::Debhelper::Buildsystem::foo`, +and are derived from `Debian::Debhelper::Buildsystem`, or other, related +classes. + +A buildsystem class needs to inherit or define these methods: `DESCRIPTION`, +`check_auto_buildable`, `configure`, `build`, `test`, `install`, `clean`. See +the comments inside `Debian::Debhelper::Buildsystem` for details. Note that +this interface is still subject to change. + +Note that third-party buildsystems will not automatically be used by +default. The package maintainer will either have to explicitly enable +it via the `--buildsystem` parameter OR the build system should be +registered in debhelper. The latter is currently needed to ensure a +stable and well-defined ordering of the build systems. + +[dh(1)]: https://manpages.debian.org/dh.1 "dh - debhelper command sequencer" +[debhelper(7)]: https://manpages.debian.org/debhelper.7 "debhelper - the debhelper tool suite" +[#867246]: https://bugs.debian.org/867246 "dh_installman incorrectly optimized away when using --fail-missing and building arch-any packages only" + +-- Joey Hess <joeyh@debian.org> diff --git a/doc/TODO b/doc/TODO index a8f867d125ecc90ef7b6aeb7e48978dc60098bc0..6da26db08b63ec4f1d509490c6b446f12e4b17ab 100644 --- a/doc/TODO +++ b/doc/TODO @@ -15,9 +15,6 @@ Deprecated: a string are not used in debhelper itself, but have been left in the library in case other things use them. Deprecate and remove. * debian/compress files -* deprecate dh_gconf for dh_installgsettings (stuff should be migrating - away from gconf, and then I can just remove it -- have not added warning - or depreaction docs yet) Also, grep the entire archive for all dh_* command lines, and check to see what other switches are not being used, and maybe remove diff --git a/lib/Debian/Debhelper/Buildsystem.pm b/lib/Debian/Debhelper/Buildsystem.pm index 47d9b7ebb1e3decfb7f4b280cfc0d737cad997aa..795f3d3d77922f2ab7d44721e0992cf5018a64b7 100644 --- a/lib/Debian/Debhelper/Buildsystem.pm +++ b/lib/Debian/Debhelper/Buildsystem.pm @@ -413,7 +413,7 @@ sub get_build_rel2sourcedir { sub mkdir_builddir { my $this=shift; if ($this->get_builddir()) { - install_dir($this->get_builddir()); + mkdirs($this->get_builddir()); } } diff --git a/lib/Debian/Debhelper/Buildsystem/autoconf.pm b/lib/Debian/Debhelper/Buildsystem/autoconf.pm index 3b2500831570183f9177d35aab25a17df7822d6b..8752ea178afb38ffde86091edafdc4079d45a0d4 100644 --- a/lib/Debian/Debhelper/Buildsystem/autoconf.pm +++ b/lib/Debian/Debhelper/Buildsystem/autoconf.pm @@ -8,7 +8,7 @@ package Debian::Debhelper::Buildsystem::autoconf; use strict; use warnings; -use Debian::Debhelper::Dh_Lib qw(%dh dpkg_architecture_value sourcepackage compat); +use Debian::Debhelper::Dh_Lib qw(%dh dpkg_architecture_value get_buildoption sourcepackage compat); use parent qw(Debian::Debhelper::Buildsystem::makefile); sub DESCRIPTION { @@ -85,7 +85,13 @@ sub configure { sub test { my $this=shift; + + my $parallel = $this->get_parallel(); + my @autotest; + push @autotest, "-j$parallel"; + push @autotest, "--verbose" if not get_buildoption("terse"); $this->make_first_existing_target(['test', 'check'], + "TESTSUITEFLAGS=@autotest", "VERBOSE=1", @_); } diff --git a/lib/Debian/Debhelper/Buildsystem/cmake.pm b/lib/Debian/Debhelper/Buildsystem/cmake.pm index aa1d0c3a366bfc75b4eba0303c89f387368f2f23..c4a2ad9c314a80ff1594c515d3aebbf31bc94a34 100644 --- a/lib/Debian/Debhelper/Buildsystem/cmake.pm +++ b/lib/Debian/Debhelper/Buildsystem/cmake.pm @@ -8,7 +8,7 @@ package Debian::Debhelper::Buildsystem::cmake; use strict; use warnings; -use Debian::Debhelper::Dh_Lib qw(%dh compat dpkg_architecture_value error is_cross_compiling); +use Debian::Debhelper::Dh_Lib qw(%dh compat dpkg_architecture_value error is_cross_compiling get_buildoption print_and_doit); use parent qw(Debian::Debhelper::Buildsystem); my @STANDARD_CMAKE_FLAGS = qw( @@ -17,7 +17,9 @@ my @STANDARD_CMAKE_FLAGS = qw( -DCMAKE_INSTALL_SYSCONFDIR=/etc -DCMAKE_INSTALL_LOCALSTATEDIR=/var -DCMAKE_EXPORT_NO_PACKAGE_REGISTRY=ON + -DCMAKE_FIND_USE_PACKAGE_REGISTRY=OFF -DCMAKE_FIND_PACKAGE_NO_PACKAGE_REGISTRY=ON + -DFETCHCONTENT_FULLY_DISCONNECTED=ON ); my %DEB_HOST2CMAKE_SYSTEM = ( @@ -86,8 +88,8 @@ sub configure { push(@flags, '-DCMAKE_INSTALL_RUNSTATEDIR=/run') if not compat(10); # Speed up installation phase a bit. push(@flags, "-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON") if not compat(12); - # Reproducibility #962474 - push(@flags, "-DCMAKE_SKIP_RPATH=ON", '-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON') if not compat(13); + # Reproducibility #962474 / #1004939 + push(@flags, '-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON') if not compat(13); if (exists($TARGET_BUILD_SYSTEM2CMAKE_GENERATOR{$backend})) { my $generator = $TARGET_BUILD_SYSTEM2CMAKE_GENERATOR{$backend}; push(@flags, "-G${generator}"); @@ -170,9 +172,31 @@ sub test { # -j1). So in order to simulate unlimited parallel, allow to fork a huge # number of threads instead. my $parallel = ($this->get_parallel() > 0) ? $this->get_parallel() : 999; - push(@_, "ARGS+=-j$parallel"); + unshift(@_, "ARGS+=-j$parallel"); + unshift(@_, "ARGS+=--verbose") if not get_buildoption("terse"); } return $this->SUPER::test(@_); } +sub install { + my $this = shift; + my $target = $this->get_targetbuildsystem; + + if (compat(13)) { + $target->install(@_); + } else { + # In compat 14 `cmake --install` is preferred to `make install`, + # see https://bugs.debian.org/1020732 + my $destdir = shift; + my %options = ( + update_env => { + 'LC_ALL' => 'C.UTF-8', + 'DESTDIR' => $destdir, + } + ); + print_and_doit(\%options, 'cmake', '--install', $this->get_buildpath, @_); + } + return 1; +} + 1 diff --git a/lib/Debian/Debhelper/Buildsystem/makefile.pm b/lib/Debian/Debhelper/Buildsystem/makefile.pm index 64b7c6bc3586d936c833f6b0da006e034e1fc354..856a6dd4dea9a9ae28b0cf260339721bbf2a4c81 100644 --- a/lib/Debian/Debhelper/Buildsystem/makefile.pm +++ b/lib/Debian/Debhelper/Buildsystem/makefile.pm @@ -142,11 +142,17 @@ sub check_auto_buildable { return 0; } +sub _should_inject_cross_build_tools { + my ($this) = @_; + return ref($this) eq 'Debian::Debhelper::Buildsystem::makefile'; +} + + sub build { my $this=shift; if (not $this->_is_targetbuildsystem - and ref($this) eq 'Debian::Debhelper::Buildsystem::makefile' - and is_cross_compiling()) { + and is_cross_compiling() + and $this->_should_inject_cross_build_tools) { # Only inject build tools variables during cross-compile when # makefile is the explicit *main* build system. for my $var (sort(keys(%DEB_DEFAULT_TOOLS))) { diff --git a/lib/Debian/Debhelper/Buildsystem/meson.pm b/lib/Debian/Debhelper/Buildsystem/meson.pm index 49fbbb640a116742fb04583055e1c2aeb0932382..3cd447dee4c1bedf3f020cf329a868c6a24b546b 100644 --- a/lib/Debian/Debhelper/Buildsystem/meson.pm +++ b/lib/Debian/Debhelper/Buildsystem/meson.pm @@ -94,7 +94,7 @@ sub configure { my %options = ( update_env => { LC_ALL => 'C.UTF-8'}, ); - $this->doit_in_builddir(\%options, "meson", $this->get_source_rel2builddir(), @opts, @_); + $this->doit_in_builddir(\%options, "meson", "setup", $this->get_source_rel2builddir(), @opts, @_); }; if ($@) { if (-e $this->get_buildpath("meson-logs/meson-log.txt")) { @@ -134,6 +134,25 @@ sub test { return 1; } +sub install { + my ($this, $destdir, @args) = @_; + my $target = $this->get_targetbuildsystem; + + if (compat(13) or $target->NAME ne 'ninja') { + $target->install($destdir, @args); + } else { + # In compat 14 with meson+ninja, we prefer using "meson install" + # over "ninja install" + my %options = ( + update_env => { + 'LC_ALL' => 'C.UTF-8', + } + ); + $this->doit_in_builddir(\%options, 'meson', 'install', '--destdir', $destdir, @args); + } + return 1; +} + 1 diff --git a/lib/Debian/Debhelper/Buildsystem/perl_build.pm b/lib/Debian/Debhelper/Buildsystem/perl_build.pm index 40f6d1c29f08226c11821714db8b9593f899d962..875290547da70705ca0e8d3f21467a148fb9c7db 100644 --- a/lib/Debian/Debhelper/Buildsystem/perl_build.pm +++ b/lib/Debian/Debhelper/Buildsystem/perl_build.pm @@ -41,7 +41,7 @@ sub do_perl { warning("cross Config.pm does not exist (missing build dependency on perl-xs-dev?)"); } } - $this->doit_in_sourcedir(\%options, "perl", @_); + $this->doit_in_sourcedir(\%options, $^X, @_); } sub new { diff --git a/lib/Debian/Debhelper/Buildsystem/perl_makemaker.pm b/lib/Debian/Debhelper/Buildsystem/perl_makemaker.pm index c8c401bf3c20be8abf1ac70f6c916f6a79584629..881f1eccedb90f3d8de115a7dfe80628aedc8fd8 100644 --- a/lib/Debian/Debhelper/Buildsystem/perl_makemaker.pm +++ b/lib/Debian/Debhelper/Buildsystem/perl_makemaker.pm @@ -72,7 +72,7 @@ sub configure { push @perl_flags, $cross_flag if is_cross_compiling() and defined $cross_flag; - $this->doit_in_sourcedir("perl", @perl_flags, "Makefile.PL", "INSTALLDIRS=vendor", + $this->doit_in_sourcedir($^X, @perl_flags, "Makefile.PL", "INSTALLDIRS=vendor", # if perl_build is not tested first, need to pass packlist # option to handle fallthrough case (compat(7) ? "create_packlist=0" : ()), diff --git a/lib/Debian/Debhelper/DH/AddonAPI.pm b/lib/Debian/Debhelper/DH/AddonAPI.pm index 499ec00663e7c41f53e392b12cda8708f562b870..44082a9b04f11155a7dbf44c648d7508b9ad1544 100644 --- a/lib/Debian/Debhelper/DH/AddonAPI.pm +++ b/lib/Debian/Debhelper/DH/AddonAPI.pm @@ -210,9 +210,17 @@ sub remove_command_options { } sub declare_command_obsolete { - my ($command) = @_; + my ($error_compat, $command) = @_; + if (not defined($command) and defined($error_compat)) { + # Backwards compat - originally this only accepted one command. + $command = $error_compat; + $error_compat = 13; + } + if ($error_compat < 13) { + error("Minimum error compat is 13 (got ${error_compat} for command: ${command})"); + } _assert_not_conditional_sequence_addon('declare_command_obsolete'); - $Debian::Debhelper::DH::SequenceState::obsolete_command{$command} = $DH_INTERNAL_ADDON_NAME; + $Debian::Debhelper::DH::SequenceState::obsolete_command{$command} = [$DH_INTERNAL_ADDON_NAME, $error_compat]; return 1; } diff --git a/lib/Debian/Debhelper/Dh_Buildsystems.pm b/lib/Debian/Debhelper/Dh_Buildsystems.pm index 08b1477718f2165c4fe8526427f21b7e175c55be..9918969e9585d39c6b595f710ca92ca42a43e080 100644 --- a/lib/Debian/Debhelper/Dh_Buildsystems.pm +++ b/lib/Debian/Debhelper/Dh_Buildsystems.pm @@ -38,9 +38,13 @@ our @BUILDSYSTEMS = ( our @THIRD_PARTY_BUILDSYSTEMS = ( 'maven', 'gradle', + 'mkcmake', + 'bmake', + 'golang', ); -my $opt_buildsys; +# Visible for dh_assistant's sake; not API for external tools! +our $opt_buildsys; my $opt_sourcedir; my $opt_builddir; my $opt_list; diff --git a/lib/Debian/Debhelper/Dh_Getopt.pm b/lib/Debian/Debhelper/Dh_Getopt.pm index 6d9540573230758b51cc41213ea1718562d67177..5486c416e72b1c11de5ca9c8d104e51a5fd5d105 100644 --- a/lib/Debian/Debhelper/Dh_Getopt.pm +++ b/lib/Debian/Debhelper/Dh_Getopt.pm @@ -11,7 +11,7 @@ use warnings; use Debian::Debhelper::Dh_Lib; use Getopt::Long; -my (%exclude_package, %internal_excluded_package, %explicitly_reqested_packages, %profile_enabled_packages, +my (%exclude_package, %internal_excluded_package, %explicitly_requested_packages, %profile_enabled_packages, $profile_excluded_pkg); sub showhelp { @@ -44,7 +44,7 @@ sub AddPackage { my($option,$value)=@_; elsif ($option eq 'p' or $option eq 'package') { assert_opt_is_known_package($value, '-p/--package'); %profile_enabled_packages = map { $_ => 1 } getpackages('both') if not %profile_enabled_packages; - $explicitly_reqested_packages{$value} = 1; + $explicitly_requested_packages{$value} = 1; # Silently ignore packages that are not enabled by the # profile. if (exists($profile_enabled_packages{$value})) { @@ -73,7 +73,8 @@ sub ExcludePackage { } # Add another item to the exclude list. -sub AddExclude { my($option,$value)=@_; +sub AddExclude { + my($option,$value)=@_; push @{$dh{EXCLUDE}},$value; } @@ -228,7 +229,7 @@ sub parseopts { @ARGV_extra=split_options_string($ENV{DH_OPTIONS}); my $ret=getoptions(\@ARGV_extra, %params); if (!$ret) { - warning("warning: ignored unknown options in DH_OPTIONS"); + warning("ignored unknown options in DH_OPTIONS"); } } @@ -272,12 +273,10 @@ sub parseopts { # Remove excluded packages from the list of packages to act on. # Also unique the list, in case some options were specified that # added a package to it twice. - my @package_list; - my $package; - my %packages_seen; + my (@package_list, $package, %packages_seen); foreach $package (@{$dh{DOPACKAGES}}) { if (defined($dh{EXCLUDE_LOGGED}) && - grep { $_ eq basename($0) } load_log($package)) { + grep { $_ eq $Debian::Debhelper::Dh_Lib::TOOL_NAME } load_log($package)) { $exclude_package{$package}=1; } if (! $exclude_package{$package}) { @@ -292,16 +291,16 @@ sub parseopts { if (! defined $dh{DOPACKAGES} || ! @{$dh{DOPACKAGES}}) { if (! $dh{BLOCK_NOOP_WARNINGS}) { my %archs; - if (%explicitly_reqested_packages) { + if (%explicitly_requested_packages) { # Avoid sending a confusing error message when debhelper must exclude a package given via -p. # This commonly happens due to Build-Profiles or/and when build only a subset of the packages # (e.g. dpkg-buildpackage -A vs. -B vs. none of the options) - for my $pkg (sort(keys(%explicitly_reqested_packages))) { + for my $pkg (sort(keys(%explicitly_requested_packages))) { if (exists($internal_excluded_package{$pkg}) or not exists($profile_enabled_packages{$pkg})) { - delete($explicitly_reqested_packages{$pkg}); + delete($explicitly_requested_packages{$pkg}); } } - if (not %explicitly_reqested_packages) { + if (not %explicitly_requested_packages) { warning('All requested packages have been excluded' . ' (e.g. via a Build-Profile or due to architecture restrictions).'); exit(0); @@ -317,11 +316,11 @@ sub parseopts { } if (defined $dh{U_PARAMS}) { - # Split the U_PARAMS up into an array. - my $u=$dh{U_PARAMS}; - undef $dh{U_PARAMS}; - push @{$dh{U_PARAMS}}, split(/\s+/,$u); - } + # Split the U_PARAMS up into an array. + my $u=$dh{U_PARAMS}; + undef $dh{U_PARAMS}; + push @{$dh{U_PARAMS}}, split(/\s+/,$u); + } # Anything left in @ARGV is options that appeared after a -- # These options are added to the U_PARAMS array, while the diff --git a/lib/Debian/Debhelper/Dh_Lib.pm b/lib/Debian/Debhelper/Dh_Lib.pm index 01470f41f27a5d4230297d4b0498d41d3e6ab15d..7cf59e03a5339695d6814daa8d24367767172e47 100644 --- a/lib/Debian/Debhelper/Dh_Lib.pm +++ b/lib/Debian/Debhelper/Dh_Lib.pm @@ -17,7 +17,7 @@ no feature 'unicode_strings'; use constant { # Lowest compat level supported - 'MIN_COMPAT_LEVEL' => 5, + 'MIN_COMPAT_LEVEL' => 7, # Lowest compat level that does *not* cause deprecation # warnings 'LOWEST_NON_DEPRECATED_COMPAT_LEVEL' => 10, @@ -25,7 +25,7 @@ use constant { # relations for. 'LOWEST_VIRTUAL_DEBHELPER_COMPAT_LEVEL' => 9, # Highest compat level permitted - 'MAX_COMPAT_LEVEL' => 14, + 'MAX_COMPAT_LEVEL' => 15, # Magic value for xargs 'XARGS_INSERT_PARAMS_HERE' => \'<INSERT-HERE>', #'# Hi emacs. # Magic value for debhelper tools to request "current version" @@ -54,7 +54,7 @@ use constant { 'DBGSYM_PACKAGE_TYPE' => DEFAULT_PACKAGE_TYPE, # Lowest compat level supported that is not scheduled for removal. # - Set to MIN_COMPAT_LEVEL when there are no pending compat removals. - 'MIN_COMPAT_LEVEL_NOT_SCHEDULED_FOR_REMOVAL' => 7, + 'MIN_COMPAT_LEVEL_NOT_SCHEDULED_FOR_REMOVAL' => MIN_COMPAT_LEVEL, }; @@ -124,6 +124,7 @@ qw( package_multiarch package_section package_arch + package_type process_pkg compute_doc_main_package isnative @@ -133,6 +134,7 @@ qw( qw( basename dirname + mkdirs install_file install_prog install_lib @@ -193,6 +195,7 @@ qw( qw( open_gz get_source_date_epoch + get_non_binnmu_date_epoch deprecated_functionality ), # Special-case functionality (e.g. tool specific), debhelper(-core) functionality and deprecated functions @@ -202,6 +205,7 @@ qw( write_log commit_override_log debhelper_script_subst + debhelper_script_per_package_subst is_make_jobserver_unavailable clean_jobserver_makeflags set_buildflags @@ -225,6 +229,7 @@ our $PKGVERSION_REGEX = qr/ (?: - [0-9A-Za-z.+:~]+ )* # Optional debian revision (+ upstreams versions with hyphens) /xoa; our $MAINTSCRIPT_TOKEN_REGEX = qr/[A-Za-z0-9_.+]+/o; +our $TOOL_NAME = basename($0); # From Policy 5.1: # @@ -372,7 +377,7 @@ sub END { # expect. return if not -f 'debian/control'; if (compat(9, 1) || $ENV{DH_INTERNAL_OVERRIDE}) { - write_log(basename($0), @{$dh{DOPACKAGES}}); + write_log($TOOL_NAME, @{$dh{DOPACKAGES}}); } } @@ -484,6 +489,35 @@ sub print_and_doit_noerror { goto \&_doit; } +sub _post_fork_setup_and_exec { + my ($close_stdin, $options, @cmd) = @_; + if (defined($options)) { + if (defined(my $dir = $options->{chdir})) { + if ($dir ne '.') { + chdir($dir) or error("chdir(\"${dir}\") failed: $!"); + } + } + if ($close_stdin) { + open(STDIN, '<', '/dev/null') or error("redirect STDIN failed: $!"); + } + if (defined(my $output = $options->{stdout})) { + open(STDOUT, '>', $output) or error("redirect STDOUT failed: $!"); + } + if (defined(my $update_env = $options->{update_env})) { + while (my ($k, $v) = each(%{$update_env})) { + if (defined($v)) { + $ENV{$k} = $v; + } else { + delete($ENV{$k}); + } + } + } + } + # Force execvp call to avoid shell. Apparently, even exec can + # involve a shell if you don't do this. + exec { $cmd[0] } @cmd or error('exec (for cmd: ' . escape_shell(@cmd) . ") failed: $!"); +} + sub _doit { my (@cmd) = @_; my $options = ref($cmd[0]) ? shift(@cmd) : undef; @@ -497,29 +531,7 @@ sub _doit { return 1 if $dh{NO_ACT}; my $pid = fork() // error("fork(): $!"); if (not $pid) { - if (defined($options)) { - if (defined(my $dir = $options->{chdir})) { - if ($dir ne '.') { - chdir($dir) or error("chdir(\"${dir}\") failed: $!"); - } - } - open(STDIN, '<', '/dev/null') or error("redirect STDIN failed: $!"); - if (defined(my $output = $options->{stdout})) { - open(STDOUT, '>', $output) or error("redirect STDOUT failed: $!"); - } - if (defined(my $update_env = $options->{update_env})) { - while (my ($k, $v) = each(%{$update_env})) { - if (defined($v)) { - $ENV{$k} = $v; - } else { - delete($ENV{$k}); - } - } - } - } - # Force execvp call to avoid shell. Apparently, even exec can - # involve a shell if you don't do this. - exec { $cmd[0] } @cmd; + _post_fork_setup_and_exec(1, $options, @cmd) // error("Assertion error: sub should not return!"); } return waitpid($pid, 0) == $pid && $? == 0; } @@ -558,8 +570,12 @@ sub _format_cmdline { sub qx_cmd { my (@cmd) = @_; + my $options = ref($cmd[0]) ? shift(@cmd) : undef; my ($output, @output); - open(my $fd, '-|', @cmd) or error('fork+exec (' . escape_shell(@cmd) . "): $!"); + my $pid = open(my $fd, '-|') // error('fork (for cmd: ' . escape_shell(@cmd) . ") failed: $!"); + if ($pid == 0) { + _post_fork_setup_and_exec(0, $options, @cmd) // error("Assertion error: sub should not return!"); + } if (wantarray) { @output = <$fd>; } else { @@ -653,28 +669,42 @@ sub error_exitcode { } } -sub install_dir { - my @to_create = grep { not -d $_ } @_; - return if not @to_create; + +sub _mkdirs { + my ($log, @dirs) = @_; + return if not @dirs; + if ($log && $dh{VERBOSE}) { + verbose_print(sprintf('install -m0755 -d %s', escape_shell(@dirs))); + } + return 1 if $dh{NO_ACT}; state $_loaded; if (not $_loaded) { $_loaded++; require File::Path; } - verbose_print(sprintf('install -d %s', escape_shell(@to_create))) - if $dh{VERBOSE}; - return 1 if $dh{NO_ACT}; + my %opts = ( + # install -d uses 0755 (no umask), make_path uses 0777 (& umask) by default. + # Since we claim to run install -d, then ensure the mode is correct. + 'chmod' => 0755, + ); eval { - File::Path::make_path(@to_create, { - # install -d uses 0755 (no umask), make_path uses 0777 (& umask) by default. - # Since we claim to run install -d, then ensure the mode is correct. - 'chmod' => 0755, - }); + File::Path::make_path(@dirs, \%opts); }; if (my $err = "$@") { $err =~ s/\s+at\s+\S+\s+line\s+\d+\.?\n//; error($err); } + return; +} + +sub mkdirs { + my @to_create = grep { not -d $_ } @_; + return _mkdirs(0, @to_create); +} + +sub install_dir { + my @dirs = @_; + return _mkdirs(1, @dirs); } sub rename_path { @@ -847,7 +877,7 @@ sub error { my ($message) = @_; # ensure the error code is well defined. $! = 255; - die(_color(basename($0), 'bold') . ': ' . _color('error', 'bold red') . ": $message\n"); + die(_color($TOOL_NAME, 'bold') . ': ' . _color('error', 'bold red') . ": $message\n"); } # Output a warning. @@ -855,7 +885,7 @@ sub warning { my ($message) = @_; $message //= ''; - print STDERR _color(basename($0), 'bold') . ': ' . _color('warning', 'bold yellow') . ": $message\n"; + print STDERR _color($TOOL_NAME, 'bold') . ': ' . _color('warning', 'bold yellow') . ": $message\n"; } # Returns the basename of the argument passed to it. @@ -882,6 +912,8 @@ my $compat_from_bd; { my $check_pending_removals = get_buildoption('dherroron', '') eq 'obsolete-compat-levels' ? 1 : 0; my $warned_compat = $ENV{DH_INTERNAL_TESTSUITE_SILENT_WARNINGS} ? 1 : 0; + my $declared_compat; + my $delared_compat_source; my $c; # Used mainly for testing @@ -890,51 +922,71 @@ my $compat_from_bd; undef $compat_from_bd; } - sub compat { - my $num=shift; - my $nowarn=shift; + sub _load_compat_info { + my ($nowarn) = @_; getpackages() if not defined($compat_from_bd); - - if (! defined $c) { - $c=1; - if (-e 'debian/compat') { - open(my $compat_in, '<', "debian/compat") || error "debian/compat: $!"; - my $l=<$compat_in>; - close($compat_in); - if (! defined $l || ! length $l) { - error("debian/compat must contain a positive number (found an empty first line)"); + $c=1; + if (-e 'debian/compat') { + open(my $compat_in, '<', "debian/compat") || error "debian/compat: $!"; + my $l=<$compat_in>; + close($compat_in); + if (! defined $l || ! length $l) { + error("debian/compat must contain a positive number (found an empty first line)"); + + } + else { + chomp $l; + my $new_compat = $l; + $new_compat =~ s/^\s*+//; + $new_compat =~ s/\s*+$//; + if ($new_compat !~ m/^\d+$/) { + error("debian/compat must contain a positive number (found: \"${new_compat}\")"); } - else { - chomp $l; - my $new_compat = $l; - $new_compat =~ s/^\s*+//; - $new_compat =~ s/\s*+$//; - if ($new_compat !~ m/^\d+$/) { - error("debian/compat must contain a positive number (found: \"${new_compat}\")"); - } - if (defined($compat_from_bd) and $compat_from_bd != -1) { - warning("Please specify the debhelper compat level exactly once."); - warning(" * debian/compat requests compat ${new_compat}."); - warning(" * debian/control requests compat ${compat_from_bd} via \"debhelper-compat (= ${compat_from_bd})\""); - warning(); - warning("Hint: If you just added a build-dependency on debhelper-compat, then please remember to remove debian/compat"); - warning(); - error("debhelper compat level specified both in debian/compat and via build-dependency on debhelper-compat"); - } - $c = $new_compat; + if (defined($compat_from_bd) and $compat_from_bd != -1) { + warning("Please specify the debhelper compat level exactly once."); + warning(" * debian/compat requests compat ${new_compat}."); + warning(" * debian/control requests compat ${compat_from_bd} via \"debhelper-compat (= ${compat_from_bd})\""); + warning(); + warning("Hint: If you just added a build-dependency on debhelper-compat, then please remember to remove debian/compat"); + warning(); + error("debhelper compat level specified both in debian/compat and via build-dependency on debhelper-compat"); } - } elsif ($compat_from_bd != -1) { - $c = $compat_from_bd; - } elsif (not $nowarn) { - error("Please specify the compatibility level in debian/compat"); + $c = $new_compat; } + $delared_compat_source = 'debian/compat'; + } elsif ($compat_from_bd != -1) { + $c = $compat_from_bd; + $delared_compat_source = "Build-Depends: debhelper-compat (= $c)"; + } elsif (not $nowarn) { + error("Please specify the compatibility level in debian/compat or via Build-Depends: debhelper-compat (= X)"); + } - if (defined $ENV{DH_COMPAT}) { - $c=$ENV{DH_COMPAT}; - } + $declared_compat = int($c); + + if (defined $ENV{DH_COMPAT}) { + my $override = $ENV{DH_COMPAT}; + error("The environment variable DH_COMPAT must be a positive integer") + if $override ne q{} and $override !~ m/^\d+$/; + $c=int($ENV{DH_COMPAT}) if $override ne q{}; } + } + + sub get_compat_info { + if (not $c) { + _load_compat_info(1); + } + return ($c, $declared_compat, $delared_compat_source); + } + + sub compat { + my ($num, $nowarn) = @_; + + if (not $c) { + _load_compat_info($nowarn); + } + if (not $nowarn) { if ($c < MIN_COMPAT_LEVEL) { error("Compatibility levels before ${\MIN_COMPAT_LEVEL} are no longer supported (level $c requested)"); @@ -1206,14 +1258,13 @@ sub autoscript { } } - if (-e $outfile && ($script eq 'postrm' || $script eq 'prerm') - && !compat(5)) { + if (-e $outfile && ($script eq 'postrm' || $script eq 'prerm')) { # Add fragments to top so they run in reverse order when removing. if (not defined($sed) or ref($sed)) { verbose_print("[META] Prepend autosnippet \"$filename\" to $script [${outfile}.new]"); if (not $dh{NO_ACT}) { open(my $out_fd, '>', "${outfile}.new") or error("open(${outfile}.new): $!"); - print {$out_fd} '# Automatically added by ' . basename($0) . "/${tool_version}\n"; + print {$out_fd} '# Automatically added by ' . $TOOL_NAME . "/${tool_version}\n"; autoscript_sed($sed, $infile, undef, $out_fd); print {$out_fd} "# End automatically added section\n"; open(my $in_fd, '<', $outfile) or error("open($outfile): $!"); @@ -1224,7 +1275,7 @@ sub autoscript { close($out_fd) or error("close(${outfile}.new): $!"); } } else { - complex_doit("echo \"# Automatically added by ".basename($0)."/${tool_version}\"> $outfile.new"); + complex_doit("echo \"# Automatically added by ".$TOOL_NAME."/${tool_version}\"> $outfile.new"); autoscript_sed($sed, $infile, "$outfile.new"); complex_doit("echo '# End automatically added section' >> $outfile.new"); complex_doit("cat $outfile >> $outfile.new"); @@ -1234,13 +1285,13 @@ sub autoscript { verbose_print("[META] Append autosnippet \"$filename\" to $script [${outfile}]"); if (not $dh{NO_ACT}) { open(my $out_fd, '>>', $outfile) or error("open(${outfile}): $!"); - print {$out_fd} '# Automatically added by ' . basename($0) . "/${tool_version}\n"; + print {$out_fd} '# Automatically added by ' . $TOOL_NAME . "/${tool_version}\n"; autoscript_sed($sed, $infile, undef, $out_fd); print {$out_fd} "# End automatically added section\n"; close($out_fd) or error("close(${outfile}): $!"); } } else { - complex_doit("echo \"# Automatically added by ".basename($0)."/${tool_version}\">> $outfile"); + complex_doit("echo \"# Automatically added by ".$TOOL_NAME."/${tool_version}\">> $outfile"); autoscript_sed($sed, $infile, $outfile); complex_doit("echo '# End automatically added section' >> $outfile"); } @@ -1309,7 +1360,7 @@ sub autoscript_sed { }x; print {$ofd} $line; } - print {$ofd} '# Triggers added by ' . basename($0) . "/${tool_version}\n"; + print {$ofd} '# Triggers added by ' . $TOOL_NAME . "/${tool_version}\n"; print {$ofd} "${trigger_type} ${trigger_target}\n"; close($ofd) or error("closing ${triggers_file}.new failed: $!"); close($ifd); @@ -1326,72 +1377,99 @@ sub generated_file { my $dir = "debian/.debhelper/generated/${package}"; my $path = "${dir}/${filename}"; $mkdirs //= 1; - install_dir($dir) if $mkdirs; + mkdirs($dir) if $mkdirs; return $path; } +sub _update_substvar { + my ($substvar_file, $update_logic, $insert_logic) = @_; + my @lines; + my $changed = 0; + if ( -f $substvar_file) { + open(my $in, '<', $substvar_file) // error("open($substvar_file): $!"); + while (my $line = <$in>) { + chomp($line); + my $orig_value = $line; + my $updated_value = $update_logic->($line); + $changed ||= !defined($updated_value) || $orig_value ne $updated_value; + push(@lines, $updated_value) if defined($updated_value); + } + close($in); + } + my $len = scalar(@lines); + push(@lines, $insert_logic->()) if $insert_logic; + $changed ||= $len != scalar(@lines); + if ($changed && !$dh{NO_ACT}) { + open(my $out, '>', "${substvar_file}.new") // error("open(${substvar_file}.new, \"w\"): $!"); + for my $line (@lines) { + print {$out} "$line\n"; + } + close($out) // error("close(${substvar_file}.new): $!"); + rename_path("${substvar_file}.new", $substvar_file); + } + return; +} + # Removes a whole substvar line. sub delsubstvar { - my $package=shift; - my $substvar=shift; - - my $ext=pkgext($package); - my $substvarfile="debian/${ext}substvars"; + my ($package, $substvar) = @_; + my $ext = pkgext($package); + my $substvarfile = "debian/${ext}substvars"; - if (-e $substvarfile) { - complex_doit("grep -a -s -v '^${substvar}=' $substvarfile > $substvarfile.new || true"); - rename_path("${substvarfile}.new", $substvarfile); - } + return _update_substvar($substvarfile, sub { + my ($line) = @_; + return $line if $line !~ m/^\Q${substvar}\E[?]?=/; + return; + }); } # Adds a dependency on some package to the specified # substvar in a package's substvar's file. sub addsubstvar { - my $package=shift; - my $substvar=shift; - my $deppackage=shift; - my $verinfo=shift; - my $remove=shift; - - my $ext=pkgext($package); - my $substvarfile="debian/${ext}substvars"; - my $str=$deppackage; - $str.=" ($verinfo)" if defined $verinfo && length $verinfo; - - # Figure out what the line will look like, based on what's there - # now, and what we're to add or remove. - my $line=""; - if (-e $substvarfile) { - my %items; - open(my $in, '<', $substvarfile) || error "read $substvarfile: $!"; - while (<$in>) { - chomp; - if (/^\Q$substvar\E=(.*)/) { - %items = map { $_ => 1} split(", ", $1); - - last; - } - } - close($in); - if (! $remove) { - $items{$str}=1; - } - else { - delete $items{$str}; - } - $line=join(", ", sort keys %items); - } - elsif (! $remove) { - $line=$str; - } - - if (length $line) { - complex_doit("(grep -a -s -v ${substvar} $substvarfile; echo ".escape_shell("${substvar}=$line").") > $substvarfile.new"); - rename_path("$substvarfile.new", $substvarfile); - } - else { - delsubstvar($package,$substvar); - } + my ($package, $substvar, $deppackage, $verinfo, $remove) = @_; + my ($present); + my $ext = pkgext($package); + my $substvarfile = "debian/${ext}substvars"; + my $str = $deppackage; + $str .= " ($verinfo)" if defined $verinfo && length $verinfo; + + if (not defined($deppackage) and not $remove) { + error("Bug in helper: Must provide a value for addsubstvar (or set the remove flag, but then use delsubstvar instead)") + } + + if (defined($str) and $str =~ m/[\n]/) { + $str =~ s/\n/\\n/g; + # Per #1026014 + warning('Unescaped newlines in the value of a substvars can cause broken substvars files (see #1025714).'); + warning("Hint: If you really need a newline character, provide it as \"\${Newline}\"."); + error("Bug in helper: The substvar must not contain a raw newline character (${substvar}=${str})"); + } + + my $update_logic = sub { + my ($line) = @_; + return $line if $line !~ m/^\Q${substvar}\E([?]?=)(.*)/; + my $assignment_type = $1; + my %items = map { $_ => 1 } split(", ", $2); + $present = 1; + if ($remove) { + # Unchanged; we can avoid rewriting the file. + return $line if not exists($items{$str}); + delete($items{$str}); + my $replacement = join(", ", sort(keys(%items))); + return "${substvar}${assignment_type}${replacement}" if $replacement ne ''; + return; + } + # Unchanged; we can avoid rewriting the file. + return $line if %items and exists($items{$str}); + + $items{$str} = 1; + return "${substvar}${assignment_type}" . join(", ", sort(keys(%items))); + }; + my $insert_logic = sub { + return ("${substvar}=${str}") if not $present and not $remove; + return; + }; + return _update_substvar($substvarfile, $update_logic, $insert_logic); } sub _glob_expand_error_default_msg { @@ -1726,6 +1804,7 @@ sub getpackages { sub _strip_spaces { my ($v) = @_; + return if not defined($v); $v =~ s/^\s++//; $v =~ s/\s++$//; return $v; @@ -1953,7 +2032,7 @@ sub _parse_debian_control { $package_types{$package} = _strip_spaces($field_values{'package-type'} // 'deb'); $package_arches{$package} = $arch; $package_multiarches{$package} = _strip_spaces($field_values{'multi-arch'} // ''); - $package_sections{$package} = _strip_spaces($field_values{'section'} // $source_section);; + $package_sections{$package} = _strip_spaces($field_values{'section'} // $source_section); $package_cross_type{$package} = $cross_type; push(@{$packages_by_type{'all-listed-in-control-file'}}, $package); @@ -2123,17 +2202,24 @@ sub package_cross_type { return $package_cross_type{$package} // 'host'; } +sub package_type { + my ($package) = @_; + + if (! exists $package_types{$package}) { + warning "package $package is not in control info"; + return DEFAULT_PACKAGE_TYPE; + } + return $package_types{$package}; +} + # Return true if a given package is really a udeb. sub is_udeb { my $package=shift; - if (! exists $package_types{$package}) { - warning "package $package is not in control info"; - return 0; - } - return $package_types{$package} eq 'udeb'; + return package_type($package) eq 'udeb'; } + sub process_pkg { my ($package) = @_; state %packages_to_process = map { $_ => 1 } @{$dh{DOPACKAGES}}; @@ -2183,6 +2269,24 @@ sub _substitution_generator { }; } +sub debhelper_script_per_package_subst { + my ($package, $provided_subst) = @_; + my %vars = %{$provided_subst}; + $vars{'PACKAGE'} = $package if not exists($vars{'PACKAGE'}); + for my $var (keys(%{$provided_subst})) { + if ($var !~ $Debian::Debhelper::Dh_Lib::MAINTSCRIPT_TOKEN_REGEX) { + warning("User defined token ${var} does not match ${Debian::Debhelper::Dh_Lib::MAINTSCRIPT_TOKEN_REGEX}"); + error("Invalid provided token ${var}: It cannot be substituted as it does not follow the token name rules"); + } + if ($var =~ m/^pkg[.]\Q${package}\E[.](.+)$/) { + my $new_key = $1; + $vars{$new_key} = $provided_subst->{$var}; + } + } + return \%vars; +} + + # Handles #DEBHELPER# substitution in a script; also can generate a new # script from scratch if none exists but there is a .debhelper file for it. sub debhelper_script_subst { @@ -2422,25 +2526,58 @@ sub cross_command { # variable and returns the computed value. sub get_source_date_epoch { return $ENV{SOURCE_DATE_EPOCH} if exists($ENV{SOURCE_DATE_EPOCH}); - eval { require Dpkg::Changelog::Debian }; - if ($@) { - warning "unable to set SOURCE_DATE_EPOCH: $@"; - return; - } - eval { require Time::Piece }; - if ($@) { - warning "unable to set SOURCE_DATE_EPOCH: $@"; - return; - } + _parse_non_binnmu_date_epoch(); + return $ENV{SOURCE_DATE_EPOCH}; +} - my $changelog = Dpkg::Changelog::Debian->new(range => {"count" => 1}); - $changelog->load("debian/changelog"); +{ + my $_non_binnmu_date_epoch; - my $tt = @{$changelog}[0]->get_timestamp(); - $tt =~ s/\s*\([^\)]+\)\s*$//; # Remove the optional timezone codename - my $timestamp = Time::Piece->strptime($tt, "%a, %d %b %Y %T %z"); + # Needed for dh_strip_nondeterminism - not exported by default because it is not likely + # to be useful beyond that one helper. + sub get_non_binnmu_date_epoch { + return $_non_binnmu_date_epoch if defined($_non_binnmu_date_epoch); + _parse_non_binnmu_date_epoch(); + return $_non_binnmu_date_epoch; + } - return $ENV{SOURCE_DATE_EPOCH} = $timestamp->epoch(); + sub _parse_non_binnmu_date_epoch { + eval { require Dpkg::Changelog::Debian }; + if ($@) { + warning "unable to set SOURCE_DATE_EPOCH: $@"; + return; + } + eval { require Time::Piece }; + if ($@) { + warning "unable to set SOURCE_DATE_EPOCH: $@"; + return; + } + + my $changelog = Dpkg::Changelog::Debian->new(range => {"count" => 2}); + $changelog->load("debian/changelog"); + + my $first_entry = $changelog->[0]; + my $non_binnmu_entry = $first_entry; + my $optional_fields = $first_entry->get_optional_fields(); + my $first_tt = $first_entry->get_timestamp(); + $first_tt =~ s/\s*\([^\)]+\)\s*$//; # Remove the optional timezone codename + my $first_timestamp = Time::Piece->strptime($first_tt, "%a, %d %b %Y %T %z")->epoch; + my $non_binnmu_timestamp = $first_timestamp; + if (exists($optional_fields->{'Binary-Only'}) and lc($optional_fields->{'Binary-Only'}) eq 'yes') { + $non_binnmu_entry = $changelog->[1]; + my $non_binnmu_options = $non_binnmu_entry->get_optional_fields(); + if (exists($non_binnmu_options->{'Binary-Only'}) and lc($non_binnmu_options->{'Binary-Only'}) eq 'yes') { + error("internal error: Could not locate the first non-binnmu entry in the change (assumed it would be the second entry)"); + } + my $non_binnmu_tt = $non_binnmu_entry->get_timestamp(); + $non_binnmu_tt =~ s/\s*\([^\)]+\)\s*$//; # Remove the optional timezone codename + $non_binnmu_timestamp = Time::Piece->strptime($non_binnmu_tt, "%a, %d %b %Y %T %z")->epoch(); + } + + $ENV{SOURCE_DATE_EPOCH} = $first_timestamp if not exists($ENV{SOURCE_DATE_EPOCH}); + $_non_binnmu_date_epoch = $non_binnmu_timestamp; + return; + } } # Setup the build ENV by setting dpkg-buildflags (via set_buildflags()) plus @@ -2467,7 +2604,7 @@ sub setup_home_and_xdg_dirs { XDG_DATA_DIRS XDG_RUNTIME_DIR ); - install_dir(@paths); + mkdirs(@paths); for my $envname (@clear_env) { delete($ENV{$envname}); } @@ -2534,7 +2671,7 @@ sub get_buildoption { } elsif ($opt =~ m/^dherroron=(\S*)$/ && $wanted eq 'dherroron') { my $value = $1; if ($value ne 'obsolete-compat-levels') { - warning("Unknown value \"${value}\" as parameter for \"dherrron\" seen in DEB_BUILD_OPTIONS"); + warning("Unknown value \"${value}\" as parameter for \"dherroron\" seen in DEB_BUILD_OPTIONS"); } return $value; } elsif ($opt eq $wanted) { @@ -2563,7 +2700,7 @@ sub _executable_dh_config_file_failed { # The interpreter did not like the file for some reason. # Lets check if the maintainer intended it to be # executable. - if (not is_so_or_exec_elf_file($source) and not _has_shbang_line($source)) { + if (not is_so_or_exec_elf_file($source) and not _has_shebang_line($source)) { warning("${source} is marked executable but does not appear to an executable config."); warning(); warning("If ${source} is intended to be an executable config file, please ensure it can"); @@ -2583,15 +2720,14 @@ sub _executable_dh_config_file_failed { # the package. Under compat 9+ it may execute the file and use its # output instead. # -# install_dh_config_file(SOURCE, TARGET[, MODE]) +# install_dh_config_file(SOURCE, TARGET) sub install_dh_config_file { - my ($source, $target, $mode) = @_; - $mode = 0644 if not defined($mode); + my ($source, $target) = @_; if (!compat(8) and -x $source) { my @sstat = stat(_) || error("cannot stat $source: $!"); open(my $tfd, '>', $target) || error("cannot open $target: $!"); - chmod($mode, $tfd) || error("cannot chmod $target: $!"); + chmod(0644, $tfd) || error("cannot chmod $target: $!"); open(my $sfd, '-|', $source) || error("cannot run $source: $!"); while (my $line = <$sfd>) { print ${tfd} $line; @@ -2603,7 +2739,7 @@ sub install_dh_config_file { # Set the mtime (and atime) to ensure reproducibility. utime($sstat[9], $sstat[9], $target); } else { - _install_file_to_path($mode, $source, $target); + install_file($source, $target); } return 1; } @@ -2613,7 +2749,7 @@ sub restore_file_on_clean { my $bucket_index = 'debian/.debhelper/bucket/index'; my $bucket_dir = 'debian/.debhelper/bucket/files'; my $checksum; - install_dir($bucket_dir); + mkdirs($bucket_dir); if ($file =~ m{^/}) { error("restore_file_on_clean requires a path relative to the package dir"); } @@ -2721,8 +2857,14 @@ sub log_installed_files { my ($package, @patterns) = @_; return if $dh{NO_ACT}; + my $tool = $TOOL_NAME; + if (ref($package) eq 'HASH') { + my $options = $package; + $tool = $options->{'tool_name'} // error('Missing mandatory "tool_name" option for log_installed_files'); + $package = $options->{'package'} // error('Missing mandatory "package" option for log_installed_files'); + } - my $log = generated_file($package, 'installed-by-' . basename($0)); + my $log = generated_file($package, 'installed-by-' . $tool); open(my $fh, '>>', $log) or error("open $log: $!"); for my $src (@patterns) { print $fh "$src\n"; @@ -2778,7 +2920,7 @@ sub is_so_or_exec_elf_file { return 1; } -sub _has_shbang_line { +sub _has_shebang_line { my ($file) = @_; open(my $fd, '<', $file) or error("open $file: $!"); my $line = <$fd>; diff --git a/lib/Debian/Debhelper/Sequence/installsysusers.pm b/lib/Debian/Debhelper/Sequence/installsysusers.pm new file mode 100644 index 0000000000000000000000000000000000000000..47c38e5942f2927814714c1d3bfae85434d7b830 --- /dev/null +++ b/lib/Debian/Debhelper/Sequence/installsysusers.pm @@ -0,0 +1,9 @@ +#!/usr/bin/perl +# Enable dh_installsysusers + +use strict; +use warnings; + +insert_after('dh_install', 'dh_installsysusers'); + +1; diff --git a/lib/Debian/Debhelper/Sequence/python_support.pm b/lib/Debian/Debhelper/Sequence/python_support.pm deleted file mode 100644 index 383407f8adb58babab23bd0e9839042cb7b26f12..0000000000000000000000000000000000000000 --- a/lib/Debian/Debhelper/Sequence/python_support.pm +++ /dev/null @@ -1,10 +0,0 @@ -#!/usr/bin/perl -# Obsolete debhelper sequence file for python-support - -use warnings; -use strict; -use Debian::Debhelper::Dh_Lib qw(deprecated_functionality); - -deprecated_functionality('python_support sequence does nothing as dh_pysupport is no longer available', 11); - -1 diff --git a/lib/Debian/Debhelper/Sequence/root_sequence.pm b/lib/Debian/Debhelper/Sequence/root_sequence.pm index 105076f876c1e877c57bfcd22f3e5c8d125c2d6a..45d908c119b395df12a7145177f8549de94900fc 100644 --- a/lib/Debian/Debhelper/Sequence/root_sequence.pm +++ b/lib/Debian/Debhelper/Sequence/root_sequence.pm @@ -11,7 +11,8 @@ my $include_if_compat_X_or_newer = sub { }; my @obsolete_command = ( - $include_if_compat_X_or_newer->(11, 'dh_systemd_enable', 'dh_systemd_start'), + [13, $include_if_compat_X_or_newer->(11, 'dh_systemd_enable', 'dh_systemd_start')], + [14, 'dh_gconf'], ); my @commands_controlled_by_deb_build_options = ( @@ -47,8 +48,8 @@ my @i = (qw{ dh_installinfo dh_installinit }, - $include_if_compat_X_or_newer->(13, 'dh_installtmpfiles'), $include_if_compat_X_or_newer->(14, 'dh_installsysusers'), + $include_if_compat_X_or_newer->(13, 'dh_installtmpfiles'), $include_if_compat_X_or_newer->(11, 'dh_installsystemd'), $include_if_compat_X_or_newer->(12, 'dh_installsystemduser'), qw{ @@ -63,17 +64,19 @@ qw{ dh_installgsettings }, (!compat(11) ? qw(dh_installinitramfs) : qw()), + (compat(13) ? qw(dh_installalternatives) : qw()), qw{ - dh_installalternatives dh_bugfiles dh_ucf dh_lintian - dh_gconf dh_icons dh_perl dh_usrlocal dh_link +}, + (!compat(13) ? qw(dh_installalternatives) : qw()), +qw{ dh_installwm dh_installxfonts dh_strip_nondeterminism @@ -99,8 +102,11 @@ _add_sequence('clean', SEQUENCE_NO_SUBSEQUENCES, @bd_minimal, qw{ dh_clean }); -for my $command (@obsolete_command) { - declare_command_obsolete($command); +for my $obsolete_command_spec (@obsolete_command) { + my ($error_compat, @cmds) = @{$obsolete_command_spec}; + for my $command (@cmds) { + declare_command_obsolete($error_compat, $command); + } } for my $entry (@commands_controlled_by_deb_build_options) { diff --git a/lib/Debian/Debhelper/Sequence/single_binary.pm b/lib/Debian/Debhelper/Sequence/single_binary.pm new file mode 100644 index 0000000000000000000000000000000000000000..68d8db1c2c0581a7306a86f0e5c65aba542e4915 --- /dev/null +++ b/lib/Debian/Debhelper/Sequence/single_binary.pm @@ -0,0 +1,34 @@ +use strict; +use warnings; + +use Debian::Debhelper::Dh_Lib qw(getpackages error warning tmpdir); +use Debian::Debhelper::SequencerUtil; + +my @packages = getpackages(); +my $pkg = $packages[0]; +my $tmp = tmpdir($pkg); +if (@packages != 1) { + warning('Detected multiple binary packages (Package paragraphs) in debian/control, which is incompatible'); + warning('with the single-binary dh add-on.'); + warning(); + warning('Please:'); + warning(' 1) Remove the single-binary add-on ("dh-sequence-single-binary" in Build-Depends)'); + warning(' 2) Update the packaging to cope with dh_auto_install using \"debian/tmp\" as default dest dir'); + warning(" (Previously, it would probably have used \"${tmp}\")"); + warning(' 3) Add Breaks/Replaces if you are moving existing files into a new package.'); + warning(' 4) Double check that the resulting binaries have content.'); + warning(); + warning("IF YOU ARE ADDING A TRANSITIONAL PACKAGE: Then you probably want to pass --destdir=${tmp} to"); + warning(' dh_auto_install. Most likely you will need Breaks + Replaces as renaming a package counts as'); + warning(' moving files between two packages.'); + warning(); + warning('IF YOU ARE "SPLITTING" THE CONTENT INTO MULTIPLE PACKAGES: Then remember to install the content'); + warning(" into them (by creating debian/${pkg}.install, etc.). Also remember to add Breaks + Replaces if"); + warning(' you are moving files from one package into another.'); + warning(); + error("The single-binary add-on cannot be used for source packages that build multiple binary packages."); +} + +add_command_options('dh_auto_install', "--destdir=${tmp}/"); + +1; diff --git a/lib/Debian/Debhelper/SequencerUtil.pm b/lib/Debian/Debhelper/SequencerUtil.pm index 2b2531e9c1dc16225b69717190598aeed84ecca7..2dc3f78076443669ea2f867c9635df652334d269 100644 --- a/lib/Debian/Debhelper/SequencerUtil.pm +++ b/lib/Debian/Debhelper/SequencerUtil.pm @@ -353,6 +353,7 @@ sub compute_selected_addons { my $sequence_type = sequence_type($sequence_name); my %addon_constraints = %{ Debian::Debhelper::Dh_Lib::bd_dh_sequences() }; + my %explicitly_managed; # Inject elf-tools early as other addons rely on their presence and it historically # has been considered a part of the "core" sequence. @@ -418,15 +419,42 @@ sub compute_selected_addons { error("Invalid request to load the sequence \"root-sequence\": Do not reference it directly"); } if ($request =~ s/^[+]//) { + # Normalize "_" to "-" in the name. + $request =~ tr/_/-/; $flush_disable_cache->() if %disabled_addons; + $explicitly_managed{$request} = 1; push(@enabled_addons, $request) if not $enabled{$request}++; } elsif ($request =~ s/^-//) { + # Normalize "_" to "-" in the name. + $request =~ tr/_/-/; + $explicitly_managed{$request} = 1; $disabled_addons{$request} = 1; } else { error("Internal error: Invalid add-on request: $request (Missing +/- prefix)"); } } + if (compat(14, 1) && getpackages() == 1 && !exists($explicitly_managed{'single-binary'})) { + if (not compat(13, 1)) { + warning("Implicitly activating single-binary dh addon for backwards compatibility. In compat 14+,"); + warning("this fallback will *not* happen automatically and dh_auto_install will instead use a"); + warning("different default for --destdir, which can cause the source to produce an empty binary package"); + warning(); + warning('To keep the existing behaviour, please activate the single-binary addon explicitly.'); + warning('This can be done by adding "dh-sequence-single-binary" to Build-Depends or passing'); + warning('--with=single-binary to dh.'); + warning(); + warning('If you have solved this issue differently (e.g., by passing --destdir explicitly to'); + warning('dh_auto_install or not using dh_auto_install at all) and want to silence this warning'); + warning('without activating the addon, you can do that by passing --without=single-binary to dh'); + warning('to explicitly acknowledge the change.'); + warning(); + warning('Please see the description of the "single-binary" in "man dh" for more details of what'); + warning('it does and why this is changing from implicit behaviour to explicitly opt-in.'); + } + push(@enabled_addons, 'single-binary'); + } + $flush_disable_cache->() if %disabled_addons; return map { { @@ -452,25 +480,30 @@ sub load_sequence_addon { sub check_for_obsolete_commands { my ($full_sequence) = @_; - my ($found_obsolete_targets); + my ($found_obsolete_targets, $min_compat); for my $command (@{$full_sequence}) { if (exists($Debian::Debhelper::DH::SequenceState::obsolete_command{$command})) { - my $addon_name = $Debian::Debhelper::DH::SequenceState::obsolete_command{$command}; + my $addon_name = $Debian::Debhelper::DH::SequenceState::obsolete_command{$command}[1]; error("The addon ${addon_name} claimed that $command was obsolete, but it is not!?"); } } for my $command (sort(keys(%Debian::Debhelper::DH::SequenceState::obsolete_command))) { + my ($addon_name, $error_compat) = @{$Debian::Debhelper::DH::SequenceState::obsolete_command{$command}}; + $addon_name = 'debhelper' if $addon_name eq 'root-sequence'; for my $prefix (qw(execute_before_ execute_after_ override_)) { for my $suffix ('', '-arch', '-indep') { my $target = "${prefix}${command}${suffix}"; if (defined(rules_explicit_target($target))) { $found_obsolete_targets = 1; - warning("The target ${target} references a now obsolete command and will not be run!"); + $min_compat //= $error_compat; + $min_compat = $error_compat if $error_compat < $min_compat; + warning("The target ${target} references a now obsolete command and will not be run!" + . " (Marked by ${addon_name}, will be an error in compat $error_compat)"); } } } } - if ($found_obsolete_targets and not compat(12)) { + if ($found_obsolete_targets and not compat($min_compat - 1)) { error("Aborting due to left over override/hook targets for now removed commands."); } return; @@ -720,7 +753,7 @@ sub run_through_command_sequence { push(@cmd_options, @{$command_opts->{$command}}) if exists($command_opts->{$command}); push(@cmd_options, @opts); - run_sequence_command_and_exit_on_failure($command, @cmd_options); + run_sequence_command_and_exit_on_failure($command, _remove_dup_pkg_options(@cmd_options)); } } @@ -728,6 +761,25 @@ sub run_through_command_sequence { } } +sub _remove_dup_pkg_options { + my (@options) = @_; + my @filtered_options; + my $arch = 0; + my $indep = 0; + for my $option (@options) { + if ($option eq '-a' or $option eq '--arch') { + next if $arch; + $arch = 1; + } + if ($option eq '-i' or $option eq '--indep') { + next if $indep; + $indep = 1; + } + push(@filtered_options, $option); + } + return @filtered_options; +} + sub _stamp_target { my ($command) = @_; diff --git a/man/po4a/po/de.po b/man/po4a/po/de.po index 55fd73c359a8943257e7dc8dd4bec29c7f7f28c8..0ff12d2fb30c99e80b8ddc60b5fc9f4a66f4b0f1 100644 --- a/man/po4a/po/de.po +++ b/man/po4a/po/de.po @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: debhelper 12.9\n" "Report-Msgid-Bugs-To: debhelper@packages.debian.org\n" -"POT-Creation-Date: 2021-02-22 09:37+0100\n" +"POT-Creation-Date: 2022-11-20 19:46+0100\n" "PO-Revision-Date: 2020-02-07 19:21+0100\n" "Last-Translator: Erik Pfannenstein <debianignatz@gmx.de>\n" "Language-Team: German <debian-l10n-german@lists.debian.org>\n" @@ -18,10 +18,11 @@ msgstr "" "Plural-Forms: nplurals=2; plural=(n != 1);\n" #. type: =head1 -#: debhelper.pod:3 debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 -#: dh_auto_clean:3 dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 -#: dh_bugfiles:3 dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 -#: dh_gconf:3 dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 +#: debhelper.pod:3 debhelper-compat-upgrade-checklist.pod:3 +#: debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 dh_auto_clean:3 +#: dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 dh_bugfiles:3 +#: dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 +#: dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 #: dh_installchangelogs:3 dh_installcron:3 dh_installdeb:3 dh_installdebconf:3 #: dh_installdirs:3 dh_installdocs:5 dh_installemacsen:3 dh_installexamples:5 #: dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installinitramfs:3 @@ -41,19 +42,20 @@ msgid "debhelper - the debhelper tool suite" msgstr "debhelper - die Debhelper-Werkzeugsammlung" #. type: =head1 -#: debhelper.pod:7 debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 -#: dh_auto_clean:16 dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 -#: dh_bugfiles:15 dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 -#: dh_fixperms:16 dh_gconf:15 dh_gencontrol:16 dh_icons:16 dh_install:15 -#: dh_installcatalogs:17 dh_installchangelogs:15 dh_installcron:15 -#: dh_installdeb:15 dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 +#: debhelper.pod:7 debhelper-compat-upgrade-checklist.pod:7 +#: debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 dh_auto_clean:16 +#: dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 dh_bugfiles:15 +#: dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 dh_fixperms:16 +#: dh_gencontrol:16 dh_icons:16 dh_install:15 dh_installcatalogs:17 +#: dh_installchangelogs:16 dh_installcron:15 dh_installdeb:15 +#: dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 #: dh_installemacsen:15 dh_installexamples:17 dh_installifupdown:15 #: dh_installinfo:15 dh_installinit:16 dh_installinitramfs:15 #: dh_installlogcheck:15 dh_installlogrotate:15 dh_installman:16 #: dh_installmanpages:16 dh_installmenu:15 dh_installmime:15 #: dh_installmodules:16 dh_installpam:15 dh_installppp:15 dh_installudev:15 #: dh_installwm:15 dh_installxfonts:15 dh_link:16 dh_lintian:15 -#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:17 +#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:18 #: dh_prep:15 dh_shlibdeps:17 dh_strip:16 dh_testdir:15 dh_testroot:9 #: dh_usrlocal:19 dh_systemd_enable:16 dh_systemd_start:17 msgid "SYNOPSIS" @@ -69,19 +71,19 @@ msgstr "" "N>I<Paket>] [B<-P>I<temporäres_Verzeichnis>]" #. type: =head1 -#: debhelper.pod:11 dh:26 dh_auto_build:20 dh_auto_clean:20 -#: dh_auto_configure:20 dh_auto_install:22 dh_auto_test:20 dh_bugfiles:19 -#: dh_builddeb:21 dh_clean:19 dh_compress:21 dh_dwz:20 dh_fixperms:20 -#: dh_gconf:19 dh_gencontrol:20 dh_icons:20 dh_install:19 dh_installcatalogs:21 -#: dh_installchangelogs:19 dh_installcron:19 dh_installdeb:19 -#: dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 +#: debhelper.pod:11 debhelper-compat-upgrade-checklist.pod:17 dh:26 +#: dh_auto_build:20 dh_auto_clean:20 dh_auto_configure:20 dh_auto_install:22 +#: dh_auto_test:20 dh_bugfiles:19 dh_builddeb:21 dh_clean:19 dh_compress:21 +#: dh_dwz:20 dh_fixperms:20 dh_gencontrol:20 dh_icons:20 dh_install:19 +#: dh_installcatalogs:21 dh_installchangelogs:20 dh_installcron:19 +#: dh_installdeb:19 dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 #: dh_installemacsen:19 dh_installexamples:21 dh_installifupdown:19 #: dh_installinfo:19 dh_installinit:20 dh_installinitramfs:19 #: dh_installlogcheck:19 dh_installlogrotate:19 dh_installman:20 #: dh_installmanpages:20 dh_installmenu:19 dh_installmime:19 #: dh_installmodules:20 dh_installpam:19 dh_installppp:19 dh_installudev:19 #: dh_installwm:19 dh_installxfonts:19 dh_link:20 dh_lintian:19 -#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:21 +#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:22 #: dh_prep:19 dh_shlibdeps:21 dh_strip:20 dh_testdir:19 dh_testroot:13 #: dh_usrlocal:23 dh_systemd_enable:20 dh_systemd_start:21 msgid "DESCRIPTION" @@ -670,18 +672,31 @@ msgstr "B<-v>, B<--verbose>" #. type: textblock #: debhelper.pod:277 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." +msgid "Verbose mode: show commands that modify the package build directory." +msgstr "" +"Detailreicher Modus: zeigt alle Befehle, die das Paketbauverzeichnis ändern" + +#. type: textblock +#: debhelper.pod:279 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." msgid "" -"Verbose mode: show all commands that modify the package build directory." +"Note that verbose mode may also output other \"internal\" commands that do " +"not directly affect the package build directory." msgstr "" "Detailreicher Modus: zeigt alle Befehle, die das Paketbauverzeichnis ändern" #. type: =item -#: debhelper.pod:279 dh:266 +#: debhelper.pod:282 dh:307 msgid "B<--no-act>" msgstr "B<--no-act>" #. type: textblock -#: debhelper.pod:281 +#: debhelper.pod:284 msgid "" "Do not really do anything. If used with -v, the result is that the command " "will output what it would have done." @@ -690,12 +705,12 @@ msgstr "" "Ergebnis ausgegeben, was der Befehl getan hätte." #. type: =item -#: debhelper.pod:284 +#: debhelper.pod:287 msgid "B<-a>, B<--arch>" msgstr "B<-a>, B<--arch>" #. type: textblock -#: debhelper.pod:286 +#: debhelper.pod:289 msgid "" "Act on architecture dependent packages that should be built for the " "B<DEB_HOST_ARCH> architecture." @@ -704,22 +719,22 @@ msgstr "" "B<DEB_HOST_ARCH> gebaut werden sollen." #. type: =item -#: debhelper.pod:289 +#: debhelper.pod:292 msgid "B<-i>, B<--indep>" msgstr "B<-i>, B<--indep>" #. type: textblock -#: debhelper.pod:291 +#: debhelper.pod:294 msgid "Act on all architecture independent packages." msgstr "wirkt sich auf alle architektur-unabhängigen Pakete aus." #. type: =item -#: debhelper.pod:293 +#: debhelper.pod:296 msgid "B<-p>I<package>, B<--package=>I<package>" msgstr "B<-p>I<Paket>, B<--package=>I<Paket>" #. type: textblock -#: debhelper.pod:295 +#: debhelper.pod:298 msgid "" "Act on the package named I<package>. This option may be specified multiple " "times to make debhelper operate on a given set of packages." @@ -729,27 +744,27 @@ msgstr "" "arbeitet." #. type: =item -#: debhelper.pod:298 +#: debhelper.pod:301 msgid "B<-s>, B<--same-arch>" msgstr "B<-s>, B<--same-arch>" #. type: textblock -#: debhelper.pod:300 +#: debhelper.pod:303 msgid "Deprecated alias of B<-a>." msgstr "missbilligter Alias von B<-a>." #. type: textblock -#: debhelper.pod:302 dh_install:80 dh_install:89 +#: debhelper.pod:305 dh_install:80 dh_install:89 msgid "This option is removed in compat 12." msgstr "Die Option wurde in Kompatibilitätsstufe 12 entfernt." #. type: =item -#: debhelper.pod:304 +#: debhelper.pod:307 msgid "B<-N>I<package>, B<--no-package=>I<package>" msgstr "B<-N>I<Paket>, B<--no-package=>I<Paket>" #. type: textblock -#: debhelper.pod:306 +#: debhelper.pod:309 msgid "" "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option " "lists the package as one that should be acted on." @@ -758,12 +773,12 @@ msgstr "" "a>, B<-i> oder B<-p> das Paket als ein zu verarbeitendes auflisten." #. type: =item -#: debhelper.pod:309 +#: debhelper.pod:312 msgid "B<--remaining-packages>" msgstr "B<--remaining-packages>" #. type: textblock -#: debhelper.pod:311 +#: debhelper.pod:314 msgid "" "Do not act on the packages which have already been acted on by this " "debhelper command earlier (i.e. if the command is present in the package " @@ -779,12 +794,12 @@ msgstr "" "verarbeiten." #. type: =item -#: debhelper.pod:317 +#: debhelper.pod:320 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" msgstr "B<-P>I<temporäres_Verzeichnis>, B<--tmpdir=>I<temporäres_Verzeichnis>" #. type: textblock -#: debhelper.pod:319 +#: debhelper.pod:322 msgid "" "Use I<tmpdir> for package build directory. The default is debian/I<package>" msgstr "" @@ -792,12 +807,12 @@ msgstr "" "Voreinstellung ist debian/I<Paket>." #. type: =item -#: debhelper.pod:321 +#: debhelper.pod:324 msgid "B<--mainpackage=>I<package>" msgstr "B<--mainpackage=>I<Paket>" #. type: textblock -#: debhelper.pod:323 +#: debhelper.pod:326 msgid "" "This little-used option changes the package which debhelper considers the " "\"main package\", that is, the first one listed in F<debian/control>, and " @@ -810,12 +825,12 @@ msgstr "" "üblichen F<debian/Paket.foo>-Dateien verwandt werden können." #. type: =item -#: debhelper.pod:328 +#: debhelper.pod:331 msgid "B<-O=>I<option>|I<bundle>" msgstr "B<-O=>I<Option>|I<Bündel>" #. type: textblock -#: debhelper.pod:330 +#: debhelper.pod:333 msgid "" "This is used by L<dh(1)> when passing user-specified options to all the " "commands it runs. If the command supports the specified option or option " @@ -828,12 +843,12 @@ msgstr "" "zum Tragen. Falls nicht, wird er ignoriert." #. type: =head1 -#: debhelper.pod:337 +#: debhelper.pod:340 msgid "COMMON DEBHELPER OPTIONS" msgstr "HÄUFIGE DEBHELPER-OPTIONEN" #. type: textblock -#: debhelper.pod:339 +#: debhelper.pod:342 msgid "" "The following command line options are supported by some debhelper " "programs. See the man page of each program for a complete explanation of " @@ -844,24 +859,24 @@ msgstr "" "Handbuchseiten jedes einzelnen Programms." #. type: =item -#: debhelper.pod:345 +#: debhelper.pod:348 msgid "B<-n>" msgstr "B<-n>" #. type: textblock -#: debhelper.pod:347 +#: debhelper.pod:350 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts." msgstr "verändert keine F<postinst>-, F<postrm>- etc. Skripte" #. type: =item -#: debhelper.pod:349 dh_compress:56 dh_dwz:56 dh_installchangelogs:83 -#: dh_installdocs:109 dh_installexamples:80 dh_link:78 dh_makeshlibs:154 +#: debhelper.pod:352 dh_compress:56 dh_dwz:56 dh_installchangelogs:89 +#: dh_installdocs:109 dh_installexamples:84 dh_link:78 dh_makeshlibs:154 #: dh_md5sums:40 dh_shlibdeps:34 dh_strip:42 msgid "B<-X>I<item>, B<--exclude=>I<item>" msgstr "B<-X>I<Element>, B<--exclude=>I<Element>" #. type: textblock -#: debhelper.pod:351 +#: debhelper.pod:354 msgid "" "Exclude an item from processing. This option may be used multiple times, to " "exclude more than one thing. The I<item> is typically part of a filename, " @@ -873,14 +888,14 @@ msgstr "" "Text enthält, wird ausgeschlossen." #. type: =item -#: debhelper.pod:355 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 -#: dh_installdocs:104 dh_installexamples:48 dh_installinfo:45 dh_installman:90 +#: debhelper.pod:358 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 +#: dh_installdocs:104 dh_installexamples:52 dh_installinfo:45 dh_installman:90 #: dh_installwm:55 dh_link:73 msgid "B<-A>, B<--all>" msgstr "B<-A>, B<--all>" #. type: textblock -#: debhelper.pod:357 +#: debhelper.pod:360 msgid "" "Makes files or other items that are specified on the command line take " "effect in ALL packages acted on, not just the first." @@ -890,12 +905,12 @@ msgstr "" "im ersten." #. type: =head1 -#: debhelper.pod:362 +#: debhelper.pod:365 msgid "BUILD SYSTEM OPTIONS" msgstr "BAUSYSTEMOPTIONEN" #. type: textblock -#: debhelper.pod:364 +#: debhelper.pod:367 msgid "" "The following command line options are supported by all of the " "B<dh_auto_>I<*> debhelper programs. These programs support a variety of " @@ -913,12 +928,12 @@ msgstr "" "B<dh_auto_>I<*>-Programme übergibt." #. type: =item -#: debhelper.pod:373 +#: debhelper.pod:376 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>" msgstr "B<-S>I<Bausystem>, B<--buildsystem=>I<Bausystem>" #. type: textblock -#: debhelper.pod:375 +#: debhelper.pod:378 msgid "" "Force use of the specified I<buildsystem>, instead of trying to auto-select " "one which might be applicable for the package." @@ -927,14 +942,14 @@ msgstr "" "automatisch eins auszuwählen, das für das Paket geeignet sein könnte." #. type: textblock -#: debhelper.pod:378 +#: debhelper.pod:381 msgid "Pass B<none> as I<buildsystem> to disable auto-selection." msgstr "" "übergibt B<none> als I<Bausystem>, um automatisches Auswählen zu " "deaktivieren." #. type: =item -#: debhelper.pod:380 +#: debhelper.pod:383 msgid "" "B<-D>I<directory>, B<--sourcedir=>I<directory>, B<--" "sourcedirectory=>I<directory>" @@ -943,7 +958,7 @@ msgstr "" "sourcedirectory=>I<Verzeichnis>" #. type: textblock -#: debhelper.pod:382 +#: debhelper.pod:385 msgid "" "Assume that the original package source tree is at the specified " "I<directory> rather than the top level directory of the Debian source " @@ -954,7 +969,7 @@ msgstr "" "Debian-Quellpaketverzeichnisbaums liegt." #. type: textblock -#: debhelper.pod:386 +#: debhelper.pod:389 msgid "" "B<Warning>: The B<--sourcedir> variant matches a similar named option in " "B<dh_install> and B<dh_missing> (etc.) for historical reasons. While they " @@ -970,7 +985,7 @@ msgstr "" "Werkzeuge weitergibt)." #. type: =item -#: debhelper.pod:392 +#: debhelper.pod:395 msgid "" "B<-B>[I<directory>], B<--builddir>[I<=directory>], B<--" "builddirectory>[I<=directory>]" @@ -979,7 +994,7 @@ msgstr "" "builddirectory=>[I<Verzeichnis>]" #. type: textblock -#: debhelper.pod:394 +#: debhelper.pod:397 msgid "" "Enable out of source building and use the specified I<directory> as the " "build directory. If I<directory> parameter is omitted, a default build " @@ -990,7 +1005,7 @@ msgstr "" "weggelassen wurde, wird ein Vorgabebauverzeichnis ausgewählt." #. type: textblock -#: debhelper.pod:398 +#: debhelper.pod:401 msgid "" "If this option is not specified, building will be done in source by default " "unless the build system requires or prefers out of source tree building. In " @@ -1004,7 +1019,7 @@ msgstr "" "angegeben wurde." #. type: textblock -#: debhelper.pod:403 +#: debhelper.pod:406 msgid "" "If the build system prefers out of source tree building but still allows in " "source building, the latter can be re-enabled by passing a build directory " @@ -1016,12 +1031,12 @@ msgstr "" "dem Quellverzeichnispfad entspricht." #. type: =item -#: debhelper.pod:407 +#: debhelper.pod:410 msgid "B<--parallel>, B<--no-parallel>" msgstr "B<--parallel>, B<--no-parallel>" #. type: textblock -#: debhelper.pod:409 +#: debhelper.pod:412 msgid "" "Control whether parallel builds should be used if underlying build system " "supports them. The number of parallel jobs is controlled by the " @@ -1035,7 +1050,7 @@ msgstr "" "bausystemspezifischen Begrenzung sein." #. type: textblock -#: debhelper.pod:415 +#: debhelper.pod:418 msgid "" "If neither option is specified, debhelper currently defaults to B<--" "parallel> in compat 10 (or later) and B<--no-parallel> otherwise." @@ -1045,7 +1060,7 @@ msgstr "" "und andernfalls B<--no-parallel>." #. type: textblock -#: debhelper.pod:418 +#: debhelper.pod:421 msgid "" "As an optimization, B<dh> will try to avoid passing these options to " "subprocesses, if they are unnecessary and the only options passed. Notably " @@ -1059,12 +1074,12 @@ msgstr "" "ist)." #. type: =item -#: debhelper.pod:423 +#: debhelper.pod:426 msgid "B<--max-parallel=>I<maximum>" msgstr "B<--max-parallel=>I<Maximum>" #. type: textblock -#: debhelper.pod:425 +#: debhelper.pod:428 msgid "" "This option implies B<--parallel> and allows further limiting the number of " "jobs that can be used in a parallel build. If the package build is known to " @@ -1079,7 +1094,7 @@ msgstr "" "wünschen, dass sie unterstützt wird." #. type: textblock -#: debhelper.pod:430 +#: debhelper.pod:433 msgid "" "Notably, setting the maximum to 1 is effectively the same as using B<--no-" "parallel>." @@ -1088,23 +1103,28 @@ msgstr "" "von B<--no-parallel>." #. type: =item -#: debhelper.pod:433 +#: debhelper.pod:436 msgid "B<--reload-all-buildenv-variables>" msgstr "B<--reload-all-buildenv-variables>" #. type: textblock -#: debhelper.pod:435 +#: debhelper.pod:438 +#, fuzzy +#| msgid "" +#| "By default, L<dh(1)> will compute several environment (e.g. by using " +#| "L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> " +#| "tool recompute them." msgid "" -"By default, L<dh(1)> will compute several environment (e.g. by using L<dpkg-" -"buildflags(1)>) and cache them to avoid having all B<dh_auto_*> tool " -"recompute them." +"By default, L<dh(1)> will compute several environment variables (e.g. by " +"using L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> " +"tool recompute them." msgstr "" "Standardmäßig wird L<dh(1)> mehrere Umgebungen berechnen (z.B. mittels " "L<dpkg-buildflags(1)>) und sie zwischenspeichern, um zu verhindern, dass " "alle B<dh_auto_*>-Werkzeuge sie erneut berechnen." #. type: textblock -#: debhelper.pod:439 +#: debhelper.pod:442 msgid "" "When passing this option, the concrete B<dh_auto_*> tool will ignore the " "cache from L<dh(1)> and retrigger a rebuild of these variables. This is " @@ -1120,7 +1140,7 @@ msgstr "" "B<CFLAGS> beim zweiten Bauen abzuändern:" #. type: verbatim -#: debhelper.pod:446 +#: debhelper.pod:449 #, no-wrap msgid "" " export DEB_CFLAGS_MAINT_APPEND=-O3\n" @@ -1130,7 +1150,7 @@ msgstr "" "\n" #. type: verbatim -#: debhelper.pod:448 +#: debhelper.pod:451 #, no-wrap msgid "" " %:\n" @@ -1142,7 +1162,7 @@ msgstr "" "\n" #. type: verbatim -#: debhelper.pod:451 +#: debhelper.pod:454 #, no-wrap msgid "" " override_dh_auto_configure:\n" @@ -1158,7 +1178,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:456 +#: debhelper.pod:459 msgid "" "Without B<--reload-all-buildenv-variables> in the second call to " "L<dh_auto_configure(1)>, the change in B<DEB_CFLAGS_MAINT_APPEND> would be " @@ -1171,7 +1191,7 @@ msgstr "" "zwischengespeicherten B<CFLAGS>-Wert benutzen würde." #. type: textblock -#: debhelper.pod:461 +#: debhelper.pod:464 msgid "" "This option is only available with B<< debhelper (>= 12.7~) >> when the " "package uses compatibility level 9 or later." @@ -1180,12 +1200,12 @@ msgstr "" "Paket Kompatibilitätsstufe 9 oder neuer verwendet." #. type: =item -#: debhelper.pod:464 dh:258 +#: debhelper.pod:467 dh:299 msgid "B<--list>, B<-l>" msgstr "B<--list>, B<-l>" #. type: textblock -#: debhelper.pod:466 +#: debhelper.pod:469 msgid "" "List all build systems supported by debhelper on this system. The list " "includes both default and third party build systems (marked as such). Also " @@ -1199,12 +1219,12 @@ msgstr "" "buildsystem> manuell angegeben wird." #. type: =head1 -#: debhelper.pod:473 +#: debhelper.pod:476 msgid "COMPATIBILITY LEVELS" msgstr "KOMPATIBILITÄTSSTUFEN" #. type: textblock -#: debhelper.pod:475 +#: debhelper.pod:478 msgid "" "From time to time, major non-backwards-compatible changes need to be made to " "debhelper, to keep it clean and well-designed as needs change and its author " @@ -1223,7 +1243,7 @@ msgstr "" "verschiedene Arten." #. type: textblock -#: debhelper.pod:482 +#: debhelper.pod:485 msgid "" "In current debhelper, you can specify the compatibility level in F<debian/" "control> by adding a Build-Depends on the debhelper-compat package. For " @@ -1235,7 +1255,7 @@ msgstr "" "stellen Sie sicher, dass F<debian/control> Folgendes enthält:" #. type: verbatim -#: debhelper.pod:486 +#: debhelper.pod:489 #, no-wrap msgid "" " Build-Depends: debhelper-compat (= #RECOMMENDED_COMPAT#)\n" @@ -1245,7 +1265,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:488 +#: debhelper.pod:491 msgid "" "This also serves as an appropriate versioned build dependency on a " "sufficient version of the debhelper package, so you do not need to specify a " @@ -1261,11 +1281,17 @@ msgstr "" "Fehlerbehebung innerhalb einer Kompatibilitätsstufe)." #. type: textblock -#: debhelper.pod:494 +#: debhelper.pod:497 +#, fuzzy +#| msgid "" +#| "Note that debhelper does not provide debhelper-compat for experimental or " +#| "beta compatibility levels; packages experimenting with those " +#| "compatibility levels should use F<debian/compat> or B<DH_COMPAT>." msgid "" "Note that debhelper does not provide debhelper-compat for experimental or " "beta compatibility levels; packages experimenting with those compatibility " -"levels should use F<debian/compat> or B<DH_COMPAT>." +"levels should use F<debian/compat> (or, if only for selected commands, " +"B<DH_COMPAT>)." msgstr "" "Beachten Sie, dass Debhelper Debhelper-Compat nicht für experimentelle oder " "Beta-Kompatibilitätsstufen bereitstellt. Pakete, die mit diesen " @@ -1273,18 +1299,30 @@ msgstr "" "B<DH_COMPAT> verwenden." #. type: textblock -#: debhelper.pod:498 +#: debhelper.pod:501 +#, fuzzy +#| msgid "" +#| "Prior versions of debhelper required specifying the compatibility level " +#| "in the file F<debian/compat>, and current debhelper still supports this " +#| "for backward compatibility, though a package may not specify a " +#| "compatibility level via multiple methods at once. To use this method, " +#| "F<debian/compat> should contain the compatibility level as a single " +#| "number, and no other content. If you specify the compatibility level by " +#| "this method, your package will also need a versioned build dependency on " +#| "a version of the debhelper package equal to (or greater than) the " +#| "compatibility level your package uses. So, if you specify compatibility " +#| "level #RECOMMENDED_COMPAT# in F<debian/compat>, ensure F<debian/control> " +#| "has:" msgid "" "Prior versions of debhelper required specifying the compatibility level in " "the file F<debian/compat>, and current debhelper still supports this for " -"backward compatibility, though a package may not specify a compatibility " -"level via multiple methods at once. To use this method, F<debian/compat> " -"should contain the compatibility level as a single number, and no other " -"content. If you specify the compatibility level by this method, your package " -"will also need a versioned build dependency on a version of the debhelper " -"package equal to (or greater than) the compatibility level your package " -"uses. So, if you specify compatibility level #RECOMMENDED_COMPAT# in " -"F<debian/compat>, ensure F<debian/control> has:" +"backward compatibility. To use this method, the F<debian/compat> file should " +"contain the compatibility level as a single number, and no other content. If " +"you specify the compatibility level by this method, your package will also " +"need a versioned build dependency on a version of the debhelper package " +"equal to (or greater than) the compatibility level your package uses. So, if " +"you specify compatibility level #RECOMMENDED_COMPAT# in F<debian/compat>, " +"ensure F<debian/control> has:" msgstr "" "Frühere Versionen von Debhelper benötigten die Angabe der " "Kompatibilitätsstufe in der Datei F<debian/compat>. Das aktuelle Debhelper " @@ -1299,7 +1337,7 @@ msgstr "" "angeben, sicherstellen, dass F<debian/control> Folgendes enthält:" #. type: verbatim -#: debhelper.pod:509 +#: debhelper.pod:511 #, no-wrap msgid "" " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#~)\n" @@ -1309,7 +1347,27 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:511 +#: debhelper.pod:513 +msgid "" +"Note that you must use either the build-dependency on debhelper-compat or " +"the F<debian/compat> file. Whenever possible, the debhelper-compat build-" +"dependency is recommended." +msgstr "" + +#. type: textblock +#: debhelper.pod:517 +msgid "" +"If needed be, the B<DH_COMPAT> environment variable can be used to override " +"the compat level for a given command. The feature is mostly useful for " +"either temporarily upgrading a few commands to a new compat level or keeping " +"a few commands on a lower compat level. The feature is best used sparingly " +"as it effectively introduces special-cases into the F<debian/rules> file " +"that may be surprising to maintainers or reviewers (or, in the long term, to " +"yourself)." +msgstr "" + +#. type: textblock +#: debhelper.pod:525 msgid "" "Unless otherwise indicated, all debhelper documentation assumes that you are " "using the most recent compatibility level, and in most cases does not " @@ -1326,1175 +1384,1409 @@ msgstr "" "lesen." #. type: =head2 -#: debhelper.pod:518 +#: debhelper.pod:532 msgid "Supported compatibility levels" msgstr "Unterstützte Kompatibilitätsstufen" #. type: textblock -#: debhelper.pod:520 -msgid "These are the available compatibility levels:" -msgstr "Folgende Kompatibilitätsstufen sind verfügbar:" - -#. type: =item -#: debhelper.pod:524 debhelper-obsolete-compat.pod:89 -msgid "v5" -msgstr "v5" - -#. type: textblock -#: debhelper.pod:526 debhelper-obsolete-compat.pod:91 -msgid "This is the lowest supported compatibility level." -msgstr "Dies ist die unterste unterstützte Kompatibilitätsstufe." - -#. type: textblock -#: debhelper.pod:528 +#: debhelper.pod:534 msgid "" -"If you are upgrading from an earlier compatibility level, please review " -"L<debhelper-obsolete-compat(7)>." +"The list of supported compatibility levels and the related upgrade check " +"list has moved to L<debhelper-compat-upgrade-checklist(7)>." msgstr "" -"Falls Sie ein Upgrade von einer vorhergehenden Kompatibilitätsstufe " -"durchführen, überprüfen Sie bitte L<debhelper-obsolete-compat(7)>." - -#. type: textblock -#: debhelper.pod:531 debhelper.pod:563 debhelper.pod:593 debhelper.pod:624 -#: debhelper.pod:685 debhelper-obsolete-compat.pod:28 -#: debhelper-obsolete-compat.pod:35 debhelper-obsolete-compat.pod:58 -#: debhelper-obsolete-compat.pod:87 -msgid "This mode is deprecated." -msgstr "Dieser Modus ist missbilligt." - -#. type: =item -#: debhelper.pod:533 -msgid "v6" -msgstr "v6" -#. type: textblock -#: debhelper.pod:535 -msgid "Changes from v5 are:" -msgstr "Änderungen gegenüber v5 sind:" +#. type: =head1 +#: debhelper.pod:537 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 +#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:96 +#: dh_installinit:204 dh_installinitramfs:60 dh_installman:131 +#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 +#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:103 +#: dh_systemd_start:68 +msgid "NOTES" +msgstr "ANMERKUNGEN" -#. type: =item -#: debhelper.pod:539 debhelper.pod:544 debhelper.pod:550 debhelper.pod:556 -#: debhelper.pod:571 debhelper.pod:578 debhelper.pod:582 debhelper.pod:586 -#: debhelper.pod:601 debhelper.pod:605 debhelper.pod:613 debhelper.pod:618 -#: debhelper.pod:632 debhelper.pod:637 debhelper.pod:644 debhelper.pod:649 -#: debhelper.pod:654 debhelper.pod:662 debhelper.pod:668 debhelper.pod:673 -#: debhelper.pod:678 debhelper.pod:693 debhelper.pod:698 debhelper.pod:704 -#: debhelper.pod:710 debhelper.pod:715 debhelper.pod:721 debhelper.pod:730 -#: debhelper.pod:740 debhelper.pod:746 debhelper.pod:769 debhelper.pod:776 -#: debhelper.pod:782 debhelper.pod:788 debhelper.pod:794 debhelper.pod:823 -#: debhelper.pod:829 debhelper.pod:841 debhelper.pod:849 debhelper.pod:855 -#: debhelper.pod:860 debhelper.pod:865 debhelper.pod:870 debhelper.pod:878 -#: debhelper.pod:888 debhelper.pod:898 debhelper.pod:905 debhelper.pod:917 -#: debhelper.pod:922 debhelper.pod:950 debhelper.pod:967 debhelper.pod:977 -#: debhelper.pod:981 debhelper.pod:986 debhelper.pod:991 debhelper.pod:998 -#: debhelper.pod:1004 debhelper.pod:1012 debhelper.pod:1018 debhelper.pod:1022 -#: debhelper.pod:1027 debhelper.pod:1032 debhelper.pod:1041 debhelper.pod:1057 -#: debhelper.pod:1064 debhelper.pod:1080 debhelper.pod:1088 debhelper.pod:1093 -#: debhelper.pod:1108 debhelper.pod:1116 debhelper.pod:1124 debhelper.pod:1133 -#: debhelper.pod:1139 debhelper.pod:1149 debhelper.pod:1157 debhelper.pod:1163 -#: debhelper.pod:1177 debhelper.pod:1188 debhelper.pod:1202 debhelper.pod:1213 -#: debhelper.pod:1231 debhelper.pod:1245 debhelper-obsolete-compat.pod:43 -#: debhelper-obsolete-compat.pod:48 debhelper-obsolete-compat.pod:52 -#: debhelper-obsolete-compat.pod:66 debhelper-obsolete-compat.pod:71 -#: debhelper-obsolete-compat.pod:76 debhelper-obsolete-compat.pod:81 -#: debhelper-obsolete-compat.pod:97 debhelper-obsolete-compat.pod:101 -#: debhelper-obsolete-compat.pod:106 debhelper-obsolete-compat.pod:110 -#: dh_testroot:36 dh_testroot:41 dh_testroot:46 -msgid "-" -msgstr "-" +#. type: =head2 +#: debhelper.pod:539 +msgid "Multiple binary package support" +msgstr "Unterstützung mehrerer Binärpakete" #. type: textblock #: debhelper.pod:541 msgid "" -"Commands that generate maintainer script fragments will order the fragments " -"in reverse order for the F<prerm> and F<postrm> scripts." +"If your source package generates more than one binary package, debhelper " +"programs will default to acting on all binary packages when run. If your " +"source package happens to generate one architecture dependent package, and " +"another architecture independent package, this is not the correct behavior, " +"because you need to generate the architecture dependent packages in the " +"binary-arch F<debian/rules> target, and the architecture independent " +"packages in the binary-indep F<debian/rules> target." msgstr "" -"Befehle, die Fragmente von Betreuerskripten erzeugen, werden die Fragmente " -"für die F<prerm>- und F<postrm>-Skripte in umgekehrter Reiherfolge anordnen." +"Falls Ihr Quellpaket mehr als ein Binärpaket erzeugt, werden die Debhelper-" +"Programme standardmäßig auf alle Paketen einwirken. Falls es vorkommt, dass " +"Ihr Quellpaket ein architekturabhängiges Paket und ein anderes " +"architekturunabhängiges Paket erzeugt, ist dies nicht das korrekte " +"Verhalten, da Sie die architekturabhängigen Pakete im F<debian/rules>-Ziel " +"»binary-arch« erzeugen müssen und die unabhängigen Pakete im F<debian/rules>-" +"Ziel »binary-indep«." #. type: textblock -#: debhelper.pod:546 +#: debhelper.pod:549 msgid "" -"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." -"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " -"directory." +"To facilitate this, as well as give you more control over which packages are " +"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" +"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " +"are given, debhelper programs default to acting on all packages listed in " +"the control file, with the exceptions below." msgstr "" -"B<dh_installwm> wird einen untergeordneten Handbuchseiten-Link für F<x-" -"window-manager.1.gz> installieren. falls es die Handbuchseite in F<usr/share/" -"man/man1> im Bauverzeichnis des Pakets entdeckt." +"Um dies zu erleichtern sowie Ihnen mehr Kontrolle darüber zu geben, auf " +"welche Pakete Debhelper-Programme einwirken, akzeptieren alle Debhelper-" +"Programme die Parameter B<-a>, B<-i>, B<-p> und B<-s>. Diese Parameter sind " +"kumulativ. Falls keiner angegeben wurde, wirken Debhelper-Programme " +"standardmäßig auf alle Paketen ein, die in der Datei »control« aufgeführt " +"sind, mit nachfolgenden Ausnahmen." #. type: textblock -#: debhelper.pod:552 +#: debhelper.pod:555 msgid "" -"B<dh_builddeb> did not previously delete everything matching " -"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " -"B<CVS:.svn:.git>. Now it does." +"First, any package whose B<Architecture> field in B<debian/control> does not " +"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " +"section 5.6.8>)." msgstr "" -"Wenn ihm eine Liste mit Dingen zum Ausschließen, so wie B<CVS:.svn:.git>, " -"mitgegeben wurde, hat B<dh_builddeb> nicht alles gelöscht, was auf " -"B<DH_ALWAYS_EXCLUDE> passte. Jetzt schon." +"Zuerst werden alle Pakete, deren B<Architecture>-Feld in B<debian/control> " +"nicht mit der B<DEB_HOST_ARCH>-Architektur übereinstimmt, ausgeschlossen " +"(L<Debian Policy, Abschnitt 5.6.8>)." #. type: textblock -#: debhelper.pod:558 +#: debhelper.pod:559 msgid "" -"B<dh_installman> allows overwriting existing man pages in the package build " -"directory. In previous compatibility levels it silently refuses to do this." +"Also, some additional packages may be excluded based on the contents of the " +"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " +"binary package stanzas in B<debian/control>, according to the draft policy " +"at L<https://wiki.debian.org/BuildProfileSpec>." msgstr "" -"B<dh_installman> erlaubt das Ãœberschreiben existierender Handbuchseiten im " -"Bauverzeichnis des Pakets. In vorhergehenden Kompatibilitätsstufen weigert " -"es sich kommentarlos." - -#. type: =item -#: debhelper.pod:565 -msgid "v7" -msgstr "v7" +"Außerdem können einige zusätzliche Paket basierend auf dem Inhalt der " +"Umgebungsvariable B<DEB_BUILD_PROFILES> und den Feldern B<Build-Profiles> in " +"den Absätzen für binäre Pakete in B<debian/control> ausgeschlossen werden. " +"Dies geschieht gemäß der Entwurfrichtlinie unter L<https://wiki.debian.org/" +"BuildProfileSpec>." -#. type: textblock -#: debhelper.pod:567 -msgid "Changes from v6 are:" -msgstr "Änderungen gegenüber v6 sind:" +#. type: =head3 +#: debhelper.pod:564 +msgid "Interaction between package selections and Build-Profiles" +msgstr "Zusammenspiel zwischen Paketauswahl und Bauprofilen" #. type: textblock -#: debhelper.pod:573 +#: debhelper.pod:566 msgid "" -"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " -"doesn't find them in the current directory (or wherever you tell it look " -"using B<--sourcedir>). This allows B<dh_install> to interoperate with " -"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " -"special parameters." +"Build-Profiles affect which packages are included in the package selections " +"mechanisms in debhelper. Generally, the package selections are described " +"from the assumption that all packages are enabled. This section describes " +"how the selections react when a package is disabled due to the active Build-" +"Profiles (or lack of active Build-Profiles)." msgstr "" -"Falls B<dh_install> keine Dateien im derzeitigen (oder dem via B<--" -"sourcedir> mitgegebenen) Verzeichnis findet, sucht es sie ersatzweise in " -"F<debian/tmp>. Das ermöglicht es ihm, ohne dass es bsondere Parameter " -"benötigt, mit B<dh_auto_install> zusammenzuarbeiten, welches nach F<debian/" -"tmp> installiert." +"Bauprofile beeinflussen, welche Pakete im Paketauswahlmechanismus von " +"Debhelper enthalten sind. Im Allgemeinen wird die Paketauswahl unter der " +"Annahme beschrieben, dass alle Pakete aktiviert sind. Dieser Abschnitt " +"beschreibt, wie die Auswahl reagiert, wenn ein Paket aufgrund des aktiven " +"Bauprofils (oder das Fehlen des aktiven Bauprofils) deaktiviert wird." -#. type: textblock -#: debhelper.pod:580 -msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +#. type: =item +#: debhelper.pod:574 +msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" msgstr "" -"B<dh_clean> wird F<debian/clean> lesen und die dort aufgeführten Dateien " -"löschen." +"-a/--arch, -i/--indep ODER keine Auswahloptionen (ein roher »dh_X«-Aufruf)" #. type: textblock -#: debhelper.pod:584 -msgid "B<dh_clean> will delete toplevel F<*-stamp> files." -msgstr "<dh_clean> wird die F<*-stamp>-Dateien der obersten Ebene löschen." +#: debhelper.pod:576 +msgid "" +"The package disabled by Build-Profiles is silently excluded from the " +"selection." +msgstr "" +"Das durch Bauprofile deaktivierte Paket wird stillschweigend aus der Auswahl " +"ausgeschlossen." #. type: textblock -#: debhelper.pod:588 +#: debhelper.pod:579 msgid "" -"B<dh_installchangelogs> will guess at what file is the upstream changelog if " -"none is specified." +"Note you will receive a warning if I<all> packages related to these " +"selections are disabled. In that case, it generally does not make sense to " +"do the build in the first place." msgstr "" -"B<dh_installchangelogs> wird abschätzen, in welcher Datei das Changelog der " -"Originalautoren liegt, falls keines angegeben wurde." +"Beachten Sie, dass Sie eine Warnung bekommen, falls I<alle> zu dieser " +"Auswahl gehörenden Pakete deaktiviert werden. In diesem Fall ist der Bau im " +"Allgemeinen überhaupt sinnlos." #. type: =item -#: debhelper.pod:595 -msgid "v8" -msgstr "v8" +#: debhelper.pod:583 +msgid "-N I<package> / --no-package I<package>" +msgstr "-N I<Paket> / --no-package I<Paket>" #. type: textblock -#: debhelper.pod:597 -msgid "Changes from v7 are:" -msgstr "Änderungen gegenüber v7 sind:" +#: debhelper.pod:585 +msgid "The option is accepted and effectively does nothing." +msgstr "Die Option wird akzeptiert und hat keine Wirkung." + +#. type: =item +#: debhelper.pod:587 +msgid "-p I<package> / --package I<package>" +msgstr "-p I<Paket> / --package I<Paket>" #. type: textblock -#: debhelper.pod:603 -msgid "" -"Commands will fail rather than warning when they are passed unknown options." +#: debhelper.pod:589 +msgid "The option is accepted, but debhelper will not act on the package." msgstr "" -"Befehle werden fehlschlagen anstatt zu warnen, wenn ihnen unbekannte " -"Optionen übergeben werden." +"Die Option wird akzeptiert, aber Debhelper wird nichts an dem Paket ändern." #. type: textblock -#: debhelper.pod:607 +#: debhelper.pod:593 msgid "" -"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " -"generates shlibs files for. So B<-X> can be used to exclude libraries. " -"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " -"processed before will be passed to it, a behavior change that can cause some " -"packages to fail to build." +"Note that it does not matter whether a package is enabled or disabled by " +"default." msgstr "" -"B<dh_makeshlibs> führt B<dpkg-gensymbols> auf allen gemeinsamen Bibliotheken " -"aus, für die es Shlib-Dateien generiert, wobei Bibliotheken mit B<-X> " -"ausgeschlossen werden können. Außerdem werden B<dpkg-gensymbols> " -"Bibliotheken an unüblichen Orten übergeben, ohne dass es diese vorher " -"verarbeitet haben wird, was dazu führen kann, dass sich einige Pakete nicht " -"bauen lassen." +"Beachten Sie, dass es keine Rolle spielt, ob das Paket standardmäßig " +"aktiviert oder deaktiviert ist." + +#. type: =head2 +#: debhelper.pod:596 +msgid "Automatic generation of Debian install scripts" +msgstr "Automatisches Erzeugen von Debian-Installationsskripten" #. type: textblock -#: debhelper.pod:615 +#: debhelper.pod:598 msgid "" -"B<dh> requires the sequence to run be specified as the first parameter, and " -"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo $@>" -"\"." +"Some debhelper commands will automatically generate parts of Debian " +"maintainer scripts. If you want these automatically generated things " +"included in your existing Debian maintainer scripts, then you need to add " +"B<#DEBHELPER#> to your scripts, in the place the code should be added. " +"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " +"B<dh_installdeb>." msgstr "" -"B<dh> erfordert, dass die auszuführende Sequenz als erster Parameter " -"angegeben wird und sämtliche Schalter danach kommen. Das heißt, Sie " -"schreiben nicht »B<dh --foo $@>«, sondern »B<dh $@ --foo>«." +"Einige Debhelper-Befehle werden automatisch Teile der Debian-Betreuerskripte " +"erzeugen. Falls Sie diese automatisch erzeugten Dinge in Ihre existierenden " +"Debian-Betreuerskripte einfügen möchten, dann müssen Sie Ihren Skripten " +"B<#DEBHELPER#> an der Stelle platzieren, an die der Kode hinzugefügt werden " +"soll. B<#DEBHELPER#> wird bei der Ausführung durch beliebigen automatisch " +"erzeugten Kode ersetzt, wenn Sie B<dh_installdeb> ausführen." #. type: textblock -#: debhelper.pod:620 +#: debhelper.pod:605 msgid "" -"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " -"F<Makefile.PL>." +"If a script does not exist at all and debhelper needs to add something to " +"it, then debhelper will create the complete script." msgstr "" -"B<dh_auto_>I<*> bevorzugt Perls B<Module::Build> gegenüber F<Makefile.PL>." +"Falls ein Skript noch gar nicht existiert und Debhelper etwas darin " +"hinzufügen muss, dann wird Debhelper das komplette Skript erstellen." -#. type: =item -#: debhelper.pod:626 -msgid "v9" -msgstr "v9" +#. type: textblock +#: debhelper.pod:608 +msgid "" +"All debhelper commands that automatically generate code in this way let it " +"be disabled by the -n parameter (see above)." +msgstr "" +"Alle Debhelper-Befehle, die auf diese Art automatisch Kode erzeugen, lassen " +"ihn durch den Parameter -n deaktiviert (siehe oben)." #. type: textblock -#: debhelper.pod:628 -msgid "Changes from v8 are:" -msgstr "Änderungen gegenüber v8 sind:" +#: debhelper.pod:611 +msgid "" +"Note that the inserted code will be shell code, so you cannot directly use " +"it in a Perl script. If you would like to embed it into a Perl script, here " +"is one way to do that (note that I made sure that $1, $2, etc are set with " +"the set command):" +msgstr "" +"Beachten Sie, dass der eingefügte Kode Shell-Kode sein wird. Sie können ihn " +"daher nicht direkt in einem Perl-Skript verwenden. Falls Sie ihn in ein Perl-" +"Skript einbetten wollen, wird hier eine Möglichkeit dafür beschrieben " +"(beachten Sie, dass über den Befehl »set« sichergestellt wird, dass $1, $2, " +"etc. gesetzt sind):" + +#. type: verbatim +#: debhelper.pod:616 +#, no-wrap +msgid "" +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"The debhelper script failed with error code: ${exit_code}\");\n" +" } else {\n" +" die(\"The debhelper script was killed by signal: ${signal}\");\n" +" }\n" +" }\n" +"\n" +msgstr "" +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"Das Debhelper-Skript scheiterte mit folgendem Fehlercode: ${exit_code}\");\n" +" } else {\n" +" die(\"Das Debhelper-Skript wurde per Signal abgebrochen: ${signal}\");\n" +" }\n" +" }\n" +"\n" + +#. type: =head2 +#: debhelper.pod:629 +msgid "Automatic generation of miscellaneous dependencies." +msgstr "Automatisches Erzeugen verschiedener Abhängigkeiten" #. type: textblock -#: debhelper.pod:634 +#: debhelper.pod:631 msgid "" -"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " -"directories to autoconf in --libdir and --libexecdir." +"Some debhelper commands may make the generated package need to depend on " +"some other packages. For example, if you use L<dh_installdebconf(1)>, your " +"package will generally need to depend on debconf. Or if you use " +"L<dh_installxfonts(1)>, your package will generally need to depend on a " +"particular version of xutils. Keeping track of these miscellaneous " +"dependencies can be annoying since they are dependent on how debhelper does " +"things, so debhelper offers a way to automate it." msgstr "" -"Multiarch-Unterstützung. Insbesondere gibt B<dh_auto_configure> Multiarch-" -"Verzeichnisse an Autoconf in --libdir and --libexecdir weiter." +"Einige Debhelper-Befehle könnten dazu führen, dass das erzeugte Paket von " +"einigen anderen Paketen abhängt. Falls Sie beispielsweise " +"L<dh_installdebconf(1)> benutzen, wird Ihr Paket von Debconf abhängen " +"müssen. Oder, falls Sie L<dh_installxfonts(1)> verwenden, wird ihr Paket " +"generell von einer bestimmten Version der Xutils abhängen. Den Ãœberblick " +"über diese verschiedenen Abhängigkeiten zu behalten kann lästig sein, da sie " +"von Debhelpers Arbeitsweise abhängen, weswegen Debhelper eine Möglichkeit " +"bietet, sie zu automatisieren." #. type: textblock #: debhelper.pod:639 msgid "" -"dh is aware of the usual dependencies between targets in debian/rules. So, " -"\"dh binary\" will run any build, build-arch, build-indep, install, etc " -"targets that exist in the rules file. There's no need to define an explicit " -"binary target with explicit dependencies on the other targets." +"All commands of this type, besides documenting what dependencies may be " +"needed on their man pages, will automatically generate a substvar called " +"B<${misc:Depends}>. If you put that token into your F<debian/control> file, " +"it will be expanded to the dependencies debhelper figures you need." msgstr "" -"dh kennt die üblichen Abhängigkeiten zwischen den Zielen in debian/rules. " -"Daher wird »dh binary« alle »build«-, »build-arch«-, »build-indep«-, " -"»install«-Ziele etc. ausführen, die in der Regeldatei stehen. Es ist nicht " -"nötig, explizit ein binäres Ziel mit expliziten Abhängigkeiten zu den " -"anderen Zielen zu definieren." +"Für jeden Befehl werden die benötigten Abhängigkeiten in den Handbuchseiten " +"dokumentiert. Daneben wird automatisch eine »substvar« erzeugt, die B<${misc:" +"Depends}> genannt wird. Falls Sie eine Markierung in Ihre F<debian/control>-" +"Datei schreiben, wird es sie zu den Abhängigkeiten expandieren, von denen " +"Debhelper findet, dass Sie sie benötigen." #. type: textblock -#: debhelper.pod:646 +#: debhelper.pod:644 msgid "" -"B<dh_strip> compresses debugging symbol files to reduce the installed size " -"of -dbg packages." +"This is entirely independent of the standard B<${shlibs:Depends}> generated " +"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " +"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " +"guesses don't match reality." msgstr "" -"B<dh_strip> komprimiert Debug-Symboldateien, um die Größe der installierten " -"»-dbg«-Paketen zu verringern." +"Dies ist gänzlich unabhängig von dem vorgegebenen B<${shlibs:Depends}>, das " +"durch L<dh_makeshlibs(1)> erzeugt wurde, und den durch L<dh_perl(1)> " +"erzeugten B<${perl:Depends}>. Sie können sich entscheiden, keines davon " +"benutzen, falls die Einschätzung von Debhelper nicht der Wirklichkeit " +"entspricht." + +#. type: =head2 +#: debhelper.pod:649 +msgid "Package build directories" +msgstr "Paketbauverzeichnisse" #. type: textblock #: debhelper.pod:651 msgid "" -"B<dh_auto_configure> does not include the source package name in --" -"libexecdir when using autoconf." +"By default, all debhelper programs assume that the temporary directory used " +"for assembling the tree of files in a package is debian/I<package>." msgstr "" -"B<dh_auto_configure> enthält keinen Quellpaketnamen in --libexecdir, wenn " -"Autoconf benutzt wird." - -#. type: textblock -#: debhelper.pod:656 -msgid "B<dh> does not default to enabling --with=python-support" -msgstr "Standardmäßig aktiviert B<dh> nicht --with=python-support." +"Standardmäßig gehen alle Debhelper-Programme davon aus, dass das temporäre " +"Verzeichnis, das zum Zusammenbau des Dateibaums in einem Paket benutzt wird, " +"debian/I<Paket> ist." #. type: textblock -#: debhelper.pod:658 +#: debhelper.pod:654 msgid "" -"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " -"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " -"regardless of compat level)" +"Sometimes, you might want to use some other temporary directory. This is " +"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/" +"tmp>\", will use B<debian/tmp> as the temporary directory. Note that if you " +"use B<-P>, the debhelper programs can only be acting on a single package at " +"a time. So if you have a package that builds many binary packages, you will " +"need to also use the B<-p> flag to specify which binary package the " +"debhelper program will act on." msgstr "" -"(Hinfällig, da das Werkzeug B<dh_pysupport> aus Debian Stretch entfernt " -"wurde. Seit Debhelper/10.3 aktiviert B<dh> diese Sequenzerweiterung " -"unabhängig von der Kompatibilitätsstufe nicht mehr.)" +"Manchmal wollen Sie möglicherweise ein anderes temporäres Vezeichnis " +"benutzen. Dies wird durch den Schalters B<-P> unterstützt. »B<dh_installdocs " +"-Pdebian/tmp>« wird zum Beispiel B<debian/tmp> als temporäres Verzeichnis " +"nutzen. Beachten Sie, dass die Debhelper-Programme nur auf ein einzelnes " +"Paket auf einmal einwirken können, wenn Sie B<-P> verwenden. Falls Sie ein " +"Paket haben, das mehrere Binärpakete baut, müssen Sie zusätzlich den " +"Schalter B<-p> einsetzen, um anzugeben, auf welches Binärpaket sich das " +"Debhelper-Programm auswirkt." + +#. type: =head2 +#: debhelper.pod:662 +msgid "udebs" +msgstr "Udebs" #. type: textblock #: debhelper.pod:664 msgid "" -"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " -"variables listed by B<dpkg-buildflags>, unless they are already set." +"Debhelper includes support for udebs. To create a udeb with debhelper, add " +"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " +"Debhelper will try to create udebs that comply with debian-installer policy, " +"by making the generated package files end in F<.udeb>, not installing any " +"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " +"and F<config> scripts, etc." msgstr "" -"Alle B<dh_auto_>I<*>-Debhelper-Programme und B<dh> setzen " -"Umgebungsvariablen, die durch B<dpkg-buildflags> aufgelistet werden, sofern " -"sie nicht bereits gesetzt sind." +"Debhelper beinhaltet Unterstützung für Udebs. Um ein Udeb mit Debhelper zu " +"erstellen, fügen Sie dem Absatz des Pakets in F<debian/control> »B<Package-" +"Type: udeb>« hinzu. Debhelper wird versuchen, Udebs zu erstellen, die der " +"Debian-Installer-Richtlinie entsprechen, indem die erzeugten Paketdateien " +"mit F<.udeb> enden, keine Dokumentation in ein Udeb installiert wird und " +"F<preinst>-, F<postrm>-, F<prerm>- sowie F<config>-Skripte etc. übersprungen " +"werden." + +#. type: =head1 +#: debhelper.pod:671 +msgid "ENVIRONMENT" +msgstr "UMGEBUNGSVARIABLEN" #. type: textblock -#: debhelper.pod:670 +#: debhelper.pod:673 msgid "" -"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " -"to perl F<Makefile.PL> and F<Build.PL>" +"This section describes some of the environment variables that influences the " +"behaviour of debhelper or which debhelper interacts with." msgstr "" -"B<dh_auto_configure> übergibt CFLAGS, CPPFLAGS und LDFLAGS von B<dpkg-" -"buildflags> an Perls F<Makefile.PL> und F<Build.PL.>" +"Dieser Abschnitt beschreibt einige der Umgebungsvariablen, die das Verhalten " +"von Debhelper beeinflussen oder mit denen Debhelper interagiert." #. type: textblock -#: debhelper.pod:675 +#: debhelper.pod:676 msgid "" -"B<dh_strip> puts separated debug symbols in a location based on their build-" -"id." +"It is important to note that these must be actual environment variables in " +"order to affect the behaviour of debhelper (not simply F<Makefile> " +"variables). To specify them properly in F<debian/rules>, be sure to " +"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." msgstr "" -"B<dh_strip> legt getrennte Fehlersuchsymbole an einer Stelle ab, die auf " -"ihrer Baukennzahl basiert." +"Es ist wichtig, darauf hinzuweisen, dass es echte Umgebungsvariablen (nicht " +"nur einfache F<Makefile>-Variablen) sein müssen, damit dies korrekt " +"funktioniert. Um sie ordnungsgemäß in F<debian/rules> anzugeben, müssen Sie " +"sicherstellen, dass sie »B<export>«iert werden, zum Beispiel »B<export " +"DH_VERBOSE>«." + +#. type: =item +#: debhelper.pod:683 +msgid "B<DH_VERBOSE>" +msgstr "B<DH_VERBOSE>" #. type: textblock -#: debhelper.pod:680 +#: debhelper.pod:685 msgid "" -"Executable debhelper config files are run and their output used as the " -"configuration." +"Set to a non-empty value to enable verbose mode. Please see the B<-v> / B<--" +"verbose> option for details." msgstr "" -"Ausführbare Debhelper-Konfigurationsdateien werden ausgeführt und ihre " -"Ausgabe wird als Konfiguration benutzt." #. type: =item -#: debhelper.pod:687 -msgid "v10" -msgstr "v10" +#: debhelper.pod:688 +msgid "B<DH_QUIET>" +msgstr "B<DH_QUIET>" #. type: textblock -#: debhelper.pod:689 -msgid "Changes from v9 are:" -msgstr "Änderungen gegenüber v9 sind:" +#: debhelper.pod:690 +#, fuzzy +#| msgid "" +#| "Set to B<1> to enable quiet mode. Debhelper will not output commands " +#| "calling the upstream build system nor will dh print which subcommands are " +#| "called and depending on the upstream build system might make that more " +#| "quiet, too. This makes it easier to spot important messages but makes " +#| "the output quite useless as buildd log. Ignored if DH_VERBOSE is also " +#| "set." +msgid "" +"Set to a non-empty value to enable quiet mode. Debhelper will not output " +"commands calling the upstream build system nor will dh print which " +"subcommands are called and depending on the upstream build system might make " +"that more quiet, too. This makes it easier to spot important messages but " +"makes the output quite useless as buildd log." +msgstr "" +"auf B<1> gesetzt, um den detailarmen Modus zu aktivieren. Debhelper wird " +"weder Befehle ausgeben, die das Bausystem der Ursprungsautoren aufrufen, " +"noch wird Dh ausgeben, welche Unterbefehle aufgerufen werden. Abhängig vom " +"benutzten Bausystem wird auch dieses weniger Details ausgeben. Dadurch wird " +"es einfacher, wichtige Nachrichten zu erkennen, die Ausgabe wird jedoch als " +"Buildd-Protokoll ziemlich nutzlos. Falls DH_VERBOSE ebenfalls gesetzt ist, " +"wird diese Einstellung ignoriert." #. type: textblock -#: debhelper.pod:695 -msgid "" -"B<dh_installinit> will no longer install a file named debian/I<package> as " -"an init script." +#: debhelper.pod:696 +msgid "Ignored if DH_VERBOSE is also set or B<-v> / B<--verbose> is passed." msgstr "" -"B<dh_installinit> wird keine Datei namens debian/I<Paket> mehr als Init-" -"Skript installieren." + +#. type: =item +#: debhelper.pod:698 +msgid "B<DH_COMPAT>" +msgstr "B<DH_COMPAT>" #. type: textblock #: debhelper.pod:700 msgid "" -"B<dh_installdocs> will error out if it detects links created with --link-doc " -"between packages of architecture \"all\" and non-\"all\" as it breaks " -"binNMUs." +"Temporarily specifies what compatibility level debhelper should run at, " +"overriding any value specified via Build-Depends on debhelper-compat or via " +"the F<debian/compat> file." msgstr "" -"B<dh_installdocs> wird mit einem Fehler fehlschlagen, falls es Links " -"entdeckt, die mit --link-doc zwischen Paketen der Architektur »all« und " -"nicht-»all« erzeugt wurden, da d binNMUs beschädigt." +"gibt vorübergehend an, auf welcher Kompatibilitätsstufe Debhelper ausgeführt " +"werden soll und setzt dabei jeden Wert außer Kraft, der über Build-Depends " +"in Debhelper-compat oder über die Datei F<debian/compat> angegeben wurde." + +#. type: =item +#: debhelper.pod:704 +msgid "B<DH_NO_ACT>" +msgstr "B<DH_NO_ACT>" #. type: textblock #: debhelper.pod:706 +msgid "Set to B<1> to enable no-act mode." +msgstr "auf B<1> gesetzt, um Modus ohne Aktion zu aktivieren." + +#. type: =item +#: debhelper.pod:708 +msgid "B<DH_OPTIONS>" +msgstr "B<DH_OPTIONS>" + +#. type: textblock +#: debhelper.pod:710 msgid "" -"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." -"shlibs file. This is now done by B<dh_makeshlibs> instead." +"All debhelper tools will parse command line arguments listed in this " +"variable before any command option (as if they had been prepended to the " +"command line arguments). Unfortunately, some third-party provided tools may " +"not support this variable and will ignore these command line arguments." msgstr "" -"B<dh_installdeb> installiert keine vom Paketbetreuer bereitgestellte debian/" -"I<Paket>.shlibs-Datei mehr. Dies wird stattdessen von B<dh_makeshlibs> " -"erledigt." +"Alle Debhelper-Werkzeuge werden die in dieser Variable aufgeführten " +"Argumente vor ihren eigenen Befehlszeilenargumenten auswerten (als ob sie " +"den Befehlszeilenargumenten vorangestellt worden wären). Leider unterstützen " +"einige von Dritten bereitgestellte Werkzeuge diese Variable möglicherweise " +"nicht und werden diese Befehlszeilenargumente ignorieren." #. type: textblock -#: debhelper.pod:712 +#: debhelper.pod:715 msgid "" -"B<dh_installwm> refuses to create a broken package if no man page can be " -"found (required to register for the x-window-manager alternative)." +"When using L<dh(1)>, it can be passed options that will be passed on to each " +"debhelper command, which is generally better than using DH_OPTIONS." msgstr "" -"B<dh_installwm> weigert sich, ein beschädigtes Paket zu erstellen, falls " -"keine Handbuchseite gefunden wird (erforderlich, um die Alternative zum X-" -"Window-Manager zu registrieren)." +"Wenn L<dh(1)> benutzt wird, können ihm Optionen übergeben werden, die es an " +"jeden Debhelper-Befehl weitergibt, was im Allgemeinen besser ist, als " +"DH_OPTIONS zu verwenden." -#. type: textblock -#: debhelper.pod:717 -msgid "" -"Debhelper will default to B<--parallel> for all buildsystems that support " -"parallel building. This can be disabled by using either B<--no-parallel> or " -"passing B<--max-parallel> with a value of 1." -msgstr "" -"B<--parallel> ist Debhelpers Voreinstellung für alle Bausysteme, die " -"paralleles Bauen unterstützen. Dies kann entweder durch Verwendung von B<--" -"no-parallel> oder durch Ãœbergabe von B<--max-parallel> mit einem Wert von 1 " -"deaktiviert werden." +#. type: =item +#: debhelper.pod:718 +msgid "B<DH_ALWAYS_EXCLUDE>" +msgstr "B<DH_ALWAYS_EXCLUDE>" #. type: textblock -#: debhelper.pod:723 +#: debhelper.pod:720 msgid "" -"The B<dh> command will not accept any of the deprecated \"manual sequence " -"control\" parameters (B<--before>, B<--after>, etc.). Please use override " -"targets instead." +"If set, this adds the value the variable is set to to the B<-X> options of " +"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " +"B<rm -rf> anything that matches the value in your package build tree." msgstr "" -"Der Befehl B<dh> wird keinen der veralteten Parameter zur »manuellen " -"Sequenzsteuerung« (B<--before>, B<--after>, etc.) akzeptieren. Bitte " -"verwenden Sie stattdessen Aufhebungsziele (override targts)." +"Falls gesetzt, fügt dies den Wert der Variablen den B<-X>-Optionen aller " +"Befehle hinzu, welche die Option B<-X> unterstützen. Außerdem wird " +"B<dh_builddeb> für alles in Ihrem Paketbaubaum, das dem Wert entspricht, " +"B<rm -rf> ausführen." #. type: textblock -#: debhelper.pod:727 +#: debhelper.pod:724 msgid "" -"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " -"any of these since debhelper/12.4." +"This can be useful if you are doing a build from a CVS source tree, in which " +"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " +"sneaking into the package you build. Or, if a package has a source tarball " +"that (unwisely) includes CVS directories, you might want to export " +"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " +"your package is built." msgstr "" -"B<Nachträglich auf frühere Kompatibilitätsstufen angewandt>: B<dh> " -"akzeptiert seit Debhelper/12.4 nichts davon mehr." +"Dies kann nützlich sein, wenn Sie aus einem CVS-Quellverzeichnisbaum bauen. " +"In diesem Fall verhindert das Setzen von B<DH_ALWAYS_EXCLUDE=CVS>, dass sich " +"irgendwelche CVS-Verzeichnisse in das Paket einschleichen, das Sie bauen. " +"Oder, falls ein Paket einen Quell-Tarball hat, der (unklugerweise) CVS-" +"Verzeichnisse enthält, möchten Sie möglicherweise B<DH_ALWAYS_EXCLUDE=CVS> " +"in F<debian/rules> exportieren, damit es wirksam ist, wo auch immer Ihr " +"Paket gebaut wird." #. type: textblock -#: debhelper.pod:732 +#: debhelper.pod:731 msgid "" -"The B<dh> command will no longer use log files to track which commands have " -"been run. The B<dh> command I<still> keeps track of whether it already ran " -"the \"build\" sequence and skip it if it did." +"Multiple things to exclude can be separated with colons, as in " +"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" msgstr "" -"Der Befehl B<dh> wird keine Logdateien mehr benutzen, um zu protokollieren, " -"welche Befehle ausgeführt worden sind. Er wird aber I<trotzdem> " -"nachverfolgen, ob er selbst schon einmal in der Bausequenz gelaufen ist und " -"sie ggf. überspringen." +"Mehrere Dinge, die ausgeschlossen werden sollen, können mit Doppelpunkten " +"getrennt werden, wie in B<DH_ALWAYS_EXCLUDE=CVS:.svn>." + +#. type: =item +#: debhelper.pod:734 +msgid "B<DH_EXTRA_ADDONS>" +msgstr "B<DH_EXTRA_ADDONS>" #. type: textblock #: debhelper.pod:736 -msgid "The main effects of this are:" -msgstr "Die wichtigsten Auswirkungen davon sind:" +msgid "" +"If set, this adds the specified dh addons to be run in the appropriate " +"places in the sequence of commands. This is equivalent to specifying the " +"addon to run with the --with flag in the debian/rules file. Any --without " +"calls specifying an addon in this environment variable will not be run." +msgstr "" +"Falls gesetzt, fügt dies die angegebenen Dh-Erweiterungen hinzu, die an den " +"entsprechenden Stellen in den Befehlssequenzen ausgeführt werden. Dies " +"entspricht der Angabe der auszuführenden Erweiterung mit dem Schalter --with " +"in der Datei »debian/rules«. Alle --without-Aufrufe, die in dieser " +"Umgebungsvariable eine Erweiterung festlegen, werden nicht ausgeführt." #. type: textblock -#: debhelper.pod:742 +#: debhelper.pod:741 msgid "" -"With this, it is now easier to debug the I<install> or/and I<binary> " -"sequences because they can now trivially be re-run (without having to do a " -"full \"clean and rebuild\" cycle)" +"This is intended to be used by downstreams or specific local configurations " +"that require a debhelper addon to be run during multiple builds without " +"having to patch a large number of rules file. If at all possible, this " +"should be avoided in favor of a --with flag in the rules file." msgstr "" -"Hierdurch wird die Fehlersuche bei den Sequenzen I<install> und/oder " -"I<binary> einfacher, da sie nun einfach erneut ausgeführt werden können " -"(ohne, dass ein vollständiger »Aufräum- und Neubau«-Durchgang erforderlich " -"ist)." +"Dies ist für die Benutzung durch nachgeschaltete Distributionen oder " +"spezielle lokale Konfigurationen gedacht, die während mehrerer Bauvorgänge " +"eine Debhelper-Erweiterung ausführen müssen, ohne dass eine große Anzahl von " +"Regeldateien bearbeitet werden muss. Falls überhaupt möglich, sollte dies " +"zugunsten eines --with-Schalters in der Datei »rules« vermieden werden." + +#. type: =item +#: debhelper.pod:746 +msgid "B<DH_COLORS>, B<DPKG_COLORS>" +msgstr "B<DH_COLORS>, B<DPKG_COLORS>" #. type: textblock #: debhelper.pod:748 msgid "" -"The main caveat is that B<dh_*> now only keeps track of what happened in a " -"single override target. When all the calls to a given B<dh_cmd> command " -"happens in the same override target everything will work as before." +"These variables can be used to control whether debhelper commands should use " +"colors in their textual output. Can be set to \"always\", \"auto\" (the " +"default), or \"never\"." msgstr "" -"Der Pferdefuß hier liegt darin, dass B<dh_*> nun nur noch nachverfolgt, was " -"in einem einzelnen Override-Ziel geschieht. Wenn alle Aufrufe eines " -"angegebenen B<dh_cmd>-Befehls im selben Override-Ziel stattfinden, wird " -"alles wie zuvor funktionieren." +"Diese Variablen können benutzt werden, um zu steuern, ob Debhelper-Befehle " +"in ihrer Textausgabe Farben benutzen sollen. Sie können auf »always«, " +"»auto« (die Voreinstellung) oder »never« gesetzt werden." #. type: textblock -#: debhelper.pod:753 -msgid "Example of where it can go wrong:" -msgstr "Beispiel, bei dem es schiefgehen kann:" - -#. type: verbatim -#: debhelper.pod:755 -#, no-wrap +#: debhelper.pod:752 msgid "" -" override_dh_foo:\n" -" dh_foo -pmy-pkg\n" -"\n" +"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " +"debhelper uses it on the assumption that you want the same color setting for " +"dpkg and debhelper. In the off-hand chance you want different color setting " +"for debhelper, you can use B<DH_COLORS> instead or in addition to " +"B<DPKG_COLORS>." msgstr "" -" override_dh_foo:\n" -" dh_foo -pmein-Paket\n" -"\n" +"Beachten Sie, dass B<DPKG_COLOR> auch mehrere mit Dpkg verbunden Werkzeuge " +"beeinflusst und Debhelper es unter der Annahme benutzt, dass Sie dieselbe " +"Farbeinstellung für Dpkg und Debhelper benutzen wollen. In dem " +"unwahrscheinlichen Fall, dass Sie für Debhelper eine andere Farbeinstellung " +"möchten, können Sie B<DH_COLORS> statt oder zusätzlich zu B<DPKG_COLORS> " +"verwenden." -#. type: verbatim +#. type: =item #: debhelper.pod:758 -#, no-wrap +msgid "B<NO_COLOR>" +msgstr "B<NO_COLOR>" + +#. type: textblock +#: debhelper.pod:760 msgid "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" +"If no explicit request for color has been given (e.g. B<DH_COLORS> and " +"B<DPKG_COLORS> are both unset), the presence of this environment variable " +"cause the default color setting to be \"never\"." msgstr "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" +"Falls nicht explizit um Farbe gebeten wurde (sowohl B<DH_COLORS> als auch " +"B<DPKG_COLORS> sind nicht gesetzt), führt die Anwesenheit dieser " +"Umgebungsvariablen dazu, dass die Standardfarbeinstellung auf »never« " +"gesetzt wird." #. type: textblock -#: debhelper.pod:762 +#: debhelper.pod:764 msgid "" -"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" -"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " -"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." +"The variable is defined according to L<https://no-color.org/>. In this " +"project, the environment variables (such as B<DH_COLORS>) are considered an " +"explicit request for color." msgstr "" -"In diesem Fall wird der Aufruf von B<dh_foo --remaining> I<außerdem> I<mein-" -"Paket> enthalten, da B<dh_foo -pmein-Paket> in einem separaten Override-Ziel " -"ausgeführt wird. Dieses Problem ist nicht auf B<--remaining> begrenzt, es " -"umfasst außerdem B<-a>, B<-i>, etc." +"Die Variable ist gemäß L<https://no-color.org/> definiert. In diesem Projekt " +"werden die Umgebungsvariablen (wie B<DH_COLORS>) als explizite Farbanfrage " +"betrachtet." -#. type: textblock -#: debhelper.pod:771 +#. type: =item +#: debhelper.pod:768 msgid "" -"The B<dh_installdeb> command now shell-escapes the lines in the " -"F<maintscript> config file. This was the original intent but it did not " -"work properly and packages have begun to rely on the incomplete shell " -"escaping (e.g. quoting file names)." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" msgstr "" -"Der Befehl B<dh_installdeb> maskiert nun die Zeilen in der " -"Konfigurationsdatei F<maintscript> für die Shell. Dies war der ursprüngliche " -"Gedanke, aber es funktionierte nicht, wie es sollte und die Pakete begannen, " -"sich auf die unvollständige Shell-Maskierung zu verlassen (z.B. das Setzen " -"von Dateinamen in Anführungszeichen)." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" #. type: textblock -#: debhelper.pod:778 +#: debhelper.pod:770 msgid "" -"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " -"For packages needing the previous behaviour, please use B<--no-restart-after-" -"upgrade>." +"By default (in any non-deprecated compat level), debhelper will " +"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " +"unset. If you need to change the default flags, please use the features " +"from L<dpkg-buildflags(1)> to do this (e.g. " +"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" +"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." msgstr "" -"Voreinstellung für den Befehl B<dh_installinit> ist nun B<--restart-after-" -"upgrade>. Für Pakete, die das vorhergehende Verhalten erfordern, verwenden " -"Sie bitte B<--no-restart-after-upgrade>." +"Standardmäßig (in jeder nicht missbilligten Kompatibilitätsstufe) wird " +"Debhelper diese Schalter automatisch mittels L<dpkg-buildflags(1)> setzen, " +"wenn sie nicht gesetzt sind. Falls Sie die voreingestellten Schalter ändern " +"wollen, benutzen Sie dazu die Funktionalität von L<dpkg-buildflags(1)> (z.B. " +"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> oder B<DEB_CPPFLAGS_MAINT_APPEND=-" +"DCUSTOM_MACRO=true>) statt die konkrete Variable direkt zu setzen." + +#. type: =item +#: debhelper.pod:777 +msgid "B<HOME>, B<XDG_*>" +msgstr "B<HOME>, B<XDG_*>" #. type: textblock -#: debhelper.pod:784 +#: debhelper.pod:779 msgid "" -"The B<autoreconf> sequence is now enabled by default. Please pass B<--" -"without autoreconf> to B<dh> if this is not desirable for a given package" +"In compat 13 and later, these environment variables are reset before " +"invoking the upstream build system via the B<dh_auto_*> helpers. The " +"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " +"(B<dh_auto_test> only) will be set to a writable directory. All remaining " +"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " +"cleared." msgstr "" -"Die B<autoreconf>-Sequenz ist nun standardmäßig aktiviert. Bitte übergeben " -"Sie B<--without autoreconf> an B<dh>, falls dies für ein angegebenes Paket " -"nicht erwünscht ist." +"In Kompatibilitätsstufe 13 und später werden diese Umgebungsvariablen " +"zurückgesetzt, bevor das Originalautoren-Bausystem via B<dh_auto_*> " +"angeworfen wird. Die B<HOME>- (B<dh_auto_*>-Hilfsprogramme) und die " +"B<XDG_RUNTIME_DIR>-Variable (nur B<dh_auto_test>) werden auf ein " +"beschreibbares Verzeichnis gesetzt. Alle anderen Variablen und " +"B<XDG_RUNTIME_DIR> (außer während des B<dh_auto_test>) werden geleert." #. type: textblock -#: debhelper.pod:790 +#: debhelper.pod:785 msgid "" -"The B<systemd> sequence is now enabled by default. Please pass B<--without " -"systemd> to B<dh> if this is not desirable for a given package." +"The B<HOME> directory will be created as an empty directory but it will be " +"reused between calls to B<dh_auto_*>. Any content will persist until " +"explicitly deleted or B<dh_clean>." msgstr "" -"Die B<systemd>-Sequenz ist nun standardmäßig aktiviert. Bitte übergeben Sie " -"B<--without systemd> an B<dh>, falls dies für ein angegebenes Paket nicht " -"erwünscht ist." +"Die Verzeichnisse werden leer erzeugt und zwischen den B<dh_auto_*>-Aufrufen " +"wiederverwendet. Jeglicher Inhalt wird weiter bestehen, bis er explizit " +"gelöscht oder B<dh_clean> aufgerufen wird." + +#. type: =item +#: debhelper.pod:789 +msgid "B<DEB_BUILD_OPTIONS>" +msgstr "B<DEB_BUILD_OPTIONS>" #. type: textblock -#: debhelper.pod:796 +#: debhelper.pod:791 msgid "" -"B<Retroactively removed>: B<dh> no longer creates the package build " -"directory when skipping running debhelper commands. This will not affect " -"packages that only build with debhelper commands, but it may expose bugs in " -"commands not included in debhelper." +"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " +"variable." msgstr "" -"B<Nachträglich entfernt>: B<dh> erstellt das Bauverzeichnis des Pakets nicht " -"mehr, wenn die Ausführung von Debhelper-Befehlen übersprungen wird. Dies hat " -"keine Auswirkungen auf Pakete, die nur mit Debhelper-Befehlen bauen, es " -"könnte aber Fehler in Befehlen offenlegen, die nicht in Debhelper enthalten " -"sind." +"Die Beschreibung dieser Umgebungsvariable entnehmen Sie bitte L</" +"Unterstützte Optionen in DEB_BUILD_OPTIONS>" #. type: textblock -#: debhelper.pod:801 +#: debhelper.pod:794 msgid "" -"This compatibility feature had a bug since its inception in " -"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " -"there has been no reports of issues caused by this bug in those ~5 years, " -"this item have been removed rather than fixed." +"Please note that this variable should I<not> be altered by package " +"maintainers inside F<debian/rules> to change the behaviour of debhelper. " +"Instead, where the package maintainer need these features, they should look " +"disabling the relevant feature directly (e.g. by overriding the concrete " +"tools)." msgstr "" -"Diese Kompatibilitätsfunktionalität hatte einen Fehler seit ihrer Aufnahme " -"in Debhelper/9.20130516, der sie im Kompatibilitätsmodus 9 und älter zum " -"Scheitern brachte. Da es in den fünf Jahren ihres Bestehens keine Berichte " -"zu Problemen gab, die von diesem Fehler verursacht wurden, wurde sie nicht " -"überarbeitet, sondern entfernt." +"Bitte beachten Sie, dass diese Variable von Paketbetreuern in ihren F<debian/" +"rules> I<nicht> geändert werden sollte, um das Verhalten von Debhelper zu " +"beeinflussen. Stattdessen sollen die fraglichen Funktionsmerkmale direkt " +"abgeschaltet werden (etwa durch Außerkraftsetzen der betreffenden Werkzeuge)." #. type: =item -#: debhelper.pod:808 -msgid "v11" -msgstr "v11" +#: debhelper.pod:799 +msgid "B<DEB_BUILD_MAINT_OPTIONS>" +msgstr "B<DEB_BUILD_MAINT_OPTIONS>" #. type: textblock -#: debhelper.pod:810 -msgid "This mode is discouraged." -msgstr "Von diesem Modus wird abgeraten." +#: debhelper.pod:801 +msgid "" +"This is a dpkg specific environment variable (see e.g. L<dpkg-" +"buildflags(1)>). The debhelper tool suite silently ignores it." +msgstr "" +"Dies ist eine Dpkg-spezifische Umgebungsvariable (siehe L<dpkg-" +"buildflags(1)>). Die Debhelper-Suite ignoriert sie kommentarlos." #. type: textblock -#: debhelper.pod:812 +#: debhelper.pod:804 msgid "" -"The compat 11 is discouraged for new packages as it suffers from feature " -"interaction between L<dh_installinit> and L<dh_installsystemd> causing " -"services to not run correctly in some cases. Please consider using " -"compatibility mode 10 or 12 instead. More details about the issue are " -"available in Debian#887904 and L<https://lists.debian.org/debian-" -"release/2019/04/msg01442.html>." +"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " +"which make some people mistakenly assume that debhelper will also react to " +"this variable." msgstr "" -"Von der Kompatibilitätsstufe 11 wird für neue Pakete abgeraten, da sie vvon " -"Funktionalitätswechselwirkungen zwischen L<dh_installinit> und " -"L<dh_installsystemd> betroffen ist, die dazu führen, dass in manchen Fällen " -"Dienste nicht korrekt laufen. Bitte erwägen Sie, stattdessen die " -"Kompatibilitätsstufen 10 oder 12 zu benutzen. Weitere Einzelheiten über das " -"Thema sind in Debian#887904 und L<https://lists.debian.org/debian-" -"release/2019/04/msg01442.html> verfügbar." +"Sie ist hier dokumentiert, weil ihr Name B<DEB_BUILD_OPTIONS> ähnelt, was zu " +"der falschen Annahme verleiten kann, dass Debhelper die Variable genauso auf " +"die Variable reagiert." -#. type: textblock -#: debhelper.pod:819 -msgid "Changes from v10 are:" -msgstr "Änderungen gegenüber v10 sind:" +#. type: =head2 +#: debhelper.pod:810 +msgid "Supported flags in DEB_BUILD_OPTIONS" +msgstr "Unterstützte Optionen in DEB_BUILD_OPTIONS" #. type: textblock -#: debhelper.pod:825 +#: debhelper.pod:812 msgid "" -"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " -"generates maintainer scripts for those files. Please use the new " -"B<dh_installsystemd> helper." +"The debhelper tool suite reacts to the following flags in " +"B<DEB_BUILD_OPTIONS>." msgstr "" -"B<dh_installinit> installiert keine F<service>- oder F<tmpfile>-Dateien " -"mehr. Es erstellt auch keine Betreuerskripte dafür. Bitte verwenden Sie das " -"neue Hilfsprogramm B<dh_installsystemd>." +"Die Debhelper-Suite reagiert auf die folgenden Optionen in " +"B<DEB_BUILD_OPTIONS>:" + +#. type: =item +#: debhelper.pod:816 +msgid "B<dherroron=obsolete-compat-levels>" +msgstr "dherroron=obsolete-compat-levels>" #. type: textblock -#: debhelper.pod:831 -msgid "" -"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " -"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " -"sequence for B<dh> has also been removed. If you need to disable the " -"B<dh_installsystemd> helper tool, please use an empty override target." -msgstr "" -"Die Hilfsprogramme B<dh_systemd_enable> und B<dh_systemd_start> wurden durch " -"das neue Hilfsprogramm B<dh_installsystemd> ersetzt. Aus demselben Grund " -"wurde auch die B<systemd>-Sequenz für B<dh> entfernt. Wenn Sie das " -"Hilfswerkzeug B<dh_installsystemd> deaktivieren möchten, verwenden Sie bitte " -"ein leeres Override-Ziel." +#: debhelper.pod:818 +msgid "I<This is a debhelper specific value.>" +msgstr "I<Dieser Wert ist Debhelper-spezfisch.>" #. type: textblock -#: debhelper.pod:837 +#: debhelper.pod:820 msgid "" -"Please note that the B<dh_installsystemd> tool has a slightly different " -"behaviour in some cases (e.g. when using the B<--name> parameter)." +"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " +"debhelper tools will promote deprecation warnings for usage of old soon to " +"be removed compat levels into errors." msgstr "" -"Bitte beachten Sie, dass sich das Werkzeug B<dh_installsystemd> in manchen " -"Fällen (z.B. bei der Verwendung des Parameters B<--name>) geringfügig anders " -"verhält." +"Wenn B<dherroron> vorhanden und auf B<obsolete-compat-levels> gesetzt ist, " +"werden die Debhelper-Werkzeuge die Missbilligungswarnungen für auf der " +"Abschussliste stehenden Kompaitiblitätsstufen zu Fehlern erheben." #. type: textblock -#: debhelper.pod:843 +#: debhelper.pod:824 msgid "" -"B<dh_installdirs> no longer creates debian/I<package> directories unless " -"explicitly requested (or it has to create a subdirectory in it)." +"This is useful for automated checking for code relying on deprecated compat " +"levels that is scheduled for removal." msgstr "" -"B<dh_installdirs> erstellt keine debian/I<Paket>-Verzeichnisse mehr, es sei " -"denn, dies wird ausdrücklich verlangt (oder es muss ein Unterverzeichnis " -"darin erstellt werden)." +"Dies hilft bei automatischen Ãœberprüfungen, ob Kode auf veralteten " +"Kompatibilitätsstufen basiert, die bald entfernt werden sollen." #. type: textblock -#: debhelper.pod:847 -msgid "The vast majority of all packages will be unaffected by this change." +#: debhelper.pod:827 +msgid "This option is intended for testing purposes; not production builds." msgstr "" -"Die große Mehrheit aller Pakete wird von dieser Änderung nicht betroffen " -"sein." +"Die Option ist für Testzwecke gedacht, aber nicht für Produktiveinsatz." + +#. type: =item +#: debhelper.pod:829 +msgid "B<nostrip>" +msgstr "B<nostrip>" #. type: textblock -#: debhelper.pod:851 +#: debhelper.pod:831 debhelper.pod:854 debhelper.pod:868 msgid "" -"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" -"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " -"or B<cmake>) are unaffected by this change." +"I<This value will change the content of the debs being built. The .deb " +"packages built when this is set is therefore not bit-for-bit reproducible " +"with a regular build in the general case.>" msgstr "" -"Das B<makefile>-Bausystem übergibt nun B<INSTALL=\"install --strip-" -"program=true\"> an L<make(1)>. Davon abgeleitete Bausysteme (z. B. " -"B<configure> oder B<cmake>) sind von dieser Änderung nicht betroffen." +"I<Dieser Wert ändert den Inhalt der Debs, die gebaut werden. Die .deb-" +"Pakete, die unter Anwesenheit dieses Werts gebaut werden, werden nicht Bit " +"für Bit reproduzierbar sein, was bei einem gewöhnlichen Paket der Regelfall " +"ist.>" #. type: textblock -#: debhelper.pod:857 +#: debhelper.pod:835 msgid "" -"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" -"configure>." +"This value will cause the official debhelper tools will skip actions and " +"helpers that either remove, detach or deduplicate debugging symbols in ELF " +"binaries." msgstr "" -"Das B<autoconf>-Bausystem übergibt nun B<--runstatedir=/run> an F<./" -"configure>." +"Durch diesen Wert werden die offiziellen Debhelper-Werkzeuge dazu gebracht, " +"Aktionen und Hilfsprogramme zum Entfernen, Abkoppeln oder Deduplizieren von " +"Fehlersuchsymbolen in ELF-Binärdateien zu überspringen." #. type: textblock -#: debhelper.pod:862 -msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " -"L<cmake(1)>." -msgstr "" -"Das B<cmake>-Bausystem übergibt nun B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> an " -"L<cmake(1)>." +#: debhelper.pod:839 +msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." +msgstr "Dieser Wert betrifft L<dh_dwz(1)> und L<dh_strip(1)>." + +#. type: =item +#: debhelper.pod:841 +msgid "B<nocheck>" +msgstr "B<nocheck>" #. type: textblock -#: debhelper.pod:867 +#: debhelper.pod:843 msgid "" -"B<dh_installman> will now prefer detecting the language from the path name " -"rather than the extension." +"This value will cause the official debhelper build systems to skip runs of " +"upstream test suites." msgstr "" -"B<dh_installman> wird nun vorzugsweise die Sprache anhand des Pfadnamens " -"statt der Erweiterung bestimmen." +"Dieser Wert führt dazu, dass die offiziellen Debhelper-Bausysteme die " +"Ausführung von Test-Suiten der Originalautoren überspringen." #. type: textblock -#: debhelper.pod:872 +#: debhelper.pod:846 msgid "" -"B<dh_auto_install> will now only create the destination directory it needs. " -"Previously, it would create the package build directory for all packages. " -"This will not affect packages that only build with debhelper commands, but " -"it may expose bugs in commands not included in debhelper." +"Package maintainers looking to avoid running the upstream tests should " +"B<not> rely on this. Instead, they can add an empty override target to skip " +"B<dh_auto_test>." msgstr "" -"B<dh_auto_install> wird jetzt nur das Zielverzeichnis erstellen, das es " -"benötigt. Vorher hätte es die Bauverzeichnisse für alle Pakete erstellt. " -"Dies hat keine Auswirkungen auf Pakete, die nur mit Debhelper-Befehlen " -"bauen, es könnte aber Programmfehler in Befehlen offenlegen, die nicht in " -"Debhelper enthalten sind." +"Paketbetreuer, die versuchen, diese Tests zu umgehen, sollten sich hierauf " +"B<nicht> verlassen. Stattdessen können sie ein leeres Override-Ziel angeben, " +"um B<dh_auto_test> zu überspringen." #. type: textblock -#: debhelper.pod:880 -msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now error out if their config has a pattern that does not " -"match anything or reference a path that does not exist." -msgstr "" -"Die Hilfsprogramme B<dh_installdocs>, B<dh_installexamples>, " -"B<dh_installinfo> und B<dh_installman> beenden sich jetzt mit Fehlermeldung, " -"falls ihre Konfiguration ein Muster aufweist, das zu nichts passt oder sich " -"auf einen Pfad bezieht, den es nicht gibt." +#: debhelper.pod:850 +msgid "This value affects L<dh_auto_test(1)>." +msgstr "Dieser Wert betrifft L<dh_auto_test(1)>." + +#. type: =item +#: debhelper.pod:852 +msgid "B<nodoc>" +msgstr "B<nodoc>" #. type: textblock -#: debhelper.pod:884 +#: debhelper.pod:858 msgid "" -"Known exceptions include building with the B<nodoc> profile, where the above " -"tools will silently permit failed matches where the patterns are used to " -"specify documentation." +"This value will cause several debhelper tools to skip installation of " +"documentation such as manpages or upstream provided documentation. " +"Additionally, the tools will also ignore if declared documentation is " +"\"missing\" on the assumption that the documentation has not been built." msgstr "" -"Bekannte Ausnahmen umfassen das Bauen mit dem Profil B<nodoc>, bei dem die " -"obigen Werkzeuge stillschweigend fehlschlagende Suchen mit Mustern erlauben," -"welche zur Angabe von Dokumentation verwendet werden." +"Dieser Wert wird mehrere Debhelper-Tools anweisen, die Installation von " +"Dokumentation wie Handbuchseiten oder von den Originalautoren " +"bereitgestellte Dokumentation auszulassen. Außerdem werden die Werkzeuge es " +"ignorieren, wenndie deklarierte Dokumentation fehlt, unter der Annahme, dass " +"sie nicht gebaut wurde." #. type: textblock -#: debhelper.pod:890 +#: debhelper.pod:863 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " -"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " -"B<dh_install>." +"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " +"working with documentation." msgstr "" -"Die Hilfsprogramme B<dh_installdocs>, B<dh_installexamples>, " -"B<dh_installinfo> und B<dh_installman> akzeptieren nun den Parameter B<--" -"sourcedir> mit derselben Bedeutung wie B<dh_install>. Ãœberdies fallen sie " -"jetzt, so wie B<dh_install>, auf F<debian/tmp> zurück." +"Dieser Wert betrifft Werkzeuge I<wie> L<dh_installdocs(1)>, welches I<weiß>, " +"dass es mit Dokumentation arbeitet." + +#. type: =item +#: debhelper.pod:866 +#, fuzzy +#| msgid "B<nostrip>" +msgid "B<notrimdch>" +msgstr "B<nostrip>" #. type: textblock -#: debhelper.pod:895 +#: debhelper.pod:872 msgid "" -"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " -"incorrectly ignore B<--sourcedir>." +"This value will cause L<dh_installchangelogs(1)> to act as if it had been " +"passed the B<--no-trim> option, forcing it to forgo removing older entries " +"from changelogs." msgstr "" -"Migrationshinweis: Ein Fehler in Debhelper 11 bis 11.1.5 führte " -"fälschlicherweise dazu, dass B<dh_installinfo> B<--sourcedir> ignoriert hat." -# FIXME s/can emulate it/can get an emulation of it/ (or emulate it) +#. type: =item +#: debhelper.pod:876 +msgid "B<noautodbgsym>, B<noddebs>" +msgstr "B<noautodbgsym>, B<noddebs>" + #. type: textblock -#: debhelper.pod:900 +#: debhelper.pod:878 msgid "" -"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)." +"I<The official name is noautodbgsym. The noddebs variant is accepted for " +"historical reasons.>" msgstr "" -"Die Bausysteme B<perl-makemaker> und B<perl-build> übergeben B<-I.> nicht " -"mehr an Perl. Pakete, die dieses Verhalten immer noch benötigen, können es " -"durch Verwendung der Umgebungsvariable B<PERL5LIB> emulieren, z. B. durch " -"Eintragen von B<export PERL5LIB=.> in ihre »debian/rules«-Datei (oder " -"dergleichen)." +"I<Der offizielle Name ist noautodbgsym. Die noddebs-Variante wird aus " +"historischen Gründen akzeptiert.>" #. type: textblock -#: debhelper.pod:907 +#: debhelper.pod:881 msgid "" -"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " -"any of the B<dh_auto_*> tools. It was added as a temporary work around to " -"avoid a lot of packages failing to build at the same time." +"This value causes debhelper to skip the generation of automatically " +"generated debug symbol packages." msgstr "" -"B<PERL_USE_UNSAFE_INC> wird jetzt von B<dh> oder den B<dh_auto_*>-Werkzeugen " -"nicht mehr gesetzt. Sie diente als Ãœbergangslösung, um zu verhindern, dass " -"das gleichzeitige Bauen vieler Pakete scheitert." +"Dieser Wert veranlasst Debhelper, die automatische Erzeugung der " +"Fehlersuchsymbol-Pakete zu unterlassen." #. type: textblock -#: debhelper.pod:912 -msgid "" -"Note this item will eventually become obsolete as upstream intends to drop " -"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " -"drops support for it, then this variable will be removed retroactively from " -"existing compat levels as well." -msgstr "" -"Beachten Sie, dass sie irgendwann komplett hinfällig wird, da die " -"Ursprungsautoren beabsichtigen, die Unterstützung für die Umgebungsvariable " -"B<PERL_USE_UNSAFE_INC> einzustellen. Wenn es so weit ist, wird diese " -"Variable nachträglich auch aus bestehenden Kompatibilitätsstufen entfernt." +#: debhelper.pod:884 +msgid "This value affects L<dh_strip(1)>." +msgstr "Dieser Wert beeinflusst L<dh_strip(1)>." + +#. type: =item +#: debhelper.pod:886 +msgid "B<parallel=N>" +msgstr "B<parallel=N>" #. type: textblock -#: debhelper.pod:919 +#: debhelper.pod:888 msgid "" -"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " -"non-zero exit from analysing a given file." +"This value enables debhelper to use up to B<N> threads or processes (subject " +"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " +"debhelper tools work with parallel tasks and may silently ignore the request." msgstr "" -"Das Hilfsprogramm B<dh_makeshlibs> wird nun mit einer Fehlermeldung beendet, " -"falls Objdump nach der Auswertung einer gegebenen Datei einen Rückgabewert " -"ungleich null zurückliefert." +"Dieser Wert erlaubt es Debhelper, bis zu B<N> Threads oder Prozesse " +"(eingeschränkt durch Parameter wie B<--no-parallel> und B<--max-parallel=M>) " +"zu verwenden. Nicht alle Debhelper-Werkzeuge arbeiten parallel und können " +"die Anfrage daher kommentarlos ignorieren." #. type: textblock -#: debhelper.pod:924 +#: debhelper.pod:893 msgid "" -"The B<dh_installdocs> and B<dh_installexamples> tools may now install " -"I<most> of the documentation in a different path to comply with the " -"recommendation from Debian policy §12.3 (since version 3.9.7)." +"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " +"will attempt to run the underlying upstream build system with that number of " +"threads." msgstr "" -"Die Werkzeuge B<dh_installdocs> und B<dh_installexamples> können jezt die " -"I<meiste> Dokumentation in einem anderen Pfad installieren, um die " -"Empfehlung der Debian-Richtlinien §12.3 (seit Version 3.9.7) zu erfüllen." +"Dieser Wert betrifft viele Debhelper-Werkzeuge. Vor allem B<dh_auto_*> wird " +"versuchen, das zugrundeliegende Bausystem der Originalautoren mit dieser " +"Anzahl an Threads auszuführen." + +#. type: =item +#: debhelper.pod:897 +msgid "B<terse>" +msgstr "B<terse>" #. type: textblock -#: debhelper.pod:928 +#: debhelper.pod:899 msgid "" -"Note that if a given source package only contains a single binary package in " -"F<debian/control> or none of the packages are I<-doc> packages, then this " -"change is not relevant for that source package and you can skip to the next " -"change." +"This value will cause the official debhelper build systems to configure " +"upstream builds to be terse (i.e. reduce verbosity in their output). This " +"is subject to the upstream and the debhelper build system supporting such " +"features." msgstr "" -"Beachten Sie, dass diese Änderung nicht für dieses Quellpaket relevant ist " -"und Sie zur nächsten Änderung springen können, falls ein angegebenes " -"Quellpaket nur ein einziges Binärpaket in F<debian/control> enthält oder " -"keine I<-doc>-Pakete dabei sind." +"Dieser Wert wird die offiziellen Debhelper-Bausysteme zu einer knappen, " +"weniger ausführlichen (daher »terse«) Ausgabe animieren. Seine Wirkung hängt " +"davon ab, inwieweit das Bausystem der Originalautoren und das von Debhelper " +"solche Funktionsmerkmale unterstützen." #. type: textblock -#: debhelper.pod:933 +#: debhelper.pod:904 msgid "" -"By default, these tools will now attempt to determine a \"main package for " -"the documentation\" (called a I<doc-main-package> from here on) for every I<-" -"doc> package. If they find such a I<doc-main-package>, they will now " -"install the documentation into the path F<< /usr/share/doc/I<doc-main-" -"package> >> in the given doc package. I.e. the path can change but the " -"documentation is still shipped in the I<-doc> package." +"This value affects most B<dh_auto_*> tools directly. For commands provided " +"by the debhelper package, it also causes the tools to act like the " +"B<DH_QUIET> environment variable was non-empty." msgstr "" -"Standardmäßig werden diese Werkzeuge nun versuchen, ein »Hauptpaket für die " -"Dokumentation« (ab hier I<Hauptdokumentationspaket> genannt) für jedes I<-" -"doc>-Paket zu bestimmen. Falls sie ein derartiges " -"I<Hauptdokumentationspaket> finden, werden sie nun die Dokumentation in den " -"Pfad F<< /usr/share/doc/I<Hauptdokumentationspaket> >> im angegebenen " -"Dokumentationspaket installieren. Das heißt, der Pfad kann sich ändern, aber " -"die Dokumentation wird immer noch im I<-doc>-Paket mitgeliefert." #. type: textblock -#: debhelper.pod:941 -msgid "" -"The B<--doc-main-package> option can be used when the auto-detection is " -"insufficient or to reset the path to its previous value if there is a reason " -"to diverge from Debian policy recommendation." -msgstr "" -"Die Option B<--doc-main-package> kann benutzt werden, wenn die automatische " -"Erkennung unzureichend ist oder um den Pfad auf seinen vorherigen Wert " -"zurückzusetzen, falls es einen Grund gibt, von der Empfehlung der Debian-" -"Richlinien abzuweichen." +#: debhelper.pod:910 +msgid "Unknown flags are silently ignored." +msgstr "Unbekannte Schalter werden stillschweigend ignoriert." #. type: textblock -#: debhelper.pod:945 +#: debhelper.pod:912 msgid "" -"Some documentation will not be affected by this change. These exceptions " -"include the copyright file, changelog files, README.Debian, etc. These " -"files will still be installed in the path F<< /usr/share/doc/I<package> >>." +"Note third-party debhelper-like tools or third-party provided build systems " +"may or may not react to the above flags. This tends to depend on " +"implementation details of the tool." +msgstr "" +"Beachten Sie, dass Debhelper-ähnliche Werkzeuge oder Bausysteme von " +"Drittherstellern unterschiedlich auf die oben genannten Schalter reagieren. " +"Das hängt davon ab, wie die Werkzeuge im Detail implementiert sind." + +#. type: =head1 +#: debhelper.pod:916 debhelper-compat-upgrade-checklist.pod:753 +#: debhelper-obsolete-compat.pod:178 dh:872 dh_auto_build:53 dh_auto_clean:55 +#: dh_auto_configure:58 dh_auto_install:103 dh_auto_test:64 dh_bugfiles:133 +#: dh_builddeb:176 dh_clean:189 dh_compress:243 dh_dwz:163 dh_fixperms:164 +#: dh_gencontrol:208 dh_icons:75 dh_install:377 dh_installcatalogs:128 +#: dh_installchangelogs:365 dh_installcron:80 dh_installdeb:419 +#: dh_installdebconf:233 dh_installdirs:131 dh_installdocs:437 +#: dh_installemacsen:138 dh_installexamples:182 dh_installifupdown:72 +#: dh_installinfo:123 dh_installinit:413 dh_installinitramfs:91 +#: dh_installlogcheck:81 dh_installlogrotate:53 dh_installman:420 +#: dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 +#: dh_installmodules:109 dh_installpam:71 dh_installppp:68 dh_installudev:102 +#: dh_installwm:130 dh_installxfonts:90 dh_link:166 dh_lintian:60 +#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 +#: dh_perl:188 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 +#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:280 dh_systemd_start:280 +msgid "SEE ALSO" +msgstr "SIEHE AUCH" + +#. type: =item +#: debhelper.pod:920 +msgid "L<debhelper-compat-upgrade-checklist(7)>" msgstr "" -"Manche Dokumentation wird von dieser Änderung nicht beeinflusst. Diese " -"Ausnahmen umfassen die Copyright-Dateien, README.Debian usw. Diese Dateien " -"werden weiterhin im Pfad F<< /usr/share/doc/I<Paket> >> installiert." #. type: textblock -#: debhelper.pod:952 +#: debhelper.pod:922 msgid "" -"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " -"to determine which files to process. Instead, they open the file and look " -"for an ELF header to determine if a given file is an shared object or an ELF " -"executable." +"List of supported compat levels and an upgrade checklist for each of them." msgstr "" -"Die Werkzeuge B<dh_strip> und B<dh_shlibdeps> verwenden keine " -"Dateinamenmuster mehr, um zu bestimmen, welche Dateien verarbeitet werden. " -"Stattdessen öffnen sie die Datei und suchen nach einem ELF-Header, um zu " -"bestimmen, ob eine übergebene Datei ein gemeinsam benutztes Objekt oder ein " -"ausführbares binäres Programm ist." + +#. type: =item +#: debhelper.pod:924 +msgid "F</usr/share/doc/debhelper/examples/>" +msgstr "F</usr/share/doc/debhelper/examples/>" #. type: textblock -#: debhelper.pod:957 -msgid "This change may cause the tools to process more files than previously." +#: debhelper.pod:926 +msgid "A set of example F<debian/rules> files that use debhelper." msgstr "" -"Diese Änderung kann dazu führen, dass mehr Dateien als vorher verarbeitet " -"werden." +"eine Zusammenstellung von F<debian/rules>-Beispieldateien, die Debhelper " +"benutzen" #. type: =item -#: debhelper.pod:961 -msgid "v12" -msgstr "v12" +#: debhelper.pod:928 +msgid "L<http://joeyh.name/code/debhelper/>" +msgstr "L<http://joeyh.name/code/debhelper/>" #. type: textblock -#: debhelper.pod:963 -msgid "Changes from v11 are:" -msgstr "Änderungen gegenüber v11 sind:" +#: debhelper.pod:930 +msgid "Debhelper web site." +msgstr "Debhelper-Website" + +#. type: =head1 +#: debhelper.pod:934 dh:878 dh_auto_build:59 dh_auto_clean:61 +#: dh_auto_configure:64 dh_auto_install:109 dh_auto_test:70 dh_bugfiles:141 +#: dh_builddeb:182 dh_clean:195 dh_compress:249 dh_dwz:169 dh_fixperms:170 +#: dh_gencontrol:214 dh_icons:81 dh_install:383 dh_installcatalogs:134 +#: dh_installchangelogs:371 dh_installcron:86 dh_installdeb:425 +#: dh_installdebconf:239 dh_installdirs:137 dh_installdocs:443 +#: dh_installemacsen:145 dh_installexamples:188 dh_installifupdown:78 +#: dh_installinfo:129 dh_installinitramfs:99 dh_installlogcheck:87 +#: dh_installlogrotate:59 dh_installman:426 dh_installmanpages:204 +#: dh_installmenu:96 dh_installmime:69 dh_installmodules:115 dh_installpam:77 +#: dh_installppp:74 dh_installudev:108 dh_installwm:136 dh_installxfonts:96 +#: dh_link:172 dh_lintian:68 dh_listpackages:40 dh_makeshlibs:462 +#: dh_md5sums:124 dh_movefiles:167 dh_perl:194 dh_prep:76 dh_shlibdeps:210 +#: dh_strip:441 dh_testdir:68 dh_testroot:99 dh_usrlocal:142 +msgid "AUTHOR" +msgstr "AUTOR" + +#. type: textblock +#: debhelper.pod:936 dh:880 dh_auto_build:61 dh_auto_clean:63 +#: dh_auto_configure:66 dh_auto_install:111 dh_auto_test:72 dh_builddeb:184 +#: dh_clean:197 dh_compress:251 dh_fixperms:172 dh_gencontrol:216 +#: dh_install:385 dh_installchangelogs:373 dh_installcron:88 dh_installdeb:427 +#: dh_installdebconf:241 dh_installdirs:139 dh_installdocs:445 +#: dh_installemacsen:147 dh_installexamples:190 dh_installifupdown:80 +#: dh_installinfo:131 dh_installinit:421 dh_installlogrotate:61 +#: dh_installman:428 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 +#: dh_installmodules:117 dh_installpam:79 dh_installppp:76 dh_installudev:110 +#: dh_installwm:138 dh_installxfonts:98 dh_link:174 dh_listpackages:42 +#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 +#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 +msgid "Joey Hess <joeyh@debian.org>" +msgstr "Joey Hess <joeyh@debian.org>" #. type: textblock -#: debhelper.pod:969 +#: debhelper-compat-upgrade-checklist.pod:5 +#, fuzzy +#| msgid "" +#| "debhelper-obsolete-compat - List of no longer supported compat levels" msgid "" -"The B<dh_makeshlibs> tool now generates shlibs files with versioned " -"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " -"is now the default." +"debhelper-compat-upgrade-checklist - Upgrade checklist for supported " +"debhelper compat levels" msgstr "" -"Das Werkzeug B<dh_makeshlibs> erzeugt nun standardmäßig Shlibs-Dateien mit " -"versionierter Abhängigkeit. Das bedeutet, dass B<-VUpstream-Version> (alias " -"B<-V>) nun die Voreinstellung ist." +"debhelper-obsolete-compat - Liste nicht mehr unterstützter " +"Kompatibilitätsstufen" #. type: textblock -#: debhelper.pod:973 +#: debhelper-compat-upgrade-checklist.pod:9 msgid "" -"If an unversioned dependency in the shlibs file is wanted, this can be " -"obtained by passing B<-VNone> instead. However, please see " -"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." +"This document is an upgrade checklist of all the supported debhelper compat " +"levels. It also lists all the support debhelper compat levels." msgstr "" -"Falls eine nicht versionierte Abhängigkeit in der Shlibs-Datei gewünscht " -"wird, kann dies stattdessen durch Ãœbergabe von B<-VNone> erreicht werden. " -"Siehe aber auch L<dh_makeshlibs(1)> für die Vorbehalte gegen nicht " -"versionierte Abhängigkeiten." #. type: textblock -#: debhelper.pod:979 +#: debhelper-compat-upgrade-checklist.pod:12 msgid "" -"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " -"instead." +"Information about how to declare the compat level is in L<debhelper(7)/" +"COMPATIBILITY LEVELS>." msgstr "" -"Die Option B<-s> (B<--same-arch>) wurde entfernt. Bitte verwenden Sie " -"stattdessen B<-a> (B<--arch>)." #. type: textblock -#: debhelper.pod:983 +#: debhelper-compat-upgrade-checklist.pod:14 +#, fuzzy +#| msgid "" +#| "If you are upgrading from an earlier compatibility level, please review " +#| "L<debhelper-obsolete-compat(7)>." msgid "" -"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." +"If you are upgrading from a (now) obsolete compat level, then please refer " +"to L<debhelper-obsolete-compat(7)>." msgstr "" -"Der Aufruf von B<dh_clean -k> verursacht jetzt einen Fehler statt einer " -"Warnung, es sei missbilligt." +"Falls Sie ein Upgrade von einer vorhergehenden Kompatibilitätsstufe " +"durchführen, überprüfen Sie bitte L<debhelper-obsolete-compat(7)>." + +#. type: =head2 +#: debhelper-compat-upgrade-checklist.pod:19 +#, fuzzy +#| msgid "This is the lowest supported compatibility level." +msgid "Upgrade checklist for supported compatibility levels" +msgstr "Dies ist die unterste unterstützte Kompatibilitätsstufe." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:21 +msgid "These are the available compatibility levels:" +msgstr "Folgende Kompatibilitätsstufen sind verfügbar:" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:25 +#, fuzzy +#| msgid "v5" +msgid "v15" +msgstr "v5" #. type: textblock -#: debhelper.pod:988 +#: debhelper-compat-upgrade-checklist.pod:27 +#: debhelper-compat-upgrade-checklist.pod:51 strings-kept-translations.pod:9 msgid "" -"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " -"removed. Please use the new name B<--no-stop-on-upgrade>" +"This compatibility level is still open for development; use with caution." msgstr "" -"Die Option B<--no-restart-on-upgrade> in B<dh_installinit> wurde entfernt. " -"Bitte verwenden Sie den neuen Namen B<--no-stop-on-upgrade>." +"Diese Kompatibilitätsstufe ist immer noch für die Entwicklung offen. " +"Verwenden Sie sie mit Vorsicht." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:29 +#, fuzzy +#| msgid "Changes from v4 are:" +msgid "Changes from v14 are:" +msgstr "Änderungen gegenüber v4 sind:" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:33 +#: debhelper-compat-upgrade-checklist.pod:57 +#: debhelper-compat-upgrade-checklist.pod:63 +#: debhelper-compat-upgrade-checklist.pod:68 +#: debhelper-compat-upgrade-checklist.pod:74 +#: debhelper-compat-upgrade-checklist.pod:90 +#: debhelper-compat-upgrade-checklist.pod:95 +#: debhelper-compat-upgrade-checklist.pod:103 +#: debhelper-compat-upgrade-checklist.pod:120 +#: debhelper-compat-upgrade-checklist.pod:128 +#: debhelper-compat-upgrade-checklist.pod:136 +#: debhelper-compat-upgrade-checklist.pod:145 +#: debhelper-compat-upgrade-checklist.pod:151 +#: debhelper-compat-upgrade-checklist.pod:161 +#: debhelper-compat-upgrade-checklist.pod:169 +#: debhelper-compat-upgrade-checklist.pod:175 +#: debhelper-compat-upgrade-checklist.pod:189 +#: debhelper-compat-upgrade-checklist.pod:200 +#: debhelper-compat-upgrade-checklist.pod:214 +#: debhelper-compat-upgrade-checklist.pod:225 +#: debhelper-compat-upgrade-checklist.pod:241 +#: debhelper-compat-upgrade-checklist.pod:251 +#: debhelper-compat-upgrade-checklist.pod:255 +#: debhelper-compat-upgrade-checklist.pod:260 +#: debhelper-compat-upgrade-checklist.pod:265 +#: debhelper-compat-upgrade-checklist.pod:272 +#: debhelper-compat-upgrade-checklist.pod:278 +#: debhelper-compat-upgrade-checklist.pod:286 +#: debhelper-compat-upgrade-checklist.pod:292 +#: debhelper-compat-upgrade-checklist.pod:296 +#: debhelper-compat-upgrade-checklist.pod:301 +#: debhelper-compat-upgrade-checklist.pod:306 +#: debhelper-compat-upgrade-checklist.pod:315 +#: debhelper-compat-upgrade-checklist.pod:331 +#: debhelper-compat-upgrade-checklist.pod:340 +#: debhelper-compat-upgrade-checklist.pod:356 +#: debhelper-compat-upgrade-checklist.pod:364 +#: debhelper-compat-upgrade-checklist.pod:369 +#: debhelper-compat-upgrade-checklist.pod:391 +#: debhelper-compat-upgrade-checklist.pod:397 +#: debhelper-compat-upgrade-checklist.pod:409 +#: debhelper-compat-upgrade-checklist.pod:417 +#: debhelper-compat-upgrade-checklist.pod:423 +#: debhelper-compat-upgrade-checklist.pod:428 +#: debhelper-compat-upgrade-checklist.pod:433 +#: debhelper-compat-upgrade-checklist.pod:438 +#: debhelper-compat-upgrade-checklist.pod:446 +#: debhelper-compat-upgrade-checklist.pod:456 +#: debhelper-compat-upgrade-checklist.pod:466 +#: debhelper-compat-upgrade-checklist.pod:473 +#: debhelper-compat-upgrade-checklist.pod:485 +#: debhelper-compat-upgrade-checklist.pod:490 +#: debhelper-compat-upgrade-checklist.pod:518 +#: debhelper-compat-upgrade-checklist.pod:535 +#: debhelper-compat-upgrade-checklist.pod:540 +#: debhelper-compat-upgrade-checklist.pod:546 +#: debhelper-compat-upgrade-checklist.pod:552 +#: debhelper-compat-upgrade-checklist.pod:557 +#: debhelper-compat-upgrade-checklist.pod:563 +#: debhelper-compat-upgrade-checklist.pod:572 +#: debhelper-compat-upgrade-checklist.pod:582 +#: debhelper-compat-upgrade-checklist.pod:588 +#: debhelper-compat-upgrade-checklist.pod:611 +#: debhelper-compat-upgrade-checklist.pod:618 +#: debhelper-compat-upgrade-checklist.pod:624 +#: debhelper-compat-upgrade-checklist.pod:630 +#: debhelper-compat-upgrade-checklist.pod:636 +#: debhelper-compat-upgrade-checklist.pod:656 +#: debhelper-compat-upgrade-checklist.pod:661 +#: debhelper-compat-upgrade-checklist.pod:668 +#: debhelper-compat-upgrade-checklist.pod:673 +#: debhelper-compat-upgrade-checklist.pod:678 +#: debhelper-compat-upgrade-checklist.pod:686 +#: debhelper-compat-upgrade-checklist.pod:692 +#: debhelper-compat-upgrade-checklist.pod:697 +#: debhelper-compat-upgrade-checklist.pod:702 +#: debhelper-compat-upgrade-checklist.pod:717 +#: debhelper-compat-upgrade-checklist.pod:721 +#: debhelper-compat-upgrade-checklist.pod:729 +#: debhelper-compat-upgrade-checklist.pod:734 debhelper-obsolete-compat.pod:29 +#: debhelper-obsolete-compat.pod:36 debhelper-obsolete-compat.pod:40 +#: debhelper-obsolete-compat.pod:44 debhelper-obsolete-compat.pod:57 +#: debhelper-obsolete-compat.pod:62 debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:74 debhelper-obsolete-compat.pod:89 +#: debhelper-obsolete-compat.pod:93 debhelper-obsolete-compat.pod:98 +#: debhelper-obsolete-compat.pod:102 debhelper-obsolete-compat.pod:114 +#: debhelper-obsolete-compat.pod:119 debhelper-obsolete-compat.pod:124 +#: debhelper-obsolete-compat.pod:129 debhelper-obsolete-compat.pod:143 +#: debhelper-obsolete-compat.pod:148 debhelper-obsolete-compat.pod:152 +#: dh_testroot:36 dh_testroot:41 dh_testroot:46 +msgid "-" +msgstr "-" #. type: textblock -#: debhelper.pod:993 +#: debhelper-compat-upgrade-checklist.pod:35 msgid "" -"There was a bug in the B<doit> (and similar) functions from L<Debian::" -"Debhelper::Dh_Lib> that made them spawn a shell in one particular " -"circumstance. This bug is now removed and will cause helpers that rely on " -"the bug to fail with a \"command not found\"-error." +"The B<dh_auto_install> tool no longer defaults to B<< --destdir=debian/" +"I<package> >> for source packages only producing a single binary. If this " +"behaviour is wanted, the package should explicitly activate the B<single-" +"binary> dh addon (e.g., by adding B<dh-sequence-single-binary> to B<Build-" +"Depends>) or pass B<--destdir> to B<dh_auto_install>." msgstr "" -"Es gab einen Fehler in den B<doit>- und ähnlichen Funktionen von L<Debian::" -"Debhelper::Dh_Lib>, der unter einem bestimmten Umstand zum Öffnen einer " -"Shell führte. Dieser Fehler wurde nun entfernt, wodurch Hilfsprogramme, die " -"auf den Fehler setzen, mit der Meldung »command not found« fehlschlagen." #. type: textblock -#: debhelper.pod:1000 +#: debhelper-compat-upgrade-checklist.pod:41 +#: debhelper-compat-upgrade-checklist.pod:84 msgid "" -"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " -"removed. Please use B<dh_missing> and its corresponding options, which can " -"also see the files installed by other helpers." +"The rationale for this change to avoid \"surprises\" when adding a second " +"binary package later. Previously, debhelper would silently change behaviour " +"often resulting in empty binary packages being uploaded to the archive by " +"mistake. With the new behaviour, the B<single-binary> addon will detect the " +"mismatch and warn the maintainer of what is about to happen." msgstr "" -"B<--list-missing> und B<--fail-missing> in B<dh_install> wurden entfernt. " -"Bitte verwenden Sie B<dh_missing> und die zugehörigen Optionen, die die " -"durch andere Hilfsprogramme installierten Dateien ebenfalls sehen können." + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:49 +msgid "v14" +msgstr "v14" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:53 +msgid "Changes from v13 are:" +msgstr "Änderungen gegenüber v13 sind:" #. type: textblock -#: debhelper.pod:1006 +#: debhelper-compat-upgrade-checklist.pod:59 +#, fuzzy +#| msgid "" +#| "The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> and B<-" +#| "DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some " +#| "reproducibility issues." msgid "" -"The B<dh_installinit> helper no longer installs configuration for the " -"upstart init system. Instead, it will abort the build if it finds an old " -"upstart configuration file. The error is there to remind the package " -"maintainer to ensure the proper removal of the conffiles shipped in previous " -"versions of the package (if any)." +"The B<cmake> buildsystem now passes B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to " +"L<cmake(1)> to avoid some reproducibility issues." msgstr "" -"Das Hilfsprogramm B<dh_installinit> installiert die Konfiguration für das " -"Init-System Upstart nicht mehr. Stattdessen bricht es das Bauen ab, wenn es " -"eine alte Upstart-Konfigurationsdatei findet. Der Fehler soll den " -"Paketbetreuer daran erinnern, sicherzugehen, dass die mit vorherigen " -"Versionen des Pakets mitgelieferten Konfigdateien (falls vorhanden) sauber " -"entfernt werden." +"Das B<cmake>-Bausystem übergibt nun B<-DCMAKE_SKIP_RPATH=ON> und B<-" +"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> an L<cmake(1)>, um einige Probleme mit der " +"Reproduzierbarkeit zu beheben." #. type: textblock -#: debhelper.pod:1014 +#: debhelper-compat-upgrade-checklist.pod:65 +#, fuzzy +#| msgid "" +#| "B<dh_installsystemduser> is now included in the B<dh> standard sequence " +#| "by default." msgid "" -"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" -"maintscript-helper(1)> commands and will error out if the commands appear to " -"be invalid." +"The tool B<dh_installsysusers> is now included in the default sequence. This " +"helper tool will process systemd sysusers files." msgstr "" -"Das Werkzeug B<dh_installdeb> wird die Grundprüfung einiger L<dpkg-" -"maintscript-helper(1)>-Befehle durchführen und sich mit einer Fehlermeldung " -"beenden, falls die Befehle ungültig zu sein scheinen." +"B<dh_installsystemduser> ist nun per Voreinstellung in der Standard-B<dh>-" +"Sequenz enthalten." #. type: textblock -#: debhelper.pod:1020 -msgid "The B<dh_missing> tool will now default to B<--list-missing>." +#: debhelper-compat-upgrade-checklist.pod:70 +msgid "" +"Use of the B<dh_gconf> command in override and hook targets now causes an " +"error. The B<dh_gconf> command has been a no-op for years and was removed " +"in debhelper 13.4." msgstr "" -"Das Werkzeug B<dh_missing> wird nun auf B<--list-missing> voreingestellt." -# https://en.wikipedia.org/wiki/Soname #. type: textblock -#: debhelper.pod:1024 +#: debhelper-compat-upgrade-checklist.pod:76 msgid "" -"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" -"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." +"The B<dh> sequencer will warn if the B<single-binary> addon is implicitly " +"activated to warn maintainers of the pending compat 15 change in " +"B<dh_auto_install>." msgstr "" -"Das Werkzeug B<dh_makeshlibs> wird jetzt nur Bibliotheken an L<dpkg-" -"gensymbols(1)> übergeben, falls die ELF-Binärdatei einen SONAME hat (enthält " -"».so«)." - -#. type: textblock -#: debhelper.pod:1029 -msgid "" -"The B<dh_compress> tool no longer compresses examples (i.e. anything " -"installed in F<</usr/share/doc/I<package>/examples>>.)" -msgstr "" -"Das Werkzeug B<dh_compress> komprimiert keine Beispiele mehr (d. h. alles, " -"was in F<</usr/share/doc/I<Paket>/examples>> installiert ist)." - -#. type: textblock -#: debhelper.pod:1034 -msgid "" -"The standard sequence in B<dh> now includes B<dh_dwz> and " -"B<dh_installinitramfs> by default. This makes the B<dwz> and " -"B<installinitramfs> sequences obsolete and they will now fail with an " -"error. If you want to skip these commands, then please insert an empty " -"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" -msgstr "" -"Die Standardsequenz in B<dh> enthält nun standardmäßig B<dh_dwz> und " -"B<dh_installinitramfs>. Dies macht die Sequenzen B<dwz> und " -"B<installinitramfs> überflüssig und sie werden mit einem Fehler scheitern. " -"Falls Sie diese Befehle überspringen wollen, fügen Sie bitte ein leeres " -"Override-Ziel in F<debian/rules> ein (z.B. I<override_dh_dwz:>)." - -#. type: textblock -#: debhelper.pod:1043 -msgid "" -"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" -"libexecdir> variable and thus relies on the build system default - which " -"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." -msgstr "" -"Die Bausysteme B<Meson> und B<Autoconf> setzen die Variable B<--libexecdir> " -"nicht mehr explizit und verlassen sich auf die Voreinstellung des Bausystems " -"– diese sollte B</usr/libexec> sein (per FHS 3.0, angenommen in der Debian-" -"Richtlinie 4.1.5)." - -#. type: textblock -#: debhelper.pod:1048 -msgid "" -"If a particular upstream package does not use the correct default, the " -"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " -"via the following example:" -msgstr "" -"Falls ein spezielles Paket der Ursprungsautoren nicht die korrekte " -"Voreinstellung benutzt, kann der Parameter oft manuell per " -"L<dh_auto_configure(1)> übergeben werden, etwa wie im folgenden Beispiel:" - -#. type: verbatim -#: debhelper.pod:1052 -#, no-wrap -msgid "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" -msgstr "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" - -#. type: textblock -#: debhelper.pod:1055 -msgid "Note the B<--> before the B<--libexecdir> parameter." -msgstr "Beachten Sie das B<--> vor dem Parameter B<--libexecdir>." - -#. type: textblock -#: debhelper.pod:1059 -msgid "" -"The B<dh_installdeb> tool no longer installs the maintainer provided " -"F<conffiles> file. The file has mostly been obsolete since compatibility " -"level 3, where B<dh_installdeb> began to automatically compute the resulting " -"F<conffiles> control file." -msgstr "" -"Das Werkzeug B<dh_installdeb> installiert die vom Paketbetreuer " -"bereitgestellte F<conffiles>-Datei nicht mehr. Die Datei war seit " -"Kompatibilitätsstufe 3 meistens überflüssig, als B<dh_installdeb> anfing, " -"die resultierende F<conffiles>-Steuerdatei automatisch selbst zu berechnen." - -#. type: textblock -#: debhelper.pod:1066 -msgid "" -"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " -"handling systemd services that have a sysvinit alternative. Both tools must " -"now be used in such a case to ensure the service is properly started under " -"both sysvinit and systemd." -msgstr "" -"Das Werkzeug B<dh_installsystemd> beruht nicht mehr auf B<dh_installinit>, " -"um Systemd-Dienste zu handhaben, die über eine SysVinit-Alternative " -"verfügen. In einem solchen Fall müssen jetzt beide Werkzeuge benutzt werden, " -"um sicherzustellen, dass der Dienst sowohl unter SysVinit als auch unter " -"Systemd sauber gestartet wird." #. type: textblock -#: debhelper.pod:1071 +#: debhelper-compat-upgrade-checklist.pod:79 msgid "" -"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" -"start>) then you will probably need one for B<dh_installsystemd> as well now." +"Maintainers are urged to either explicitly activate the B<single-binary> " +"addon to preserve the existing behaviour (e.g., by adding B<dh-sequence-" +"single-binary> to Build-Depends), or explicitly passing B<--destdir> to " +"B<dh_auto_install> if used and then passing B<--without single-binary> to " +"B<dh> (the latter to silence the warning)." msgstr "" -"Falls Sie eine Methode haben, B<dh_installinit> außer Kraft zu setzen (z. B. " -"indem Sie es mit B<--no-start> aufrufen), dann werden Sie jetzt " -"wahrscheinlich auch eine für B<dh_installsystemd> benötigen." #. type: textblock -#: debhelper.pod:1075 +#: debhelper-compat-upgrade-checklist.pod:92 msgid "" -"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " -"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists B<" -"${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to compat " -"12." +"The B<dh_installalternatives> tool will now be run after B<dh_link> rather " +"than after B<dh_installinitramfs> in the default B<dh> sequence." msgstr "" -"Diese Änderung lässt B<dh_installinit> ein I<misc:Pre-Depends> für B<< init-" -"system-helpers (>= 1.54~) >> einspeisen. Bitte stellen Sie sicher, dass das " -"Paket B<${misc:Pre-Depends}> in seinem Feld B<Pre-Depends> aufführt, bevor " -"Sie ein Upgrade auf Kompatibilitätsstufe 12 durchführen." #. type: textblock -#: debhelper.pod:1082 +#: debhelper-compat-upgrade-checklist.pod:97 msgid "" -"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " -"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " -"packages and not only during the building process. Please set " -"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " -"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." +"The B<dh_installpam> tool will now install PAM configuration files under " +"F<< /usr/lib/pam.d/I<package> >> instead of F<< /etc/pam.d/I<package> >>." msgstr "" -"Das Drittherstellerwerkzeug B<dh_golang> (aus dem Paket B<dh-golang>) " -"akzeptiert jetzt standardmäßig die Variable B<DH_GOLANG_EXCLUDES> für die " -"Quelleninstallation in -dev-Paketen und das nicht nur während des " -"Bauprozesses. Bitte setzen Sie B<DH_GOLANG_EXCLUDES_ALL> auf »false«, um zum " -"vorherigen Verhalten zurückzukehren. Einzelheiten und Beispiele finden Sie " -"unter B<Debian::Debhelper::Buildsystem::golang(3pm)>." #. type: textblock -#: debhelper.pod:1090 +#: debhelper-compat-upgrade-checklist.pod:100 +#, fuzzy +#| msgid "" +#| "In compatibility level 11, this file will trigger an error with a " +#| "reminder about ensuring the proper removal of the upstart file in the " +#| "previous package version. Please consider using the \"rm_conffile\" " +#| "feature from L<dh_installdeb(1)> to ensure the proper removal of previous " +#| "upstart files." msgid "" -"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " -"default." +"Please consider using the \"rm_conffile\" feature from L<dh_installdeb(1)> " +"to ensure the proper removal of previous PAM files." msgstr "" -"B<dh_installsystemduser> ist nun per Voreinstellung in der Standard-B<dh>-" -"Sequenz enthalten." +"In Kompatibilitätsstufe 11 wird diese Datei einen Fehler auslösen, der daran " +"erinnert, dass das ordentliche Entfernen der Upstart-Datei in der vorherigen " +"Paketversion sichergestellt werden soll. Bitte ziehen Sie die Verwendung der " +"Funktionalität »rm_conffile« von L<dh_installdeb(1)> in Betracht, um das " +"ordentliche Entfernen früherer Upstart-Dateien sicherzustellen." #. type: textblock -#: debhelper.pod:1095 +#: debhelper-compat-upgrade-checklist.pod:105 +#, fuzzy +#| msgid "" +#| "The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " +#| "test> when running the test suite. Any override of B<dh_auto_test> that " +#| "passes extra parameters to upstream test runner should be reviewed as " +#| "B<meson test> is not command line compatible with B<ninja test>." msgid "" -"The B<python-distutils> buildsystem is now removed. Please use the third-" -"party build system B<pybuild> instead." +"The B<meson+ninja> and B<cmake> build systems now use B<meson install> and " +"B<cmake --install>, respectively, instead of B<ninja install> and B<make " +"install> in the L<dh_auto_install(1)> call. Any override of " +"B<dh_auto_install> that passes extra parameters to the upstream build system " +"should be reviewed." msgstr "" -"Das Bausystem B<python-distutils> ist jetzt entfernt worden. Bitte verwenden " -"Sie stattdessen das Drittanbieterbausystem B<pybuild>." +"Das Bausystem B<meson+ninja> benutzt anstelle von B<ninja test> nun B<meson " +"test>, wenn die Testsuite ausgeführt wird. Alles, was B<dh_auto_test> außer " +"Kraft setzt und zusätzliche Parameter an das Testausführungsprogramm der " +"Ursprungsautoren übergibt, sollte überprüft werden, da B<meson test> auf der " +"Befehlszeile nicht mit B<ninja test> kompatibel ist." #. type: =item -#: debhelper.pod:1100 +#: debhelper-compat-upgrade-checklist.pod:112 msgid "v13" msgstr "v13" #. type: textblock -#: debhelper.pod:1102 +#: debhelper-compat-upgrade-checklist.pod:114 msgid "This is the recommended mode of operation." msgstr "Dies ist der empfohlene Betriebsmodus." #. type: textblock -#: debhelper.pod:1104 +#: debhelper-compat-upgrade-checklist.pod:116 msgid "Changes from v12 are:" msgstr "Die Änderungen gegenüber v12 sind:" #. type: textblock -#: debhelper.pod:1110 +#: debhelper-compat-upgrade-checklist.pod:122 msgid "" "The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " "test> when running the test suite. Any override of B<dh_auto_test> that " @@ -2508,7 +2800,7 @@ msgstr "" "Befehlszeile nicht mit B<ninja test> kompatibel ist." #. type: textblock -#: debhelper.pod:1118 +#: debhelper-compat-upgrade-checklist.pod:130 msgid "" "All debhelper like tools based on the official debhelper library (including " "B<dh> and the official B<dh_*> tools) no longer accepts abbreviated command " @@ -2523,7 +2815,7 @@ msgstr "" "werden." #. type: textblock -#: debhelper.pod:1126 +#: debhelper-compat-upgrade-checklist.pod:138 msgid "" "The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, B<dh_makeshlibs>, " "B<dh_shlibdeps>) are now only run for arch dependent packages by default (i." @@ -2539,7 +2831,7 @@ msgstr "" "B<dh-sequence-elf-tools> hinzufügen." #. type: textblock -#: debhelper.pod:1135 +#: debhelper-compat-upgrade-checklist.pod:147 msgid "" "The third-party B<gradle> build system (from B<gradle-debian-helper> " "package) now runs the upstream-provided test suite automatically. To " @@ -2551,7 +2843,7 @@ msgstr "" "zu unterbinden." #. type: textblock -#: debhelper.pod:1141 +#: debhelper-compat-upgrade-checklist.pod:153 msgid "" "The B<dh_installman> tool now aborts if it sees conflicting definitions of a " "manpage. This typically happens if the upstream build system is installing " @@ -2571,7 +2863,7 @@ msgstr "" # FIXME: s/resets/reset # FIXME: last line: missing "is" #. type: textblock -#: debhelper.pod:1151 +#: debhelper-compat-upgrade-checklist.pod:163 msgid "" "The B<dh_auto_*> helpers now reset the environment variables B<HOME> and " "common B<XDG_*> variable. Please see description of the environment " @@ -2584,14 +2876,14 @@ msgstr "" # FIXME: Double "between" #. type: textblock -#: debhelper.pod:1155 +#: debhelper-compat-upgrade-checklist.pod:167 msgid "I<This feature changed between debhelper 13 and debhelper 13.2.>" msgstr "" "I<Dieses Funktionsmerkmal hat sich zwischen Debhelper 13 und Debhelper 13.2 " "geändert.>" #. type: textblock -#: debhelper.pod:1159 +#: debhelper-compat-upgrade-checklist.pod:171 msgid "" "The B<dh> command will now error if an override or hook target for an " "obsolete command are present in F<debian/rules> (e.g. " @@ -2602,7 +2894,7 @@ msgstr "" "B<override_dh_systemd_enable:>) vorhanden ist." #. type: textblock -#: debhelper.pod:1165 +#: debhelper-compat-upgrade-checklist.pod:177 msgid "" "The B<dh_missing> command will now default to B<--fail-missing>. This can " "be reverted to a non-fatal warning by explicitly passing B<--list-missing> " @@ -2613,7 +2905,7 @@ msgstr "" "list-missing> übergeben wird, wie es in Kompatibilitätsstufe 12 war." #. type: textblock -#: debhelper.pod:1169 +#: debhelper-compat-upgrade-checklist.pod:181 msgid "" "If you do not want the warning either, please omit the call to " "B<dh_missing>. If you use the B<dh> command sequencer, then you can do this " @@ -2626,7 +2918,7 @@ msgstr "" "oder dem passenden Paket erledigen. Zum Beispiel:" #. type: verbatim -#: debhelper.pod:1174 +#: debhelper-compat-upgrade-checklist.pod:186 #, no-wrap msgid "" " # Disable dh_missing\n" @@ -2638,7 +2930,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:1179 +#: debhelper-compat-upgrade-checklist.pod:191 msgid "" "The B<dh> command sequencer now runs B<dh_installtmpfiles> in the default " "sequence. The B<dh_installtmpfiles> takes over handling of tmpfiles.d " @@ -2651,7 +2943,7 @@ msgstr "" "B<dh_installsystemd> ist nun deaktiviert." #. type: textblock -#: debhelper.pod:1184 +#: debhelper-compat-upgrade-checklist.pod:196 msgid "" "Note that B<dh_installtmpfiles> responds to F<< debian/I<package>.tmpfiles " ">> where B<dh_installsystemd> used a name without the trailing \"s\"." @@ -2661,7 +2953,7 @@ msgstr "" "benutzt hat." #. type: textblock -#: debhelper.pod:1190 +#: debhelper-compat-upgrade-checklist.pod:202 msgid "" "Many B<dh_*> tools now support limited variable expansion via the B<${foo}> " "syntax. In many cases, this can be used to reference paths that contain " @@ -2679,7 +2971,7 @@ msgstr "" "das Paket weiterhin L<dh-exec(1)> benötigt." #. type: textblock -#: debhelper.pod:1197 +#: debhelper-compat-upgrade-checklist.pod:209 msgid "" "Please see L</Substitutions in debhelper config files> for syntax and " "available substitution variables. To B<dh_*> tool writers, substitution " @@ -2692,7 +2984,7 @@ msgstr "" "Funktionen B<filearray> und B<filedoublearray>." #. type: textblock -#: debhelper.pod:1204 +#: debhelper-compat-upgrade-checklist.pod:216 msgid "" "The B<dh> command sequencer will now skip all hook and override targets for " "B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> lists " @@ -2704,7 +2996,7 @@ msgstr "" "aufführt." #. type: textblock -#: debhelper.pod:1208 +#: debhelper-compat-upgrade-checklist.pod:220 msgid "" "Any package relying on these targets to always be run should instead move " "relevant logic out of those targets. E.g. non-test related packaging code " @@ -2718,7 +3010,7 @@ msgstr "" "B<execute_before_dh_auto_install> verschoben werden." #. type: textblock -#: debhelper.pod:1215 +#: debhelper-compat-upgrade-checklist.pod:227 msgid "" "The B<cmake> buildsystem now passes B<-" "DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> to L<cmake(1)> to speed up automatic " @@ -2731,7 +3023,7 @@ msgstr "" "alten Verhalten bleiben möchten, übersteuern Sie den Schalter:" #. type: verbatim -#: debhelper.pod:1219 +#: debhelper-compat-upgrade-checklist.pod:231 #, no-wrap msgid "" " dh_auto_configure -- -DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ...\n" @@ -2741,1105 +3033,1087 @@ msgstr "" "\n" #. type: =item -#: debhelper.pod:1223 -msgid "v14" -msgstr "v14" - -#. type: textblock -#: debhelper.pod:1225 strings-kept-translations.pod:9 -msgid "" -"This compatibility level is still open for development; use with caution." -msgstr "" -"Diese Kompatibilitätsstufe ist immer noch für die Entwicklung offen. " -"Verwenden Sie sie mit Vorsicht." +#: debhelper-compat-upgrade-checklist.pod:235 +msgid "v12" +msgstr "v12" #. type: textblock -#: debhelper.pod:1227 -msgid "Changes from v13 are:" -msgstr "Änderungen gegenüber v13 sind:" +#: debhelper-compat-upgrade-checklist.pod:237 +msgid "Changes from v11 are:" +msgstr "Änderungen gegenüber v11 sind:" #. type: textblock -#: debhelper.pod:1233 +#: debhelper-compat-upgrade-checklist.pod:243 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> and B<-" -"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some " -"reproducibility issues." +"The B<dh_makeshlibs> tool now generates shlibs files with versioned " +"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " +"is now the default." msgstr "" -"Das B<cmake>-Bausystem übergibt nun B<-DCMAKE_SKIP_RPATH=ON> und B<-" -"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> an L<cmake(1)>, um einige Probleme mit der " -"Reproduzierbarkeit zu beheben." +"Das Werkzeug B<dh_makeshlibs> erzeugt nun standardmäßig Shlibs-Dateien mit " +"versionierter Abhängigkeit. Das bedeutet, dass B<-VUpstream-Version> (alias " +"B<-V>) nun die Voreinstellung ist." #. type: textblock -#: debhelper.pod:1237 -#, fuzzy -#| msgid "" -#| "This can cause issues with running binaries directly from the build " -#| "directories as they might now require a manually set B<LD_LIBRARY_PATH>. " -#| "If you need to override this change, we recommend that you try to pass " -#| "the B<-DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the " -#| "problem (leaving B<BUILD_RPATH_USE_ORIGIN> at its new default). This " -#| "should undo the need for B<LD_LIBRARY_PATH> and avoid the reproducibility " -#| "issues on Linux, where B<$ORIGIN> is supported by the runtime linkers." -msgid "" -"This can cause issues with running binaries directly from the build " -"directories as they might now require a manually set B<LD_LIBRARY_PATH>. If " -"you need to override this change, we recommend that you try to pass the B<-" -"DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the problem " -"(leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). This should " -"undo the need for B<LD_LIBRARY_PATH> and avoid the reproducibility issues on " -"Linux, where B<$ORIGIN> is supported by the runtime linkers." -msgstr "" -"Daraus können sich Probleme mit Binärdateien ergeben, welche direkt aus dem " -"Bauverzeichnis heraus aufgeführt werden, weil dafür jetzt ein per Hand " -"gesetztes B<LD_LIBRARY_PATH> erforderlich sein kann. Wenn Sie diese Änderung " -"außer Kraft setzen müssen, empfehlen wir, dass Sie zuerst versuchsweise die " -"B<-DCMAKE_SKIP_RPATH=OFF>-Option übergeben, um zu sehen, ob sie ausreicht, " -"um das Problem zu lösen (sodass B<BUILD_RPATH_USE_ORIGIN> seinen neuen " -"Standardwert behalten kann). Auf diese Weise sollten sich der Bedarf für " -"B<LD_LIBRARY_PATH> erübrigen und die Reproduzierbarkeitsprobleme unter " -"Linux, woB<$ORIGIN> von den Laufzeit-Linkern unterstützt wird, vermieden " -"werden." +#: debhelper-compat-upgrade-checklist.pod:247 +msgid "" +"If an unversioned dependency in the shlibs file is wanted, this can be " +"obtained by passing B<-VNone> instead. However, please see " +"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." +msgstr "" +"Falls eine nicht versionierte Abhängigkeit in der Shlibs-Datei gewünscht " +"wird, kann dies stattdessen durch Ãœbergabe von B<-VNone> erreicht werden. " +"Siehe aber auch L<dh_makeshlibs(1)> für die Vorbehalte gegen nicht " +"versionierte Abhängigkeiten." #. type: textblock -#: debhelper.pod:1247 -#, fuzzy -#| msgid "" -#| "B<dh_installsystemduser> is now included in the B<dh> standard sequence " -#| "by default." -msgid "The tool B<dh_installsysusers> is now included in the default sequence." +#: debhelper-compat-upgrade-checklist.pod:253 +msgid "" +"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " +"instead." msgstr "" -"B<dh_installsystemduser> ist nun per Voreinstellung in der Standard-B<dh>-" -"Sequenz enthalten." - -#. type: =head1 -#: debhelper.pod:1253 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 -#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:92 -#: dh_installinit:205 dh_installinitramfs:60 dh_installman:131 -#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 -#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:104 -#: dh_systemd_start:68 -msgid "NOTES" -msgstr "ANMERKUNGEN" - -#. type: =head2 -#: debhelper.pod:1255 -msgid "Multiple binary package support" -msgstr "Unterstützung mehrerer Binärpakete" +"Die Option B<-s> (B<--same-arch>) wurde entfernt. Bitte verwenden Sie " +"stattdessen B<-a> (B<--arch>)." #. type: textblock -#: debhelper.pod:1257 +#: debhelper-compat-upgrade-checklist.pod:257 msgid "" -"If your source package generates more than one binary package, debhelper " -"programs will default to acting on all binary packages when run. If your " -"source package happens to generate one architecture dependent package, and " -"another architecture independent package, this is not the correct behavior, " -"because you need to generate the architecture dependent packages in the " -"binary-arch F<debian/rules> target, and the architecture independent " -"packages in the binary-indep F<debian/rules> target." +"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." msgstr "" -"Falls Ihr Quellpaket mehr als ein Binärpaket erzeugt, werden die Debhelper-" -"Programme standardmäßig auf alle Paketen einwirken. Falls es vorkommt, dass " -"Ihr Quellpaket ein architekturabhängiges Paket und ein anderes " -"architekturunabhängiges Paket erzeugt, ist dies nicht das korrekte " -"Verhalten, da Sie die architekturabhängigen Pakete im F<debian/rules>-Ziel " -"»binary-arch« erzeugen müssen und die unabhängigen Pakete im F<debian/rules>-" -"Ziel »binary-indep«." +"Der Aufruf von B<dh_clean -k> verursacht jetzt einen Fehler statt einer " +"Warnung, es sei missbilligt." #. type: textblock -#: debhelper.pod:1265 +#: debhelper-compat-upgrade-checklist.pod:262 msgid "" -"To facilitate this, as well as give you more control over which packages are " -"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" -"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " -"are given, debhelper programs default to acting on all packages listed in " -"the control file, with the exceptions below." +"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " +"removed. Please use the new name B<--no-stop-on-upgrade>" msgstr "" -"Um dies zu erleichtern sowie Ihnen mehr Kontrolle darüber zu geben, auf " -"welche Pakete Debhelper-Programme einwirken, akzeptieren alle Debhelper-" -"Programme die Parameter B<-a>, B<-i>, B<-p> und B<-s>. Diese Parameter sind " -"kumulativ. Falls keiner angegeben wurde, wirken Debhelper-Programme " -"standardmäßig auf alle Paketen ein, die in der Datei »control« aufgeführt " -"sind, mit nachfolgenden Ausnahmen." +"Die Option B<--no-restart-on-upgrade> in B<dh_installinit> wurde entfernt. " +"Bitte verwenden Sie den neuen Namen B<--no-stop-on-upgrade>." #. type: textblock -#: debhelper.pod:1271 +#: debhelper-compat-upgrade-checklist.pod:267 msgid "" -"First, any package whose B<Architecture> field in B<debian/control> does not " -"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " -"section 5.6.8>)." +"There was a bug in the B<doit> (and similar) functions from L<Debian::" +"Debhelper::Dh_Lib> that made them spawn a shell in one particular " +"circumstance. This bug is now removed and will cause helpers that rely on " +"the bug to fail with a \"command not found\"-error." msgstr "" -"Zuerst werden alle Pakete, deren B<Architecture>-Feld in B<debian/control> " -"nicht mit der B<DEB_HOST_ARCH>-Architektur übereinstimmt, ausgeschlossen " -"(L<Debian Policy, Abschnitt 5.6.8>)." +"Es gab einen Fehler in den B<doit>- und ähnlichen Funktionen von L<Debian::" +"Debhelper::Dh_Lib>, der unter einem bestimmten Umstand zum Öffnen einer " +"Shell führte. Dieser Fehler wurde nun entfernt, wodurch Hilfsprogramme, die " +"auf den Fehler setzen, mit der Meldung »command not found« fehlschlagen." #. type: textblock -#: debhelper.pod:1275 +#: debhelper-compat-upgrade-checklist.pod:274 msgid "" -"Also, some additional packages may be excluded based on the contents of the " -"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " -"binary package stanzas in B<debian/control>, according to the draft policy " -"at L<https://wiki.debian.org/BuildProfileSpec>." +"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " +"removed. Please use B<dh_missing> and its corresponding options, which can " +"also see the files installed by other helpers." msgstr "" -"Außerdem können einige zusätzliche Paket basierend auf dem Inhalt der " -"Umgebungsvariable B<DEB_BUILD_PROFILES> und den Feldern B<Build-Profiles> in " -"den Absätzen für binäre Pakete in B<debian/control> ausgeschlossen werden. " -"Dies geschieht gemäß der Entwurfrichtlinie unter L<https://wiki.debian.org/" -"BuildProfileSpec>." - -#. type: =head3 -#: debhelper.pod:1280 -msgid "Interaction between package selections and Build-Profiles" -msgstr "Zusammenspiel zwischen Paketauswahl und Bauprofilen" +"B<--list-missing> und B<--fail-missing> in B<dh_install> wurden entfernt. " +"Bitte verwenden Sie B<dh_missing> und die zugehörigen Optionen, die die " +"durch andere Hilfsprogramme installierten Dateien ebenfalls sehen können." #. type: textblock -#: debhelper.pod:1282 +#: debhelper-compat-upgrade-checklist.pod:280 msgid "" -"Build-Profiles affect which packages are included in the package selections " -"mechanisms in debhelper. Generally, the package selections are described " -"from the assumption that all packages are enabled. This section describes " -"how the selections react when a package is disabled due to the active Build-" -"Profiles (or lack of active Build-Profiles)." +"The B<dh_installinit> helper no longer installs configuration for the " +"upstart init system. Instead, it will abort the build if it finds an old " +"upstart configuration file. The error is there to remind the package " +"maintainer to ensure the proper removal of the conffiles shipped in previous " +"versions of the package (if any)." msgstr "" -"Bauprofile beeinflussen, welche Pakete im Paketauswahlmechanismus von " -"Debhelper enthalten sind. Im Allgemeinen wird die Paketauswahl unter der " -"Annahme beschrieben, dass alle Pakete aktiviert sind. Dieser Abschnitt " -"beschreibt, wie die Auswahl reagiert, wenn ein Paket aufgrund des aktiven " -"Bauprofils (oder das Fehlen des aktiven Bauprofils) deaktiviert wird." +"Das Hilfsprogramm B<dh_installinit> installiert die Konfiguration für das " +"Init-System Upstart nicht mehr. Stattdessen bricht es das Bauen ab, wenn es " +"eine alte Upstart-Konfigurationsdatei findet. Der Fehler soll den " +"Paketbetreuer daran erinnern, sicherzugehen, dass die mit vorherigen " +"Versionen des Pakets mitgelieferten Konfigdateien (falls vorhanden) sauber " +"entfernt werden." -#. type: =item -#: debhelper.pod:1290 -msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:288 +msgid "" +"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" +"maintscript-helper(1)> commands and will error out if the commands appear to " +"be invalid." msgstr "" -"-a/--arch, -i/--indep ODER keine Auswahloptionen (ein roher »dh_X«-Aufruf)" +"Das Werkzeug B<dh_installdeb> wird die Grundprüfung einiger L<dpkg-" +"maintscript-helper(1)>-Befehle durchführen und sich mit einer Fehlermeldung " +"beenden, falls die Befehle ungültig zu sein scheinen." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:294 +msgid "The B<dh_missing> tool will now default to B<--list-missing>." +msgstr "" +"Das Werkzeug B<dh_missing> wird nun auf B<--list-missing> voreingestellt." +# https://en.wikipedia.org/wiki/Soname #. type: textblock -#: debhelper.pod:1292 +#: debhelper-compat-upgrade-checklist.pod:298 msgid "" -"The package disabled by Build-Profiles is silently excluded from the " -"selection." +"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" +"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." msgstr "" -"Das durch Bauprofile deaktivierte Paket wird stillschweigend aus der Auswahl " -"ausgeschlossen." +"Das Werkzeug B<dh_makeshlibs> wird jetzt nur Bibliotheken an L<dpkg-" +"gensymbols(1)> übergeben, falls die ELF-Binärdatei einen SONAME hat (enthält " +"».so«)." #. type: textblock -#: debhelper.pod:1295 +#: debhelper-compat-upgrade-checklist.pod:303 msgid "" -"Note you will receive a warning if I<all> packages related to these " -"selections are disabled. In that case, it generally does not make sense to " -"do the build in the first place." +"The B<dh_compress> tool no longer compresses examples (i.e. anything " +"installed in F<</usr/share/doc/I<package>/examples>>.)" msgstr "" -"Beachten Sie, dass Sie eine Warnung bekommen, falls I<alle> zu dieser " -"Auswahl gehörenden Pakete deaktiviert werden. In diesem Fall ist der Bau im " -"Allgemeinen überhaupt sinnlos." +"Das Werkzeug B<dh_compress> komprimiert keine Beispiele mehr (d. h. alles, " +"was in F<</usr/share/doc/I<Paket>/examples>> installiert ist)." -#. type: =item -#: debhelper.pod:1299 -msgid "-N I<package> / --no-package I<package>" -msgstr "-N I<Paket> / --no-package I<Paket>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:308 +msgid "" +"The standard sequence in B<dh> now includes B<dh_dwz> and " +"B<dh_installinitramfs> by default. This makes the B<dwz> and " +"B<installinitramfs> sequences obsolete and they will now fail with an " +"error. If you want to skip these commands, then please insert an empty " +"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" +msgstr "" +"Die Standardsequenz in B<dh> enthält nun standardmäßig B<dh_dwz> und " +"B<dh_installinitramfs>. Dies macht die Sequenzen B<dwz> und " +"B<installinitramfs> überflüssig und sie werden mit einem Fehler scheitern. " +"Falls Sie diese Befehle überspringen wollen, fügen Sie bitte ein leeres " +"Override-Ziel in F<debian/rules> ein (z.B. I<override_dh_dwz:>)." #. type: textblock -#: debhelper.pod:1301 -msgid "The option is accepted and effectively does nothing." -msgstr "Die Option wird akzeptiert und hat keine Wirkung." +#: debhelper-compat-upgrade-checklist.pod:317 +msgid "" +"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" +"libexecdir> variable and thus relies on the build system default - which " +"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." +msgstr "" +"Die Bausysteme B<Meson> und B<Autoconf> setzen die Variable B<--libexecdir> " +"nicht mehr explizit und verlassen sich auf die Voreinstellung des Bausystems " +"– diese sollte B</usr/libexec> sein (per FHS 3.0, angenommen in der Debian-" +"Richtlinie 4.1.5)." -#. type: =item -#: debhelper.pod:1303 -msgid "-p I<package> / --package I<package>" -msgstr "-p I<Paket> / --package I<Paket>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:322 +msgid "" +"If a particular upstream package does not use the correct default, the " +"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " +"via the following example:" +msgstr "" +"Falls ein spezielles Paket der Ursprungsautoren nicht die korrekte " +"Voreinstellung benutzt, kann der Parameter oft manuell per " +"L<dh_auto_configure(1)> übergeben werden, etwa wie im folgenden Beispiel:" + +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:326 +#, no-wrap +msgid "" +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" +"\n" +msgstr "" +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" +"\n" #. type: textblock -#: debhelper.pod:1305 -msgid "The option is accepted, but debhelper will not act on the package." +#: debhelper-compat-upgrade-checklist.pod:329 +msgid "Note the B<--> before the B<--libexecdir> parameter." +msgstr "Beachten Sie das B<--> vor dem Parameter B<--libexecdir>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:333 +msgid "B<Retroactively removed in debhelper/13.5>:" msgstr "" -"Die Option wird akzeptiert, aber Debhelper wird nichts an dem Paket ändern." #. type: textblock -#: debhelper.pod:1309 +#: debhelper-compat-upgrade-checklist.pod:335 +#, fuzzy +#| msgid "" +#| "The B<dh_installdeb> tool no longer installs the maintainer provided " +#| "F<conffiles> file. The file has mostly been obsolete since compatibility " +#| "level 3, where B<dh_installdeb> began to automatically compute the " +#| "resulting F<conffiles> control file." msgid "" -"Note that it does not matter whether a package is enabled or disabled by " +"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+." +msgstr "" +"Das Werkzeug B<dh_installdeb> installiert die vom Paketbetreuer " +"bereitgestellte F<conffiles>-Datei nicht mehr. Die Datei war seit " +"Kompatibilitätsstufe 3 meistens überflüssig, als B<dh_installdeb> anfing, " +"die resultierende F<conffiles>-Steuerdatei automatisch selbst zu berechnen." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:342 +msgid "" +"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " +"handling systemd services that have a sysvinit alternative. Both tools must " +"now be used in such a case to ensure the service is properly started under " +"both sysvinit and systemd." +msgstr "" +"Das Werkzeug B<dh_installsystemd> beruht nicht mehr auf B<dh_installinit>, " +"um Systemd-Dienste zu handhaben, die über eine SysVinit-Alternative " +"verfügen. In einem solchen Fall müssen jetzt beide Werkzeuge benutzt werden, " +"um sicherzustellen, dass der Dienst sowohl unter SysVinit als auch unter " +"Systemd sauber gestartet wird." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:347 +msgid "" +"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" +"start>) then you will probably need one for B<dh_installsystemd> as well now." +msgstr "" +"Falls Sie eine Methode haben, B<dh_installinit> außer Kraft zu setzen (z. B. " +"indem Sie es mit B<--no-start> aufrufen), dann werden Sie jetzt " +"wahrscheinlich auch eine für B<dh_installsystemd> benötigen." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:351 +msgid "" +"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " +"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists " +"B<${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to " +"compat 12." +msgstr "" +"Diese Änderung lässt B<dh_installinit> ein I<misc:Pre-Depends> für B<< init-" +"system-helpers (>= 1.54~) >> einspeisen. Bitte stellen Sie sicher, dass das " +"Paket B<${misc:Pre-Depends}> in seinem Feld B<Pre-Depends> aufführt, bevor " +"Sie ein Upgrade auf Kompatibilitätsstufe 12 durchführen." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:358 +msgid "" +"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " +"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " +"packages and not only during the building process. Please set " +"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " +"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." +msgstr "" +"Das Drittherstellerwerkzeug B<dh_golang> (aus dem Paket B<dh-golang>) " +"akzeptiert jetzt standardmäßig die Variable B<DH_GOLANG_EXCLUDES> für die " +"Quelleninstallation in -dev-Paketen und das nicht nur während des " +"Bauprozesses. Bitte setzen Sie B<DH_GOLANG_EXCLUDES_ALL> auf »false«, um zum " +"vorherigen Verhalten zurückzukehren. Einzelheiten und Beispiele finden Sie " +"unter B<Debian::Debhelper::Buildsystem::golang(3pm)>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:366 +msgid "" +"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " "default." msgstr "" -"Beachten Sie, dass es keine Rolle spielt, ob das Paket standardmäßig " -"aktiviert oder deaktiviert ist." +"B<dh_installsystemduser> ist nun per Voreinstellung in der Standard-B<dh>-" +"Sequenz enthalten." -#. type: =head2 -#: debhelper.pod:1312 -msgid "Automatic generation of Debian install scripts" -msgstr "Automatisches Erzeugen von Debian-Installationsskripten" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:371 +msgid "" +"The B<python-distutils> buildsystem is now removed. Please use the third-" +"party build system B<pybuild> instead." +msgstr "" +"Das Bausystem B<python-distutils> ist jetzt entfernt worden. Bitte verwenden " +"Sie stattdessen das Drittanbieterbausystem B<pybuild>." + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:376 +msgid "v11" +msgstr "v11" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:378 +msgid "This mode is discouraged." +msgstr "Von diesem Modus wird abgeraten." #. type: textblock -#: debhelper.pod:1314 +#: debhelper-compat-upgrade-checklist.pod:380 msgid "" -"Some debhelper commands will automatically generate parts of Debian " -"maintainer scripts. If you want these automatically generated things " -"included in your existing Debian maintainer scripts, then you need to add " -"B<#DEBHELPER#> to your scripts, in the place the code should be added. " -"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " -"B<dh_installdeb>." +"The compat 11 is discouraged for new packages as it suffers from feature " +"interaction between L<dh_installinit> and L<dh_installsystemd> causing " +"services to not run correctly in some cases. Please consider using " +"compatibility mode 10 or 12 instead. More details about the issue are " +"available in Debian#887904 and L<https://lists.debian.org/debian-" +"release/2019/04/msg01442.html>." msgstr "" -"Einige Debhelper-Befehle werden automatisch Teile der Debian-Betreuerskripte " -"erzeugen. Falls Sie diese automatisch erzeugten Dinge in Ihre existierenden " -"Debian-Betreuerskripte einfügen möchten, dann müssen Sie Ihren Skripten " -"B<#DEBHELPER#> an der Stelle platzieren, an die der Kode hinzugefügt werden " -"soll. B<#DEBHELPER#> wird bei der Ausführung durch beliebigen automatisch " -"erzeugten Kode ersetzt, wenn Sie B<dh_installdeb> ausführen." +"Von der Kompatibilitätsstufe 11 wird für neue Pakete abgeraten, da sie vvon " +"Funktionalitätswechselwirkungen zwischen L<dh_installinit> und " +"L<dh_installsystemd> betroffen ist, die dazu führen, dass in manchen Fällen " +"Dienste nicht korrekt laufen. Bitte erwägen Sie, stattdessen die " +"Kompatibilitätsstufen 10 oder 12 zu benutzen. Weitere Einzelheiten über das " +"Thema sind in Debian#887904 und L<https://lists.debian.org/debian-" +"release/2019/04/msg01442.html> verfügbar." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:387 +msgid "Changes from v10 are:" +msgstr "Änderungen gegenüber v10 sind:" #. type: textblock -#: debhelper.pod:1321 +#: debhelper-compat-upgrade-checklist.pod:393 msgid "" -"If a script does not exist at all and debhelper needs to add something to " -"it, then debhelper will create the complete script." +"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " +"generates maintainer scripts for those files. Please use the new " +"B<dh_installsystemd> helper." msgstr "" -"Falls ein Skript noch gar nicht existiert und Debhelper etwas darin " -"hinzufügen muss, dann wird Debhelper das komplette Skript erstellen." +"B<dh_installinit> installiert keine F<service>- oder F<tmpfile>-Dateien " +"mehr. Es erstellt auch keine Betreuerskripte dafür. Bitte verwenden Sie das " +"neue Hilfsprogramm B<dh_installsystemd>." #. type: textblock -#: debhelper.pod:1324 +#: debhelper-compat-upgrade-checklist.pod:399 msgid "" -"All debhelper commands that automatically generate code in this way let it " -"be disabled by the -n parameter (see above)." +"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " +"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " +"sequence for B<dh> has also been removed. If you need to disable the " +"B<dh_installsystemd> helper tool, please use an empty override target." msgstr "" -"Alle Debhelper-Befehle, die auf diese Art automatisch Kode erzeugen, lassen " -"ihn durch den Parameter -n deaktiviert (siehe oben)." +"Die Hilfsprogramme B<dh_systemd_enable> und B<dh_systemd_start> wurden durch " +"das neue Hilfsprogramm B<dh_installsystemd> ersetzt. Aus demselben Grund " +"wurde auch die B<systemd>-Sequenz für B<dh> entfernt. Wenn Sie das " +"Hilfswerkzeug B<dh_installsystemd> deaktivieren möchten, verwenden Sie bitte " +"ein leeres Override-Ziel." #. type: textblock -#: debhelper.pod:1327 +#: debhelper-compat-upgrade-checklist.pod:405 msgid "" -"Note that the inserted code will be shell code, so you cannot directly use " -"it in a Perl script. If you would like to embed it into a Perl script, here " -"is one way to do that (note that I made sure that $1, $2, etc are set with " -"the set command):" +"Please note that the B<dh_installsystemd> tool has a slightly different " +"behaviour in some cases (e.g. when using the B<--name> parameter)." msgstr "" -"Beachten Sie, dass der eingefügte Kode Shell-Kode sein wird. Sie können ihn " -"daher nicht direkt in einem Perl-Skript verwenden. Falls Sie ihn in ein Perl-" -"Skript einbetten wollen, wird hier eine Möglichkeit dafür beschrieben " -"(beachten Sie, dass über den Befehl »set« sichergestellt wird, dass $1, $2, " -"etc. gesetzt sind):" +"Bitte beachten Sie, dass sich das Werkzeug B<dh_installsystemd> in manchen " +"Fällen (z.B. bei der Verwendung des Parameters B<--name>) geringfügig anders " +"verhält." -#. type: verbatim -#: debhelper.pod:1332 -#, no-wrap +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:411 msgid "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"The debhelper script failed with error code: ${exit_code}\");\n" -" } else {\n" -" die(\"The debhelper script was killed by signal: ${signal}\");\n" -" }\n" -" }\n" -"\n" +"B<dh_installdirs> no longer creates debian/I<package> directories unless " +"explicitly requested (or it has to create a subdirectory in it)." msgstr "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"Das Debhelper-Skript scheiterte mit folgendem Fehlercode: ${exit_code}\");\n" -" } else {\n" -" die(\"Das Debhelper-Skript wurde per Signal abgebrochen: ${signal}\");\n" -" }\n" -" }\n" -"\n" +"B<dh_installdirs> erstellt keine debian/I<Paket>-Verzeichnisse mehr, es sei " +"denn, dies wird ausdrücklich verlangt (oder es muss ein Unterverzeichnis " +"darin erstellt werden)." -#. type: =head2 -#: debhelper.pod:1345 -msgid "Automatic generation of miscellaneous dependencies." -msgstr "Automatisches Erzeugen verschiedener Abhängigkeiten" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:415 +msgid "The vast majority of all packages will be unaffected by this change." +msgstr "" +"Die große Mehrheit aller Pakete wird von dieser Änderung nicht betroffen " +"sein." #. type: textblock -#: debhelper.pod:1347 +#: debhelper-compat-upgrade-checklist.pod:419 msgid "" -"Some debhelper commands may make the generated package need to depend on " -"some other packages. For example, if you use L<dh_installdebconf(1)>, your " -"package will generally need to depend on debconf. Or if you use " -"L<dh_installxfonts(1)>, your package will generally need to depend on a " -"particular version of xutils. Keeping track of these miscellaneous " -"dependencies can be annoying since they are dependent on how debhelper does " -"things, so debhelper offers a way to automate it." +"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" +"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " +"or B<cmake>) are unaffected by this change." msgstr "" -"Einige Debhelper-Befehle könnten dazu führen, dass das erzeugte Paket von " -"einigen anderen Paketen abhängt. Falls Sie beispielsweise " -"L<dh_installdebconf(1)> benutzen, wird Ihr Paket von Debconf abhängen " -"müssen. Oder, falls Sie L<dh_installxfonts(1)> verwenden, wird ihr Paket " -"generell von einer bestimmten Version der Xutils abhängen. Den Ãœberblick " -"über diese verschiedenen Abhängigkeiten zu behalten kann lästig sein, da sie " -"von Debhelpers Arbeitsweise abhängen, weswegen Debhelper eine Möglichkeit " -"bietet, sie zu automatisieren." +"Das B<makefile>-Bausystem übergibt nun B<INSTALL=\"install --strip-" +"program=true\"> an L<make(1)>. Davon abgeleitete Bausysteme (z. B. " +"B<configure> oder B<cmake>) sind von dieser Änderung nicht betroffen." #. type: textblock -#: debhelper.pod:1355 +#: debhelper-compat-upgrade-checklist.pod:425 msgid "" -"All commands of this type, besides documenting what dependencies may be " -"needed on their man pages, will automatically generate a substvar called B<" -"${misc:Depends}>. If you put that token into your F<debian/control> file, it " -"will be expanded to the dependencies debhelper figures you need." +"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" +"configure>." msgstr "" -"Für jeden Befehl werden die benötigten Abhängigkeiten in den Handbuchseiten " -"dokumentiert. Daneben wird automatisch eine »substvar« erzeugt, die B<${misc:" -"Depends}> genannt wird. Falls Sie eine Markierung in Ihre F<debian/control>-" -"Datei schreiben, wird es sie zu den Abhängigkeiten expandieren, von denen " -"Debhelper findet, dass Sie sie benötigen." +"Das B<autoconf>-Bausystem übergibt nun B<--runstatedir=/run> an F<./" +"configure>." #. type: textblock -#: debhelper.pod:1360 +#: debhelper-compat-upgrade-checklist.pod:430 msgid "" -"This is entirely independent of the standard B<${shlibs:Depends}> generated " -"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " -"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " -"guesses don't match reality." +"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " +"L<cmake(1)>." msgstr "" -"Dies ist gänzlich unabhängig von dem vorgegebenen B<${shlibs:Depends}>, das " -"durch L<dh_makeshlibs(1)> erzeugt wurde, und den durch L<dh_perl(1)> " -"erzeugten B<${perl:Depends}>. Sie können sich entscheiden, keines davon " -"benutzen, falls die Einschätzung von Debhelper nicht der Wirklichkeit " -"entspricht." +"Das B<cmake>-Bausystem übergibt nun B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> an " +"L<cmake(1)>." -#. type: =head2 -#: debhelper.pod:1365 -msgid "Package build directories" -msgstr "Paketbauverzeichnisse" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:435 +msgid "" +"B<dh_installman> will now prefer detecting the language from the path name " +"rather than the extension." +msgstr "" +"B<dh_installman> wird nun vorzugsweise die Sprache anhand des Pfadnamens " +"statt der Erweiterung bestimmen." #. type: textblock -#: debhelper.pod:1367 +#: debhelper-compat-upgrade-checklist.pod:440 msgid "" -"By default, all debhelper programs assume that the temporary directory used " -"for assembling the tree of files in a package is debian/I<package>." +"B<dh_auto_install> will now only create the destination directory it needs. " +"Previously, it would create the package build directory for all packages. " +"This will not affect packages that only build with debhelper commands, but " +"it may expose bugs in commands not included in debhelper." msgstr "" -"Standardmäßig gehen alle Debhelper-Programme davon aus, dass das temporäre " -"Verzeichnis, das zum Zusammenbau des Dateibaums in einem Paket benutzt wird, " -"debian/I<Paket> ist." +"B<dh_auto_install> wird jetzt nur das Zielverzeichnis erstellen, das es " +"benötigt. Vorher hätte es die Bauverzeichnisse für alle Pakete erstellt. " +"Dies hat keine Auswirkungen auf Pakete, die nur mit Debhelper-Befehlen " +"bauen, es könnte aber Programmfehler in Befehlen offenlegen, die nicht in " +"Debhelper enthalten sind." #. type: textblock -#: debhelper.pod:1370 +#: debhelper-compat-upgrade-checklist.pod:448 msgid "" -"Sometimes, you might want to use some other temporary directory. This is " -"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/tmp>" -"\", will use B<debian/tmp> as the temporary directory. Note that if you use " -"B<-P>, the debhelper programs can only be acting on a single package at a " -"time. So if you have a package that builds many binary packages, you will " -"need to also use the B<-p> flag to specify which binary package the " -"debhelper program will act on." +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now error out if their config has a pattern that does not " +"match anything or reference a path that does not exist." msgstr "" -"Manchmal wollen Sie möglicherweise ein anderes temporäres Vezeichnis " -"benutzen. Dies wird durch den Schalters B<-P> unterstützt. »B<dh_installdocs " -"-Pdebian/tmp>« wird zum Beispiel B<debian/tmp> als temporäres Verzeichnis " -"nutzen. Beachten Sie, dass die Debhelper-Programme nur auf ein einzelnes " -"Paket auf einmal einwirken können, wenn Sie B<-P> verwenden. Falls Sie ein " -"Paket haben, das mehrere Binärpakete baut, müssen Sie zusätzlich den " -"Schalter B<-p> einsetzen, um anzugeben, auf welches Binärpaket sich das " -"Debhelper-Programm auswirkt." +"Die Hilfsprogramme B<dh_installdocs>, B<dh_installexamples>, " +"B<dh_installinfo> und B<dh_installman> beenden sich jetzt mit Fehlermeldung, " +"falls ihre Konfiguration ein Muster aufweist, das zu nichts passt oder sich " +"auf einen Pfad bezieht, den es nicht gibt." -#. type: =head2 -#: debhelper.pod:1378 -msgid "udebs" -msgstr "Udebs" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:452 +msgid "" +"Known exceptions include building with the B<nodoc> profile, where the above " +"tools will silently permit failed matches where the patterns are used to " +"specify documentation." +msgstr "" +"Bekannte Ausnahmen umfassen das Bauen mit dem Profil B<nodoc>, bei dem die " +"obigen Werkzeuge stillschweigend fehlschlagende Suchen mit Mustern erlauben," +"welche zur Angabe von Dokumentation verwendet werden." #. type: textblock -#: debhelper.pod:1380 +#: debhelper-compat-upgrade-checklist.pod:458 msgid "" -"Debhelper includes support for udebs. To create a udeb with debhelper, add " -"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " -"Debhelper will try to create udebs that comply with debian-installer policy, " -"by making the generated package files end in F<.udeb>, not installing any " -"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " -"and F<config> scripts, etc." +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " +"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " +"B<dh_install>." msgstr "" -"Debhelper beinhaltet Unterstützung für Udebs. Um ein Udeb mit Debhelper zu " -"erstellen, fügen Sie dem Absatz des Pakets in F<debian/control> »B<Package-" -"Type: udeb>« hinzu. Debhelper wird versuchen, Udebs zu erstellen, die der " -"Debian-Installer-Richtlinie entsprechen, indem die erzeugten Paketdateien " -"mit F<.udeb> enden, keine Dokumentation in ein Udeb installiert wird und " -"F<preinst>-, F<postrm>-, F<prerm>- sowie F<config>-Skripte etc. übersprungen " -"werden." +"Die Hilfsprogramme B<dh_installdocs>, B<dh_installexamples>, " +"B<dh_installinfo> und B<dh_installman> akzeptieren nun den Parameter B<--" +"sourcedir> mit derselben Bedeutung wie B<dh_install>. Ãœberdies fallen sie " +"jetzt, so wie B<dh_install>, auf F<debian/tmp> zurück." -#. type: =head1 -#: debhelper.pod:1387 -msgid "ENVIRONMENT" -msgstr "UMGEBUNGSVARIABLEN" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:463 +msgid "" +"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " +"incorrectly ignore B<--sourcedir>." +msgstr "" +"Migrationshinweis: Ein Fehler in Debhelper 11 bis 11.1.5 führte " +"fälschlicherweise dazu, dass B<dh_installinfo> B<--sourcedir> ignoriert hat." +# FIXME s/can emulate it/can get an emulation of it/ (or emulate it) #. type: textblock -#: debhelper.pod:1389 +#: debhelper-compat-upgrade-checklist.pod:468 msgid "" -"This section describes some of the environment variables that influences the " -"behaviour of debhelper or which debhelper interacts with." +"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)." msgstr "" -"Dieser Abschnitt beschreibt einige der Umgebungsvariablen, die das Verhalten " -"von Debhelper beeinflussen oder mit denen Debhelper interagiert." +"Die Bausysteme B<perl-makemaker> und B<perl-build> übergeben B<-I.> nicht " +"mehr an Perl. Pakete, die dieses Verhalten immer noch benötigen, können es " +"durch Verwendung der Umgebungsvariable B<PERL5LIB> emulieren, z. B. durch " +"Eintragen von B<export PERL5LIB=.> in ihre »debian/rules«-Datei (oder " +"dergleichen)." #. type: textblock -#: debhelper.pod:1392 +#: debhelper-compat-upgrade-checklist.pod:475 msgid "" -"It is important to note that these must be actual environment variables in " -"order to affect the behaviour of debhelper (not simply F<Makefile> " -"variables). To specify them properly in F<debian/rules>, be sure to " -"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." +"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " +"any of the B<dh_auto_*> tools. It was added as a temporary work around to " +"avoid a lot of packages failing to build at the same time." msgstr "" -"Es ist wichtig, darauf hinzuweisen, dass es echte Umgebungsvariablen (nicht " -"nur einfache F<Makefile>-Variablen) sein müssen, damit dies korrekt " -"funktioniert. Um sie ordnungsgemäß in F<debian/rules> anzugeben, müssen Sie " -"sicherstellen, dass sie »B<export>«iert werden, zum Beispiel »B<export " -"DH_VERBOSE>«." +"B<PERL_USE_UNSAFE_INC> wird jetzt von B<dh> oder den B<dh_auto_*>-Werkzeugen " +"nicht mehr gesetzt. Sie diente als Ãœbergangslösung, um zu verhindern, dass " +"das gleichzeitige Bauen vieler Pakete scheitert." -#. type: =item -#: debhelper.pod:1399 -msgid "B<DH_VERBOSE>" -msgstr "B<DH_VERBOSE>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:480 +msgid "" +"Note this item will eventually become obsolete as upstream intends to drop " +"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " +"drops support for it, then this variable will be removed retroactively from " +"existing compat levels as well." +msgstr "" +"Beachten Sie, dass sie irgendwann komplett hinfällig wird, da die " +"Ursprungsautoren beabsichtigen, die Unterstützung für die Umgebungsvariable " +"B<PERL_USE_UNSAFE_INC> einzustellen. Wenn es so weit ist, wird diese " +"Variable nachträglich auch aus bestehenden Kompatibilitätsstufen entfernt." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:487 +msgid "" +"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " +"non-zero exit from analysing a given file." +msgstr "" +"Das Hilfsprogramm B<dh_makeshlibs> wird nun mit einer Fehlermeldung beendet, " +"falls Objdump nach der Auswertung einer gegebenen Datei einen Rückgabewert " +"ungleich null zurückliefert." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:492 +msgid "" +"The B<dh_installdocs> and B<dh_installexamples> tools may now install " +"I<most> of the documentation in a different path to comply with the " +"recommendation from Debian policy §12.3 (since version 3.9.7)." +msgstr "" +"Die Werkzeuge B<dh_installdocs> und B<dh_installexamples> können jezt die " +"I<meiste> Dokumentation in einem anderen Pfad installieren, um die " +"Empfehlung der Debian-Richtlinien §12.3 (seit Version 3.9.7) zu erfüllen." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:496 +msgid "" +"Note that if a given source package only contains a single binary package in " +"F<debian/control> or none of the packages are I<-doc> packages, then this " +"change is not relevant for that source package and you can skip to the next " +"change." +msgstr "" +"Beachten Sie, dass diese Änderung nicht für dieses Quellpaket relevant ist " +"und Sie zur nächsten Änderung springen können, falls ein angegebenes " +"Quellpaket nur ein einziges Binärpaket in F<debian/control> enthält oder " +"keine I<-doc>-Pakete dabei sind." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:501 +msgid "" +"By default, these tools will now attempt to determine a \"main package for " +"the documentation\" (called a I<doc-main-package> from here on) for every I<-" +"doc> package. If they find such a I<doc-main-package>, they will now " +"install the documentation into the path F<< /usr/share/doc/I<doc-main-" +"package> >> in the given doc package. I.e. the path can change but the " +"documentation is still shipped in the I<-doc> package." +msgstr "" +"Standardmäßig werden diese Werkzeuge nun versuchen, ein »Hauptpaket für die " +"Dokumentation« (ab hier I<Hauptdokumentationspaket> genannt) für jedes I<-" +"doc>-Paket zu bestimmen. Falls sie ein derartiges " +"I<Hauptdokumentationspaket> finden, werden sie nun die Dokumentation in den " +"Pfad F<< /usr/share/doc/I<Hauptdokumentationspaket> >> im angegebenen " +"Dokumentationspaket installieren. Das heißt, der Pfad kann sich ändern, aber " +"die Dokumentation wird immer noch im I<-doc>-Paket mitgeliefert." #. type: textblock -#: debhelper.pod:1401 +#: debhelper-compat-upgrade-checklist.pod:509 msgid "" -"Set to B<1> to enable verbose mode. Debhelper will output every command it " -"runs. Also enables verbose build logs for some build systems like autoconf." +"The B<--doc-main-package> option can be used when the auto-detection is " +"insufficient or to reset the path to its previous value if there is a reason " +"to diverge from Debian policy recommendation." msgstr "" -"auf B<1> gesetzt, um den Modus mit detailreicher Ausgabe zu aktivieren. " -"Debhelper wird jeden von ihm ausgeführten Befehl ausgeben. Außerdem wird die " -"detailreiche Ausgabe von Bauprotokollen für einige Bausysteme wie Autoconf " -"aktiviert." - -#. type: =item -#: debhelper.pod:1404 -msgid "B<DH_QUIET>" -msgstr "B<DH_QUIET>" +"Die Option B<--doc-main-package> kann benutzt werden, wenn die automatische " +"Erkennung unzureichend ist oder um den Pfad auf seinen vorherigen Wert " +"zurückzusetzen, falls es einen Grund gibt, von der Empfehlung der Debian-" +"Richlinien abzuweichen." #. type: textblock -#: debhelper.pod:1406 +#: debhelper-compat-upgrade-checklist.pod:513 msgid "" -"Set to B<1> to enable quiet mode. Debhelper will not output commands calling " -"the upstream build system nor will dh print which subcommands are called and " -"depending on the upstream build system might make that more quiet, too. " -"This makes it easier to spot important messages but makes the output quite " -"useless as buildd log. Ignored if DH_VERBOSE is also set." +"Some documentation will not be affected by this change. These exceptions " +"include the copyright file, changelog files, README.Debian, etc. These " +"files will still be installed in the path F<< /usr/share/doc/I<package> >>." msgstr "" -"auf B<1> gesetzt, um den detailarmen Modus zu aktivieren. Debhelper wird " -"weder Befehle ausgeben, die das Bausystem der Ursprungsautoren aufrufen, " -"noch wird Dh ausgeben, welche Unterbefehle aufgerufen werden. Abhängig vom " -"benutzten Bausystem wird auch dieses weniger Details ausgeben. Dadurch wird " -"es einfacher, wichtige Nachrichten zu erkennen, die Ausgabe wird jedoch als " -"Buildd-Protokoll ziemlich nutzlos. Falls DH_VERBOSE ebenfalls gesetzt ist, " -"wird diese Einstellung ignoriert." - -#. type: =item -#: debhelper.pod:1413 -msgid "B<DH_COMPAT>" -msgstr "B<DH_COMPAT>" +"Manche Dokumentation wird von dieser Änderung nicht beeinflusst. Diese " +"Ausnahmen umfassen die Copyright-Dateien, README.Debian usw. Diese Dateien " +"werden weiterhin im Pfad F<< /usr/share/doc/I<Paket> >> installiert." #. type: textblock -#: debhelper.pod:1415 +#: debhelper-compat-upgrade-checklist.pod:520 msgid "" -"Temporarily specifies what compatibility level debhelper should run at, " -"overriding any value specified via Build-Depends on debhelper-compat or via " -"the F<debian/compat> file." +"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " +"to determine which files to process. Instead, they open the file and look " +"for an ELF header to determine if a given file is an shared object or an ELF " +"executable." msgstr "" -"gibt vorübergehend an, auf welcher Kompatibilitätsstufe Debhelper ausgeführt " -"werden soll und setzt dabei jeden Wert außer Kraft, der über Build-Depends " -"in Debhelper-compat oder über die Datei F<debian/compat> angegeben wurde." - -#. type: =item -#: debhelper.pod:1419 -msgid "B<DH_NO_ACT>" -msgstr "B<DH_NO_ACT>" +"Die Werkzeuge B<dh_strip> und B<dh_shlibdeps> verwenden keine " +"Dateinamenmuster mehr, um zu bestimmen, welche Dateien verarbeitet werden. " +"Stattdessen öffnen sie die Datei und suchen nach einem ELF-Header, um zu " +"bestimmen, ob eine übergebene Datei ein gemeinsam benutztes Objekt oder ein " +"ausführbares binäres Programm ist." #. type: textblock -#: debhelper.pod:1421 -msgid "Set to B<1> to enable no-act mode." -msgstr "auf B<1> gesetzt, um Modus ohne Aktion zu aktivieren." +#: debhelper-compat-upgrade-checklist.pod:525 +msgid "This change may cause the tools to process more files than previously." +msgstr "" +"Diese Änderung kann dazu führen, dass mehr Dateien als vorher verarbeitet " +"werden." #. type: =item -#: debhelper.pod:1423 -msgid "B<DH_OPTIONS>" -msgstr "B<DH_OPTIONS>" +#: debhelper-compat-upgrade-checklist.pod:529 +msgid "v10" +msgstr "v10" #. type: textblock -#: debhelper.pod:1425 -msgid "" -"All debhelper tools will parse command line arguments listed in this " -"variable before any command option (as if they had been prepended to the " -"command line arguments). Unfortunately, some third-party provided tools may " -"not support this variable and will ignore these command line arguments." -msgstr "" -"Alle Debhelper-Werkzeuge werden die in dieser Variable aufgeführten " -"Argumente vor ihren eigenen Befehlszeilenargumenten auswerten (als ob sie " -"den Befehlszeilenargumenten vorangestellt worden wären). Leider unterstützen " -"einige von Dritten bereitgestellte Werkzeuge diese Variable möglicherweise " -"nicht und werden diese Befehlszeilenargumente ignorieren." +#: debhelper-compat-upgrade-checklist.pod:531 +msgid "Changes from v9 are:" +msgstr "Änderungen gegenüber v9 sind:" #. type: textblock -#: debhelper.pod:1430 +#: debhelper-compat-upgrade-checklist.pod:537 msgid "" -"When using L<dh(1)>, it can be passed options that will be passed on to each " -"debhelper command, which is generally better than using DH_OPTIONS." +"B<dh_installinit> will no longer install a file named debian/I<package> as " +"an init script." msgstr "" -"Wenn L<dh(1)> benutzt wird, können ihm Optionen übergeben werden, die es an " -"jeden Debhelper-Befehl weitergibt, was im Allgemeinen besser ist, als " -"DH_OPTIONS zu verwenden." - -#. type: =item -#: debhelper.pod:1433 -msgid "B<DH_ALWAYS_EXCLUDE>" -msgstr "B<DH_ALWAYS_EXCLUDE>" +"B<dh_installinit> wird keine Datei namens debian/I<Paket> mehr als Init-" +"Skript installieren." #. type: textblock -#: debhelper.pod:1435 +#: debhelper-compat-upgrade-checklist.pod:542 msgid "" -"If set, this adds the value the variable is set to to the B<-X> options of " -"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " -"B<rm -rf> anything that matches the value in your package build tree." +"B<dh_installdocs> will error out if it detects links created with --link-doc " +"between packages of architecture \"all\" and non-\"all\" as it breaks " +"binNMUs." msgstr "" -"Falls gesetzt, fügt dies den Wert der Variablen den B<-X>-Optionen aller " -"Befehle hinzu, welche die Option B<-X> unterstützen. Außerdem wird " -"B<dh_builddeb> für alles in Ihrem Paketbaubaum, das dem Wert entspricht, " -"B<rm -rf> ausführen." +"B<dh_installdocs> wird mit einem Fehler fehlschlagen, falls es Links " +"entdeckt, die mit --link-doc zwischen Paketen der Architektur »all« und " +"nicht-»all« erzeugt wurden, da d binNMUs beschädigt." #. type: textblock -#: debhelper.pod:1439 +#: debhelper-compat-upgrade-checklist.pod:548 msgid "" -"This can be useful if you are doing a build from a CVS source tree, in which " -"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " -"sneaking into the package you build. Or, if a package has a source tarball " -"that (unwisely) includes CVS directories, you might want to export " -"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " -"your package is built." +"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." +"shlibs file. This is now done by B<dh_makeshlibs> instead." msgstr "" -"Dies kann nützlich sein, wenn Sie aus einem CVS-Quellverzeichnisbaum bauen. " -"In diesem Fall verhindert das Setzen von B<DH_ALWAYS_EXCLUDE=CVS>, dass sich " -"irgendwelche CVS-Verzeichnisse in das Paket einschleichen, das Sie bauen. " -"Oder, falls ein Paket einen Quell-Tarball hat, der (unklugerweise) CVS-" -"Verzeichnisse enthält, möchten Sie möglicherweise B<DH_ALWAYS_EXCLUDE=CVS> " -"in F<debian/rules> exportieren, damit es wirksam ist, wo auch immer Ihr " -"Paket gebaut wird." +"B<dh_installdeb> installiert keine vom Paketbetreuer bereitgestellte debian/" +"I<Paket>.shlibs-Datei mehr. Dies wird stattdessen von B<dh_makeshlibs> " +"erledigt." #. type: textblock -#: debhelper.pod:1446 +#: debhelper-compat-upgrade-checklist.pod:554 msgid "" -"Multiple things to exclude can be separated with colons, as in " -"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" +"B<dh_installwm> refuses to create a broken package if no man page can be " +"found (required to register for the x-window-manager alternative)." msgstr "" -"Mehrere Dinge, die ausgeschlossen werden sollen, können mit Doppelpunkten " -"getrennt werden, wie in B<DH_ALWAYS_EXCLUDE=CVS:.svn>." - -#. type: =item -#: debhelper.pod:1449 -msgid "B<DH_EXTRA_ADDONS>" -msgstr "B<DH_EXTRA_ADDONS>" +"B<dh_installwm> weigert sich, ein beschädigtes Paket zu erstellen, falls " +"keine Handbuchseite gefunden wird (erforderlich, um die Alternative zum X-" +"Window-Manager zu registrieren)." #. type: textblock -#: debhelper.pod:1451 +#: debhelper-compat-upgrade-checklist.pod:559 msgid "" -"If set, this adds the specified dh addons to be run in the appropriate " -"places in the sequence of commands. This is equivalent to specifying the " -"addon to run with the --with flag in the debian/rules file. Any --without " -"calls specifying an addon in this environment variable will not be run." +"Debhelper will default to B<--parallel> for all buildsystems that support " +"parallel building. This can be disabled by using either B<--no-parallel> or " +"passing B<--max-parallel> with a value of 1." msgstr "" -"Falls gesetzt, fügt dies die angegebenen Dh-Erweiterungen hinzu, die an den " -"entsprechenden Stellen in den Befehlssequenzen ausgeführt werden. Dies " -"entspricht der Angabe der auszuführenden Erweiterung mit dem Schalter --with " -"in der Datei »debian/rules«. Alle --without-Aufrufe, die in dieser " -"Umgebungsvariable eine Erweiterung festlegen, werden nicht ausgeführt." +"B<--parallel> ist Debhelpers Voreinstellung für alle Bausysteme, die " +"paralleles Bauen unterstützen. Dies kann entweder durch Verwendung von B<--" +"no-parallel> oder durch Ãœbergabe von B<--max-parallel> mit einem Wert von 1 " +"deaktiviert werden." #. type: textblock -#: debhelper.pod:1456 +#: debhelper-compat-upgrade-checklist.pod:565 msgid "" -"This is intended to be used by downstreams or specific local configurations " -"that require a debhelper addon to be run during multiple builds without " -"having to patch a large number of rules file. If at all possible, this " -"should be avoided in favor of a --with flag in the rules file." +"The B<dh> command will not accept any of the deprecated \"manual sequence " +"control\" parameters (B<--before>, B<--after>, etc.). Please use override " +"targets instead." msgstr "" -"Dies ist für die Benutzung durch nachgeschaltete Distributionen oder " -"spezielle lokale Konfigurationen gedacht, die während mehrerer Bauvorgänge " -"eine Debhelper-Erweiterung ausführen müssen, ohne dass eine große Anzahl von " -"Regeldateien bearbeitet werden muss. Falls überhaupt möglich, sollte dies " -"zugunsten eines --with-Schalters in der Datei »rules« vermieden werden." - -#. type: =item -#: debhelper.pod:1461 -msgid "B<DH_COLORS>, B<DPKG_COLORS>" -msgstr "B<DH_COLORS>, B<DPKG_COLORS>" +"Der Befehl B<dh> wird keinen der veralteten Parameter zur »manuellen " +"Sequenzsteuerung« (B<--before>, B<--after>, etc.) akzeptieren. Bitte " +"verwenden Sie stattdessen Aufhebungsziele (override targts)." #. type: textblock -#: debhelper.pod:1463 +#: debhelper-compat-upgrade-checklist.pod:569 msgid "" -"These variables can be used to control whether debhelper commands should use " -"colors in their textual output. Can be set to \"always\", \"auto\" (the " -"default), or \"never\"." +"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " +"any of these since debhelper/12.4." msgstr "" -"Diese Variablen können benutzt werden, um zu steuern, ob Debhelper-Befehle " -"in ihrer Textausgabe Farben benutzen sollen. Sie können auf »always«, " -"»auto« (die Voreinstellung) oder »never« gesetzt werden." +"B<Nachträglich auf frühere Kompatibilitätsstufen angewandt>: B<dh> " +"akzeptiert seit Debhelper/12.4 nichts davon mehr." #. type: textblock -#: debhelper.pod:1467 +#: debhelper-compat-upgrade-checklist.pod:574 msgid "" -"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " -"debhelper uses it on the assumption that you want the same color setting for " -"dpkg and debhelper. In the off-hand chance you want different color setting " -"for debhelper, you can use B<DH_COLORS> instead or in addition to " -"B<DPKG_COLORS>." +"The B<dh> command will no longer use log files to track which commands have " +"been run. The B<dh> command I<still> keeps track of whether it already ran " +"the \"build\" sequence and skip it if it did." msgstr "" -"Beachten Sie, dass B<DPKG_COLOR> auch mehrere mit Dpkg verbunden Werkzeuge " -"beeinflusst und Debhelper es unter der Annahme benutzt, dass Sie dieselbe " -"Farbeinstellung für Dpkg und Debhelper benutzen wollen. In dem " -"unwahrscheinlichen Fall, dass Sie für Debhelper eine andere Farbeinstellung " -"möchten, können Sie B<DH_COLORS> statt oder zusätzlich zu B<DPKG_COLORS> " -"verwenden." +"Der Befehl B<dh> wird keine Logdateien mehr benutzen, um zu protokollieren, " +"welche Befehle ausgeführt worden sind. Er wird aber I<trotzdem> " +"nachverfolgen, ob er selbst schon einmal in der Bausequenz gelaufen ist und " +"sie ggf. überspringen." -#. type: =item -#: debhelper.pod:1473 -msgid "B<NO_COLOR>" -msgstr "B<NO_COLOR>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:578 +msgid "The main effects of this are:" +msgstr "Die wichtigsten Auswirkungen davon sind:" #. type: textblock -#: debhelper.pod:1475 +#: debhelper-compat-upgrade-checklist.pod:584 msgid "" -"If no explicit request for color has been given (e.g. B<DH_COLORS> and " -"B<DPKG_COLORS> are both unset), the presence of this environment variable " -"cause the default color setting to be \"never\"." +"With this, it is now easier to debug the I<install> or/and I<binary> " +"sequences because they can now trivially be re-run (without having to do a " +"full \"clean and rebuild\" cycle)" msgstr "" -"Falls nicht explizit um Farbe gebeten wurde (sowohl B<DH_COLORS> als auch " -"B<DPKG_COLORS> sind nicht gesetzt), führt die Anwesenheit dieser " -"Umgebungsvariablen dazu, dass die Standardfarbeinstellung auf »never« " -"gesetzt wird." +"Hierdurch wird die Fehlersuche bei den Sequenzen I<install> und/oder " +"I<binary> einfacher, da sie nun einfach erneut ausgeführt werden können " +"(ohne, dass ein vollständiger »Aufräum- und Neubau«-Durchgang erforderlich " +"ist)." #. type: textblock -#: debhelper.pod:1479 +#: debhelper-compat-upgrade-checklist.pod:590 msgid "" -"The variable is defined according to L<https://no-color.org/>. In this " -"project, the environment variables (such as B<DH_COLORS>) are considered an " -"explicit request for color." +"The main caveat is that B<dh_*> now only keeps track of what happened in a " +"single override target. When all the calls to a given B<dh_cmd> command " +"happens in the same override target everything will work as before." msgstr "" -"Die Variable ist gemäß L<https://no-color.org/> definiert. In diesem Projekt " -"werden die Umgebungsvariablen (wie B<DH_COLORS>) als explizite Farbanfrage " -"betrachtet." +"Der Pferdefuß hier liegt darin, dass B<dh_*> nun nur noch nachverfolgt, was " +"in einem einzelnen Override-Ziel geschieht. Wenn alle Aufrufe eines " +"angegebenen B<dh_cmd>-Befehls im selben Override-Ziel stattfinden, wird " +"alles wie zuvor funktionieren." -#. type: =item -#: debhelper.pod:1483 +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:595 +msgid "Example of where it can go wrong:" +msgstr "Beispiel, bei dem es schiefgehen kann:" + +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:597 +#, no-wrap msgid "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +" override_dh_foo:\n" +" dh_foo -pmy-pkg\n" +"\n" msgstr "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +" override_dh_foo:\n" +" dh_foo -pmein-Paket\n" +"\n" -#. type: textblock -#: debhelper.pod:1485 +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:600 +#, no-wrap msgid "" -"By default (in any non-deprecated compat level), debhelper will " -"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " -"unset. If you need to change the default flags, please use the features " -"from L<dpkg-buildflags(1)> to do this (e.g. " -"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" -"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" msgstr "" -"Standardmäßig (in jeder nicht missbilligten Kompatibilitätsstufe) wird " -"Debhelper diese Schalter automatisch mittels L<dpkg-buildflags(1)> setzen, " -"wenn sie nicht gesetzt sind. Falls Sie die voreingestellten Schalter ändern " -"wollen, benutzen Sie dazu die Funktionalität von L<dpkg-buildflags(1)> (z.B. " -"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> oder B<DEB_CPPFLAGS_MAINT_APPEND=-" -"DCUSTOM_MACRO=true>) statt die konkrete Variable direkt zu setzen." - -#. type: =item -#: debhelper.pod:1492 -msgid "B<HOME>, B<XDG_*>" -msgstr "B<HOME>, B<XDG_*>" +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" #. type: textblock -#: debhelper.pod:1494 +#: debhelper-compat-upgrade-checklist.pod:604 msgid "" -"In compat 13 and later, these environment variables are reset before " -"invoking the upstream build system via the B<dh_auto_*> helpers. The " -"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " -"(B<dh_auto_test> only) will be set to a writable directory. All remaining " -"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " -"cleared." +"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" +"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " +"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." msgstr "" -"In Kompatibilitätsstufe 13 und später werden diese Umgebungsvariablen " -"zurückgesetzt, bevor das Originalautoren-Bausystem via B<dh_auto_*> " -"angeworfen wird. Die B<HOME>- (B<dh_auto_*>-Hilfsprogramme) und die " -"B<XDG_RUNTIME_DIR>-Variable (nur B<dh_auto_test>) werden auf ein " -"beschreibbares Verzeichnis gesetzt. Alle anderen Variablen und " -"B<XDG_RUNTIME_DIR> (außer während des B<dh_auto_test>) werden geleert." +"In diesem Fall wird der Aufruf von B<dh_foo --remaining> I<außerdem> I<mein-" +"Paket> enthalten, da B<dh_foo -pmein-Paket> in einem separaten Override-Ziel " +"ausgeführt wird. Dieses Problem ist nicht auf B<--remaining> begrenzt, es " +"umfasst außerdem B<-a>, B<-i>, etc." #. type: textblock -#: debhelper.pod:1500 +#: debhelper-compat-upgrade-checklist.pod:613 msgid "" -"The B<HOME> directory will be created as an empty directory but it will be " -"reused between calls to B<dh_auto_*>. Any content will persist until " -"explicitly deleted or B<dh_clean>." +"The B<dh_installdeb> command now shell-escapes the lines in the " +"F<maintscript> config file. This was the original intent but it did not " +"work properly and packages have begun to rely on the incomplete shell " +"escaping (e.g. quoting file names)." msgstr "" -"Die Verzeichnisse werden leer erzeugt und zwischen den B<dh_auto_*>-Aufrufen " -"wiederverwendet. Jeglicher Inhalt wird weiter bestehen, bis er explizit " -"gelöscht oder B<dh_clean> aufgerufen wird." - -#. type: =item -#: debhelper.pod:1504 -msgid "B<DEB_BUILD_OPTIONS>" -msgstr "B<DEB_BUILD_OPTIONS>" +"Der Befehl B<dh_installdeb> maskiert nun die Zeilen in der " +"Konfigurationsdatei F<maintscript> für die Shell. Dies war der ursprüngliche " +"Gedanke, aber es funktionierte nicht, wie es sollte und die Pakete begannen, " +"sich auf die unvollständige Shell-Maskierung zu verlassen (z.B. das Setzen " +"von Dateinamen in Anführungszeichen)." #. type: textblock -#: debhelper.pod:1506 +#: debhelper-compat-upgrade-checklist.pod:620 msgid "" -"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " -"variable." +"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " +"For packages needing the previous behaviour, please use B<--no-restart-after-" +"upgrade>." msgstr "" -"Die Beschreibung dieser Umgebungsvariable entnehmen Sie bitte L</" -"Unterstützte Optionen in DEB_BUILD_OPTIONS>" +"Voreinstellung für den Befehl B<dh_installinit> ist nun B<--restart-after-" +"upgrade>. Für Pakete, die das vorhergehende Verhalten erfordern, verwenden " +"Sie bitte B<--no-restart-after-upgrade>." #. type: textblock -#: debhelper.pod:1509 +#: debhelper-compat-upgrade-checklist.pod:626 msgid "" -"Please note that this variable should I<not> be altered by package " -"maintainers inside F<debian/rules> to change the behaviour of debhelper. " -"Instead, where the package maintainer need these features, they should look " -"disabling the relevant feature directly (e.g. by overriding the concrete " -"tools)." +"The B<autoreconf> sequence is now enabled by default. Please pass B<--" +"without autoreconf> to B<dh> if this is not desirable for a given package" msgstr "" -"Bitte beachten Sie, dass diese Variable von Paketbetreuern in ihren F<debian/" -"rules> I<nicht> geändert werden sollte, um das Verhalten von Debhelper zu " -"beeinflussen. Stattdessen sollen die fraglichen Funktionsmerkmale direkt " -"abgeschaltet werden (etwa durch Außerkraftsetzen der betreffenden Werkzeuge)." - -#. type: =item -#: debhelper.pod:1514 -msgid "B<DEB_MAINT_BUILD_OPTIONS>" -msgstr "B<DEB_MAINT_BUILD_OPTIONS>" +"Die B<autoreconf>-Sequenz ist nun standardmäßig aktiviert. Bitte übergeben " +"Sie B<--without autoreconf> an B<dh>, falls dies für ein angegebenes Paket " +"nicht erwünscht ist." #. type: textblock -#: debhelper.pod:1516 +#: debhelper-compat-upgrade-checklist.pod:632 msgid "" -"This is a dpkg specific environment variable (see e.g. L<dpkg-" -"buildflags(1)>). The debhelper tool suite silently ignores it." +"The B<systemd> sequence is now enabled by default. Please pass B<--without " +"systemd> to B<dh> if this is not desirable for a given package." msgstr "" -"Dies ist eine Dpkg-spezifische Umgebungsvariable (siehe L<dpkg-" -"buildflags(1)>). Die Debhelper-Suite ignoriert sie kommentarlos." +"Die B<systemd>-Sequenz ist nun standardmäßig aktiviert. Bitte übergeben Sie " +"B<--without systemd> an B<dh>, falls dies für ein angegebenes Paket nicht " +"erwünscht ist." #. type: textblock -#: debhelper.pod:1519 +#: debhelper-compat-upgrade-checklist.pod:638 msgid "" -"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " -"which make some people mistakenly assume that debhelper will also react to " -"this variable." +"B<Retroactively removed>: B<dh> no longer creates the package build " +"directory when skipping running debhelper commands. This will not affect " +"packages that only build with debhelper commands, but it may expose bugs in " +"commands not included in debhelper." msgstr "" -"Sie ist hier dokumentiert, weil ihr Name B<DEB_BUILD_OPTIONS> ähnelt, was zu " -"der falschen Annahme verleiten kann, dass Debhelper die Variable genauso auf " -"die Variable reagiert." - -#. type: =head2 -#: debhelper.pod:1525 -msgid "Supported flags in DEB_BUILD_OPTIONS" -msgstr "Unterstützte Optionen in DEB_BUILD_OPTIONS" +"B<Nachträglich entfernt>: B<dh> erstellt das Bauverzeichnis des Pakets nicht " +"mehr, wenn die Ausführung von Debhelper-Befehlen übersprungen wird. Dies hat " +"keine Auswirkungen auf Pakete, die nur mit Debhelper-Befehlen bauen, es " +"könnte aber Fehler in Befehlen offenlegen, die nicht in Debhelper enthalten " +"sind." #. type: textblock -#: debhelper.pod:1527 +#: debhelper-compat-upgrade-checklist.pod:643 msgid "" -"The debhelper tool suite reacts to the following flags in " -"B<DEB_BUILD_OPTIONS>." +"This compatibility feature had a bug since its inception in " +"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " +"there has been no reports of issues caused by this bug in those ~5 years, " +"this item have been removed rather than fixed." msgstr "" -"Die Debhelper-Suite reagiert auf die folgenden Optionen in " -"B<DEB_BUILD_OPTIONS>:" +"Diese Kompatibilitätsfunktionalität hatte einen Fehler seit ihrer Aufnahme " +"in Debhelper/9.20130516, der sie im Kompatibilitätsmodus 9 und älter zum " +"Scheitern brachte. Da es in den fünf Jahren ihres Bestehens keine Berichte " +"zu Problemen gab, die von diesem Fehler verursacht wurden, wurde sie nicht " +"überarbeitet, sondern entfernt." #. type: =item -#: debhelper.pod:1531 -msgid "B<dherroron=obsolete-compat-levels>" -msgstr "dherroron=obsolete-compat-levels>" +#: debhelper-compat-upgrade-checklist.pod:650 +msgid "v9" +msgstr "v9" #. type: textblock -#: debhelper.pod:1533 -msgid "I<This is a debhelper specific value.>" -msgstr "I<Dieser Wert ist Debhelper-spezfisch.>" +#: debhelper-compat-upgrade-checklist.pod:652 +msgid "Changes from v8 are:" +msgstr "Änderungen gegenüber v8 sind:" #. type: textblock -#: debhelper.pod:1535 +#: debhelper-compat-upgrade-checklist.pod:658 msgid "" -"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " -"debhelper tools will promote deprecation warnings for usage of old soon to " -"be removed compat levels into errors." +"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " +"directories to autoconf in --libdir and --libexecdir." msgstr "" -"Wenn B<dherroron> vorhanden und auf B<obsolete-compat-levels> gesetzt ist, " -"werden die Debhelper-Werkzeuge die Missbilligungswarnungen für auf der " -"Abschussliste stehenden Kompaitiblitätsstufen zu Fehlern erheben." +"Multiarch-Unterstützung. Insbesondere gibt B<dh_auto_configure> Multiarch-" +"Verzeichnisse an Autoconf in --libdir and --libexecdir weiter." #. type: textblock -#: debhelper.pod:1539 +#: debhelper-compat-upgrade-checklist.pod:663 msgid "" -"This is useful for automated checking for code relying on deprecated compat " -"levels that is scheduled for removal." +"dh is aware of the usual dependencies between targets in debian/rules. So, " +"\"dh binary\" will run any build, build-arch, build-indep, install, etc " +"targets that exist in the rules file. There's no need to define an explicit " +"binary target with explicit dependencies on the other targets." msgstr "" -"Dies hilft bei automatischen Ãœberprüfungen, ob Kode auf veralteten " -"Kompatibilitätsstufen basiert, die bald entfernt werden sollen." +"dh kennt die üblichen Abhängigkeiten zwischen den Zielen in debian/rules. " +"Daher wird »dh binary« alle »build«-, »build-arch«-, »build-indep«-, " +"»install«-Ziele etc. ausführen, die in der Regeldatei stehen. Es ist nicht " +"nötig, explizit ein binäres Ziel mit expliziten Abhängigkeiten zu den " +"anderen Zielen zu definieren." #. type: textblock -#: debhelper.pod:1542 -msgid "This option is intended for testing purposes; not production builds." +#: debhelper-compat-upgrade-checklist.pod:670 +msgid "" +"B<dh_strip> compresses debugging symbol files to reduce the installed size " +"of -dbg packages." msgstr "" -"Die Option ist für Testzwecke gedacht, aber nicht für Produktiveinsatz." - -#. type: =item -#: debhelper.pod:1544 -msgid "B<nostrip>" -msgstr "B<nostrip>" +"B<dh_strip> komprimiert Debug-Symboldateien, um die Größe der installierten " +"»-dbg«-Paketen zu verringern." #. type: textblock -#: debhelper.pod:1546 debhelper.pod:1569 +#: debhelper-compat-upgrade-checklist.pod:675 msgid "" -"I<This value will change the content of the debs being built. The .deb " -"packages built when this is set is therefore not bit-for-bit reproducible " -"with a regular build in the general case.>" +"B<dh_auto_configure> does not include the source package name in --" +"libexecdir when using autoconf." msgstr "" -"I<Dieser Wert ändert den Inhalt der Debs, die gebaut werden. Die .deb-" -"Pakete, die unter Anwesenheit dieses Werts gebaut werden, werden nicht Bit " -"für Bit reproduzierbar sein, was bei einem gewöhnlichen Paket der Regelfall " -"ist.>" +"B<dh_auto_configure> enthält keinen Quellpaketnamen in --libexecdir, wenn " +"Autoconf benutzt wird." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:680 +msgid "B<dh> does not default to enabling --with=python-support" +msgstr "Standardmäßig aktiviert B<dh> nicht --with=python-support." #. type: textblock -#: debhelper.pod:1550 +#: debhelper-compat-upgrade-checklist.pod:682 msgid "" -"This value will cause the official debhelper tools will skip actions and " -"helpers that either remove, detach or deduplicate debugging symbols in ELF " -"binaries." +"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " +"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " +"regardless of compat level)" msgstr "" -"Durch diesen Wert werden die offiziellen Debhelper-Werkzeuge dazu gebracht, " -"Aktionen und Hilfsprogramme zum Entfernen, Abkoppeln oder Deduplizieren von " -"Fehlersuchsymbolen in ELF-Binärdateien zu überspringen." +"(Hinfällig, da das Werkzeug B<dh_pysupport> aus Debian Stretch entfernt " +"wurde. Seit Debhelper/10.3 aktiviert B<dh> diese Sequenzerweiterung " +"unabhängig von der Kompatibilitätsstufe nicht mehr.)" #. type: textblock -#: debhelper.pod:1554 -msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." -msgstr "Dieser Wert betrifft L<dh_dwz(1)> und L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:688 +msgid "" +"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " +"variables listed by B<dpkg-buildflags>, unless they are already set." +msgstr "" +"Alle B<dh_auto_>I<*>-Debhelper-Programme und B<dh> setzen " +"Umgebungsvariablen, die durch B<dpkg-buildflags> aufgelistet werden, sofern " +"sie nicht bereits gesetzt sind." -#. type: =item -#: debhelper.pod:1556 -msgid "B<nocheck>" -msgstr "B<nocheck>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:694 +msgid "" +"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " +"to perl F<Makefile.PL> and F<Build.PL>" +msgstr "" +"B<dh_auto_configure> übergibt CFLAGS, CPPFLAGS und LDFLAGS von B<dpkg-" +"buildflags> an Perls F<Makefile.PL> und F<Build.PL.>" #. type: textblock -#: debhelper.pod:1558 +#: debhelper-compat-upgrade-checklist.pod:699 msgid "" -"This value will cause the official debhelper build systems to skip runs of " -"upstream test suites." +"B<dh_strip> puts separated debug symbols in a location based on their build-" +"id." msgstr "" -"Dieser Wert führt dazu, dass die offiziellen Debhelper-Bausysteme die " -"Ausführung von Test-Suiten der Originalautoren überspringen." +"B<dh_strip> legt getrennte Fehlersuchsymbole an einer Stelle ab, die auf " +"ihrer Baukennzahl basiert." #. type: textblock -#: debhelper.pod:1561 +#: debhelper-compat-upgrade-checklist.pod:704 msgid "" -"Package maintainers looking to avoid running the upstream tests should " -"B<not> rely on this. Instead, they can add an empty override target to skip " -"B<dh_auto_test>." +"Executable debhelper config files are run and their output used as the " +"configuration." msgstr "" -"Paketbetreuer, die versuchen, diese Tests zu umgehen, sollten sich hierauf " -"B<nicht> verlassen. Stattdessen können sie ein leeres Override-Ziel angeben, " -"um B<dh_auto_test> zu überspringen." +"Ausführbare Debhelper-Konfigurationsdateien werden ausgeführt und ihre " +"Ausgabe wird als Konfiguration benutzt." #. type: textblock -#: debhelper.pod:1565 -msgid "This value affects L<dh_auto_test(1)>." -msgstr "Dieser Wert betrifft L<dh_auto_test(1)>." +#: debhelper-compat-upgrade-checklist.pod:709 +#: debhelper-compat-upgrade-checklist.pod:740 +#: debhelper-compat-upgrade-checklist.pod:744 debhelper-obsolete-compat.pod:81 +#: debhelper-obsolete-compat.pod:135 debhelper-obsolete-compat.pod:158 +#: debhelper-obsolete-compat.pod:165 debhelper-obsolete-compat.pod:174 +msgid "This mode is deprecated." +msgstr "Dieser Modus ist missbilligt." #. type: =item -#: debhelper.pod:1567 -msgid "B<nodoc>" -msgstr "B<nodoc>" +#: debhelper-compat-upgrade-checklist.pod:711 +msgid "v8" +msgstr "v8" #. type: textblock -#: debhelper.pod:1573 -msgid "" -"This value will cause several debhelper tools to skip installation of " -"documentation such as manpages or upstream provided documentation. " -"Additionally, the tools will also ignore if declared documentation is " -"\"missing\" on the assumption that the documentation has not been built." -msgstr "" -"Dieser Wert wird mehrere Debhelper-Tools anweisen, die Installation von " -"Dokumentation wie Handbuchseiten oder von den Originalautoren " -"bereitgestellte Dokumentation auszulassen. Außerdem werden die Werkzeuge es " -"ignorieren, wenndie deklarierte Dokumentation fehlt, unter der Annahme, dass " -"sie nicht gebaut wurde." +#: debhelper-compat-upgrade-checklist.pod:713 +msgid "Changes from v7 are:" +msgstr "Änderungen gegenüber v7 sind:" #. type: textblock -#: debhelper.pod:1578 +#: debhelper-compat-upgrade-checklist.pod:719 msgid "" -"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " -"working with documentation." +"Commands will fail rather than warning when they are passed unknown options." msgstr "" -"Dieser Wert betrifft Werkzeuge I<wie> L<dh_installdocs(1)>, welches I<weiß>, " -"dass es mit Dokumentation arbeitet." - -#. type: =item -#: debhelper.pod:1581 -msgid "B<noautodbgsym>, B<noddebs>" -msgstr "B<noautodbgsym>, B<noddebs>" +"Befehle werden fehlschlagen anstatt zu warnen, wenn ihnen unbekannte " +"Optionen übergeben werden." #. type: textblock -#: debhelper.pod:1583 +#: debhelper-compat-upgrade-checklist.pod:723 msgid "" -"I<The official name is autodbgsym. The noddebs variant is accepted for " -"historical reasons.>" +"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " +"generates shlibs files for. So B<-X> can be used to exclude libraries. " +"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " +"processed before will be passed to it, a behavior change that can cause some " +"packages to fail to build." msgstr "" -"I<Der offizielle Name ist autodbgsym. Die noddebs-Variante wird aus " -"historischen Gründen akzeptiert.>" +"B<dh_makeshlibs> führt B<dpkg-gensymbols> auf allen gemeinsamen Bibliotheken " +"aus, für die es Shlib-Dateien generiert, wobei Bibliotheken mit B<-X> " +"ausgeschlossen werden können. Außerdem werden B<dpkg-gensymbols> " +"Bibliotheken an unüblichen Orten übergeben, ohne dass es diese vorher " +"verarbeitet haben wird, was dazu führen kann, dass sich einige Pakete nicht " +"bauen lassen." #. type: textblock -#: debhelper.pod:1586 +#: debhelper-compat-upgrade-checklist.pod:731 msgid "" -"This value causes debhelper to skip the generation of automatically " -"generated debug symbol packages." +"B<dh> requires the sequence to run be specified as the first parameter, and " +"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo " +"$@>\"." msgstr "" -"Dieser Wert veranlasst Debhelper, die automatische Erzeugung der " -"Fehlersuchsymbol-Pakete zu unterlassen." +"B<dh> erfordert, dass die auszuführende Sequenz als erster Parameter " +"angegeben wird und sämtliche Schalter danach kommen. Das heißt, Sie " +"schreiben nicht »B<dh --foo $@>«, sondern »B<dh $@ --foo>«." #. type: textblock -#: debhelper.pod:1589 -msgid "This value affects L<dh_strip(1)>." -msgstr "Dieser Wert beeinflusst L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:736 +msgid "" +"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " +"F<Makefile.PL>." +msgstr "" +"B<dh_auto_>I<*> bevorzugt Perls B<Module::Build> gegenüber F<Makefile.PL>." #. type: =item -#: debhelper.pod:1591 -msgid "B<parallel=N>" -msgstr "B<parallel=N>" +#: debhelper-compat-upgrade-checklist.pod:742 debhelper-obsolete-compat.pod:21 +msgid "v7" +msgstr "v7" #. type: textblock -#: debhelper.pod:1593 -msgid "" -"This value enables debhelper to use up to B<N> threads or processes (subject " -"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " -"debhelper tools work with parallel tasks and may silently ignore the request." -msgstr "" -"Dieser Wert erlaubt es Debhelper, bis zu B<N> Threads oder Prozesse " -"(eingeschränkt durch Parameter wie B<--no-parallel> und B<--max-parallel=M>) " -"zu verwenden. Nicht alle Debhelper-Werkzeuge arbeiten parallel und können " -"die Anfrage daher kommentarlos ignorieren." +#: debhelper-compat-upgrade-checklist.pod:746 debhelper-obsolete-compat.pod:23 +msgid "This is the lowest supported compatibility level." +msgstr "Dies ist die unterste unterstützte Kompatibilitätsstufe." #. type: textblock -#: debhelper.pod:1598 +#: debhelper-compat-upgrade-checklist.pod:748 msgid "" -"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " -"will attempt to run the underlying upstream build system with that number of " -"threads." +"If you are upgrading from an earlier compatibility level, please review " +"L<debhelper-obsolete-compat(7)>." msgstr "" -"Dieser Wert betrifft viele Debhelper-Werkzeuge. Vor allem B<dh_auto_*> wird " -"versuchen, das zugrundeliegende Bausystem der Originalautoren mit dieser " -"Anzahl an Threads auszuführen." +"Falls Sie ein Upgrade von einer vorhergehenden Kompatibilitätsstufe " +"durchführen, überprüfen Sie bitte L<debhelper-obsolete-compat(7)>." #. type: =item -#: debhelper.pod:1602 -msgid "B<terse>" -msgstr "B<terse>" +#: debhelper-compat-upgrade-checklist.pod:757 +#, fuzzy +#| msgid "L<debhelper(7)>" +msgid "L<debhelper-obsolete-compat(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1604 +#: debhelper-compat-upgrade-checklist.pod:759 msgid "" -"This value will cause the official debhelper build systems to configure " -"upstream builds to be terse (i.e. reduce verbosity in their output). This " -"is subject to the upstream and the debhelper build system supporting such " -"features." +"Upgrading from a (now) obsolete compatibility level? This document covers " +"the upgrade checklist up to the earliest supported level." msgstr "" -"Dieser Wert wird die offiziellen Debhelper-Bausysteme zu einer knappen, " -"weniger ausführlichen (daher »terse«) Ausgabe animieren. Seine Wirkung hängt " -"davon ab, inwieweit das Bausystem der Originalautoren und das von Debhelper " -"solche Funktionsmerkmale unterstützen." - -#. type: textblock -#: debhelper.pod:1609 -msgid "This value affects most B<dh_auto_*> tools." -msgstr "Dieser Wert betrifft die meisten B<dh_auto_*>-Werkzeuge." #. type: textblock -#: debhelper.pod:1613 -msgid "Unknown flags are silently ignored." -msgstr "Unbekannte Schalter werden stillschweigend ignoriert." +#: debhelper-compat-upgrade-checklist.pod:762 debhelper-obsolete-compat.pod:180 +#: dh:874 dh_auto_build:55 dh_auto_clean:57 dh_auto_configure:60 +#: dh_auto_install:105 dh_auto_test:66 dh_builddeb:178 dh_clean:191 +#: dh_compress:245 dh_dwz:165 dh_fixperms:166 dh_gencontrol:210 dh_install:379 +#: dh_installcatalogs:130 dh_installchangelogs:367 dh_installcron:82 +#: dh_installdeb:421 dh_installdebconf:235 dh_installdirs:133 +#: dh_installdocs:439 dh_installexamples:184 dh_installifupdown:74 +#: dh_installinfo:125 dh_installlogcheck:83 dh_installlogrotate:55 +#: dh_installman:422 dh_installmanpages:200 dh_installmime:65 +#: dh_installmodules:111 dh_installpam:73 dh_installppp:70 dh_installudev:104 +#: dh_installwm:132 dh_installxfonts:92 dh_link:168 dh_listpackages:36 +#: dh_makeshlibs:458 dh_md5sums:120 dh_movefiles:163 dh_perl:190 dh_prep:72 +#: dh_strip:437 dh_testdir:64 dh_testroot:95 dh_usrlocal:138 +#: dh_systemd_start:282 +msgid "L<debhelper(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1615 +#: debhelper-compat-upgrade-checklist.pod:764 msgid "" -"Note third-party debhelper-like tools or third-party provided build systems " -"may or may not react to the above flags. This tends to depend on " -"implementation details of the tool." +"General information about the debhelper framework. This document also covers " +"how to declare your chosen debhelper compat level." msgstr "" -"Beachten Sie, dass Debhelper-ähnliche Werkzeuge oder Bausysteme von " -"Drittherstellern unterschiedlich auf die oben genannten Schalter reagieren. " -"Das hängt davon ab, wie die Werkzeuge im Detail implementiert sind." #. type: =head1 -#: debhelper.pod:1619 debhelper-obsolete-compat.pod:118 dh:733 dh_auto_build:53 -#: dh_auto_clean:55 dh_auto_configure:58 dh_auto_install:97 dh_auto_test:64 -#: dh_bugfiles:133 dh_builddeb:182 dh_clean:189 dh_compress:242 dh_dwz:161 -#: dh_fixperms:164 dh_gconf:105 dh_gencontrol:208 dh_icons:75 dh_install:377 -#: dh_installcatalogs:128 dh_installchangelogs:300 dh_installcron:78 -#: dh_installdeb:412 dh_installdebconf:128 dh_installdirs:131 -#: dh_installdocs:454 dh_installemacsen:138 dh_installexamples:178 -#: dh_installifupdown:72 dh_installinfo:123 dh_installinit:430 -#: dh_installinitramfs:91 dh_installlogcheck:81 dh_installlogrotate:53 -#: dh_installman:417 dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 -#: dh_installmodules:109 dh_installpam:62 dh_installppp:68 dh_installudev:102 -#: dh_installwm:132 dh_installxfonts:90 dh_link:166 dh_lintian:60 -#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 -#: dh_perl:174 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 -#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:281 dh_systemd_start:280 -msgid "SEE ALSO" -msgstr "SIEHE AUCH" - -#. type: =item -#: debhelper.pod:1623 -msgid "F</usr/share/doc/debhelper/examples/>" -msgstr "F</usr/share/doc/debhelper/examples/>" - -#. type: textblock -#: debhelper.pod:1625 -msgid "A set of example F<debian/rules> files that use debhelper." -msgstr "" -"eine Zusammenstellung von F<debian/rules>-Beispieldateien, die Debhelper " -"benutzen" - -#. type: =item -#: debhelper.pod:1627 -msgid "L<http://joeyh.name/code/debhelper/>" -msgstr "L<http://joeyh.name/code/debhelper/>" +#: debhelper-compat-upgrade-checklist.pod:769 debhelper-obsolete-compat.pod:182 +#: dh_installinit:419 dh_systemd_enable:284 dh_systemd_start:284 +msgid "AUTHORS" +msgstr "AUTOREN" #. type: textblock -#: debhelper.pod:1629 -msgid "Debhelper web site." -msgstr "Debhelper-Website" - -#. type: =head1 -#: debhelper.pod:1633 dh:739 dh_auto_build:59 dh_auto_clean:61 -#: dh_auto_configure:64 dh_auto_install:103 dh_auto_test:70 dh_bugfiles:141 -#: dh_builddeb:188 dh_clean:195 dh_compress:248 dh_dwz:167 dh_fixperms:170 -#: dh_gconf:111 dh_gencontrol:214 dh_icons:81 dh_install:383 -#: dh_installcatalogs:134 dh_installchangelogs:306 dh_installcron:84 -#: dh_installdeb:418 dh_installdebconf:134 dh_installdirs:137 -#: dh_installdocs:460 dh_installemacsen:145 dh_installexamples:184 -#: dh_installifupdown:78 dh_installinfo:129 dh_installinitramfs:99 -#: dh_installlogcheck:87 dh_installlogrotate:59 dh_installman:423 -#: dh_installmanpages:204 dh_installmenu:96 dh_installmime:69 -#: dh_installmodules:115 dh_installpam:68 dh_installppp:74 dh_installudev:108 -#: dh_installwm:138 dh_installxfonts:96 dh_link:172 dh_lintian:68 -#: dh_listpackages:40 dh_makeshlibs:462 dh_md5sums:124 dh_movefiles:167 -#: dh_perl:180 dh_prep:76 dh_shlibdeps:210 dh_strip:441 dh_testdir:68 -#: dh_testroot:99 dh_usrlocal:142 -msgid "AUTHOR" -msgstr "AUTOR" +#: debhelper-compat-upgrade-checklist.pod:771 debhelper-obsolete-compat.pod:184 +#: dh_dwz:171 dh_installinitramfs:101 +msgid "Niels Thykier <niels@thykier.net>" +msgstr "Niels Thykier <niels@thykier.net>" #. type: textblock -#: debhelper.pod:1635 dh:741 dh_auto_build:61 dh_auto_clean:63 -#: dh_auto_configure:66 dh_auto_install:105 dh_auto_test:72 dh_builddeb:190 -#: dh_clean:197 dh_compress:250 dh_fixperms:172 dh_gencontrol:216 -#: dh_install:385 dh_installchangelogs:308 dh_installcron:86 dh_installdeb:420 -#: dh_installdebconf:136 dh_installdirs:139 dh_installdocs:462 -#: dh_installemacsen:147 dh_installexamples:186 dh_installifupdown:80 -#: dh_installinfo:131 dh_installinit:438 dh_installlogrotate:61 -#: dh_installman:425 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 -#: dh_installmodules:117 dh_installpam:70 dh_installppp:76 dh_installudev:110 -#: dh_installwm:140 dh_installxfonts:98 dh_link:174 dh_listpackages:42 -#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 -#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 -msgid "Joey Hess <joeyh@debian.org>" -msgstr "Joey Hess <joeyh@debian.org>" +#: debhelper-compat-upgrade-checklist.pod:773 debhelper-obsolete-compat.pod:186 +msgid "Joey Hess" +msgstr "Joey Hess" #. type: textblock #: debhelper-obsolete-compat.pod:3 @@ -3881,89 +4155,148 @@ msgstr "" "Es folgt die Liste der nun überflüssigen Kompatibilitätsstufen und ihrer " "Änderungen." -#. type: =item -#: debhelper-obsolete-compat.pod:21 -msgid "v1" -msgstr "v1" +#. type: textblock +#: debhelper-obsolete-compat.pod:25 +msgid "Changes from v6 are:" +msgstr "Änderungen gegenüber v6 sind:" #. type: textblock -#: debhelper-obsolete-compat.pod:23 +#: debhelper-obsolete-compat.pod:31 msgid "" -"This is the original debhelper compatibility level, and so it is the default " -"one. In this mode, debhelper will use F<debian/tmp> as the package tree " -"directory for the first binary package listed in the control file, while " -"using debian/I<package> for all other packages listed in the F<control> file." +"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " +"doesn't find them in the current directory (or wherever you tell it look " +"using B<--sourcedir>). This allows B<dh_install> to interoperate with " +"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " +"special parameters." msgstr "" -"Dies ist die Original-Debhelper-Kompatibilitätsstufe und daher ist sie die " -"Vorgabe. In diesem Modus wird Debhelper F<debian/tmp> als " -"Paketverzeichnisbaum des ersten in der Datei »control« aufgeführten Pakets " -"nehmen, während für alle anderen in der Datei F<control> aufgeführten Pakete " -"debian/I<Paket> genommen wird." +"Falls B<dh_install> keine Dateien im derzeitigen (oder dem via B<--" +"sourcedir> mitgegebenen) Verzeichnis findet, sucht es sie ersatzweise in " +"F<debian/tmp>. Das ermöglicht es ihm, ohne dass es bsondere Parameter " +"benötigt, mit B<dh_auto_install> zusammenzuarbeiten, welches nach F<debian/" +"tmp> installiert." -#. type: =item -#: debhelper-obsolete-compat.pod:30 -msgid "v2" -msgstr "v2" +#. type: textblock +#: debhelper-obsolete-compat.pod:38 +msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +msgstr "" +"B<dh_clean> wird F<debian/clean> lesen und die dort aufgeführten Dateien " +"löschen." #. type: textblock -#: debhelper-obsolete-compat.pod:32 +#: debhelper-obsolete-compat.pod:42 +msgid "B<dh_clean> will delete toplevel F<*-stamp> files." +msgstr "<dh_clean> wird die F<*-stamp>-Dateien der obersten Ebene löschen." + +#. type: textblock +#: debhelper-obsolete-compat.pod:46 msgid "" -"In this mode, debhelper will consistently use debian/I<package> as the " -"package tree directory for every package that is built." +"B<dh_installchangelogs> will guess at what file is the upstream changelog if " +"none is specified." msgstr "" -"In diesem Modus wird Debhelper durchweg debian/I<Paket> als " -"Paketverzeichnisbaum für jedes Paket nehmen, das gebaut wird." +"B<dh_installchangelogs> wird abschätzen, in welcher Datei das Changelog der " +"Originalautoren liegt, falls keines angegeben wurde." #. type: =item -#: debhelper-obsolete-compat.pod:37 -msgid "v3" -msgstr "v3" +#: debhelper-obsolete-compat.pod:51 +msgid "v6" +msgstr "v6" #. type: textblock -#: debhelper-obsolete-compat.pod:39 -msgid "This mode works like v2, with the following additions:" -msgstr "Dieser Modus funktioniert wie v2 mit den folgenden Zusätzen:" +#: debhelper-obsolete-compat.pod:53 +msgid "Changes from v5 are:" +msgstr "Änderungen gegenüber v5 sind:" #. type: textblock -#: debhelper-obsolete-compat.pod:45 +#: debhelper-obsolete-compat.pod:59 msgid "" -"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " -"To turn this off and use those characters raw, just prefix with a backslash." +"Commands that generate maintainer script fragments will order the fragments " +"in reverse order for the F<prerm> and F<postrm> scripts." msgstr "" -"Debhelper-Konfigurationsdateien unterstützen Platzhalter mittels B<*> und B<?" -">, wenn angemessen. Um dies auszuschalten und diese Zeichen im Rohzustand zu " -"verwenden, stellen Sie ihnen einen Rückwärtsschragstrich voran." +"Befehle, die Fragmente von Betreuerskripten erzeugen, werden die Fragmente " +"für die F<prerm>- und F<postrm>-Skripte in umgekehrter Reiherfolge anordnen." #. type: textblock -#: debhelper-obsolete-compat.pod:50 +#: debhelper-obsolete-compat.pod:64 msgid "" -"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " -"B<ldconfig>." +"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." +"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " +"directory." msgstr "" -"B<dh_makeshlibs> lässt F<postinst>- und F<postrm>-Skripte B<ldconfig> " -"aufrufen." +"B<dh_installwm> wird einen untergeordneten Handbuchseiten-Link für F<x-" +"window-manager.1.gz> installieren. falls es die Handbuchseite in F<usr/share/" +"man/man1> im Bauverzeichnis des Pakets entdeckt." #. type: textblock -#: debhelper-obsolete-compat.pod:54 +#: debhelper-obsolete-compat.pod:70 msgid "" -"Every file in F<etc/> is automatically flagged as a conffile by " -"B<dh_installdeb>." +"B<dh_builddeb> did not previously delete everything matching " +"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " +"B<CVS:.svn:.git>. Now it does." msgstr "" -"Jede Datei in F<etc/> wird automatisch durch B<dh_installdeb> als Conffile " -"markiert." +"Wenn ihm eine Liste mit Dingen zum Ausschließen, so wie B<CVS:.svn:.git>, " +"mitgegeben wurde, hat B<dh_builddeb> nicht alles gelöscht, was auf " +"B<DH_ALWAYS_EXCLUDE> passte. Jetzt schon." + +#. type: textblock +#: debhelper-obsolete-compat.pod:76 +msgid "" +"B<dh_installman> allows overwriting existing man pages in the package build " +"directory. In previous compatibility levels it silently refuses to do this." +msgstr "" +"B<dh_installman> erlaubt das Ãœberschreiben existierender Handbuchseiten im " +"Bauverzeichnis des Pakets. In vorhergehenden Kompatibilitätsstufen weigert " +"es sich kommentarlos." + +#. type: =item +#: debhelper-obsolete-compat.pod:83 +msgid "v5" +msgstr "v5" + +#. type: textblock +#: debhelper-obsolete-compat.pod:85 +msgid "Changes from v4 are:" +msgstr "Änderungen gegenüber v4 sind:" + +#. type: textblock +#: debhelper-obsolete-compat.pod:91 +msgid "Comments are ignored in debhelper config files." +msgstr "Kommentare in Debhelper-Konfigurationsdateien werden ignoriert." + +# http://de.wikipedia.org/wiki/Debugsymbol +#. type: textblock +#: debhelper-obsolete-compat.pod:95 +msgid "" +"B<dh_strip --dbg-package> now specifies the name of a package to put " +"debugging symbols in, not the packages to take the symbols from." +msgstr "" +"B<dh_strip --dbg-package> gibt nun den Namen des Pakets an, in das " +"Fehlersuchsymbole getan werden, nicht die Pakete, aus denen die Symbole " +"genommen werden." + +#. type: textblock +#: debhelper-obsolete-compat.pod:100 +msgid "B<dh_installdocs> skips installing empty files." +msgstr "B<dh_installdocs> überspringt die Installation leerer Dateien." + +#. type: textblock +#: debhelper-obsolete-compat.pod:104 +msgid "B<dh_install> errors out if wildcards expand to nothing." +msgstr "" +"B<dh_install> gibt Fehlermeldungen aus, wenn Platzhalter zu nichts " +"expandieren." #. type: =item -#: debhelper-obsolete-compat.pod:60 +#: debhelper-obsolete-compat.pod:108 msgid "v4" msgstr "v4" #. type: textblock -#: debhelper-obsolete-compat.pod:62 +#: debhelper-obsolete-compat.pod:110 msgid "Changes from v3 are:" msgstr "Änderungen gegenüber v3 sind:" #. type: textblock -#: debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:116 msgid "" "B<dh_makeshlibs -V> will not include the Debian part of the version number " "in the generated dependency line in the shlibs file." @@ -3972,7 +4305,7 @@ msgstr "" "erzeugten Abhängigkeitslinie in der Shlibs-Datei enthalten." #. type: textblock -#: debhelper-obsolete-compat.pod:73 +#: debhelper-obsolete-compat.pod:121 msgid "" "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> " "to supplement the B<${shlibs:Depends}> field." @@ -3981,7 +4314,7 @@ msgstr "" "abzulegen, um das Feld B<${shlibs:Depends}> zu ergänzen." #. type: textblock -#: debhelper-obsolete-compat.pod:78 +#: debhelper-obsolete-compat.pod:126 msgid "" "B<dh_fixperms> will make all files in F<bin/> directories and in F<etc/init." "d> executable." @@ -3990,77 +4323,82 @@ msgstr "" "d> ausführbar machen." #. type: textblock -#: debhelper-obsolete-compat.pod:83 +#: debhelper-obsolete-compat.pod:131 msgid "B<dh_link> will correct existing links to conform with policy." msgstr "" "B<dh_link> wird bestehende Links korrigieren, damit sie konform mit der " "Richtlinie sind." -#. type: textblock -#: debhelper-obsolete-compat.pod:93 -msgid "Changes from v4 are:" -msgstr "Änderungen gegenüber v4 sind:" - -#. type: textblock -#: debhelper-obsolete-compat.pod:99 -msgid "Comments are ignored in debhelper config files." -msgstr "Kommentare in Debhelper-Konfigurationsdateien werden ignoriert." +#. type: =item +#: debhelper-obsolete-compat.pod:137 +msgid "v3" +msgstr "v3" -# http://de.wikipedia.org/wiki/Debugsymbol #. type: textblock -#: debhelper-obsolete-compat.pod:103 -msgid "" -"B<dh_strip --dbg-package> now specifies the name of a package to put " -"debugging symbols in, not the packages to take the symbols from." -msgstr "" -"B<dh_strip --dbg-package> gibt nun den Namen des Pakets an, in das " -"Fehlersuchsymbole getan werden, nicht die Pakete, aus denen die Symbole " -"genommen werden." +#: debhelper-obsolete-compat.pod:139 +msgid "This mode works like v2, with the following additions:" +msgstr "Dieser Modus funktioniert wie v2 mit den folgenden Zusätzen:" #. type: textblock -#: debhelper-obsolete-compat.pod:108 -msgid "B<dh_installdocs> skips installing empty files." -msgstr "B<dh_installdocs> überspringt die Installation leerer Dateien." +#: debhelper-obsolete-compat.pod:145 +msgid "" +"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " +"To turn this off and use those characters raw, just prefix with a backslash." +msgstr "" +"Debhelper-Konfigurationsdateien unterstützen Platzhalter mittels B<*> und B<?" +">, wenn angemessen. Um dies auszuschalten und diese Zeichen im Rohzustand zu " +"verwenden, stellen Sie ihnen einen Rückwärtsschragstrich voran." #. type: textblock -#: debhelper-obsolete-compat.pod:112 -msgid "B<dh_install> errors out if wildcards expand to nothing." +#: debhelper-obsolete-compat.pod:150 +msgid "" +"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " +"B<ldconfig>." msgstr "" -"B<dh_install> gibt Fehlermeldungen aus, wenn Platzhalter zu nichts " -"expandieren." +"B<dh_makeshlibs> lässt F<postinst>- und F<postrm>-Skripte B<ldconfig> " +"aufrufen." #. type: textblock -#: debhelper-obsolete-compat.pod:120 dh:735 dh_auto_build:55 dh_auto_clean:57 -#: dh_auto_configure:60 dh_auto_install:99 dh_auto_test:66 dh_builddeb:184 -#: dh_clean:191 dh_compress:244 dh_dwz:163 dh_fixperms:166 dh_gconf:107 -#: dh_gencontrol:210 dh_install:379 dh_installcatalogs:130 -#: dh_installchangelogs:302 dh_installcron:80 dh_installdeb:414 -#: dh_installdebconf:130 dh_installdirs:133 dh_installdocs:456 -#: dh_installexamples:180 dh_installifupdown:74 dh_installinfo:125 -#: dh_installlogcheck:83 dh_installlogrotate:55 dh_installman:419 -#: dh_installmanpages:200 dh_installmime:65 dh_installmodules:111 -#: dh_installpam:64 dh_installppp:70 dh_installudev:104 dh_installwm:134 -#: dh_installxfonts:92 dh_link:168 dh_listpackages:36 dh_makeshlibs:458 -#: dh_md5sums:120 dh_movefiles:163 dh_perl:176 dh_prep:72 dh_strip:437 -#: dh_testdir:64 dh_testroot:95 dh_usrlocal:138 dh_systemd_start:282 -msgid "L<debhelper(7)>" -msgstr "L<debhelper(7)>" +#: debhelper-obsolete-compat.pod:154 +msgid "" +"Every file in F<etc/> is automatically flagged as a conffile by " +"B<dh_installdeb>." +msgstr "" +"Jede Datei in F<etc/> wird automatisch durch B<dh_installdeb> als Conffile " +"markiert." -#. type: =head1 -#: debhelper-obsolete-compat.pod:122 dh_installinit:436 dh_systemd_enable:285 -#: dh_systemd_start:284 -msgid "AUTHORS" -msgstr "AUTOREN" +#. type: =item +#: debhelper-obsolete-compat.pod:160 +msgid "v2" +msgstr "v2" #. type: textblock -#: debhelper-obsolete-compat.pod:124 dh_dwz:169 dh_installinitramfs:101 -msgid "Niels Thykier <niels@thykier.net>" -msgstr "Niels Thykier <niels@thykier.net>" +#: debhelper-obsolete-compat.pod:162 +msgid "" +"In this mode, debhelper will consistently use debian/I<package> as the " +"package tree directory for every package that is built." +msgstr "" +"In diesem Modus wird Debhelper durchweg debian/I<Paket> als " +"Paketverzeichnisbaum für jedes Paket nehmen, das gebaut wird." + +#. type: =item +#: debhelper-obsolete-compat.pod:167 +msgid "v1" +msgstr "v1" #. type: textblock -#: debhelper-obsolete-compat.pod:126 -msgid "Joey Hess" -msgstr "Joey Hess" +#: debhelper-obsolete-compat.pod:169 +msgid "" +"This is the original debhelper compatibility level, and so it is the default " +"one. In this mode, debhelper will use F<debian/tmp> as the package tree " +"directory for the first binary package listed in the control file, while " +"using debian/I<package> for all other packages listed in the F<control> file." +msgstr "" +"Dies ist die Original-Debhelper-Kompatibilitätsstufe und daher ist sie die " +"Vorgabe. In diesem Modus wird Debhelper F<debian/tmp> als " +"Paketverzeichnisbaum des ersten in der Datei »control« aufgeführten Pakets " +"nehmen, während für alle anderen in der Datei F<control> aufgeführten Pakete " +"debian/I<Paket> genommen wird." #. type: textblock #: dh:5 @@ -4175,11 +4513,17 @@ msgstr "Architekturabhängige/-unabhängige Override- und Hook-Ziele" #. type: textblock #: dh:65 +#, fuzzy +#| msgid "" +#| "The override and hook targets can also be defined to run only when " +#| "building architecture dependent or architecture independent packages. Use " +#| "targets with names like B<override_>I<dh_command>B<-arch> and " +#| "B<execute_after>I<dh_command>B<-indep>." msgid "" "The override and hook targets can also be defined to run only when building " "architecture dependent or architecture independent packages. Use targets " "with names like B<override_>I<dh_command>B<-arch> and " -"B<execute_after>I<dh_command>B<-indep>." +"B<execute_after_>I<dh_command>B<-indep>." msgstr "" "Die Override- und Hook-Ziele können so definiert werden, dass sie nur " "ausgeführt werden, wenn architekturabhängige bzw. -unabhängige Pakete gebaut " @@ -4202,10 +4546,16 @@ msgstr "Komplett leere Ziele" #. type: textblock #: dh:75 +#, fuzzy +#| msgid "" +#| "As a special optimization, B<dh> will skip a target if it is completely " +#| "empty. This is mostly useful for override targets, where the command " +#| "will simply be skipped without the overhead of invoking a dummy target." msgid "" "As a special optimization, B<dh> will skip a target if it is completely " -"empty. This is mostly useful for override targets, where the command will " -"simply be skipped without the overhead of invoking a dummy target." +"empty and does not depend on any other target. This is mostly useful for " +"override targets, where the command will simply be skipped without the " +"overhead of invoking a dummy target." msgstr "" "Als besondere Optimierung wird B<dh> ein Ziel überspringen, falls es " "komplett leer ist. Dies eignet sich für Override-Ziele, bei denen der Befehl " @@ -4213,13 +4563,13 @@ msgstr "" "Scheinziels eingespart wird." #. type: textblock -#: dh:79 +#: dh:80 msgid "Note that the target has to be completely empty for this to work:" msgstr "" "Beachten Sie, das das Ziel komplett leer sein muss, damit dies funktioniert." #. type: verbatim -#: dh:81 +#: dh:82 #, no-wrap msgid "" " # Skip dh_bar - the good and optimized way\n" @@ -4233,7 +4583,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:86 +#: dh:87 #, no-wrap msgid "" " # Skip dh_foo - the slow way\n" @@ -4249,21 +4599,92 @@ msgstr "" "\n" #. type: =head2 -#: dh:91 +#: dh:92 msgid "Verifying targets are picked up by dh" msgstr "Ãœberprüfung, dass Ziele von dh aufgenommen werden" #. type: textblock -#: dh:93 +#: dh:94 msgid "" -"If you want to confirm that B<dh> has seen an override or a hook target, you " +"As of debhelper 13.10, you can use L<dh_assistant(1)> to see which override " +"and hook targets will be seen by B<dh>. Here is an example run of " +"L<dh_assistant(1)> along with its output:" +msgstr "" + +#. type: verbatim +#: dh:98 +#, no-wrap +msgid "" +" $ dh_assistant detect-hook-targets\n" +" {\n" +" \"commands-not-in-path\": [\n" +" \"dh_foo\"\n" +" ],\n" +" \"hook-targets\": [\n" +" {\n" +" \"command\": \"dh_strip_nondeterminism\",\n" +" \"is-empty\": true,\n" +" \"package-section-param\": null,\n" +" \"target-name\": \"override_dh_strip_nondeterminism\"\n" +" },\n" +" {\n" +" \"command\": \"dh_foo\",\n" +" \"is-empty\": false,\n" +" \"package-section-param\": \"-a\",\n" +" \"target-name\": \"override_dh_foo-arch\"\n" +" }\n" +" ]\n" +" }\n" +"\n" +msgstr "" + +#. type: textblock +#: dh:119 +msgid "" +"The B<commands-not-in-path> is useful for spotting mistakes in the hook " +"target names. A non-empty value implies one of more hook targets are " +"related to a command that is either not installed or no command with that " +"name exists at all. It is generally worth double checking these." +msgstr "" + +#. type: textblock +#: dh:124 +msgid "" +"Additionally, the B<is-empty> attribute for each hook target can be used for " +"seeing whether a hook target triggers the L</Completely empty targets> " +"optimization." +msgstr "" + +#. type: textblock +#: dh:127 +msgid "" +"If you are interested in the other attributes, please read the " +"L<dh_assistant(1)> for the details." +msgstr "" + +#. type: =head3 +#: dh:130 +#, fuzzy +#| msgid "Verifying targets are picked up by dh" +msgid "" +"Verifying targets are picked up by dh (when debhelper is older than 13.10)" +msgstr "Ãœberprüfung, dass Ziele von dh aufgenommen werden" + +#. type: textblock +#: dh:134 +#, fuzzy +#| msgid "" +#| "If you want to confirm that B<dh> has seen an override or a hook target, " +#| "you can use the following command as an example:" +msgid "" +"On older versions of debhelper, you have to use B<dh> with B<--no-act>. You " "can use the following command as an example:" msgstr "" "Um zu bestätigen, dass B<dh> ein Override- oder Hook-Ziel gefunden hat, " "können Sie beispielsweise folgenden Befehl verwenden:" #. type: verbatim -#: dh:96 +#: dh:137 #, no-wrap msgid "" " $ dh binary --no-act | grep dh_install | head -n5\n" @@ -4283,7 +4704,7 @@ msgstr "" "\n" #. type: textblock -#: dh:103 +#: dh:144 msgid "" "The B<debian/rules execute_after_dh_install> in the output, which signals " "that B<dh> registered a B<execute_after_dh_install> target and would run it " @@ -4294,7 +4715,7 @@ msgstr "" "nach L<dh_install(1)> ausführen würde." #. type: textblock -#: dh:107 +#: dh:148 msgid "" "Note that L</Completely empty targets> will be omitted in the listing " "above. This makes it a bit harder to spot as you are looking for the " @@ -4306,12 +4727,12 @@ msgstr "" "dasselbe." #. type: =head2 -#: dh:111 +#: dh:152 msgid "Caveats with hook targets and makefile conditionals" msgstr "Vorbehalte bei Hook-Zielen und Makefile-Bedingungen (conditionals)" #. type: textblock -#: dh:113 +#: dh:154 msgid "" "If you choose to wrap a hook target in makefile conditionals, please be " "aware that B<dh> computes all the hook targets a head of time and caches the " @@ -4327,7 +4748,7 @@ msgstr "" "geändert haben." #. type: textblock -#: dh:119 +#: dh:160 msgid "" "The parsing and caching I<often> happens before B<dh> knows whether it will " "build arch:any (-a) or/and arch:all (-i) packages, which can produce " @@ -4340,7 +4761,7 @@ msgstr "" "L<dh_listpackages(1)> Teil der Bedingung ist." #. type: textblock -#: dh:124 +#: dh:165 msgid "" "Most of the problems can be avoided by making the hook target unconditional " "and then have the \"body\" be partially or completely conditional. As an " @@ -4351,7 +4772,7 @@ msgstr "" "konditional gemacht wird. Beispielsweise:" #. type: verbatim -#: dh:128 +#: dh:169 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. The hook target\n" @@ -4385,7 +4806,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:142 +#: dh:183 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -4418,7 +4839,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:157 +#: dh:198 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -4451,7 +4872,7 @@ msgstr "" "\n" #. type: textblock -#: dh:171 +#: dh:212 msgid "" "These recipes are also relevant for conditional dependency targets, which " "are often seen in a variant of the following example:" @@ -4460,7 +4881,7 @@ msgstr "" "in einer Abwandlung des folgenden Beispiels anzutreffen sind:" #. type: verbatim -#: dh:174 +#: dh:215 #, no-wrap msgid "" " COND_TASKS =\n" @@ -4478,7 +4899,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:180 +#: dh:221 #, no-wrap msgid "" " maybe-run-this:\n" @@ -4490,7 +4911,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:183 +#: dh:224 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. Either the\n" @@ -4515,7 +4936,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:194 +#: dh:235 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -4541,7 +4962,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:205 +#: dh:246 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -4561,7 +4982,7 @@ msgstr "" "\n" #. type: textblock -#: dh:213 +#: dh:254 msgid "" "When in doubt, pick the relevant B<SIMPLE> case in the examples above that " "match your need." @@ -4570,29 +4991,29 @@ msgstr "" "welches zu Ihrem Bedarf passt." #. type: =head1 -#: dh:216 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 -#: dh_auto_install:46 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 -#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gconf:42 dh_gencontrol:38 -#: dh_icons:33 dh_install:69 dh_installcatalogs:56 dh_installchangelogs:71 -#: dh_installcron:43 dh_installdeb:100 dh_installdebconf:64 dh_installdirs:45 -#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:44 -#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:78 +#: dh:257 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 +#: dh_auto_install:52 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 +#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gencontrol:38 dh_icons:33 +#: dh_install:69 dh_installcatalogs:56 dh_installchangelogs:77 +#: dh_installcron:45 dh_installdeb:107 dh_installdebconf:64 dh_installdirs:45 +#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:48 +#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:77 #: dh_installinitramfs:43 dh_installlogcheck:45 dh_installlogrotate:25 #: dh_installman:86 dh_installmanpages:43 dh_installmenu:44 -#: dh_installmodules:41 dh_installpam:34 dh_installppp:38 dh_installudev:34 +#: dh_installmodules:41 dh_installpam:38 dh_installppp:38 dh_installudev:34 #: dh_installwm:41 dh_link:69 dh_makeshlibs:67 dh_md5sums:31 dh_movefiles:41 -#: dh_perl:34 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 -#: dh_usrlocal:50 dh_systemd_enable:83 dh_systemd_start:33 +#: dh_perl:35 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 +#: dh_usrlocal:50 dh_systemd_enable:82 dh_systemd_start:33 msgid "OPTIONS" msgstr "OPTIONEN" #. type: =item -#: dh:220 +#: dh:261 msgid "B<--with> I<addon>[B<,>I<addon> ...]" msgstr "B<--with> I<Erweiterung>[B<,>I<Add-on> …]" #. type: textblock -#: dh:222 +#: dh:263 msgid "" "Add the debhelper commands specified by the given addon to appropriate " "places in the sequence of commands that is run. This option can be repeated " @@ -4609,7 +5030,7 @@ msgstr "" "Sequenz-Erweiterungsschnittstelle finden Sie in der Datei F<PROGRAMMING>." #. type: textblock -#: dh:229 +#: dh:270 msgid "" "A B<Build-Depends> relation on the package B<dh-sequence->I<addon> implies a " "B<--with> I<addon>. This avoids the need for an explicit B<--with> in " @@ -4629,7 +5050,7 @@ msgstr "" "Bootstrapping zu erleichtern)." #. type: textblock -#: dh:238 +#: dh:279 msgid "" "Since debhelper 12.5, addons can also be activated in B<indep>-only mode " "(via B<Build-Depends-Indep>) or B<arch>-only mode (via B<Build-Depends-" @@ -4643,7 +5064,7 @@ msgstr "" "Bauen vereinfachen." #. type: textblock -#: dh:244 +#: dh:285 msgid "" "Please note that addons activated via B<Build-Depends-Indep> or B<Build-" "Depends-Arch> are subject to additional limitations to ensure the result is " @@ -4662,12 +5083,12 @@ msgstr "" "Erweiterungen nur Befehle zu Sequenzen hinzufügen." #. type: =item -#: dh:252 +#: dh:293 msgid "B<--without> I<addon>" msgstr "B<--without> I<Erweiterung>" #. type: textblock -#: dh:254 +#: dh:295 msgid "" "The inverse of B<--with>, disables using the given addon. This option can be " "repeated more than once, or multiple addons to disable can be listed, " @@ -4679,12 +5100,12 @@ msgstr "" "werden." #. type: textblock -#: dh:260 +#: dh:301 msgid "List all available addons." msgstr "listet alle verfügbaren Erweiterungen auf." #. type: textblock -#: dh:262 +#: dh:303 msgid "" "When called only with this option, B<dh> can be called from any directory (i." "e. it does not need access to files from a source package)." @@ -4694,7 +5115,7 @@ msgstr "" "aus einem Quellpaket)." #. type: textblock -#: dh:268 +#: dh:309 msgid "" "Prints commands that would run for a given sequence, but does not run them." msgstr "" @@ -4702,7 +5123,7 @@ msgstr "" "sie aber nicht aus" #. type: textblock -#: dh:270 +#: dh:311 msgid "" "Note that dh normally skips running commands that it knows will do nothing. " "With --no-act, the full list of commands in a sequence is printed." @@ -4712,7 +5133,7 @@ msgstr "" "vollständige Liste der Befehle der Reihe nach ausgegeben." #. type: textblock -#: dh:275 +#: dh:316 msgid "" "Other options passed to B<dh> are passed on to each command it runs. This " "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for " @@ -4723,13 +5144,13 @@ msgstr "" "spezialisiertere Optionen gesetzt werden." #. type: =head1 -#: dh:279 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 +#: dh:320 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 #: dh_makeshlibs:185 dh_shlibdeps:78 msgid "EXAMPLES" msgstr "BEISPIELE" #. type: textblock -#: dh:281 +#: dh:322 msgid "" "To see what commands are included in a sequence, without actually doing " "anything:" @@ -4738,7 +5159,7 @@ msgstr "" "tatsächlich etwas zu tun, geben Sie Folgendes ein:" #. type: verbatim -#: dh:284 +#: dh:325 #, no-wrap msgid "" "\tdh binary-arch --no-act\n" @@ -4748,7 +5169,7 @@ msgstr "" "\n" #. type: textblock -#: dh:286 +#: dh:327 msgid "" "This is a very simple rules file, for packages where the default sequences " "of commands work with no additional options." @@ -4757,7 +5178,7 @@ msgstr "" "vorgegebenen Befehlssequenzen ohne zusätzliche Optionen arbeiten." #. type: verbatim -#: dh:289 dh:296 dh:310 dh:323 dh:334 dh:392 dh:403 +#: dh:330 dh:337 dh:351 dh:364 dh:375 dh:433 dh:444 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4771,7 +5192,7 @@ msgstr "" "\n" #. type: textblock -#: dh:293 +#: dh:334 msgid "" "Often you'll want to pass an option to a specific debhelper command. The " "easy way to do with is by adding an override target for that command." @@ -4781,7 +5202,7 @@ msgstr "" "Befehl hinzuzufügen." #. type: verbatim -#: dh:300 +#: dh:341 #, no-wrap msgid "" "\toverride_dh_strip:\n" @@ -4793,7 +5214,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:303 +#: dh:344 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4805,7 +5226,7 @@ msgstr "" "\n" #. type: textblock -#: dh:306 +#: dh:347 msgid "" "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> " "can't guess what to do for a strange package. Here's how to avoid running " @@ -4817,7 +5238,7 @@ msgstr "" "einzusetzen, schreiben Sie Folgendes: " #. type: verbatim -#: dh:314 +#: dh:355 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4829,7 +5250,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:317 +#: dh:358 #, no-wrap msgid "" "\toverride_dh_auto_build:\n" @@ -4841,7 +5262,7 @@ msgstr "" "\n" #. type: textblock -#: dh:320 +#: dh:361 msgid "" "Another common case is wanting to do something manually before or after a " "particular debhelper command is run." @@ -4850,7 +5271,7 @@ msgstr "" "besonderen Debhelper-Befehls manuell etwas tun möchten." #. type: verbatim -#: dh:327 +#: dh:368 #, no-wrap msgid "" "\t# Example assumes debhelper/12.8 and compat 10+\n" @@ -4864,7 +5285,7 @@ msgstr "" "\n" #. type: textblock -#: dh:331 +#: dh:372 msgid "" "If you are on an older debhelper or compatibility level, the above example " "would have to be written as." @@ -4873,7 +5294,7 @@ msgstr "" "Beispiel wie folgt aussehen:" #. type: verbatim -#: dh:338 +#: dh:379 #, no-wrap msgid "" "\t# Older debhelper versions or using compat 9 or lower.\n" @@ -4890,7 +5311,7 @@ msgstr "" "\n" #. type: textblock -#: dh:343 +#: dh:384 msgid "" "Python tools are not run by dh by default, due to the continual change in " "that area. Here is how to use B<dh_python2>." @@ -4900,7 +5321,7 @@ msgstr "" "folgendermaßen benutzen." #. type: verbatim -#: dh:346 +#: dh:387 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4914,7 +5335,7 @@ msgstr "" "\n" #. type: textblock -#: dh:350 +#: dh:391 msgid "" "Here is how to force use of Perl's B<Module::Build> build system, which can " "be necessary if debhelper wrongly detects that the package uses MakeMaker." @@ -4924,7 +5345,7 @@ msgstr "" "Programm MakeMaker verwendet." #. type: verbatim -#: dh:354 +#: dh:395 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4938,7 +5359,7 @@ msgstr "" "\n" #. type: textblock -#: dh:358 +#: dh:399 msgid "" "Here is an example of overriding where the B<dh_auto_>I<*> commands find the " "package's source, for a package where the source is located in a " @@ -4949,7 +5370,7 @@ msgstr "" "einem Unterverzeichnis liegt." #. type: verbatim -#: dh:362 +#: dh:403 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4963,7 +5384,7 @@ msgstr "" "\n" #. type: textblock -#: dh:366 +#: dh:407 msgid "" "And here is an example of how to tell the B<dh_auto_>I<*> commands to build " "in a subdirectory, which will be removed on B<clean>." @@ -4973,7 +5394,7 @@ msgstr "" "wird." #. type: verbatim -#: dh:369 +#: dh:410 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4987,7 +5408,7 @@ msgstr "" "\n" #. type: textblock -#: dh:373 +#: dh:414 msgid "" "If your package can be built in parallel, please either use compat 10 or " "pass B<--parallel> to dh. Then B<dpkg-buildpackage -j> will work." @@ -4997,7 +5418,7 @@ msgstr "" "B<dpkg-buildpackage -j> funktionieren." #. type: verbatim -#: dh:376 +#: dh:417 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -5011,7 +5432,7 @@ msgstr "" "\n" #. type: textblock -#: dh:380 +#: dh:421 msgid "" "If your package cannot be built reliably while using multiple threads, " "please pass B<--no-parallel> to dh (or the relevant B<dh_auto_>I<*> command):" @@ -5021,7 +5442,7 @@ msgstr "" "zuständigen B<dh_auto_>I<*>-Befehl):" #. type: verbatim -#: dh:385 +#: dh:426 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -5035,7 +5456,7 @@ msgstr "" "\n" #. type: textblock -#: dh:389 +#: dh:430 msgid "" "Here is a way to prevent B<dh> from running several commands that you don't " "want it to run, by defining empty override targets for each command." @@ -5045,7 +5466,7 @@ msgstr "" "für jeden Befehl definieren." #. type: verbatim -#: dh:396 +#: dh:437 #, no-wrap msgid "" "\t# Commands not to run:\n" @@ -5057,7 +5478,7 @@ msgstr "" "\n" #. type: textblock -#: dh:399 +#: dh:440 msgid "" "A long build process for a separate documentation package can be separated " "out using architecture independent overrides. These will be skipped when " @@ -5069,7 +5490,7 @@ msgstr "" "»binary-arch«-Sequenzen ausgeführt werden." #. type: verbatim -#: dh:407 +#: dh:448 #, no-wrap msgid "" "\toverride_dh_auto_build-indep:\n" @@ -5081,7 +5502,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:410 +#: dh:451 #, no-wrap msgid "" "\t# No tests needed for docs\n" @@ -5093,7 +5514,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:413 +#: dh:454 #, no-wrap msgid "" "\toverride_dh_auto_install-indep:\n" @@ -5105,7 +5526,7 @@ msgstr "" "\n" #. type: textblock -#: dh:416 +#: dh:457 msgid "" "Adding to the example above, suppose you need to chmod a file, but only when " "building the architecture dependent package, as it's not present when " @@ -5117,7 +5538,7 @@ msgstr "" "vorhanden ist." #. type: verbatim -#: dh:420 +#: dh:461 #, no-wrap msgid "" "\t# Example assumes debhelper/12.8 and compat 10+\n" @@ -5131,12 +5552,162 @@ msgstr "" "\n" #. type: =head1 -#: dh:424 +#: dh:465 +#, fuzzy +#| msgid "DEBHELPER COMMANDS" +msgid "DEBHELPER PROVIDED DH ADDONS" +msgstr "DEBHELPER-BEFEHLE" + +#. type: textblock +#: dh:467 +msgid "" +"The primary purpose of B<dh> addons is to provide easy integration with " +"third-party provided features for debhelper. However, debhelper itself also " +"provide a few sequences that can be useful in some cases. These are " +"documented in this list:" +msgstr "" + +#. type: =item +#: dh:474 +msgid "build-stamp" +msgstr "" + +#. type: textblock +#: dh:476 +msgid "" +"A special addon for controlling whether B<dh> (in compat 10 or later) will " +"create stamp files to tell whether the build target has been run " +"successfully. See L</INTERNALS> for more details." +msgstr "" + +#. type: textblock +#: dh:480 +msgid "" +"This addon is active by default but can disabled by using B<dh $@ --without " +"build-stamp>" +msgstr "" + +#. type: =item +#: dh:483 +msgid "dwz (obsolete)" +msgstr "" + +#. type: textblock +#: dh:485 +msgid "" +"Adds L<dh_dwz(1)> to the sequence in compat level 11 or below. Obsolete in " +"compat 12 or later." +msgstr "" + +#. type: =item +#: dh:488 +msgid "elf-tools" +msgstr "" + +#. type: textblock +#: dh:490 +msgid "" +"This addon adds tools related to ELF files to the sequence such as " +"L<dh_strip(1)> and L<dh_shlibdeps(1)>" +msgstr "" + +#. type: textblock +#: dh:493 +msgid "" +"This addon is I<conditionally> active by default for architecture specific " +"packages - that is, it is skipped for arch:all packages. In the special " +"case where you need these tools to work on arch:all packages, you can use " +"B<--with elf-tools> to activate it unconditionally." +msgstr "" + +#. type: =item +#: dh:499 +msgid "installinitramfs (obsolete)" +msgstr "" + +#. type: textblock +#: dh:501 +msgid "" +"Adds L<dh_installinitramfs(1)> to the sequence in compat level 11 or below. " +"Obsolete in compat 12 or later." +msgstr "" + +#. type: =item +#: dh:504 +msgid "root-sequence (internal)" +msgstr "" + +#. type: textblock +#: dh:506 +msgid "This is reserved for internal usage." +msgstr "" + +#. type: =item +#: dh:508 +msgid "single-binary" +msgstr "" + +#. type: textblock +#: dh:510 +msgid "" +"A special-purpose addon that makes debhelper run in \"single binary\" mode." +msgstr "" + +#. type: textblock +#: dh:512 +msgid "" +"When active, it will pass B<< --destdir=debian/I<package>/ >> to " +"L<dh_auto_install(1)>. This makes every file \"installed\" by the upstream " +"build system part of the (only) binary package by default without having to " +"use other helpers such as L<dh_install(1)>." +msgstr "" + +#. type: textblock +#: dh:517 +msgid "" +"The addon will refuse to activate when the source package lists 2 or more " +"binary packages in F<debian/control> as a precaution." +msgstr "" + +#. type: textblock +#: dh:520 +msgid "" +"Before compat 15. this behaviour was the default when there was only a " +"single binary package listed in F<debian/control>. In compat 15 and later, " +"this addon must explicitly be activated for this feature to work." +msgstr "" + +#. type: textblock +#: dh:524 +msgid "" +"The rationale for requiring this as an explicit choice is that if it is " +"implicit then debhelper will silently change behaviour on adding a new " +"binary package. This has caused many RC bugs when maintainers renamed a " +"binary and added transitional packages with the intention of supporting " +"seamless upgrades. The result would often be two empty binary packages that " +"were uploaded to archive with users frustrated as their \"upgrade\" removed " +"their programs." +msgstr "" + +#. type: =item +#: dh:532 +msgid "systemd (obsolete)" +msgstr "" + +#. type: textblock +#: dh:534 +msgid "" +"Adds L<dh_systemd_enable(1)> and L<dh_systemd_start(1)> to the sequence in " +"compat level 10 or below. Obsolete in compat 11 or later." +msgstr "" + +#. type: =head1 +#: dh:539 msgid "INTERNALS" msgstr "INTERNA" #. type: textblock -#: dh:426 +#: dh:541 msgid "" "If you're curious about B<dh>'s internals, here's how it works under the " "hood." @@ -5145,7 +5716,7 @@ msgstr "" "wie es unter der Haube arbeitet." #. type: textblock -#: dh:428 +#: dh:543 msgid "" "In compat 10 (or later), B<dh> creates a stamp file F<debian/debhelper-build-" "stamp> after the build step(s) are complete to avoid re-running them. It is " @@ -5163,7 +5734,7 @@ msgstr "" "zweimal ausgeführt (das zweite Mal als root oder unter L<fakeroot(1)>)." #. type: textblock -#: dh:436 +#: dh:551 msgid "" "Inside an override target, B<dh_*> commands will create a log file F<debian/" "package.debhelper.log> to keep track of which packages the command(s) have " @@ -5176,7 +5747,7 @@ msgstr "" "entfernt, sobald die Override-Ziele erledigt sind." #. type: textblock -#: dh:441 +#: dh:556 msgid "" "In compat 9 or earlier, each debhelper command will record when it's " "successfully run in F<debian/package.debhelper.log>. (Which B<dh_clean> " @@ -5190,7 +5761,7 @@ msgstr "" "Ausführung dieser Befehle überspringen." #. type: textblock -#: dh:446 +#: dh:561 msgid "" "Each time B<dh> is run (in compat 9 or earlier), it examines the log, and " "finds the last logged command that is in the specified sequence. It then " @@ -5202,7 +5773,7 @@ msgstr "" "Befehl fort." #. type: textblock -#: dh:450 +#: dh:565 msgid "" "A sequence can also run dependent targets in debian/rules. For example, the " "\"binary\" sequence runs the \"install\" target." @@ -5211,7 +5782,7 @@ msgstr "" "Sequenz »binary« führt zum Beispiel das Ziel »install« aus." #. type: textblock -#: dh:453 +#: dh:568 msgid "" "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass " "information through to debhelper commands that are run inside override " @@ -5224,7 +5795,7 @@ msgstr "" "ist, wie der Name schon andeutet, Gegenstand dauernder Änderungen." #. type: textblock -#: dh:458 +#: dh:573 msgid "" "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> " "sequences are passed the B<-i> option to ensure they only work on " @@ -5240,19 +5811,19 @@ msgstr "" "architekturabhängigen Paketen funktionieren." #. type: textblock -#: dh:737 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 -#: dh_auto_install:101 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:186 -#: dh_clean:193 dh_compress:246 dh_dwz:165 dh_fixperms:168 dh_gconf:109 -#: dh_gencontrol:212 dh_icons:79 dh_install:381 dh_installchangelogs:304 -#: dh_installcron:82 dh_installdeb:416 dh_installdebconf:132 dh_installdirs:135 -#: dh_installdocs:458 dh_installemacsen:143 dh_installexamples:182 -#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:434 -#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:421 +#: dh:876 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 +#: dh_auto_install:107 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:180 +#: dh_clean:193 dh_compress:247 dh_dwz:167 dh_fixperms:168 dh_gencontrol:212 +#: dh_icons:79 dh_install:381 dh_installchangelogs:369 dh_installcron:84 +#: dh_installdeb:423 dh_installdebconf:237 dh_installdirs:135 +#: dh_installdocs:441 dh_installemacsen:143 dh_installexamples:186 +#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:417 +#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:424 #: dh_installmanpages:202 dh_installmenu:94 dh_installmime:67 -#: dh_installmodules:113 dh_installpam:66 dh_installppp:72 dh_installudev:106 -#: dh_installwm:136 dh_installxfonts:94 dh_link:170 dh_lintian:64 +#: dh_installmodules:113 dh_installpam:75 dh_installppp:72 dh_installudev:106 +#: dh_installwm:134 dh_installxfonts:94 dh_link:170 dh_lintian:64 #: dh_listpackages:38 dh_makeshlibs:460 dh_md5sums:122 dh_movefiles:165 -#: dh_perl:178 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 +#: dh_perl:192 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 #: dh_testroot:97 dh_usrlocal:140 msgid "This program is a part of debhelper." msgstr "Dieses Programm ist Teil von Debhelper." @@ -5299,7 +5870,7 @@ msgstr "" "von B<dh_auto_build> überspringen und den Bauprozess nur manuell ausführen." #. type: textblock -#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:48 +#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:54 #: dh_auto_test:36 msgid "" "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build " @@ -5309,9 +5880,9 @@ msgstr "" "L<debhelper(7)/B<BUILD-SYSTEMOPTIONEN>>." #. type: =item -#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:59 +#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:65 #: dh_auto_test:41 dh_builddeb:48 dh_dwz:62 dh_gencontrol:42 -#: dh_installdebconf:72 dh_installinit:167 dh_makeshlibs:179 dh_shlibdeps:41 +#: dh_installdebconf:72 dh_installinit:166 dh_makeshlibs:179 dh_shlibdeps:41 msgid "B<--> I<params>" msgstr "B<--> I<Parameter>" @@ -5484,11 +6055,28 @@ msgstr "" #. type: textblock #: dh_auto_install:32 msgid "" -"Unless B<--destdir> option is specified, the files are installed into debian/" -"I<package>/ if there is only one binary package. In the multiple binary " -"package case, the files are instead installed into F<debian/tmp/>, and " -"should be moved from there to the appropriate package build directory using " -"L<dh_install(1)>." +"In compat 15 or later, B<dh_auto_install> will use F<debian/tmp> as the " +"default B<--destdir> and should be moved from there to the appropriate " +"package build directory using L<dh_install(1)> or similar tools. Though if " +"the B<single-binary> addon for L<dh(1)> is activated, then it will pass an " +"explicit B<< --destdir=debian/I<package>/ >> to B<dh_auto_install>." +msgstr "" + +#. type: textblock +#: dh_auto_install:38 +#, fuzzy +#| msgid "" +#| "Unless B<--destdir> option is specified, the files are installed into " +#| "debian/I<package>/ if there is only one binary package. In the multiple " +#| "binary package case, the files are instead installed into F<debian/tmp/>, " +#| "and should be moved from there to the appropriate package build directory " +#| "using L<dh_install(1)>." +msgid "" +"For earlier compat levels then unless B<--destdir> option is specified, the " +"files are installed into debian/I<package>/ if there is only one binary " +"package. In the multiple binary package case, the files are instead " +"installed into F<debian/tmp/>, and should be moved from there to the " +"appropriate package build directory using L<dh_install(1)> or similar tools." msgstr "" "Sofern die Option B<--destdir> nicht angegeben ist und es nur ein binäres " "Paket gibt, werden die Dateien in debian/I<Paket>/ installiert. Im Fall " @@ -5497,7 +6085,7 @@ msgstr "" "dazugehörige Bauverzeichnis des Pakets verschoben werden." #. type: textblock -#: dh_auto_install:38 +#: dh_auto_install:44 msgid "" "B<DESTDIR> is used to tell make where to install the files. If the Makefile " "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set " @@ -5509,7 +6097,7 @@ msgstr "" "dies erfordern." #. type: textblock -#: dh_auto_install:42 +#: dh_auto_install:48 msgid "" "This is intended to work for about 90% of packages. If it doesn't work, or " "tries to use the wrong install target, you're encouraged to skip using " @@ -5521,12 +6109,12 @@ msgstr "" "install per Hand ausführen." #. type: =item -#: dh_auto_install:53 dh_builddeb:38 +#: dh_auto_install:59 dh_builddeb:38 msgid "B<--destdir=>I<directory>" msgstr "B<--destdir=>I<Verzeichnis>" #. type: textblock -#: dh_auto_install:55 +#: dh_auto_install:61 msgid "" "Install files into the specified I<directory>. If this option is not " "specified, destination directory is determined automatically as described in " @@ -5537,7 +6125,7 @@ msgstr "" "Abschnitt L</B<BESCHREIBUNG>> beschrieben, festgelegt." #. type: textblock -#: dh_auto_install:61 +#: dh_auto_install:67 msgid "" "Pass I<params> to the program that is run, after the parameters that " "B<dh_auto_install> usually passes." @@ -5636,8 +6224,8 @@ msgstr "" "»presubj«-Dateien)." #. type: =head1 -#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_gconf:26 dh_install:40 -#: dh_installcatalogs:39 dh_installchangelogs:47 dh_installcron:24 +#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_install:40 +#: dh_installcatalogs:39 dh_installchangelogs:53 dh_installcron:24 #: dh_installdeb:25 dh_installdebconf:37 dh_installdirs:28 dh_installdocs:40 #: dh_installemacsen:30 dh_installexamples:31 dh_installifupdown:25 #: dh_installinfo:28 dh_installinit:41 dh_installinitramfs:30 @@ -5894,8 +6482,8 @@ msgstr "" "ebenfalls entfernt." #. type: textblock -#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:95 -#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:39 dh_installinfo:36 +#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:102 +#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:43 dh_installinfo:36 #: dh_installman:81 dh_installwm:36 dh_link:64 msgid "" "Supports substitution variables in compat 13 and later as documented in " @@ -5905,7 +6493,7 @@ msgstr "" "in L<debhelper(7)> beschrieben." #. type: =item -#: dh_clean:53 dh_installchangelogs:75 +#: dh_clean:53 dh_installchangelogs:81 msgid "B<-k>, B<--keep>" msgstr "B<-k>, B<--keep>" @@ -6067,7 +6655,7 @@ msgstr "" "Paketen, auf die es sich auswirken wird." #. type: =item -#: dh_compress:68 dh_installdocs:184 dh_installexamples:85 dh_installinfo:60 +#: dh_compress:68 dh_installdocs:184 dh_installexamples:89 dh_installinfo:60 #: dh_installmanpages:47 dh_movefiles:58 dh_testdir:30 msgid "I<file> ..." msgstr "<I<Datei> …" @@ -6079,7 +6667,7 @@ msgstr "" "fügt diese Dateien zu der Liste der Dateien hinzu, die komprimiert werden." #. type: =head1 -#: dh_compress:74 dh_perl:64 dh_strip:133 dh_usrlocal:66 +#: dh_compress:74 dh_perl:65 dh_strip:133 dh_usrlocal:66 msgid "CONFORMS TO" msgstr "KONFORM ZU" @@ -6276,109 +6864,29 @@ msgstr "" #: dh_fixperms:36 msgid "" "When the I<Rules-Requires-Root> field has the (effective) value of I<binary-" -"targets>, B<dh_fixperms> will also reset the ownership of all paths to " -"\"root:root\"." -msgstr "" -"Wenn das Feld I<Rules-Requires-Root> den (tatsächlichen) Wert von I<binary-" -"targets> hat, wird B<dh_fixperms> auch den Eigentümer an allen Pfaden auf " -"»root:root« zurücksetzen." - -#. type: =item -#: dh_fixperms:44 -msgid "B<-X>I<item>, B<--exclude> I<item>" -msgstr "B<-X>I<Element>, B<--exclude> I<Element>" - -#. type: textblock -#: dh_fixperms:46 -msgid "" -"Exclude files that contain I<item> anywhere in their filename from having " -"their permissions changed. You may use this option multiple times to build " -"up a list of things to exclude." -msgstr "" -"schließt Dateien von der Änderung der Zugriffsrechte aus, die irgendwo in " -"ihrem Dateinamen I<Element> enthalten. Sie können diese Option mehrfach " -"benutzen, um eine Liste von Dingen zu erstellen, die ausgeschlossen werden " -"sollen." - -#. type: textblock -#: dh_gconf:5 -msgid "" -"dh_gconf - install GConf defaults files and register schemas (deprecated)" -msgstr "" -"dh_gconf - installiert Standard-GConf-Dateien und registriert Schemata " -"(missbilligt)" - -#. type: textblock -#: dh_gconf:17 -msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" -msgstr "B<dh_gconf> [S<I<Debhelper-Optionen>>] [B<--priority=>I<Priorität>]" - -#. type: textblock -#: dh_gconf:21 -msgid "" -"B<dh_gconf> is a debhelper program that is responsible for installing GConf " -"defaults files and registering GConf schemas." -msgstr "" -"B<dh_gconf> ist ein Debhelper-Programm, das für die Installation der " -"Standard-GConf-Dateien und das Registrieren der GConf-Schemata zuständig ist." - -#. type: textblock -#: dh_gconf:24 -msgid "" -"An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>." -msgstr "" -"Eine geeignete Abhängigkeit zu gconf2 wird in B<${misc:Depends}> erzeugt." - -#. type: =item -#: dh_gconf:30 -msgid "debian/I<package>.gconf-defaults" -msgstr "debian/I<Paket>.gconf-defaults" - -#. type: textblock -#: dh_gconf:32 -msgid "" -"Installed into F<usr/share/gconf/defaults/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" -"installiert in F<usr/share/gconf/defaults/10_package> im Bauverzeichnis des " -"Pakets, wobei I<Paket> durch den Namen des Pakets ersetzt wird." - -#. type: =item -#: dh_gconf:35 -msgid "debian/I<package>.gconf-mandatory" -msgstr "debian/I<Paket>.gconf-mandatory" - -#. type: textblock -#: dh_gconf:37 -msgid "" -"Installed into F<usr/share/gconf/mandatory/10_package> in the package build " -"directory, with I<package> replaced by the package name." +"targets>, B<dh_fixperms> will also reset the ownership of all paths to " +"\"root:root\"." msgstr "" -"installiert in F<usr/share/gconf/mandatory/10_package> im Bauverzeichnis des " -"Pakets, wobei I<Paket> durch den Namen des Pakets ersetzt wird." +"Wenn das Feld I<Rules-Requires-Root> den (tatsächlichen) Wert von I<binary-" +"targets> hat, wird B<dh_fixperms> auch den Eigentümer an allen Pfaden auf " +"»root:root« zurücksetzen." #. type: =item -#: dh_gconf:46 -msgid "B<--priority> I<priority>" -msgstr "B<--priority> I<Priorität>" +#: dh_fixperms:44 +msgid "B<-X>I<item>, B<--exclude> I<item>" +msgstr "B<-X>I<Element>, B<--exclude> I<Element>" #. type: textblock -#: dh_gconf:48 +#: dh_fixperms:46 msgid "" -"Use I<priority> (which should be a 2-digit number) as the defaults priority " -"instead of B<10>. Higher values than ten can be used by derived " -"distributions (B<20>), CDD distributions (B<50>), or site-specific packages " -"(B<90>)." +"Exclude files that contain I<item> anywhere in their filename from having " +"their permissions changed. You may use this option multiple times to build " +"up a list of things to exclude." msgstr "" -"benutzt I<Priorität> (welche eine zweistellige Zahl sein sollte) als " -"Standardpriorität an Stelle von B<10>. Höhere Werte als zehn können durch " -"abgeleitete Distributionen (B<20>), CDD-Distributionen (B<50>) oder Site-" -"spezifische Pakete (B<90>) verwendet werden." - -#. type: textblock -#: dh_gconf:113 -msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" -msgstr "Ross Burton <ross@burtonini.com>, Josselin Mouette <joss@debian.org>" +"schließt Dateien von der Änderung der Zugriffsrechte aus, die irgendwo in " +"ihrem Dateinamen I<Element> enthalten. Sie können diese Option mehrfach " +"benutzen, um eine Liste von Dingen zu erstellen, die ausgeschlossen werden " +"sollen." #. type: textblock #: dh_gencontrol:5 @@ -6490,7 +6998,7 @@ msgstr "" #. type: =item #: dh_icons:37 dh_installcatalogs:60 dh_installdebconf:68 dh_installemacsen:60 -#: dh_installinit:82 dh_installinitramfs:47 dh_installmenu:48 +#: dh_installinit:81 dh_installinitramfs:47 dh_installmenu:48 #: dh_installmodules:45 dh_installwm:51 dh_makeshlibs:147 dh_usrlocal:54 msgid "B<-n>, B<--no-scripts>" msgstr "B<-n>, B<--no-scripts>" @@ -6669,7 +7177,7 @@ msgstr "" "Dokumentation dieser Option finden Sie unter L<dh_missing(1)>." #. type: =item -#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:53 +#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:57 #: dh_installinfo:50 dh_installman:100 dh_movefiles:45 msgid "B<--sourcedir=>I<dir>" msgstr "B<--sourcedir=>I<Verz>" @@ -6953,7 +7461,7 @@ msgstr "" "Aktivierungsauslöser hinzugefügt." #. type: textblock -#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:207 +#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:206 #: dh_installmodules:59 dh_installudev:52 dh_installwm:68 dh_usrlocal:62 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " @@ -6983,16 +7491,20 @@ msgstr "" "dh_installchangelogs - installiert Changelogs in die Paketbauverzeichnisse" #. type: textblock -#: dh_installchangelogs:17 +#: dh_installchangelogs:18 +#, fuzzy +#| msgid "" +#| "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " +#| "[I<upstream>]" msgid "" "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " -"[I<upstream>]" +"[B<--no-trim>] [I<upstream>]" msgstr "" "B<dh_installchangelogs> [S<I<Debhelper-Optionen>>] [B<-k>] [B<-X>I<Element>] " "[I<Originalautor>]" #. type: textblock -#: dh_installchangelogs:21 +#: dh_installchangelogs:22 msgid "" "B<dh_installchangelogs> is a debhelper program that is responsible for " "installing changelogs into package build directories." @@ -7001,7 +7513,7 @@ msgstr "" "von Changelogs in Paketbauverzeichnisse zuständig ist." #. type: textblock -#: dh_installchangelogs:24 +#: dh_installchangelogs:25 msgid "" "An upstream F<changelog> file may be specified as an option. If none is " "specified, B<dh_installchangelogs> may look for files with names that seem " @@ -7013,7 +7525,7 @@ msgstr "" "Abschnitten beschrieben, sein könnten." #. type: textblock -#: dh_installchangelogs:28 +#: dh_installchangelogs:29 msgid "" "In non-native packages, B<dh_installchangelogs> will first look for " "changelog files installed by the upstream build system into F<< usr/share/" @@ -7039,7 +7551,7 @@ msgstr "" "können (etwa F<.txt>, F<.md> und F<.rst>)." #. type: textblock -#: dh_installchangelogs:40 +#: dh_installchangelogs:41 msgid "" "If a changelog file is specified and is an F<html> file (determined by file " "extension), it will be installed as F<usr/share/doc/package/changelog.html> " @@ -7056,28 +7568,37 @@ msgstr "" "angegeben wurde, wird ein kurzes F<usr/share/doc/Paket/changelog> erzeugt, " "das Leser auf die HTML-Changelog-Datei verweist." +#. type: textblock +#: dh_installchangelogs:48 +msgid "" +"The B<debchange>-style Debian changelogs are trimmed to include only entries " +"more recent than the release date of I<oldstable>. No trimming will be " +"performed if the B<--no-trim> option is passed or if the " +"B<DEB_BUILD_OPTIONS> environment variable contains B<notrimdch>." +msgstr "" + #. type: =item -#: dh_installchangelogs:51 +#: dh_installchangelogs:57 msgid "F<debian/changelog>" msgstr "F<debian/changelog>" #. type: =item -#: dh_installchangelogs:53 +#: dh_installchangelogs:59 msgid "F<debian/NEWS>" msgstr "F<debian/NEWS>" #. type: =item -#: dh_installchangelogs:55 +#: dh_installchangelogs:61 msgid "debian/I<package>.changelog" msgstr "debian/I<Paket>.changelog" #. type: =item -#: dh_installchangelogs:57 +#: dh_installchangelogs:63 msgid "debian/I<package>.NEWS" msgstr "debian/I<Paket>.NEWS" #. type: textblock -#: dh_installchangelogs:59 +#: dh_installchangelogs:65 msgid "" "Automatically installed into usr/share/doc/I<package>/ in the package build " "directory." @@ -7086,7 +7607,7 @@ msgstr "" "installiert." #. type: textblock -#: dh_installchangelogs:62 +#: dh_installchangelogs:68 msgid "" "Use the package specific name if I<package> needs a different F<NEWS> or " "F<changelog> file." @@ -7095,7 +7616,7 @@ msgstr "" "oder F<changelog>-Datei benötigt." #. type: textblock -#: dh_installchangelogs:65 +#: dh_installchangelogs:71 msgid "" "The F<changelog> file is installed with a name of changelog for native " "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file " @@ -7106,7 +7627,7 @@ msgstr "" "F<NEWS> wird immer mit dem Namen F<NEWS.Debian> installiert." #. type: textblock -#: dh_installchangelogs:77 +#: dh_installchangelogs:83 msgid "" "Keep the original name of the upstream changelog. This will be accomplished " "by installing the upstream changelog as F<changelog>, and making a symlink " @@ -7122,7 +7643,7 @@ msgstr "" "Dokumentation im Paket sich auf die Datei F<changelog> bezieht." #. type: textblock -#: dh_installchangelogs:85 +#: dh_installchangelogs:91 msgid "" "Exclude upstream F<changelog> files that contain I<item> anywhere in their " "filename from being installed." @@ -7131,19 +7652,33 @@ msgstr "" "die irgendwo in ihrem Dateinamen I<Element> enthalten." #. type: textblock -#: dh_installchangelogs:88 +#: dh_installchangelogs:94 msgid "Note that directory name of the changelog is also part of the match." msgstr "" "Beachten Sie, dass der Verzeichnisname des Changelogs auch Teil des Treffers " "ist." #. type: =item -#: dh_installchangelogs:90 +#: dh_installchangelogs:96 +#, fuzzy +#| msgid "B<--no-start>" +msgid "B<--no-trim>" +msgstr "B<--no-start>" + +#. type: textblock +#: dh_installchangelogs:98 +msgid "" +"Install the full changelog, not its trimmed version that includes only " +"recent entries." +msgstr "" + +#. type: =item +#: dh_installchangelogs:101 msgid "I<upstream>" msgstr "I<Originalautoren>" #. type: textblock -#: dh_installchangelogs:92 +#: dh_installchangelogs:103 msgid "Install this file as the upstream changelog." msgstr "installiert diese Datei als Changelog der Originalautoren." @@ -7183,16 +7718,23 @@ msgstr "debian/I<Paket>.cron.monthly" #. type: =item #: dh_installcron:34 +#, fuzzy +#| msgid "debian/I<package>.cron.daily" +msgid "debian/I<package>.cron.yearly" +msgstr "debian/I<Paket>.cron.daily" + +#. type: =item +#: dh_installcron:36 msgid "debian/I<package>.cron.hourly" msgstr "debian/I<Paket>.cron.hourly" #. type: =item -#: dh_installcron:36 +#: dh_installcron:38 msgid "debian/I<package>.cron.d" msgstr "debian/I<Paket>.cron.d" #. type: textblock -#: dh_installcron:38 +#: dh_installcron:40 msgid "" "Installed into the appropriate F<etc/cron.*/> directory in the package build " "directory." @@ -7200,14 +7742,14 @@ msgstr "" "installiert im passenden F<etc/cron.*/>-Verzeichnis im Paketbauverzeichnis" #. type: =item -#: dh_installcron:47 dh_installifupdown:46 dh_installinit:175 +#: dh_installcron:49 dh_installifupdown:46 dh_installinit:174 #: dh_installlogcheck:49 dh_installlogrotate:29 dh_installmodules:49 -#: dh_installpam:38 dh_installppp:42 dh_installudev:38 dh_systemd_enable:95 +#: dh_installpam:42 dh_installppp:42 dh_installudev:38 dh_systemd_enable:94 msgid "B<--name=>I<name>" msgstr "B<--name=>I<Name>" #. type: textblock -#: dh_installcron:49 +#: dh_installcron:51 msgid "" "Look for files named F<debian/package.name.cron.*> and install them as F<etc/" "cron.*/name>, instead of using the usual files and installing them as the " @@ -7319,24 +7861,18 @@ msgstr "I<Paket>.conffiles" #. type: textblock #: dh_installdeb:59 msgid "" -"Historically, this file was needed to manually mark files files as " -"conffiles. However, it has become de facto obsolete since debhelper " -"automatically computed which files should be marked as conffiles." +"This file will be installed into the F<DEBIAN> directory. The provided file " +"will be enriched by debhelper to include all the B<conffiles> auto-detected " +"by debhelper (the maintainer should not list there as debhelper assumes it " +"should handle that part)." msgstr "" -"Früher wurde diese Datei benötigt, um Dateien manuell als Conffiles zu " -"markieren. Allerdings wurde es faktisch überflüssig, seit Debhelper " -"automatisch berechnet, welche Dateien als Conffiles markiert werden sollen." #. type: textblock -#: dh_installdeb:63 +#: dh_installdeb:64 msgid "" -"In compatibility level up and including 11, this control file will be " -"installed into the F<DEBIAN> directory. In compatibility level 12 and " -"later, the file is silently ignored." +"This file is primarily useful for using \"special\" entries such as the B<< " +"remove-on-upgrade >> feature from dpkg." msgstr "" -"Auf Kompatibilitätsstufen 11 und darunter wird diese Steuerdatei im " -"Verzeichnis F<DEBIAN> installiert. Auf Kompatibilitätsstufe 12 und neuer " -"wird diese Datei stillschweigend ignoriert." #. type: =item #: dh_installdeb:67 @@ -7413,13 +7949,23 @@ msgstr "" "abzufangen. Die Ãœberprüfung wird seit Kompatibilitätsstufe 10 als Warnung " "aktiviert und in Kompatibilitätsstufe 12 als harter Fehler." +#. type: textblock +#: dh_installdeb:95 +msgid "" +"Where possible, B<dh_installdeb> may choose to rewrite some or all of the " +"entries into equivalent features supported in dpkg without relying on " +"maintainer scripts at its sole discretion (examples include rewriting " +"B<rm_conffile> into dpkg's B<remove-on-upgrade>). The minimum requirement " +"for activating this feature is that debhelper runs in compat 10 or later." +msgstr "" + #. type: =item -#: dh_installdeb:104 +#: dh_installdeb:111 dh_installdebconf:76 msgid "B<-D>I<TOKEN=VALUE>, B<--define> I<TOKEN=VALUE>" msgstr "B<-D>I<MARKIERUNG=WERT>, B<--define> I<MARKIERUNG=WERT>" #. type: textblock -#: dh_installdeb:106 +#: dh_installdeb:113 dh_installdebconf:78 msgid "" "Define tokens to be replaced inside the maintainer scripts when it is " "generated. Please note that the limitations described in L</Limitations in " @@ -7433,7 +7979,7 @@ msgstr "" "Markierungsnamen werden einen Fehler auslösen." #. type: textblock -#: dh_installdeb:111 +#: dh_installdeb:118 dh_installdebconf:83 msgid "" "In the simple case, this parameter will cause B<< #I<TOKEN># >> to be " "replaced by I<VALUE>. If I<VALUE> starts with a literal I<@>-sign, then " @@ -7446,7 +7992,7 @@ msgstr "" "die den tatsächlich einzufügenden Wert enthält." #. type: textblock -#: dh_installdeb:116 +#: dh_installdeb:123 dh_installdebconf:88 msgid "" "An explicit declared token with this parameter will replace built-in tokens." msgstr "" @@ -7454,12 +8000,12 @@ msgstr "" "eingebauten Markierungen ersetzen." #. type: textblock -#: dh_installdeb:119 +#: dh_installdeb:126 dh_installdebconf:91 msgid "Test examples to aid with the understanding:" msgstr "Testbeispiele zum besseren Verständnis:" #. type: verbatim -#: dh_installdeb:121 +#: dh_installdeb:128 #, no-wrap msgid "" "\tcat >> debian/postinst <<EOF\n" @@ -7479,7 +8025,7 @@ msgstr "" "\n" #. type: textblock -#: dh_installdeb:128 +#: dh_installdeb:135 dh_installdebconf:100 msgid "" "In this example, B<#SIMPLE#> will expand to B<direct> and B<#FILEBASED#> " "will expand to B<Complex value>." @@ -7488,7 +8034,7 @@ msgstr "" "B<Komplexer Wert> expandiert." #. type: textblock -#: dh_installdeb:131 +#: dh_installdeb:138 msgid "" "It is also possible to set package-specific values for a given token. This " "is useful when B<dh_installdeb> is acting on multiple packages that need " @@ -7501,12 +8047,12 @@ msgstr "" "wird B<< pkg.I<Paketname>. >> vor die Markierung gestellt." #. type: textblock -#: dh_installdeb:136 +#: dh_installdeb:143 dh_installdebconf:108 msgid "This can be used as in the following example:" msgstr "Es kann wie im folgenden Beispiel benutzt werden:" #. type: verbatim -#: dh_installdeb:138 +#: dh_installdeb:145 #, no-wrap msgid "" "\tcat >> debian/foo.postinst <<EOF\n" @@ -7542,7 +8088,7 @@ msgstr "" "\n" #. type: textblock -#: dh_installdeb:153 +#: dh_installdeb:160 msgid "" "In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." "postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and to B<unique-" @@ -7553,7 +8099,7 @@ msgstr "" "F<debian/baz.postinst> zu B<eindeutiger-baz-wert> expandiert." #. type: textblock -#: dh_installdeb:157 +#: dh_installdeb:164 msgid "" "Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." "g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> and it " @@ -7565,12 +8111,12 @@ msgstr "" "B<eindeutiger-bar-wert> ersetzt." #. type: =head1 -#: dh_installdeb:163 +#: dh_installdeb:170 dh_installdebconf:135 msgid "SUBSTITUTION IN MAINTAINER SCRIPTS" msgstr "ERSETZUNG IN BETREUERSKRIPTEN" #. type: textblock -#: dh_installdeb:165 +#: dh_installdeb:172 msgid "" "The B<dh_installdeb> will automatically replace the following tokens inside " "a provided maintainer script (if not replaced via B<-D>/B<--define>):" @@ -7580,12 +8126,12 @@ msgstr "" "define> ersetzt werden):" #. type: =item -#: dh_installdeb:170 +#: dh_installdeb:177 msgid "#DEBHELPER#" msgstr "#DEBHELPER#" #. type: textblock -#: dh_installdeb:172 +#: dh_installdeb:179 msgid "" "This token is by default replaced with generated shell snippets debhelper " "commands. This includes the snippets generated by B<dh_installdeb> from " @@ -7596,12 +8142,12 @@ msgstr "" "Datei I<Paket>.maintscript erzeugten Schnipsel (falls vorhanden)." #. type: =item -#: dh_installdeb:176 +#: dh_installdeb:183 dh_installdebconf:142 msgid "#DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME>#" msgstr "#DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME>#" #. type: textblock -#: dh_installdeb:178 +#: dh_installdeb:185 dh_installdebconf:144 msgid "" "These tokens are replaced with the respective variable from L<dpkg-" "architecture(1)>. In almost all cases, you will want use the B<< " @@ -7614,7 +8160,7 @@ msgstr "" "dass Sie beim Cross-Bauen den richtigen Wert haben." #. type: textblock -#: dh_installdeb:183 +#: dh_installdeb:190 dh_installdebconf:149 msgid "" "On a best effort, tokens of this pattern that do not match a variable in " "L<dpkg-architecture(1)> will be left as-is." @@ -7624,12 +8170,12 @@ msgstr "" "wie sie sind." #. type: =item -#: dh_installdeb:186 +#: dh_installdeb:193 dh_installdebconf:152 msgid "#ENV.I<NAME>#" msgstr "#ENV.I<NAME>#" #. type: textblock -#: dh_installdeb:188 +#: dh_installdeb:195 dh_installdebconf:154 msgid "" "These tokens of this form will be replaced with value of the corresponding " "environment variable. If the environment variable is unset, the token is " @@ -7640,7 +8186,7 @@ msgstr "" "wird die Markierung durch die leere Zeichenkette ersetzt." #. type: textblock -#: dh_installdeb:193 +#: dh_installdeb:200 dh_installdebconf:159 msgid "" "Note that there are limits on which names can be used (see L</Limitations in " "token names>)." @@ -7649,12 +8195,12 @@ msgstr "" "können (siehe L</Einschränkungen in Markierungsnamen>)." #. type: =item -#: dh_installdeb:196 +#: dh_installdeb:203 dh_installdebconf:162 msgid "#PACKAGE#" msgstr "#PACKAGE#" #. type: textblock -#: dh_installdeb:198 +#: dh_installdeb:205 dh_installdebconf:164 msgid "" "This token is by default replaced by the package name, which will contain " "the concrete script." @@ -7663,12 +8209,12 @@ msgstr "" "welches das wirkliche Skript enthält." #. type: =head2 -#: dh_installdeb:203 +#: dh_installdeb:210 dh_installdebconf:169 msgid "Limitations in token names" msgstr "Einschränkungen in Markierungsnamen" #. type: textblock -#: dh_installdeb:205 +#: dh_installdeb:212 dh_installdebconf:171 msgid "" "All tokens intended to be substituted must match the regex: #[A-Za-z0-9_.+]+#" msgstr "" @@ -7676,7 +8222,7 @@ msgstr "" "Ausdruck #[A-Za-z0-9_.+]+# passen." #. type: textblock -#: dh_installdeb:207 +#: dh_installdeb:214 msgid "" "Tokens that do not match that regex will be silently ignored if found in the " "script template. Invalid token names passed to B<-D> or B<--define> will " @@ -7820,6 +8366,172 @@ msgstr "Ncht das F<postrm>-Skript ändern." msgid "Pass the params to B<po2debconf>." msgstr "Ãœbergeben der Parameter an B<po2debconf>." +#. type: verbatim +#: dh_installdebconf:93 +#, fuzzy, no-wrap +#| msgid "" +#| "\tcat >> debian/postinst <<EOF\n" +#| "\t#SIMPLE#\n" +#| "\t#FILEBASED#\n" +#| "\tEOF\n" +#| "\techo -n \"Complex value\" > some-file\n" +#| " dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +#| "\n" +msgid "" +"\tcat >> debian/config <<EOF\n" +"\t#SIMPLE#\n" +"\t#FILEBASED#\n" +"\tEOF\n" +"\techo -n \"Complex value\" > some-file\n" +" dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +"\n" +msgstr "" +"\tcat >> debian/postinst <<EOF\n" +"\t#EINFACH#\n" +"\t#DATEIBASIERT#\n" +"\tEOF\n" +"\techo -n \"Komplexer Wert\" > irgendeine-Datei\n" +" dh_installdeb --define EINFACH=direkt --define DATEIBASIERT=@irgendeine-Datei\n" +"\n" + +#. type: textblock +#: dh_installdebconf:103 +#, fuzzy +#| msgid "" +#| "It is also possible to set package-specific values for a given token. " +#| "This is useful when B<dh_installdeb> is acting on multiple packages that " +#| "need different values for the same token. This is done by prefixing the " +#| "token name with B<< pkg.I<package-name>. >>." +msgid "" +"It is also possible to set package-specific values for a given token. This " +"is useful when B<dh_installdebconf> is acting on multiple packages that need " +"different values for the same token. This is done by prefixing the token " +"name with B<< pkg.I<package-name>. >>." +msgstr "" +"Es ist auch möglich, paketspezifische Werte für eine angegebene Markierung " +"zu setzen, was hilfreich ist, wenn B<dh_installdeb> mit mehreren Paketen " +"agiert, die unterschiedliche Werte für dieselbe Markierung benötigen. Dazu " +"wird B<< pkg.I<Paketname>. >> vor die Markierung gestellt." + +#. type: verbatim +#: dh_installdebconf:110 +#, fuzzy, no-wrap +#| msgid "" +#| "\tcat >> debian/foo.postinst <<EOF\n" +#| "\t# Script for #PACKAGE#\n" +#| "\t#TOKEN#\n" +#| "\tEOF\n" +#| "\tcat >> debian/bar.postinst <<EOF\n" +#| "\t# Script for #PACKAGE#\n" +#| "\t#TOKEN#\n" +#| "\tEOF\n" +#| "\tcat >> debian/baz.postinst <<EOF\n" +#| "\t# Script for #PACKAGE#\n" +#| "\t#TOKEN#\n" +#| "\tEOF\n" +#| " dh_installdeb -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \\\n" +#| " --define pkg.baz.TOKEN=unique-baz-value\n" +#| "\n" +msgid "" +"\tcat >> debian/foo.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/bar.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/baz.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +" dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \\\n" +" --define pkg.baz.TOKEN=unique-baz-value\n" +"\n" +msgstr "" +"\tcat >> debian/foo.postinst <<EOF\n" +"\t# Skript für #PACKAGE#\n" +"\t#MARKIERUNG#\n" +"\tEOF\n" +"\tcat >> debian/bar.postinst <<EOF\n" +"\t# Skript für #PACKAGE#\n" +"\t#MARKIERUNG#\n" +"\tEOF\n" +"\tcat >> debian/baz.postinst <<EOF\n" +"\t# Skript für #PACKAGE#\n" +"\t#MARKIERUNG#\n" +"\tEOF\n" +" dh_installdeb -pfoo -pbar -pbaz --define MARKIERUNG=Vorgabe --define pkg.bar.MARKIERUNG=eindeutiger-bar-wert \\\n" +" --define pkg.baz.MARKIERUNG=eindeutiger-baz-wert\n" +"\n" + +#. type: textblock +#: dh_installdebconf:125 +#, fuzzy +#| msgid "" +#| "In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." +#| "postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and to " +#| "B<unique-baz-value> in F<debian/baz.postinst>." +msgid "" +"In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." +"config>, to B<unique-bar-value> in F<debian/bar.config> and to B<unique-baz-" +"value> in F<debian/baz.config>." +msgstr "" +"In diesem Beispiel wird B<#MARKIERUNG#> in F<debian/foo.postinst> zu " +"B<Vorgabe>, in F<debian/bar.postinst> zu B<eindeutiger-bar-wert> und in " +"F<debian/baz.postinst> zu B<eindeutiger-baz-wert> expandiert." + +#. type: textblock +#: dh_installdebconf:129 +#, fuzzy +#| msgid "" +#| "Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. " +#| "E.g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> " +#| "and it will be replaced by B<unique-bar-value>." +msgid "" +"Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." +"g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.config> and it " +"will be replaced by B<unique-bar-value>." +msgstr "" +"Beachten Sie, dass die B<#pkg.*#>-Markierungen in allen Skripten, mit denen " +"gearbeitet wird, sichtbar sind. Sie können sich z. B. auf B<#pkg.bar." +"MARKIERUNG#> innerhalb von F<debian/foo.postinst> beziehen und es wird durch " +"B<eindeutiger-bar-wert> ersetzt." + +#. type: textblock +#: dh_installdebconf:137 +#, fuzzy +#| msgid "" +#| "The B<dh_installdeb> will automatically replace the following tokens " +#| "inside a provided maintainer script (if not replaced via B<-D>/B<--" +#| "define>):" +msgid "" +"The B<dh_installdebconf> will automatically replace the following tokens " +"inside a provided maintainer script (if not replaced via B<-D>/B<--define>):" +msgstr "" +"B<dh_installdeb> wird automatisch die folgenden Markierungen innerhalb eines " +"bereitgestellten Betreuerskripts ersetzen (falls sie nicht über B<-D>/B<--" +"define> ersetzt werden):" + +#. type: textblock +#: dh_installdebconf:173 +#, fuzzy +#| msgid "" +#| "Tokens that do not match that regex will be silently ignored if found in " +#| "the script template. Invalid token names passed to B<-D> or B<--define> " +#| "will cause B<dh_installdeb> to reject the command with an error in most " +#| "cases." +msgid "" +"Tokens that do not match that regex will be silently ignored if found in the " +"script template. Invalid token names passed to B<-D> or B<--define> will " +"cause B<dh_installdebconf> to reject the command with an error in most cases." +msgstr "" +"Markierungen, die nicht auf diesen Ausdruck passen, werden stillschweigend " +"ignoriert, falls sie in der Skriptschablone gefunden werden. Ungültige " +"Markierungsnamen, die per B<-D> oder B<--define> übergeben wurden, führen in " +"den meisten Fällen dazu, dass B<dh_installdeb> den Befehl mit einem Fehler " +"zurückweist." + #. type: textblock #: dh_installdirs:5 msgid "dh_installdirs - create subdirectories in package build directories" @@ -8148,7 +8860,7 @@ msgstr "" "Dateinamen enthalten. Beachten Sie, dass dies doc-base-Dateien einschließt." #. type: textblock -#: dh_installdocs:116 dh_installexamples:55 dh_installinfo:52 dh_installman:102 +#: dh_installdocs:116 dh_installexamples:59 dh_installinfo:52 dh_installman:102 msgid "" "Look in the specified directory for files to be installed. This option " "requires compat 11 or later (it is silently ignored in compat 10 or earlier)." @@ -8172,12 +8884,12 @@ msgstr "" "Dateien sucht." #. type: =item -#: dh_installdocs:124 dh_installexamples:63 +#: dh_installdocs:124 dh_installexamples:67 msgid "B<--doc-main-package=>I<main-package>" msgstr "B<--doc-main-package=>I<Hauptpaket>" #. type: textblock -#: dh_installdocs:126 dh_installexamples:65 +#: dh_installdocs:126 dh_installexamples:69 msgid "" "Set the main package for a documentation package. This is used to install " "the documentation of the documentation package in F<< /usr/share/doc/I<main-" @@ -8189,7 +8901,7 @@ msgstr "" "§12.3 empfiehlt." #. type: textblock -#: dh_installdocs:131 dh_installexamples:70 +#: dh_installdocs:131 dh_installexamples:74 msgid "" "In compat 11 (or later), this option is only useful if debhelper's auto-" "detection of the main package is wrong. The option can also be used to " @@ -8538,7 +9250,16 @@ msgid "Lists example files or directories to be installed." msgstr "listet zu installierende Beispieldateien oder -verzeichnisse auf" #. type: textblock -#: dh_installexamples:50 +#: dh_installexamples:39 +msgid "" +"If upstream provides an F<examples> directory, you will often want to use " +"B<examples/*> rather than B<examples> in this file. The latter would create " +"F<< /usr/share/doc/I<package>/examples/examples >>, which is rarely what you " +"want." +msgstr "" + +#. type: textblock +#: dh_installexamples:54 msgid "" "Install any files specified by command line parameters in ALL packages acted " "on." @@ -8547,7 +9268,7 @@ msgstr "" "ALLEN Paketen, auf die es sich auswirkt." #. type: textblock -#: dh_installexamples:58 +#: dh_installexamples:62 msgid "" "Note that this is not the same as the B<--sourcedirectory> option used by " "the B<dh_auto_>I<*> commands. You rarely need to use this option, since " @@ -8561,7 +9282,7 @@ msgstr "" "Dateien sucht." #. type: textblock -#: dh_installexamples:75 +#: dh_installexamples:79 msgid "" "This option cannot be used when B<dh_installexamples> is instructed to act " "on multiple packages. If you need this option, you will generally need to " @@ -8573,7 +9294,7 @@ msgstr "" "sicherzustellen, dass auf genau ein Paket eingewirkt wird." #. type: textblock -#: dh_installexamples:82 +#: dh_installexamples:86 msgid "" "Exclude files that contain I<item> anywhere in their filename from being " "installed." @@ -8582,7 +9303,7 @@ msgstr "" "I<Element> enthalten" #. type: textblock -#: dh_installexamples:87 +#: dh_installexamples:91 msgid "" "Install these files (or directories) as examples into the first package " "acted on. (Or into all packages if B<-A> is specified.)" @@ -8592,7 +9313,7 @@ msgstr "" "wurde)." #. type: textblock -#: dh_installexamples:94 +#: dh_installexamples:98 msgid "" "Note that B<dh_installexamples> will happily copy entire directory " "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to " @@ -8841,9 +9562,15 @@ msgstr "debian/I<Paket>.service" #. type: textblock #: dh_installinit:67 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into lib/systemd/system/I<package>." +#| "service in the package build directory. Only used in compat levels 10 and " +#| "below." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"in the package build directory. Only used in compat levels 10 and below." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> in the package build directory. Only used in compat levels 10 and " +"below." msgstr "" "Falls vorhanden, wird es in lib/systemd/system/I<Paket>.service im " "Paketbauverzeichnis installiert. Wird nur in Kompatibilitätsstufen 10 und " @@ -8856,28 +9583,31 @@ msgstr "debian/I<Paket>.tmpfile" #. type: textblock #: dh_installinit:72 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into lib/systemd/system/I<package>." +#| "service in the package build directory. Only used in compat levels 10 and " +#| "below." msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.) Only used in compat levels 10 and below." +"the package build directory. Only used in compat levels 10 and below." msgstr "" -"Falls vorhanden, wird es in usr/lib/tmpfiles.d/I<Paket>.conf im " -"Paketbauverzeichnis installiert. (Der »tmpfiles.d«-Mechanismus wird derzeit " -"nur von Systemd benutzt.) Wird nur in Kompatibilitätsstufe 10 und darunter " -"eingesetzt." +"Falls vorhanden, wird es in lib/systemd/system/I<Paket>.service im " +"Paketbauverzeichnis installiert. Wird nur in Kompatibilitätsstufen 10 und " +"darunter benutzt." #. type: textblock -#: dh_installinit:84 +#: dh_installinit:83 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts." msgstr "ändert keine F<postinst>-/F<postrm>/F<prerm>-Skripte." #. type: =item -#: dh_installinit:86 +#: dh_installinit:85 msgid "B<-o>, B<--only-scripts>" msgstr "B<-o>, B<--only-scripts>" #. type: textblock -#: dh_installinit:88 +#: dh_installinit:87 msgid "" "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install " "any init script, default files, upstart job or systemd service file. May be " @@ -8891,7 +9621,7 @@ msgstr "" "sie zu finden." #. type: textblock -#: dh_installinit:93 +#: dh_installinit:92 msgid "" "B<Caveat>: This will bypass all the regular checks and I<unconditionally> " "modify the scripts. You will almost certainly want to use this with B<-p> " @@ -8903,7 +9633,7 @@ msgstr "" "Beispiel:" #. type: verbatim -#: dh_installinit:98 +#: dh_installinit:97 #, no-wrap msgid "" " override_dh_installinit:\n" @@ -8917,12 +9647,12 @@ msgstr "" "\n" #. type: =item -#: dh_installinit:102 +#: dh_installinit:101 msgid "B<-R>, B<--restart-after-upgrade>" msgstr "B<-R>, B<--restart-after-upgrade>" #. type: textblock -#: dh_installinit:104 +#: dh_installinit:103 msgid "" "Do not stop the init script until after the package upgrade has been " "completed. This is the default behaviour in compat 10." @@ -8931,7 +9661,7 @@ msgstr "" "wurde. Dies ist das Standardverhalten für Kompatibilitätsmodus 10." #. type: textblock -#: dh_installinit:107 +#: dh_installinit:106 msgid "" "In early compat levels, the default was to stop the script in the F<prerm>, " "and starts it again in the F<postinst>." @@ -8940,7 +9670,7 @@ msgstr "" "F<prerm> stoppt und es in F<postinst> wieder startet." #. type: textblock -#: dh_installinit:110 dh_systemd_start:45 +#: dh_installinit:109 dh_systemd_start:45 msgid "" "This can be useful for daemons that should not have a possibly long downtime " "during upgrade. But you should make sure that the daemon will not get " @@ -8953,12 +9683,12 @@ msgstr "" "sein Paket ausgetauscht wird." #. type: =item -#: dh_installinit:115 dh_systemd_start:50 +#: dh_installinit:114 dh_systemd_start:50 msgid "B<--no-restart-after-upgrade>" msgstr "B<--no-restart-after-upgrade>" #. type: textblock -#: dh_installinit:117 dh_systemd_start:52 +#: dh_installinit:116 dh_systemd_start:52 msgid "" "Undo a previous B<--restart-after-upgrade> (or the default of compat 10). " "If no other options are given, this will cause the service to be stopped in " @@ -8970,12 +9700,12 @@ msgstr "" "gestoppt und im F<postinst>-Skript wieder gestartet wird." #. type: =item -#: dh_installinit:122 dh_systemd_start:57 +#: dh_installinit:121 dh_systemd_start:57 msgid "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" msgstr "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" #. type: textblock -#: dh_installinit:124 +#: dh_installinit:123 msgid "" "Do not stop init script on upgrade. This has the side-effect of not " "restarting the service as a part of the upgrade." @@ -8984,7 +9714,7 @@ msgstr "" "dass der Dienst nicht als Teil des Upgrades neu gestartet wird." #. type: textblock -#: dh_installinit:127 +#: dh_installinit:126 msgid "" "If you want to restart the service with minimal downtime, please use B<--" "restart-after-upgrade> (default in compat 10 or later). If you want the " @@ -8998,7 +9728,7 @@ msgstr "" "no-restart-after-upgrade> (beachten Sie das »after-upgrade«)." #. type: textblock -#: dh_installinit:132 +#: dh_installinit:131 msgid "" "Note that the B<--no-restart-on-upgrade> alias is deprecated and will be " "removed in compat 12. This is to avoid confusion with the B<--no-restart-" @@ -9011,12 +9741,12 @@ msgstr "" "wurde in Debhelper 10.2 (enthalten in Debian Stretch) eingeführt." #. type: =item -#: dh_installinit:137 dh_systemd_start:61 +#: dh_installinit:136 dh_systemd_start:61 msgid "B<--no-start>" msgstr "B<--no-start>" #. type: textblock -#: dh_installinit:139 +#: dh_installinit:138 msgid "" "Do not start the init script on install or upgrade, or stop it on removal. " "Only call B<update-rc.d>. Useful for rcS scripts." @@ -9026,12 +9756,12 @@ msgstr "" "für rcS-Skripte." #. type: =item -#: dh_installinit:142 dh_systemd_enable:87 +#: dh_installinit:141 dh_systemd_enable:86 msgid "B<--no-enable>" msgstr "B<--no-enable>" #. type: textblock -#: dh_installinit:144 +#: dh_installinit:143 msgid "" "Disable the init script on purge, but do not enable them on install. This " "implies a versioned dependency on B<< init-system-helpers (E<gt>= 1.51) >> " @@ -9045,7 +9775,7 @@ msgstr "" "disabled >> unterstützt." #. type: textblock -#: dh_installinit:149 +#: dh_installinit:148 msgid "" "B<Note> that this option does not affect whether the services are started. " "Please remember to also use B<--no-start> if the service should not be " @@ -9056,7 +9786,7 @@ msgstr "" "falls der Dienst nicht gestartet werden soll." #. type: textblock -#: dh_installinit:153 +#: dh_installinit:152 msgid "" "Cannot be combined with B<-u>I<params>, B<--update-rcd-params=>I<params>, or " "B<--> I<params>." @@ -9065,12 +9795,12 @@ msgstr "" "B<--> I<Parameter> kombiniert werden." #. type: =item -#: dh_installinit:156 +#: dh_installinit:155 msgid "B<-d>, B<--remove-d>" msgstr "B<-d>, B<--remove-d>" #. type: textblock -#: dh_installinit:158 +#: dh_installinit:157 msgid "" "Remove trailing B<d> from the name of the package, and use the result for " "the filename the upstart job file is installed as in F<etc/init/> , and for " @@ -9087,12 +9817,12 @@ msgstr "" "beschriebenen Parameter B<--init-script>.)" #. type: =item -#: dh_installinit:165 +#: dh_installinit:164 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>" msgstr "B<-u>I<Parameter> B<--update-rcd-params=>I<Parameter>" #. type: textblock -#: dh_installinit:169 +#: dh_installinit:168 msgid "" "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> (or " "B<defaults-disabled> with B<--no-enable>) will be passed to L<update-rc." @@ -9103,12 +9833,12 @@ msgstr "" "d(8)> übergeben." #. type: textblock -#: dh_installinit:173 +#: dh_installinit:172 msgid "Cannot be combined with B<--no-enable>." msgstr "kann nicht mit B<--no-enable> kombiniert werden" #. type: textblock -#: dh_installinit:177 +#: dh_installinit:176 msgid "" "Install the init script (and default file) as well as upstart job file using " "the filename I<name> instead of the default filename, which is the package " @@ -9126,12 +9856,12 @@ msgstr "" "init>, F<debian/package.default> and F<debian/package.upstart>." #. type: =item -#: dh_installinit:185 +#: dh_installinit:184 msgid "B<--init-script=>I<scriptname>" msgstr "B<--init-script=>I<Skriptname>" #. type: textblock -#: dh_installinit:187 +#: dh_installinit:186 msgid "" "Use I<scriptname> as the filename the init script is installed as in F<etc/" "init.d/> (and also use it as the filename for the defaults file, if it is " @@ -9149,7 +9879,7 @@ msgstr "" "vorziehen." #. type: textblock -#: dh_installinit:194 +#: dh_installinit:193 msgid "" "This parameter is deprecated, use the B<--name> parameter instead. This " "parameter is incompatible with the use of upstart jobs." @@ -9158,12 +9888,12 @@ msgstr "" "Desweiteren ist er für die Benutzung mit Upstart-Jobs inkompatibel." #. type: =item -#: dh_installinit:197 +#: dh_installinit:196 msgid "B<--error-handler=>I<function>" msgstr "B<--error-handler=>I<Funktion>" #. type: textblock -#: dh_installinit:199 +#: dh_installinit:198 msgid "" "Call the named shell I<function> if running the init script fails. The " "function should be provided in the F<prerm> and F<postinst> scripts, before " @@ -9174,17 +9904,17 @@ msgstr "" "F<postinst>-Skripten vor der Markierung B<#DEBHELPER#> bereitgestellt werden." #. type: textblock -#: dh_installinit:432 +#: dh_installinit:415 msgid "L<debhelper(7)>, L<dh_installsystemd(1)>" msgstr "L<debhelper(7)>, L<dh_installsystemd(1)>" #. type: textblock -#: dh_installinit:440 +#: dh_installinit:423 msgid "Steve Langasek <steve.langasek@canonical.com>" msgstr "Steve Langasek <steve.langasek@canonical.com>" #. type: textblock -#: dh_installinit:442 +#: dh_installinit:425 msgid "Michael Stapelberg <stapelberg@debian.org>" msgstr "Michael Stapelberg <stapelberg@debian.org>" @@ -9939,15 +10669,42 @@ msgstr "debian/I<Paket>.pam" #. type: textblock #: dh_installpam:30 -msgid "Installed into etc/pam.d/I<package> in the package build directory." +#, fuzzy +#| msgid "Installed into etc/pam.d/I<package> in the package build directory." +msgid "Installed into usr/lib/pam.d/I<package> in the package build directory." msgstr "installiert in etc/pam.d/I<Paket> im Paketbauverzeichnis" #. type: textblock -#: dh_installpam:40 +#: dh_installpam:32 +#, fuzzy +#| msgid "" +#| "In compatibility level 11, this file will trigger an error with a " +#| "reminder about ensuring the proper removal of the upstart file in the " +#| "previous package version. Please consider using the \"rm_conffile\" " +#| "feature from L<dh_installdeb(1)> to ensure the proper removal of previous " +#| "upstart files." msgid "" -"Look for files named debian/I<package>.I<name>.pam and install them as etc/" -"pam.d/I<name>, instead of using the usual files and installing them using " -"the package name." +"Until compatibility level 14 this file was installed under etc/pam.d/" +"I<package>. Please consider using the \"rm_conffile\" feature from " +"L<dh_installdeb(1)> to ensure the proper removal of previous PAM files." +msgstr "" +"In Kompatibilitätsstufe 11 wird diese Datei einen Fehler auslösen, der daran " +"erinnert, dass das ordentliche Entfernen der Upstart-Datei in der vorherigen " +"Paketversion sichergestellt werden soll. Bitte ziehen Sie die Verwendung der " +"Funktionalität »rm_conffile« von L<dh_installdeb(1)> in Betracht, um das " +"ordentliche Entfernen früherer Upstart-Dateien sicherzustellen." + +#. type: textblock +#: dh_installpam:44 +#, fuzzy +#| msgid "" +#| "Look for files named debian/I<package>.I<name>.pam and install them as " +#| "etc/pam.d/I<name>, instead of using the usual files and installing them " +#| "using the package name." +msgid "" +"Look for files named debian/I<package>.I<name>.pam and install them as usr/" +"lib/pam.d/I<name>, instead of using the usual files and installing them " +"using the package name." msgstr "" "sucht nach Dateien mit Namen debian/I<Paket>.I<Name>.pam und installiert sie " "als etc/pam.d/I<Name>, anstatt die üblichen Dateien zu verwenden und sie " @@ -10184,8 +10941,8 @@ msgid "" "Depends}>.)" msgstr "" "Ihr Paket sollte von B<xfonts-utils> abhängen, so dass die B<update-fonts-" -">I<*>-Befehle verfügbar sind. (Dieses Programm fügt diese Abhängigkeit B<" -"${misc:Depends}> hinzu.)" +">I<*>-Befehle verfügbar sind. (Dieses Programm fügt diese Abhängigkeit " +"B<${misc:Depends}> hinzu.)" #. type: textblock #: dh_installxfonts:35 @@ -11028,9 +11785,13 @@ msgstr "B<-x>, B<--include-conffiles>" #. type: textblock #: dh_md5sums:37 +#, fuzzy +#| msgid "" +#| "Include conffiles in the md5sums list. Note that this information is " +#| "redundant since it is included elsewhere in Debian packages." msgid "" "Include conffiles in the md5sums list. Note that this information is " -"redundant since it is included elsewhere in Debian packages." +"redundant since it is included in F</var/lib/dpkg/status> in Debian packages." msgstr "" "fügt Conffiles in die Md5sums-Liste ein. Beachten Sie, dass diese " "Information überflüssig ist, da sie anderswo in Debian-Paketen enthalten ist." @@ -11170,24 +11931,24 @@ msgid "dh_perl - calculates Perl dependencies and cleans up after MakeMaker" msgstr "dh_perl - berechnet Perl-Abhängigkeiten und räumt nach MakeMaker auf" #. type: textblock -#: dh_perl:19 +#: dh_perl:20 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]" msgstr "" "B<dh_perl> [S<I<Debhelper-Optionen>>] [B<-d>] " "[S<I<Bibliothekenverzeichnisse> …>]" #. type: textblock -#: dh_perl:23 +#: dh_perl:24 msgid "" -"B<dh_perl> is a debhelper program that is responsible for generating the B<" -"${perl:Depends}> substitutions and adding them to substvars files." +"B<dh_perl> is a debhelper program that is responsible for generating the " +"B<${perl:Depends}> substitutions and adding them to substvars files." msgstr "" "B<dh_perl> ist ein Debhelper-Programm, das für das Erzeugen der B<${perl:" "Depends}>-Ersetzung zuständig ist und um diese dann den Substvars-Dateien " "hinzuzufügen." #. type: textblock -#: dh_perl:26 +#: dh_perl:27 msgid "" "The program will look at Perl scripts and modules in your package, and will " "use this information to generate a dependency on B<perl> or B<perlapi>. The " @@ -11200,7 +11961,7 @@ msgstr "" "eingesetzt, wo Sie die Markierung B<${perl:Depends}> platzieren." #. type: textblock -#: dh_perl:31 +#: dh_perl:32 msgid "" "B<dh_perl> also cleans up empty directories that MakeMaker can generate when " "installing Perl modules." @@ -11209,12 +11970,12 @@ msgstr "" "kann, wenn es Perl-Module installiert." #. type: =item -#: dh_perl:38 +#: dh_perl:39 msgid "B<-d>" msgstr "B<-d>" #. type: textblock -#: dh_perl:40 +#: dh_perl:41 msgid "" "In some specific cases you may want to depend on B<perl-base> rather than " "the full B<perl> package. If so, you can pass the -d option to make " @@ -11228,7 +11989,7 @@ msgstr "" "im Basissystem enthalten sind." #. type: textblock -#: dh_perl:45 +#: dh_perl:46 msgid "" "Note that this flag may cause no dependency on B<perl-base> to be generated " "at all. B<perl-base> is Essential, so its dependency can be left out, unless " @@ -11240,12 +12001,12 @@ msgstr "" "werden, außer wenn eine versionsbasierte Abhängigkeit nötig ist." #. type: =item -#: dh_perl:49 +#: dh_perl:50 msgid "B<-V>" msgstr "B<-V>" #. type: textblock -#: dh_perl:51 +#: dh_perl:52 msgid "" "By default, scripts and architecture independent modules don't depend on any " "specific version of B<perl>. The B<-V> option causes the current version of " @@ -11257,12 +12018,12 @@ msgstr "" "angegeben wird." #. type: =item -#: dh_perl:55 +#: dh_perl:56 msgid "I<library dirs>" msgstr "<I<Bibliothekenverzeichnisse>" #. type: textblock -#: dh_perl:57 +#: dh_perl:58 msgid "" "If your package installs Perl modules in non-standard directories, you can " "make B<dh_perl> check those directories by passing their names on the " @@ -11275,17 +12036,17 @@ msgstr "" "Verzeichnisse F<vendorlib> und F<vendorarch> prüfen." #. type: textblock -#: dh_perl:66 +#: dh_perl:67 msgid "Debian policy, version 3.8.3" msgstr "Debian-Richtlinie, Version 3.8.3" #. type: textblock -#: dh_perl:68 +#: dh_perl:69 msgid "Perl policy, version 1.20" msgstr "Perl-Richtlinie, Version 1.20" #. type: textblock -#: dh_perl:182 +#: dh_perl:196 msgid "Brendan O'Dea <bod@debian.org>" msgstr "Brendan O'Dea <bod@debian.org>" @@ -11795,8 +12556,8 @@ msgid "" "adding B<noautodbgsym> to the B<DEB_BUILD_OPTIONS> environment variable. " "However, B<dh_strip> will still add debuglinks to ELF binaries when this " "flag is set. This is to ensure that the regular deb package will be " -"identical with and without this flag (assuming it is otherwise \"bit-for-bit" -"\" reproducible)." +"identical with and without this flag (assuming it is otherwise \"bit-for-" +"bit\" reproducible)." msgstr "" "Das automatische Erzeugen von Symbolpaketen zur Fehlersuche kann außerdem " "durch Hinzufügen von B<noautodbgsym> zur Umgebungsvariablen " @@ -12111,103 +12872,135 @@ msgstr "debian/I<Paket>.service, debian/I<Paket>@.service" #. type: textblock #: dh_systemd_enable:47 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into lib/systemd/system/I<package>." +#| "service (or lib/systemd/system/I<package>@.service) in the package build " +#| "directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"(or lib/systemd/system/I<package>@.service) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> (or F<< lib/systemd/system/I<package>@.service >>) in the package " +"build directory." msgstr "" "Falls vorhanden, wird es in lib/systemd/system/I<Paket>.service (oder lib/" "systemd/system/I<Paket>@.service) im Paketbauverzeichnis installiert." #. type: textblock #: dh_systemd_enable:52 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into etc/init.d/I<package> in the package " +#| "build directory." msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.)" +"the package build directory." msgstr "" -"Falls vorhanden, wird es in usr/lib/tmpfiles.d/I<Paket>.conf im " -"Paketbauverzeichnis installiert. (Der »tmpfiles.d«-Mechanismus wird derzeit " -"nur von Systemd benutzt.)" +"Falls vorhanden, wird es in etc/init.d/I<Paket> im Paketbauverzeichnis " +"installiert." #. type: =item -#: dh_systemd_enable:56 +#: dh_systemd_enable:55 msgid "debian/I<package>.target, debian/I<package>@.target" msgstr "debian/I<Paket>.target, debian/I<Paket>@.target" #. type: textblock -#: dh_systemd_enable:58 +#: dh_systemd_enable:57 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into lib/systemd/system/I<package>.target " +#| "(or lib/systemd/system/I<package>@.target) in the package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.target " -"(or lib/systemd/system/I<package>@.target) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"target >> (or F<< lib/systemd/system/I<package>@.target >>) in the package " +"build directory." msgstr "" "Falls vorhanden, wird es in lib/systemd/system/I<Paket>.target (oder lib/" "systemd/system/I<Paket>@.target) im Paketbauverzeichnis installiert." #. type: =item -#: dh_systemd_enable:61 +#: dh_systemd_enable:60 msgid "debian/I<package>.socket, debian/I<package>@.socket" msgstr "debian/I<Paket>.socket, debian/I<Paket>@.socket" #. type: textblock -#: dh_systemd_enable:63 +#: dh_systemd_enable:62 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into lib/systemd/system/I<package>.socket " +#| "(or lib/systemd/system/I<package>@.socket) in the package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.socket " -"(or lib/systemd/system/I<package>@.socket) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"socket >> (or F<< lib/systemd/system/I<package>@.socket >>) in the package " +"build directory." msgstr "" "Falls vorhanden, wird es in lib/systemd/system/I<Paket>.socket (oder lib/" "systemd/system/I<Paket>@.socket) im Paketbauverzeichnis installiert." #. type: =item -#: dh_systemd_enable:66 +#: dh_systemd_enable:65 msgid "debian/I<package>.mount" msgstr "debian/I<Paket>.mount" #. type: textblock -#: dh_systemd_enable:68 +#: dh_systemd_enable:67 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into lib/systemd/system/I<package>.mount " +#| "in the package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.mount in " -"the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.mount " +">> in the package build directory." msgstr "" "Falls vorhanden, wird es in lib/systemd/system/I<Paket>.mount im " "Paketbauverzeichnis installiert." #. type: =item -#: dh_systemd_enable:71 +#: dh_systemd_enable:70 msgid "debian/I<package>.path, debian/I<package>@.path" msgstr "debian/I<Paket>.path, debian/I<Paket>@.path" #. type: textblock -#: dh_systemd_enable:73 +#: dh_systemd_enable:72 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into lib/systemd/system/I<package>.path " +#| "(or lib/systemd/system/I<package>@.path) in the package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.path (or " -"lib/systemd/system/I<package>@.path) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.path " +">> (or F<< lib/systemd/system/I<package>@.path >>) in the package build " +"directory." msgstr "" "Falls vorhanden, wird es in lib/systemd/system/I<Paket>.path (oder lib/" "systemd/system/I<Paket>@.path) im Paketbauverzeichnis installiert." #. type: =item -#: dh_systemd_enable:76 +#: dh_systemd_enable:75 msgid "debian/I<package>.timer, debian/I<package>@.timer" msgstr "debian/I<Paket>.timer, debian/I<Paket>@.timer" #. type: textblock -#: dh_systemd_enable:78 +#: dh_systemd_enable:77 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into lib/systemd/system/I<package>.timer " +#| "(or lib/systemd/system/I<package>@.timer) in the package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.timer (or " -"lib/systemd/system/I<package>@.timer) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.timer " +">> (or F<< lib/systemd/system/I<package>@.timer >>) in the package build " +"directory." msgstr "" "Falls vorhanden, wird es in lib/systemd/system/I<Paket>.timer (oder lib/" "systemd/system/I<Paket>@.timer) im Paketbauverzeichnis installiert." #. type: textblock -#: dh_systemd_enable:89 +#: dh_systemd_enable:88 msgid "Disable the service(s) on purge, but do not enable them on install." msgstr "" "deaktiviert nur den Dienst oder die Dienste beim vollständigen Löschen, " "aktiviert sie aber nicht bei der Installation." #. type: textblock -#: dh_systemd_enable:91 +#: dh_systemd_enable:90 msgid "" "B<Note> that this option does not affect whether the services are started. " "That is controlled by L<dh_systemd_start(1)> (using e.g. its B<--no-start> " @@ -12218,7 +13011,7 @@ msgstr "" "durch seine B<--no-start>-Option)." #. type: textblock -#: dh_systemd_enable:97 +#: dh_systemd_enable:96 msgid "" "Install the service file as I<name.service> instead of the default filename, " "which is the I<package.service>. When this parameter is used, " @@ -12231,7 +13024,7 @@ msgstr "" "Name.service> anstelle der üblichen F<debian/Paket.service>." #. type: textblock -#: dh_systemd_enable:106 dh_systemd_start:70 +#: dh_systemd_enable:105 dh_systemd_start:70 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " "between invocations of this command (with the same arguments). Otherwise, it " @@ -12244,7 +13037,7 @@ msgstr "" "Betreuerskripten mehrere Instanzen des gleichen Textes hinzugefügt werden." #. type: textblock -#: dh_systemd_enable:111 +#: dh_systemd_enable:110 msgid "" "Note that B<dh_systemd_enable> should be run before B<dh_installinit>. The " "default sequence in B<dh> does the right thing, this note is only relevant " @@ -12255,12 +13048,12 @@ msgstr "" "Hinweis ist nur relevant, wenn Sie B<dh_systemd_enable> manuell aufrufen." #. type: textblock -#: dh_systemd_enable:283 +#: dh_systemd_enable:282 msgid "L<dh_systemd_start(1)>, L<debhelper(7)>" msgstr "L<dh_systemd_start(1)>, L<debhelper(7)>" #. type: textblock -#: dh_systemd_enable:287 dh_systemd_start:286 +#: dh_systemd_enable:286 dh_systemd_start:286 msgid "pkg-systemd-maintainers@lists.alioth.debian.org" msgstr "pkg-systemd-maintainers@lists.alioth.debian.org" @@ -12361,6 +13154,149 @@ msgstr "" msgid "This compatibility level is open for beta testing; changes may occur." msgstr "Diese Kompatibilitätsstufe ist im Beta-Test; Änderungen sind möglich." +#~ msgid "" +#~ "Set to B<1> to enable verbose mode. Debhelper will output every command " +#~ "it runs. Also enables verbose build logs for some build systems like " +#~ "autoconf." +#~ msgstr "" +#~ "auf B<1> gesetzt, um den Modus mit detailreicher Ausgabe zu aktivieren. " +#~ "Debhelper wird jeden von ihm ausgeführten Befehl ausgeben. Außerdem wird " +#~ "die detailreiche Ausgabe von Bauprotokollen für einige Bausysteme wie " +#~ "Autoconf aktiviert." + +#~ msgid "This value affects most B<dh_auto_*> tools." +#~ msgstr "Dieser Wert betrifft die meisten B<dh_auto_*>-Werkzeuge." + +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.) Only used in compat levels 10 and below." +#~ msgstr "" +#~ "Falls vorhanden, wird es in usr/lib/tmpfiles.d/I<Paket>.conf im " +#~ "Paketbauverzeichnis installiert. (Der »tmpfiles.d«-Mechanismus wird " +#~ "derzeit nur von Systemd benutzt.) Wird nur in Kompatibilitätsstufe 10 und " +#~ "darunter eingesetzt." + +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.)" +#~ msgstr "" +#~ "Falls vorhanden, wird es in usr/lib/tmpfiles.d/I<Paket>.conf im " +#~ "Paketbauverzeichnis installiert. (Der »tmpfiles.d«-Mechanismus wird " +#~ "derzeit nur von Systemd benutzt.)" + +#, fuzzy +#~| msgid "" +#~| "This can cause issues with running binaries directly from the build " +#~| "directories as they might now require a manually set " +#~| "B<LD_LIBRARY_PATH>. If you need to override this change, we recommend " +#~| "that you try to pass the B<-DCMAKE_SKIP_RPATH=OFF> option first to see " +#~| "if that fixes the problem (leaving B<BUILD_RPATH_USE_ORIGIN> at its new " +#~| "default). This should undo the need for B<LD_LIBRARY_PATH> and avoid " +#~| "the reproducibility issues on Linux, where B<$ORIGIN> is supported by " +#~| "the runtime linkers." +#~ msgid "" +#~ "This can cause issues with running binaries directly from the build " +#~ "directories as they might now require a manually set B<LD_LIBRARY_PATH>. " +#~ "If you need to override this change, we recommend that you try to pass " +#~ "the B<-DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the " +#~ "problem (leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). " +#~ "This should undo the need for B<LD_LIBRARY_PATH> and avoid the " +#~ "reproducibility issues on Linux, where B<$ORIGIN> is supported by the " +#~ "runtime linkers." +#~ msgstr "" +#~ "Daraus können sich Probleme mit Binärdateien ergeben, welche direkt aus " +#~ "dem Bauverzeichnis heraus aufgeführt werden, weil dafür jetzt ein per " +#~ "Hand gesetztes B<LD_LIBRARY_PATH> erforderlich sein kann. Wenn Sie diese " +#~ "Änderung außer Kraft setzen müssen, empfehlen wir, dass Sie zuerst " +#~ "versuchsweise die B<-DCMAKE_SKIP_RPATH=OFF>-Option übergeben, um zu " +#~ "sehen, ob sie ausreicht, um das Problem zu lösen (sodass " +#~ "B<BUILD_RPATH_USE_ORIGIN> seinen neuen Standardwert behalten kann). Auf " +#~ "diese Weise sollten sich der Bedarf für B<LD_LIBRARY_PATH> erübrigen und " +#~ "die Reproduzierbarkeitsprobleme unter Linux, woB<$ORIGIN> von den " +#~ "Laufzeit-Linkern unterstützt wird, vermieden werden." + +#~ msgid "" +#~ "Historically, this file was needed to manually mark files files as " +#~ "conffiles. However, it has become de facto obsolete since debhelper " +#~ "automatically computed which files should be marked as conffiles." +#~ msgstr "" +#~ "Früher wurde diese Datei benötigt, um Dateien manuell als Conffiles zu " +#~ "markieren. Allerdings wurde es faktisch überflüssig, seit Debhelper " +#~ "automatisch berechnet, welche Dateien als Conffiles markiert werden " +#~ "sollen." + +#~ msgid "" +#~ "In compatibility level up and including 11, this control file will be " +#~ "installed into the F<DEBIAN> directory. In compatibility level 12 and " +#~ "later, the file is silently ignored." +#~ msgstr "" +#~ "Auf Kompatibilitätsstufen 11 und darunter wird diese Steuerdatei im " +#~ "Verzeichnis F<DEBIAN> installiert. Auf Kompatibilitätsstufe 12 und neuer " +#~ "wird diese Datei stillschweigend ignoriert." + +#~ msgid "" +#~ "dh_gconf - install GConf defaults files and register schemas (deprecated)" +#~ msgstr "" +#~ "dh_gconf - installiert Standard-GConf-Dateien und registriert Schemata " +#~ "(missbilligt)" + +#~ msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" +#~ msgstr "B<dh_gconf> [S<I<Debhelper-Optionen>>] [B<--priority=>I<Priorität>]" + +#~ msgid "" +#~ "B<dh_gconf> is a debhelper program that is responsible for installing " +#~ "GConf defaults files and registering GConf schemas." +#~ msgstr "" +#~ "B<dh_gconf> ist ein Debhelper-Programm, das für die Installation der " +#~ "Standard-GConf-Dateien und das Registrieren der GConf-Schemata zuständig " +#~ "ist." + +#~ msgid "" +#~ "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}" +#~ ">." +#~ msgstr "" +#~ "Eine geeignete Abhängigkeit zu gconf2 wird in B<${misc:Depends}> erzeugt." + +#~ msgid "debian/I<package>.gconf-defaults" +#~ msgstr "debian/I<Paket>.gconf-defaults" + +#~ msgid "" +#~ "Installed into F<usr/share/gconf/defaults/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "installiert in F<usr/share/gconf/defaults/10_package> im Bauverzeichnis " +#~ "des Pakets, wobei I<Paket> durch den Namen des Pakets ersetzt wird." + +#~ msgid "debian/I<package>.gconf-mandatory" +#~ msgstr "debian/I<Paket>.gconf-mandatory" + +#~ msgid "" +#~ "Installed into F<usr/share/gconf/mandatory/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "installiert in F<usr/share/gconf/mandatory/10_package> im Bauverzeichnis " +#~ "des Pakets, wobei I<Paket> durch den Namen des Pakets ersetzt wird." + +#~ msgid "B<--priority> I<priority>" +#~ msgstr "B<--priority> I<Priorität>" + +#~ msgid "" +#~ "Use I<priority> (which should be a 2-digit number) as the defaults " +#~ "priority instead of B<10>. Higher values than ten can be used by derived " +#~ "distributions (B<20>), CDD distributions (B<50>), or site-specific " +#~ "packages (B<90>)." +#~ msgstr "" +#~ "benutzt I<Priorität> (welche eine zweistellige Zahl sein sollte) als " +#~ "Standardpriorität an Stelle von B<10>. Höhere Werte als zehn können durch " +#~ "abgeleitete Distributionen (B<20>), CDD-Distributionen (B<50>) oder Site-" +#~ "spezifische Pakete (B<90>) verwendet werden." + +#~ msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" +#~ msgstr "" +#~ "Ross Burton <ross@burtonini.com>, Josselin Mouette <joss@debian.org>" + #~ msgid "" #~ "B<dh_clean> should be the last debhelper command run in the B<clean> " #~ "target in F<debian/rules>." diff --git a/man/po4a/po/debhelper.pot b/man/po4a/po/debhelper.pot index 3142571a85e663147046349cddab344c84d61c86..4f007466febd1d771b6db22b6c2dce44ed10b6b9 100644 --- a/man/po4a/po/debhelper.pot +++ b/man/po4a/po/debhelper.pot @@ -7,7 +7,7 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" -"POT-Creation-Date: 2021-02-22 09:37+0100\n" +"POT-Creation-Date: 2022-11-20 19:46+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" @@ -17,10 +17,11 @@ msgstr "" "Content-Transfer-Encoding: 8bit\n" #. type: =head1 -#: debhelper.pod:3 debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 -#: dh_auto_clean:3 dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 -#: dh_bugfiles:3 dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 -#: dh_gconf:3 dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 +#: debhelper.pod:3 debhelper-compat-upgrade-checklist.pod:3 +#: debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 dh_auto_clean:3 +#: dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 dh_bugfiles:3 +#: dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 +#: dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 #: dh_installchangelogs:3 dh_installcron:3 dh_installdeb:3 dh_installdebconf:3 #: dh_installdirs:3 dh_installdocs:5 dh_installemacsen:3 dh_installexamples:5 #: dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installinitramfs:3 @@ -40,19 +41,20 @@ msgid "debhelper - the debhelper tool suite" msgstr "" #. type: =head1 -#: debhelper.pod:7 debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 -#: dh_auto_clean:16 dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 -#: dh_bugfiles:15 dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 -#: dh_fixperms:16 dh_gconf:15 dh_gencontrol:16 dh_icons:16 dh_install:15 -#: dh_installcatalogs:17 dh_installchangelogs:15 dh_installcron:15 -#: dh_installdeb:15 dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 +#: debhelper.pod:7 debhelper-compat-upgrade-checklist.pod:7 +#: debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 dh_auto_clean:16 +#: dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 dh_bugfiles:15 +#: dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 dh_fixperms:16 +#: dh_gencontrol:16 dh_icons:16 dh_install:15 dh_installcatalogs:17 +#: dh_installchangelogs:16 dh_installcron:15 dh_installdeb:15 +#: dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 #: dh_installemacsen:15 dh_installexamples:17 dh_installifupdown:15 #: dh_installinfo:15 dh_installinit:16 dh_installinitramfs:15 #: dh_installlogcheck:15 dh_installlogrotate:15 dh_installman:16 #: dh_installmanpages:16 dh_installmenu:15 dh_installmime:15 #: dh_installmodules:16 dh_installpam:15 dh_installppp:15 dh_installudev:15 #: dh_installwm:15 dh_installxfonts:15 dh_link:16 dh_lintian:15 -#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:17 +#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:18 #: dh_prep:15 dh_shlibdeps:17 dh_strip:16 dh_testdir:15 dh_testroot:9 #: dh_usrlocal:19 dh_systemd_enable:16 dh_systemd_start:17 msgid "SYNOPSIS" @@ -66,19 +68,19 @@ msgid "" msgstr "" #. type: =head1 -#: debhelper.pod:11 dh:26 dh_auto_build:20 dh_auto_clean:20 -#: dh_auto_configure:20 dh_auto_install:22 dh_auto_test:20 dh_bugfiles:19 -#: dh_builddeb:21 dh_clean:19 dh_compress:21 dh_dwz:20 dh_fixperms:20 -#: dh_gconf:19 dh_gencontrol:20 dh_icons:20 dh_install:19 dh_installcatalogs:21 -#: dh_installchangelogs:19 dh_installcron:19 dh_installdeb:19 -#: dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 +#: debhelper.pod:11 debhelper-compat-upgrade-checklist.pod:17 dh:26 +#: dh_auto_build:20 dh_auto_clean:20 dh_auto_configure:20 dh_auto_install:22 +#: dh_auto_test:20 dh_bugfiles:19 dh_builddeb:21 dh_clean:19 dh_compress:21 +#: dh_dwz:20 dh_fixperms:20 dh_gencontrol:20 dh_icons:20 dh_install:19 +#: dh_installcatalogs:21 dh_installchangelogs:20 dh_installcron:19 +#: dh_installdeb:19 dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 #: dh_installemacsen:19 dh_installexamples:21 dh_installifupdown:19 #: dh_installinfo:19 dh_installinit:20 dh_installinitramfs:19 #: dh_installlogcheck:19 dh_installlogrotate:19 dh_installman:20 #: dh_installmanpages:20 dh_installmenu:19 dh_installmime:19 #: dh_installmodules:20 dh_installpam:19 dh_installppp:19 dh_installudev:19 #: dh_installwm:19 dh_installxfonts:19 dh_link:20 dh_lintian:19 -#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:21 +#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:22 #: dh_prep:19 dh_shlibdeps:21 dh_strip:20 dh_testdir:19 dh_testroot:13 #: dh_usrlocal:23 dh_systemd_enable:20 dh_systemd_start:21 msgid "DESCRIPTION" @@ -528,89 +530,96 @@ msgstr "" #. type: textblock #: debhelper.pod:277 -msgid "Verbose mode: show all commands that modify the package build directory." +msgid "Verbose mode: show commands that modify the package build directory." +msgstr "" + +#. type: textblock +#: debhelper.pod:279 +msgid "" +"Note that verbose mode may also output other \"internal\" commands that do " +"not directly affect the package build directory." msgstr "" #. type: =item -#: debhelper.pod:279 dh:266 +#: debhelper.pod:282 dh:307 msgid "B<--no-act>" msgstr "" #. type: textblock -#: debhelper.pod:281 +#: debhelper.pod:284 msgid "" "Do not really do anything. If used with -v, the result is that the command " "will output what it would have done." msgstr "" #. type: =item -#: debhelper.pod:284 +#: debhelper.pod:287 msgid "B<-a>, B<--arch>" msgstr "" #. type: textblock -#: debhelper.pod:286 +#: debhelper.pod:289 msgid "" "Act on architecture dependent packages that should be built for the " "B<DEB_HOST_ARCH> architecture." msgstr "" #. type: =item -#: debhelper.pod:289 +#: debhelper.pod:292 msgid "B<-i>, B<--indep>" msgstr "" #. type: textblock -#: debhelper.pod:291 +#: debhelper.pod:294 msgid "Act on all architecture independent packages." msgstr "" #. type: =item -#: debhelper.pod:293 +#: debhelper.pod:296 msgid "B<-p>I<package>, B<--package=>I<package>" msgstr "" #. type: textblock -#: debhelper.pod:295 +#: debhelper.pod:298 msgid "" "Act on the package named I<package>. This option may be specified multiple " "times to make debhelper operate on a given set of packages." msgstr "" #. type: =item -#: debhelper.pod:298 +#: debhelper.pod:301 msgid "B<-s>, B<--same-arch>" msgstr "" #. type: textblock -#: debhelper.pod:300 +#: debhelper.pod:303 msgid "Deprecated alias of B<-a>." msgstr "" #. type: textblock -#: debhelper.pod:302 dh_install:80 dh_install:89 +#: debhelper.pod:305 dh_install:80 dh_install:89 msgid "This option is removed in compat 12." msgstr "" #. type: =item -#: debhelper.pod:304 +#: debhelper.pod:307 msgid "B<-N>I<package>, B<--no-package=>I<package>" msgstr "" #. type: textblock -#: debhelper.pod:306 +#: debhelper.pod:309 msgid "" "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option " "lists the package as one that should be acted on." msgstr "" #. type: =item -#: debhelper.pod:309 +#: debhelper.pod:312 msgid "B<--remaining-packages>" msgstr "" #. type: textblock -#: debhelper.pod:311 +#: debhelper.pod:314 msgid "" "Do not act on the packages which have already been acted on by this " "debhelper command earlier (i.e. if the command is present in the package " @@ -620,22 +629,22 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:317 +#: debhelper.pod:320 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" msgstr "" #. type: textblock -#: debhelper.pod:319 +#: debhelper.pod:322 msgid "Use I<tmpdir> for package build directory. The default is debian/I<package>" msgstr "" #. type: =item -#: debhelper.pod:321 +#: debhelper.pod:324 msgid "B<--mainpackage=>I<package>" msgstr "" #. type: textblock -#: debhelper.pod:323 +#: debhelper.pod:326 msgid "" "This little-used option changes the package which debhelper considers the " "\"main package\", that is, the first one listed in F<debian/control>, and " @@ -644,12 +653,12 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:328 +#: debhelper.pod:331 msgid "B<-O=>I<option>|I<bundle>" msgstr "" #. type: textblock -#: debhelper.pod:330 +#: debhelper.pod:333 msgid "" "This is used by L<dh(1)> when passing user-specified options to all the " "commands it runs. If the command supports the specified option or option " @@ -658,12 +667,12 @@ msgid "" msgstr "" #. type: =head1 -#: debhelper.pod:337 +#: debhelper.pod:340 msgid "COMMON DEBHELPER OPTIONS" msgstr "" #. type: textblock -#: debhelper.pod:339 +#: debhelper.pod:342 msgid "" "The following command line options are supported by some debhelper " "programs. See the man page of each program for a complete explanation of " @@ -671,24 +680,24 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:345 +#: debhelper.pod:348 msgid "B<-n>" msgstr "" #. type: textblock -#: debhelper.pod:347 +#: debhelper.pod:350 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts." msgstr "" #. type: =item -#: debhelper.pod:349 dh_compress:56 dh_dwz:56 dh_installchangelogs:83 -#: dh_installdocs:109 dh_installexamples:80 dh_link:78 dh_makeshlibs:154 +#: debhelper.pod:352 dh_compress:56 dh_dwz:56 dh_installchangelogs:89 +#: dh_installdocs:109 dh_installexamples:84 dh_link:78 dh_makeshlibs:154 #: dh_md5sums:40 dh_shlibdeps:34 dh_strip:42 msgid "B<-X>I<item>, B<--exclude=>I<item>" msgstr "" #. type: textblock -#: debhelper.pod:351 +#: debhelper.pod:354 msgid "" "Exclude an item from processing. This option may be used multiple times, to " "exclude more than one thing. The I<item> is typically part of a filename, " @@ -696,26 +705,26 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:355 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 -#: dh_installdocs:104 dh_installexamples:48 dh_installinfo:45 dh_installman:90 +#: debhelper.pod:358 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 +#: dh_installdocs:104 dh_installexamples:52 dh_installinfo:45 dh_installman:90 #: dh_installwm:55 dh_link:73 msgid "B<-A>, B<--all>" msgstr "" #. type: textblock -#: debhelper.pod:357 +#: debhelper.pod:360 msgid "" "Makes files or other items that are specified on the command line take " "effect in ALL packages acted on, not just the first." msgstr "" #. type: =head1 -#: debhelper.pod:362 +#: debhelper.pod:365 msgid "BUILD SYSTEM OPTIONS" msgstr "" #. type: textblock -#: debhelper.pod:364 +#: debhelper.pod:367 msgid "" "The following command line options are supported by all of the " "B<dh_auto_>I<*> debhelper programs. These programs support a variety of " @@ -726,31 +735,31 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:373 +#: debhelper.pod:376 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>" msgstr "" #. type: textblock -#: debhelper.pod:375 +#: debhelper.pod:378 msgid "" "Force use of the specified I<buildsystem>, instead of trying to auto-select " "one which might be applicable for the package." msgstr "" #. type: textblock -#: debhelper.pod:378 +#: debhelper.pod:381 msgid "Pass B<none> as I<buildsystem> to disable auto-selection." msgstr "" #. type: =item -#: debhelper.pod:380 +#: debhelper.pod:383 msgid "" "B<-D>I<directory>, B<--sourcedir=>I<directory>, " "B<--sourcedirectory=>I<directory>" msgstr "" #. type: textblock -#: debhelper.pod:382 +#: debhelper.pod:385 msgid "" "Assume that the original package source tree is at the specified " "I<directory> rather than the top level directory of the Debian source " @@ -758,7 +767,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:386 +#: debhelper.pod:389 msgid "" "B<Warning>: The B<--sourcedir> variant matches a similar named option in " "B<dh_install> and B<dh_missing> (etc.) for historical reasons. While they " @@ -768,14 +777,14 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:392 +#: debhelper.pod:395 msgid "" "B<-B>[I<directory>], B<--builddir>[I<=directory>], " "B<--builddirectory>[I<=directory>]" msgstr "" #. type: textblock -#: debhelper.pod:394 +#: debhelper.pod:397 msgid "" "Enable out of source building and use the specified I<directory> as the " "build directory. If I<directory> parameter is omitted, a default build " @@ -783,7 +792,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:398 +#: debhelper.pod:401 msgid "" "If this option is not specified, building will be done in source by default " "unless the build system requires or prefers out of source tree building. In " @@ -792,7 +801,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:403 +#: debhelper.pod:406 msgid "" "If the build system prefers out of source tree building but still allows in " "source building, the latter can be re-enabled by passing a build directory " @@ -800,12 +809,12 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:407 +#: debhelper.pod:410 msgid "B<--parallel>, B<--no-parallel>" msgstr "" #. type: textblock -#: debhelper.pod:409 +#: debhelper.pod:412 msgid "" "Control whether parallel builds should be used if underlying build system " "supports them. The number of parallel jobs is controlled by the " @@ -814,14 +823,14 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:415 +#: debhelper.pod:418 msgid "" "If neither option is specified, debhelper currently defaults to " "B<--parallel> in compat 10 (or later) and B<--no-parallel> otherwise." msgstr "" #. type: textblock -#: debhelper.pod:418 +#: debhelper.pod:421 msgid "" "As an optimization, B<dh> will try to avoid passing these options to " "subprocesses, if they are unnecessary and the only options passed. Notably " @@ -830,12 +839,12 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:423 +#: debhelper.pod:426 msgid "B<--max-parallel=>I<maximum>" msgstr "" #. type: textblock -#: debhelper.pod:425 +#: debhelper.pod:428 msgid "" "This option implies B<--parallel> and allows further limiting the number of " "jobs that can be used in a parallel build. If the package build is known to " @@ -844,27 +853,27 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:430 +#: debhelper.pod:433 msgid "" "Notably, setting the maximum to 1 is effectively the same as using " "B<--no-parallel>." msgstr "" #. type: =item -#: debhelper.pod:433 +#: debhelper.pod:436 msgid "B<--reload-all-buildenv-variables>" msgstr "" #. type: textblock -#: debhelper.pod:435 +#: debhelper.pod:438 msgid "" -"By default, L<dh(1)> will compute several environment (e.g. by using " -"L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> tool " -"recompute them." +"By default, L<dh(1)> will compute several environment variables (e.g. by " +"using L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> " +"tool recompute them." msgstr "" #. type: textblock -#: debhelper.pod:439 +#: debhelper.pod:442 msgid "" "When passing this option, the concrete B<dh_auto_*> tool will ignore the " "cache from L<dh(1)> and retrigger a rebuild of these variables. This is " @@ -874,7 +883,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:446 +#: debhelper.pod:449 #, no-wrap msgid "" " export DEB_CFLAGS_MAINT_APPEND=-O3\n" @@ -882,7 +891,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:448 +#: debhelper.pod:451 #, no-wrap msgid "" " %:\n" @@ -891,7 +900,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:451 +#: debhelper.pod:454 #, no-wrap msgid "" " override_dh_auto_configure:\n" @@ -902,7 +911,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:456 +#: debhelper.pod:459 msgid "" "Without B<--reload-all-buildenv-variables> in the second call to " "L<dh_auto_configure(1)>, the change in B<DEB_CFLAGS_MAINT_APPEND> would be " @@ -911,19 +920,19 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:461 +#: debhelper.pod:464 msgid "" "This option is only available with B<< debhelper (>= 12.7~) >> when the " "package uses compatibility level 9 or later." msgstr "" #. type: =item -#: debhelper.pod:464 dh:258 +#: debhelper.pod:467 dh:299 msgid "B<--list>, B<-l>" msgstr "" #. type: textblock -#: debhelper.pod:466 +#: debhelper.pod:469 msgid "" "List all build systems supported by debhelper on this system. The list " "includes both default and third party build systems (marked as such). Also " @@ -932,12 +941,12 @@ msgid "" msgstr "" #. type: =head1 -#: debhelper.pod:473 +#: debhelper.pod:476 msgid "COMPATIBILITY LEVELS" msgstr "" #. type: textblock -#: debhelper.pod:475 +#: debhelper.pod:478 msgid "" "From time to time, major non-backwards-compatible changes need to be made to " "debhelper, to keep it clean and well-designed as needs change and its author " @@ -948,7 +957,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:482 +#: debhelper.pod:485 msgid "" "In current debhelper, you can specify the compatibility level in " "F<debian/control> by adding a Build-Depends on the debhelper-compat " @@ -957,7 +966,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:486 +#: debhelper.pod:489 #, no-wrap msgid "" " Build-Depends: debhelper-compat (= #RECOMMENDED_COMPAT#)\n" @@ -965,7 +974,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:488 +#: debhelper.pod:491 msgid "" "This also serves as an appropriate versioned build dependency on a " "sufficient version of the debhelper package, so you do not need to specify a " @@ -975,30 +984,30 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:494 +#: debhelper.pod:497 msgid "" "Note that debhelper does not provide debhelper-compat for experimental or " "beta compatibility levels; packages experimenting with those compatibility " -"levels should use F<debian/compat> or B<DH_COMPAT>." +"levels should use F<debian/compat> (or, if only for selected commands, " +"B<DH_COMPAT>)." msgstr "" #. type: textblock -#: debhelper.pod:498 +#: debhelper.pod:501 msgid "" "Prior versions of debhelper required specifying the compatibility level in " "the file F<debian/compat>, and current debhelper still supports this for " -"backward compatibility, though a package may not specify a compatibility " -"level via multiple methods at once. To use this method, F<debian/compat> " -"should contain the compatibility level as a single number, and no other " -"content. If you specify the compatibility level by this method, your package " -"will also need a versioned build dependency on a version of the debhelper " -"package equal to (or greater than) the compatibility level your package " -"uses. So, if you specify compatibility level #RECOMMENDED_COMPAT# in " -"F<debian/compat>, ensure F<debian/control> has:" +"backward compatibility. To use this method, the F<debian/compat> file should " +"contain the compatibility level as a single number, and no other content. If " +"you specify the compatibility level by this method, your package will also " +"need a versioned build dependency on a version of the debhelper package " +"equal to (or greater than) the compatibility level your package uses. So, if " +"you specify compatibility level #RECOMMENDED_COMPAT# in F<debian/compat>, " +"ensure F<debian/control> has:" msgstr "" #. type: verbatim -#: debhelper.pod:509 +#: debhelper.pod:511 #, no-wrap msgid "" " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#~)\n" @@ -1006,7 +1015,27 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:511 +#: debhelper.pod:513 +msgid "" +"Note that you must use either the build-dependency on debhelper-compat or " +"the F<debian/compat> file. Whenever possible, the debhelper-compat " +"build-dependency is recommended." +msgstr "" + +#. type: textblock +#: debhelper.pod:517 +msgid "" +"If needed be, the B<DH_COMPAT> environment variable can be used to override " +"the compat level for a given command. The feature is mostly useful for " +"either temporarily upgrading a few commands to a new compat level or keeping " +"a few commands on a lower compat level. The feature is best used sparingly " +"as it effectively introduces special-cases into the F<debian/rules> file " +"that may be surprising to maintainers or reviewers (or, in the long term, to " +"yourself)." +msgstr "" + +#. type: textblock +#: debhelper.pod:525 msgid "" "Unless otherwise indicated, all debhelper documentation assumes that you are " "using the most recent compatibility level, and in most cases does not " @@ -1017,885 +1046,1106 @@ msgid "" msgstr "" #. type: =head2 -#: debhelper.pod:518 +#: debhelper.pod:532 msgid "Supported compatibility levels" msgstr "" #. type: textblock -#: debhelper.pod:520 -msgid "These are the available compatibility levels:" +#: debhelper.pod:534 +msgid "" +"The list of supported compatibility levels and the related upgrade check " +"list has moved to L<debhelper-compat-upgrade-checklist(7)>." msgstr "" -#. type: =item -#: debhelper.pod:524 debhelper-obsolete-compat.pod:89 -msgid "v5" +#. type: =head1 +#: debhelper.pod:537 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 +#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:96 +#: dh_installinit:204 dh_installinitramfs:60 dh_installman:131 +#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 +#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:103 +#: dh_systemd_start:68 +msgid "NOTES" msgstr "" -#. type: textblock -#: debhelper.pod:526 debhelper-obsolete-compat.pod:91 -msgid "This is the lowest supported compatibility level." +#. type: =head2 +#: debhelper.pod:539 +msgid "Multiple binary package support" msgstr "" #. type: textblock -#: debhelper.pod:528 +#: debhelper.pod:541 msgid "" -"If you are upgrading from an earlier compatibility level, please review " -"L<debhelper-obsolete-compat(7)>." +"If your source package generates more than one binary package, debhelper " +"programs will default to acting on all binary packages when run. If your " +"source package happens to generate one architecture dependent package, and " +"another architecture independent package, this is not the correct behavior, " +"because you need to generate the architecture dependent packages in the " +"binary-arch F<debian/rules> target, and the architecture independent " +"packages in the binary-indep F<debian/rules> target." msgstr "" #. type: textblock -#: debhelper.pod:531 debhelper.pod:563 debhelper.pod:593 debhelper.pod:624 -#: debhelper.pod:685 debhelper-obsolete-compat.pod:28 -#: debhelper-obsolete-compat.pod:35 debhelper-obsolete-compat.pod:58 -#: debhelper-obsolete-compat.pod:87 -msgid "This mode is deprecated." +#: debhelper.pod:549 +msgid "" +"To facilitate this, as well as give you more control over which packages are " +"acted on by debhelper programs, all debhelper programs accept the B<-a>, " +"B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If " +"none are given, debhelper programs default to acting on all packages listed " +"in the control file, with the exceptions below." msgstr "" -#. type: =item -#: debhelper.pod:533 -msgid "v6" +#. type: textblock +#: debhelper.pod:555 +msgid "" +"First, any package whose B<Architecture> field in B<debian/control> does not " +"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " +"section 5.6.8>)." msgstr "" #. type: textblock -#: debhelper.pod:535 -msgid "Changes from v5 are:" +#: debhelper.pod:559 +msgid "" +"Also, some additional packages may be excluded based on the contents of the " +"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " +"binary package stanzas in B<debian/control>, according to the draft policy " +"at L<https://wiki.debian.org/BuildProfileSpec>." msgstr "" -#. type: =item -#: debhelper.pod:539 debhelper.pod:544 debhelper.pod:550 debhelper.pod:556 -#: debhelper.pod:571 debhelper.pod:578 debhelper.pod:582 debhelper.pod:586 -#: debhelper.pod:601 debhelper.pod:605 debhelper.pod:613 debhelper.pod:618 -#: debhelper.pod:632 debhelper.pod:637 debhelper.pod:644 debhelper.pod:649 -#: debhelper.pod:654 debhelper.pod:662 debhelper.pod:668 debhelper.pod:673 -#: debhelper.pod:678 debhelper.pod:693 debhelper.pod:698 debhelper.pod:704 -#: debhelper.pod:710 debhelper.pod:715 debhelper.pod:721 debhelper.pod:730 -#: debhelper.pod:740 debhelper.pod:746 debhelper.pod:769 debhelper.pod:776 -#: debhelper.pod:782 debhelper.pod:788 debhelper.pod:794 debhelper.pod:823 -#: debhelper.pod:829 debhelper.pod:841 debhelper.pod:849 debhelper.pod:855 -#: debhelper.pod:860 debhelper.pod:865 debhelper.pod:870 debhelper.pod:878 -#: debhelper.pod:888 debhelper.pod:898 debhelper.pod:905 debhelper.pod:917 -#: debhelper.pod:922 debhelper.pod:950 debhelper.pod:967 debhelper.pod:977 -#: debhelper.pod:981 debhelper.pod:986 debhelper.pod:991 debhelper.pod:998 -#: debhelper.pod:1004 debhelper.pod:1012 debhelper.pod:1018 debhelper.pod:1022 -#: debhelper.pod:1027 debhelper.pod:1032 debhelper.pod:1041 debhelper.pod:1057 -#: debhelper.pod:1064 debhelper.pod:1080 debhelper.pod:1088 debhelper.pod:1093 -#: debhelper.pod:1108 debhelper.pod:1116 debhelper.pod:1124 debhelper.pod:1133 -#: debhelper.pod:1139 debhelper.pod:1149 debhelper.pod:1157 debhelper.pod:1163 -#: debhelper.pod:1177 debhelper.pod:1188 debhelper.pod:1202 debhelper.pod:1213 -#: debhelper.pod:1231 debhelper.pod:1245 debhelper-obsolete-compat.pod:43 -#: debhelper-obsolete-compat.pod:48 debhelper-obsolete-compat.pod:52 -#: debhelper-obsolete-compat.pod:66 debhelper-obsolete-compat.pod:71 -#: debhelper-obsolete-compat.pod:76 debhelper-obsolete-compat.pod:81 -#: debhelper-obsolete-compat.pod:97 debhelper-obsolete-compat.pod:101 -#: debhelper-obsolete-compat.pod:106 debhelper-obsolete-compat.pod:110 -#: dh_testroot:36 dh_testroot:41 dh_testroot:46 -msgid "-" +#. type: =head3 +#: debhelper.pod:564 +msgid "Interaction between package selections and Build-Profiles" msgstr "" #. type: textblock -#: debhelper.pod:541 +#: debhelper.pod:566 msgid "" -"Commands that generate maintainer script fragments will order the fragments " -"in reverse order for the F<prerm> and F<postrm> scripts." +"Build-Profiles affect which packages are included in the package selections " +"mechanisms in debhelper. Generally, the package selections are described " +"from the assumption that all packages are enabled. This section describes " +"how the selections react when a package is disabled due to the active " +"Build-Profiles (or lack of active Build-Profiles)." msgstr "" -#. type: textblock -#: debhelper.pod:546 -msgid "" -"B<dh_installwm> will install a slave manpage link for " -"F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> " -"in the package build directory." +#. type: =item +#: debhelper.pod:574 +msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" msgstr "" #. type: textblock -#: debhelper.pod:552 +#: debhelper.pod:576 msgid "" -"B<dh_builddeb> did not previously delete everything matching " -"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " -"B<CVS:.svn:.git>. Now it does." +"The package disabled by Build-Profiles is silently excluded from the " +"selection." msgstr "" #. type: textblock -#: debhelper.pod:558 +#: debhelper.pod:579 msgid "" -"B<dh_installman> allows overwriting existing man pages in the package build " -"directory. In previous compatibility levels it silently refuses to do this." +"Note you will receive a warning if I<all> packages related to these " +"selections are disabled. In that case, it generally does not make sense to " +"do the build in the first place." msgstr "" #. type: =item -#: debhelper.pod:565 -msgid "v7" -msgstr "" - -#. type: textblock -#: debhelper.pod:567 -msgid "Changes from v6 are:" +#: debhelper.pod:583 +msgid "-N I<package> / --no-package I<package>" msgstr "" #. type: textblock -#: debhelper.pod:573 -msgid "" -"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " -"doesn't find them in the current directory (or wherever you tell it look " -"using B<--sourcedir>). This allows B<dh_install> to interoperate with " -"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " -"special parameters." +#: debhelper.pod:585 +msgid "The option is accepted and effectively does nothing." msgstr "" -#. type: textblock -#: debhelper.pod:580 -msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +#. type: =item +#: debhelper.pod:587 +msgid "-p I<package> / --package I<package>" msgstr "" #. type: textblock -#: debhelper.pod:584 -msgid "B<dh_clean> will delete toplevel F<*-stamp> files." +#: debhelper.pod:589 +msgid "The option is accepted, but debhelper will not act on the package." msgstr "" #. type: textblock -#: debhelper.pod:588 +#: debhelper.pod:593 msgid "" -"B<dh_installchangelogs> will guess at what file is the upstream changelog if " -"none is specified." -msgstr "" - -#. type: =item -#: debhelper.pod:595 -msgid "v8" +"Note that it does not matter whether a package is enabled or disabled by " +"default." msgstr "" -#. type: textblock -#: debhelper.pod:597 -msgid "Changes from v7 are:" +#. type: =head2 +#: debhelper.pod:596 +msgid "Automatic generation of Debian install scripts" msgstr "" #. type: textblock -#: debhelper.pod:603 -msgid "Commands will fail rather than warning when they are passed unknown options." +#: debhelper.pod:598 +msgid "" +"Some debhelper commands will automatically generate parts of Debian " +"maintainer scripts. If you want these automatically generated things " +"included in your existing Debian maintainer scripts, then you need to add " +"B<#DEBHELPER#> to your scripts, in the place the code should be added. " +"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " +"B<dh_installdeb>." msgstr "" #. type: textblock -#: debhelper.pod:607 +#: debhelper.pod:605 msgid "" -"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " -"generates shlibs files for. So B<-X> can be used to exclude libraries. " -"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " -"processed before will be passed to it, a behavior change that can cause some " -"packages to fail to build." +"If a script does not exist at all and debhelper needs to add something to " +"it, then debhelper will create the complete script." msgstr "" #. type: textblock -#: debhelper.pod:615 +#: debhelper.pod:608 msgid "" -"B<dh> requires the sequence to run be specified as the first parameter, and " -"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo " -"$@>\"." +"All debhelper commands that automatically generate code in this way let it " +"be disabled by the -n parameter (see above)." msgstr "" #. type: textblock -#: debhelper.pod:620 +#: debhelper.pod:611 msgid "" -"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " -"F<Makefile.PL>." +"Note that the inserted code will be shell code, so you cannot directly use " +"it in a Perl script. If you would like to embed it into a Perl script, here " +"is one way to do that (note that I made sure that $1, $2, etc are set with " +"the set command):" msgstr "" -#. type: =item -#: debhelper.pod:626 -msgid "v9" +#. type: verbatim +#: debhelper.pod:616 +#, no-wrap +msgid "" +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"The debhelper script failed with error code: " +"${exit_code}\");\n" +" } else {\n" +" die(\"The debhelper script was killed by signal: ${signal}\");\n" +" }\n" +" }\n" +"\n" msgstr "" -#. type: textblock -#: debhelper.pod:628 -msgid "Changes from v8 are:" +#. type: =head2 +#: debhelper.pod:629 +msgid "Automatic generation of miscellaneous dependencies." msgstr "" #. type: textblock -#: debhelper.pod:634 +#: debhelper.pod:631 msgid "" -"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " -"directories to autoconf in --libdir and --libexecdir." +"Some debhelper commands may make the generated package need to depend on " +"some other packages. For example, if you use L<dh_installdebconf(1)>, your " +"package will generally need to depend on debconf. Or if you use " +"L<dh_installxfonts(1)>, your package will generally need to depend on a " +"particular version of xutils. Keeping track of these miscellaneous " +"dependencies can be annoying since they are dependent on how debhelper does " +"things, so debhelper offers a way to automate it." msgstr "" #. type: textblock #: debhelper.pod:639 msgid "" -"dh is aware of the usual dependencies between targets in debian/rules. So, " -"\"dh binary\" will run any build, build-arch, build-indep, install, etc " -"targets that exist in the rules file. There's no need to define an explicit " -"binary target with explicit dependencies on the other targets." +"All commands of this type, besides documenting what dependencies may be " +"needed on their man pages, will automatically generate a substvar called " +"B<${misc:Depends}>. If you put that token into your F<debian/control> file, " +"it will be expanded to the dependencies debhelper figures you need." msgstr "" #. type: textblock -#: debhelper.pod:646 +#: debhelper.pod:644 msgid "" -"B<dh_strip> compresses debugging symbol files to reduce the installed size " -"of -dbg packages." +"This is entirely independent of the standard B<${shlibs:Depends}> generated " +"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " +"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " +"guesses don't match reality." +msgstr "" + +#. type: =head2 +#: debhelper.pod:649 +msgid "Package build directories" msgstr "" #. type: textblock #: debhelper.pod:651 msgid "" -"B<dh_auto_configure> does not include the source package name in " -"--libexecdir when using autoconf." +"By default, all debhelper programs assume that the temporary directory used " +"for assembling the tree of files in a package is debian/I<package>." msgstr "" #. type: textblock -#: debhelper.pod:656 -msgid "B<dh> does not default to enabling --with=python-support" +#: debhelper.pod:654 +msgid "" +"Sometimes, you might want to use some other temporary directory. This is " +"supported by the B<-P> flag. For example, \"B<dh_installdocs " +"-Pdebian/tmp>\", will use B<debian/tmp> as the temporary directory. Note " +"that if you use B<-P>, the debhelper programs can only be acting on a single " +"package at a time. So if you have a package that builds many binary " +"packages, you will need to also use the B<-p> flag to specify which binary " +"package the debhelper program will act on." msgstr "" -#. type: textblock -#: debhelper.pod:658 -msgid "" -"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " -"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " -"regardless of compat level)" +#. type: =head2 +#: debhelper.pod:662 +msgid "udebs" msgstr "" #. type: textblock #: debhelper.pod:664 msgid "" -"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " -"variables listed by B<dpkg-buildflags>, unless they are already set." +"Debhelper includes support for udebs. To create a udeb with debhelper, add " +"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " +"Debhelper will try to create udebs that comply with debian-installer policy, " +"by making the generated package files end in F<.udeb>, not installing any " +"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " +"and F<config> scripts, etc." msgstr "" -#. type: textblock -#: debhelper.pod:670 -msgid "" -"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " -"to perl F<Makefile.PL> and F<Build.PL>" +#. type: =head1 +#: debhelper.pod:671 +msgid "ENVIRONMENT" msgstr "" #. type: textblock -#: debhelper.pod:675 +#: debhelper.pod:673 msgid "" -"B<dh_strip> puts separated debug symbols in a location based on their " -"build-id." +"This section describes some of the environment variables that influences the " +"behaviour of debhelper or which debhelper interacts with." msgstr "" #. type: textblock -#: debhelper.pod:680 +#: debhelper.pod:676 msgid "" -"Executable debhelper config files are run and their output used as the " -"configuration." +"It is important to note that these must be actual environment variables in " +"order to affect the behaviour of debhelper (not simply F<Makefile> " +"variables). To specify them properly in F<debian/rules>, be sure to " +"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." msgstr "" #. type: =item -#: debhelper.pod:687 -msgid "v10" +#: debhelper.pod:683 +msgid "B<DH_VERBOSE>" msgstr "" #. type: textblock -#: debhelper.pod:689 -msgid "Changes from v9 are:" +#: debhelper.pod:685 +msgid "" +"Set to a non-empty value to enable verbose mode. Please see the B<-v> / " +"B<--verbose> option for details." +msgstr "" + +#. type: =item +#: debhelper.pod:688 +msgid "B<DH_QUIET>" msgstr "" #. type: textblock -#: debhelper.pod:695 +#: debhelper.pod:690 msgid "" -"B<dh_installinit> will no longer install a file named debian/I<package> as " -"an init script." +"Set to a non-empty value to enable quiet mode. Debhelper will not output " +"commands calling the upstream build system nor will dh print which " +"subcommands are called and depending on the upstream build system might make " +"that more quiet, too. This makes it easier to spot important messages but " +"makes the output quite useless as buildd log." +msgstr "" + +#. type: textblock +#: debhelper.pod:696 +msgid "Ignored if DH_VERBOSE is also set or B<-v> / B<--verbose> is passed." +msgstr "" + +#. type: =item +#: debhelper.pod:698 +msgid "B<DH_COMPAT>" msgstr "" #. type: textblock #: debhelper.pod:700 msgid "" -"B<dh_installdocs> will error out if it detects links created with --link-doc " -"between packages of architecture \"all\" and non-\"all\" as it breaks " -"binNMUs." +"Temporarily specifies what compatibility level debhelper should run at, " +"overriding any value specified via Build-Depends on debhelper-compat or via " +"the F<debian/compat> file." +msgstr "" + +#. type: =item +#: debhelper.pod:704 +msgid "B<DH_NO_ACT>" msgstr "" #. type: textblock #: debhelper.pod:706 -msgid "" -"B<dh_installdeb> no longer installs a maintainer-provided " -"debian/I<package>.shlibs file. This is now done by B<dh_makeshlibs> " -"instead." +msgid "Set to B<1> to enable no-act mode." +msgstr "" + +#. type: =item +#: debhelper.pod:708 +msgid "B<DH_OPTIONS>" msgstr "" #. type: textblock -#: debhelper.pod:712 +#: debhelper.pod:710 msgid "" -"B<dh_installwm> refuses to create a broken package if no man page can be " -"found (required to register for the x-window-manager alternative)." +"All debhelper tools will parse command line arguments listed in this " +"variable before any command option (as if they had been prepended to the " +"command line arguments). Unfortunately, some third-party provided tools may " +"not support this variable and will ignore these command line arguments." msgstr "" #. type: textblock -#: debhelper.pod:717 +#: debhelper.pod:715 msgid "" -"Debhelper will default to B<--parallel> for all buildsystems that support " -"parallel building. This can be disabled by using either B<--no-parallel> or " -"passing B<--max-parallel> with a value of 1." +"When using L<dh(1)>, it can be passed options that will be passed on to each " +"debhelper command, which is generally better than using DH_OPTIONS." +msgstr "" + +#. type: =item +#: debhelper.pod:718 +msgid "B<DH_ALWAYS_EXCLUDE>" msgstr "" #. type: textblock -#: debhelper.pod:723 +#: debhelper.pod:720 msgid "" -"The B<dh> command will not accept any of the deprecated \"manual sequence " -"control\" parameters (B<--before>, B<--after>, etc.). Please use override " -"targets instead." +"If set, this adds the value the variable is set to to the B<-X> options of " +"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " +"B<rm -rf> anything that matches the value in your package build tree." msgstr "" #. type: textblock -#: debhelper.pod:727 +#: debhelper.pod:724 msgid "" -"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " -"any of these since debhelper/12.4." +"This can be useful if you are doing a build from a CVS source tree, in which " +"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " +"sneaking into the package you build. Or, if a package has a source tarball " +"that (unwisely) includes CVS directories, you might want to export " +"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " +"your package is built." msgstr "" #. type: textblock -#: debhelper.pod:732 +#: debhelper.pod:731 msgid "" -"The B<dh> command will no longer use log files to track which commands have " -"been run. The B<dh> command I<still> keeps track of whether it already ran " -"the \"build\" sequence and skip it if it did." +"Multiple things to exclude can be separated with colons, as in " +"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" +msgstr "" + +#. type: =item +#: debhelper.pod:734 +msgid "B<DH_EXTRA_ADDONS>" msgstr "" #. type: textblock #: debhelper.pod:736 -msgid "The main effects of this are:" +msgid "" +"If set, this adds the specified dh addons to be run in the appropriate " +"places in the sequence of commands. This is equivalent to specifying the " +"addon to run with the --with flag in the debian/rules file. Any --without " +"calls specifying an addon in this environment variable will not be run." msgstr "" #. type: textblock -#: debhelper.pod:742 +#: debhelper.pod:741 msgid "" -"With this, it is now easier to debug the I<install> or/and I<binary> " -"sequences because they can now trivially be re-run (without having to do a " -"full \"clean and rebuild\" cycle)" +"This is intended to be used by downstreams or specific local configurations " +"that require a debhelper addon to be run during multiple builds without " +"having to patch a large number of rules file. If at all possible, this " +"should be avoided in favor of a --with flag in the rules file." +msgstr "" + +#. type: =item +#: debhelper.pod:746 +msgid "B<DH_COLORS>, B<DPKG_COLORS>" msgstr "" #. type: textblock #: debhelper.pod:748 msgid "" -"The main caveat is that B<dh_*> now only keeps track of what happened in a " -"single override target. When all the calls to a given B<dh_cmd> command " -"happens in the same override target everything will work as before." +"These variables can be used to control whether debhelper commands should use " +"colors in their textual output. Can be set to \"always\", \"auto\" (the " +"default), or \"never\"." msgstr "" #. type: textblock -#: debhelper.pod:753 -msgid "Example of where it can go wrong:" -msgstr "" - -#. type: verbatim -#: debhelper.pod:755 -#, no-wrap +#: debhelper.pod:752 msgid "" -" override_dh_foo:\n" -" dh_foo -pmy-pkg\n" -"\n" +"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " +"debhelper uses it on the assumption that you want the same color setting for " +"dpkg and debhelper. In the off-hand chance you want different color setting " +"for debhelper, you can use B<DH_COLORS> instead or in addition to " +"B<DPKG_COLORS>." msgstr "" -#. type: verbatim +#. type: =item #: debhelper.pod:758 -#, no-wrap -msgid "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" +msgid "B<NO_COLOR>" msgstr "" #. type: textblock -#: debhelper.pod:762 +#: debhelper.pod:760 msgid "" -"In this case, the call to B<dh_foo --remaining> will I<also> include " -"I<my-pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. " -"This issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, " -"etc." +"If no explicit request for color has been given (e.g. B<DH_COLORS> and " +"B<DPKG_COLORS> are both unset), the presence of this environment variable " +"cause the default color setting to be \"never\"." msgstr "" #. type: textblock -#: debhelper.pod:771 +#: debhelper.pod:764 msgid "" -"The B<dh_installdeb> command now shell-escapes the lines in the " -"F<maintscript> config file. This was the original intent but it did not " -"work properly and packages have begun to rely on the incomplete shell " -"escaping (e.g. quoting file names)." +"The variable is defined according to L<https://no-color.org/>. In this " +"project, the environment variables (such as B<DH_COLORS>) are considered an " +"explicit request for color." msgstr "" -#. type: textblock -#: debhelper.pod:778 +#. type: =item +#: debhelper.pod:768 msgid "" -"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " -"For packages needing the previous behaviour, please use " -"B<--no-restart-after-upgrade>." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" msgstr "" #. type: textblock -#: debhelper.pod:784 +#: debhelper.pod:770 msgid "" -"The B<autoreconf> sequence is now enabled by default. Please pass " -"B<--without autoreconf> to B<dh> if this is not desirable for a given " -"package" +"By default (in any non-deprecated compat level), debhelper will " +"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " +"unset. If you need to change the default flags, please use the features " +"from L<dpkg-buildflags(1)> to do this " +"(e.g. B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or " +"B<DEB_CPPFLAGS_MAINT_APPEND=-DCUSTOM_MACRO=true>) rather than setting the " +"concrete variable directly." msgstr "" -#. type: textblock -#: debhelper.pod:790 -msgid "" -"The B<systemd> sequence is now enabled by default. Please pass B<--without " -"systemd> to B<dh> if this is not desirable for a given package." +#. type: =item +#: debhelper.pod:777 +msgid "B<HOME>, B<XDG_*>" msgstr "" #. type: textblock -#: debhelper.pod:796 +#: debhelper.pod:779 msgid "" -"B<Retroactively removed>: B<dh> no longer creates the package build " -"directory when skipping running debhelper commands. This will not affect " -"packages that only build with debhelper commands, but it may expose bugs in " -"commands not included in debhelper." +"In compat 13 and later, these environment variables are reset before " +"invoking the upstream build system via the B<dh_auto_*> helpers. The " +"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " +"(B<dh_auto_test> only) will be set to a writable directory. All remaining " +"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " +"cleared." msgstr "" #. type: textblock -#: debhelper.pod:801 +#: debhelper.pod:785 msgid "" -"This compatibility feature had a bug since its inception in " -"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " -"there has been no reports of issues caused by this bug in those ~5 years, " -"this item have been removed rather than fixed." +"The B<HOME> directory will be created as an empty directory but it will be " +"reused between calls to B<dh_auto_*>. Any content will persist until " +"explicitly deleted or B<dh_clean>." msgstr "" #. type: =item -#: debhelper.pod:808 -msgid "v11" +#: debhelper.pod:789 +msgid "B<DEB_BUILD_OPTIONS>" msgstr "" #. type: textblock -#: debhelper.pod:810 -msgid "This mode is discouraged." +#: debhelper.pod:791 +msgid "" +"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " +"variable." msgstr "" #. type: textblock -#: debhelper.pod:812 +#: debhelper.pod:794 msgid "" -"The compat 11 is discouraged for new packages as it suffers from feature " -"interaction between L<dh_installinit> and L<dh_installsystemd> causing " -"services to not run correctly in some cases. Please consider using " -"compatibility mode 10 or 12 instead. More details about the issue are " -"available in Debian#887904 and " -"L<https://lists.debian.org/debian-release/2019/04/msg01442.html>." +"Please note that this variable should I<not> be altered by package " +"maintainers inside F<debian/rules> to change the behaviour of debhelper. " +"Instead, where the package maintainer need these features, they should look " +"disabling the relevant feature directly (e.g. by overriding the concrete " +"tools)." msgstr "" -#. type: textblock -#: debhelper.pod:819 -msgid "Changes from v10 are:" +#. type: =item +#: debhelper.pod:799 +msgid "B<DEB_BUILD_MAINT_OPTIONS>" msgstr "" #. type: textblock -#: debhelper.pod:825 +#: debhelper.pod:801 msgid "" -"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " -"generates maintainer scripts for those files. Please use the new " -"B<dh_installsystemd> helper." +"This is a dpkg specific environment variable (see " +"e.g. L<dpkg-buildflags(1)>). The debhelper tool suite silently ignores it." msgstr "" #. type: textblock -#: debhelper.pod:831 +#: debhelper.pod:804 msgid "" -"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " -"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " -"sequence for B<dh> has also been removed. If you need to disable the " -"B<dh_installsystemd> helper tool, please use an empty override target." +"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " +"which make some people mistakenly assume that debhelper will also react to " +"this variable." msgstr "" -#. type: textblock -#: debhelper.pod:837 -msgid "" -"Please note that the B<dh_installsystemd> tool has a slightly different " -"behaviour in some cases (e.g. when using the B<--name> parameter)." +#. type: =head2 +#: debhelper.pod:810 +msgid "Supported flags in DEB_BUILD_OPTIONS" msgstr "" #. type: textblock -#: debhelper.pod:843 +#: debhelper.pod:812 msgid "" -"B<dh_installdirs> no longer creates debian/I<package> directories unless " -"explicitly requested (or it has to create a subdirectory in it)." +"The debhelper tool suite reacts to the following flags in " +"B<DEB_BUILD_OPTIONS>." msgstr "" -#. type: textblock -#: debhelper.pod:847 -msgid "The vast majority of all packages will be unaffected by this change." +#. type: =item +#: debhelper.pod:816 +msgid "B<dherroron=obsolete-compat-levels>" msgstr "" #. type: textblock -#: debhelper.pod:851 -msgid "" -"The B<makefile> buildsystem now passes B<INSTALL=\"install " -"--strip-program=true\"> to L<make(1)>. Derivative buildsystems " -"(e.g. B<configure> or B<cmake>) are unaffected by this change." +#: debhelper.pod:818 +msgid "I<This is a debhelper specific value.>" msgstr "" #. type: textblock -#: debhelper.pod:857 +#: debhelper.pod:820 msgid "" -"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to " -"F<./configure>." +"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " +"debhelper tools will promote deprecation warnings for usage of old soon to " +"be removed compat levels into errors." msgstr "" #. type: textblock -#: debhelper.pod:862 +#: debhelper.pod:824 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " -"L<cmake(1)>." +"This is useful for automated checking for code relying on deprecated compat " +"levels that is scheduled for removal." msgstr "" #. type: textblock -#: debhelper.pod:867 -msgid "" -"B<dh_installman> will now prefer detecting the language from the path name " -"rather than the extension." +#: debhelper.pod:827 +msgid "This option is intended for testing purposes; not production builds." msgstr "" -#. type: textblock -#: debhelper.pod:872 -msgid "" -"B<dh_auto_install> will now only create the destination directory it needs. " -"Previously, it would create the package build directory for all packages. " -"This will not affect packages that only build with debhelper commands, but " -"it may expose bugs in commands not included in debhelper." +#. type: =item +#: debhelper.pod:829 +msgid "B<nostrip>" msgstr "" #. type: textblock -#: debhelper.pod:880 +#: debhelper.pod:831 debhelper.pod:854 debhelper.pod:868 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now error out if their config has a pattern that does not " -"match anything or reference a path that does not exist." +"I<This value will change the content of the debs being built. The .deb " +"packages built when this is set is therefore not bit-for-bit reproducible " +"with a regular build in the general case.>" msgstr "" #. type: textblock -#: debhelper.pod:884 +#: debhelper.pod:835 msgid "" -"Known exceptions include building with the B<nodoc> profile, where the above " -"tools will silently permit failed matches where the patterns are used to " -"specify documentation." +"This value will cause the official debhelper tools will skip actions and " +"helpers that either remove, detach or deduplicate debugging symbols in ELF " +"binaries." msgstr "" #. type: textblock -#: debhelper.pod:890 -msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " -"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " -"B<dh_install>." +#: debhelper.pod:839 +msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." msgstr "" -#. type: textblock -#: debhelper.pod:895 -msgid "" -"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " -"incorrectly ignore B<--sourcedir>." +#. type: =item +#: debhelper.pod:841 +msgid "B<nocheck>" msgstr "" #. type: textblock -#: debhelper.pod:900 +#: debhelper.pod:843 msgid "" -"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)." +"This value will cause the official debhelper build systems to skip runs of " +"upstream test suites." msgstr "" #. type: textblock -#: debhelper.pod:907 +#: debhelper.pod:846 msgid "" -"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " -"any of the B<dh_auto_*> tools. It was added as a temporary work around to " -"avoid a lot of packages failing to build at the same time." +"Package maintainers looking to avoid running the upstream tests should " +"B<not> rely on this. Instead, they can add an empty override target to skip " +"B<dh_auto_test>." msgstr "" #. type: textblock -#: debhelper.pod:912 -msgid "" -"Note this item will eventually become obsolete as upstream intends to drop " -"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " -"drops support for it, then this variable will be removed retroactively from " -"existing compat levels as well." +#: debhelper.pod:850 +msgid "This value affects L<dh_auto_test(1)>." +msgstr "" + +#. type: =item +#: debhelper.pod:852 +msgid "B<nodoc>" msgstr "" #. type: textblock -#: debhelper.pod:919 +#: debhelper.pod:858 msgid "" -"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " -"non-zero exit from analysing a given file." +"This value will cause several debhelper tools to skip installation of " +"documentation such as manpages or upstream provided documentation. " +"Additionally, the tools will also ignore if declared documentation is " +"\"missing\" on the assumption that the documentation has not been built." msgstr "" #. type: textblock -#: debhelper.pod:924 +#: debhelper.pod:863 msgid "" -"The B<dh_installdocs> and B<dh_installexamples> tools may now install " -"I<most> of the documentation in a different path to comply with the " -"recommendation from Debian policy §12.3 (since version 3.9.7)." +"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " +"working with documentation." +msgstr "" + +#. type: =item +#: debhelper.pod:866 +msgid "B<notrimdch>" msgstr "" #. type: textblock -#: debhelper.pod:928 +#: debhelper.pod:872 msgid "" -"Note that if a given source package only contains a single binary package in " -"F<debian/control> or none of the packages are I<-doc> packages, then this " -"change is not relevant for that source package and you can skip to the next " -"change." +"This value will cause L<dh_installchangelogs(1)> to act as if it had been " +"passed the B<--no-trim> option, forcing it to forgo removing older entries " +"from changelogs." +msgstr "" + +#. type: =item +#: debhelper.pod:876 +msgid "B<noautodbgsym>, B<noddebs>" msgstr "" #. type: textblock -#: debhelper.pod:933 +#: debhelper.pod:878 msgid "" -"By default, these tools will now attempt to determine a \"main package for " -"the documentation\" (called a I<doc-main-package> from here on) for every " -"I<-doc> package. If they find such a I<doc-main-package>, they will now " -"install the documentation into the path F<< " -"/usr/share/doc/I<doc-main-package> >> in the given doc package. I.e. the " -"path can change but the documentation is still shipped in the I<-doc> " -"package." +"I<The official name is noautodbgsym. The noddebs variant is accepted for " +"historical reasons.>" msgstr "" #. type: textblock -#: debhelper.pod:941 +#: debhelper.pod:881 msgid "" -"The B<--doc-main-package> option can be used when the auto-detection is " -"insufficient or to reset the path to its previous value if there is a reason " -"to diverge from Debian policy recommendation." +"This value causes debhelper to skip the generation of automatically " +"generated debug symbol packages." msgstr "" #. type: textblock -#: debhelper.pod:945 -msgid "" -"Some documentation will not be affected by this change. These exceptions " -"include the copyright file, changelog files, README.Debian, etc. These " -"files will still be installed in the path F<< /usr/share/doc/I<package> >>." +#: debhelper.pod:884 +msgid "This value affects L<dh_strip(1)>." +msgstr "" + +#. type: =item +#: debhelper.pod:886 +msgid "B<parallel=N>" msgstr "" #. type: textblock -#: debhelper.pod:952 +#: debhelper.pod:888 msgid "" -"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " -"to determine which files to process. Instead, they open the file and look " -"for an ELF header to determine if a given file is an shared object or an ELF " -"executable." +"This value enables debhelper to use up to B<N> threads or processes (subject " +"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " +"debhelper tools work with parallel tasks and may silently ignore the " +"request." msgstr "" #. type: textblock -#: debhelper.pod:957 -msgid "This change may cause the tools to process more files than previously." +#: debhelper.pod:893 +msgid "" +"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " +"will attempt to run the underlying upstream build system with that number of " +"threads." msgstr "" #. type: =item -#: debhelper.pod:961 -msgid "v12" +#: debhelper.pod:897 +msgid "B<terse>" msgstr "" #. type: textblock -#: debhelper.pod:963 -msgid "Changes from v11 are:" +#: debhelper.pod:899 +msgid "" +"This value will cause the official debhelper build systems to configure " +"upstream builds to be terse (i.e. reduce verbosity in their output). This " +"is subject to the upstream and the debhelper build system supporting such " +"features." msgstr "" #. type: textblock -#: debhelper.pod:969 +#: debhelper.pod:904 msgid "" -"The B<dh_makeshlibs> tool now generates shlibs files with versioned " -"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " -"is now the default." +"This value affects most B<dh_auto_*> tools directly. For commands provided " +"by the debhelper package, it also causes the tools to act like the " +"B<DH_QUIET> environment variable was non-empty." msgstr "" #. type: textblock -#: debhelper.pod:973 -msgid "" -"If an unversioned dependency in the shlibs file is wanted, this can be " -"obtained by passing B<-VNone> instead. However, please see " -"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." +#: debhelper.pod:910 +msgid "Unknown flags are silently ignored." msgstr "" #. type: textblock -#: debhelper.pod:979 +#: debhelper.pod:912 msgid "" -"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " -"instead." +"Note third-party debhelper-like tools or third-party provided build systems " +"may or may not react to the above flags. This tends to depend on " +"implementation details of the tool." +msgstr "" + +#. type: =head1 +#: debhelper.pod:916 debhelper-compat-upgrade-checklist.pod:753 +#: debhelper-obsolete-compat.pod:178 dh:872 dh_auto_build:53 dh_auto_clean:55 +#: dh_auto_configure:58 dh_auto_install:103 dh_auto_test:64 dh_bugfiles:133 +#: dh_builddeb:176 dh_clean:189 dh_compress:243 dh_dwz:163 dh_fixperms:164 +#: dh_gencontrol:208 dh_icons:75 dh_install:377 dh_installcatalogs:128 +#: dh_installchangelogs:365 dh_installcron:80 dh_installdeb:419 +#: dh_installdebconf:233 dh_installdirs:131 dh_installdocs:437 +#: dh_installemacsen:138 dh_installexamples:182 dh_installifupdown:72 +#: dh_installinfo:123 dh_installinit:413 dh_installinitramfs:91 +#: dh_installlogcheck:81 dh_installlogrotate:53 dh_installman:420 +#: dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 +#: dh_installmodules:109 dh_installpam:71 dh_installppp:68 dh_installudev:102 +#: dh_installwm:130 dh_installxfonts:90 dh_link:166 dh_lintian:60 +#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 +#: dh_perl:188 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 +#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:280 dh_systemd_start:280 +msgid "SEE ALSO" +msgstr "" + +#. type: =item +#: debhelper.pod:920 +msgid "L<debhelper-compat-upgrade-checklist(7)>" msgstr "" #. type: textblock -#: debhelper.pod:983 -msgid "" -"Invoking B<dh_clean -k> now causes an error instead of a deprecation " -"warning." +#: debhelper.pod:922 +msgid "List of supported compat levels and an upgrade checklist for each of them." +msgstr "" + +#. type: =item +#: debhelper.pod:924 +msgid "F</usr/share/doc/debhelper/examples/>" msgstr "" #. type: textblock -#: debhelper.pod:988 -msgid "" -"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " -"removed. Please use the new name B<--no-stop-on-upgrade>" +#: debhelper.pod:926 +msgid "A set of example F<debian/rules> files that use debhelper." +msgstr "" + +#. type: =item +#: debhelper.pod:928 +msgid "L<http://joeyh.name/code/debhelper/>" +msgstr "" + +#. type: textblock +#: debhelper.pod:930 +msgid "Debhelper web site." +msgstr "" + +#. type: =head1 +#: debhelper.pod:934 dh:878 dh_auto_build:59 dh_auto_clean:61 +#: dh_auto_configure:64 dh_auto_install:109 dh_auto_test:70 dh_bugfiles:141 +#: dh_builddeb:182 dh_clean:195 dh_compress:249 dh_dwz:169 dh_fixperms:170 +#: dh_gencontrol:214 dh_icons:81 dh_install:383 dh_installcatalogs:134 +#: dh_installchangelogs:371 dh_installcron:86 dh_installdeb:425 +#: dh_installdebconf:239 dh_installdirs:137 dh_installdocs:443 +#: dh_installemacsen:145 dh_installexamples:188 dh_installifupdown:78 +#: dh_installinfo:129 dh_installinitramfs:99 dh_installlogcheck:87 +#: dh_installlogrotate:59 dh_installman:426 dh_installmanpages:204 +#: dh_installmenu:96 dh_installmime:69 dh_installmodules:115 dh_installpam:77 +#: dh_installppp:74 dh_installudev:108 dh_installwm:136 dh_installxfonts:96 +#: dh_link:172 dh_lintian:68 dh_listpackages:40 dh_makeshlibs:462 +#: dh_md5sums:124 dh_movefiles:167 dh_perl:194 dh_prep:76 dh_shlibdeps:210 +#: dh_strip:441 dh_testdir:68 dh_testroot:99 dh_usrlocal:142 +msgid "AUTHOR" +msgstr "" + +#. type: textblock +#: debhelper.pod:936 dh:880 dh_auto_build:61 dh_auto_clean:63 +#: dh_auto_configure:66 dh_auto_install:111 dh_auto_test:72 dh_builddeb:184 +#: dh_clean:197 dh_compress:251 dh_fixperms:172 dh_gencontrol:216 +#: dh_install:385 dh_installchangelogs:373 dh_installcron:88 dh_installdeb:427 +#: dh_installdebconf:241 dh_installdirs:139 dh_installdocs:445 +#: dh_installemacsen:147 dh_installexamples:190 dh_installifupdown:80 +#: dh_installinfo:131 dh_installinit:421 dh_installlogrotate:61 +#: dh_installman:428 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 +#: dh_installmodules:117 dh_installpam:79 dh_installppp:76 dh_installudev:110 +#: dh_installwm:138 dh_installxfonts:98 dh_link:174 dh_listpackages:42 +#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 +#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 +msgid "Joey Hess <joeyh@debian.org>" msgstr "" #. type: textblock -#: debhelper.pod:993 +#: debhelper-compat-upgrade-checklist.pod:5 msgid "" -"There was a bug in the B<doit> (and similar) functions from " -"L<Debian::Debhelper::Dh_Lib> that made them spawn a shell in one particular " -"circumstance. This bug is now removed and will cause helpers that rely on " -"the bug to fail with a \"command not found\"-error." +"debhelper-compat-upgrade-checklist - Upgrade checklist for supported " +"debhelper compat levels" msgstr "" #. type: textblock -#: debhelper.pod:1000 +#: debhelper-compat-upgrade-checklist.pod:9 msgid "" -"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " -"removed. Please use B<dh_missing> and its corresponding options, which can " -"also see the files installed by other helpers." +"This document is an upgrade checklist of all the supported debhelper compat " +"levels. It also lists all the support debhelper compat levels." msgstr "" #. type: textblock -#: debhelper.pod:1006 +#: debhelper-compat-upgrade-checklist.pod:12 msgid "" -"The B<dh_installinit> helper no longer installs configuration for the " -"upstart init system. Instead, it will abort the build if it finds an old " -"upstart configuration file. The error is there to remind the package " -"maintainer to ensure the proper removal of the conffiles shipped in previous " -"versions of the package (if any)." +"Information about how to declare the compat level is in " +"L<debhelper(7)/COMPATIBILITY LEVELS>." msgstr "" #. type: textblock -#: debhelper.pod:1014 +#: debhelper-compat-upgrade-checklist.pod:14 msgid "" -"The B<dh_installdeb> tool will do basic validation of some " -"L<dpkg-maintscript-helper(1)> commands and will error out if the commands " -"appear to be invalid." +"If you are upgrading from a (now) obsolete compat level, then please refer " +"to L<debhelper-obsolete-compat(7)>." +msgstr "" + +#. type: =head2 +#: debhelper-compat-upgrade-checklist.pod:19 +msgid "Upgrade checklist for supported compatibility levels" msgstr "" #. type: textblock -#: debhelper.pod:1020 -msgid "The B<dh_missing> tool will now default to B<--list-missing>." +#: debhelper-compat-upgrade-checklist.pod:21 +msgid "These are the available compatibility levels:" +msgstr "" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:25 +msgid "v15" msgstr "" #. type: textblock -#: debhelper.pod:1024 -msgid "" -"The B<dh_makeshlibs> tool will now only pass libraries to " -"L<dpkg-gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." +#: debhelper-compat-upgrade-checklist.pod:27 +#: debhelper-compat-upgrade-checklist.pod:51 strings-kept-translations.pod:9 +msgid "This compatibility level is still open for development; use with caution." msgstr "" #. type: textblock -#: debhelper.pod:1029 -msgid "" -"The B<dh_compress> tool no longer compresses examples (i.e. anything " -"installed in F<</usr/share/doc/I<package>/examples>>.)" +#: debhelper-compat-upgrade-checklist.pod:29 +msgid "Changes from v14 are:" +msgstr "" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:33 +#: debhelper-compat-upgrade-checklist.pod:57 +#: debhelper-compat-upgrade-checklist.pod:63 +#: debhelper-compat-upgrade-checklist.pod:68 +#: debhelper-compat-upgrade-checklist.pod:74 +#: debhelper-compat-upgrade-checklist.pod:90 +#: debhelper-compat-upgrade-checklist.pod:95 +#: debhelper-compat-upgrade-checklist.pod:103 +#: debhelper-compat-upgrade-checklist.pod:120 +#: debhelper-compat-upgrade-checklist.pod:128 +#: debhelper-compat-upgrade-checklist.pod:136 +#: debhelper-compat-upgrade-checklist.pod:145 +#: debhelper-compat-upgrade-checklist.pod:151 +#: debhelper-compat-upgrade-checklist.pod:161 +#: debhelper-compat-upgrade-checklist.pod:169 +#: debhelper-compat-upgrade-checklist.pod:175 +#: debhelper-compat-upgrade-checklist.pod:189 +#: debhelper-compat-upgrade-checklist.pod:200 +#: debhelper-compat-upgrade-checklist.pod:214 +#: debhelper-compat-upgrade-checklist.pod:225 +#: debhelper-compat-upgrade-checklist.pod:241 +#: debhelper-compat-upgrade-checklist.pod:251 +#: debhelper-compat-upgrade-checklist.pod:255 +#: debhelper-compat-upgrade-checklist.pod:260 +#: debhelper-compat-upgrade-checklist.pod:265 +#: debhelper-compat-upgrade-checklist.pod:272 +#: debhelper-compat-upgrade-checklist.pod:278 +#: debhelper-compat-upgrade-checklist.pod:286 +#: debhelper-compat-upgrade-checklist.pod:292 +#: debhelper-compat-upgrade-checklist.pod:296 +#: debhelper-compat-upgrade-checklist.pod:301 +#: debhelper-compat-upgrade-checklist.pod:306 +#: debhelper-compat-upgrade-checklist.pod:315 +#: debhelper-compat-upgrade-checklist.pod:331 +#: debhelper-compat-upgrade-checklist.pod:340 +#: debhelper-compat-upgrade-checklist.pod:356 +#: debhelper-compat-upgrade-checklist.pod:364 +#: debhelper-compat-upgrade-checklist.pod:369 +#: debhelper-compat-upgrade-checklist.pod:391 +#: debhelper-compat-upgrade-checklist.pod:397 +#: debhelper-compat-upgrade-checklist.pod:409 +#: debhelper-compat-upgrade-checklist.pod:417 +#: debhelper-compat-upgrade-checklist.pod:423 +#: debhelper-compat-upgrade-checklist.pod:428 +#: debhelper-compat-upgrade-checklist.pod:433 +#: debhelper-compat-upgrade-checklist.pod:438 +#: debhelper-compat-upgrade-checklist.pod:446 +#: debhelper-compat-upgrade-checklist.pod:456 +#: debhelper-compat-upgrade-checklist.pod:466 +#: debhelper-compat-upgrade-checklist.pod:473 +#: debhelper-compat-upgrade-checklist.pod:485 +#: debhelper-compat-upgrade-checklist.pod:490 +#: debhelper-compat-upgrade-checklist.pod:518 +#: debhelper-compat-upgrade-checklist.pod:535 +#: debhelper-compat-upgrade-checklist.pod:540 +#: debhelper-compat-upgrade-checklist.pod:546 +#: debhelper-compat-upgrade-checklist.pod:552 +#: debhelper-compat-upgrade-checklist.pod:557 +#: debhelper-compat-upgrade-checklist.pod:563 +#: debhelper-compat-upgrade-checklist.pod:572 +#: debhelper-compat-upgrade-checklist.pod:582 +#: debhelper-compat-upgrade-checklist.pod:588 +#: debhelper-compat-upgrade-checklist.pod:611 +#: debhelper-compat-upgrade-checklist.pod:618 +#: debhelper-compat-upgrade-checklist.pod:624 +#: debhelper-compat-upgrade-checklist.pod:630 +#: debhelper-compat-upgrade-checklist.pod:636 +#: debhelper-compat-upgrade-checklist.pod:656 +#: debhelper-compat-upgrade-checklist.pod:661 +#: debhelper-compat-upgrade-checklist.pod:668 +#: debhelper-compat-upgrade-checklist.pod:673 +#: debhelper-compat-upgrade-checklist.pod:678 +#: debhelper-compat-upgrade-checklist.pod:686 +#: debhelper-compat-upgrade-checklist.pod:692 +#: debhelper-compat-upgrade-checklist.pod:697 +#: debhelper-compat-upgrade-checklist.pod:702 +#: debhelper-compat-upgrade-checklist.pod:717 +#: debhelper-compat-upgrade-checklist.pod:721 +#: debhelper-compat-upgrade-checklist.pod:729 +#: debhelper-compat-upgrade-checklist.pod:734 debhelper-obsolete-compat.pod:29 +#: debhelper-obsolete-compat.pod:36 debhelper-obsolete-compat.pod:40 +#: debhelper-obsolete-compat.pod:44 debhelper-obsolete-compat.pod:57 +#: debhelper-obsolete-compat.pod:62 debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:74 debhelper-obsolete-compat.pod:89 +#: debhelper-obsolete-compat.pod:93 debhelper-obsolete-compat.pod:98 +#: debhelper-obsolete-compat.pod:102 debhelper-obsolete-compat.pod:114 +#: debhelper-obsolete-compat.pod:119 debhelper-obsolete-compat.pod:124 +#: debhelper-obsolete-compat.pod:129 debhelper-obsolete-compat.pod:143 +#: debhelper-obsolete-compat.pod:148 debhelper-obsolete-compat.pod:152 +#: dh_testroot:36 dh_testroot:41 dh_testroot:46 +msgid "-" msgstr "" #. type: textblock -#: debhelper.pod:1034 +#: debhelper-compat-upgrade-checklist.pod:35 msgid "" -"The standard sequence in B<dh> now includes B<dh_dwz> and " -"B<dh_installinitramfs> by default. This makes the B<dwz> and " -"B<installinitramfs> sequences obsolete and they will now fail with an " -"error. If you want to skip these commands, then please insert an empty " -"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" +"The B<dh_auto_install> tool no longer defaults to B<< " +"--destdir=debian/I<package> >> for source packages only producing a single " +"binary. If this behaviour is wanted, the package should explicitly activate " +"the B<single-binary> dh addon (e.g., by adding B<dh-sequence-single-binary> " +"to B<Build-Depends>) or pass B<--destdir> to B<dh_auto_install>." msgstr "" #. type: textblock -#: debhelper.pod:1043 +#: debhelper-compat-upgrade-checklist.pod:41 +#: debhelper-compat-upgrade-checklist.pod:84 msgid "" -"The build systems B<meson> and B<autoconf> no longer explicitly set the " -"B<--libexecdir> variable and thus relies on the build system default - which " -"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." +"The rationale for this change to avoid \"surprises\" when adding a second " +"binary package later. Previously, debhelper would silently change behaviour " +"often resulting in empty binary packages being uploaded to the archive by " +"mistake. With the new behaviour, the B<single-binary> addon will detect the " +"mismatch and warn the maintainer of what is about to happen." +msgstr "" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:49 +msgid "v14" msgstr "" #. type: textblock -#: debhelper.pod:1048 -msgid "" -"If a particular upstream package does not use the correct default, the " -"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " -"via the following example:" +#: debhelper-compat-upgrade-checklist.pod:53 +msgid "Changes from v13 are:" msgstr "" -#. type: verbatim -#: debhelper.pod:1052 -#, no-wrap +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:59 msgid "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" +"The B<cmake> buildsystem now passes B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to " +"L<cmake(1)> to avoid some reproducibility issues." msgstr "" #. type: textblock -#: debhelper.pod:1055 -msgid "Note the B<--> before the B<--libexecdir> parameter." +#: debhelper-compat-upgrade-checklist.pod:65 +msgid "" +"The tool B<dh_installsysusers> is now included in the default sequence. This " +"helper tool will process systemd sysusers files." msgstr "" #. type: textblock -#: debhelper.pod:1059 +#: debhelper-compat-upgrade-checklist.pod:70 msgid "" -"The B<dh_installdeb> tool no longer installs the maintainer provided " -"F<conffiles> file. The file has mostly been obsolete since compatibility " -"level 3, where B<dh_installdeb> began to automatically compute the resulting " -"F<conffiles> control file." +"Use of the B<dh_gconf> command in override and hook targets now causes an " +"error. The B<dh_gconf> command has been a no-op for years and was removed " +"in debhelper 13.4." msgstr "" #. type: textblock -#: debhelper.pod:1066 +#: debhelper-compat-upgrade-checklist.pod:76 msgid "" -"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " -"handling systemd services that have a sysvinit alternative. Both tools must " -"now be used in such a case to ensure the service is properly started under " -"both sysvinit and systemd." +"The B<dh> sequencer will warn if the B<single-binary> addon is implicitly " +"activated to warn maintainers of the pending compat 15 change in " +"B<dh_auto_install>." msgstr "" #. type: textblock -#: debhelper.pod:1071 +#: debhelper-compat-upgrade-checklist.pod:79 msgid "" -"If you have an override for B<dh_installinit> (e.g. to call it with " -"B<--no-start>) then you will probably need one for B<dh_installsystemd> as " -"well now." +"Maintainers are urged to either explicitly activate the B<single-binary> " +"addon to preserve the existing behaviour (e.g., by adding " +"B<dh-sequence-single-binary> to Build-Depends), or explicitly passing " +"B<--destdir> to B<dh_auto_install> if used and then passing B<--without " +"single-binary> to B<dh> (the latter to silence the warning)." msgstr "" #. type: textblock -#: debhelper.pod:1075 +#: debhelper-compat-upgrade-checklist.pod:92 msgid "" -"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " -"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists " -"B<${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to " -"compat 12." +"The B<dh_installalternatives> tool will now be run after B<dh_link> rather " +"than after B<dh_installinitramfs> in the default B<dh> sequence." msgstr "" #. type: textblock -#: debhelper.pod:1082 +#: debhelper-compat-upgrade-checklist.pod:97 msgid "" -"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " -"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " -"packages and not only during the building process. Please set " -"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " -"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." +"The B<dh_installpam> tool will now install PAM configuration files under F<< " +"/usr/lib/pam.d/I<package> >> instead of F<< /etc/pam.d/I<package> >>." msgstr "" #. type: textblock -#: debhelper.pod:1090 +#: debhelper-compat-upgrade-checklist.pod:100 msgid "" -"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " -"default." +"Please consider using the \"rm_conffile\" feature from L<dh_installdeb(1)> " +"to ensure the proper removal of previous PAM files." msgstr "" #. type: textblock -#: debhelper.pod:1095 +#: debhelper-compat-upgrade-checklist.pod:105 msgid "" -"The B<python-distutils> buildsystem is now removed. Please use the " -"third-party build system B<pybuild> instead." +"The B<meson+ninja> and B<cmake> build systems now use B<meson install> and " +"B<cmake --install>, respectively, instead of B<ninja install> and B<make " +"install> in the L<dh_auto_install(1)> call. Any override of " +"B<dh_auto_install> that passes extra parameters to the upstream build system " +"should be reviewed." msgstr "" #. type: =item -#: debhelper.pod:1100 +#: debhelper-compat-upgrade-checklist.pod:112 msgid "v13" msgstr "" #. type: textblock -#: debhelper.pod:1102 +#: debhelper-compat-upgrade-checklist.pod:114 msgid "This is the recommended mode of operation." msgstr "" #. type: textblock -#: debhelper.pod:1104 +#: debhelper-compat-upgrade-checklist.pod:116 msgid "Changes from v12 are:" msgstr "" #. type: textblock -#: debhelper.pod:1110 +#: debhelper-compat-upgrade-checklist.pod:122 msgid "" "The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " "test> when running the test suite. Any override of B<dh_auto_test> that " @@ -1904,7 +2154,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1118 +#: debhelper-compat-upgrade-checklist.pod:130 msgid "" "All debhelper like tools based on the official debhelper library (including " "B<dh> and the official B<dh_*> tools) no longer accepts abbreviated command " @@ -1913,7 +2163,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1126 +#: debhelper-compat-upgrade-checklist.pod:138 msgid "" "The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, B<dh_makeshlibs>, " "B<dh_shlibdeps>) are now only run for arch dependent packages by default " @@ -1923,7 +2173,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1135 +#: debhelper-compat-upgrade-checklist.pod:147 msgid "" "The third-party B<gradle> build system (from B<gradle-debian-helper> " "package) now runs the upstream-provided test suite automatically. To " @@ -1931,7 +2181,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1141 +#: debhelper-compat-upgrade-checklist.pod:153 msgid "" "The B<dh_installman> tool now aborts if it sees conflicting definitions of a " "manpage. This typically happens if the upstream build system is installing " @@ -1942,7 +2192,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1151 +#: debhelper-compat-upgrade-checklist.pod:163 msgid "" "The B<dh_auto_*> helpers now reset the environment variables B<HOME> and " "common B<XDG_*> variable. Please see description of the environment " @@ -1950,12 +2200,12 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1155 +#: debhelper-compat-upgrade-checklist.pod:167 msgid "I<This feature changed between debhelper 13 and debhelper 13.2.>" msgstr "" #. type: textblock -#: debhelper.pod:1159 +#: debhelper-compat-upgrade-checklist.pod:171 msgid "" "The B<dh> command will now error if an override or hook target for an " "obsolete command are present in F<debian/rules> " @@ -1963,7 +2213,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1165 +#: debhelper-compat-upgrade-checklist.pod:177 msgid "" "The B<dh_missing> command will now default to B<--fail-missing>. This can " "be reverted to a non-fatal warning by explicitly passing B<--list-missing> " @@ -1971,7 +2221,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1169 +#: debhelper-compat-upgrade-checklist.pod:181 msgid "" "If you do not want the warning either, please omit the call to " "B<dh_missing>. If you use the B<dh> command sequencer, then you can do this " @@ -1980,7 +2230,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:1174 +#: debhelper-compat-upgrade-checklist.pod:186 #, no-wrap msgid "" " # Disable dh_missing\n" @@ -1989,7 +2239,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1179 +#: debhelper-compat-upgrade-checklist.pod:191 msgid "" "The B<dh> command sequencer now runs B<dh_installtmpfiles> in the default " "sequence. The B<dh_installtmpfiles> takes over handling of tmpfiles.d " @@ -1998,14 +2248,14 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1184 +#: debhelper-compat-upgrade-checklist.pod:196 msgid "" "Note that B<dh_installtmpfiles> responds to F<< debian/I<package>.tmpfiles " ">> where B<dh_installsystemd> used a name without the trailing \"s\"." msgstr "" #. type: textblock -#: debhelper.pod:1190 +#: debhelper-compat-upgrade-checklist.pod:202 msgid "" "Many B<dh_*> tools now support limited variable expansion via the B<${foo}> " "syntax. In many cases, this can be used to reference paths that contain " @@ -2016,7 +2266,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1197 +#: debhelper-compat-upgrade-checklist.pod:209 msgid "" "Please see L</Substitutions in debhelper config files> for syntax and " "available substitution variables. To B<dh_*> tool writers, substitution " @@ -2025,7 +2275,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1204 +#: debhelper-compat-upgrade-checklist.pod:216 msgid "" "The B<dh> command sequencer will now skip all hook and override targets for " "B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> lists " @@ -2033,7 +2283,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1208 +#: debhelper-compat-upgrade-checklist.pod:220 msgid "" "Any package relying on these targets to always be run should instead move " "relevant logic out of those targets. E.g. non-test related packaging code " @@ -2042,7 +2292,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1215 +#: debhelper-compat-upgrade-checklist.pod:227 msgid "" "The B<cmake> buildsystem now passes " "B<-DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> to L<cmake(1)> to speed up " @@ -2051,7 +2301,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:1219 +#: debhelper-compat-upgrade-checklist.pod:231 #, no-wrap msgid "" " dh_auto_configure -- -DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ...\n" @@ -2059,834 +2309,808 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:1223 -msgid "v14" +#: debhelper-compat-upgrade-checklist.pod:235 +msgid "v12" msgstr "" #. type: textblock -#: debhelper.pod:1225 strings-kept-translations.pod:9 -msgid "This compatibility level is still open for development; use with caution." +#: debhelper-compat-upgrade-checklist.pod:237 +msgid "Changes from v11 are:" msgstr "" #. type: textblock -#: debhelper.pod:1227 -msgid "Changes from v13 are:" +#: debhelper-compat-upgrade-checklist.pod:243 +msgid "" +"The B<dh_makeshlibs> tool now generates shlibs files with versioned " +"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " +"is now the default." msgstr "" #. type: textblock -#: debhelper.pod:1233 +#: debhelper-compat-upgrade-checklist.pod:247 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> and " -"B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some " -"reproducibility issues." +"If an unversioned dependency in the shlibs file is wanted, this can be " +"obtained by passing B<-VNone> instead. However, please see " +"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." msgstr "" #. type: textblock -#: debhelper.pod:1237 +#: debhelper-compat-upgrade-checklist.pod:253 msgid "" -"This can cause issues with running binaries directly from the build " -"directories as they might now require a manually set B<LD_LIBRARY_PATH>. If " -"you need to override this change, we recommend that you try to pass the " -"B<-DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the problem " -"(leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). This should " -"undo the need for B<LD_LIBRARY_PATH> and avoid the reproducibility issues on " -"Linux, where B<$ORIGIN> is supported by the runtime linkers." +"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " +"instead." msgstr "" #. type: textblock -#: debhelper.pod:1247 -msgid "The tool B<dh_installsysusers> is now included in the default sequence." -msgstr "" - -#. type: =head1 -#: debhelper.pod:1253 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 -#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:92 -#: dh_installinit:205 dh_installinitramfs:60 dh_installman:131 -#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 -#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:104 -#: dh_systemd_start:68 -msgid "NOTES" -msgstr "" - -#. type: =head2 -#: debhelper.pod:1255 -msgid "Multiple binary package support" +#: debhelper-compat-upgrade-checklist.pod:257 +msgid "" +"Invoking B<dh_clean -k> now causes an error instead of a deprecation " +"warning." msgstr "" #. type: textblock -#: debhelper.pod:1257 +#: debhelper-compat-upgrade-checklist.pod:262 msgid "" -"If your source package generates more than one binary package, debhelper " -"programs will default to acting on all binary packages when run. If your " -"source package happens to generate one architecture dependent package, and " -"another architecture independent package, this is not the correct behavior, " -"because you need to generate the architecture dependent packages in the " -"binary-arch F<debian/rules> target, and the architecture independent " -"packages in the binary-indep F<debian/rules> target." +"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " +"removed. Please use the new name B<--no-stop-on-upgrade>" msgstr "" #. type: textblock -#: debhelper.pod:1265 +#: debhelper-compat-upgrade-checklist.pod:267 msgid "" -"To facilitate this, as well as give you more control over which packages are " -"acted on by debhelper programs, all debhelper programs accept the B<-a>, " -"B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If " -"none are given, debhelper programs default to acting on all packages listed " -"in the control file, with the exceptions below." +"There was a bug in the B<doit> (and similar) functions from " +"L<Debian::Debhelper::Dh_Lib> that made them spawn a shell in one particular " +"circumstance. This bug is now removed and will cause helpers that rely on " +"the bug to fail with a \"command not found\"-error." msgstr "" #. type: textblock -#: debhelper.pod:1271 +#: debhelper-compat-upgrade-checklist.pod:274 msgid "" -"First, any package whose B<Architecture> field in B<debian/control> does not " -"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " -"section 5.6.8>)." +"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " +"removed. Please use B<dh_missing> and its corresponding options, which can " +"also see the files installed by other helpers." msgstr "" #. type: textblock -#: debhelper.pod:1275 +#: debhelper-compat-upgrade-checklist.pod:280 msgid "" -"Also, some additional packages may be excluded based on the contents of the " -"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " -"binary package stanzas in B<debian/control>, according to the draft policy " -"at L<https://wiki.debian.org/BuildProfileSpec>." -msgstr "" - -#. type: =head3 -#: debhelper.pod:1280 -msgid "Interaction between package selections and Build-Profiles" +"The B<dh_installinit> helper no longer installs configuration for the " +"upstart init system. Instead, it will abort the build if it finds an old " +"upstart configuration file. The error is there to remind the package " +"maintainer to ensure the proper removal of the conffiles shipped in previous " +"versions of the package (if any)." msgstr "" #. type: textblock -#: debhelper.pod:1282 +#: debhelper-compat-upgrade-checklist.pod:288 msgid "" -"Build-Profiles affect which packages are included in the package selections " -"mechanisms in debhelper. Generally, the package selections are described " -"from the assumption that all packages are enabled. This section describes " -"how the selections react when a package is disabled due to the active " -"Build-Profiles (or lack of active Build-Profiles)." +"The B<dh_installdeb> tool will do basic validation of some " +"L<dpkg-maintscript-helper(1)> commands and will error out if the commands " +"appear to be invalid." msgstr "" -#. type: =item -#: debhelper.pod:1290 -msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:294 +msgid "The B<dh_missing> tool will now default to B<--list-missing>." msgstr "" #. type: textblock -#: debhelper.pod:1292 +#: debhelper-compat-upgrade-checklist.pod:298 msgid "" -"The package disabled by Build-Profiles is silently excluded from the " -"selection." +"The B<dh_makeshlibs> tool will now only pass libraries to " +"L<dpkg-gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." msgstr "" #. type: textblock -#: debhelper.pod:1295 +#: debhelper-compat-upgrade-checklist.pod:303 msgid "" -"Note you will receive a warning if I<all> packages related to these " -"selections are disabled. In that case, it generally does not make sense to " -"do the build in the first place." -msgstr "" - -#. type: =item -#: debhelper.pod:1299 -msgid "-N I<package> / --no-package I<package>" +"The B<dh_compress> tool no longer compresses examples (i.e. anything " +"installed in F<</usr/share/doc/I<package>/examples>>.)" msgstr "" #. type: textblock -#: debhelper.pod:1301 -msgid "The option is accepted and effectively does nothing." -msgstr "" - -#. type: =item -#: debhelper.pod:1303 -msgid "-p I<package> / --package I<package>" +#: debhelper-compat-upgrade-checklist.pod:308 +msgid "" +"The standard sequence in B<dh> now includes B<dh_dwz> and " +"B<dh_installinitramfs> by default. This makes the B<dwz> and " +"B<installinitramfs> sequences obsolete and they will now fail with an " +"error. If you want to skip these commands, then please insert an empty " +"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" msgstr "" #. type: textblock -#: debhelper.pod:1305 -msgid "The option is accepted, but debhelper will not act on the package." +#: debhelper-compat-upgrade-checklist.pod:317 +msgid "" +"The build systems B<meson> and B<autoconf> no longer explicitly set the " +"B<--libexecdir> variable and thus relies on the build system default - which " +"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." msgstr "" #. type: textblock -#: debhelper.pod:1309 +#: debhelper-compat-upgrade-checklist.pod:322 msgid "" -"Note that it does not matter whether a package is enabled or disabled by " -"default." +"If a particular upstream package does not use the correct default, the " +"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " +"via the following example:" msgstr "" -#. type: =head2 -#: debhelper.pod:1312 -msgid "Automatic generation of Debian install scripts" +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:326 +#, no-wrap +msgid "" +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" +"\n" msgstr "" #. type: textblock -#: debhelper.pod:1314 -msgid "" -"Some debhelper commands will automatically generate parts of Debian " -"maintainer scripts. If you want these automatically generated things " -"included in your existing Debian maintainer scripts, then you need to add " -"B<#DEBHELPER#> to your scripts, in the place the code should be added. " -"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " -"B<dh_installdeb>." +#: debhelper-compat-upgrade-checklist.pod:329 +msgid "Note the B<--> before the B<--libexecdir> parameter." msgstr "" #. type: textblock -#: debhelper.pod:1321 -msgid "" -"If a script does not exist at all and debhelper needs to add something to " -"it, then debhelper will create the complete script." +#: debhelper-compat-upgrade-checklist.pod:333 +msgid "B<Retroactively removed in debhelper/13.5>:" msgstr "" #. type: textblock -#: debhelper.pod:1324 +#: debhelper-compat-upgrade-checklist.pod:335 msgid "" -"All debhelper commands that automatically generate code in this way let it " -"be disabled by the -n parameter (see above)." +"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+." msgstr "" #. type: textblock -#: debhelper.pod:1327 +#: debhelper-compat-upgrade-checklist.pod:342 msgid "" -"Note that the inserted code will be shell code, so you cannot directly use " -"it in a Perl script. If you would like to embed it into a Perl script, here " -"is one way to do that (note that I made sure that $1, $2, etc are set with " -"the set command):" +"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " +"handling systemd services that have a sysvinit alternative. Both tools must " +"now be used in such a case to ensure the service is properly started under " +"both sysvinit and systemd." msgstr "" -#. type: verbatim -#: debhelper.pod:1332 -#, no-wrap +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:347 msgid "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"The debhelper script failed with error code: " -"${exit_code}\");\n" -" } else {\n" -" die(\"The debhelper script was killed by signal: ${signal}\");\n" -" }\n" -" }\n" -"\n" +"If you have an override for B<dh_installinit> (e.g. to call it with " +"B<--no-start>) then you will probably need one for B<dh_installsystemd> as " +"well now." msgstr "" -#. type: =head2 -#: debhelper.pod:1345 -msgid "Automatic generation of miscellaneous dependencies." +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:351 +msgid "" +"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " +"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists " +"B<${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to " +"compat 12." msgstr "" #. type: textblock -#: debhelper.pod:1347 +#: debhelper-compat-upgrade-checklist.pod:358 msgid "" -"Some debhelper commands may make the generated package need to depend on " -"some other packages. For example, if you use L<dh_installdebconf(1)>, your " -"package will generally need to depend on debconf. Or if you use " -"L<dh_installxfonts(1)>, your package will generally need to depend on a " -"particular version of xutils. Keeping track of these miscellaneous " -"dependencies can be annoying since they are dependent on how debhelper does " -"things, so debhelper offers a way to automate it." +"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " +"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " +"packages and not only during the building process. Please set " +"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " +"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." msgstr "" #. type: textblock -#: debhelper.pod:1355 +#: debhelper-compat-upgrade-checklist.pod:366 msgid "" -"All commands of this type, besides documenting what dependencies may be " -"needed on their man pages, will automatically generate a substvar called " -"B<${misc:Depends}>. If you put that token into your F<debian/control> file, " -"it will be expanded to the dependencies debhelper figures you need." +"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " +"default." msgstr "" #. type: textblock -#: debhelper.pod:1360 +#: debhelper-compat-upgrade-checklist.pod:371 msgid "" -"This is entirely independent of the standard B<${shlibs:Depends}> generated " -"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " -"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " -"guesses don't match reality." +"The B<python-distutils> buildsystem is now removed. Please use the " +"third-party build system B<pybuild> instead." msgstr "" -#. type: =head2 -#: debhelper.pod:1365 -msgid "Package build directories" +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:376 +msgid "v11" msgstr "" #. type: textblock -#: debhelper.pod:1367 -msgid "" -"By default, all debhelper programs assume that the temporary directory used " -"for assembling the tree of files in a package is debian/I<package>." +#: debhelper-compat-upgrade-checklist.pod:378 +msgid "This mode is discouraged." msgstr "" #. type: textblock -#: debhelper.pod:1370 +#: debhelper-compat-upgrade-checklist.pod:380 msgid "" -"Sometimes, you might want to use some other temporary directory. This is " -"supported by the B<-P> flag. For example, \"B<dh_installdocs " -"-Pdebian/tmp>\", will use B<debian/tmp> as the temporary directory. Note " -"that if you use B<-P>, the debhelper programs can only be acting on a single " -"package at a time. So if you have a package that builds many binary " -"packages, you will need to also use the B<-p> flag to specify which binary " -"package the debhelper program will act on." +"The compat 11 is discouraged for new packages as it suffers from feature " +"interaction between L<dh_installinit> and L<dh_installsystemd> causing " +"services to not run correctly in some cases. Please consider using " +"compatibility mode 10 or 12 instead. More details about the issue are " +"available in Debian#887904 and " +"L<https://lists.debian.org/debian-release/2019/04/msg01442.html>." msgstr "" -#. type: =head2 -#: debhelper.pod:1378 -msgid "udebs" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:387 +msgid "Changes from v10 are:" msgstr "" #. type: textblock -#: debhelper.pod:1380 +#: debhelper-compat-upgrade-checklist.pod:393 msgid "" -"Debhelper includes support for udebs. To create a udeb with debhelper, add " -"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " -"Debhelper will try to create udebs that comply with debian-installer policy, " -"by making the generated package files end in F<.udeb>, not installing any " -"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " -"and F<config> scripts, etc." +"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " +"generates maintainer scripts for those files. Please use the new " +"B<dh_installsystemd> helper." msgstr "" -#. type: =head1 -#: debhelper.pod:1387 -msgid "ENVIRONMENT" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:399 +msgid "" +"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " +"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " +"sequence for B<dh> has also been removed. If you need to disable the " +"B<dh_installsystemd> helper tool, please use an empty override target." msgstr "" #. type: textblock -#: debhelper.pod:1389 +#: debhelper-compat-upgrade-checklist.pod:405 msgid "" -"This section describes some of the environment variables that influences the " -"behaviour of debhelper or which debhelper interacts with." +"Please note that the B<dh_installsystemd> tool has a slightly different " +"behaviour in some cases (e.g. when using the B<--name> parameter)." msgstr "" #. type: textblock -#: debhelper.pod:1392 +#: debhelper-compat-upgrade-checklist.pod:411 msgid "" -"It is important to note that these must be actual environment variables in " -"order to affect the behaviour of debhelper (not simply F<Makefile> " -"variables). To specify them properly in F<debian/rules>, be sure to " -"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." +"B<dh_installdirs> no longer creates debian/I<package> directories unless " +"explicitly requested (or it has to create a subdirectory in it)." msgstr "" -#. type: =item -#: debhelper.pod:1399 -msgid "B<DH_VERBOSE>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:415 +msgid "The vast majority of all packages will be unaffected by this change." msgstr "" #. type: textblock -#: debhelper.pod:1401 +#: debhelper-compat-upgrade-checklist.pod:419 msgid "" -"Set to B<1> to enable verbose mode. Debhelper will output every command it " -"runs. Also enables verbose build logs for some build systems like autoconf." +"The B<makefile> buildsystem now passes B<INSTALL=\"install " +"--strip-program=true\"> to L<make(1)>. Derivative buildsystems " +"(e.g. B<configure> or B<cmake>) are unaffected by this change." msgstr "" -#. type: =item -#: debhelper.pod:1404 -msgid "B<DH_QUIET>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:425 +msgid "" +"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to " +"F<./configure>." msgstr "" #. type: textblock -#: debhelper.pod:1406 +#: debhelper-compat-upgrade-checklist.pod:430 msgid "" -"Set to B<1> to enable quiet mode. Debhelper will not output commands calling " -"the upstream build system nor will dh print which subcommands are called and " -"depending on the upstream build system might make that more quiet, too. " -"This makes it easier to spot important messages but makes the output quite " -"useless as buildd log. Ignored if DH_VERBOSE is also set." +"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " +"L<cmake(1)>." msgstr "" -#. type: =item -#: debhelper.pod:1413 -msgid "B<DH_COMPAT>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:435 +msgid "" +"B<dh_installman> will now prefer detecting the language from the path name " +"rather than the extension." msgstr "" #. type: textblock -#: debhelper.pod:1415 +#: debhelper-compat-upgrade-checklist.pod:440 msgid "" -"Temporarily specifies what compatibility level debhelper should run at, " -"overriding any value specified via Build-Depends on debhelper-compat or via " -"the F<debian/compat> file." +"B<dh_auto_install> will now only create the destination directory it needs. " +"Previously, it would create the package build directory for all packages. " +"This will not affect packages that only build with debhelper commands, but " +"it may expose bugs in commands not included in debhelper." msgstr "" -#. type: =item -#: debhelper.pod:1419 -msgid "B<DH_NO_ACT>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:448 +msgid "" +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now error out if their config has a pattern that does not " +"match anything or reference a path that does not exist." msgstr "" #. type: textblock -#: debhelper.pod:1421 -msgid "Set to B<1> to enable no-act mode." +#: debhelper-compat-upgrade-checklist.pod:452 +msgid "" +"Known exceptions include building with the B<nodoc> profile, where the above " +"tools will silently permit failed matches where the patterns are used to " +"specify documentation." msgstr "" -#. type: =item -#: debhelper.pod:1423 -msgid "B<DH_OPTIONS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:458 +msgid "" +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " +"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " +"B<dh_install>." msgstr "" #. type: textblock -#: debhelper.pod:1425 +#: debhelper-compat-upgrade-checklist.pod:463 msgid "" -"All debhelper tools will parse command line arguments listed in this " -"variable before any command option (as if they had been prepended to the " -"command line arguments). Unfortunately, some third-party provided tools may " -"not support this variable and will ignore these command line arguments." +"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " +"incorrectly ignore B<--sourcedir>." msgstr "" #. type: textblock -#: debhelper.pod:1430 +#: debhelper-compat-upgrade-checklist.pod:468 msgid "" -"When using L<dh(1)>, it can be passed options that will be passed on to each " -"debhelper command, which is generally better than using DH_OPTIONS." +"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)." msgstr "" -#. type: =item -#: debhelper.pod:1433 -msgid "B<DH_ALWAYS_EXCLUDE>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:475 +msgid "" +"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " +"any of the B<dh_auto_*> tools. It was added as a temporary work around to " +"avoid a lot of packages failing to build at the same time." msgstr "" #. type: textblock -#: debhelper.pod:1435 +#: debhelper-compat-upgrade-checklist.pod:480 msgid "" -"If set, this adds the value the variable is set to to the B<-X> options of " -"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " -"B<rm -rf> anything that matches the value in your package build tree." +"Note this item will eventually become obsolete as upstream intends to drop " +"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " +"drops support for it, then this variable will be removed retroactively from " +"existing compat levels as well." msgstr "" #. type: textblock -#: debhelper.pod:1439 +#: debhelper-compat-upgrade-checklist.pod:487 msgid "" -"This can be useful if you are doing a build from a CVS source tree, in which " -"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " -"sneaking into the package you build. Or, if a package has a source tarball " -"that (unwisely) includes CVS directories, you might want to export " -"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " -"your package is built." +"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " +"non-zero exit from analysing a given file." msgstr "" #. type: textblock -#: debhelper.pod:1446 +#: debhelper-compat-upgrade-checklist.pod:492 msgid "" -"Multiple things to exclude can be separated with colons, as in " -"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" +"The B<dh_installdocs> and B<dh_installexamples> tools may now install " +"I<most> of the documentation in a different path to comply with the " +"recommendation from Debian policy §12.3 (since version 3.9.7)." msgstr "" -#. type: =item -#: debhelper.pod:1449 -msgid "B<DH_EXTRA_ADDONS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:496 +msgid "" +"Note that if a given source package only contains a single binary package in " +"F<debian/control> or none of the packages are I<-doc> packages, then this " +"change is not relevant for that source package and you can skip to the next " +"change." msgstr "" #. type: textblock -#: debhelper.pod:1451 +#: debhelper-compat-upgrade-checklist.pod:501 msgid "" -"If set, this adds the specified dh addons to be run in the appropriate " -"places in the sequence of commands. This is equivalent to specifying the " -"addon to run with the --with flag in the debian/rules file. Any --without " -"calls specifying an addon in this environment variable will not be run." +"By default, these tools will now attempt to determine a \"main package for " +"the documentation\" (called a I<doc-main-package> from here on) for every " +"I<-doc> package. If they find such a I<doc-main-package>, they will now " +"install the documentation into the path F<< " +"/usr/share/doc/I<doc-main-package> >> in the given doc package. I.e. the " +"path can change but the documentation is still shipped in the I<-doc> " +"package." msgstr "" #. type: textblock -#: debhelper.pod:1456 +#: debhelper-compat-upgrade-checklist.pod:509 msgid "" -"This is intended to be used by downstreams or specific local configurations " -"that require a debhelper addon to be run during multiple builds without " -"having to patch a large number of rules file. If at all possible, this " -"should be avoided in favor of a --with flag in the rules file." +"The B<--doc-main-package> option can be used when the auto-detection is " +"insufficient or to reset the path to its previous value if there is a reason " +"to diverge from Debian policy recommendation." msgstr "" -#. type: =item -#: debhelper.pod:1461 -msgid "B<DH_COLORS>, B<DPKG_COLORS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:513 +msgid "" +"Some documentation will not be affected by this change. These exceptions " +"include the copyright file, changelog files, README.Debian, etc. These " +"files will still be installed in the path F<< /usr/share/doc/I<package> >>." msgstr "" #. type: textblock -#: debhelper.pod:1463 +#: debhelper-compat-upgrade-checklist.pod:520 msgid "" -"These variables can be used to control whether debhelper commands should use " -"colors in their textual output. Can be set to \"always\", \"auto\" (the " -"default), or \"never\"." +"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " +"to determine which files to process. Instead, they open the file and look " +"for an ELF header to determine if a given file is an shared object or an ELF " +"executable." msgstr "" #. type: textblock -#: debhelper.pod:1467 -msgid "" -"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " -"debhelper uses it on the assumption that you want the same color setting for " -"dpkg and debhelper. In the off-hand chance you want different color setting " -"for debhelper, you can use B<DH_COLORS> instead or in addition to " -"B<DPKG_COLORS>." +#: debhelper-compat-upgrade-checklist.pod:525 +msgid "This change may cause the tools to process more files than previously." msgstr "" #. type: =item -#: debhelper.pod:1473 -msgid "B<NO_COLOR>" +#: debhelper-compat-upgrade-checklist.pod:529 +msgid "v10" msgstr "" #. type: textblock -#: debhelper.pod:1475 -msgid "" -"If no explicit request for color has been given (e.g. B<DH_COLORS> and " -"B<DPKG_COLORS> are both unset), the presence of this environment variable " -"cause the default color setting to be \"never\"." +#: debhelper-compat-upgrade-checklist.pod:531 +msgid "Changes from v9 are:" msgstr "" #. type: textblock -#: debhelper.pod:1479 +#: debhelper-compat-upgrade-checklist.pod:537 msgid "" -"The variable is defined according to L<https://no-color.org/>. In this " -"project, the environment variables (such as B<DH_COLORS>) are considered an " -"explicit request for color." +"B<dh_installinit> will no longer install a file named debian/I<package> as " +"an init script." msgstr "" -#. type: =item -#: debhelper.pod:1483 +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:542 msgid "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +"B<dh_installdocs> will error out if it detects links created with --link-doc " +"between packages of architecture \"all\" and non-\"all\" as it breaks " +"binNMUs." msgstr "" #. type: textblock -#: debhelper.pod:1485 +#: debhelper-compat-upgrade-checklist.pod:548 msgid "" -"By default (in any non-deprecated compat level), debhelper will " -"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " -"unset. If you need to change the default flags, please use the features " -"from L<dpkg-buildflags(1)> to do this " -"(e.g. B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or " -"B<DEB_CPPFLAGS_MAINT_APPEND=-DCUSTOM_MACRO=true>) rather than setting the " -"concrete variable directly." -msgstr "" - -#. type: =item -#: debhelper.pod:1492 -msgid "B<HOME>, B<XDG_*>" +"B<dh_installdeb> no longer installs a maintainer-provided " +"debian/I<package>.shlibs file. This is now done by B<dh_makeshlibs> " +"instead." msgstr "" #. type: textblock -#: debhelper.pod:1494 +#: debhelper-compat-upgrade-checklist.pod:554 msgid "" -"In compat 13 and later, these environment variables are reset before " -"invoking the upstream build system via the B<dh_auto_*> helpers. The " -"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " -"(B<dh_auto_test> only) will be set to a writable directory. All remaining " -"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " -"cleared." +"B<dh_installwm> refuses to create a broken package if no man page can be " +"found (required to register for the x-window-manager alternative)." msgstr "" #. type: textblock -#: debhelper.pod:1500 +#: debhelper-compat-upgrade-checklist.pod:559 msgid "" -"The B<HOME> directory will be created as an empty directory but it will be " -"reused between calls to B<dh_auto_*>. Any content will persist until " -"explicitly deleted or B<dh_clean>." +"Debhelper will default to B<--parallel> for all buildsystems that support " +"parallel building. This can be disabled by using either B<--no-parallel> or " +"passing B<--max-parallel> with a value of 1." msgstr "" -#. type: =item -#: debhelper.pod:1504 -msgid "B<DEB_BUILD_OPTIONS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:565 +msgid "" +"The B<dh> command will not accept any of the deprecated \"manual sequence " +"control\" parameters (B<--before>, B<--after>, etc.). Please use override " +"targets instead." msgstr "" #. type: textblock -#: debhelper.pod:1506 +#: debhelper-compat-upgrade-checklist.pod:569 msgid "" -"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " -"variable." +"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " +"any of these since debhelper/12.4." msgstr "" #. type: textblock -#: debhelper.pod:1509 +#: debhelper-compat-upgrade-checklist.pod:574 msgid "" -"Please note that this variable should I<not> be altered by package " -"maintainers inside F<debian/rules> to change the behaviour of debhelper. " -"Instead, where the package maintainer need these features, they should look " -"disabling the relevant feature directly (e.g. by overriding the concrete " -"tools)." +"The B<dh> command will no longer use log files to track which commands have " +"been run. The B<dh> command I<still> keeps track of whether it already ran " +"the \"build\" sequence and skip it if it did." msgstr "" -#. type: =item -#: debhelper.pod:1514 -msgid "B<DEB_MAINT_BUILD_OPTIONS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:578 +msgid "The main effects of this are:" msgstr "" #. type: textblock -#: debhelper.pod:1516 +#: debhelper-compat-upgrade-checklist.pod:584 msgid "" -"This is a dpkg specific environment variable (see " -"e.g. L<dpkg-buildflags(1)>). The debhelper tool suite silently ignores it." +"With this, it is now easier to debug the I<install> or/and I<binary> " +"sequences because they can now trivially be re-run (without having to do a " +"full \"clean and rebuild\" cycle)" msgstr "" #. type: textblock -#: debhelper.pod:1519 +#: debhelper-compat-upgrade-checklist.pod:590 msgid "" -"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " -"which make some people mistakenly assume that debhelper will also react to " -"this variable." +"The main caveat is that B<dh_*> now only keeps track of what happened in a " +"single override target. When all the calls to a given B<dh_cmd> command " +"happens in the same override target everything will work as before." msgstr "" -#. type: =head2 -#: debhelper.pod:1525 -msgid "Supported flags in DEB_BUILD_OPTIONS" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:595 +msgid "Example of where it can go wrong:" msgstr "" -#. type: textblock -#: debhelper.pod:1527 +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:597 +#, no-wrap msgid "" -"The debhelper tool suite reacts to the following flags in " -"B<DEB_BUILD_OPTIONS>." +" override_dh_foo:\n" +" dh_foo -pmy-pkg\n" +"\n" msgstr "" -#. type: =item -#: debhelper.pod:1531 -msgid "B<dherroron=obsolete-compat-levels>" +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:600 +#, no-wrap +msgid "" +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" msgstr "" #. type: textblock -#: debhelper.pod:1533 -msgid "I<This is a debhelper specific value.>" +#: debhelper-compat-upgrade-checklist.pod:604 +msgid "" +"In this case, the call to B<dh_foo --remaining> will I<also> include " +"I<my-pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. " +"This issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, " +"etc." msgstr "" #. type: textblock -#: debhelper.pod:1535 +#: debhelper-compat-upgrade-checklist.pod:613 msgid "" -"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " -"debhelper tools will promote deprecation warnings for usage of old soon to " -"be removed compat levels into errors." +"The B<dh_installdeb> command now shell-escapes the lines in the " +"F<maintscript> config file. This was the original intent but it did not " +"work properly and packages have begun to rely on the incomplete shell " +"escaping (e.g. quoting file names)." msgstr "" #. type: textblock -#: debhelper.pod:1539 +#: debhelper-compat-upgrade-checklist.pod:620 msgid "" -"This is useful for automated checking for code relying on deprecated compat " -"levels that is scheduled for removal." +"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " +"For packages needing the previous behaviour, please use " +"B<--no-restart-after-upgrade>." msgstr "" #. type: textblock -#: debhelper.pod:1542 -msgid "This option is intended for testing purposes; not production builds." +#: debhelper-compat-upgrade-checklist.pod:626 +msgid "" +"The B<autoreconf> sequence is now enabled by default. Please pass " +"B<--without autoreconf> to B<dh> if this is not desirable for a given " +"package" msgstr "" -#. type: =item -#: debhelper.pod:1544 -msgid "B<nostrip>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:632 +msgid "" +"The B<systemd> sequence is now enabled by default. Please pass B<--without " +"systemd> to B<dh> if this is not desirable for a given package." msgstr "" #. type: textblock -#: debhelper.pod:1546 debhelper.pod:1569 +#: debhelper-compat-upgrade-checklist.pod:638 msgid "" -"I<This value will change the content of the debs being built. The .deb " -"packages built when this is set is therefore not bit-for-bit reproducible " -"with a regular build in the general case.>" +"B<Retroactively removed>: B<dh> no longer creates the package build " +"directory when skipping running debhelper commands. This will not affect " +"packages that only build with debhelper commands, but it may expose bugs in " +"commands not included in debhelper." msgstr "" #. type: textblock -#: debhelper.pod:1550 +#: debhelper-compat-upgrade-checklist.pod:643 msgid "" -"This value will cause the official debhelper tools will skip actions and " -"helpers that either remove, detach or deduplicate debugging symbols in ELF " -"binaries." +"This compatibility feature had a bug since its inception in " +"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " +"there has been no reports of issues caused by this bug in those ~5 years, " +"this item have been removed rather than fixed." +msgstr "" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:650 +msgid "v9" msgstr "" #. type: textblock -#: debhelper.pod:1554 -msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:652 +msgid "Changes from v8 are:" msgstr "" -#. type: =item -#: debhelper.pod:1556 -msgid "B<nocheck>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:658 +msgid "" +"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " +"directories to autoconf in --libdir and --libexecdir." msgstr "" #. type: textblock -#: debhelper.pod:1558 +#: debhelper-compat-upgrade-checklist.pod:663 msgid "" -"This value will cause the official debhelper build systems to skip runs of " -"upstream test suites." +"dh is aware of the usual dependencies between targets in debian/rules. So, " +"\"dh binary\" will run any build, build-arch, build-indep, install, etc " +"targets that exist in the rules file. There's no need to define an explicit " +"binary target with explicit dependencies on the other targets." msgstr "" #. type: textblock -#: debhelper.pod:1561 +#: debhelper-compat-upgrade-checklist.pod:670 msgid "" -"Package maintainers looking to avoid running the upstream tests should " -"B<not> rely on this. Instead, they can add an empty override target to skip " -"B<dh_auto_test>." +"B<dh_strip> compresses debugging symbol files to reduce the installed size " +"of -dbg packages." msgstr "" #. type: textblock -#: debhelper.pod:1565 -msgid "This value affects L<dh_auto_test(1)>." +#: debhelper-compat-upgrade-checklist.pod:675 +msgid "" +"B<dh_auto_configure> does not include the source package name in " +"--libexecdir when using autoconf." msgstr "" -#. type: =item -#: debhelper.pod:1567 -msgid "B<nodoc>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:680 +msgid "B<dh> does not default to enabling --with=python-support" msgstr "" #. type: textblock -#: debhelper.pod:1573 +#: debhelper-compat-upgrade-checklist.pod:682 msgid "" -"This value will cause several debhelper tools to skip installation of " -"documentation such as manpages or upstream provided documentation. " -"Additionally, the tools will also ignore if declared documentation is " -"\"missing\" on the assumption that the documentation has not been built." +"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " +"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " +"regardless of compat level)" msgstr "" #. type: textblock -#: debhelper.pod:1578 +#: debhelper-compat-upgrade-checklist.pod:688 msgid "" -"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " -"working with documentation." +"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " +"variables listed by B<dpkg-buildflags>, unless they are already set." msgstr "" -#. type: =item -#: debhelper.pod:1581 -msgid "B<noautodbgsym>, B<noddebs>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:694 +msgid "" +"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " +"to perl F<Makefile.PL> and F<Build.PL>" msgstr "" #. type: textblock -#: debhelper.pod:1583 +#: debhelper-compat-upgrade-checklist.pod:699 msgid "" -"I<The official name is autodbgsym. The noddebs variant is accepted for " -"historical reasons.>" +"B<dh_strip> puts separated debug symbols in a location based on their " +"build-id." msgstr "" #. type: textblock -#: debhelper.pod:1586 +#: debhelper-compat-upgrade-checklist.pod:704 msgid "" -"This value causes debhelper to skip the generation of automatically " -"generated debug symbol packages." +"Executable debhelper config files are run and their output used as the " +"configuration." msgstr "" #. type: textblock -#: debhelper.pod:1589 -msgid "This value affects L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:709 +#: debhelper-compat-upgrade-checklist.pod:740 +#: debhelper-compat-upgrade-checklist.pod:744 debhelper-obsolete-compat.pod:81 +#: debhelper-obsolete-compat.pod:135 debhelper-obsolete-compat.pod:158 +#: debhelper-obsolete-compat.pod:165 debhelper-obsolete-compat.pod:174 +msgid "This mode is deprecated." msgstr "" #. type: =item -#: debhelper.pod:1591 -msgid "B<parallel=N>" +#: debhelper-compat-upgrade-checklist.pod:711 +msgid "v8" msgstr "" #. type: textblock -#: debhelper.pod:1593 -msgid "" -"This value enables debhelper to use up to B<N> threads or processes (subject " -"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " -"debhelper tools work with parallel tasks and may silently ignore the " -"request." +#: debhelper-compat-upgrade-checklist.pod:713 +msgid "Changes from v7 are:" msgstr "" #. type: textblock -#: debhelper.pod:1598 -msgid "" -"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " -"will attempt to run the underlying upstream build system with that number of " -"threads." +#: debhelper-compat-upgrade-checklist.pod:719 +msgid "Commands will fail rather than warning when they are passed unknown options." msgstr "" -#. type: =item -#: debhelper.pod:1602 -msgid "B<terse>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:723 +msgid "" +"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " +"generates shlibs files for. So B<-X> can be used to exclude libraries. " +"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " +"processed before will be passed to it, a behavior change that can cause some " +"packages to fail to build." msgstr "" #. type: textblock -#: debhelper.pod:1604 +#: debhelper-compat-upgrade-checklist.pod:731 msgid "" -"This value will cause the official debhelper build systems to configure " -"upstream builds to be terse (i.e. reduce verbosity in their output). This " -"is subject to the upstream and the debhelper build system supporting such " -"features." +"B<dh> requires the sequence to run be specified as the first parameter, and " +"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo " +"$@>\"." msgstr "" #. type: textblock -#: debhelper.pod:1609 -msgid "This value affects most B<dh_auto_*> tools." +#: debhelper-compat-upgrade-checklist.pod:736 +msgid "" +"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " +"F<Makefile.PL>." msgstr "" -#. type: textblock -#: debhelper.pod:1613 -msgid "Unknown flags are silently ignored." +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:742 debhelper-obsolete-compat.pod:21 +msgid "v7" msgstr "" #. type: textblock -#: debhelper.pod:1615 -msgid "" -"Note third-party debhelper-like tools or third-party provided build systems " -"may or may not react to the above flags. This tends to depend on " -"implementation details of the tool." +#: debhelper-compat-upgrade-checklist.pod:746 debhelper-obsolete-compat.pod:23 +msgid "This is the lowest supported compatibility level." msgstr "" -#. type: =head1 -#: debhelper.pod:1619 debhelper-obsolete-compat.pod:118 dh:733 dh_auto_build:53 -#: dh_auto_clean:55 dh_auto_configure:58 dh_auto_install:97 dh_auto_test:64 -#: dh_bugfiles:133 dh_builddeb:182 dh_clean:189 dh_compress:242 dh_dwz:161 -#: dh_fixperms:164 dh_gconf:105 dh_gencontrol:208 dh_icons:75 dh_install:377 -#: dh_installcatalogs:128 dh_installchangelogs:300 dh_installcron:78 -#: dh_installdeb:412 dh_installdebconf:128 dh_installdirs:131 -#: dh_installdocs:454 dh_installemacsen:138 dh_installexamples:178 -#: dh_installifupdown:72 dh_installinfo:123 dh_installinit:430 -#: dh_installinitramfs:91 dh_installlogcheck:81 dh_installlogrotate:53 -#: dh_installman:417 dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 -#: dh_installmodules:109 dh_installpam:62 dh_installppp:68 dh_installudev:102 -#: dh_installwm:132 dh_installxfonts:90 dh_link:166 dh_lintian:60 -#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 -#: dh_perl:174 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 -#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:281 dh_systemd_start:280 -msgid "SEE ALSO" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:748 +msgid "" +"If you are upgrading from an earlier compatibility level, please review " +"L<debhelper-obsolete-compat(7)>." msgstr "" #. type: =item -#: debhelper.pod:1623 -msgid "F</usr/share/doc/debhelper/examples/>" +#: debhelper-compat-upgrade-checklist.pod:757 +msgid "L<debhelper-obsolete-compat(7)>" msgstr "" #. type: textblock -#: debhelper.pod:1625 -msgid "A set of example F<debian/rules> files that use debhelper." +#: debhelper-compat-upgrade-checklist.pod:759 +msgid "" +"Upgrading from a (now) obsolete compatibility level? This document covers " +"the upgrade checklist up to the earliest supported level." msgstr "" -#. type: =item -#: debhelper.pod:1627 -msgid "L<http://joeyh.name/code/debhelper/>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:762 debhelper-obsolete-compat.pod:180 +#: dh:874 dh_auto_build:55 dh_auto_clean:57 dh_auto_configure:60 +#: dh_auto_install:105 dh_auto_test:66 dh_builddeb:178 dh_clean:191 +#: dh_compress:245 dh_dwz:165 dh_fixperms:166 dh_gencontrol:210 dh_install:379 +#: dh_installcatalogs:130 dh_installchangelogs:367 dh_installcron:82 +#: dh_installdeb:421 dh_installdebconf:235 dh_installdirs:133 +#: dh_installdocs:439 dh_installexamples:184 dh_installifupdown:74 +#: dh_installinfo:125 dh_installlogcheck:83 dh_installlogrotate:55 +#: dh_installman:422 dh_installmanpages:200 dh_installmime:65 +#: dh_installmodules:111 dh_installpam:73 dh_installppp:70 dh_installudev:104 +#: dh_installwm:132 dh_installxfonts:92 dh_link:168 dh_listpackages:36 +#: dh_makeshlibs:458 dh_md5sums:120 dh_movefiles:163 dh_perl:190 dh_prep:72 +#: dh_strip:437 dh_testdir:64 dh_testroot:95 dh_usrlocal:138 +#: dh_systemd_start:282 +msgid "L<debhelper(7)>" msgstr "" #. type: textblock -#: debhelper.pod:1629 -msgid "Debhelper web site." +#: debhelper-compat-upgrade-checklist.pod:764 +msgid "" +"General information about the debhelper framework. This document also covers " +"how to declare your chosen debhelper compat level." msgstr "" #. type: =head1 -#: debhelper.pod:1633 dh:739 dh_auto_build:59 dh_auto_clean:61 -#: dh_auto_configure:64 dh_auto_install:103 dh_auto_test:70 dh_bugfiles:141 -#: dh_builddeb:188 dh_clean:195 dh_compress:248 dh_dwz:167 dh_fixperms:170 -#: dh_gconf:111 dh_gencontrol:214 dh_icons:81 dh_install:383 -#: dh_installcatalogs:134 dh_installchangelogs:306 dh_installcron:84 -#: dh_installdeb:418 dh_installdebconf:134 dh_installdirs:137 -#: dh_installdocs:460 dh_installemacsen:145 dh_installexamples:184 -#: dh_installifupdown:78 dh_installinfo:129 dh_installinitramfs:99 -#: dh_installlogcheck:87 dh_installlogrotate:59 dh_installman:423 -#: dh_installmanpages:204 dh_installmenu:96 dh_installmime:69 -#: dh_installmodules:115 dh_installpam:68 dh_installppp:74 dh_installudev:108 -#: dh_installwm:138 dh_installxfonts:96 dh_link:172 dh_lintian:68 -#: dh_listpackages:40 dh_makeshlibs:462 dh_md5sums:124 dh_movefiles:167 -#: dh_perl:180 dh_prep:76 dh_shlibdeps:210 dh_strip:441 dh_testdir:68 -#: dh_testroot:99 dh_usrlocal:142 -msgid "AUTHOR" +#: debhelper-compat-upgrade-checklist.pod:769 debhelper-obsolete-compat.pod:182 +#: dh_installinit:419 dh_systemd_enable:284 dh_systemd_start:284 +msgid "AUTHORS" msgstr "" #. type: textblock -#: debhelper.pod:1635 dh:741 dh_auto_build:61 dh_auto_clean:63 -#: dh_auto_configure:66 dh_auto_install:105 dh_auto_test:72 dh_builddeb:190 -#: dh_clean:197 dh_compress:250 dh_fixperms:172 dh_gencontrol:216 -#: dh_install:385 dh_installchangelogs:308 dh_installcron:86 dh_installdeb:420 -#: dh_installdebconf:136 dh_installdirs:139 dh_installdocs:462 -#: dh_installemacsen:147 dh_installexamples:186 dh_installifupdown:80 -#: dh_installinfo:131 dh_installinit:438 dh_installlogrotate:61 -#: dh_installman:425 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 -#: dh_installmodules:117 dh_installpam:70 dh_installppp:76 dh_installudev:110 -#: dh_installwm:140 dh_installxfonts:98 dh_link:174 dh_listpackages:42 -#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 -#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 -msgid "Joey Hess <joeyh@debian.org>" +#: debhelper-compat-upgrade-checklist.pod:771 debhelper-obsolete-compat.pod:184 +#: dh_dwz:171 dh_installinitramfs:101 +msgid "Niels Thykier <niels@thykier.net>" +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:773 debhelper-obsolete-compat.pod:186 +msgid "Joey Hess" msgstr "" #. type: textblock @@ -2918,159 +3142,203 @@ msgstr "" msgid "The following is the list of now obsolete compat levels and their changes." msgstr "" -#. type: =item -#: debhelper-obsolete-compat.pod:21 -msgid "v1" +#. type: textblock +#: debhelper-obsolete-compat.pod:25 +msgid "Changes from v6 are:" msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:23 +#: debhelper-obsolete-compat.pod:31 msgid "" -"This is the original debhelper compatibility level, and so it is the default " -"one. In this mode, debhelper will use F<debian/tmp> as the package tree " -"directory for the first binary package listed in the control file, while " -"using debian/I<package> for all other packages listed in the F<control> " -"file." +"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " +"doesn't find them in the current directory (or wherever you tell it look " +"using B<--sourcedir>). This allows B<dh_install> to interoperate with " +"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " +"special parameters." msgstr "" -#. type: =item -#: debhelper-obsolete-compat.pod:30 -msgid "v2" +#. type: textblock +#: debhelper-obsolete-compat.pod:38 +msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:32 +#: debhelper-obsolete-compat.pod:42 +msgid "B<dh_clean> will delete toplevel F<*-stamp> files." +msgstr "" + +#. type: textblock +#: debhelper-obsolete-compat.pod:46 msgid "" -"In this mode, debhelper will consistently use debian/I<package> as the " -"package tree directory for every package that is built." +"B<dh_installchangelogs> will guess at what file is the upstream changelog if " +"none is specified." msgstr "" #. type: =item -#: debhelper-obsolete-compat.pod:37 -msgid "v3" +#: debhelper-obsolete-compat.pod:51 +msgid "v6" msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:39 -msgid "This mode works like v2, with the following additions:" +#: debhelper-obsolete-compat.pod:53 +msgid "Changes from v5 are:" msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:45 +#: debhelper-obsolete-compat.pod:59 msgid "" -"Debhelper config files support globbing via B<*> and B<?>, when " -"appropriate. To turn this off and use those characters raw, just prefix with " -"a backslash." +"Commands that generate maintainer script fragments will order the fragments " +"in reverse order for the F<prerm> and F<postrm> scripts." msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:50 +#: debhelper-obsolete-compat.pod:64 msgid "" -"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " -"B<ldconfig>." +"B<dh_installwm> will install a slave manpage link for " +"F<x-window-manager.1.gz>, if it sees the man page in F<usr/share/man/man1> " +"in the package build directory." msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:54 +#: debhelper-obsolete-compat.pod:70 msgid "" -"Every file in F<etc/> is automatically flagged as a conffile by " -"B<dh_installdeb>." +"B<dh_builddeb> did not previously delete everything matching " +"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " +"B<CVS:.svn:.git>. Now it does." +msgstr "" + +#. type: textblock +#: debhelper-obsolete-compat.pod:76 +msgid "" +"B<dh_installman> allows overwriting existing man pages in the package build " +"directory. In previous compatibility levels it silently refuses to do this." +msgstr "" + +#. type: =item +#: debhelper-obsolete-compat.pod:83 +msgid "v5" +msgstr "" + +#. type: textblock +#: debhelper-obsolete-compat.pod:85 +msgid "Changes from v4 are:" +msgstr "" + +#. type: textblock +#: debhelper-obsolete-compat.pod:91 +msgid "Comments are ignored in debhelper config files." +msgstr "" + +#. type: textblock +#: debhelper-obsolete-compat.pod:95 +msgid "" +"B<dh_strip --dbg-package> now specifies the name of a package to put " +"debugging symbols in, not the packages to take the symbols from." +msgstr "" + +#. type: textblock +#: debhelper-obsolete-compat.pod:100 +msgid "B<dh_installdocs> skips installing empty files." +msgstr "" + +#. type: textblock +#: debhelper-obsolete-compat.pod:104 +msgid "B<dh_install> errors out if wildcards expand to nothing." msgstr "" #. type: =item -#: debhelper-obsolete-compat.pod:60 +#: debhelper-obsolete-compat.pod:108 msgid "v4" msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:62 +#: debhelper-obsolete-compat.pod:110 msgid "Changes from v3 are:" msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:116 msgid "" "B<dh_makeshlibs -V> will not include the Debian part of the version number " "in the generated dependency line in the shlibs file." msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:73 +#: debhelper-obsolete-compat.pod:121 msgid "" "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> " "to supplement the B<${shlibs:Depends}> field." msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:78 +#: debhelper-obsolete-compat.pod:126 msgid "" "B<dh_fixperms> will make all files in F<bin/> directories and in " "F<etc/init.d> executable." msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:83 +#: debhelper-obsolete-compat.pod:131 msgid "B<dh_link> will correct existing links to conform with policy." msgstr "" -#. type: textblock -#: debhelper-obsolete-compat.pod:93 -msgid "Changes from v4 are:" +#. type: =item +#: debhelper-obsolete-compat.pod:137 +msgid "v3" msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:99 -msgid "Comments are ignored in debhelper config files." +#: debhelper-obsolete-compat.pod:139 +msgid "This mode works like v2, with the following additions:" msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:103 +#: debhelper-obsolete-compat.pod:145 msgid "" -"B<dh_strip --dbg-package> now specifies the name of a package to put " -"debugging symbols in, not the packages to take the symbols from." +"Debhelper config files support globbing via B<*> and B<?>, when " +"appropriate. To turn this off and use those characters raw, just prefix with " +"a backslash." msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:108 -msgid "B<dh_installdocs> skips installing empty files." +#: debhelper-obsolete-compat.pod:150 +msgid "" +"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " +"B<ldconfig>." msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:112 -msgid "B<dh_install> errors out if wildcards expand to nothing." +#: debhelper-obsolete-compat.pod:154 +msgid "" +"Every file in F<etc/> is automatically flagged as a conffile by " +"B<dh_installdeb>." msgstr "" -#. type: textblock -#: debhelper-obsolete-compat.pod:120 dh:735 dh_auto_build:55 dh_auto_clean:57 -#: dh_auto_configure:60 dh_auto_install:99 dh_auto_test:66 dh_builddeb:184 -#: dh_clean:191 dh_compress:244 dh_dwz:163 dh_fixperms:166 dh_gconf:107 -#: dh_gencontrol:210 dh_install:379 dh_installcatalogs:130 -#: dh_installchangelogs:302 dh_installcron:80 dh_installdeb:414 -#: dh_installdebconf:130 dh_installdirs:133 dh_installdocs:456 -#: dh_installexamples:180 dh_installifupdown:74 dh_installinfo:125 -#: dh_installlogcheck:83 dh_installlogrotate:55 dh_installman:419 -#: dh_installmanpages:200 dh_installmime:65 dh_installmodules:111 -#: dh_installpam:64 dh_installppp:70 dh_installudev:104 dh_installwm:134 -#: dh_installxfonts:92 dh_link:168 dh_listpackages:36 dh_makeshlibs:458 -#: dh_md5sums:120 dh_movefiles:163 dh_perl:176 dh_prep:72 dh_strip:437 -#: dh_testdir:64 dh_testroot:95 dh_usrlocal:138 dh_systemd_start:282 -msgid "L<debhelper(7)>" +#. type: =item +#: debhelper-obsolete-compat.pod:160 +msgid "v2" msgstr "" -#. type: =head1 -#: debhelper-obsolete-compat.pod:122 dh_installinit:436 dh_systemd_enable:285 -#: dh_systemd_start:284 -msgid "AUTHORS" +#. type: textblock +#: debhelper-obsolete-compat.pod:162 +msgid "" +"In this mode, debhelper will consistently use debian/I<package> as the " +"package tree directory for every package that is built." msgstr "" -#. type: textblock -#: debhelper-obsolete-compat.pod:124 dh_dwz:169 dh_installinitramfs:101 -msgid "Niels Thykier <niels@thykier.net>" +#. type: =item +#: debhelper-obsolete-compat.pod:167 +msgid "v1" msgstr "" #. type: textblock -#: debhelper-obsolete-compat.pod:126 -msgid "Joey Hess" +#: debhelper-obsolete-compat.pod:169 +msgid "" +"This is the original debhelper compatibility level, and so it is the default " +"one. In this mode, debhelper will use F<debian/tmp> as the package tree " +"directory for the first binary package listed in the control file, while " +"using debian/I<package> for all other packages listed in the F<control> " +"file." msgstr "" #. type: textblock @@ -3164,7 +3432,7 @@ msgid "" "The override and hook targets can also be defined to run only when building " "architecture dependent or architecture independent packages. Use targets " "with names like B<override_>I<dh_command>B<-arch> and " -"B<execute_after>I<dh_command>B<-indep>." +"B<execute_after_>I<dh_command>B<-indep>." msgstr "" #. type: textblock @@ -3183,17 +3451,18 @@ msgstr "" #: dh:75 msgid "" "As a special optimization, B<dh> will skip a target if it is completely " -"empty. This is mostly useful for override targets, where the command will " -"simply be skipped without the overhead of invoking a dummy target." +"empty and does not depend on any other target. This is mostly useful for " +"override targets, where the command will simply be skipped without the " +"overhead of invoking a dummy target." msgstr "" #. type: textblock -#: dh:79 +#: dh:80 msgid "Note that the target has to be completely empty for this to work:" msgstr "" #. type: verbatim -#: dh:81 +#: dh:82 #, no-wrap msgid "" " # Skip dh_bar - the good and optimized way\n" @@ -3203,30 +3472,94 @@ msgid "" msgstr "" #. type: verbatim -#: dh:86 +#: dh:87 +#, no-wrap +msgid "" +" # Skip dh_foo - the slow way\n" +" override_dh_foo:\n" +" # Some rationale for skipping dh_foo goes here\n" +" # (these comments causes a dummy target to be run)\n" +"\n" +msgstr "" + +#. type: =head2 +#: dh:92 +msgid "Verifying targets are picked up by dh" +msgstr "" + +#. type: textblock +#: dh:94 +msgid "" +"As of debhelper 13.10, you can use L<dh_assistant(1)> to see which override " +"and hook targets will be seen by B<dh>. Here is an example run of " +"L<dh_assistant(1)> along with its output:" +msgstr "" + +#. type: verbatim +#: dh:98 #, no-wrap msgid "" -" # Skip dh_foo - the slow way\n" -" override_dh_foo:\n" -" # Some rationale for skipping dh_foo goes here\n" -" # (these comments causes a dummy target to be run)\n" -"\n" +" $ dh_assistant detect-hook-targets\n" +" {\n" +" \"commands-not-in-path\": [\n" +" \"dh_foo\"\n" +" ],\n" +" \"hook-targets\": [\n" +" {\n" +" \"command\": \"dh_strip_nondeterminism\",\n" +" \"is-empty\": true,\n" +" \"package-section-param\": null,\n" +" \"target-name\": \"override_dh_strip_nondeterminism\"\n" +" },\n" +" {\n" +" \"command\": \"dh_foo\",\n" +" \"is-empty\": false,\n" +" \"package-section-param\": \"-a\",\n" +" \"target-name\": \"override_dh_foo-arch\"\n" +" }\n" +" ]\n" +" }\n" +"\n" +msgstr "" + +#. type: textblock +#: dh:119 +msgid "" +"The B<commands-not-in-path> is useful for spotting mistakes in the hook " +"target names. A non-empty value implies one of more hook targets are " +"related to a command that is either not installed or no command with that " +"name exists at all. It is generally worth double checking these." +msgstr "" + +#. type: textblock +#: dh:124 +msgid "" +"Additionally, the B<is-empty> attribute for each hook target can be used for " +"seeing whether a hook target triggers the L</Completely empty targets> " +"optimization." +msgstr "" + +#. type: textblock +#: dh:127 +msgid "" +"If you are interested in the other attributes, please read the " +"L<dh_assistant(1)> for the details." msgstr "" -#. type: =head2 -#: dh:91 -msgid "Verifying targets are picked up by dh" +#. type: =head3 +#: dh:130 +msgid "Verifying targets are picked up by dh (when debhelper is older than 13.10)" msgstr "" #. type: textblock -#: dh:93 +#: dh:134 msgid "" -"If you want to confirm that B<dh> has seen an override or a hook target, you " +"On older versions of debhelper, you have to use B<dh> with B<--no-act>. You " "can use the following command as an example:" msgstr "" #. type: verbatim -#: dh:96 +#: dh:137 #, no-wrap msgid "" " $ dh binary --no-act | grep dh_install | head -n5\n" @@ -3239,7 +3572,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:103 +#: dh:144 msgid "" "The B<debian/rules execute_after_dh_install> in the output, which signals " "that B<dh> registered a B<execute_after_dh_install> target and would run it " @@ -3247,7 +3580,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:107 +#: dh:148 msgid "" "Note that L</Completely empty targets> will be omitted in the listing " "above. This makes it a bit harder to spot as you are looking for the " @@ -3255,12 +3588,12 @@ msgid "" msgstr "" #. type: =head2 -#: dh:111 +#: dh:152 msgid "Caveats with hook targets and makefile conditionals" msgstr "" #. type: textblock -#: dh:113 +#: dh:154 msgid "" "If you choose to wrap a hook target in makefile conditionals, please be " "aware that B<dh> computes all the hook targets a head of time and caches the " @@ -3270,7 +3603,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:119 +#: dh:160 msgid "" "The parsing and caching I<often> happens before B<dh> knows whether it will " "build arch:any (-a) or/and arch:all (-i) packages, which can produce " @@ -3279,7 +3612,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:124 +#: dh:165 msgid "" "Most of the problems can be avoided by making the hook target unconditional " "and then have the \"body\" be partially or completely conditional. As an " @@ -3287,7 +3620,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:128 +#: dh:169 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. The hook target\n" @@ -3307,7 +3640,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:142 +#: dh:183 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -3327,7 +3660,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:157 +#: dh:198 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -3348,14 +3681,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:171 +#: dh:212 msgid "" "These recipes are also relevant for conditional dependency targets, which " "are often seen in a variant of the following example:" msgstr "" #. type: verbatim -#: dh:174 +#: dh:215 #, no-wrap msgid "" " COND_TASKS =\n" @@ -3367,7 +3700,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:180 +#: dh:221 #, no-wrap msgid "" " maybe-run-this:\n" @@ -3376,7 +3709,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:183 +#: dh:224 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. Either the\n" @@ -3392,7 +3725,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:194 +#: dh:235 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -3409,7 +3742,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:205 +#: dh:246 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -3422,36 +3755,36 @@ msgid "" msgstr "" #. type: textblock -#: dh:213 +#: dh:254 msgid "" "When in doubt, pick the relevant B<SIMPLE> case in the examples above that " "match your need." msgstr "" #. type: =head1 -#: dh:216 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 -#: dh_auto_install:46 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 -#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gconf:42 dh_gencontrol:38 -#: dh_icons:33 dh_install:69 dh_installcatalogs:56 dh_installchangelogs:71 -#: dh_installcron:43 dh_installdeb:100 dh_installdebconf:64 dh_installdirs:45 -#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:44 -#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:78 +#: dh:257 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 +#: dh_auto_install:52 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 +#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gencontrol:38 dh_icons:33 +#: dh_install:69 dh_installcatalogs:56 dh_installchangelogs:77 +#: dh_installcron:45 dh_installdeb:107 dh_installdebconf:64 dh_installdirs:45 +#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:48 +#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:77 #: dh_installinitramfs:43 dh_installlogcheck:45 dh_installlogrotate:25 #: dh_installman:86 dh_installmanpages:43 dh_installmenu:44 -#: dh_installmodules:41 dh_installpam:34 dh_installppp:38 dh_installudev:34 +#: dh_installmodules:41 dh_installpam:38 dh_installppp:38 dh_installudev:34 #: dh_installwm:41 dh_link:69 dh_makeshlibs:67 dh_md5sums:31 dh_movefiles:41 -#: dh_perl:34 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 -#: dh_usrlocal:50 dh_systemd_enable:83 dh_systemd_start:33 +#: dh_perl:35 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 +#: dh_usrlocal:50 dh_systemd_enable:82 dh_systemd_start:33 msgid "OPTIONS" msgstr "" #. type: =item -#: dh:220 +#: dh:261 msgid "B<--with> I<addon>[B<,>I<addon> ...]" msgstr "" #. type: textblock -#: dh:222 +#: dh:263 msgid "" "Add the debhelper commands specified by the given addon to appropriate " "places in the sequence of commands that is run. This option can be repeated " @@ -3462,7 +3795,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:229 +#: dh:270 msgid "" "A B<Build-Depends> relation on the package B<dh-sequence->I<addon> implies a " "B<--with> I<addon>. This avoids the need for an explicit B<--with> in " @@ -3474,7 +3807,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:238 +#: dh:279 msgid "" "Since debhelper 12.5, addons can also be activated in B<indep>-only mode " "(via B<Build-Depends-Indep>) or B<arch>-only mode (via " @@ -3484,7 +3817,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:244 +#: dh:285 msgid "" "Please note that addons activated via B<Build-Depends-Indep> or " "B<Build-Depends-Arch> are subject to additional limitations to ensure the " @@ -3496,12 +3829,12 @@ msgid "" msgstr "" #. type: =item -#: dh:252 +#: dh:293 msgid "B<--without> I<addon>" msgstr "" #. type: textblock -#: dh:254 +#: dh:295 msgid "" "The inverse of B<--with>, disables using the given addon. This option can be " "repeated more than once, or multiple addons to disable can be listed, " @@ -3509,31 +3842,31 @@ msgid "" msgstr "" #. type: textblock -#: dh:260 +#: dh:301 msgid "List all available addons." msgstr "" #. type: textblock -#: dh:262 +#: dh:303 msgid "" "When called only with this option, B<dh> can be called from any directory " "(i.e. it does not need access to files from a source package)." msgstr "" #. type: textblock -#: dh:268 +#: dh:309 msgid "Prints commands that would run for a given sequence, but does not run them." msgstr "" #. type: textblock -#: dh:270 +#: dh:311 msgid "" "Note that dh normally skips running commands that it knows will do nothing. " "With --no-act, the full list of commands in a sequence is printed." msgstr "" #. type: textblock -#: dh:275 +#: dh:316 msgid "" "Other options passed to B<dh> are passed on to each command it runs. This " "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for " @@ -3541,20 +3874,20 @@ msgid "" msgstr "" #. type: =head1 -#: dh:279 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 +#: dh:320 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 #: dh_makeshlibs:185 dh_shlibdeps:78 msgid "EXAMPLES" msgstr "" #. type: textblock -#: dh:281 +#: dh:322 msgid "" "To see what commands are included in a sequence, without actually doing " "anything:" msgstr "" #. type: verbatim -#: dh:284 +#: dh:325 #, no-wrap msgid "" "\tdh binary-arch --no-act\n" @@ -3562,14 +3895,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:286 +#: dh:327 msgid "" "This is a very simple rules file, for packages where the default sequences " "of commands work with no additional options." msgstr "" #. type: verbatim -#: dh:289 dh:296 dh:310 dh:323 dh:334 dh:392 dh:403 +#: dh:330 dh:337 dh:351 dh:364 dh:375 dh:433 dh:444 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -3579,14 +3912,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:293 +#: dh:334 msgid "" "Often you'll want to pass an option to a specific debhelper command. The " "easy way to do with is by adding an override target for that command." msgstr "" #. type: verbatim -#: dh:300 +#: dh:341 #, no-wrap msgid "" "\toverride_dh_strip:\n" @@ -3595,7 +3928,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:303 +#: dh:344 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -3604,7 +3937,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:306 +#: dh:347 msgid "" "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> " "can't guess what to do for a strange package. Here's how to avoid running " @@ -3612,7 +3945,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:314 +#: dh:355 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -3621,7 +3954,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:317 +#: dh:358 #, no-wrap msgid "" "\toverride_dh_auto_build:\n" @@ -3630,14 +3963,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:320 +#: dh:361 msgid "" "Another common case is wanting to do something manually before or after a " "particular debhelper command is run." msgstr "" #. type: verbatim -#: dh:327 +#: dh:368 #, no-wrap msgid "" "\t# Example assumes debhelper/12.8 and compat 10+\n" @@ -3647,14 +3980,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:331 +#: dh:372 msgid "" "If you are on an older debhelper or compatibility level, the above example " "would have to be written as." msgstr "" #. type: verbatim -#: dh:338 +#: dh:379 #, no-wrap msgid "" "\t# Older debhelper versions or using compat 9 or lower.\n" @@ -3665,14 +3998,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:343 +#: dh:384 msgid "" "Python tools are not run by dh by default, due to the continual change in " "that area. Here is how to use B<dh_python2>." msgstr "" #. type: verbatim -#: dh:346 +#: dh:387 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -3682,14 +4015,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:350 +#: dh:391 msgid "" "Here is how to force use of Perl's B<Module::Build> build system, which can " "be necessary if debhelper wrongly detects that the package uses MakeMaker." msgstr "" #. type: verbatim -#: dh:354 +#: dh:395 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -3699,7 +4032,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:358 +#: dh:399 msgid "" "Here is an example of overriding where the B<dh_auto_>I<*> commands find the " "package's source, for a package where the source is located in a " @@ -3707,7 +4040,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:362 +#: dh:403 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -3717,14 +4050,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:366 +#: dh:407 msgid "" "And here is an example of how to tell the B<dh_auto_>I<*> commands to build " "in a subdirectory, which will be removed on B<clean>." msgstr "" #. type: verbatim -#: dh:369 +#: dh:410 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -3734,14 +4067,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:373 +#: dh:414 msgid "" "If your package can be built in parallel, please either use compat 10 or " "pass B<--parallel> to dh. Then B<dpkg-buildpackage -j> will work." msgstr "" #. type: verbatim -#: dh:376 +#: dh:417 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -3751,7 +4084,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:380 +#: dh:421 msgid "" "If your package cannot be built reliably while using multiple threads, " "please pass B<--no-parallel> to dh (or the relevant B<dh_auto_>I<*> " @@ -3759,7 +4092,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:385 +#: dh:426 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -3769,14 +4102,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:389 +#: dh:430 msgid "" "Here is a way to prevent B<dh> from running several commands that you don't " "want it to run, by defining empty override targets for each command." msgstr "" #. type: verbatim -#: dh:396 +#: dh:437 #, no-wrap msgid "" "\t# Commands not to run:\n" @@ -3785,7 +4118,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:399 +#: dh:440 msgid "" "A long build process for a separate documentation package can be separated " "out using architecture independent overrides. These will be skipped when " @@ -3793,7 +4126,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:407 +#: dh:448 #, no-wrap msgid "" "\toverride_dh_auto_build-indep:\n" @@ -3802,7 +4135,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:410 +#: dh:451 #, no-wrap msgid "" "\t# No tests needed for docs\n" @@ -3811,7 +4144,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:413 +#: dh:454 #, no-wrap msgid "" "\toverride_dh_auto_install-indep:\n" @@ -3820,7 +4153,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:416 +#: dh:457 msgid "" "Adding to the example above, suppose you need to chmod a file, but only when " "building the architecture dependent package, as it's not present when " @@ -3828,7 +4161,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:420 +#: dh:461 #, no-wrap msgid "" "\t# Example assumes debhelper/12.8 and compat 10+\n" @@ -3838,19 +4171,166 @@ msgid "" msgstr "" #. type: =head1 -#: dh:424 +#: dh:465 +msgid "DEBHELPER PROVIDED DH ADDONS" +msgstr "" + +#. type: textblock +#: dh:467 +msgid "" +"The primary purpose of B<dh> addons is to provide easy integration with " +"third-party provided features for debhelper. However, debhelper itself also " +"provide a few sequences that can be useful in some cases. These are " +"documented in this list:" +msgstr "" + +#. type: =item +#: dh:474 +msgid "build-stamp" +msgstr "" + +#. type: textblock +#: dh:476 +msgid "" +"A special addon for controlling whether B<dh> (in compat 10 or later) will " +"create stamp files to tell whether the build target has been run " +"successfully. See L</INTERNALS> for more details." +msgstr "" + +#. type: textblock +#: dh:480 +msgid "" +"This addon is active by default but can disabled by using B<dh $@ --without " +"build-stamp>" +msgstr "" + +#. type: =item +#: dh:483 +msgid "dwz (obsolete)" +msgstr "" + +#. type: textblock +#: dh:485 +msgid "" +"Adds L<dh_dwz(1)> to the sequence in compat level 11 or below. Obsolete in " +"compat 12 or later." +msgstr "" + +#. type: =item +#: dh:488 +msgid "elf-tools" +msgstr "" + +#. type: textblock +#: dh:490 +msgid "" +"This addon adds tools related to ELF files to the sequence such as " +"L<dh_strip(1)> and L<dh_shlibdeps(1)>" +msgstr "" + +#. type: textblock +#: dh:493 +msgid "" +"This addon is I<conditionally> active by default for architecture specific " +"packages - that is, it is skipped for arch:all packages. In the special " +"case where you need these tools to work on arch:all packages, you can use " +"B<--with elf-tools> to activate it unconditionally." +msgstr "" + +#. type: =item +#: dh:499 +msgid "installinitramfs (obsolete)" +msgstr "" + +#. type: textblock +#: dh:501 +msgid "" +"Adds L<dh_installinitramfs(1)> to the sequence in compat level 11 or below. " +"Obsolete in compat 12 or later." +msgstr "" + +#. type: =item +#: dh:504 +msgid "root-sequence (internal)" +msgstr "" + +#. type: textblock +#: dh:506 +msgid "This is reserved for internal usage." +msgstr "" + +#. type: =item +#: dh:508 +msgid "single-binary" +msgstr "" + +#. type: textblock +#: dh:510 +msgid "A special-purpose addon that makes debhelper run in \"single binary\" mode." +msgstr "" + +#. type: textblock +#: dh:512 +msgid "" +"When active, it will pass B<< --destdir=debian/I<package>/ >> to " +"L<dh_auto_install(1)>. This makes every file \"installed\" by the upstream " +"build system part of the (only) binary package by default without having to " +"use other helpers such as L<dh_install(1)>." +msgstr "" + +#. type: textblock +#: dh:517 +msgid "" +"The addon will refuse to activate when the source package lists 2 or more " +"binary packages in F<debian/control> as a precaution." +msgstr "" + +#. type: textblock +#: dh:520 +msgid "" +"Before compat 15. this behaviour was the default when there was only a " +"single binary package listed in F<debian/control>. In compat 15 and later, " +"this addon must explicitly be activated for this feature to work." +msgstr "" + +#. type: textblock +#: dh:524 +msgid "" +"The rationale for requiring this as an explicit choice is that if it is " +"implicit then debhelper will silently change behaviour on adding a new " +"binary package. This has caused many RC bugs when maintainers renamed a " +"binary and added transitional packages with the intention of supporting " +"seamless upgrades. The result would often be two empty binary packages that " +"were uploaded to archive with users frustrated as their \"upgrade\" removed " +"their programs." +msgstr "" + +#. type: =item +#: dh:532 +msgid "systemd (obsolete)" +msgstr "" + +#. type: textblock +#: dh:534 +msgid "" +"Adds L<dh_systemd_enable(1)> and L<dh_systemd_start(1)> to the sequence in " +"compat level 10 or below. Obsolete in compat 11 or later." +msgstr "" + +#. type: =head1 +#: dh:539 msgid "INTERNALS" msgstr "" #. type: textblock -#: dh:426 +#: dh:541 msgid "" "If you're curious about B<dh>'s internals, here's how it works under the " "hood." msgstr "" #. type: textblock -#: dh:428 +#: dh:543 msgid "" "In compat 10 (or later), B<dh> creates a stamp file " "F<debian/debhelper-build-stamp> after the build step(s) are complete to " @@ -3861,7 +4341,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:436 +#: dh:551 msgid "" "Inside an override target, B<dh_*> commands will create a log file " "F<debian/package.debhelper.log> to keep track of which packages the " @@ -3870,7 +4350,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:441 +#: dh:556 msgid "" "In compat 9 or earlier, each debhelper command will record when it's " "successfully run in F<debian/package.debhelper.log>. (Which B<dh_clean> " @@ -3879,7 +4359,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:446 +#: dh:561 msgid "" "Each time B<dh> is run (in compat 9 or earlier), it examines the log, and " "finds the last logged command that is in the specified sequence. It then " @@ -3887,14 +4367,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:450 +#: dh:565 msgid "" "A sequence can also run dependent targets in debian/rules. For example, the " "\"binary\" sequence runs the \"install\" target." msgstr "" #. type: textblock -#: dh:453 +#: dh:568 msgid "" "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass " "information through to debhelper commands that are run inside override " @@ -3903,7 +4383,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:458 +#: dh:573 msgid "" "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> " "sequences are passed the B<-i> option to ensure they only work on " @@ -3913,19 +4393,19 @@ msgid "" msgstr "" #. type: textblock -#: dh:737 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 -#: dh_auto_install:101 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:186 -#: dh_clean:193 dh_compress:246 dh_dwz:165 dh_fixperms:168 dh_gconf:109 -#: dh_gencontrol:212 dh_icons:79 dh_install:381 dh_installchangelogs:304 -#: dh_installcron:82 dh_installdeb:416 dh_installdebconf:132 dh_installdirs:135 -#: dh_installdocs:458 dh_installemacsen:143 dh_installexamples:182 -#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:434 -#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:421 +#: dh:876 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 +#: dh_auto_install:107 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:180 +#: dh_clean:193 dh_compress:247 dh_dwz:167 dh_fixperms:168 dh_gencontrol:212 +#: dh_icons:79 dh_install:381 dh_installchangelogs:369 dh_installcron:84 +#: dh_installdeb:423 dh_installdebconf:237 dh_installdirs:135 +#: dh_installdocs:441 dh_installemacsen:143 dh_installexamples:186 +#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:417 +#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:424 #: dh_installmanpages:202 dh_installmenu:94 dh_installmime:67 -#: dh_installmodules:113 dh_installpam:66 dh_installppp:72 dh_installudev:106 -#: dh_installwm:136 dh_installxfonts:94 dh_link:170 dh_lintian:64 +#: dh_installmodules:113 dh_installpam:75 dh_installppp:72 dh_installudev:106 +#: dh_installwm:134 dh_installxfonts:94 dh_link:170 dh_lintian:64 #: dh_listpackages:38 dh_makeshlibs:460 dh_md5sums:122 dh_movefiles:165 -#: dh_perl:178 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 +#: dh_perl:192 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 #: dh_testroot:97 dh_usrlocal:140 msgid "This program is a part of debhelper." msgstr "" @@ -3961,7 +4441,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:48 +#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:54 #: dh_auto_test:36 msgid "" "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build " @@ -3969,9 +4449,9 @@ msgid "" msgstr "" #. type: =item -#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:59 +#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:65 #: dh_auto_test:41 dh_builddeb:48 dh_dwz:62 dh_gencontrol:42 -#: dh_installdebconf:72 dh_installinit:167 dh_makeshlibs:179 dh_shlibdeps:41 +#: dh_installdebconf:72 dh_installinit:166 dh_makeshlibs:179 dh_shlibdeps:41 msgid "B<--> I<params>" msgstr "" @@ -4097,23 +4577,33 @@ msgstr "" #. type: textblock #: dh_auto_install:32 msgid "" -"Unless B<--destdir> option is specified, the files are installed into " -"debian/I<package>/ if there is only one binary package. In the multiple " -"binary package case, the files are instead installed into F<debian/tmp/>, " -"and should be moved from there to the appropriate package build directory " -"using L<dh_install(1)>." +"In compat 15 or later, B<dh_auto_install> will use F<debian/tmp> as the " +"default B<--destdir> and should be moved from there to the appropriate " +"package build directory using L<dh_install(1)> or similar tools. Though if " +"the B<single-binary> addon for L<dh(1)> is activated, then it will pass an " +"explicit B<< --destdir=debian/I<package>/ >> to B<dh_auto_install>." msgstr "" #. type: textblock #: dh_auto_install:38 msgid "" +"For earlier compat levels then unless B<--destdir> option is specified, the " +"files are installed into debian/I<package>/ if there is only one binary " +"package. In the multiple binary package case, the files are instead " +"installed into F<debian/tmp/>, and should be moved from there to the " +"appropriate package build directory using L<dh_install(1)> or similar tools." +msgstr "" + +#. type: textblock +#: dh_auto_install:44 +msgid "" "B<DESTDIR> is used to tell make where to install the files. If the Makefile " "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set " "B<PREFIX=/usr> too, since such Makefiles need that." msgstr "" #. type: textblock -#: dh_auto_install:42 +#: dh_auto_install:48 msgid "" "This is intended to work for about 90% of packages. If it doesn't work, or " "tries to use the wrong install target, you're encouraged to skip using " @@ -4121,12 +4611,12 @@ msgid "" msgstr "" #. type: =item -#: dh_auto_install:53 dh_builddeb:38 +#: dh_auto_install:59 dh_builddeb:38 msgid "B<--destdir=>I<directory>" msgstr "" #. type: textblock -#: dh_auto_install:55 +#: dh_auto_install:61 msgid "" "Install files into the specified I<directory>. If this option is not " "specified, destination directory is determined automatically as described in " @@ -4134,7 +4624,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_auto_install:61 +#: dh_auto_install:67 msgid "" "Pass I<params> to the program that is run, after the parameters that " "B<dh_auto_install> usually passes." @@ -4207,8 +4697,8 @@ msgid "" msgstr "" #. type: =head1 -#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_gconf:26 dh_install:40 -#: dh_installcatalogs:39 dh_installchangelogs:47 dh_installcron:24 +#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_install:40 +#: dh_installcatalogs:39 dh_installchangelogs:53 dh_installcron:24 #: dh_installdeb:25 dh_installdebconf:37 dh_installdirs:28 dh_installdocs:40 #: dh_installemacsen:30 dh_installexamples:31 dh_installifupdown:25 #: dh_installinfo:28 dh_installinit:41 dh_installinitramfs:30 @@ -4414,8 +4904,8 @@ msgid "" msgstr "" #. type: textblock -#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:95 -#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:39 dh_installinfo:36 +#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:102 +#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:43 dh_installinfo:36 #: dh_installman:81 dh_installwm:36 dh_link:64 msgid "" "Supports substitution variables in compat 13 and later as documented in " @@ -4423,7 +4913,7 @@ msgid "" msgstr "" #. type: =item -#: dh_clean:53 dh_installchangelogs:75 +#: dh_clean:53 dh_installchangelogs:81 msgid "B<-k>, B<--keep>" msgstr "" @@ -4550,7 +5040,7 @@ msgid "" msgstr "" #. type: =item -#: dh_compress:68 dh_installdocs:184 dh_installexamples:85 dh_installinfo:60 +#: dh_compress:68 dh_installdocs:184 dh_installexamples:89 dh_installinfo:60 #: dh_installmanpages:47 dh_movefiles:58 dh_testdir:30 msgid "I<file> ..." msgstr "" @@ -4561,7 +5051,7 @@ msgid "Add these files to the list of files to compress." msgstr "" #. type: =head1 -#: dh_compress:74 dh_perl:64 dh_strip:133 dh_usrlocal:66 +#: dh_compress:74 dh_perl:65 dh_strip:133 dh_usrlocal:66 msgid "CONFORMS TO" msgstr "" @@ -4720,71 +5210,6 @@ msgid "" "up a list of things to exclude." msgstr "" -#. type: textblock -#: dh_gconf:5 -msgid "dh_gconf - install GConf defaults files and register schemas (deprecated)" -msgstr "" - -#. type: textblock -#: dh_gconf:17 -msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" -msgstr "" - -#. type: textblock -#: dh_gconf:21 -msgid "" -"B<dh_gconf> is a debhelper program that is responsible for installing GConf " -"defaults files and registering GConf schemas." -msgstr "" - -#. type: textblock -#: dh_gconf:24 -msgid "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>." -msgstr "" - -#. type: =item -#: dh_gconf:30 -msgid "debian/I<package>.gconf-defaults" -msgstr "" - -#. type: textblock -#: dh_gconf:32 -msgid "" -"Installed into F<usr/share/gconf/defaults/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" - -#. type: =item -#: dh_gconf:35 -msgid "debian/I<package>.gconf-mandatory" -msgstr "" - -#. type: textblock -#: dh_gconf:37 -msgid "" -"Installed into F<usr/share/gconf/mandatory/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" - -#. type: =item -#: dh_gconf:46 -msgid "B<--priority> I<priority>" -msgstr "" - -#. type: textblock -#: dh_gconf:48 -msgid "" -"Use I<priority> (which should be a 2-digit number) as the defaults priority " -"instead of B<10>. Higher values than ten can be used by derived " -"distributions (B<20>), CDD distributions (B<50>), or site-specific packages " -"(B<90>)." -msgstr "" - -#. type: textblock -#: dh_gconf:113 -msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" -msgstr "" - #. type: textblock #: dh_gencontrol:5 msgid "dh_gencontrol - generate and install control file" @@ -4870,7 +5295,7 @@ msgstr "" #. type: =item #: dh_icons:37 dh_installcatalogs:60 dh_installdebconf:68 dh_installemacsen:60 -#: dh_installinit:82 dh_installinitramfs:47 dh_installmenu:48 +#: dh_installinit:81 dh_installinitramfs:47 dh_installmenu:48 #: dh_installmodules:45 dh_installwm:51 dh_makeshlibs:147 dh_usrlocal:54 msgid "B<-n>, B<--no-scripts>" msgstr "" @@ -5003,7 +5428,7 @@ msgid "" msgstr "" #. type: =item -#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:53 +#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:57 #: dh_installinfo:50 dh_installman:100 dh_movefiles:45 msgid "B<--sourcedir=>I<dir>" msgstr "" @@ -5220,7 +5645,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:207 +#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:206 #: dh_installmodules:59 dh_installudev:52 dh_installwm:68 dh_usrlocal:62 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " @@ -5244,21 +5669,21 @@ msgid "dh_installchangelogs - install changelogs into package build directories" msgstr "" #. type: textblock -#: dh_installchangelogs:17 +#: dh_installchangelogs:18 msgid "" "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " -"[I<upstream>]" +"[B<--no-trim>] [I<upstream>]" msgstr "" #. type: textblock -#: dh_installchangelogs:21 +#: dh_installchangelogs:22 msgid "" "B<dh_installchangelogs> is a debhelper program that is responsible for " "installing changelogs into package build directories." msgstr "" #. type: textblock -#: dh_installchangelogs:24 +#: dh_installchangelogs:25 msgid "" "An upstream F<changelog> file may be specified as an option. If none is " "specified, B<dh_installchangelogs> may look for files with names that seem " @@ -5266,7 +5691,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installchangelogs:28 +#: dh_installchangelogs:29 msgid "" "In non-native packages, B<dh_installchangelogs> will first look for " "changelog files installed by the upstream build system into F<< " @@ -5281,7 +5706,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installchangelogs:40 +#: dh_installchangelogs:41 msgid "" "If a changelog file is specified and is an F<html> file (determined by file " "extension), it will be installed as F<usr/share/doc/package/changelog.html> " @@ -5291,42 +5716,51 @@ msgid "" "the html changelog file." msgstr "" +#. type: textblock +#: dh_installchangelogs:48 +msgid "" +"The B<debchange>-style Debian changelogs are trimmed to include only entries " +"more recent than the release date of I<oldstable>. No trimming will be " +"performed if the B<--no-trim> option is passed or if the " +"B<DEB_BUILD_OPTIONS> environment variable contains B<notrimdch>." +msgstr "" + #. type: =item -#: dh_installchangelogs:51 +#: dh_installchangelogs:57 msgid "F<debian/changelog>" msgstr "" #. type: =item -#: dh_installchangelogs:53 +#: dh_installchangelogs:59 msgid "F<debian/NEWS>" msgstr "" #. type: =item -#: dh_installchangelogs:55 +#: dh_installchangelogs:61 msgid "debian/I<package>.changelog" msgstr "" #. type: =item -#: dh_installchangelogs:57 +#: dh_installchangelogs:63 msgid "debian/I<package>.NEWS" msgstr "" #. type: textblock -#: dh_installchangelogs:59 +#: dh_installchangelogs:65 msgid "" "Automatically installed into usr/share/doc/I<package>/ in the package build " "directory." msgstr "" #. type: textblock -#: dh_installchangelogs:62 +#: dh_installchangelogs:68 msgid "" "Use the package specific name if I<package> needs a different F<NEWS> or " "F<changelog> file." msgstr "" #. type: textblock -#: dh_installchangelogs:65 +#: dh_installchangelogs:71 msgid "" "The F<changelog> file is installed with a name of changelog for native " "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file " @@ -5334,7 +5768,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installchangelogs:77 +#: dh_installchangelogs:83 msgid "" "Keep the original name of the upstream changelog. This will be accomplished " "by installing the upstream changelog as F<changelog>, and making a symlink " @@ -5344,24 +5778,36 @@ msgid "" msgstr "" #. type: textblock -#: dh_installchangelogs:85 +#: dh_installchangelogs:91 msgid "" "Exclude upstream F<changelog> files that contain I<item> anywhere in their " "filename from being installed." msgstr "" #. type: textblock -#: dh_installchangelogs:88 +#: dh_installchangelogs:94 msgid "Note that directory name of the changelog is also part of the match." msgstr "" #. type: =item -#: dh_installchangelogs:90 +#: dh_installchangelogs:96 +msgid "B<--no-trim>" +msgstr "" + +#. type: textblock +#: dh_installchangelogs:98 +msgid "" +"Install the full changelog, not its trimmed version that includes only " +"recent entries." +msgstr "" + +#. type: =item +#: dh_installchangelogs:101 msgid "I<upstream>" msgstr "" #. type: textblock -#: dh_installchangelogs:92 +#: dh_installchangelogs:103 msgid "Install this file as the upstream changelog." msgstr "" @@ -5399,30 +5845,35 @@ msgstr "" #. type: =item #: dh_installcron:34 -msgid "debian/I<package>.cron.hourly" +msgid "debian/I<package>.cron.yearly" msgstr "" #. type: =item #: dh_installcron:36 +msgid "debian/I<package>.cron.hourly" +msgstr "" + +#. type: =item +#: dh_installcron:38 msgid "debian/I<package>.cron.d" msgstr "" #. type: textblock -#: dh_installcron:38 +#: dh_installcron:40 msgid "" "Installed into the appropriate F<etc/cron.*/> directory in the package build " "directory." msgstr "" #. type: =item -#: dh_installcron:47 dh_installifupdown:46 dh_installinit:175 +#: dh_installcron:49 dh_installifupdown:46 dh_installinit:174 #: dh_installlogcheck:49 dh_installlogrotate:29 dh_installmodules:49 -#: dh_installpam:38 dh_installppp:42 dh_installudev:38 dh_systemd_enable:95 +#: dh_installpam:42 dh_installppp:42 dh_installudev:38 dh_systemd_enable:94 msgid "B<--name=>I<name>" msgstr "" #. type: textblock -#: dh_installcron:49 +#: dh_installcron:51 msgid "" "Look for files named F<debian/package.name.cron.*> and install them as " "F<etc/cron.*/name>, instead of using the usual files and installing them as " @@ -5518,17 +5969,17 @@ msgstr "" #. type: textblock #: dh_installdeb:59 msgid "" -"Historically, this file was needed to manually mark files files as " -"conffiles. However, it has become de facto obsolete since debhelper " -"automatically computed which files should be marked as conffiles." +"This file will be installed into the F<DEBIAN> directory. The provided file " +"will be enriched by debhelper to include all the B<conffiles> auto-detected " +"by debhelper (the maintainer should not list there as debhelper assumes it " +"should handle that part)." msgstr "" #. type: textblock -#: dh_installdeb:63 +#: dh_installdeb:64 msgid "" -"In compatibility level up and including 11, this control file will be " -"installed into the F<DEBIAN> directory. In compatibility level 12 and " -"later, the file is silently ignored." +"This file is primarily useful for using \"special\" entries such as the B<< " +"remove-on-upgrade >> feature from dpkg." msgstr "" #. type: =item @@ -5586,13 +6037,23 @@ msgid "" "enabled as a warning since compat 10 and as a hard error in compat 12." msgstr "" +#. type: textblock +#: dh_installdeb:95 +msgid "" +"Where possible, B<dh_installdeb> may choose to rewrite some or all of the " +"entries into equivalent features supported in dpkg without relying on " +"maintainer scripts at its sole discretion (examples include rewriting " +"B<rm_conffile> into dpkg's B<remove-on-upgrade>). The minimum requirement " +"for activating this feature is that debhelper runs in compat 10 or later." +msgstr "" + #. type: =item -#: dh_installdeb:104 +#: dh_installdeb:111 dh_installdebconf:76 msgid "B<-D>I<TOKEN=VALUE>, B<--define> I<TOKEN=VALUE>" msgstr "" #. type: textblock -#: dh_installdeb:106 +#: dh_installdeb:113 dh_installdebconf:78 msgid "" "Define tokens to be replaced inside the maintainer scripts when it is " "generated. Please note that the limitations described in L</Limitations in " @@ -5601,7 +6062,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:111 +#: dh_installdeb:118 dh_installdebconf:83 msgid "" "In the simple case, this parameter will cause B<< #I<TOKEN># >> to be " "replaced by I<VALUE>. If I<VALUE> starts with a literal I<@>-sign, then " @@ -5610,17 +6071,17 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:116 +#: dh_installdeb:123 dh_installdebconf:88 msgid "An explicit declared token with this parameter will replace built-in tokens." msgstr "" #. type: textblock -#: dh_installdeb:119 +#: dh_installdeb:126 dh_installdebconf:91 msgid "Test examples to aid with the understanding:" msgstr "" #. type: verbatim -#: dh_installdeb:121 +#: dh_installdeb:128 #, no-wrap msgid "" "\tcat >> debian/postinst <<EOF\n" @@ -5633,14 +6094,14 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:128 +#: dh_installdeb:135 dh_installdebconf:100 msgid "" "In this example, B<#SIMPLE#> will expand to B<direct> and B<#FILEBASED#> " "will expand to B<Complex value>." msgstr "" #. type: textblock -#: dh_installdeb:131 +#: dh_installdeb:138 msgid "" "It is also possible to set package-specific values for a given token. This " "is useful when B<dh_installdeb> is acting on multiple packages that need " @@ -5649,12 +6110,12 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:136 +#: dh_installdeb:143 dh_installdebconf:108 msgid "This can be used as in the following example:" msgstr "" #. type: verbatim -#: dh_installdeb:138 +#: dh_installdeb:145 #, no-wrap msgid "" "\tcat >> debian/foo.postinst <<EOF\n" @@ -5676,7 +6137,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:153 +#: dh_installdeb:160 msgid "" "In this example, B<#TOKEN#> will expand to B<default> in " "F<debian/foo.postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and " @@ -5684,7 +6145,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:157 +#: dh_installdeb:164 msgid "" "Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. " "E.g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> and " @@ -5692,24 +6153,24 @@ msgid "" msgstr "" #. type: =head1 -#: dh_installdeb:163 +#: dh_installdeb:170 dh_installdebconf:135 msgid "SUBSTITUTION IN MAINTAINER SCRIPTS" msgstr "" #. type: textblock -#: dh_installdeb:165 +#: dh_installdeb:172 msgid "" "The B<dh_installdeb> will automatically replace the following tokens inside " "a provided maintainer script (if not replaced via B<-D>/B<--define>):" msgstr "" #. type: =item -#: dh_installdeb:170 +#: dh_installdeb:177 msgid "#DEBHELPER#" msgstr "" #. type: textblock -#: dh_installdeb:172 +#: dh_installdeb:179 msgid "" "This token is by default replaced with generated shell snippets debhelper " "commands. This includes the snippets generated by B<dh_installdeb> from " @@ -5717,12 +6178,12 @@ msgid "" msgstr "" #. type: =item -#: dh_installdeb:176 +#: dh_installdeb:183 dh_installdebconf:142 msgid "#DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME>#" msgstr "" #. type: textblock -#: dh_installdeb:178 +#: dh_installdeb:185 dh_installdebconf:144 msgid "" "These tokens are replaced with the respective variable from " "L<dpkg-architecture(1)>. In almost all cases, you will want use the B<< " @@ -5731,19 +6192,19 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:183 +#: dh_installdeb:190 dh_installdebconf:149 msgid "" "On a best effort, tokens of this pattern that do not match a variable in " "L<dpkg-architecture(1)> will be left as-is." msgstr "" #. type: =item -#: dh_installdeb:186 +#: dh_installdeb:193 dh_installdebconf:152 msgid "#ENV.I<NAME>#" msgstr "" #. type: textblock -#: dh_installdeb:188 +#: dh_installdeb:195 dh_installdebconf:154 msgid "" "These tokens of this form will be replaced with value of the corresponding " "environment variable. If the environment variable is unset, the token is " @@ -5751,38 +6212,38 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:193 +#: dh_installdeb:200 dh_installdebconf:159 msgid "" "Note that there are limits on which names can be used (see L</Limitations in " "token names>)." msgstr "" #. type: =item -#: dh_installdeb:196 +#: dh_installdeb:203 dh_installdebconf:162 msgid "#PACKAGE#" msgstr "" #. type: textblock -#: dh_installdeb:198 +#: dh_installdeb:205 dh_installdebconf:164 msgid "" "This token is by default replaced by the package name, which will contain " "the concrete script." msgstr "" #. type: =head2 -#: dh_installdeb:203 +#: dh_installdeb:210 dh_installdebconf:169 msgid "Limitations in token names" msgstr "" #. type: textblock -#: dh_installdeb:205 +#: dh_installdeb:212 dh_installdebconf:171 msgid "" "All tokens intended to be substituted must match the regex: " "#[A-Za-z0-9_.+]+#" msgstr "" #. type: textblock -#: dh_installdeb:207 +#: dh_installdeb:214 msgid "" "Tokens that do not match that regex will be silently ignored if found in the " "script template. Invalid token names passed to B<-D> or B<--define> will " @@ -5892,6 +6353,82 @@ msgstr "" msgid "Pass the params to B<po2debconf>." msgstr "" +#. type: verbatim +#: dh_installdebconf:93 +#, no-wrap +msgid "" +"\tcat >> debian/config <<EOF\n" +"\t#SIMPLE#\n" +"\t#FILEBASED#\n" +"\tEOF\n" +"\techo -n \"Complex value\" > some-file\n" +" dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +"\n" +msgstr "" + +#. type: textblock +#: dh_installdebconf:103 +msgid "" +"It is also possible to set package-specific values for a given token. This " +"is useful when B<dh_installdebconf> is acting on multiple packages that need " +"different values for the same token. This is done by prefixing the token " +"name with B<< pkg.I<package-name>. >>." +msgstr "" + +#. type: verbatim +#: dh_installdebconf:110 +#, no-wrap +msgid "" +"\tcat >> debian/foo.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/bar.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/baz.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +" dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define " +"pkg.bar.TOKEN=unique-bar-value \\\n" +" --define pkg.baz.TOKEN=unique-baz-value\n" +"\n" +msgstr "" + +#. type: textblock +#: dh_installdebconf:125 +msgid "" +"In this example, B<#TOKEN#> will expand to B<default> in " +"F<debian/foo.config>, to B<unique-bar-value> in F<debian/bar.config> and to " +"B<unique-baz-value> in F<debian/baz.config>." +msgstr "" + +#. type: textblock +#: dh_installdebconf:129 +msgid "" +"Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. " +"E.g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.config> and it " +"will be replaced by B<unique-bar-value>." +msgstr "" + +#. type: textblock +#: dh_installdebconf:137 +msgid "" +"The B<dh_installdebconf> will automatically replace the following tokens " +"inside a provided maintainer script (if not replaced via B<-D>/B<--define>):" +msgstr "" + +#. type: textblock +#: dh_installdebconf:173 +msgid "" +"Tokens that do not match that regex will be silently ignored if found in the " +"script template. Invalid token names passed to B<-D> or B<--define> will " +"cause B<dh_installdebconf> to reject the command with an error in most " +"cases." +msgstr "" + #. type: textblock #: dh_installdirs:5 msgid "dh_installdirs - create subdirectories in package build directories" @@ -6155,7 +6692,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdocs:116 dh_installexamples:55 dh_installinfo:52 dh_installman:102 +#: dh_installdocs:116 dh_installexamples:59 dh_installinfo:52 dh_installman:102 msgid "" "Look in the specified directory for files to be installed. This option " "requires compat 11 or later (it is silently ignored in compat 10 or " @@ -6172,12 +6709,12 @@ msgid "" msgstr "" #. type: =item -#: dh_installdocs:124 dh_installexamples:63 +#: dh_installdocs:124 dh_installexamples:67 msgid "B<--doc-main-package=>I<main-package>" msgstr "" #. type: textblock -#: dh_installdocs:126 dh_installexamples:65 +#: dh_installdocs:126 dh_installexamples:69 msgid "" "Set the main package for a documentation package. This is used to install " "the documentation of the documentation package in F<< " @@ -6186,7 +6723,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdocs:131 dh_installexamples:70 +#: dh_installdocs:131 dh_installexamples:74 msgid "" "In compat 11 (or later), this option is only useful if debhelper's " "auto-detection of the main package is wrong. The option can also be used to " @@ -6450,14 +6987,23 @@ msgid "Lists example files or directories to be installed." msgstr "" #. type: textblock -#: dh_installexamples:50 +#: dh_installexamples:39 +msgid "" +"If upstream provides an F<examples> directory, you will often want to use " +"B<examples/*> rather than B<examples> in this file. The latter would create " +"F<< /usr/share/doc/I<package>/examples/examples >>, which is rarely what you " +"want." +msgstr "" + +#. type: textblock +#: dh_installexamples:54 msgid "" "Install any files specified by command line parameters in ALL packages acted " "on." msgstr "" #. type: textblock -#: dh_installexamples:58 +#: dh_installexamples:62 msgid "" "Note that this is not the same as the B<--sourcedirectory> option used by " "the B<dh_auto_>I<*> commands. You rarely need to use this option, since " @@ -6466,7 +7012,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installexamples:75 +#: dh_installexamples:79 msgid "" "This option cannot be used when B<dh_installexamples> is instructed to act " "on multiple packages. If you need this option, you will generally need to " @@ -6474,21 +7020,21 @@ msgid "" msgstr "" #. type: textblock -#: dh_installexamples:82 +#: dh_installexamples:86 msgid "" "Exclude files that contain I<item> anywhere in their filename from being " "installed." msgstr "" #. type: textblock -#: dh_installexamples:87 +#: dh_installexamples:91 msgid "" "Install these files (or directories) as examples into the first package " "acted on. (Or into all packages if B<-A> is specified.)" msgstr "" #. type: textblock -#: dh_installexamples:94 +#: dh_installexamples:98 msgid "" "Note that B<dh_installexamples> will happily copy entire directory " "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to " @@ -6686,8 +7232,9 @@ msgstr "" #. type: textblock #: dh_installinit:67 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"in the package build directory. Only used in compat levels 10 and below." +"If this exists, it is installed into F<< " +"lib/systemd/system/I<package>.service >> in the package build " +"directory. Only used in compat levels 10 and below." msgstr "" #. type: =item @@ -6699,22 +7246,21 @@ msgstr "" #: dh_installinit:72 msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.) Only used in compat levels 10 and below." +"the package build directory. Only used in compat levels 10 and below." msgstr "" #. type: textblock -#: dh_installinit:84 +#: dh_installinit:83 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts." msgstr "" #. type: =item -#: dh_installinit:86 +#: dh_installinit:85 msgid "B<-o>, B<--only-scripts>" msgstr "" #. type: textblock -#: dh_installinit:88 +#: dh_installinit:87 msgid "" "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install " "any init script, default files, upstart job or systemd service file. May be " @@ -6723,7 +7269,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:93 +#: dh_installinit:92 msgid "" "B<Caveat>: This will bypass all the regular checks and I<unconditionally> " "modify the scripts. You will almost certainly want to use this with B<-p> " @@ -6731,7 +7277,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh_installinit:98 +#: dh_installinit:97 #, no-wrap msgid "" " override_dh_installinit:\n" @@ -6741,26 +7287,26 @@ msgid "" msgstr "" #. type: =item -#: dh_installinit:102 +#: dh_installinit:101 msgid "B<-R>, B<--restart-after-upgrade>" msgstr "" #. type: textblock -#: dh_installinit:104 +#: dh_installinit:103 msgid "" "Do not stop the init script until after the package upgrade has been " "completed. This is the default behaviour in compat 10." msgstr "" #. type: textblock -#: dh_installinit:107 +#: dh_installinit:106 msgid "" "In early compat levels, the default was to stop the script in the F<prerm>, " "and starts it again in the F<postinst>." msgstr "" #. type: textblock -#: dh_installinit:110 dh_systemd_start:45 +#: dh_installinit:109 dh_systemd_start:45 msgid "" "This can be useful for daemons that should not have a possibly long downtime " "during upgrade. But you should make sure that the daemon will not get " @@ -6769,12 +7315,12 @@ msgid "" msgstr "" #. type: =item -#: dh_installinit:115 dh_systemd_start:50 +#: dh_installinit:114 dh_systemd_start:50 msgid "B<--no-restart-after-upgrade>" msgstr "" #. type: textblock -#: dh_installinit:117 dh_systemd_start:52 +#: dh_installinit:116 dh_systemd_start:52 msgid "" "Undo a previous B<--restart-after-upgrade> (or the default of compat 10). " "If no other options are given, this will cause the service to be stopped in " @@ -6782,19 +7328,19 @@ msgid "" msgstr "" #. type: =item -#: dh_installinit:122 dh_systemd_start:57 +#: dh_installinit:121 dh_systemd_start:57 msgid "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" msgstr "" #. type: textblock -#: dh_installinit:124 +#: dh_installinit:123 msgid "" "Do not stop init script on upgrade. This has the side-effect of not " "restarting the service as a part of the upgrade." msgstr "" #. type: textblock -#: dh_installinit:127 +#: dh_installinit:126 msgid "" "If you want to restart the service with minimal downtime, please use " "B<--restart-after-upgrade> (default in compat 10 or later). If you want the " @@ -6803,7 +7349,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:132 +#: dh_installinit:131 msgid "" "Note that the B<--no-restart-on-upgrade> alias is deprecated and will be " "removed in compat 12. This is to avoid confusion with the " @@ -6812,24 +7358,24 @@ msgid "" msgstr "" #. type: =item -#: dh_installinit:137 dh_systemd_start:61 +#: dh_installinit:136 dh_systemd_start:61 msgid "B<--no-start>" msgstr "" #. type: textblock -#: dh_installinit:139 +#: dh_installinit:138 msgid "" "Do not start the init script on install or upgrade, or stop it on removal. " "Only call B<update-rc.d>. Useful for rcS scripts." msgstr "" #. type: =item -#: dh_installinit:142 dh_systemd_enable:87 +#: dh_installinit:141 dh_systemd_enable:86 msgid "B<--no-enable>" msgstr "" #. type: textblock -#: dh_installinit:144 +#: dh_installinit:143 msgid "" "Disable the init script on purge, but do not enable them on install. This " "implies a versioned dependency on B<< init-system-helpers (E<gt>= 1.51) >> " @@ -6838,7 +7384,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:149 +#: dh_installinit:148 msgid "" "B<Note> that this option does not affect whether the services are started. " "Please remember to also use B<--no-start> if the service should not be " @@ -6846,19 +7392,19 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:153 +#: dh_installinit:152 msgid "" "Cannot be combined with B<-u>I<params>, B<--update-rcd-params=>I<params>, or " "B<--> I<params>." msgstr "" #. type: =item -#: dh_installinit:156 +#: dh_installinit:155 msgid "B<-d>, B<--remove-d>" msgstr "" #. type: textblock -#: dh_installinit:158 +#: dh_installinit:157 msgid "" "Remove trailing B<d> from the name of the package, and use the result for " "the filename the upstart job file is installed as in F<etc/init/> , and for " @@ -6869,12 +7415,12 @@ msgid "" msgstr "" #. type: =item -#: dh_installinit:165 +#: dh_installinit:164 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>" msgstr "" #. type: textblock -#: dh_installinit:169 +#: dh_installinit:168 msgid "" "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> (or " "B<defaults-disabled> with B<--no-enable>) will be passed to " @@ -6882,12 +7428,12 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:173 +#: dh_installinit:172 msgid "Cannot be combined with B<--no-enable>." msgstr "" #. type: textblock -#: dh_installinit:177 +#: dh_installinit:176 msgid "" "Install the init script (and default file) as well as upstart job file using " "the filename I<name> instead of the default filename, which is the package " @@ -6898,12 +7444,12 @@ msgid "" msgstr "" #. type: =item -#: dh_installinit:185 +#: dh_installinit:184 msgid "B<--init-script=>I<scriptname>" msgstr "" #. type: textblock -#: dh_installinit:187 +#: dh_installinit:186 msgid "" "Use I<scriptname> as the filename the init script is installed as in " "F<etc/init.d/> (and also use it as the filename for the defaults file, if it " @@ -6914,19 +7460,19 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:194 +#: dh_installinit:193 msgid "" "This parameter is deprecated, use the B<--name> parameter instead. This " "parameter is incompatible with the use of upstart jobs." msgstr "" #. type: =item -#: dh_installinit:197 +#: dh_installinit:196 msgid "B<--error-handler=>I<function>" msgstr "" #. type: textblock -#: dh_installinit:199 +#: dh_installinit:198 msgid "" "Call the named shell I<function> if running the init script fails. The " "function should be provided in the F<prerm> and F<postinst> scripts, before " @@ -6934,17 +7480,17 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:432 +#: dh_installinit:415 msgid "L<debhelper(7)>, L<dh_installsystemd(1)>" msgstr "" #. type: textblock -#: dh_installinit:440 +#: dh_installinit:423 msgid "Steve Langasek <steve.langasek@canonical.com>" msgstr "" #. type: textblock -#: dh_installinit:442 +#: dh_installinit:425 msgid "Michael Stapelberg <stapelberg@debian.org>" msgstr "" @@ -7531,14 +8077,22 @@ msgstr "" #. type: textblock #: dh_installpam:30 -msgid "Installed into etc/pam.d/I<package> in the package build directory." +msgid "Installed into usr/lib/pam.d/I<package> in the package build directory." msgstr "" #. type: textblock -#: dh_installpam:40 +#: dh_installpam:32 +msgid "" +"Until compatibility level 14 this file was installed under " +"etc/pam.d/I<package>. Please consider using the \"rm_conffile\" feature from " +"L<dh_installdeb(1)> to ensure the proper removal of previous PAM files." +msgstr "" + +#. type: textblock +#: dh_installpam:44 msgid "" "Look for files named debian/I<package>.I<name>.pam and install them as " -"etc/pam.d/I<name>, instead of using the usual files and installing them " +"usr/lib/pam.d/I<name>, instead of using the usual files and installing them " "using the package name." msgstr "" @@ -8370,7 +8924,8 @@ msgstr "" #: dh_md5sums:37 msgid "" "Include conffiles in the md5sums list. Note that this information is " -"redundant since it is included elsewhere in Debian packages." +"redundant since it is included in F</var/lib/dpkg/status> in Debian " +"packages." msgstr "" #. type: textblock @@ -8471,19 +9026,19 @@ msgid "dh_perl - calculates Perl dependencies and cleans up after MakeMaker" msgstr "" #. type: textblock -#: dh_perl:19 +#: dh_perl:20 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]" msgstr "" #. type: textblock -#: dh_perl:23 +#: dh_perl:24 msgid "" "B<dh_perl> is a debhelper program that is responsible for generating the " "B<${perl:Depends}> substitutions and adding them to substvars files." msgstr "" #. type: textblock -#: dh_perl:26 +#: dh_perl:27 msgid "" "The program will look at Perl scripts and modules in your package, and will " "use this information to generate a dependency on B<perl> or B<perlapi>. The " @@ -8492,19 +9047,19 @@ msgid "" msgstr "" #. type: textblock -#: dh_perl:31 +#: dh_perl:32 msgid "" "B<dh_perl> also cleans up empty directories that MakeMaker can generate when " "installing Perl modules." msgstr "" #. type: =item -#: dh_perl:38 +#: dh_perl:39 msgid "B<-d>" msgstr "" #. type: textblock -#: dh_perl:40 +#: dh_perl:41 msgid "" "In some specific cases you may want to depend on B<perl-base> rather than " "the full B<perl> package. If so, you can pass the -d option to make " @@ -8513,7 +9068,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_perl:45 +#: dh_perl:46 msgid "" "Note that this flag may cause no dependency on B<perl-base> to be generated " "at all. B<perl-base> is Essential, so its dependency can be left out, unless " @@ -8521,12 +9076,12 @@ msgid "" msgstr "" #. type: =item -#: dh_perl:49 +#: dh_perl:50 msgid "B<-V>" msgstr "" #. type: textblock -#: dh_perl:51 +#: dh_perl:52 msgid "" "By default, scripts and architecture independent modules don't depend on any " "specific version of B<perl>. The B<-V> option causes the current version of " @@ -8534,12 +9089,12 @@ msgid "" msgstr "" #. type: =item -#: dh_perl:55 +#: dh_perl:56 msgid "I<library dirs>" msgstr "" #. type: textblock -#: dh_perl:57 +#: dh_perl:58 msgid "" "If your package installs Perl modules in non-standard directories, you can " "make B<dh_perl> check those directories by passing their names on the " @@ -8548,17 +9103,17 @@ msgid "" msgstr "" #. type: textblock -#: dh_perl:66 +#: dh_perl:67 msgid "Debian policy, version 3.8.3" msgstr "" #. type: textblock -#: dh_perl:68 +#: dh_perl:69 msgid "Perl policy, version 1.20" msgstr "" #. type: textblock -#: dh_perl:182 +#: dh_perl:196 msgid "Brendan O'Dea <bod@debian.org>" msgstr "" @@ -9177,85 +9732,89 @@ msgstr "" #. type: textblock #: dh_systemd_enable:47 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"(or lib/systemd/system/I<package>@.service) in the package build directory." +"If this exists, it is installed into F<< " +"lib/systemd/system/I<package>.service >> (or F<< " +"lib/systemd/system/I<package>@.service >>) in the package build directory." msgstr "" #. type: textblock #: dh_systemd_enable:52 msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.)" +"the package build directory." msgstr "" #. type: =item -#: dh_systemd_enable:56 +#: dh_systemd_enable:55 msgid "debian/I<package>.target, debian/I<package>@.target" msgstr "" #. type: textblock -#: dh_systemd_enable:58 +#: dh_systemd_enable:57 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.target " -"(or lib/systemd/system/I<package>@.target) in the package build directory." +"If this exists, it is installed into F<< " +"lib/systemd/system/I<package>.target >> (or F<< " +"lib/systemd/system/I<package>@.target >>) in the package build directory." msgstr "" #. type: =item -#: dh_systemd_enable:61 +#: dh_systemd_enable:60 msgid "debian/I<package>.socket, debian/I<package>@.socket" msgstr "" #. type: textblock -#: dh_systemd_enable:63 +#: dh_systemd_enable:62 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.socket " -"(or lib/systemd/system/I<package>@.socket) in the package build directory." +"If this exists, it is installed into F<< " +"lib/systemd/system/I<package>.socket >> (or F<< " +"lib/systemd/system/I<package>@.socket >>) in the package build directory." msgstr "" #. type: =item -#: dh_systemd_enable:66 +#: dh_systemd_enable:65 msgid "debian/I<package>.mount" msgstr "" #. type: textblock -#: dh_systemd_enable:68 +#: dh_systemd_enable:67 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.mount in " -"the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.mount " +">> in the package build directory." msgstr "" #. type: =item -#: dh_systemd_enable:71 +#: dh_systemd_enable:70 msgid "debian/I<package>.path, debian/I<package>@.path" msgstr "" #. type: textblock -#: dh_systemd_enable:73 +#: dh_systemd_enable:72 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.path (or " -"lib/systemd/system/I<package>@.path) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.path " +">> (or F<< lib/systemd/system/I<package>@.path >>) in the package build " +"directory." msgstr "" #. type: =item -#: dh_systemd_enable:76 +#: dh_systemd_enable:75 msgid "debian/I<package>.timer, debian/I<package>@.timer" msgstr "" #. type: textblock -#: dh_systemd_enable:78 +#: dh_systemd_enable:77 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.timer (or " -"lib/systemd/system/I<package>@.timer) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.timer " +">> (or F<< lib/systemd/system/I<package>@.timer >>) in the package build " +"directory." msgstr "" #. type: textblock -#: dh_systemd_enable:89 +#: dh_systemd_enable:88 msgid "Disable the service(s) on purge, but do not enable them on install." msgstr "" #. type: textblock -#: dh_systemd_enable:91 +#: dh_systemd_enable:90 msgid "" "B<Note> that this option does not affect whether the services are started. " "That is controlled by L<dh_systemd_start(1)> (using e.g. its B<--no-start> " @@ -9263,7 +9822,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_systemd_enable:97 +#: dh_systemd_enable:96 msgid "" "Install the service file as I<name.service> instead of the default filename, " "which is the I<package.service>. When this parameter is used, " @@ -9273,7 +9832,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_systemd_enable:106 dh_systemd_start:70 +#: dh_systemd_enable:105 dh_systemd_start:70 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " "between invocations of this command (with the same arguments). Otherwise, it " @@ -9282,7 +9841,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_systemd_enable:111 +#: dh_systemd_enable:110 msgid "" "Note that B<dh_systemd_enable> should be run before B<dh_installinit>. The " "default sequence in B<dh> does the right thing, this note is only relevant " @@ -9290,12 +9849,12 @@ msgid "" msgstr "" #. type: textblock -#: dh_systemd_enable:283 +#: dh_systemd_enable:282 msgid "L<dh_systemd_start(1)>, L<debhelper(7)>" msgstr "" #. type: textblock -#: dh_systemd_enable:287 dh_systemd_start:286 +#: dh_systemd_enable:286 dh_systemd_start:286 msgid "pkg-systemd-maintainers@lists.alioth.debian.org" msgstr "" diff --git a/man/po4a/po/es.po b/man/po4a/po/es.po index a471cb52c61e5d73570cb97d1ccbddd1f0cac46e..01b4fa61a0ebb237943cbc9d34e0484f3eb7a8cd 100644 --- a/man/po4a/po/es.po +++ b/man/po4a/po/es.po @@ -31,7 +31,7 @@ msgid "" msgstr "" "Project-Id-Version: debhelper 9.20120609\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2021-02-22 09:37+0100\n" +"POT-Creation-Date: 2022-11-20 19:46+0100\n" "PO-Revision-Date: 2012-08-20 11:17+0200\n" "Last-Translator: Omar Campagne <ocampagne@gmail.com>\n" "Language-Team: Debian l10n Spanish <debian-l10n-spanish@lists.debian.org>\n" @@ -44,10 +44,11 @@ msgstr "" # type: =head1 #. type: =head1 -#: debhelper.pod:3 debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 -#: dh_auto_clean:3 dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 -#: dh_bugfiles:3 dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 -#: dh_gconf:3 dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 +#: debhelper.pod:3 debhelper-compat-upgrade-checklist.pod:3 +#: debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 dh_auto_clean:3 +#: dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 dh_bugfiles:3 +#: dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 +#: dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 #: dh_installchangelogs:3 dh_installcron:3 dh_installdeb:3 dh_installdebconf:3 #: dh_installdirs:3 dh_installdocs:5 dh_installemacsen:3 dh_installexamples:5 #: dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installinitramfs:3 @@ -69,19 +70,20 @@ msgstr "debhelper - El conjunto de herramientas debhelper" # type: =head1 #. type: =head1 -#: debhelper.pod:7 debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 -#: dh_auto_clean:16 dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 -#: dh_bugfiles:15 dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 -#: dh_fixperms:16 dh_gconf:15 dh_gencontrol:16 dh_icons:16 dh_install:15 -#: dh_installcatalogs:17 dh_installchangelogs:15 dh_installcron:15 -#: dh_installdeb:15 dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 +#: debhelper.pod:7 debhelper-compat-upgrade-checklist.pod:7 +#: debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 dh_auto_clean:16 +#: dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 dh_bugfiles:15 +#: dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 dh_fixperms:16 +#: dh_gencontrol:16 dh_icons:16 dh_install:15 dh_installcatalogs:17 +#: dh_installchangelogs:16 dh_installcron:15 dh_installdeb:15 +#: dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 #: dh_installemacsen:15 dh_installexamples:17 dh_installifupdown:15 #: dh_installinfo:15 dh_installinit:16 dh_installinitramfs:15 #: dh_installlogcheck:15 dh_installlogrotate:15 dh_installman:16 #: dh_installmanpages:16 dh_installmenu:15 dh_installmime:15 #: dh_installmodules:16 dh_installpam:15 dh_installppp:15 dh_installudev:15 #: dh_installwm:15 dh_installxfonts:15 dh_link:16 dh_lintian:15 -#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:17 +#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:18 #: dh_prep:15 dh_shlibdeps:17 dh_strip:16 dh_testdir:15 dh_testroot:9 #: dh_usrlocal:19 dh_systemd_enable:16 dh_systemd_start:17 msgid "SYNOPSIS" @@ -103,19 +105,19 @@ msgstr "" # type: =head1 #. type: =head1 -#: debhelper.pod:11 dh:26 dh_auto_build:20 dh_auto_clean:20 -#: dh_auto_configure:20 dh_auto_install:22 dh_auto_test:20 dh_bugfiles:19 -#: dh_builddeb:21 dh_clean:19 dh_compress:21 dh_dwz:20 dh_fixperms:20 -#: dh_gconf:19 dh_gencontrol:20 dh_icons:20 dh_install:19 dh_installcatalogs:21 -#: dh_installchangelogs:19 dh_installcron:19 dh_installdeb:19 -#: dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 +#: debhelper.pod:11 debhelper-compat-upgrade-checklist.pod:17 dh:26 +#: dh_auto_build:20 dh_auto_clean:20 dh_auto_configure:20 dh_auto_install:22 +#: dh_auto_test:20 dh_bugfiles:19 dh_builddeb:21 dh_clean:19 dh_compress:21 +#: dh_dwz:20 dh_fixperms:20 dh_gencontrol:20 dh_icons:20 dh_install:19 +#: dh_installcatalogs:21 dh_installchangelogs:20 dh_installcron:19 +#: dh_installdeb:19 dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 #: dh_installemacsen:19 dh_installexamples:21 dh_installifupdown:19 #: dh_installinfo:19 dh_installinit:20 dh_installinitramfs:19 #: dh_installlogcheck:19 dh_installlogrotate:19 dh_installman:20 #: dh_installmanpages:20 dh_installmenu:19 dh_installmime:19 #: dh_installmodules:20 dh_installpam:19 dh_installppp:19 dh_installudev:19 #: dh_installwm:19 dh_installxfonts:19 dh_link:20 dh_lintian:19 -#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:21 +#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:22 #: dh_prep:19 dh_shlibdeps:21 dh_strip:20 dh_testdir:19 dh_testroot:13 #: dh_usrlocal:23 dh_systemd_enable:20 dh_systemd_start:21 msgid "DESCRIPTION" @@ -644,21 +646,36 @@ msgstr "B<-v>, B<--verbose>" # type: textblock #. type: textblock #: debhelper.pod:277 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." +msgid "Verbose mode: show commands that modify the package build directory." +msgstr "" +"Modo explicativo: muestra todas las órdenes que modifican el directorio de " +"construcción del paquete." + +# type: textblock +#. type: textblock +#: debhelper.pod:279 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." msgid "" -"Verbose mode: show all commands that modify the package build directory." +"Note that verbose mode may also output other \"internal\" commands that do " +"not directly affect the package build directory." msgstr "" "Modo explicativo: muestra todas las órdenes que modifican el directorio de " "construcción del paquete." # type: =item #. type: =item -#: debhelper.pod:279 dh:266 +#: debhelper.pod:282 dh:307 msgid "B<--no-act>" msgstr "B<--no-act>" # type: textblock #. type: textblock -#: debhelper.pod:281 +#: debhelper.pod:284 msgid "" "Do not really do anything. If used with -v, the result is that the command " "will output what it would have done." @@ -668,13 +685,13 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:284 +#: debhelper.pod:287 msgid "B<-a>, B<--arch>" msgstr "B<-a>, B<--arch>" # type: textblock #. type: textblock -#: debhelper.pod:286 +#: debhelper.pod:289 #, fuzzy #| msgid "" #| "Act on architecture dependent packages that should be built for the build " @@ -688,25 +705,25 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:289 +#: debhelper.pod:292 msgid "B<-i>, B<--indep>" msgstr "B<-i>, B<--indep>" # type: textblock #. type: textblock -#: debhelper.pod:291 +#: debhelper.pod:294 msgid "Act on all architecture independent packages." msgstr "Actúa en todos los paquetes independientes de la arquitectura." # type: =item #. type: =item -#: debhelper.pod:293 +#: debhelper.pod:296 msgid "B<-p>I<package>, B<--package=>I<package>" msgstr "B<-p>I<paquete>, B<--package=>I<paquete>" # type: textblock #. type: textblock -#: debhelper.pod:295 +#: debhelper.pod:298 msgid "" "Act on the package named I<package>. This option may be specified multiple " "times to make debhelper operate on a given set of packages." @@ -717,29 +734,29 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:298 +#: debhelper.pod:301 msgid "B<-s>, B<--same-arch>" msgstr "B<-s>, B<--same-arch>" #. type: textblock -#: debhelper.pod:300 +#: debhelper.pod:303 msgid "Deprecated alias of B<-a>." msgstr "" #. type: textblock -#: debhelper.pod:302 dh_install:80 dh_install:89 +#: debhelper.pod:305 dh_install:80 dh_install:89 msgid "This option is removed in compat 12." msgstr "" # type: =item #. type: =item -#: debhelper.pod:304 +#: debhelper.pod:307 msgid "B<-N>I<package>, B<--no-package=>I<package>" msgstr "B<-N>I<paquete>, B<--no-package=>I<paquete>" # type: textblock #. type: textblock -#: debhelper.pod:306 +#: debhelper.pod:309 msgid "" "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option " "lists the package as one that should be acted on." @@ -749,12 +766,12 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:309 +#: debhelper.pod:312 msgid "B<--remaining-packages>" msgstr "B<--remaining-packages>" #. type: textblock -#: debhelper.pod:311 +#: debhelper.pod:314 msgid "" "Do not act on the packages which have already been acted on by this " "debhelper command earlier (i.e. if the command is present in the package " @@ -771,13 +788,13 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:317 +#: debhelper.pod:320 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" msgstr "B<-P>I<directorio_temporal>, B<--tmpdir=>I<directorio_temporal>" # type: textblock #. type: textblock -#: debhelper.pod:319 +#: debhelper.pod:322 msgid "" "Use I<tmpdir> for package build directory. The default is debian/I<package>" msgstr "" @@ -786,13 +803,13 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:321 +#: debhelper.pod:324 msgid "B<--mainpackage=>I<package>" msgstr "B<--mainpackage=>I<paquete>" # type: textblock #. type: textblock -#: debhelper.pod:323 +#: debhelper.pod:326 msgid "" "This little-used option changes the package which debhelper considers the " "\"main package\", that is, the first one listed in F<debian/control>, and " @@ -805,12 +822,12 @@ msgstr "" "usuales F<debian/package.tal>." #. type: =item -#: debhelper.pod:328 +#: debhelper.pod:331 msgid "B<-O=>I<option>|I<bundle>" msgstr "B<-O=>I<opción>|I<fichero>" #. type: textblock -#: debhelper.pod:330 +#: debhelper.pod:333 msgid "" "This is used by L<dh(1)> when passing user-specified options to all the " "commands it runs. If the command supports the specified option or option " @@ -824,13 +841,13 @@ msgstr "" # type: =head1 #. type: =head1 -#: debhelper.pod:337 +#: debhelper.pod:340 msgid "COMMON DEBHELPER OPTIONS" msgstr "OPCIONES COMUNES DE DEBHELPER" # type: textblock #. type: textblock -#: debhelper.pod:339 +#: debhelper.pod:342 msgid "" "The following command line options are supported by some debhelper " "programs. See the man page of each program for a complete explanation of " @@ -842,27 +859,27 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:345 +#: debhelper.pod:348 msgid "B<-n>" msgstr "B<-n>" # type: textblock #. type: textblock -#: debhelper.pod:347 +#: debhelper.pod:350 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts." msgstr "No modifica los scripts F<postinst>, F<postrm>, etc." # type: =item #. type: =item -#: debhelper.pod:349 dh_compress:56 dh_dwz:56 dh_installchangelogs:83 -#: dh_installdocs:109 dh_installexamples:80 dh_link:78 dh_makeshlibs:154 +#: debhelper.pod:352 dh_compress:56 dh_dwz:56 dh_installchangelogs:89 +#: dh_installdocs:109 dh_installexamples:84 dh_link:78 dh_makeshlibs:154 #: dh_md5sums:40 dh_shlibdeps:34 dh_strip:42 msgid "B<-X>I<item>, B<--exclude=>I<item>" msgstr "B<-X>I<elemento>, B<--exclude=>I<elemento>" # type: textblock #. type: textblock -#: debhelper.pod:351 +#: debhelper.pod:354 #, fuzzy #| msgid "" #| "Exclude an item from processing. This option may be used multiple times, " @@ -877,15 +894,15 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:355 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 -#: dh_installdocs:104 dh_installexamples:48 dh_installinfo:45 dh_installman:90 +#: debhelper.pod:358 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 +#: dh_installdocs:104 dh_installexamples:52 dh_installinfo:45 dh_installman:90 #: dh_installwm:55 dh_link:73 msgid "B<-A>, B<--all>" msgstr "B<-A>, B<--all>" # type: textblock #. type: textblock -#: debhelper.pod:357 +#: debhelper.pod:360 msgid "" "Makes files or other items that are specified on the command line take " "effect in ALL packages acted on, not just the first." @@ -894,12 +911,12 @@ msgstr "" "tengan efecto en TODOS los paquetes sobre los que actúa, no sólo el primero." #. type: =head1 -#: debhelper.pod:362 +#: debhelper.pod:365 msgid "BUILD SYSTEM OPTIONS" msgstr "OPCIONES DEL SISTEMA DE CONSTRUCCIÓN" #. type: textblock -#: debhelper.pod:364 +#: debhelper.pod:367 msgid "" "The following command line options are supported by all of the " "B<dh_auto_>I<*> debhelper programs. These programs support a variety of " @@ -917,13 +934,13 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:373 +#: debhelper.pod:376 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>" msgstr "" "B<-S>I<sistema-de-construcción>, B<--buildsystem=>I<sistema-de-construcción>" #. type: textblock -#: debhelper.pod:375 +#: debhelper.pod:378 msgid "" "Force use of the specified I<buildsystem>, instead of trying to auto-select " "one which might be applicable for the package." @@ -932,13 +949,13 @@ msgstr "" "seleccionar uno de forma automática que podrÃa ser adecuado para el paquete." #. type: textblock -#: debhelper.pod:378 +#: debhelper.pod:381 msgid "Pass B<none> as I<buildsystem> to disable auto-selection." msgstr "" # type: =item #. type: =item -#: debhelper.pod:380 +#: debhelper.pod:383 #, fuzzy #| msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>" msgid "" @@ -947,7 +964,7 @@ msgid "" msgstr "B<-D>I<directorio>, B<--sourcedirectory=>I<directorio>" #. type: textblock -#: debhelper.pod:382 +#: debhelper.pod:385 msgid "" "Assume that the original package source tree is at the specified " "I<directory> rather than the top level directory of the Debian source " @@ -958,7 +975,7 @@ msgstr "" "del paquete fuente de Debian." #. type: textblock -#: debhelper.pod:386 +#: debhelper.pod:389 msgid "" "B<Warning>: The B<--sourcedir> variant matches a similar named option in " "B<dh_install> and B<dh_missing> (etc.) for historical reasons. While they " @@ -969,7 +986,7 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:392 +#: debhelper.pod:395 #, fuzzy #| msgid "B<-B>[I<directory>], B<--builddirectory=>[I<directory>]" msgid "" @@ -978,7 +995,7 @@ msgid "" msgstr "B<-B>[I<directorio>], B<--builddirectory=>[I<directorio>]" #. type: textblock -#: debhelper.pod:394 +#: debhelper.pod:397 #, fuzzy #| msgid "" #| "Enable out of source building and use the specified I<directory> as the " @@ -994,7 +1011,7 @@ msgstr "" "de construcción predeterminado si se omite el parámetro I<directorio>." #. type: textblock -#: debhelper.pod:398 +#: debhelper.pod:401 msgid "" "If this option is not specified, building will be done in source by default " "unless the build system requires or prefers out of source tree building. In " @@ -1008,7 +1025,7 @@ msgstr "" "define B<--builddirectory>." #. type: textblock -#: debhelper.pod:403 +#: debhelper.pod:406 msgid "" "If the build system prefers out of source tree building but still allows in " "source building, the latter can be re-enabled by passing a build directory " @@ -1021,14 +1038,14 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:407 +#: debhelper.pod:410 #, fuzzy #| msgid "B<-A>, B<--all>" msgid "B<--parallel>, B<--no-parallel>" msgstr "B<-A>, B<--all>" #. type: textblock -#: debhelper.pod:409 +#: debhelper.pod:412 #, fuzzy #| msgid "" #| "Enable parallel builds if underlying build system supports them. The " @@ -1048,7 +1065,7 @@ msgstr "" "sistema de construcción." #. type: textblock -#: debhelper.pod:415 +#: debhelper.pod:418 #, fuzzy #| msgid "" #| "If this option is not specified, debhelper currently defaults to not " @@ -1061,7 +1078,7 @@ msgstr "" "paralelo de paquetes de forma predeterminada." #. type: textblock -#: debhelper.pod:418 +#: debhelper.pod:421 msgid "" "As an optimization, B<dh> will try to avoid passing these options to " "subprocesses, if they are unnecessary and the only options passed. Notably " @@ -1070,12 +1087,12 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:423 +#: debhelper.pod:426 msgid "B<--max-parallel=>I<maximum>" msgstr "B<--max-parallel=>I<máximo>" #. type: textblock -#: debhelper.pod:425 +#: debhelper.pod:428 msgid "" "This option implies B<--parallel> and allows further limiting the number of " "jobs that can be used in a parallel build. If the package build is known to " @@ -1089,27 +1106,27 @@ msgstr "" "desea permitir." #. type: textblock -#: debhelper.pod:430 +#: debhelper.pod:433 msgid "" "Notably, setting the maximum to 1 is effectively the same as using B<--no-" "parallel>." msgstr "" #. type: =item -#: debhelper.pod:433 +#: debhelper.pod:436 msgid "B<--reload-all-buildenv-variables>" msgstr "" #. type: textblock -#: debhelper.pod:435 +#: debhelper.pod:438 msgid "" -"By default, L<dh(1)> will compute several environment (e.g. by using L<dpkg-" -"buildflags(1)>) and cache them to avoid having all B<dh_auto_*> tool " -"recompute them." +"By default, L<dh(1)> will compute several environment variables (e.g. by " +"using L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> " +"tool recompute them." msgstr "" #. type: textblock -#: debhelper.pod:439 +#: debhelper.pod:442 msgid "" "When passing this option, the concrete B<dh_auto_*> tool will ignore the " "cache from L<dh(1)> and retrigger a rebuild of these variables. This is " @@ -1119,7 +1136,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:446 +#: debhelper.pod:449 #, no-wrap msgid "" " export DEB_CFLAGS_MAINT_APPEND=-O3\n" @@ -1127,7 +1144,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:448 +#: debhelper.pod:451 #, no-wrap msgid "" " %:\n" @@ -1136,7 +1153,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:451 +#: debhelper.pod:454 #, no-wrap msgid "" " override_dh_auto_configure:\n" @@ -1147,7 +1164,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:456 +#: debhelper.pod:459 msgid "" "Without B<--reload-all-buildenv-variables> in the second call to " "L<dh_auto_configure(1)>, the change in B<DEB_CFLAGS_MAINT_APPEND> would be " @@ -1156,7 +1173,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:461 +#: debhelper.pod:464 msgid "" "This option is only available with B<< debhelper (>= 12.7~) >> when the " "package uses compatibility level 9 or later." @@ -1164,12 +1181,12 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:464 dh:258 +#: debhelper.pod:467 dh:299 msgid "B<--list>, B<-l>" msgstr "B<--list>, B<-l>" #. type: textblock -#: debhelper.pod:466 +#: debhelper.pod:469 msgid "" "List all build systems supported by debhelper on this system. The list " "includes both default and third party build systems (marked as such). Also " @@ -1183,13 +1200,13 @@ msgstr "" "buildsystem>." #. type: =head1 -#: debhelper.pod:473 +#: debhelper.pod:476 msgid "COMPATIBILITY LEVELS" msgstr "NIVELES DE COMPATIBILIDAD" # type: textblock #. type: textblock -#: debhelper.pod:475 +#: debhelper.pod:478 #, fuzzy #| msgid "" #| "From time to time, major non-backwards-compatible changes need to be made " @@ -1216,7 +1233,7 @@ msgstr "" # type: textblock #. type: textblock -#: debhelper.pod:482 +#: debhelper.pod:485 #, fuzzy #| msgid "" #| "Tell debhelper what compatibility level to use by writing a number to " @@ -1232,7 +1249,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: debhelper.pod:486 +#: debhelper.pod:489 #, fuzzy, no-wrap #| msgid "" #| " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#)\n" @@ -1245,7 +1262,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:488 +#: debhelper.pod:491 msgid "" "This also serves as an appropriate versioned build dependency on a " "sufficient version of the debhelper package, so you do not need to specify a " @@ -1255,31 +1272,31 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:494 +#: debhelper.pod:497 msgid "" "Note that debhelper does not provide debhelper-compat for experimental or " "beta compatibility levels; packages experimenting with those compatibility " -"levels should use F<debian/compat> or B<DH_COMPAT>." +"levels should use F<debian/compat> (or, if only for selected commands, " +"B<DH_COMPAT>)." msgstr "" #. type: textblock -#: debhelper.pod:498 +#: debhelper.pod:501 msgid "" "Prior versions of debhelper required specifying the compatibility level in " "the file F<debian/compat>, and current debhelper still supports this for " -"backward compatibility, though a package may not specify a compatibility " -"level via multiple methods at once. To use this method, F<debian/compat> " -"should contain the compatibility level as a single number, and no other " -"content. If you specify the compatibility level by this method, your package " -"will also need a versioned build dependency on a version of the debhelper " -"package equal to (or greater than) the compatibility level your package " -"uses. So, if you specify compatibility level #RECOMMENDED_COMPAT# in " -"F<debian/compat>, ensure F<debian/control> has:" +"backward compatibility. To use this method, the F<debian/compat> file should " +"contain the compatibility level as a single number, and no other content. If " +"you specify the compatibility level by this method, your package will also " +"need a versioned build dependency on a version of the debhelper package " +"equal to (or greater than) the compatibility level your package uses. So, if " +"you specify compatibility level #RECOMMENDED_COMPAT# in F<debian/compat>, " +"ensure F<debian/control> has:" msgstr "" # type: verbatim #. type: verbatim -#: debhelper.pod:509 +#: debhelper.pod:511 #, fuzzy, no-wrap #| msgid "" #| " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#)\n" @@ -1291,9 +1308,29 @@ msgstr "" " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#)\n" "\n" +#. type: textblock +#: debhelper.pod:513 +msgid "" +"Note that you must use either the build-dependency on debhelper-compat or " +"the F<debian/compat> file. Whenever possible, the debhelper-compat build-" +"dependency is recommended." +msgstr "" + +#. type: textblock +#: debhelper.pod:517 +msgid "" +"If needed be, the B<DH_COMPAT> environment variable can be used to override " +"the compat level for a given command. The feature is mostly useful for " +"either temporarily upgrading a few commands to a new compat level or keeping " +"a few commands on a lower compat level. The feature is best used sparingly " +"as it effectively introduces special-cases into the F<debian/rules> file " +"that may be surprising to maintainers or reviewers (or, in the long term, to " +"yourself)." +msgstr "" + # type: textblock #. type: textblock -#: debhelper.pod:511 +#: debhelper.pod:525 msgid "" "Unless otherwise indicated, all debhelper documentation assumes that you are " "using the most recent compatibility level, and in most cases does not " @@ -1310,953 +1347,1257 @@ msgstr "" # type: =head2 #. type: =head2 -#: debhelper.pod:518 +#: debhelper.pod:532 #, fuzzy #| msgid "Debhelper compatibility levels" msgid "Supported compatibility levels" msgstr "Niveles de compatibilidad de debhelper" -# type: textblock -#. type: textblock -#: debhelper.pod:520 -msgid "These are the available compatibility levels:" -msgstr "Los niveles de compatibilidad disponibles son:" - -#. type: =item -#: debhelper.pod:524 debhelper-obsolete-compat.pod:89 -msgid "v5" -msgstr "v5" - -# type: textblock -#. type: textblock -#: debhelper.pod:526 debhelper-obsolete-compat.pod:91 -#, fuzzy -#| msgid "These are the available compatibility levels:" -msgid "This is the lowest supported compatibility level." -msgstr "Los niveles de compatibilidad disponibles son:" - #. type: textblock -#: debhelper.pod:528 +#: debhelper.pod:534 msgid "" -"If you are upgrading from an earlier compatibility level, please review " -"L<debhelper-obsolete-compat(7)>." +"The list of supported compatibility levels and the related upgrade check " +"list has moved to L<debhelper-compat-upgrade-checklist(7)>." msgstr "" -# type: textblock -#. type: textblock -#: debhelper.pod:531 debhelper.pod:563 debhelper.pod:593 debhelper.pod:624 -#: debhelper.pod:685 debhelper-obsolete-compat.pod:28 -#: debhelper-obsolete-compat.pod:35 debhelper-obsolete-compat.pod:58 -#: debhelper-obsolete-compat.pod:87 -msgid "This mode is deprecated." -msgstr "Este modo está obsoleto." - -#. type: =item -#: debhelper.pod:533 -msgid "v6" -msgstr "v6" - -#. type: textblock -#: debhelper.pod:535 -msgid "Changes from v5 are:" -msgstr "Los cambios desde el nivel v5 son:" +# type: =head1 +#. type: =head1 +#: debhelper.pod:537 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 +#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:96 +#: dh_installinit:204 dh_installinitramfs:60 dh_installman:131 +#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 +#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:103 +#: dh_systemd_start:68 +msgid "NOTES" +msgstr "NOTAS" -# type: =item -#. type: =item -#: debhelper.pod:539 debhelper.pod:544 debhelper.pod:550 debhelper.pod:556 -#: debhelper.pod:571 debhelper.pod:578 debhelper.pod:582 debhelper.pod:586 -#: debhelper.pod:601 debhelper.pod:605 debhelper.pod:613 debhelper.pod:618 -#: debhelper.pod:632 debhelper.pod:637 debhelper.pod:644 debhelper.pod:649 -#: debhelper.pod:654 debhelper.pod:662 debhelper.pod:668 debhelper.pod:673 -#: debhelper.pod:678 debhelper.pod:693 debhelper.pod:698 debhelper.pod:704 -#: debhelper.pod:710 debhelper.pod:715 debhelper.pod:721 debhelper.pod:730 -#: debhelper.pod:740 debhelper.pod:746 debhelper.pod:769 debhelper.pod:776 -#: debhelper.pod:782 debhelper.pod:788 debhelper.pod:794 debhelper.pod:823 -#: debhelper.pod:829 debhelper.pod:841 debhelper.pod:849 debhelper.pod:855 -#: debhelper.pod:860 debhelper.pod:865 debhelper.pod:870 debhelper.pod:878 -#: debhelper.pod:888 debhelper.pod:898 debhelper.pod:905 debhelper.pod:917 -#: debhelper.pod:922 debhelper.pod:950 debhelper.pod:967 debhelper.pod:977 -#: debhelper.pod:981 debhelper.pod:986 debhelper.pod:991 debhelper.pod:998 -#: debhelper.pod:1004 debhelper.pod:1012 debhelper.pod:1018 debhelper.pod:1022 -#: debhelper.pod:1027 debhelper.pod:1032 debhelper.pod:1041 debhelper.pod:1057 -#: debhelper.pod:1064 debhelper.pod:1080 debhelper.pod:1088 debhelper.pod:1093 -#: debhelper.pod:1108 debhelper.pod:1116 debhelper.pod:1124 debhelper.pod:1133 -#: debhelper.pod:1139 debhelper.pod:1149 debhelper.pod:1157 debhelper.pod:1163 -#: debhelper.pod:1177 debhelper.pod:1188 debhelper.pod:1202 debhelper.pod:1213 -#: debhelper.pod:1231 debhelper.pod:1245 debhelper-obsolete-compat.pod:43 -#: debhelper-obsolete-compat.pod:48 debhelper-obsolete-compat.pod:52 -#: debhelper-obsolete-compat.pod:66 debhelper-obsolete-compat.pod:71 -#: debhelper-obsolete-compat.pod:76 debhelper-obsolete-compat.pod:81 -#: debhelper-obsolete-compat.pod:97 debhelper-obsolete-compat.pod:101 -#: debhelper-obsolete-compat.pod:106 debhelper-obsolete-compat.pod:110 -#: dh_testroot:36 dh_testroot:41 dh_testroot:46 -msgid "-" -msgstr "-" +# type: =head2 +#. type: =head2 +#: debhelper.pod:539 +msgid "Multiple binary package support" +msgstr "Compatibilidad con varios paquetes binarios" # type: textblock #. type: textblock #: debhelper.pod:541 msgid "" -"Commands that generate maintainer script fragments will order the fragments " -"in reverse order for the F<prerm> and F<postrm> scripts." +"If your source package generates more than one binary package, debhelper " +"programs will default to acting on all binary packages when run. If your " +"source package happens to generate one architecture dependent package, and " +"another architecture independent package, this is not the correct behavior, " +"because you need to generate the architecture dependent packages in the " +"binary-arch F<debian/rules> target, and the architecture independent " +"packages in the binary-indep F<debian/rules> target." msgstr "" -"Las órdenes que generan segmentos de scripts de desarrollador ordenarán " -"estos segmentos en orden inverso para los scripts F<prerm> y F<postrm>." +"Si su paquete fuente genera más de un paquete binario, los programas de " +"debhelper actuarán sobre todos los paquetes binarios de forma " +"predeterminada. Si se diera el caso de que su paquete fuente genera un " +"paquete dependiente de la arquitectura, y otro independiente, éste no serÃa " +"un comportamiento correcto porque necesitará generar los paquetes " +"dependientes de la arquitectura en el objetivo binary-arch de F<debian/" +"rules>, y los paquetes independientes de la arquitectura en el objetivo " +"binary-indep de F<debian/rules>." # type: textblock #. type: textblock -#: debhelper.pod:546 +#: debhelper.pod:549 +#, fuzzy +#| msgid "" +#| "To facilitate this, as well as give you more control over which packages " +#| "are acted on by debhelper programs, all debhelper programs accept the B<-" +#| "a>, B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. " +#| "If none are given, debhelper programs default to acting on all packages " +#| "listed in the control file." msgid "" -"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." -"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " -"directory." +"To facilitate this, as well as give you more control over which packages are " +"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" +"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " +"are given, debhelper programs default to acting on all packages listed in " +"the control file, with the exceptions below." msgstr "" -"B<dh_installwm> instalará un enlace esclavo a la página de manual F<x-window-" -"manager.1.gz> en caso de encontrar la página de manual en F<usr/share/man/" -"man1> dentro del directorio de construcción del paquete." +"Para facilitar esto, asà como para dar mayor control sobre qué paquetes " +"actúan los programas de debhelper, todos estos aceptan los parámetros B<-a>, " +"B<-i>, B<-p>, y B<-s>. Estos parámetros son acumulativos. Si no se " +"especifica ninguno, los programas de debhelper actúan por omisión en todos " +"los paquetes listados en el fichero de control." -# type: textblock #. type: textblock -#: debhelper.pod:552 +#: debhelper.pod:555 msgid "" -"B<dh_builddeb> did not previously delete everything matching " -"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " -"B<CVS:.svn:.git>. Now it does." +"First, any package whose B<Architecture> field in B<debian/control> does not " +"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " +"section 5.6.8>)." msgstr "" -"Anteriormente, B<dh_builddeb> no eliminaba todo aquello que coincidiese con " -"B<DH_ALWAYS_EXCLUDE>, si es que se definÃa con una lista de elementos a " -"excluir, como por ejemplo B<CVS:.svn:.git>. Ahora sà lo hace." -# type: textblock #. type: textblock -#: debhelper.pod:558 +#: debhelper.pod:559 msgid "" -"B<dh_installman> allows overwriting existing man pages in the package build " -"directory. In previous compatibility levels it silently refuses to do this." +"Also, some additional packages may be excluded based on the contents of the " +"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " +"binary package stanzas in B<debian/control>, according to the draft policy " +"at L<https://wiki.debian.org/BuildProfileSpec>." msgstr "" -"B<dh_installman> permite sobreescribir páginas de manual existentes en el " -"directorio de construcción del paquete. Bajo los niveles de compatibilidad " -"anteriores simplemente rechazaba hacerlo, de forma silenciosa." -#. type: =item -#: debhelper.pod:565 -msgid "v7" -msgstr "v7" +#. type: =head3 +#: debhelper.pod:564 +msgid "Interaction between package selections and Build-Profiles" +msgstr "" #. type: textblock -#: debhelper.pod:567 -msgid "Changes from v6 are:" -msgstr "Los cambios desde el nivel v6 son:" +#: debhelper.pod:566 +msgid "" +"Build-Profiles affect which packages are included in the package selections " +"mechanisms in debhelper. Generally, the package selections are described " +"from the assumption that all packages are enabled. This section describes " +"how the selections react when a package is disabled due to the active Build-" +"Profiles (or lack of active Build-Profiles)." +msgstr "" + +#. type: =item +#: debhelper.pod:574 +msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +msgstr "" -# type: textblock #. type: textblock -#: debhelper.pod:573 +#: debhelper.pod:576 msgid "" -"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " -"doesn't find them in the current directory (or wherever you tell it look " -"using B<--sourcedir>). This allows B<dh_install> to interoperate with " -"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " -"special parameters." +"The package disabled by Build-Profiles is silently excluded from the " +"selection." msgstr "" -"B<dh_install> buscará ficheros en F<debian/tmp> de forma predeterminada si " -"no los encuentra en el directorio actual (o dónde indicó hacerlo mediante " -"B<--sourcedir>). Esto permite la interoperabilidad entre B<dh_install> y " -"B<dh_auto_install>, que instala en F<debian/tmp>, sin necesidad de " -"parámetros especiales." -# type: textblock #. type: textblock -#: debhelper.pod:580 -msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +#: debhelper.pod:579 +msgid "" +"Note you will receive a warning if I<all> packages related to these " +"selections are disabled. In that case, it generally does not make sense to " +"do the build in the first place." msgstr "" -"B<dh_clean> leerá F<debian/clean> y eliminará los ficheros ahà listados." -# type: textblock -#. type: textblock -#: debhelper.pod:584 -msgid "B<dh_clean> will delete toplevel F<*-stamp> files." -msgstr "B<dh_clean> eliminará ficheros F<*-stamp> del nivel superior." +# type: =item +#. type: =item +#: debhelper.pod:583 +#, fuzzy +#| msgid "B<-N>I<package>, B<--no-package=>I<package>" +msgid "-N I<package> / --no-package I<package>" +msgstr "B<-N>I<paquete>, B<--no-package=>I<paquete>" -# type: textblock #. type: textblock -#: debhelper.pod:588 -msgid "" -"B<dh_installchangelogs> will guess at what file is the upstream changelog if " -"none is specified." +#: debhelper.pod:585 +msgid "The option is accepted and effectively does nothing." msgstr "" -"B<dh_installchangelogs> intentará averiguar el fichero de registro de " -"cambios de la fuente original si no se especifica ninguno." +# type: =item #. type: =item -#: debhelper.pod:595 -msgid "v8" -msgstr "v8" +#: debhelper.pod:587 +#, fuzzy +#| msgid "B<-p>I<package>, B<--package=>I<package>" +msgid "-p I<package> / --package I<package>" +msgstr "B<-p>I<paquete>, B<--package=>I<paquete>" #. type: textblock -#: debhelper.pod:597 -msgid "Changes from v7 are:" -msgstr "Los cambios desde el nivel v7 son:" +#: debhelper.pod:589 +msgid "The option is accepted, but debhelper will not act on the package." +msgstr "" #. type: textblock -#: debhelper.pod:603 +#: debhelper.pod:593 msgid "" -"Commands will fail rather than warning when they are passed unknown options." +"Note that it does not matter whether a package is enabled or disabled by " +"default." msgstr "" -"Las órdenes fallarán, en lugar de emitir un aviso, cuando se les introduzcan " -"opciones desconocidas." +# type: =head2 +#. type: =head2 +#: debhelper.pod:596 +msgid "Automatic generation of Debian install scripts" +msgstr "Generación automática de los scripts de instalación de Debian" + +# type: textblock #. type: textblock -#: debhelper.pod:607 +#: debhelper.pod:598 msgid "" -"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " -"generates shlibs files for. So B<-X> can be used to exclude libraries. " -"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " -"processed before will be passed to it, a behavior change that can cause some " -"packages to fail to build." +"Some debhelper commands will automatically generate parts of Debian " +"maintainer scripts. If you want these automatically generated things " +"included in your existing Debian maintainer scripts, then you need to add " +"B<#DEBHELPER#> to your scripts, in the place the code should be added. " +"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " +"B<dh_installdeb>." msgstr "" -"B<dh_makeshlibs> ejecutará B<dpkg-gensymbols> sobre todas las bibliotecas " -"compartidas para las que genera ficheros «shlibs». Por ello, puede utilizar " -"B<-X> para excluir bibliotecas. Asà mismo, se introducirán a B<dpkg-" -"gensymbols> bibliotecas en ubicaciones inusuales que antes no procesaba, un " -"cambio de comportamiento que puede impedir la construcción de algunos " -"paquetes." +"Algunas órdenes de debhelper generarán automáticamente parte de los scripts " +"de instalación de Debian. Si quiere que estas órdenes generen " +"automáticamente lo que esté incluido en sus scripts de instalación de " +"Debian, necesitará añadir B<#DEBHELPER#> a sus scripts, en el lugar donde el " +"código se deba añadir. B<#DEBHELPER#> será remplazado por cualquier código " +"auto-generado cuando ejecute B<dh_installdeb>." +# type: textblock #. type: textblock -#: debhelper.pod:615 +#: debhelper.pod:605 msgid "" -"B<dh> requires the sequence to run be specified as the first parameter, and " -"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo $@>" -"\"." +"If a script does not exist at all and debhelper needs to add something to " +"it, then debhelper will create the complete script." msgstr "" -"B<dh> requiere que la secuencia a ejecutar se defina como el primer " -"parámetro, y que las opciones aparezcan a continuación. Por ejemplo, use " -"B<dh $@ --foo>, no B<dh --foo $@>." +"Si el script no existe y debhelper necesita añadir algo en particular, " +"creará el script por completo." +# type: textblock #. type: textblock -#: debhelper.pod:620 +#: debhelper.pod:608 msgid "" -"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " -"F<Makefile.PL>." +"All debhelper commands that automatically generate code in this way let it " +"be disabled by the -n parameter (see above)." msgstr "" -"B<dh_auto_>I<*> prefiere utilizar el módulo de Perl B<Module::Build> con " -"preferencia a un fichero F<Makefile.PL>." - -#. type: =item -#: debhelper.pod:626 -msgid "v9" -msgstr "v9" +"Todas las órdenes de debhelper que generan código automáticamente de esta " +"manera se pueden deshabilitar con el parámetro «-n» (ver arriba)." +# type: textblock #. type: textblock -#: debhelper.pod:628 -msgid "Changes from v8 are:" -msgstr "Los cambios desde el nivel v8 son:" +#: debhelper.pod:611 +msgid "" +"Note that the inserted code will be shell code, so you cannot directly use " +"it in a Perl script. If you would like to embed it into a Perl script, here " +"is one way to do that (note that I made sure that $1, $2, etc are set with " +"the set command):" +msgstr "" +"Observe que el código insertado sera código de consola, y por ello no puede " +"utilizarlo directamente en un script de Perl. Si desea introducirlo en un " +"script de Perl, hágalo de la siguiente forma (tenga en cuenta que en este " +"caso comprobé que $1, $2, etc se definen con la orden «set»):" + +#. type: verbatim +#: debhelper.pod:616 +#, no-wrap +msgid "" +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"The debhelper script failed with error code: ${exit_code}\");\n" +" } else {\n" +" die(\"The debhelper script was killed by signal: ${signal}\");\n" +" }\n" +" }\n" +"\n" +msgstr "" + +# type: =head2 +#. type: =head2 +#: debhelper.pod:629 +msgid "Automatic generation of miscellaneous dependencies." +msgstr "Generación automática de diversas dependencias." #. type: textblock -#: debhelper.pod:634 +#: debhelper.pod:631 msgid "" -"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " -"directories to autoconf in --libdir and --libexecdir." +"Some debhelper commands may make the generated package need to depend on " +"some other packages. For example, if you use L<dh_installdebconf(1)>, your " +"package will generally need to depend on debconf. Or if you use " +"L<dh_installxfonts(1)>, your package will generally need to depend on a " +"particular version of xutils. Keeping track of these miscellaneous " +"dependencies can be annoying since they are dependent on how debhelper does " +"things, so debhelper offers a way to automate it." msgstr "" -"Compatibilidad multiarquitectura, B<dh_auto_configure> introduce directorios " -"multiarquitectura a autoconf en «--libdir» y «--libexecdir»." +"Es posible que algunas órdenes de debhelper hagan que los paquetes generados " +"dependan de otros paquetes. Por ejemplo, si utiliza L<dh_installdebconf(1)>, " +"el paquete generado dependerá de debconf. Si utiliza L<dh_installxfonts(1)>, " +"el paquete dependerá de una determinada versión de xutils. Llevar la cuenta " +"de todas estas dependencias puede ser tedioso porque dependen de cómo " +"debhelper haga las cosas, y por ello debhelper ofrece una manera de " +"automatizarlo." +# type: textblock #. type: textblock #: debhelper.pod:639 msgid "" -"dh is aware of the usual dependencies between targets in debian/rules. So, " -"\"dh binary\" will run any build, build-arch, build-indep, install, etc " -"targets that exist in the rules file. There's no need to define an explicit " -"binary target with explicit dependencies on the other targets." +"All commands of this type, besides documenting what dependencies may be " +"needed on their man pages, will automatically generate a substvar called " +"B<${misc:Depends}>. If you put that token into your F<debian/control> file, " +"it will be expanded to the dependencies debhelper figures you need." msgstr "" -"dh es consciente de las dependencias habituales entre objetivos en «debian/" -"rules». Por ello, «dh binary» ejecuta cualquier objetivo build, build-arch, " -"build-indep e install que se encuentre en el fichero «rules». No es " -"necesario definir un objetivo binario explÃcito con dependencias explÃcitas " -"sobre otros objetivos." +"Todas las órdenes de este tipo, además de documentar qué dependencias pueden " +"ser necesarias en sus páginas de manual, generarán automáticamente una " +"variable de sustitución llamada B<${misc:Depends}>. Si introduce esta " +"variable en el fichero F<debian/control>, se expandirá a las dependencias " +"que debhelper crea oportunas." +# type: textblock #. type: textblock -#: debhelper.pod:646 +#: debhelper.pod:644 msgid "" -"B<dh_strip> compresses debugging symbol files to reduce the installed size " -"of -dbg packages." +"This is entirely independent of the standard B<${shlibs:Depends}> generated " +"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " +"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " +"guesses don't match reality." msgstr "" -"B<dh_strip> comprime ficheros de sÃmbolos de depuración de fallos para " -"reducir el tamaño de los paquetes -dbg." +"Esto es totalmente independiente del campo estándar B<${shlibs:Depends}> " +"generado por L<dh_makeshlibs(1)>, y del B<${perl:Depends}> generada por " +"L<dh_perl(1)>. Puede preferir no utilizar ninguno de estos si la expansión " +"de debhelper de estas variables no es correcta." +# type: =head2 +#. type: =head2 +#: debhelper.pod:649 +msgid "Package build directories" +msgstr "Directorios de construcción del paquete" + +# type: textblock #. type: textblock #: debhelper.pod:651 msgid "" -"B<dh_auto_configure> does not include the source package name in --" -"libexecdir when using autoconf." +"By default, all debhelper programs assume that the temporary directory used " +"for assembling the tree of files in a package is debian/I<package>." msgstr "" -"B<dh_auto_configure> no incluye el nombre de paquete fuente en «--" -"libexecdir» al utilizar autoconf." - -#. type: textblock -#: debhelper.pod:656 -msgid "B<dh> does not default to enabling --with=python-support" -msgstr "B<dh> no activa «--with=python-support» de forma predeterminada." +"Por omisión, todos los programas de debhelper asumen que el directorio " +"temporal utilizado para ensamblar el árbol de ficheros en un paquete es " +"«debian/I<paquete>»." +# type: textblock #. type: textblock -#: debhelper.pod:658 +#: debhelper.pod:654 msgid "" -"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " -"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " -"regardless of compat level)" +"Sometimes, you might want to use some other temporary directory. This is " +"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/" +"tmp>\", will use B<debian/tmp> as the temporary directory. Note that if you " +"use B<-P>, the debhelper programs can only be acting on a single package at " +"a time. So if you have a package that builds many binary packages, you will " +"need to also use the B<-p> flag to specify which binary package the " +"debhelper program will act on." msgstr "" +"Algunas veces, puede que desee utilizar otro directorio temporal. Esto se " +"puede conseguir con la opción B<-P>. Por ejemplo, B<dh_installdocs -Pdebian/" +"tmp>, utilizará el directorio B<debian/tmp> como directorio temporal. Tenga " +"en cuenta que si utiliza la opción B<-P>, los programas de debhelper sólo " +"podrán actuar sobre un paquete a la vez. Por eso, si tiene un paquete que " +"construye muchos paquetes binarios, tendrá que hacer uso de la opción B<-p> " +"para especificar el paquete binario sobre el que debhelper actuará." +# type: =head2 +#. type: =head2 +#: debhelper.pod:662 +msgid "udebs" +msgstr "udebs" + +# type: textblock #. type: textblock #: debhelper.pod:664 msgid "" -"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " -"variables listed by B<dpkg-buildflags>, unless they are already set." +"Debhelper includes support for udebs. To create a udeb with debhelper, add " +"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " +"Debhelper will try to create udebs that comply with debian-installer policy, " +"by making the generated package files end in F<.udeb>, not installing any " +"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " +"and F<config> scripts, etc." msgstr "" -"Todos los programas de debhelper B<dh_auto_>I<*> definen variables de " -"entorno listados en B<dpkg-buildflags>, a menos que ya estén definidas." +"Debhelper incluye la compatibilidad con paquetes udeb. Para crear un udeb " +"con debhelper, añada B<Package-Type: udeb> al párrafo del paquete binario en " +"F<debian/control>. Debhelper tratará de crear udebs que cumplan con las " +"normas de debian-installer, haciendo que los ficheros de los paquetes " +"terminen en F<.udeb>, no instalando ninguna documentación en un udeb, y " +"omitiendo los scripts F<preinst>, F<postrm>, F<prerm>, scripts F<config>, " +"etc." + +# type: =head1 +#. type: =head1 +#: debhelper.pod:671 +msgid "ENVIRONMENT" +msgstr "ENTORNO" #. type: textblock -#: debhelper.pod:670 +#: debhelper.pod:673 msgid "" -"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " -"to perl F<Makefile.PL> and F<Build.PL>" +"This section describes some of the environment variables that influences the " +"behaviour of debhelper or which debhelper interacts with." msgstr "" -"B<dh_auto_configure> introduce B<dpkg-buildflags> CFLAGS, CPPFLAGS, y " -"LDFLAGS a ficheros de Perl F<Makefile.PL> y F<Build.PL>" #. type: textblock -#: debhelper.pod:675 +#: debhelper.pod:676 msgid "" -"B<dh_strip> puts separated debug symbols in a location based on their build-" -"id." +"It is important to note that these must be actual environment variables in " +"order to affect the behaviour of debhelper (not simply F<Makefile> " +"variables). To specify them properly in F<debian/rules>, be sure to " +"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." msgstr "" -"B<dh_strip> ubica sÃmbolos de depuración separados en una ubicación según su " -"build-id." + +# type: =item +#. type: =item +#: debhelper.pod:683 +msgid "B<DH_VERBOSE>" +msgstr "B<DH_VERBOSE>" #. type: textblock -#: debhelper.pod:680 +#: debhelper.pod:685 msgid "" -"Executable debhelper config files are run and their output used as the " -"configuration." +"Set to a non-empty value to enable verbose mode. Please see the B<-v> / B<--" +"verbose> option for details." msgstr "" -"Se utilizan como configuración los ficheros de configuración ejecutables de " -"debhelper y su salida." +# type: =item #. type: =item -#: debhelper.pod:687 -msgid "v10" -msgstr "v10" +#: debhelper.pod:688 +#, fuzzy +#| msgid "B<DH_COMPAT>" +msgid "B<DH_QUIET>" +msgstr "B<DH_COMPAT>" #. type: textblock -#: debhelper.pod:689 -msgid "Changes from v9 are:" -msgstr "Los cambios desde el nivel v9 son:" +#: debhelper.pod:690 +msgid "" +"Set to a non-empty value to enable quiet mode. Debhelper will not output " +"commands calling the upstream build system nor will dh print which " +"subcommands are called and depending on the upstream build system might make " +"that more quiet, too. This makes it easier to spot important messages but " +"makes the output quite useless as buildd log." +msgstr "" #. type: textblock -#: debhelper.pod:695 -msgid "" -"B<dh_installinit> will no longer install a file named debian/I<package> as " -"an init script." +#: debhelper.pod:696 +msgid "Ignored if DH_VERBOSE is also set or B<-v> / B<--verbose> is passed." msgstr "" +# type: =item +#. type: =item +#: debhelper.pod:698 +msgid "B<DH_COMPAT>" +msgstr "B<DH_COMPAT>" + +# type: textblock #. type: textblock #: debhelper.pod:700 +#, fuzzy +#| msgid "" +#| "Temporarily specifies what compatibility level debhelper should run at, " +#| "overriding any value in F<debian/compat>." msgid "" -"B<dh_installdocs> will error out if it detects links created with --link-doc " -"between packages of architecture \"all\" and non-\"all\" as it breaks " -"binNMUs." +"Temporarily specifies what compatibility level debhelper should run at, " +"overriding any value specified via Build-Depends on debhelper-compat or via " +"the F<debian/compat> file." msgstr "" +"Especifica temporalmente bajo qué nivel de compatibilidad debe actuar " +"debhelper, ignorando cualquier valor en F<debian/compat>." +# type: =item +#. type: =item +#: debhelper.pod:704 +msgid "B<DH_NO_ACT>" +msgstr "B<DH_NO_ACT>" + +# type: textblock #. type: textblock #: debhelper.pod:706 +msgid "Set to B<1> to enable no-act mode." +msgstr "Defina como B<1> para habilitar el modo no-act." + +# type: =item +#. type: =item +#: debhelper.pod:708 +msgid "B<DH_OPTIONS>" +msgstr "B<DH_OPTIONS>" + +#. type: textblock +#: debhelper.pod:710 msgid "" -"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." -"shlibs file. This is now done by B<dh_makeshlibs> instead." +"All debhelper tools will parse command line arguments listed in this " +"variable before any command option (as if they had been prepended to the " +"command line arguments). Unfortunately, some third-party provided tools may " +"not support this variable and will ignore these command line arguments." msgstr "" #. type: textblock -#: debhelper.pod:712 +#: debhelper.pod:715 msgid "" -"B<dh_installwm> refuses to create a broken package if no man page can be " -"found (required to register for the x-window-manager alternative)." +"When using L<dh(1)>, it can be passed options that will be passed on to each " +"debhelper command, which is generally better than using DH_OPTIONS." msgstr "" +"Al utilizar L<dh(1)>, puede aceptar opciones que se introducen a cada orden " +"de debhelper, lo que habitualmente es mejor que utilizar «DH_OPTIONS»." +# type: =item +#. type: =item +#: debhelper.pod:718 +msgid "B<DH_ALWAYS_EXCLUDE>" +msgstr "B<DH_ALWAYS_EXCLUDE>" + +# type: textblock #. type: textblock -#: debhelper.pod:717 +#: debhelper.pod:720 msgid "" -"Debhelper will default to B<--parallel> for all buildsystems that support " -"parallel building. This can be disabled by using either B<--no-parallel> or " -"passing B<--max-parallel> with a value of 1." +"If set, this adds the value the variable is set to to the B<-X> options of " +"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " +"B<rm -rf> anything that matches the value in your package build tree." msgstr "" +"Si se define, añade su valor a la opción B<-X> de todas las órdenes que " +"permiten dicha opción. Es más, B<dh_builddeb> ejecutará B<rm -rf> con todo " +"lo que coincida con el valor dentro del árbol de construcción del paquete." + +# type: textblock +#. type: textblock +#: debhelper.pod:724 +msgid "" +"This can be useful if you are doing a build from a CVS source tree, in which " +"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " +"sneaking into the package you build. Or, if a package has a source tarball " +"that (unwisely) includes CVS directories, you might want to export " +"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " +"your package is built." +msgstr "" +"Puede ser útil si está compilando desde un árbol de CVS, en cuyo caso " +"estableciendo B<DH_ALWAYS_EXCLUDE=CVS> evitará que los directorios CVS se " +"introduzcan en el paquete construido. O, si su paquete original " +"(imprudentemente) incluye directorios CVS, puede ser útil exportar " +"B<DH_ALWAYS_EXCLUDE=CVS> en F<debian/rules>, para que esto tenga efecto en " +"cualquier sitio donde se construya el paquete." +# type: textblock #. type: textblock -#: debhelper.pod:723 +#: debhelper.pod:731 msgid "" -"The B<dh> command will not accept any of the deprecated \"manual sequence " -"control\" parameters (B<--before>, B<--after>, etc.). Please use override " -"targets instead." +"Multiple things to exclude can be separated with colons, as in " +"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" msgstr "" +"Puede separar varias cosas a excluir mediante dos puntos, por ejemplo: " +"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" -#. type: textblock -#: debhelper.pod:727 -msgid "" -"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " -"any of these since debhelper/12.4." -msgstr "" +# type: =item +#. type: =item +#: debhelper.pod:734 +#, fuzzy +#| msgid "B<DH_OPTIONS>" +msgid "B<DH_EXTRA_ADDONS>" +msgstr "B<DH_OPTIONS>" #. type: textblock -#: debhelper.pod:732 +#: debhelper.pod:736 msgid "" -"The B<dh> command will no longer use log files to track which commands have " -"been run. The B<dh> command I<still> keeps track of whether it already ran " -"the \"build\" sequence and skip it if it did." +"If set, this adds the specified dh addons to be run in the appropriate " +"places in the sequence of commands. This is equivalent to specifying the " +"addon to run with the --with flag in the debian/rules file. Any --without " +"calls specifying an addon in this environment variable will not be run." msgstr "" #. type: textblock -#: debhelper.pod:736 -msgid "The main effects of this are:" +#: debhelper.pod:741 +msgid "" +"This is intended to be used by downstreams or specific local configurations " +"that require a debhelper addon to be run during multiple builds without " +"having to patch a large number of rules file. If at all possible, this " +"should be avoided in favor of a --with flag in the rules file." msgstr "" -#. type: textblock -#: debhelper.pod:742 -msgid "" -"With this, it is now easier to debug the I<install> or/and I<binary> " -"sequences because they can now trivially be re-run (without having to do a " -"full \"clean and rebuild\" cycle)" +#. type: =item +#: debhelper.pod:746 +msgid "B<DH_COLORS>, B<DPKG_COLORS>" msgstr "" #. type: textblock #: debhelper.pod:748 msgid "" -"The main caveat is that B<dh_*> now only keeps track of what happened in a " -"single override target. When all the calls to a given B<dh_cmd> command " -"happens in the same override target everything will work as before." +"These variables can be used to control whether debhelper commands should use " +"colors in their textual output. Can be set to \"always\", \"auto\" (the " +"default), or \"never\"." msgstr "" #. type: textblock -#: debhelper.pod:753 -msgid "Example of where it can go wrong:" -msgstr "" - -#. type: verbatim -#: debhelper.pod:755 -#, no-wrap +#: debhelper.pod:752 msgid "" -" override_dh_foo:\n" -" dh_foo -pmy-pkg\n" -"\n" +"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " +"debhelper uses it on the assumption that you want the same color setting for " +"dpkg and debhelper. In the off-hand chance you want different color setting " +"for debhelper, you can use B<DH_COLORS> instead or in addition to " +"B<DPKG_COLORS>." msgstr "" -#. type: verbatim +#. type: =item #: debhelper.pod:758 -#, no-wrap -msgid "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" +msgid "B<NO_COLOR>" msgstr "" #. type: textblock -#: debhelper.pod:762 +#: debhelper.pod:760 msgid "" -"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" -"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " -"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." +"If no explicit request for color has been given (e.g. B<DH_COLORS> and " +"B<DPKG_COLORS> are both unset), the presence of this environment variable " +"cause the default color setting to be \"never\"." msgstr "" #. type: textblock -#: debhelper.pod:771 +#: debhelper.pod:764 msgid "" -"The B<dh_installdeb> command now shell-escapes the lines in the " -"F<maintscript> config file. This was the original intent but it did not " -"work properly and packages have begun to rely on the incomplete shell " -"escaping (e.g. quoting file names)." +"The variable is defined according to L<https://no-color.org/>. In this " +"project, the environment variables (such as B<DH_COLORS>) are considered an " +"explicit request for color." msgstr "" -#. type: textblock -#: debhelper.pod:778 +#. type: =item +#: debhelper.pod:768 msgid "" -"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " -"For packages needing the previous behaviour, please use B<--no-restart-after-" -"upgrade>." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" msgstr "" #. type: textblock -#: debhelper.pod:784 +#: debhelper.pod:770 msgid "" -"The B<autoreconf> sequence is now enabled by default. Please pass B<--" -"without autoreconf> to B<dh> if this is not desirable for a given package" +"By default (in any non-deprecated compat level), debhelper will " +"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " +"unset. If you need to change the default flags, please use the features " +"from L<dpkg-buildflags(1)> to do this (e.g. " +"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" +"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." msgstr "" -#. type: textblock -#: debhelper.pod:790 -msgid "" -"The B<systemd> sequence is now enabled by default. Please pass B<--without " -"systemd> to B<dh> if this is not desirable for a given package." +#. type: =item +#: debhelper.pod:777 +msgid "B<HOME>, B<XDG_*>" msgstr "" #. type: textblock -#: debhelper.pod:796 +#: debhelper.pod:779 msgid "" -"B<Retroactively removed>: B<dh> no longer creates the package build " -"directory when skipping running debhelper commands. This will not affect " -"packages that only build with debhelper commands, but it may expose bugs in " -"commands not included in debhelper." +"In compat 13 and later, these environment variables are reset before " +"invoking the upstream build system via the B<dh_auto_*> helpers. The " +"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " +"(B<dh_auto_test> only) will be set to a writable directory. All remaining " +"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " +"cleared." msgstr "" #. type: textblock -#: debhelper.pod:801 +#: debhelper.pod:785 msgid "" -"This compatibility feature had a bug since its inception in " -"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " -"there has been no reports of issues caused by this bug in those ~5 years, " -"this item have been removed rather than fixed." +"The B<HOME> directory will be created as an empty directory but it will be " +"reused between calls to B<dh_auto_*>. Any content will persist until " +"explicitly deleted or B<dh_clean>." msgstr "" +# type: =item #. type: =item -#: debhelper.pod:808 +#: debhelper.pod:789 #, fuzzy -#| msgid "v1" -msgid "v11" -msgstr "v1" +#| msgid "B<DH_OPTIONS>" +msgid "B<DEB_BUILD_OPTIONS>" +msgstr "B<DH_OPTIONS>" -# type: textblock #. type: textblock -#: debhelper.pod:810 -#, fuzzy -#| msgid "This mode is deprecated." -msgid "This mode is discouraged." -msgstr "Este modo está obsoleto." +#: debhelper.pod:791 +msgid "" +"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " +"variable." +msgstr "" #. type: textblock -#: debhelper.pod:812 +#: debhelper.pod:794 msgid "" -"The compat 11 is discouraged for new packages as it suffers from feature " -"interaction between L<dh_installinit> and L<dh_installsystemd> causing " -"services to not run correctly in some cases. Please consider using " -"compatibility mode 10 or 12 instead. More details about the issue are " -"available in Debian#887904 and L<https://lists.debian.org/debian-" -"release/2019/04/msg01442.html>." +"Please note that this variable should I<not> be altered by package " +"maintainers inside F<debian/rules> to change the behaviour of debhelper. " +"Instead, where the package maintainer need these features, they should look " +"disabling the relevant feature directly (e.g. by overriding the concrete " +"tools)." msgstr "" -#. type: textblock -#: debhelper.pod:819 +# type: =item +#. type: =item +#: debhelper.pod:799 #, fuzzy -#| msgid "Changes from v3 are:" -msgid "Changes from v10 are:" -msgstr "Los cambios desde el nivel v3 son:" +#| msgid "B<DH_OPTIONS>" +msgid "B<DEB_BUILD_MAINT_OPTIONS>" +msgstr "B<DH_OPTIONS>" #. type: textblock -#: debhelper.pod:825 +#: debhelper.pod:801 msgid "" -"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " -"generates maintainer scripts for those files. Please use the new " -"B<dh_installsystemd> helper." +"This is a dpkg specific environment variable (see e.g. L<dpkg-" +"buildflags(1)>). The debhelper tool suite silently ignores it." msgstr "" #. type: textblock -#: debhelper.pod:831 +#: debhelper.pod:804 msgid "" -"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " -"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " -"sequence for B<dh> has also been removed. If you need to disable the " -"B<dh_installsystemd> helper tool, please use an empty override target." +"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " +"which make some people mistakenly assume that debhelper will also react to " +"this variable." msgstr "" -#. type: textblock -#: debhelper.pod:837 -msgid "" -"Please note that the B<dh_installsystemd> tool has a slightly different " -"behaviour in some cases (e.g. when using the B<--name> parameter)." +#. type: =head2 +#: debhelper.pod:810 +msgid "Supported flags in DEB_BUILD_OPTIONS" msgstr "" #. type: textblock -#: debhelper.pod:843 +#: debhelper.pod:812 msgid "" -"B<dh_installdirs> no longer creates debian/I<package> directories unless " -"explicitly requested (or it has to create a subdirectory in it)." +"The debhelper tool suite reacts to the following flags in " +"B<DEB_BUILD_OPTIONS>." msgstr "" -#. type: textblock -#: debhelper.pod:847 -msgid "The vast majority of all packages will be unaffected by this change." +#. type: =item +#: debhelper.pod:816 +msgid "B<dherroron=obsolete-compat-levels>" msgstr "" #. type: textblock -#: debhelper.pod:851 -msgid "" -"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" -"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " -"or B<cmake>) are unaffected by this change." +#: debhelper.pod:818 +msgid "I<This is a debhelper specific value.>" msgstr "" #. type: textblock -#: debhelper.pod:857 +#: debhelper.pod:820 msgid "" -"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" -"configure>." +"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " +"debhelper tools will promote deprecation warnings for usage of old soon to " +"be removed compat levels into errors." msgstr "" #. type: textblock -#: debhelper.pod:862 +#: debhelper.pod:824 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " -"L<cmake(1)>." +"This is useful for automated checking for code relying on deprecated compat " +"levels that is scheduled for removal." msgstr "" #. type: textblock -#: debhelper.pod:867 -msgid "" -"B<dh_installman> will now prefer detecting the language from the path name " -"rather than the extension." +#: debhelper.pod:827 +msgid "This option is intended for testing purposes; not production builds." +msgstr "" + +#. type: =item +#: debhelper.pod:829 +msgid "B<nostrip>" msgstr "" #. type: textblock -#: debhelper.pod:872 +#: debhelper.pod:831 debhelper.pod:854 debhelper.pod:868 msgid "" -"B<dh_auto_install> will now only create the destination directory it needs. " -"Previously, it would create the package build directory for all packages. " -"This will not affect packages that only build with debhelper commands, but " -"it may expose bugs in commands not included in debhelper." +"I<This value will change the content of the debs being built. The .deb " +"packages built when this is set is therefore not bit-for-bit reproducible " +"with a regular build in the general case.>" msgstr "" #. type: textblock -#: debhelper.pod:880 +#: debhelper.pod:835 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now error out if their config has a pattern that does not " -"match anything or reference a path that does not exist." +"This value will cause the official debhelper tools will skip actions and " +"helpers that either remove, detach or deduplicate debugging symbols in ELF " +"binaries." msgstr "" #. type: textblock -#: debhelper.pod:884 -msgid "" -"Known exceptions include building with the B<nodoc> profile, where the above " -"tools will silently permit failed matches where the patterns are used to " -"specify documentation." +#: debhelper.pod:839 +msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." +msgstr "" + +#. type: =item +#: debhelper.pod:841 +msgid "B<nocheck>" msgstr "" #. type: textblock -#: debhelper.pod:890 +#: debhelper.pod:843 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " -"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " -"B<dh_install>." +"This value will cause the official debhelper build systems to skip runs of " +"upstream test suites." msgstr "" #. type: textblock -#: debhelper.pod:895 +#: debhelper.pod:846 msgid "" -"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " -"incorrectly ignore B<--sourcedir>." +"Package maintainers looking to avoid running the upstream tests should " +"B<not> rely on this. Instead, they can add an empty override target to skip " +"B<dh_auto_test>." msgstr "" #. type: textblock -#: debhelper.pod:900 -msgid "" -"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)." +#: debhelper.pod:850 +msgid "This value affects L<dh_auto_test(1)>." +msgstr "" + +#. type: =item +#: debhelper.pod:852 +msgid "B<nodoc>" msgstr "" #. type: textblock -#: debhelper.pod:907 +#: debhelper.pod:858 msgid "" -"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " -"any of the B<dh_auto_*> tools. It was added as a temporary work around to " -"avoid a lot of packages failing to build at the same time." +"This value will cause several debhelper tools to skip installation of " +"documentation such as manpages or upstream provided documentation. " +"Additionally, the tools will also ignore if declared documentation is " +"\"missing\" on the assumption that the documentation has not been built." msgstr "" #. type: textblock -#: debhelper.pod:912 +#: debhelper.pod:863 msgid "" -"Note this item will eventually become obsolete as upstream intends to drop " -"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " -"drops support for it, then this variable will be removed retroactively from " -"existing compat levels as well." +"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " +"working with documentation." +msgstr "" + +#. type: =item +#: debhelper.pod:866 +msgid "B<notrimdch>" msgstr "" #. type: textblock -#: debhelper.pod:919 +#: debhelper.pod:872 msgid "" -"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " -"non-zero exit from analysing a given file." +"This value will cause L<dh_installchangelogs(1)> to act as if it had been " +"passed the B<--no-trim> option, forcing it to forgo removing older entries " +"from changelogs." msgstr "" +# type: =item +#. type: =item +#: debhelper.pod:876 +#, fuzzy +#| msgid "B<-i>, B<--indep>" +msgid "B<noautodbgsym>, B<noddebs>" +msgstr "B<-i>, B<--indep>" + #. type: textblock -#: debhelper.pod:924 +#: debhelper.pod:878 msgid "" -"The B<dh_installdocs> and B<dh_installexamples> tools may now install " -"I<most> of the documentation in a different path to comply with the " -"recommendation from Debian policy §12.3 (since version 3.9.7)." +"I<The official name is noautodbgsym. The noddebs variant is accepted for " +"historical reasons.>" msgstr "" #. type: textblock -#: debhelper.pod:928 +#: debhelper.pod:881 msgid "" -"Note that if a given source package only contains a single binary package in " -"F<debian/control> or none of the packages are I<-doc> packages, then this " -"change is not relevant for that source package and you can skip to the next " -"change." +"This value causes debhelper to skip the generation of automatically " +"generated debug symbol packages." msgstr "" #. type: textblock -#: debhelper.pod:933 -msgid "" -"By default, these tools will now attempt to determine a \"main package for " -"the documentation\" (called a I<doc-main-package> from here on) for every I<-" -"doc> package. If they find such a I<doc-main-package>, they will now " -"install the documentation into the path F<< /usr/share/doc/I<doc-main-" -"package> >> in the given doc package. I.e. the path can change but the " -"documentation is still shipped in the I<-doc> package." +#: debhelper.pod:884 +msgid "This value affects L<dh_strip(1)>." msgstr "" +# type: =item +#. type: =item +#: debhelper.pod:886 +#, fuzzy +#| msgid "B<--parallel>" +msgid "B<parallel=N>" +msgstr "B<--parallel>" + #. type: textblock -#: debhelper.pod:941 +#: debhelper.pod:888 msgid "" -"The B<--doc-main-package> option can be used when the auto-detection is " -"insufficient or to reset the path to its previous value if there is a reason " -"to diverge from Debian policy recommendation." +"This value enables debhelper to use up to B<N> threads or processes (subject " +"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " +"debhelper tools work with parallel tasks and may silently ignore the request." msgstr "" #. type: textblock -#: debhelper.pod:945 +#: debhelper.pod:893 msgid "" -"Some documentation will not be affected by this change. These exceptions " -"include the copyright file, changelog files, README.Debian, etc. These " -"files will still be installed in the path F<< /usr/share/doc/I<package> >>." +"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " +"will attempt to run the underlying upstream build system with that number of " +"threads." +msgstr "" + +#. type: =item +#: debhelper.pod:897 +msgid "B<terse>" msgstr "" #. type: textblock -#: debhelper.pod:952 +#: debhelper.pod:899 msgid "" -"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " -"to determine which files to process. Instead, they open the file and look " -"for an ELF header to determine if a given file is an shared object or an ELF " -"executable." +"This value will cause the official debhelper build systems to configure " +"upstream builds to be terse (i.e. reduce verbosity in their output). This " +"is subject to the upstream and the debhelper build system supporting such " +"features." msgstr "" #. type: textblock -#: debhelper.pod:957 -msgid "This change may cause the tools to process more files than previously." +#: debhelper.pod:904 +msgid "" +"This value affects most B<dh_auto_*> tools directly. For commands provided " +"by the debhelper package, it also causes the tools to act like the " +"B<DH_QUIET> environment variable was non-empty." msgstr "" -#. type: =item -#: debhelper.pod:961 -#, fuzzy -#| msgid "v10" -msgid "v12" -msgstr "v10" - #. type: textblock -#: debhelper.pod:963 -#, fuzzy -#| msgid "Changes from v3 are:" -msgid "Changes from v11 are:" -msgstr "Los cambios desde el nivel v3 son:" +#: debhelper.pod:910 +msgid "Unknown flags are silently ignored." +msgstr "" #. type: textblock -#: debhelper.pod:969 +#: debhelper.pod:912 msgid "" -"The B<dh_makeshlibs> tool now generates shlibs files with versioned " -"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " -"is now the default." +"Note third-party debhelper-like tools or third-party provided build systems " +"may or may not react to the above flags. This tends to depend on " +"implementation details of the tool." +msgstr "" + +# type: =head1 +#. type: =head1 +#: debhelper.pod:916 debhelper-compat-upgrade-checklist.pod:753 +#: debhelper-obsolete-compat.pod:178 dh:872 dh_auto_build:53 dh_auto_clean:55 +#: dh_auto_configure:58 dh_auto_install:103 dh_auto_test:64 dh_bugfiles:133 +#: dh_builddeb:176 dh_clean:189 dh_compress:243 dh_dwz:163 dh_fixperms:164 +#: dh_gencontrol:208 dh_icons:75 dh_install:377 dh_installcatalogs:128 +#: dh_installchangelogs:365 dh_installcron:80 dh_installdeb:419 +#: dh_installdebconf:233 dh_installdirs:131 dh_installdocs:437 +#: dh_installemacsen:138 dh_installexamples:182 dh_installifupdown:72 +#: dh_installinfo:123 dh_installinit:413 dh_installinitramfs:91 +#: dh_installlogcheck:81 dh_installlogrotate:53 dh_installman:420 +#: dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 +#: dh_installmodules:109 dh_installpam:71 dh_installppp:68 dh_installudev:102 +#: dh_installwm:130 dh_installxfonts:90 dh_link:166 dh_lintian:60 +#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 +#: dh_perl:188 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 +#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:280 dh_systemd_start:280 +msgid "SEE ALSO" +msgstr "VÉASE TAMBIÉN" + +#. type: =item +#: debhelper.pod:920 +msgid "L<debhelper-compat-upgrade-checklist(7)>" msgstr "" #. type: textblock -#: debhelper.pod:973 +#: debhelper.pod:922 msgid "" -"If an unversioned dependency in the shlibs file is wanted, this can be " -"obtained by passing B<-VNone> instead. However, please see " -"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." +"List of supported compat levels and an upgrade checklist for each of them." msgstr "" # type: =item +#. type: =item +#: debhelper.pod:924 +msgid "F</usr/share/doc/debhelper/examples/>" +msgstr "F</usr/share/doc/debhelper/examples/>" + +# type: textblock #. type: textblock -#: debhelper.pod:979 +#: debhelper.pod:926 +msgid "A set of example F<debian/rules> files that use debhelper." +msgstr "Varios ficheros de ejemplo F<debian/rules> que utilizan debhelper." + +# type: =item +#. type: =item +#: debhelper.pod:928 #, fuzzy -#| msgid "B<-s>, B<--same-arch>" -msgid "" -"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " -"instead." -msgstr "B<-s>, B<--same-arch>" +#| msgid "L<http://kitenet.net/~joey/code/debhelper/>" +msgid "L<http://joeyh.name/code/debhelper/>" +msgstr "L<http://kitenet.net/~joey/code/debhelper/>" +# type: textblock #. type: textblock -#: debhelper.pod:983 -msgid "" -"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." -msgstr "" +#: debhelper.pod:930 +msgid "Debhelper web site." +msgstr "Sitio web de Debhelper." + +# type: =head1 +#. type: =head1 +#: debhelper.pod:934 dh:878 dh_auto_build:59 dh_auto_clean:61 +#: dh_auto_configure:64 dh_auto_install:109 dh_auto_test:70 dh_bugfiles:141 +#: dh_builddeb:182 dh_clean:195 dh_compress:249 dh_dwz:169 dh_fixperms:170 +#: dh_gencontrol:214 dh_icons:81 dh_install:383 dh_installcatalogs:134 +#: dh_installchangelogs:371 dh_installcron:86 dh_installdeb:425 +#: dh_installdebconf:239 dh_installdirs:137 dh_installdocs:443 +#: dh_installemacsen:145 dh_installexamples:188 dh_installifupdown:78 +#: dh_installinfo:129 dh_installinitramfs:99 dh_installlogcheck:87 +#: dh_installlogrotate:59 dh_installman:426 dh_installmanpages:204 +#: dh_installmenu:96 dh_installmime:69 dh_installmodules:115 dh_installpam:77 +#: dh_installppp:74 dh_installudev:108 dh_installwm:136 dh_installxfonts:96 +#: dh_link:172 dh_lintian:68 dh_listpackages:40 dh_makeshlibs:462 +#: dh_md5sums:124 dh_movefiles:167 dh_perl:194 dh_prep:76 dh_shlibdeps:210 +#: dh_strip:441 dh_testdir:68 dh_testroot:99 dh_usrlocal:142 +msgid "AUTHOR" +msgstr "AUTOR" +# type: textblock #. type: textblock -#: debhelper.pod:988 -msgid "" -"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " -"removed. Please use the new name B<--no-stop-on-upgrade>" -msgstr "" +#: debhelper.pod:936 dh:880 dh_auto_build:61 dh_auto_clean:63 +#: dh_auto_configure:66 dh_auto_install:111 dh_auto_test:72 dh_builddeb:184 +#: dh_clean:197 dh_compress:251 dh_fixperms:172 dh_gencontrol:216 +#: dh_install:385 dh_installchangelogs:373 dh_installcron:88 dh_installdeb:427 +#: dh_installdebconf:241 dh_installdirs:139 dh_installdocs:445 +#: dh_installemacsen:147 dh_installexamples:190 dh_installifupdown:80 +#: dh_installinfo:131 dh_installinit:421 dh_installlogrotate:61 +#: dh_installman:428 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 +#: dh_installmodules:117 dh_installpam:79 dh_installppp:76 dh_installudev:110 +#: dh_installwm:138 dh_installxfonts:98 dh_link:174 dh_listpackages:42 +#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 +#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 +msgid "Joey Hess <joeyh@debian.org>" +msgstr "Joey Hess <joeyh@debian.org>" #. type: textblock -#: debhelper.pod:993 +#: debhelper-compat-upgrade-checklist.pod:5 msgid "" -"There was a bug in the B<doit> (and similar) functions from L<Debian::" -"Debhelper::Dh_Lib> that made them spawn a shell in one particular " -"circumstance. This bug is now removed and will cause helpers that rely on " -"the bug to fail with a \"command not found\"-error." +"debhelper-compat-upgrade-checklist - Upgrade checklist for supported " +"debhelper compat levels" msgstr "" #. type: textblock -#: debhelper.pod:1000 +#: debhelper-compat-upgrade-checklist.pod:9 msgid "" -"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " -"removed. Please use B<dh_missing> and its corresponding options, which can " -"also see the files installed by other helpers." +"This document is an upgrade checklist of all the supported debhelper compat " +"levels. It also lists all the support debhelper compat levels." msgstr "" #. type: textblock -#: debhelper.pod:1006 +#: debhelper-compat-upgrade-checklist.pod:12 msgid "" -"The B<dh_installinit> helper no longer installs configuration for the " -"upstart init system. Instead, it will abort the build if it finds an old " -"upstart configuration file. The error is there to remind the package " -"maintainer to ensure the proper removal of the conffiles shipped in previous " -"versions of the package (if any)." +"Information about how to declare the compat level is in L<debhelper(7)/" +"COMPATIBILITY LEVELS>." msgstr "" #. type: textblock -#: debhelper.pod:1014 +#: debhelper-compat-upgrade-checklist.pod:14 msgid "" -"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" -"maintscript-helper(1)> commands and will error out if the commands appear to " -"be invalid." +"If you are upgrading from a (now) obsolete compat level, then please refer " +"to L<debhelper-obsolete-compat(7)>." msgstr "" +# type: textblock +#. type: =head2 +#: debhelper-compat-upgrade-checklist.pod:19 +#, fuzzy +#| msgid "These are the available compatibility levels:" +msgid "Upgrade checklist for supported compatibility levels" +msgstr "Los niveles de compatibilidad disponibles son:" + +# type: textblock #. type: textblock -#: debhelper.pod:1020 -msgid "The B<dh_missing> tool will now default to B<--list-missing>." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:21 +msgid "These are the available compatibility levels:" +msgstr "Los niveles de compatibilidad disponibles son:" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:25 +#, fuzzy +#| msgid "v5" +msgid "v15" +msgstr "v5" #. type: textblock -#: debhelper.pod:1024 +#: debhelper-compat-upgrade-checklist.pod:27 +#: debhelper-compat-upgrade-checklist.pod:51 strings-kept-translations.pod:9 +#, fuzzy +#| msgid "" +#| "This compatibility level is still open for development; use with caution." msgid "" -"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" -"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." +"This compatibility level is still open for development; use with caution." msgstr "" +"Este nivel de compatibilidad aún está en desarrollo, utilÃcelo con " +"precaución." #. type: textblock -#: debhelper.pod:1029 -msgid "" -"The B<dh_compress> tool no longer compresses examples (i.e. anything " -"installed in F<</usr/share/doc/I<package>/examples>>.)" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:29 +#, fuzzy +#| msgid "Changes from v4 are:" +msgid "Changes from v14 are:" +msgstr "Los cambios desde el nivel v4 son:" + +# type: =item +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:33 +#: debhelper-compat-upgrade-checklist.pod:57 +#: debhelper-compat-upgrade-checklist.pod:63 +#: debhelper-compat-upgrade-checklist.pod:68 +#: debhelper-compat-upgrade-checklist.pod:74 +#: debhelper-compat-upgrade-checklist.pod:90 +#: debhelper-compat-upgrade-checklist.pod:95 +#: debhelper-compat-upgrade-checklist.pod:103 +#: debhelper-compat-upgrade-checklist.pod:120 +#: debhelper-compat-upgrade-checklist.pod:128 +#: debhelper-compat-upgrade-checklist.pod:136 +#: debhelper-compat-upgrade-checklist.pod:145 +#: debhelper-compat-upgrade-checklist.pod:151 +#: debhelper-compat-upgrade-checklist.pod:161 +#: debhelper-compat-upgrade-checklist.pod:169 +#: debhelper-compat-upgrade-checklist.pod:175 +#: debhelper-compat-upgrade-checklist.pod:189 +#: debhelper-compat-upgrade-checklist.pod:200 +#: debhelper-compat-upgrade-checklist.pod:214 +#: debhelper-compat-upgrade-checklist.pod:225 +#: debhelper-compat-upgrade-checklist.pod:241 +#: debhelper-compat-upgrade-checklist.pod:251 +#: debhelper-compat-upgrade-checklist.pod:255 +#: debhelper-compat-upgrade-checklist.pod:260 +#: debhelper-compat-upgrade-checklist.pod:265 +#: debhelper-compat-upgrade-checklist.pod:272 +#: debhelper-compat-upgrade-checklist.pod:278 +#: debhelper-compat-upgrade-checklist.pod:286 +#: debhelper-compat-upgrade-checklist.pod:292 +#: debhelper-compat-upgrade-checklist.pod:296 +#: debhelper-compat-upgrade-checklist.pod:301 +#: debhelper-compat-upgrade-checklist.pod:306 +#: debhelper-compat-upgrade-checklist.pod:315 +#: debhelper-compat-upgrade-checklist.pod:331 +#: debhelper-compat-upgrade-checklist.pod:340 +#: debhelper-compat-upgrade-checklist.pod:356 +#: debhelper-compat-upgrade-checklist.pod:364 +#: debhelper-compat-upgrade-checklist.pod:369 +#: debhelper-compat-upgrade-checklist.pod:391 +#: debhelper-compat-upgrade-checklist.pod:397 +#: debhelper-compat-upgrade-checklist.pod:409 +#: debhelper-compat-upgrade-checklist.pod:417 +#: debhelper-compat-upgrade-checklist.pod:423 +#: debhelper-compat-upgrade-checklist.pod:428 +#: debhelper-compat-upgrade-checklist.pod:433 +#: debhelper-compat-upgrade-checklist.pod:438 +#: debhelper-compat-upgrade-checklist.pod:446 +#: debhelper-compat-upgrade-checklist.pod:456 +#: debhelper-compat-upgrade-checklist.pod:466 +#: debhelper-compat-upgrade-checklist.pod:473 +#: debhelper-compat-upgrade-checklist.pod:485 +#: debhelper-compat-upgrade-checklist.pod:490 +#: debhelper-compat-upgrade-checklist.pod:518 +#: debhelper-compat-upgrade-checklist.pod:535 +#: debhelper-compat-upgrade-checklist.pod:540 +#: debhelper-compat-upgrade-checklist.pod:546 +#: debhelper-compat-upgrade-checklist.pod:552 +#: debhelper-compat-upgrade-checklist.pod:557 +#: debhelper-compat-upgrade-checklist.pod:563 +#: debhelper-compat-upgrade-checklist.pod:572 +#: debhelper-compat-upgrade-checklist.pod:582 +#: debhelper-compat-upgrade-checklist.pod:588 +#: debhelper-compat-upgrade-checklist.pod:611 +#: debhelper-compat-upgrade-checklist.pod:618 +#: debhelper-compat-upgrade-checklist.pod:624 +#: debhelper-compat-upgrade-checklist.pod:630 +#: debhelper-compat-upgrade-checklist.pod:636 +#: debhelper-compat-upgrade-checklist.pod:656 +#: debhelper-compat-upgrade-checklist.pod:661 +#: debhelper-compat-upgrade-checklist.pod:668 +#: debhelper-compat-upgrade-checklist.pod:673 +#: debhelper-compat-upgrade-checklist.pod:678 +#: debhelper-compat-upgrade-checklist.pod:686 +#: debhelper-compat-upgrade-checklist.pod:692 +#: debhelper-compat-upgrade-checklist.pod:697 +#: debhelper-compat-upgrade-checklist.pod:702 +#: debhelper-compat-upgrade-checklist.pod:717 +#: debhelper-compat-upgrade-checklist.pod:721 +#: debhelper-compat-upgrade-checklist.pod:729 +#: debhelper-compat-upgrade-checklist.pod:734 debhelper-obsolete-compat.pod:29 +#: debhelper-obsolete-compat.pod:36 debhelper-obsolete-compat.pod:40 +#: debhelper-obsolete-compat.pod:44 debhelper-obsolete-compat.pod:57 +#: debhelper-obsolete-compat.pod:62 debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:74 debhelper-obsolete-compat.pod:89 +#: debhelper-obsolete-compat.pod:93 debhelper-obsolete-compat.pod:98 +#: debhelper-obsolete-compat.pod:102 debhelper-obsolete-compat.pod:114 +#: debhelper-obsolete-compat.pod:119 debhelper-obsolete-compat.pod:124 +#: debhelper-obsolete-compat.pod:129 debhelper-obsolete-compat.pod:143 +#: debhelper-obsolete-compat.pod:148 debhelper-obsolete-compat.pod:152 +#: dh_testroot:36 dh_testroot:41 dh_testroot:46 +msgid "-" +msgstr "-" #. type: textblock -#: debhelper.pod:1034 +#: debhelper-compat-upgrade-checklist.pod:35 msgid "" -"The standard sequence in B<dh> now includes B<dh_dwz> and " -"B<dh_installinitramfs> by default. This makes the B<dwz> and " -"B<installinitramfs> sequences obsolete and they will now fail with an " -"error. If you want to skip these commands, then please insert an empty " -"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" +"The B<dh_auto_install> tool no longer defaults to B<< --destdir=debian/" +"I<package> >> for source packages only producing a single binary. If this " +"behaviour is wanted, the package should explicitly activate the B<single-" +"binary> dh addon (e.g., by adding B<dh-sequence-single-binary> to B<Build-" +"Depends>) or pass B<--destdir> to B<dh_auto_install>." msgstr "" #. type: textblock -#: debhelper.pod:1043 +#: debhelper-compat-upgrade-checklist.pod:41 +#: debhelper-compat-upgrade-checklist.pod:84 msgid "" -"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" -"libexecdir> variable and thus relies on the build system default - which " -"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." +"The rationale for this change to avoid \"surprises\" when adding a second " +"binary package later. Previously, debhelper would silently change behaviour " +"often resulting in empty binary packages being uploaded to the archive by " +"mistake. With the new behaviour, the B<single-binary> addon will detect the " +"mismatch and warn the maintainer of what is about to happen." msgstr "" +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:49 +#, fuzzy +#| msgid "v10" +msgid "v14" +msgstr "v10" + #. type: textblock -#: debhelper.pod:1048 -msgid "" -"If a particular upstream package does not use the correct default, the " -"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " -"via the following example:" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:53 +#, fuzzy +#| msgid "Changes from v5 are:" +msgid "Changes from v13 are:" +msgstr "Los cambios desde el nivel v5 son:" -#. type: verbatim -#: debhelper.pod:1052 -#, fuzzy, no-wrap -#| msgid "" -#| "\toverride_dh_auto_configure:\n" -#| "\t\tdh_auto_configure -- --with-foo --disable-bar\n" -#| "\n" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:59 msgid "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" +"The B<cmake> buildsystem now passes B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to " +"L<cmake(1)> to avoid some reproducibility issues." msgstr "" -"\toverride_dh_auto_configure:\n" -"\t\tdh_auto_configure -- --with-foo --disable-bar\n" -"\n" #. type: textblock -#: debhelper.pod:1055 -msgid "Note the B<--> before the B<--libexecdir> parameter." +#: debhelper-compat-upgrade-checklist.pod:65 +msgid "" +"The tool B<dh_installsysusers> is now included in the default sequence. This " +"helper tool will process systemd sysusers files." msgstr "" #. type: textblock -#: debhelper.pod:1059 +#: debhelper-compat-upgrade-checklist.pod:70 msgid "" -"The B<dh_installdeb> tool no longer installs the maintainer provided " -"F<conffiles> file. The file has mostly been obsolete since compatibility " -"level 3, where B<dh_installdeb> began to automatically compute the resulting " -"F<conffiles> control file." +"Use of the B<dh_gconf> command in override and hook targets now causes an " +"error. The B<dh_gconf> command has been a no-op for years and was removed " +"in debhelper 13.4." msgstr "" #. type: textblock -#: debhelper.pod:1066 +#: debhelper-compat-upgrade-checklist.pod:76 msgid "" -"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " -"handling systemd services that have a sysvinit alternative. Both tools must " -"now be used in such a case to ensure the service is properly started under " -"both sysvinit and systemd." +"The B<dh> sequencer will warn if the B<single-binary> addon is implicitly " +"activated to warn maintainers of the pending compat 15 change in " +"B<dh_auto_install>." msgstr "" #. type: textblock -#: debhelper.pod:1071 +#: debhelper-compat-upgrade-checklist.pod:79 msgid "" -"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" -"start>) then you will probably need one for B<dh_installsystemd> as well now." +"Maintainers are urged to either explicitly activate the B<single-binary> " +"addon to preserve the existing behaviour (e.g., by adding B<dh-sequence-" +"single-binary> to Build-Depends), or explicitly passing B<--destdir> to " +"B<dh_auto_install> if used and then passing B<--without single-binary> to " +"B<dh> (the latter to silence the warning)." msgstr "" #. type: textblock -#: debhelper.pod:1075 +#: debhelper-compat-upgrade-checklist.pod:92 msgid "" -"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " -"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists B<" -"${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to compat " -"12." +"The B<dh_installalternatives> tool will now be run after B<dh_link> rather " +"than after B<dh_installinitramfs> in the default B<dh> sequence." msgstr "" #. type: textblock -#: debhelper.pod:1082 +#: debhelper-compat-upgrade-checklist.pod:97 msgid "" -"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " -"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " -"packages and not only during the building process. Please set " -"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " -"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." +"The B<dh_installpam> tool will now install PAM configuration files under " +"F<< /usr/lib/pam.d/I<package> >> instead of F<< /etc/pam.d/I<package> >>." msgstr "" #. type: textblock -#: debhelper.pod:1090 +#: debhelper-compat-upgrade-checklist.pod:100 msgid "" -"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " -"default." +"Please consider using the \"rm_conffile\" feature from L<dh_installdeb(1)> " +"to ensure the proper removal of previous PAM files." msgstr "" #. type: textblock -#: debhelper.pod:1095 +#: debhelper-compat-upgrade-checklist.pod:105 msgid "" -"The B<python-distutils> buildsystem is now removed. Please use the third-" -"party build system B<pybuild> instead." +"The B<meson+ninja> and B<cmake> build systems now use B<meson install> and " +"B<cmake --install>, respectively, instead of B<ninja install> and B<make " +"install> in the L<dh_auto_install(1)> call. Any override of " +"B<dh_auto_install> that passes extra parameters to the upstream build system " +"should be reviewed." msgstr "" #. type: =item -#: debhelper.pod:1100 +#: debhelper-compat-upgrade-checklist.pod:112 #, fuzzy #| msgid "v10" msgid "v13" @@ -2264,19 +2605,19 @@ msgstr "v10" # type: textblock #. type: textblock -#: debhelper.pod:1102 +#: debhelper-compat-upgrade-checklist.pod:114 msgid "This is the recommended mode of operation." msgstr "Este es el modo de operación aconsejado." #. type: textblock -#: debhelper.pod:1104 +#: debhelper-compat-upgrade-checklist.pod:116 #, fuzzy #| msgid "Changes from v3 are:" msgid "Changes from v12 are:" msgstr "Los cambios desde el nivel v3 son:" #. type: textblock -#: debhelper.pod:1110 +#: debhelper-compat-upgrade-checklist.pod:122 msgid "" "The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " "test> when running the test suite. Any override of B<dh_auto_test> that " @@ -2285,7 +2626,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1118 +#: debhelper-compat-upgrade-checklist.pod:130 msgid "" "All debhelper like tools based on the official debhelper library (including " "B<dh> and the official B<dh_*> tools) no longer accepts abbreviated command " @@ -2294,7 +2635,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1126 +#: debhelper-compat-upgrade-checklist.pod:138 msgid "" "The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, B<dh_makeshlibs>, " "B<dh_shlibdeps>) are now only run for arch dependent packages by default (i." @@ -2304,7 +2645,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1135 +#: debhelper-compat-upgrade-checklist.pod:147 msgid "" "The third-party B<gradle> build system (from B<gradle-debian-helper> " "package) now runs the upstream-provided test suite automatically. To " @@ -2312,7 +2653,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1141 +#: debhelper-compat-upgrade-checklist.pod:153 msgid "" "The B<dh_installman> tool now aborts if it sees conflicting definitions of a " "manpage. This typically happens if the upstream build system is installing " @@ -2323,7 +2664,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1151 +#: debhelper-compat-upgrade-checklist.pod:163 msgid "" "The B<dh_auto_*> helpers now reset the environment variables B<HOME> and " "common B<XDG_*> variable. Please see description of the environment " @@ -2331,12 +2672,12 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1155 +#: debhelper-compat-upgrade-checklist.pod:167 msgid "I<This feature changed between debhelper 13 and debhelper 13.2.>" msgstr "" #. type: textblock -#: debhelper.pod:1159 +#: debhelper-compat-upgrade-checklist.pod:171 msgid "" "The B<dh> command will now error if an override or hook target for an " "obsolete command are present in F<debian/rules> (e.g. " @@ -2344,7 +2685,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1165 +#: debhelper-compat-upgrade-checklist.pod:177 msgid "" "The B<dh_missing> command will now default to B<--fail-missing>. This can " "be reverted to a non-fatal warning by explicitly passing B<--list-missing> " @@ -2352,7 +2693,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1169 +#: debhelper-compat-upgrade-checklist.pod:181 msgid "" "If you do not want the warning either, please omit the call to " "B<dh_missing>. If you use the B<dh> command sequencer, then you can do this " @@ -2361,7 +2702,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:1174 +#: debhelper-compat-upgrade-checklist.pod:186 #, no-wrap msgid "" " # Disable dh_missing\n" @@ -2370,7 +2711,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1179 +#: debhelper-compat-upgrade-checklist.pod:191 msgid "" "The B<dh> command sequencer now runs B<dh_installtmpfiles> in the default " "sequence. The B<dh_installtmpfiles> takes over handling of tmpfiles.d " @@ -2379,14 +2720,14 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1184 +#: debhelper-compat-upgrade-checklist.pod:196 msgid "" "Note that B<dh_installtmpfiles> responds to F<< debian/I<package>.tmpfiles " ">> where B<dh_installsystemd> used a name without the trailing \"s\"." msgstr "" #. type: textblock -#: debhelper.pod:1190 +#: debhelper-compat-upgrade-checklist.pod:202 msgid "" "Many B<dh_*> tools now support limited variable expansion via the B<${foo}> " "syntax. In many cases, this can be used to reference paths that contain " @@ -2397,7 +2738,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1197 +#: debhelper-compat-upgrade-checklist.pod:209 msgid "" "Please see L</Substitutions in debhelper config files> for syntax and " "available substitution variables. To B<dh_*> tool writers, substitution " @@ -2406,7 +2747,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1204 +#: debhelper-compat-upgrade-checklist.pod:216 msgid "" "The B<dh> command sequencer will now skip all hook and override targets for " "B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> lists " @@ -2414,7 +2755,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1208 +#: debhelper-compat-upgrade-checklist.pod:220 msgid "" "Any package relying on these targets to always be run should instead move " "relevant logic out of those targets. E.g. non-test related packaging code " @@ -2423,7 +2764,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1215 +#: debhelper-compat-upgrade-checklist.pod:227 msgid "" "The B<cmake> buildsystem now passes B<-" "DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> to L<cmake(1)> to speed up automatic " @@ -2432,7 +2773,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:1219 +#: debhelper-compat-upgrade-checklist.pod:231 #, no-wrap msgid "" " dh_auto_configure -- -DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ...\n" @@ -2440,997 +2781,866 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:1223 +#: debhelper-compat-upgrade-checklist.pod:235 #, fuzzy #| msgid "v10" -msgid "v14" +msgid "v12" msgstr "v10" #. type: textblock -#: debhelper.pod:1225 strings-kept-translations.pod:9 +#: debhelper-compat-upgrade-checklist.pod:237 #, fuzzy -#| msgid "" -#| "This compatibility level is still open for development; use with caution." +#| msgid "Changes from v3 are:" +msgid "Changes from v11 are:" +msgstr "Los cambios desde el nivel v3 son:" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:243 msgid "" -"This compatibility level is still open for development; use with caution." +"The B<dh_makeshlibs> tool now generates shlibs files with versioned " +"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " +"is now the default." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:247 +msgid "" +"If an unversioned dependency in the shlibs file is wanted, this can be " +"obtained by passing B<-VNone> instead. However, please see " +"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." msgstr "" -"Este nivel de compatibilidad aún está en desarrollo, utilÃcelo con " -"precaución." +# type: =item #. type: textblock -#: debhelper.pod:1227 +#: debhelper-compat-upgrade-checklist.pod:253 #, fuzzy -#| msgid "Changes from v5 are:" -msgid "Changes from v13 are:" -msgstr "Los cambios desde el nivel v5 son:" +#| msgid "B<-s>, B<--same-arch>" +msgid "" +"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " +"instead." +msgstr "B<-s>, B<--same-arch>" #. type: textblock -#: debhelper.pod:1233 +#: debhelper-compat-upgrade-checklist.pod:257 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> and B<-" -"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some " -"reproducibility issues." +"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." msgstr "" #. type: textblock -#: debhelper.pod:1237 +#: debhelper-compat-upgrade-checklist.pod:262 msgid "" -"This can cause issues with running binaries directly from the build " -"directories as they might now require a manually set B<LD_LIBRARY_PATH>. If " -"you need to override this change, we recommend that you try to pass the B<-" -"DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the problem " -"(leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). This should " -"undo the need for B<LD_LIBRARY_PATH> and avoid the reproducibility issues on " -"Linux, where B<$ORIGIN> is supported by the runtime linkers." +"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " +"removed. Please use the new name B<--no-stop-on-upgrade>" msgstr "" #. type: textblock -#: debhelper.pod:1247 -msgid "The tool B<dh_installsysusers> is now included in the default sequence." +#: debhelper-compat-upgrade-checklist.pod:267 +msgid "" +"There was a bug in the B<doit> (and similar) functions from L<Debian::" +"Debhelper::Dh_Lib> that made them spawn a shell in one particular " +"circumstance. This bug is now removed and will cause helpers that rely on " +"the bug to fail with a \"command not found\"-error." msgstr "" -# type: =head1 -#. type: =head1 -#: debhelper.pod:1253 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 -#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:92 -#: dh_installinit:205 dh_installinitramfs:60 dh_installman:131 -#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 -#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:104 -#: dh_systemd_start:68 -msgid "NOTES" -msgstr "NOTAS" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:274 +msgid "" +"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " +"removed. Please use B<dh_missing> and its corresponding options, which can " +"also see the files installed by other helpers." +msgstr "" -# type: =head2 -#. type: =head2 -#: debhelper.pod:1255 -msgid "Multiple binary package support" -msgstr "Compatibilidad con varios paquetes binarios" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:280 +msgid "" +"The B<dh_installinit> helper no longer installs configuration for the " +"upstart init system. Instead, it will abort the build if it finds an old " +"upstart configuration file. The error is there to remind the package " +"maintainer to ensure the proper removal of the conffiles shipped in previous " +"versions of the package (if any)." +msgstr "" -# type: textblock #. type: textblock -#: debhelper.pod:1257 +#: debhelper-compat-upgrade-checklist.pod:288 msgid "" -"If your source package generates more than one binary package, debhelper " -"programs will default to acting on all binary packages when run. If your " -"source package happens to generate one architecture dependent package, and " -"another architecture independent package, this is not the correct behavior, " -"because you need to generate the architecture dependent packages in the " -"binary-arch F<debian/rules> target, and the architecture independent " -"packages in the binary-indep F<debian/rules> target." +"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" +"maintscript-helper(1)> commands and will error out if the commands appear to " +"be invalid." msgstr "" -"Si su paquete fuente genera más de un paquete binario, los programas de " -"debhelper actuarán sobre todos los paquetes binarios de forma " -"predeterminada. Si se diera el caso de que su paquete fuente genera un " -"paquete dependiente de la arquitectura, y otro independiente, éste no serÃa " -"un comportamiento correcto porque necesitará generar los paquetes " -"dependientes de la arquitectura en el objetivo binary-arch de F<debian/" -"rules>, y los paquetes independientes de la arquitectura en el objetivo " -"binary-indep de F<debian/rules>." -# type: textblock #. type: textblock -#: debhelper.pod:1265 -#, fuzzy +#: debhelper-compat-upgrade-checklist.pod:294 +msgid "The B<dh_missing> tool will now default to B<--list-missing>." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:298 +msgid "" +"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" +"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:303 +msgid "" +"The B<dh_compress> tool no longer compresses examples (i.e. anything " +"installed in F<</usr/share/doc/I<package>/examples>>.)" +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:308 +msgid "" +"The standard sequence in B<dh> now includes B<dh_dwz> and " +"B<dh_installinitramfs> by default. This makes the B<dwz> and " +"B<installinitramfs> sequences obsolete and they will now fail with an " +"error. If you want to skip these commands, then please insert an empty " +"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:317 +msgid "" +"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" +"libexecdir> variable and thus relies on the build system default - which " +"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:322 +msgid "" +"If a particular upstream package does not use the correct default, the " +"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " +"via the following example:" +msgstr "" + +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:326 +#, fuzzy, no-wrap #| msgid "" -#| "To facilitate this, as well as give you more control over which packages " -#| "are acted on by debhelper programs, all debhelper programs accept the B<-" -#| "a>, B<-i>, B<-p>, and B<-s> parameters. These parameters are cumulative. " -#| "If none are given, debhelper programs default to acting on all packages " -#| "listed in the control file." +#| "\toverride_dh_auto_configure:\n" +#| "\t\tdh_auto_configure -- --with-foo --disable-bar\n" +#| "\n" msgid "" -"To facilitate this, as well as give you more control over which packages are " -"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" -"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " -"are given, debhelper programs default to acting on all packages listed in " -"the control file, with the exceptions below." +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" +"\n" +msgstr "" +"\toverride_dh_auto_configure:\n" +"\t\tdh_auto_configure -- --with-foo --disable-bar\n" +"\n" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:329 +msgid "Note the B<--> before the B<--libexecdir> parameter." msgstr "" -"Para facilitar esto, asà como para dar mayor control sobre qué paquetes " -"actúan los programas de debhelper, todos estos aceptan los parámetros B<-a>, " -"B<-i>, B<-p>, y B<-s>. Estos parámetros son acumulativos. Si no se " -"especifica ninguno, los programas de debhelper actúan por omisión en todos " -"los paquetes listados en el fichero de control." #. type: textblock -#: debhelper.pod:1271 +#: debhelper-compat-upgrade-checklist.pod:333 +msgid "B<Retroactively removed in debhelper/13.5>:" +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:335 msgid "" -"First, any package whose B<Architecture> field in B<debian/control> does not " -"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " -"section 5.6.8>)." +"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+." msgstr "" #. type: textblock -#: debhelper.pod:1275 +#: debhelper-compat-upgrade-checklist.pod:342 msgid "" -"Also, some additional packages may be excluded based on the contents of the " -"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " -"binary package stanzas in B<debian/control>, according to the draft policy " -"at L<https://wiki.debian.org/BuildProfileSpec>." +"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " +"handling systemd services that have a sysvinit alternative. Both tools must " +"now be used in such a case to ensure the service is properly started under " +"both sysvinit and systemd." msgstr "" -#. type: =head3 -#: debhelper.pod:1280 -msgid "Interaction between package selections and Build-Profiles" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:347 +msgid "" +"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" +"start>) then you will probably need one for B<dh_installsystemd> as well now." msgstr "" #. type: textblock -#: debhelper.pod:1282 +#: debhelper-compat-upgrade-checklist.pod:351 msgid "" -"Build-Profiles affect which packages are included in the package selections " -"mechanisms in debhelper. Generally, the package selections are described " -"from the assumption that all packages are enabled. This section describes " -"how the selections react when a package is disabled due to the active Build-" -"Profiles (or lack of active Build-Profiles)." +"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " +"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists " +"B<${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to " +"compat 12." msgstr "" -#. type: =item -#: debhelper.pod:1290 -msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:358 +msgid "" +"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " +"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " +"packages and not only during the building process. Please set " +"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " +"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." msgstr "" #. type: textblock -#: debhelper.pod:1292 +#: debhelper-compat-upgrade-checklist.pod:366 msgid "" -"The package disabled by Build-Profiles is silently excluded from the " -"selection." +"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " +"default." msgstr "" #. type: textblock -#: debhelper.pod:1295 +#: debhelper-compat-upgrade-checklist.pod:371 msgid "" -"Note you will receive a warning if I<all> packages related to these " -"selections are disabled. In that case, it generally does not make sense to " -"do the build in the first place." +"The B<python-distutils> buildsystem is now removed. Please use the third-" +"party build system B<pybuild> instead." msgstr "" -# type: =item #. type: =item -#: debhelper.pod:1299 +#: debhelper-compat-upgrade-checklist.pod:376 #, fuzzy -#| msgid "B<-N>I<package>, B<--no-package=>I<package>" -msgid "-N I<package> / --no-package I<package>" -msgstr "B<-N>I<paquete>, B<--no-package=>I<paquete>" +#| msgid "v1" +msgid "v11" +msgstr "v1" +# type: textblock #. type: textblock -#: debhelper.pod:1301 -msgid "The option is accepted and effectively does nothing." +#: debhelper-compat-upgrade-checklist.pod:378 +#, fuzzy +#| msgid "This mode is deprecated." +msgid "This mode is discouraged." +msgstr "Este modo está obsoleto." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:380 +msgid "" +"The compat 11 is discouraged for new packages as it suffers from feature " +"interaction between L<dh_installinit> and L<dh_installsystemd> causing " +"services to not run correctly in some cases. Please consider using " +"compatibility mode 10 or 12 instead. More details about the issue are " +"available in Debian#887904 and L<https://lists.debian.org/debian-" +"release/2019/04/msg01442.html>." msgstr "" -# type: =item -#. type: =item -#: debhelper.pod:1303 +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:387 #, fuzzy -#| msgid "B<-p>I<package>, B<--package=>I<package>" -msgid "-p I<package> / --package I<package>" -msgstr "B<-p>I<paquete>, B<--package=>I<paquete>" +#| msgid "Changes from v3 are:" +msgid "Changes from v10 are:" +msgstr "Los cambios desde el nivel v3 son:" #. type: textblock -#: debhelper.pod:1305 -msgid "The option is accepted, but debhelper will not act on the package." +#: debhelper-compat-upgrade-checklist.pod:393 +msgid "" +"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " +"generates maintainer scripts for those files. Please use the new " +"B<dh_installsystemd> helper." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:399 +msgid "" +"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " +"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " +"sequence for B<dh> has also been removed. If you need to disable the " +"B<dh_installsystemd> helper tool, please use an empty override target." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:405 +msgid "" +"Please note that the B<dh_installsystemd> tool has a slightly different " +"behaviour in some cases (e.g. when using the B<--name> parameter)." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:411 +msgid "" +"B<dh_installdirs> no longer creates debian/I<package> directories unless " +"explicitly requested (or it has to create a subdirectory in it)." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:415 +msgid "The vast majority of all packages will be unaffected by this change." msgstr "" #. type: textblock -#: debhelper.pod:1309 +#: debhelper-compat-upgrade-checklist.pod:419 msgid "" -"Note that it does not matter whether a package is enabled or disabled by " -"default." +"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" +"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " +"or B<cmake>) are unaffected by this change." msgstr "" -# type: =head2 -#. type: =head2 -#: debhelper.pod:1312 -msgid "Automatic generation of Debian install scripts" -msgstr "Generación automática de los scripts de instalación de Debian" - -# type: textblock #. type: textblock -#: debhelper.pod:1314 +#: debhelper-compat-upgrade-checklist.pod:425 msgid "" -"Some debhelper commands will automatically generate parts of Debian " -"maintainer scripts. If you want these automatically generated things " -"included in your existing Debian maintainer scripts, then you need to add " -"B<#DEBHELPER#> to your scripts, in the place the code should be added. " -"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " -"B<dh_installdeb>." +"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" +"configure>." msgstr "" -"Algunas órdenes de debhelper generarán automáticamente parte de los scripts " -"de instalación de Debian. Si quiere que estas órdenes generen " -"automáticamente lo que esté incluido en sus scripts de instalación de " -"Debian, necesitará añadir B<#DEBHELPER#> a sus scripts, en el lugar donde el " -"código se deba añadir. B<#DEBHELPER#> será remplazado por cualquier código " -"auto-generado cuando ejecute B<dh_installdeb>." -# type: textblock #. type: textblock -#: debhelper.pod:1321 +#: debhelper-compat-upgrade-checklist.pod:430 msgid "" -"If a script does not exist at all and debhelper needs to add something to " -"it, then debhelper will create the complete script." +"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " +"L<cmake(1)>." msgstr "" -"Si el script no existe y debhelper necesita añadir algo en particular, " -"creará el script por completo." -# type: textblock #. type: textblock -#: debhelper.pod:1324 +#: debhelper-compat-upgrade-checklist.pod:435 msgid "" -"All debhelper commands that automatically generate code in this way let it " -"be disabled by the -n parameter (see above)." +"B<dh_installman> will now prefer detecting the language from the path name " +"rather than the extension." msgstr "" -"Todas las órdenes de debhelper que generan código automáticamente de esta " -"manera se pueden deshabilitar con el parámetro «-n» (ver arriba)." -# type: textblock #. type: textblock -#: debhelper.pod:1327 +#: debhelper-compat-upgrade-checklist.pod:440 msgid "" -"Note that the inserted code will be shell code, so you cannot directly use " -"it in a Perl script. If you would like to embed it into a Perl script, here " -"is one way to do that (note that I made sure that $1, $2, etc are set with " -"the set command):" +"B<dh_auto_install> will now only create the destination directory it needs. " +"Previously, it would create the package build directory for all packages. " +"This will not affect packages that only build with debhelper commands, but " +"it may expose bugs in commands not included in debhelper." msgstr "" -"Observe que el código insertado sera código de consola, y por ello no puede " -"utilizarlo directamente en un script de Perl. Si desea introducirlo en un " -"script de Perl, hágalo de la siguiente forma (tenga en cuenta que en este " -"caso comprobé que $1, $2, etc se definen con la orden «set»):" -#. type: verbatim -#: debhelper.pod:1332 -#, no-wrap +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:448 msgid "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"The debhelper script failed with error code: ${exit_code}\");\n" -" } else {\n" -" die(\"The debhelper script was killed by signal: ${signal}\");\n" -" }\n" -" }\n" -"\n" +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now error out if their config has a pattern that does not " +"match anything or reference a path that does not exist." msgstr "" -# type: =head2 -#. type: =head2 -#: debhelper.pod:1345 -msgid "Automatic generation of miscellaneous dependencies." -msgstr "Generación automática de diversas dependencias." - #. type: textblock -#: debhelper.pod:1347 +#: debhelper-compat-upgrade-checklist.pod:452 msgid "" -"Some debhelper commands may make the generated package need to depend on " -"some other packages. For example, if you use L<dh_installdebconf(1)>, your " -"package will generally need to depend on debconf. Or if you use " -"L<dh_installxfonts(1)>, your package will generally need to depend on a " -"particular version of xutils. Keeping track of these miscellaneous " -"dependencies can be annoying since they are dependent on how debhelper does " -"things, so debhelper offers a way to automate it." +"Known exceptions include building with the B<nodoc> profile, where the above " +"tools will silently permit failed matches where the patterns are used to " +"specify documentation." msgstr "" -"Es posible que algunas órdenes de debhelper hagan que los paquetes generados " -"dependan de otros paquetes. Por ejemplo, si utiliza L<dh_installdebconf(1)>, " -"el paquete generado dependerá de debconf. Si utiliza L<dh_installxfonts(1)>, " -"el paquete dependerá de una determinada versión de xutils. Llevar la cuenta " -"de todas estas dependencias puede ser tedioso porque dependen de cómo " -"debhelper haga las cosas, y por ello debhelper ofrece una manera de " -"automatizarlo." -# type: textblock #. type: textblock -#: debhelper.pod:1355 +#: debhelper-compat-upgrade-checklist.pod:458 msgid "" -"All commands of this type, besides documenting what dependencies may be " -"needed on their man pages, will automatically generate a substvar called B<" -"${misc:Depends}>. If you put that token into your F<debian/control> file, it " -"will be expanded to the dependencies debhelper figures you need." +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " +"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " +"B<dh_install>." msgstr "" -"Todas las órdenes de este tipo, además de documentar qué dependencias pueden " -"ser necesarias en sus páginas de manual, generarán automáticamente una " -"variable de sustitución llamada B<${misc:Depends}>. Si introduce esta " -"variable en el fichero F<debian/control>, se expandirá a las dependencias " -"que debhelper crea oportunas." -# type: textblock #. type: textblock -#: debhelper.pod:1360 +#: debhelper-compat-upgrade-checklist.pod:463 msgid "" -"This is entirely independent of the standard B<${shlibs:Depends}> generated " -"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " -"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " -"guesses don't match reality." +"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " +"incorrectly ignore B<--sourcedir>." msgstr "" -"Esto es totalmente independiente del campo estándar B<${shlibs:Depends}> " -"generado por L<dh_makeshlibs(1)>, y del B<${perl:Depends}> generada por " -"L<dh_perl(1)>. Puede preferir no utilizar ninguno de estos si la expansión " -"de debhelper de estas variables no es correcta." - -# type: =head2 -#. type: =head2 -#: debhelper.pod:1365 -msgid "Package build directories" -msgstr "Directorios de construcción del paquete" -# type: textblock #. type: textblock -#: debhelper.pod:1367 +#: debhelper-compat-upgrade-checklist.pod:468 msgid "" -"By default, all debhelper programs assume that the temporary directory used " -"for assembling the tree of files in a package is debian/I<package>." +"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)." msgstr "" -"Por omisión, todos los programas de debhelper asumen que el directorio " -"temporal utilizado para ensamblar el árbol de ficheros en un paquete es " -"«debian/I<paquete>»." -# type: textblock #. type: textblock -#: debhelper.pod:1370 +#: debhelper-compat-upgrade-checklist.pod:475 msgid "" -"Sometimes, you might want to use some other temporary directory. This is " -"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/tmp>" -"\", will use B<debian/tmp> as the temporary directory. Note that if you use " -"B<-P>, the debhelper programs can only be acting on a single package at a " -"time. So if you have a package that builds many binary packages, you will " -"need to also use the B<-p> flag to specify which binary package the " -"debhelper program will act on." +"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " +"any of the B<dh_auto_*> tools. It was added as a temporary work around to " +"avoid a lot of packages failing to build at the same time." msgstr "" -"Algunas veces, puede que desee utilizar otro directorio temporal. Esto se " -"puede conseguir con la opción B<-P>. Por ejemplo, B<dh_installdocs -Pdebian/" -"tmp>, utilizará el directorio B<debian/tmp> como directorio temporal. Tenga " -"en cuenta que si utiliza la opción B<-P>, los programas de debhelper sólo " -"podrán actuar sobre un paquete a la vez. Por eso, si tiene un paquete que " -"construye muchos paquetes binarios, tendrá que hacer uso de la opción B<-p> " -"para especificar el paquete binario sobre el que debhelper actuará." -# type: =head2 -#. type: =head2 -#: debhelper.pod:1378 -msgid "udebs" -msgstr "udebs" - -# type: textblock #. type: textblock -#: debhelper.pod:1380 +#: debhelper-compat-upgrade-checklist.pod:480 msgid "" -"Debhelper includes support for udebs. To create a udeb with debhelper, add " -"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " -"Debhelper will try to create udebs that comply with debian-installer policy, " -"by making the generated package files end in F<.udeb>, not installing any " -"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " -"and F<config> scripts, etc." +"Note this item will eventually become obsolete as upstream intends to drop " +"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " +"drops support for it, then this variable will be removed retroactively from " +"existing compat levels as well." msgstr "" -"Debhelper incluye la compatibilidad con paquetes udeb. Para crear un udeb " -"con debhelper, añada B<Package-Type: udeb> al párrafo del paquete binario en " -"F<debian/control>. Debhelper tratará de crear udebs que cumplan con las " -"normas de debian-installer, haciendo que los ficheros de los paquetes " -"terminen en F<.udeb>, no instalando ninguna documentación en un udeb, y " -"omitiendo los scripts F<preinst>, F<postrm>, F<prerm>, scripts F<config>, " -"etc." - -# type: =head1 -#. type: =head1 -#: debhelper.pod:1387 -msgid "ENVIRONMENT" -msgstr "ENTORNO" #. type: textblock -#: debhelper.pod:1389 +#: debhelper-compat-upgrade-checklist.pod:487 msgid "" -"This section describes some of the environment variables that influences the " -"behaviour of debhelper or which debhelper interacts with." +"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " +"non-zero exit from analysing a given file." msgstr "" #. type: textblock -#: debhelper.pod:1392 +#: debhelper-compat-upgrade-checklist.pod:492 msgid "" -"It is important to note that these must be actual environment variables in " -"order to affect the behaviour of debhelper (not simply F<Makefile> " -"variables). To specify them properly in F<debian/rules>, be sure to " -"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." +"The B<dh_installdocs> and B<dh_installexamples> tools may now install " +"I<most> of the documentation in a different path to comply with the " +"recommendation from Debian policy §12.3 (since version 3.9.7)." msgstr "" -# type: =item -#. type: =item -#: debhelper.pod:1399 -msgid "B<DH_VERBOSE>" -msgstr "B<DH_VERBOSE>" - -# type: textblock #. type: textblock -#: debhelper.pod:1401 -#, fuzzy -#| msgid "" -#| "Set to B<1> to enable verbose mode. Debhelper will output every command " -#| "it runs that modifies files on the build system." +#: debhelper-compat-upgrade-checklist.pod:496 msgid "" -"Set to B<1> to enable verbose mode. Debhelper will output every command it " -"runs. Also enables verbose build logs for some build systems like autoconf." +"Note that if a given source package only contains a single binary package in " +"F<debian/control> or none of the packages are I<-doc> packages, then this " +"change is not relevant for that source package and you can skip to the next " +"change." msgstr "" -"Defina como B<1> para activar el modo explicativo. Debhelper mostrará todas " -"las órdenes utilizadas que modifiquen ficheros en el sistema en el que se " -"hace la construcción." - -# type: =item -#. type: =item -#: debhelper.pod:1404 -#, fuzzy -#| msgid "B<DH_COMPAT>" -msgid "B<DH_QUIET>" -msgstr "B<DH_COMPAT>" #. type: textblock -#: debhelper.pod:1406 +#: debhelper-compat-upgrade-checklist.pod:501 msgid "" -"Set to B<1> to enable quiet mode. Debhelper will not output commands calling " -"the upstream build system nor will dh print which subcommands are called and " -"depending on the upstream build system might make that more quiet, too. " -"This makes it easier to spot important messages but makes the output quite " -"useless as buildd log. Ignored if DH_VERBOSE is also set." +"By default, these tools will now attempt to determine a \"main package for " +"the documentation\" (called a I<doc-main-package> from here on) for every I<-" +"doc> package. If they find such a I<doc-main-package>, they will now " +"install the documentation into the path F<< /usr/share/doc/I<doc-main-" +"package> >> in the given doc package. I.e. the path can change but the " +"documentation is still shipped in the I<-doc> package." msgstr "" -# type: =item -#. type: =item -#: debhelper.pod:1413 -msgid "B<DH_COMPAT>" -msgstr "B<DH_COMPAT>" - -# type: textblock #. type: textblock -#: debhelper.pod:1415 -#, fuzzy -#| msgid "" -#| "Temporarily specifies what compatibility level debhelper should run at, " -#| "overriding any value in F<debian/compat>." +#: debhelper-compat-upgrade-checklist.pod:509 msgid "" -"Temporarily specifies what compatibility level debhelper should run at, " -"overriding any value specified via Build-Depends on debhelper-compat or via " -"the F<debian/compat> file." +"The B<--doc-main-package> option can be used when the auto-detection is " +"insufficient or to reset the path to its previous value if there is a reason " +"to diverge from Debian policy recommendation." msgstr "" -"Especifica temporalmente bajo qué nivel de compatibilidad debe actuar " -"debhelper, ignorando cualquier valor en F<debian/compat>." - -# type: =item -#. type: =item -#: debhelper.pod:1419 -msgid "B<DH_NO_ACT>" -msgstr "B<DH_NO_ACT>" - -# type: textblock -#. type: textblock -#: debhelper.pod:1421 -msgid "Set to B<1> to enable no-act mode." -msgstr "Defina como B<1> para habilitar el modo no-act." - -# type: =item -#. type: =item -#: debhelper.pod:1423 -msgid "B<DH_OPTIONS>" -msgstr "B<DH_OPTIONS>" #. type: textblock -#: debhelper.pod:1425 +#: debhelper-compat-upgrade-checklist.pod:513 msgid "" -"All debhelper tools will parse command line arguments listed in this " -"variable before any command option (as if they had been prepended to the " -"command line arguments). Unfortunately, some third-party provided tools may " -"not support this variable and will ignore these command line arguments." +"Some documentation will not be affected by this change. These exceptions " +"include the copyright file, changelog files, README.Debian, etc. These " +"files will still be installed in the path F<< /usr/share/doc/I<package> >>." msgstr "" #. type: textblock -#: debhelper.pod:1430 +#: debhelper-compat-upgrade-checklist.pod:520 msgid "" -"When using L<dh(1)>, it can be passed options that will be passed on to each " -"debhelper command, which is generally better than using DH_OPTIONS." +"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " +"to determine which files to process. Instead, they open the file and look " +"for an ELF header to determine if a given file is an shared object or an ELF " +"executable." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:525 +msgid "This change may cause the tools to process more files than previously." msgstr "" -"Al utilizar L<dh(1)>, puede aceptar opciones que se introducen a cada orden " -"de debhelper, lo que habitualmente es mejor que utilizar «DH_OPTIONS»." -# type: =item #. type: =item -#: debhelper.pod:1433 -msgid "B<DH_ALWAYS_EXCLUDE>" -msgstr "B<DH_ALWAYS_EXCLUDE>" +#: debhelper-compat-upgrade-checklist.pod:529 +msgid "v10" +msgstr "v10" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:531 +msgid "Changes from v9 are:" +msgstr "Los cambios desde el nivel v9 son:" -# type: textblock #. type: textblock -#: debhelper.pod:1435 +#: debhelper-compat-upgrade-checklist.pod:537 msgid "" -"If set, this adds the value the variable is set to to the B<-X> options of " -"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " -"B<rm -rf> anything that matches the value in your package build tree." +"B<dh_installinit> will no longer install a file named debian/I<package> as " +"an init script." msgstr "" -"Si se define, añade su valor a la opción B<-X> de todas las órdenes que " -"permiten dicha opción. Es más, B<dh_builddeb> ejecutará B<rm -rf> con todo " -"lo que coincida con el valor dentro del árbol de construcción del paquete." -# type: textblock #. type: textblock -#: debhelper.pod:1439 +#: debhelper-compat-upgrade-checklist.pod:542 msgid "" -"This can be useful if you are doing a build from a CVS source tree, in which " -"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " -"sneaking into the package you build. Or, if a package has a source tarball " -"that (unwisely) includes CVS directories, you might want to export " -"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " -"your package is built." +"B<dh_installdocs> will error out if it detects links created with --link-doc " +"between packages of architecture \"all\" and non-\"all\" as it breaks " +"binNMUs." msgstr "" -"Puede ser útil si está compilando desde un árbol de CVS, en cuyo caso " -"estableciendo B<DH_ALWAYS_EXCLUDE=CVS> evitará que los directorios CVS se " -"introduzcan en el paquete construido. O, si su paquete original " -"(imprudentemente) incluye directorios CVS, puede ser útil exportar " -"B<DH_ALWAYS_EXCLUDE=CVS> en F<debian/rules>, para que esto tenga efecto en " -"cualquier sitio donde se construya el paquete." -# type: textblock #. type: textblock -#: debhelper.pod:1446 +#: debhelper-compat-upgrade-checklist.pod:548 msgid "" -"Multiple things to exclude can be separated with colons, as in " -"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" +"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." +"shlibs file. This is now done by B<dh_makeshlibs> instead." msgstr "" -"Puede separar varias cosas a excluir mediante dos puntos, por ejemplo: " -"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" - -# type: =item -#. type: =item -#: debhelper.pod:1449 -#, fuzzy -#| msgid "B<DH_OPTIONS>" -msgid "B<DH_EXTRA_ADDONS>" -msgstr "B<DH_OPTIONS>" #. type: textblock -#: debhelper.pod:1451 +#: debhelper-compat-upgrade-checklist.pod:554 msgid "" -"If set, this adds the specified dh addons to be run in the appropriate " -"places in the sequence of commands. This is equivalent to specifying the " -"addon to run with the --with flag in the debian/rules file. Any --without " -"calls specifying an addon in this environment variable will not be run." +"B<dh_installwm> refuses to create a broken package if no man page can be " +"found (required to register for the x-window-manager alternative)." msgstr "" #. type: textblock -#: debhelper.pod:1456 +#: debhelper-compat-upgrade-checklist.pod:559 msgid "" -"This is intended to be used by downstreams or specific local configurations " -"that require a debhelper addon to be run during multiple builds without " -"having to patch a large number of rules file. If at all possible, this " -"should be avoided in favor of a --with flag in the rules file." +"Debhelper will default to B<--parallel> for all buildsystems that support " +"parallel building. This can be disabled by using either B<--no-parallel> or " +"passing B<--max-parallel> with a value of 1." msgstr "" -#. type: =item -#: debhelper.pod:1461 -msgid "B<DH_COLORS>, B<DPKG_COLORS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:565 +msgid "" +"The B<dh> command will not accept any of the deprecated \"manual sequence " +"control\" parameters (B<--before>, B<--after>, etc.). Please use override " +"targets instead." msgstr "" #. type: textblock -#: debhelper.pod:1463 +#: debhelper-compat-upgrade-checklist.pod:569 msgid "" -"These variables can be used to control whether debhelper commands should use " -"colors in their textual output. Can be set to \"always\", \"auto\" (the " -"default), or \"never\"." +"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " +"any of these since debhelper/12.4." msgstr "" #. type: textblock -#: debhelper.pod:1467 +#: debhelper-compat-upgrade-checklist.pod:574 msgid "" -"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " -"debhelper uses it on the assumption that you want the same color setting for " -"dpkg and debhelper. In the off-hand chance you want different color setting " -"for debhelper, you can use B<DH_COLORS> instead or in addition to " -"B<DPKG_COLORS>." +"The B<dh> command will no longer use log files to track which commands have " +"been run. The B<dh> command I<still> keeps track of whether it already ran " +"the \"build\" sequence and skip it if it did." msgstr "" -#. type: =item -#: debhelper.pod:1473 -msgid "B<NO_COLOR>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:578 +msgid "The main effects of this are:" msgstr "" #. type: textblock -#: debhelper.pod:1475 +#: debhelper-compat-upgrade-checklist.pod:584 msgid "" -"If no explicit request for color has been given (e.g. B<DH_COLORS> and " -"B<DPKG_COLORS> are both unset), the presence of this environment variable " -"cause the default color setting to be \"never\"." +"With this, it is now easier to debug the I<install> or/and I<binary> " +"sequences because they can now trivially be re-run (without having to do a " +"full \"clean and rebuild\" cycle)" msgstr "" #. type: textblock -#: debhelper.pod:1479 +#: debhelper-compat-upgrade-checklist.pod:590 msgid "" -"The variable is defined according to L<https://no-color.org/>. In this " -"project, the environment variables (such as B<DH_COLORS>) are considered an " -"explicit request for color." +"The main caveat is that B<dh_*> now only keeps track of what happened in a " +"single override target. When all the calls to a given B<dh_cmd> command " +"happens in the same override target everything will work as before." msgstr "" -#. type: =item -#: debhelper.pod:1483 -msgid "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:595 +msgid "Example of where it can go wrong:" msgstr "" -#. type: textblock -#: debhelper.pod:1485 +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:597 +#, no-wrap msgid "" -"By default (in any non-deprecated compat level), debhelper will " -"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " -"unset. If you need to change the default flags, please use the features " -"from L<dpkg-buildflags(1)> to do this (e.g. " -"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" -"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." +" override_dh_foo:\n" +" dh_foo -pmy-pkg\n" +"\n" msgstr "" -#. type: =item -#: debhelper.pod:1492 -msgid "B<HOME>, B<XDG_*>" +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:600 +#, no-wrap +msgid "" +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" msgstr "" #. type: textblock -#: debhelper.pod:1494 +#: debhelper-compat-upgrade-checklist.pod:604 msgid "" -"In compat 13 and later, these environment variables are reset before " -"invoking the upstream build system via the B<dh_auto_*> helpers. The " -"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " -"(B<dh_auto_test> only) will be set to a writable directory. All remaining " -"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " -"cleared." +"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" +"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " +"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." msgstr "" #. type: textblock -#: debhelper.pod:1500 +#: debhelper-compat-upgrade-checklist.pod:613 msgid "" -"The B<HOME> directory will be created as an empty directory but it will be " -"reused between calls to B<dh_auto_*>. Any content will persist until " -"explicitly deleted or B<dh_clean>." +"The B<dh_installdeb> command now shell-escapes the lines in the " +"F<maintscript> config file. This was the original intent but it did not " +"work properly and packages have begun to rely on the incomplete shell " +"escaping (e.g. quoting file names)." msgstr "" -# type: =item -#. type: =item -#: debhelper.pod:1504 -#, fuzzy -#| msgid "B<DH_OPTIONS>" -msgid "B<DEB_BUILD_OPTIONS>" -msgstr "B<DH_OPTIONS>" - #. type: textblock -#: debhelper.pod:1506 +#: debhelper-compat-upgrade-checklist.pod:620 msgid "" -"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " -"variable." +"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " +"For packages needing the previous behaviour, please use B<--no-restart-after-" +"upgrade>." msgstr "" #. type: textblock -#: debhelper.pod:1509 +#: debhelper-compat-upgrade-checklist.pod:626 msgid "" -"Please note that this variable should I<not> be altered by package " -"maintainers inside F<debian/rules> to change the behaviour of debhelper. " -"Instead, where the package maintainer need these features, they should look " -"disabling the relevant feature directly (e.g. by overriding the concrete " -"tools)." +"The B<autoreconf> sequence is now enabled by default. Please pass B<--" +"without autoreconf> to B<dh> if this is not desirable for a given package" msgstr "" -# type: =item -#. type: =item -#: debhelper.pod:1514 -#, fuzzy -#| msgid "B<DH_OPTIONS>" -msgid "B<DEB_MAINT_BUILD_OPTIONS>" -msgstr "B<DH_OPTIONS>" - #. type: textblock -#: debhelper.pod:1516 +#: debhelper-compat-upgrade-checklist.pod:632 msgid "" -"This is a dpkg specific environment variable (see e.g. L<dpkg-" -"buildflags(1)>). The debhelper tool suite silently ignores it." +"The B<systemd> sequence is now enabled by default. Please pass B<--without " +"systemd> to B<dh> if this is not desirable for a given package." msgstr "" #. type: textblock -#: debhelper.pod:1519 +#: debhelper-compat-upgrade-checklist.pod:638 msgid "" -"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " -"which make some people mistakenly assume that debhelper will also react to " -"this variable." -msgstr "" - -#. type: =head2 -#: debhelper.pod:1525 -msgid "Supported flags in DEB_BUILD_OPTIONS" +"B<Retroactively removed>: B<dh> no longer creates the package build " +"directory when skipping running debhelper commands. This will not affect " +"packages that only build with debhelper commands, but it may expose bugs in " +"commands not included in debhelper." msgstr "" #. type: textblock -#: debhelper.pod:1527 +#: debhelper-compat-upgrade-checklist.pod:643 msgid "" -"The debhelper tool suite reacts to the following flags in " -"B<DEB_BUILD_OPTIONS>." +"This compatibility feature had a bug since its inception in " +"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " +"there has been no reports of issues caused by this bug in those ~5 years, " +"this item have been removed rather than fixed." msgstr "" #. type: =item -#: debhelper.pod:1531 -msgid "B<dherroron=obsolete-compat-levels>" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:650 +msgid "v9" +msgstr "v9" #. type: textblock -#: debhelper.pod:1533 -msgid "I<This is a debhelper specific value.>" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:652 +msgid "Changes from v8 are:" +msgstr "Los cambios desde el nivel v8 son:" #. type: textblock -#: debhelper.pod:1535 +#: debhelper-compat-upgrade-checklist.pod:658 msgid "" -"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " -"debhelper tools will promote deprecation warnings for usage of old soon to " -"be removed compat levels into errors." +"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " +"directories to autoconf in --libdir and --libexecdir." msgstr "" +"Compatibilidad multiarquitectura, B<dh_auto_configure> introduce directorios " +"multiarquitectura a autoconf en «--libdir» y «--libexecdir»." #. type: textblock -#: debhelper.pod:1539 +#: debhelper-compat-upgrade-checklist.pod:663 msgid "" -"This is useful for automated checking for code relying on deprecated compat " -"levels that is scheduled for removal." +"dh is aware of the usual dependencies between targets in debian/rules. So, " +"\"dh binary\" will run any build, build-arch, build-indep, install, etc " +"targets that exist in the rules file. There's no need to define an explicit " +"binary target with explicit dependencies on the other targets." msgstr "" +"dh es consciente de las dependencias habituales entre objetivos en «debian/" +"rules». Por ello, «dh binary» ejecuta cualquier objetivo build, build-arch, " +"build-indep e install que se encuentre en el fichero «rules». No es " +"necesario definir un objetivo binario explÃcito con dependencias explÃcitas " +"sobre otros objetivos." #. type: textblock -#: debhelper.pod:1542 -msgid "This option is intended for testing purposes; not production builds." -msgstr "" - -#. type: =item -#: debhelper.pod:1544 -msgid "B<nostrip>" +#: debhelper-compat-upgrade-checklist.pod:670 +msgid "" +"B<dh_strip> compresses debugging symbol files to reduce the installed size " +"of -dbg packages." msgstr "" +"B<dh_strip> comprime ficheros de sÃmbolos de depuración de fallos para " +"reducir el tamaño de los paquetes -dbg." #. type: textblock -#: debhelper.pod:1546 debhelper.pod:1569 +#: debhelper-compat-upgrade-checklist.pod:675 msgid "" -"I<This value will change the content of the debs being built. The .deb " -"packages built when this is set is therefore not bit-for-bit reproducible " -"with a regular build in the general case.>" +"B<dh_auto_configure> does not include the source package name in --" +"libexecdir when using autoconf." msgstr "" +"B<dh_auto_configure> no incluye el nombre de paquete fuente en «--" +"libexecdir» al utilizar autoconf." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:680 +msgid "B<dh> does not default to enabling --with=python-support" +msgstr "B<dh> no activa «--with=python-support» de forma predeterminada." #. type: textblock -#: debhelper.pod:1550 +#: debhelper-compat-upgrade-checklist.pod:682 msgid "" -"This value will cause the official debhelper tools will skip actions and " -"helpers that either remove, detach or deduplicate debugging symbols in ELF " -"binaries." +"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " +"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " +"regardless of compat level)" msgstr "" #. type: textblock -#: debhelper.pod:1554 -msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:688 +msgid "" +"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " +"variables listed by B<dpkg-buildflags>, unless they are already set." msgstr "" +"Todos los programas de debhelper B<dh_auto_>I<*> definen variables de " +"entorno listados en B<dpkg-buildflags>, a menos que ya estén definidas." -#. type: =item -#: debhelper.pod:1556 -msgid "B<nocheck>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:694 +msgid "" +"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " +"to perl F<Makefile.PL> and F<Build.PL>" msgstr "" +"B<dh_auto_configure> introduce B<dpkg-buildflags> CFLAGS, CPPFLAGS, y " +"LDFLAGS a ficheros de Perl F<Makefile.PL> y F<Build.PL>" #. type: textblock -#: debhelper.pod:1558 +#: debhelper-compat-upgrade-checklist.pod:699 msgid "" -"This value will cause the official debhelper build systems to skip runs of " -"upstream test suites." +"B<dh_strip> puts separated debug symbols in a location based on their build-" +"id." msgstr "" +"B<dh_strip> ubica sÃmbolos de depuración separados en una ubicación según su " +"build-id." #. type: textblock -#: debhelper.pod:1561 +#: debhelper-compat-upgrade-checklist.pod:704 msgid "" -"Package maintainers looking to avoid running the upstream tests should " -"B<not> rely on this. Instead, they can add an empty override target to skip " -"B<dh_auto_test>." +"Executable debhelper config files are run and their output used as the " +"configuration." msgstr "" +"Se utilizan como configuración los ficheros de configuración ejecutables de " +"debhelper y su salida." +# type: textblock #. type: textblock -#: debhelper.pod:1565 -msgid "This value affects L<dh_auto_test(1)>." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:709 +#: debhelper-compat-upgrade-checklist.pod:740 +#: debhelper-compat-upgrade-checklist.pod:744 debhelper-obsolete-compat.pod:81 +#: debhelper-obsolete-compat.pod:135 debhelper-obsolete-compat.pod:158 +#: debhelper-obsolete-compat.pod:165 debhelper-obsolete-compat.pod:174 +msgid "This mode is deprecated." +msgstr "Este modo está obsoleto." #. type: =item -#: debhelper.pod:1567 -msgid "B<nodoc>" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:711 +msgid "v8" +msgstr "v8" #. type: textblock -#: debhelper.pod:1573 -msgid "" -"This value will cause several debhelper tools to skip installation of " -"documentation such as manpages or upstream provided documentation. " -"Additionally, the tools will also ignore if declared documentation is " -"\"missing\" on the assumption that the documentation has not been built." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:713 +msgid "Changes from v7 are:" +msgstr "Los cambios desde el nivel v7 son:" #. type: textblock -#: debhelper.pod:1578 +#: debhelper-compat-upgrade-checklist.pod:719 msgid "" -"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " -"working with documentation." +"Commands will fail rather than warning when they are passed unknown options." msgstr "" - -# type: =item -#. type: =item -#: debhelper.pod:1581 -#, fuzzy -#| msgid "B<-i>, B<--indep>" -msgid "B<noautodbgsym>, B<noddebs>" -msgstr "B<-i>, B<--indep>" +"Las órdenes fallarán, en lugar de emitir un aviso, cuando se les introduzcan " +"opciones desconocidas." #. type: textblock -#: debhelper.pod:1583 +#: debhelper-compat-upgrade-checklist.pod:723 msgid "" -"I<The official name is autodbgsym. The noddebs variant is accepted for " -"historical reasons.>" +"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " +"generates shlibs files for. So B<-X> can be used to exclude libraries. " +"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " +"processed before will be passed to it, a behavior change that can cause some " +"packages to fail to build." msgstr "" +"B<dh_makeshlibs> ejecutará B<dpkg-gensymbols> sobre todas las bibliotecas " +"compartidas para las que genera ficheros «shlibs». Por ello, puede utilizar " +"B<-X> para excluir bibliotecas. Asà mismo, se introducirán a B<dpkg-" +"gensymbols> bibliotecas en ubicaciones inusuales que antes no procesaba, un " +"cambio de comportamiento que puede impedir la construcción de algunos " +"paquetes." #. type: textblock -#: debhelper.pod:1586 +#: debhelper-compat-upgrade-checklist.pod:731 msgid "" -"This value causes debhelper to skip the generation of automatically " -"generated debug symbol packages." +"B<dh> requires the sequence to run be specified as the first parameter, and " +"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo " +"$@>\"." msgstr "" +"B<dh> requiere que la secuencia a ejecutar se defina como el primer " +"parámetro, y que las opciones aparezcan a continuación. Por ejemplo, use " +"B<dh $@ --foo>, no B<dh --foo $@>." #. type: textblock -#: debhelper.pod:1589 -msgid "This value affects L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:736 +msgid "" +"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " +"F<Makefile.PL>." msgstr "" +"B<dh_auto_>I<*> prefiere utilizar el módulo de Perl B<Module::Build> con " +"preferencia a un fichero F<Makefile.PL>." -# type: =item #. type: =item -#: debhelper.pod:1591 -#, fuzzy -#| msgid "B<--parallel>" -msgid "B<parallel=N>" -msgstr "B<--parallel>" +#: debhelper-compat-upgrade-checklist.pod:742 debhelper-obsolete-compat.pod:21 +msgid "v7" +msgstr "v7" +# type: textblock #. type: textblock -#: debhelper.pod:1593 -msgid "" -"This value enables debhelper to use up to B<N> threads or processes (subject " -"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " -"debhelper tools work with parallel tasks and may silently ignore the request." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:746 debhelper-obsolete-compat.pod:23 +#, fuzzy +#| msgid "These are the available compatibility levels:" +msgid "This is the lowest supported compatibility level." +msgstr "Los niveles de compatibilidad disponibles son:" #. type: textblock -#: debhelper.pod:1598 +#: debhelper-compat-upgrade-checklist.pod:748 msgid "" -"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " -"will attempt to run the underlying upstream build system with that number of " -"threads." +"If you are upgrading from an earlier compatibility level, please review " +"L<debhelper-obsolete-compat(7)>." msgstr "" +# type: textblock #. type: =item -#: debhelper.pod:1602 -msgid "B<terse>" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:757 +#, fuzzy +#| msgid "L<debhelper(7)>" +msgid "L<debhelper-obsolete-compat(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1604 +#: debhelper-compat-upgrade-checklist.pod:759 msgid "" -"This value will cause the official debhelper build systems to configure " -"upstream builds to be terse (i.e. reduce verbosity in their output). This " -"is subject to the upstream and the debhelper build system supporting such " -"features." -msgstr "" - -#. type: textblock -#: debhelper.pod:1609 -msgid "This value affects most B<dh_auto_*> tools." +"Upgrading from a (now) obsolete compatibility level? This document covers " +"the upgrade checklist up to the earliest supported level." msgstr "" +# type: textblock #. type: textblock -#: debhelper.pod:1613 -msgid "Unknown flags are silently ignored." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:762 debhelper-obsolete-compat.pod:180 +#: dh:874 dh_auto_build:55 dh_auto_clean:57 dh_auto_configure:60 +#: dh_auto_install:105 dh_auto_test:66 dh_builddeb:178 dh_clean:191 +#: dh_compress:245 dh_dwz:165 dh_fixperms:166 dh_gencontrol:210 dh_install:379 +#: dh_installcatalogs:130 dh_installchangelogs:367 dh_installcron:82 +#: dh_installdeb:421 dh_installdebconf:235 dh_installdirs:133 +#: dh_installdocs:439 dh_installexamples:184 dh_installifupdown:74 +#: dh_installinfo:125 dh_installlogcheck:83 dh_installlogrotate:55 +#: dh_installman:422 dh_installmanpages:200 dh_installmime:65 +#: dh_installmodules:111 dh_installpam:73 dh_installppp:70 dh_installudev:104 +#: dh_installwm:132 dh_installxfonts:92 dh_link:168 dh_listpackages:36 +#: dh_makeshlibs:458 dh_md5sums:120 dh_movefiles:163 dh_perl:190 dh_prep:72 +#: dh_strip:437 dh_testdir:64 dh_testroot:95 dh_usrlocal:138 +#: dh_systemd_start:282 +msgid "L<debhelper(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1615 +#: debhelper-compat-upgrade-checklist.pod:764 msgid "" -"Note third-party debhelper-like tools or third-party provided build systems " -"may or may not react to the above flags. This tends to depend on " -"implementation details of the tool." +"General information about the debhelper framework. This document also covers " +"how to declare your chosen debhelper compat level." msgstr "" # type: =head1 #. type: =head1 -#: debhelper.pod:1619 debhelper-obsolete-compat.pod:118 dh:733 dh_auto_build:53 -#: dh_auto_clean:55 dh_auto_configure:58 dh_auto_install:97 dh_auto_test:64 -#: dh_bugfiles:133 dh_builddeb:182 dh_clean:189 dh_compress:242 dh_dwz:161 -#: dh_fixperms:164 dh_gconf:105 dh_gencontrol:208 dh_icons:75 dh_install:377 -#: dh_installcatalogs:128 dh_installchangelogs:300 dh_installcron:78 -#: dh_installdeb:412 dh_installdebconf:128 dh_installdirs:131 -#: dh_installdocs:454 dh_installemacsen:138 dh_installexamples:178 -#: dh_installifupdown:72 dh_installinfo:123 dh_installinit:430 -#: dh_installinitramfs:91 dh_installlogcheck:81 dh_installlogrotate:53 -#: dh_installman:417 dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 -#: dh_installmodules:109 dh_installpam:62 dh_installppp:68 dh_installudev:102 -#: dh_installwm:132 dh_installxfonts:90 dh_link:166 dh_lintian:60 -#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 -#: dh_perl:174 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 -#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:281 dh_systemd_start:280 -msgid "SEE ALSO" -msgstr "VÉASE TAMBIÉN" - -# type: =item -#. type: =item -#: debhelper.pod:1623 -msgid "F</usr/share/doc/debhelper/examples/>" -msgstr "F</usr/share/doc/debhelper/examples/>" - -# type: textblock -#. type: textblock -#: debhelper.pod:1625 -msgid "A set of example F<debian/rules> files that use debhelper." -msgstr "Varios ficheros de ejemplo F<debian/rules> que utilizan debhelper." - -# type: =item -#. type: =item -#: debhelper.pod:1627 -#, fuzzy -#| msgid "L<http://kitenet.net/~joey/code/debhelper/>" -msgid "L<http://joeyh.name/code/debhelper/>" -msgstr "L<http://kitenet.net/~joey/code/debhelper/>" +#: debhelper-compat-upgrade-checklist.pod:769 debhelper-obsolete-compat.pod:182 +#: dh_installinit:419 dh_systemd_enable:284 dh_systemd_start:284 +msgid "AUTHORS" +msgstr "AUTORES" -# type: textblock #. type: textblock -#: debhelper.pod:1629 -msgid "Debhelper web site." -msgstr "Sitio web de Debhelper." - -# type: =head1 -#. type: =head1 -#: debhelper.pod:1633 dh:739 dh_auto_build:59 dh_auto_clean:61 -#: dh_auto_configure:64 dh_auto_install:103 dh_auto_test:70 dh_bugfiles:141 -#: dh_builddeb:188 dh_clean:195 dh_compress:248 dh_dwz:167 dh_fixperms:170 -#: dh_gconf:111 dh_gencontrol:214 dh_icons:81 dh_install:383 -#: dh_installcatalogs:134 dh_installchangelogs:306 dh_installcron:84 -#: dh_installdeb:418 dh_installdebconf:134 dh_installdirs:137 -#: dh_installdocs:460 dh_installemacsen:145 dh_installexamples:184 -#: dh_installifupdown:78 dh_installinfo:129 dh_installinitramfs:99 -#: dh_installlogcheck:87 dh_installlogrotate:59 dh_installman:423 -#: dh_installmanpages:204 dh_installmenu:96 dh_installmime:69 -#: dh_installmodules:115 dh_installpam:68 dh_installppp:74 dh_installudev:108 -#: dh_installwm:138 dh_installxfonts:96 dh_link:172 dh_lintian:68 -#: dh_listpackages:40 dh_makeshlibs:462 dh_md5sums:124 dh_movefiles:167 -#: dh_perl:180 dh_prep:76 dh_shlibdeps:210 dh_strip:441 dh_testdir:68 -#: dh_testroot:99 dh_usrlocal:142 -msgid "AUTHOR" -msgstr "AUTOR" +#: debhelper-compat-upgrade-checklist.pod:771 debhelper-obsolete-compat.pod:184 +#: dh_dwz:171 dh_installinitramfs:101 +msgid "Niels Thykier <niels@thykier.net>" +msgstr "" -# type: textblock #. type: textblock -#: debhelper.pod:1635 dh:741 dh_auto_build:61 dh_auto_clean:63 -#: dh_auto_configure:66 dh_auto_install:105 dh_auto_test:72 dh_builddeb:190 -#: dh_clean:197 dh_compress:250 dh_fixperms:172 dh_gencontrol:216 -#: dh_install:385 dh_installchangelogs:308 dh_installcron:86 dh_installdeb:420 -#: dh_installdebconf:136 dh_installdirs:139 dh_installdocs:462 -#: dh_installemacsen:147 dh_installexamples:186 dh_installifupdown:80 -#: dh_installinfo:131 dh_installinit:438 dh_installlogrotate:61 -#: dh_installman:425 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 -#: dh_installmodules:117 dh_installpam:70 dh_installppp:76 dh_installudev:110 -#: dh_installwm:140 dh_installxfonts:98 dh_link:174 dh_listpackages:42 -#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 -#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 -msgid "Joey Hess <joeyh@debian.org>" -msgstr "Joey Hess <joeyh@debian.org>" +#: debhelper-compat-upgrade-checklist.pod:773 debhelper-obsolete-compat.pod:186 +msgid "Joey Hess" +msgstr "" #. type: textblock #: debhelper-obsolete-compat.pod:3 @@ -3462,91 +3672,154 @@ msgid "" "The following is the list of now obsolete compat levels and their changes." msgstr "" -#. type: =item -#: debhelper-obsolete-compat.pod:21 -#, fuzzy -#| msgid "v10" -msgid "v1" -msgstr "v10" +#. type: textblock +#: debhelper-obsolete-compat.pod:25 +msgid "Changes from v6 are:" +msgstr "Los cambios desde el nivel v6 son:" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:23 +#: debhelper-obsolete-compat.pod:31 msgid "" -"This is the original debhelper compatibility level, and so it is the default " -"one. In this mode, debhelper will use F<debian/tmp> as the package tree " -"directory for the first binary package listed in the control file, while " -"using debian/I<package> for all other packages listed in the F<control> file." +"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " +"doesn't find them in the current directory (or wherever you tell it look " +"using B<--sourcedir>). This allows B<dh_install> to interoperate with " +"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " +"special parameters." msgstr "" -"Este es el nivel de compatibilidad original de debhelper, y por tanto es el " -"nivel predeterminado. En este modo, debhelper utiliza F<debian/tmp> como el " -"árbol de directorios del paquete, y «debian/I<paquete>» para el resto de " -"paquetes listados en el fichero F<control>." +"B<dh_install> buscará ficheros en F<debian/tmp> de forma predeterminada si " +"no los encuentra en el directorio actual (o dónde indicó hacerlo mediante " +"B<--sourcedir>). Esto permite la interoperabilidad entre B<dh_install> y " +"B<dh_auto_install>, que instala en F<debian/tmp>, sin necesidad de " +"parámetros especiales." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:38 +msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +msgstr "" +"B<dh_clean> leerá F<debian/clean> y eliminará los ficheros ahà listados." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:42 +msgid "B<dh_clean> will delete toplevel F<*-stamp> files." +msgstr "B<dh_clean> eliminará ficheros F<*-stamp> del nivel superior." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:46 +msgid "" +"B<dh_installchangelogs> will guess at what file is the upstream changelog if " +"none is specified." +msgstr "" +"B<dh_installchangelogs> intentará averiguar el fichero de registro de " +"cambios de la fuente original si no se especifica ninguno." #. type: =item -#: debhelper-obsolete-compat.pod:30 -msgid "v2" -msgstr "v2" +#: debhelper-obsolete-compat.pod:51 +msgid "v6" +msgstr "v6" + +#. type: textblock +#: debhelper-obsolete-compat.pod:53 +msgid "Changes from v5 are:" +msgstr "Los cambios desde el nivel v5 son:" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:32 +#: debhelper-obsolete-compat.pod:59 msgid "" -"In this mode, debhelper will consistently use debian/I<package> as the " -"package tree directory for every package that is built." +"Commands that generate maintainer script fragments will order the fragments " +"in reverse order for the F<prerm> and F<postrm> scripts." msgstr "" -"En este modo, debhelper utilizará «debian/I<paquete>» de forma consistente " -"como el árbol de directorios para cada paquete que se construya." +"Las órdenes que generan segmentos de scripts de desarrollador ordenarán " +"estos segmentos en orden inverso para los scripts F<prerm> y F<postrm>." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:64 +msgid "" +"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." +"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " +"directory." +msgstr "" +"B<dh_installwm> instalará un enlace esclavo a la página de manual F<x-window-" +"manager.1.gz> en caso de encontrar la página de manual en F<usr/share/man/" +"man1> dentro del directorio de construcción del paquete." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:70 +msgid "" +"B<dh_builddeb> did not previously delete everything matching " +"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " +"B<CVS:.svn:.git>. Now it does." +msgstr "" +"Anteriormente, B<dh_builddeb> no eliminaba todo aquello que coincidiese con " +"B<DH_ALWAYS_EXCLUDE>, si es que se definÃa con una lista de elementos a " +"excluir, como por ejemplo B<CVS:.svn:.git>. Ahora sà lo hace." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:76 +msgid "" +"B<dh_installman> allows overwriting existing man pages in the package build " +"directory. In previous compatibility levels it silently refuses to do this." +msgstr "" +"B<dh_installman> permite sobreescribir páginas de manual existentes en el " +"directorio de construcción del paquete. Bajo los niveles de compatibilidad " +"anteriores simplemente rechazaba hacerlo, de forma silenciosa." #. type: =item -#: debhelper-obsolete-compat.pod:37 -msgid "v3" -msgstr "v3" +#: debhelper-obsolete-compat.pod:83 +msgid "v5" +msgstr "v5" + +#. type: textblock +#: debhelper-obsolete-compat.pod:85 +msgid "Changes from v4 are:" +msgstr "Los cambios desde el nivel v4 son:" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:39 -msgid "This mode works like v2, with the following additions:" -msgstr "Este modo funciona como v2, con los siguientes añadidos:" +#: debhelper-obsolete-compat.pod:91 +msgid "Comments are ignored in debhelper config files." +msgstr "" +"Se ignoran los comentarios en los ficheros de configuración de debhelper." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:45 +#: debhelper-obsolete-compat.pod:95 msgid "" -"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " -"To turn this off and use those characters raw, just prefix with a backslash." +"B<dh_strip --dbg-package> now specifies the name of a package to put " +"debugging symbols in, not the packages to take the symbols from." msgstr "" -"Los ficheros de configuración de Debhelper aceptan comodines globales " -"mediante B<*> y B<?> cuando sea apropiado. Para utilizar «*» y «?» como " -"caracteres simplemente debe insertar como prefijo una barra invertida." +"B<dh_strip --dbg-package> ahora especifica el nombre del paquete en el que " +"se colocan los sÃmbolos de depuración, no los paquetes desde los que obtener " +"los sÃmbolos." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:50 -msgid "" -"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " -"B<ldconfig>." -msgstr "" -"B<dh_makeshlibs> hace que los scripts F<postinst> y F<postrm> ejecuten " -"ldconfig." +#: debhelper-obsolete-compat.pod:100 +msgid "B<dh_installdocs> skips installing empty files." +msgstr "B<dh_installdocs> omite la instalación de ficheros vacÃos." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:54 -msgid "" -"Every file in F<etc/> is automatically flagged as a conffile by " -"B<dh_installdeb>." +#: debhelper-obsolete-compat.pod:104 +msgid "B<dh_install> errors out if wildcards expand to nothing." msgstr "" -"B<dh_installdeb> marca automáticamente todos los ficheros en F<etc/> como " -"conffiles." +"B<dh_install> devuelve un error si los comodines se expanden a un valor " +"vacÃo." #. type: =item -#: debhelper-obsolete-compat.pod:60 +#: debhelper-obsolete-compat.pod:108 msgid "v4" msgstr "v4" #. type: textblock -#: debhelper-obsolete-compat.pod:62 +#: debhelper-obsolete-compat.pod:110 #, fuzzy #| msgid "Changes from v5 are:" msgid "Changes from v3 are:" @@ -3554,7 +3827,7 @@ msgstr "Los cambios desde el nivel v5 son:" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:116 msgid "" "B<dh_makeshlibs -V> will not include the Debian part of the version number " "in the generated dependency line in the shlibs file." @@ -3564,7 +3837,7 @@ msgstr "" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:73 +#: debhelper-obsolete-compat.pod:121 msgid "" "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> " "to supplement the B<${shlibs:Depends}> field." @@ -3574,7 +3847,7 @@ msgstr "" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:78 +#: debhelper-obsolete-compat.pod:126 msgid "" "B<dh_fixperms> will make all files in F<bin/> directories and in F<etc/init." "d> executable." @@ -3584,83 +3857,89 @@ msgstr "" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:83 +#: debhelper-obsolete-compat.pod:131 msgid "B<dh_link> will correct existing links to conform with policy." msgstr "" "B<dh_link> corregirá los enlaces existentes para ajustarse a las normas de " "Debian." -#. type: textblock -#: debhelper-obsolete-compat.pod:93 -msgid "Changes from v4 are:" -msgstr "Los cambios desde el nivel v4 son:" +#. type: =item +#: debhelper-obsolete-compat.pod:137 +msgid "v3" +msgstr "v3" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:99 -msgid "Comments are ignored in debhelper config files." -msgstr "" -"Se ignoran los comentarios en los ficheros de configuración de debhelper." +#: debhelper-obsolete-compat.pod:139 +msgid "This mode works like v2, with the following additions:" +msgstr "Este modo funciona como v2, con los siguientes añadidos:" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:103 +#: debhelper-obsolete-compat.pod:145 msgid "" -"B<dh_strip --dbg-package> now specifies the name of a package to put " -"debugging symbols in, not the packages to take the symbols from." +"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " +"To turn this off and use those characters raw, just prefix with a backslash." msgstr "" -"B<dh_strip --dbg-package> ahora especifica el nombre del paquete en el que " -"se colocan los sÃmbolos de depuración, no los paquetes desde los que obtener " -"los sÃmbolos." - -# type: textblock -#. type: textblock -#: debhelper-obsolete-compat.pod:108 -msgid "B<dh_installdocs> skips installing empty files." -msgstr "B<dh_installdocs> omite la instalación de ficheros vacÃos." +"Los ficheros de configuración de Debhelper aceptan comodines globales " +"mediante B<*> y B<?> cuando sea apropiado. Para utilizar «*» y «?» como " +"caracteres simplemente debe insertar como prefijo una barra invertida." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:112 -msgid "B<dh_install> errors out if wildcards expand to nothing." +#: debhelper-obsolete-compat.pod:150 +msgid "" +"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " +"B<ldconfig>." msgstr "" -"B<dh_install> devuelve un error si los comodines se expanden a un valor " -"vacÃo." +"B<dh_makeshlibs> hace que los scripts F<postinst> y F<postrm> ejecuten " +"ldconfig." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:120 dh:735 dh_auto_build:55 dh_auto_clean:57 -#: dh_auto_configure:60 dh_auto_install:99 dh_auto_test:66 dh_builddeb:184 -#: dh_clean:191 dh_compress:244 dh_dwz:163 dh_fixperms:166 dh_gconf:107 -#: dh_gencontrol:210 dh_install:379 dh_installcatalogs:130 -#: dh_installchangelogs:302 dh_installcron:80 dh_installdeb:414 -#: dh_installdebconf:130 dh_installdirs:133 dh_installdocs:456 -#: dh_installexamples:180 dh_installifupdown:74 dh_installinfo:125 -#: dh_installlogcheck:83 dh_installlogrotate:55 dh_installman:419 -#: dh_installmanpages:200 dh_installmime:65 dh_installmodules:111 -#: dh_installpam:64 dh_installppp:70 dh_installudev:104 dh_installwm:134 -#: dh_installxfonts:92 dh_link:168 dh_listpackages:36 dh_makeshlibs:458 -#: dh_md5sums:120 dh_movefiles:163 dh_perl:176 dh_prep:72 dh_strip:437 -#: dh_testdir:64 dh_testroot:95 dh_usrlocal:138 dh_systemd_start:282 -msgid "L<debhelper(7)>" -msgstr "L<debhelper(7)>" +#: debhelper-obsolete-compat.pod:154 +msgid "" +"Every file in F<etc/> is automatically flagged as a conffile by " +"B<dh_installdeb>." +msgstr "" +"B<dh_installdeb> marca automáticamente todos los ficheros en F<etc/> como " +"conffiles." -# type: =head1 -#. type: =head1 -#: debhelper-obsolete-compat.pod:122 dh_installinit:436 dh_systemd_enable:285 -#: dh_systemd_start:284 -msgid "AUTHORS" -msgstr "AUTORES" +#. type: =item +#: debhelper-obsolete-compat.pod:160 +msgid "v2" +msgstr "v2" +# type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:124 dh_dwz:169 dh_installinitramfs:101 -msgid "Niels Thykier <niels@thykier.net>" +#: debhelper-obsolete-compat.pod:162 +msgid "" +"In this mode, debhelper will consistently use debian/I<package> as the " +"package tree directory for every package that is built." msgstr "" +"En este modo, debhelper utilizará «debian/I<paquete>» de forma consistente " +"como el árbol de directorios para cada paquete que se construya." + +#. type: =item +#: debhelper-obsolete-compat.pod:167 +#, fuzzy +#| msgid "v10" +msgid "v1" +msgstr "v10" +# type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:126 -msgid "Joey Hess" +#: debhelper-obsolete-compat.pod:169 +msgid "" +"This is the original debhelper compatibility level, and so it is the default " +"one. In this mode, debhelper will use F<debian/tmp> as the package tree " +"directory for the first binary package listed in the control file, while " +"using debian/I<package> for all other packages listed in the F<control> file." msgstr "" +"Este es el nivel de compatibilidad original de debhelper, y por tanto es el " +"nivel predeterminado. En este modo, debhelper utiliza F<debian/tmp> como el " +"árbol de directorios del paquete, y «debian/I<paquete>» para el resto de " +"paquetes listados en el fichero F<control>." #. type: textblock #: dh:5 @@ -3790,7 +4069,7 @@ msgid "" "The override and hook targets can also be defined to run only when building " "architecture dependent or architecture independent packages. Use targets " "with names like B<override_>I<dh_command>B<-arch> and " -"B<execute_after>I<dh_command>B<-indep>." +"B<execute_after_>I<dh_command>B<-indep>." msgstr "" "Los objetivos «override» también se pueden definir para que se ejecuten solo " "al consuitr paquetes dependientes o independientes de la arquitectura. " @@ -3815,17 +4094,18 @@ msgstr "" #: dh:75 msgid "" "As a special optimization, B<dh> will skip a target if it is completely " -"empty. This is mostly useful for override targets, where the command will " -"simply be skipped without the overhead of invoking a dummy target." +"empty and does not depend on any other target. This is mostly useful for " +"override targets, where the command will simply be skipped without the " +"overhead of invoking a dummy target." msgstr "" #. type: textblock -#: dh:79 +#: dh:80 msgid "Note that the target has to be completely empty for this to work:" msgstr "" #. type: verbatim -#: dh:81 +#: dh:82 #, no-wrap msgid "" " # Skip dh_bar - the good and optimized way\n" @@ -3835,7 +4115,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:86 +#: dh:87 #, no-wrap msgid "" " # Skip dh_foo - the slow way\n" @@ -3846,19 +4126,84 @@ msgid "" msgstr "" #. type: =head2 -#: dh:91 +#: dh:92 msgid "Verifying targets are picked up by dh" msgstr "" #. type: textblock -#: dh:93 +#: dh:94 +msgid "" +"As of debhelper 13.10, you can use L<dh_assistant(1)> to see which override " +"and hook targets will be seen by B<dh>. Here is an example run of " +"L<dh_assistant(1)> along with its output:" +msgstr "" + +#. type: verbatim +#: dh:98 +#, no-wrap +msgid "" +" $ dh_assistant detect-hook-targets\n" +" {\n" +" \"commands-not-in-path\": [\n" +" \"dh_foo\"\n" +" ],\n" +" \"hook-targets\": [\n" +" {\n" +" \"command\": \"dh_strip_nondeterminism\",\n" +" \"is-empty\": true,\n" +" \"package-section-param\": null,\n" +" \"target-name\": \"override_dh_strip_nondeterminism\"\n" +" },\n" +" {\n" +" \"command\": \"dh_foo\",\n" +" \"is-empty\": false,\n" +" \"package-section-param\": \"-a\",\n" +" \"target-name\": \"override_dh_foo-arch\"\n" +" }\n" +" ]\n" +" }\n" +"\n" +msgstr "" + +#. type: textblock +#: dh:119 +msgid "" +"The B<commands-not-in-path> is useful for spotting mistakes in the hook " +"target names. A non-empty value implies one of more hook targets are " +"related to a command that is either not installed or no command with that " +"name exists at all. It is generally worth double checking these." +msgstr "" + +#. type: textblock +#: dh:124 +msgid "" +"Additionally, the B<is-empty> attribute for each hook target can be used for " +"seeing whether a hook target triggers the L</Completely empty targets> " +"optimization." +msgstr "" + +#. type: textblock +#: dh:127 +msgid "" +"If you are interested in the other attributes, please read the " +"L<dh_assistant(1)> for the details." +msgstr "" + +#. type: =head3 +#: dh:130 +msgid "" +"Verifying targets are picked up by dh (when debhelper is older than 13.10)" +msgstr "" + +#. type: textblock +#: dh:134 msgid "" -"If you want to confirm that B<dh> has seen an override or a hook target, you " +"On older versions of debhelper, you have to use B<dh> with B<--no-act>. You " "can use the following command as an example:" msgstr "" #. type: verbatim -#: dh:96 +#: dh:137 #, no-wrap msgid "" " $ dh binary --no-act | grep dh_install | head -n5\n" @@ -3871,7 +4216,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:103 +#: dh:144 msgid "" "The B<debian/rules execute_after_dh_install> in the output, which signals " "that B<dh> registered a B<execute_after_dh_install> target and would run it " @@ -3879,7 +4224,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:107 +#: dh:148 msgid "" "Note that L</Completely empty targets> will be omitted in the listing " "above. This makes it a bit harder to spot as you are looking for the " @@ -3887,12 +4232,12 @@ msgid "" msgstr "" #. type: =head2 -#: dh:111 +#: dh:152 msgid "Caveats with hook targets and makefile conditionals" msgstr "" #. type: textblock -#: dh:113 +#: dh:154 msgid "" "If you choose to wrap a hook target in makefile conditionals, please be " "aware that B<dh> computes all the hook targets a head of time and caches the " @@ -3902,7 +4247,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:119 +#: dh:160 msgid "" "The parsing and caching I<often> happens before B<dh> knows whether it will " "build arch:any (-a) or/and arch:all (-i) packages, which can produce " @@ -3911,7 +4256,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:124 +#: dh:165 msgid "" "Most of the problems can be avoided by making the hook target unconditional " "and then have the \"body\" be partially or completely conditional. As an " @@ -3919,7 +4264,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:128 +#: dh:169 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. The hook target\n" @@ -3939,7 +4284,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:142 +#: dh:183 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -3959,7 +4304,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:157 +#: dh:198 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -3979,14 +4324,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:171 +#: dh:212 msgid "" "These recipes are also relevant for conditional dependency targets, which " "are often seen in a variant of the following example:" msgstr "" #. type: verbatim -#: dh:174 +#: dh:215 #, no-wrap msgid "" " COND_TASKS =\n" @@ -3998,7 +4343,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:180 +#: dh:221 #, no-wrap msgid "" " maybe-run-this:\n" @@ -4007,7 +4352,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:183 +#: dh:224 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. Either the\n" @@ -4023,7 +4368,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:194 +#: dh:235 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -4040,7 +4385,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:205 +#: dh:246 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -4053,7 +4398,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:213 +#: dh:254 msgid "" "When in doubt, pick the relevant B<SIMPLE> case in the examples above that " "match your need." @@ -4061,29 +4406,29 @@ msgstr "" # type: =head1 #. type: =head1 -#: dh:216 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 -#: dh_auto_install:46 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 -#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gconf:42 dh_gencontrol:38 -#: dh_icons:33 dh_install:69 dh_installcatalogs:56 dh_installchangelogs:71 -#: dh_installcron:43 dh_installdeb:100 dh_installdebconf:64 dh_installdirs:45 -#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:44 -#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:78 +#: dh:257 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 +#: dh_auto_install:52 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 +#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gencontrol:38 dh_icons:33 +#: dh_install:69 dh_installcatalogs:56 dh_installchangelogs:77 +#: dh_installcron:45 dh_installdeb:107 dh_installdebconf:64 dh_installdirs:45 +#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:48 +#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:77 #: dh_installinitramfs:43 dh_installlogcheck:45 dh_installlogrotate:25 #: dh_installman:86 dh_installmanpages:43 dh_installmenu:44 -#: dh_installmodules:41 dh_installpam:34 dh_installppp:38 dh_installudev:34 +#: dh_installmodules:41 dh_installpam:38 dh_installppp:38 dh_installudev:34 #: dh_installwm:41 dh_link:69 dh_makeshlibs:67 dh_md5sums:31 dh_movefiles:41 -#: dh_perl:34 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 -#: dh_usrlocal:50 dh_systemd_enable:83 dh_systemd_start:33 +#: dh_perl:35 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 +#: dh_usrlocal:50 dh_systemd_enable:82 dh_systemd_start:33 msgid "OPTIONS" msgstr "OPCIONES" #. type: =item -#: dh:220 +#: dh:261 msgid "B<--with> I<addon>[B<,>I<addon> ...]" msgstr "B<--with> I<extensión>[B<,>I<extensión>,...]" #. type: textblock -#: dh:222 +#: dh:263 msgid "" "Add the debhelper commands specified by the given addon to appropriate " "places in the sequence of commands that is run. This option can be repeated " @@ -4100,7 +4445,7 @@ msgstr "" "de secuencia consulte el fichero F<PROGRAMMING>." #. type: textblock -#: dh:229 +#: dh:270 msgid "" "A B<Build-Depends> relation on the package B<dh-sequence->I<addon> implies a " "B<--with> I<addon>. This avoids the need for an explicit B<--with> in " @@ -4112,7 +4457,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:238 +#: dh:279 msgid "" "Since debhelper 12.5, addons can also be activated in B<indep>-only mode " "(via B<Build-Depends-Indep>) or B<arch>-only mode (via B<Build-Depends-" @@ -4121,7 +4466,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:244 +#: dh:285 msgid "" "Please note that addons activated via B<Build-Depends-Indep> or B<Build-" "Depends-Arch> are subject to additional limitations to ensure the result is " @@ -4133,12 +4478,12 @@ msgstr "" # type: =item #. type: =item -#: dh:252 +#: dh:293 msgid "B<--without> I<addon>" msgstr "B<--without> I<extensión>" #. type: textblock -#: dh:254 +#: dh:295 msgid "" "The inverse of B<--with>, disables using the given addon. This option can be " "repeated more than once, or multiple addons to disable can be listed, " @@ -4149,19 +4494,19 @@ msgstr "" "extensiones que desactivar." #. type: textblock -#: dh:260 +#: dh:301 msgid "List all available addons." msgstr "Lista todas las extensiones disponibles." #. type: textblock -#: dh:262 +#: dh:303 msgid "" "When called only with this option, B<dh> can be called from any directory (i." "e. it does not need access to files from a source package)." msgstr "" #. type: textblock -#: dh:268 +#: dh:309 msgid "" "Prints commands that would run for a given sequence, but does not run them." msgstr "" @@ -4169,14 +4514,14 @@ msgstr "" "ejecuta." #. type: textblock -#: dh:270 +#: dh:311 msgid "" "Note that dh normally skips running commands that it knows will do nothing. " "With --no-act, the full list of commands in a sequence is printed." msgstr "" #. type: textblock -#: dh:275 +#: dh:316 msgid "" "Other options passed to B<dh> are passed on to each command it runs. This " "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for " @@ -4188,13 +4533,13 @@ msgstr "" # type: =head1 #. type: =head1 -#: dh:279 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 +#: dh:320 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 #: dh_makeshlibs:185 dh_shlibdeps:78 msgid "EXAMPLES" msgstr "EJEMPLOS" #. type: textblock -#: dh:281 +#: dh:322 msgid "" "To see what commands are included in a sequence, without actually doing " "anything:" @@ -4203,7 +4548,7 @@ msgstr "" "realidad:" #. type: verbatim -#: dh:284 +#: dh:325 #, no-wrap msgid "" "\tdh binary-arch --no-act\n" @@ -4213,7 +4558,7 @@ msgstr "" "\n" #. type: textblock -#: dh:286 +#: dh:327 msgid "" "This is a very simple rules file, for packages where the default sequences " "of commands work with no additional options." @@ -4222,7 +4567,7 @@ msgstr "" "predeterminadas de órdenes funcionan sin opciones adicionales." #. type: verbatim -#: dh:289 dh:296 dh:310 dh:323 dh:334 dh:392 dh:403 +#: dh:330 dh:337 dh:351 dh:364 dh:375 dh:433 dh:444 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4236,7 +4581,7 @@ msgstr "" "\n" #. type: textblock -#: dh:293 +#: dh:334 msgid "" "Often you'll want to pass an option to a specific debhelper command. The " "easy way to do with is by adding an override target for that command." @@ -4246,7 +4591,7 @@ msgstr "" "para esa orden." #. type: verbatim -#: dh:300 +#: dh:341 #, fuzzy, no-wrap #| msgid "" #| "\toverride_dh_strip:\n" @@ -4262,7 +4607,7 @@ msgstr "" "\t\n" #. type: verbatim -#: dh:303 +#: dh:344 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4274,7 +4619,7 @@ msgstr "" "\n" #. type: textblock -#: dh:306 +#: dh:347 msgid "" "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> " "can't guess what to do for a strange package. Here's how to avoid running " @@ -4286,7 +4631,7 @@ msgstr "" "ejecutar sus propias órdenes." #. type: verbatim -#: dh:314 +#: dh:355 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4298,7 +4643,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:317 +#: dh:358 #, no-wrap msgid "" "\toverride_dh_auto_build:\n" @@ -4310,7 +4655,7 @@ msgstr "" "\n" #. type: textblock -#: dh:320 +#: dh:361 msgid "" "Another common case is wanting to do something manually before or after a " "particular debhelper command is run." @@ -4319,7 +4664,7 @@ msgstr "" "se ejecute una orden en particular de debhelper." #. type: verbatim -#: dh:327 +#: dh:368 #, fuzzy, no-wrap #| msgid "" #| "\toverride_dh_fixperms:\n" @@ -4338,14 +4683,14 @@ msgstr "" "\n" #. type: textblock -#: dh:331 +#: dh:372 msgid "" "If you are on an older debhelper or compatibility level, the above example " "would have to be written as." msgstr "" #. type: verbatim -#: dh:338 +#: dh:379 #, fuzzy, no-wrap #| msgid "" #| "\toverride_dh_fixperms:\n" @@ -4365,7 +4710,7 @@ msgstr "" "\n" #. type: textblock -#: dh:343 +#: dh:384 #, fuzzy #| msgid "" #| "Python tools are not run by dh by default, due to the continual change in " @@ -4381,7 +4726,7 @@ msgstr "" "B<dh_python2>." #. type: verbatim -#: dh:346 +#: dh:387 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4395,7 +4740,7 @@ msgstr "" "\n" #. type: textblock -#: dh:350 +#: dh:391 msgid "" "Here is how to force use of Perl's B<Module::Build> build system, which can " "be necessary if debhelper wrongly detects that the package uses MakeMaker." @@ -4405,7 +4750,7 @@ msgstr "" "detecta erróneamente que el paquete utiliza MakeMaker." #. type: verbatim -#: dh:354 +#: dh:395 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4419,7 +4764,7 @@ msgstr "" "\n" #. type: textblock -#: dh:358 +#: dh:399 msgid "" "Here is an example of overriding where the B<dh_auto_>I<*> commands find the " "package's source, for a package where the source is located in a " @@ -4430,7 +4775,7 @@ msgstr "" "en el que las fuentes se ubican en un subdirectorio." #. type: verbatim -#: dh:362 +#: dh:403 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4444,7 +4789,7 @@ msgstr "" "\n" #. type: textblock -#: dh:366 +#: dh:407 msgid "" "And here is an example of how to tell the B<dh_auto_>I<*> commands to build " "in a subdirectory, which will be removed on B<clean>." @@ -4454,7 +4799,7 @@ msgstr "" "B<clean>." #. type: verbatim -#: dh:369 +#: dh:410 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4468,7 +4813,7 @@ msgstr "" "\n" #. type: textblock -#: dh:373 +#: dh:414 #, fuzzy #| msgid "" #| "If your package can be built in parallel, you can support parallel " @@ -4482,7 +4827,7 @@ msgstr "" "j> funcionará." #. type: verbatim -#: dh:376 +#: dh:417 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4496,14 +4841,14 @@ msgstr "" "\n" #. type: textblock -#: dh:380 +#: dh:421 msgid "" "If your package cannot be built reliably while using multiple threads, " "please pass B<--no-parallel> to dh (or the relevant B<dh_auto_>I<*> command):" msgstr "" #. type: verbatim -#: dh:385 +#: dh:426 #, fuzzy, no-wrap #| msgid "" #| "\t#!/usr/bin/make -f\n" @@ -4522,7 +4867,7 @@ msgstr "" "\n" #. type: textblock -#: dh:389 +#: dh:430 msgid "" "Here is a way to prevent B<dh> from running several commands that you don't " "want it to run, by defining empty override targets for each command." @@ -4532,7 +4877,7 @@ msgstr "" "cada orden." #. type: verbatim -#: dh:396 +#: dh:437 #, no-wrap msgid "" "\t# Commands not to run:\n" @@ -4544,7 +4889,7 @@ msgstr "" "\n" #. type: textblock -#: dh:399 +#: dh:440 msgid "" "A long build process for a separate documentation package can be separated " "out using architecture independent overrides. These will be skipped when " @@ -4555,7 +4900,7 @@ msgstr "" "omiten al ejecutar las secuencias build-arch y binary-arch." #. type: verbatim -#: dh:407 +#: dh:448 #, no-wrap msgid "" "\toverride_dh_auto_build-indep:\n" @@ -4567,7 +4912,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:410 +#: dh:451 #, no-wrap msgid "" "\t# No tests needed for docs\n" @@ -4579,54 +4924,205 @@ msgstr "" "\n" #. type: verbatim -#: dh:413 +#: dh:454 #, no-wrap msgid "" "\toverride_dh_auto_install-indep:\n" "\t\t$(MAKE) -C docs install\n" "\n" msgstr "" -"\toverride_dh_auto_install-indep:\n" -"\t\t$(MAKE) -C docs install\n" -"\n" +"\toverride_dh_auto_install-indep:\n" +"\t\t$(MAKE) -C docs install\n" +"\n" + +#. type: textblock +#: dh:457 +msgid "" +"Adding to the example above, suppose you need to chmod a file, but only when " +"building the architecture dependent package, as it's not present when " +"building only documentation." +msgstr "" +"Continuando con el ejemplo anterior, suponga que necesita ejecutar «chmod» " +"sobre un fichero, pero solo al construir el paquete dependiente de la " +"arquitectura, ya que no está presente cuando solo se construye documentación." + +#. type: verbatim +#: dh:461 +#, fuzzy, no-wrap +#| msgid "" +#| "\toverride_dh_fixperms:\n" +#| "\t\tdh_fixperms\n" +#| "\t\tchmod 4755 debian/foo/usr/bin/foo\n" +#| "\n" +msgid "" +"\t# Example assumes debhelper/12.8 and compat 10+\n" +"\texecute_after_dh_fixperms-arch:\n" +"\t\tchmod 4755 debian/foo/usr/bin/foo\n" +"\n" +msgstr "" +"\toverride_dh_fixperms:\n" +"\t\tdh_fixperms\n" +"\t\tchmod 4755 debian/foo/usr/bin/foo\n" +"\n" + +# type: =head1 +#. type: =head1 +#: dh:465 +#, fuzzy +#| msgid "DEBHELPER COMMANDS" +msgid "DEBHELPER PROVIDED DH ADDONS" +msgstr "ÓRDENES DE DEBHELPER" + +#. type: textblock +#: dh:467 +msgid "" +"The primary purpose of B<dh> addons is to provide easy integration with " +"third-party provided features for debhelper. However, debhelper itself also " +"provide a few sequences that can be useful in some cases. These are " +"documented in this list:" +msgstr "" + +#. type: =item +#: dh:474 +msgid "build-stamp" +msgstr "" + +#. type: textblock +#: dh:476 +msgid "" +"A special addon for controlling whether B<dh> (in compat 10 or later) will " +"create stamp files to tell whether the build target has been run " +"successfully. See L</INTERNALS> for more details." +msgstr "" + +#. type: textblock +#: dh:480 +msgid "" +"This addon is active by default but can disabled by using B<dh $@ --without " +"build-stamp>" +msgstr "" + +#. type: =item +#: dh:483 +msgid "dwz (obsolete)" +msgstr "" + +#. type: textblock +#: dh:485 +msgid "" +"Adds L<dh_dwz(1)> to the sequence in compat level 11 or below. Obsolete in " +"compat 12 or later." +msgstr "" + +#. type: =item +#: dh:488 +msgid "elf-tools" +msgstr "" + +#. type: textblock +#: dh:490 +msgid "" +"This addon adds tools related to ELF files to the sequence such as " +"L<dh_strip(1)> and L<dh_shlibdeps(1)>" +msgstr "" + +#. type: textblock +#: dh:493 +msgid "" +"This addon is I<conditionally> active by default for architecture specific " +"packages - that is, it is skipped for arch:all packages. In the special " +"case where you need these tools to work on arch:all packages, you can use " +"B<--with elf-tools> to activate it unconditionally." +msgstr "" + +#. type: =item +#: dh:499 +msgid "installinitramfs (obsolete)" +msgstr "" + +#. type: textblock +#: dh:501 +msgid "" +"Adds L<dh_installinitramfs(1)> to the sequence in compat level 11 or below. " +"Obsolete in compat 12 or later." +msgstr "" + +#. type: =item +#: dh:504 +msgid "root-sequence (internal)" +msgstr "" + +#. type: textblock +#: dh:506 +msgid "This is reserved for internal usage." +msgstr "" + +#. type: =item +#: dh:508 +msgid "single-binary" +msgstr "" + +#. type: textblock +#: dh:510 +msgid "" +"A special-purpose addon that makes debhelper run in \"single binary\" mode." +msgstr "" + +#. type: textblock +#: dh:512 +msgid "" +"When active, it will pass B<< --destdir=debian/I<package>/ >> to " +"L<dh_auto_install(1)>. This makes every file \"installed\" by the upstream " +"build system part of the (only) binary package by default without having to " +"use other helpers such as L<dh_install(1)>." +msgstr "" + +#. type: textblock +#: dh:517 +msgid "" +"The addon will refuse to activate when the source package lists 2 or more " +"binary packages in F<debian/control> as a precaution." +msgstr "" + +#. type: textblock +#: dh:520 +msgid "" +"Before compat 15. this behaviour was the default when there was only a " +"single binary package listed in F<debian/control>. In compat 15 and later, " +"this addon must explicitly be activated for this feature to work." +msgstr "" #. type: textblock -#: dh:416 +#: dh:524 msgid "" -"Adding to the example above, suppose you need to chmod a file, but only when " -"building the architecture dependent package, as it's not present when " -"building only documentation." +"The rationale for requiring this as an explicit choice is that if it is " +"implicit then debhelper will silently change behaviour on adding a new " +"binary package. This has caused many RC bugs when maintainers renamed a " +"binary and added transitional packages with the intention of supporting " +"seamless upgrades. The result would often be two empty binary packages that " +"were uploaded to archive with users frustrated as their \"upgrade\" removed " +"their programs." msgstr "" -"Continuando con el ejemplo anterior, suponga que necesita ejecutar «chmod» " -"sobre un fichero, pero solo al construir el paquete dependiente de la " -"arquitectura, ya que no está presente cuando solo se construye documentación." -#. type: verbatim -#: dh:420 -#, fuzzy, no-wrap -#| msgid "" -#| "\toverride_dh_fixperms:\n" -#| "\t\tdh_fixperms\n" -#| "\t\tchmod 4755 debian/foo/usr/bin/foo\n" -#| "\n" +#. type: =item +#: dh:532 +msgid "systemd (obsolete)" +msgstr "" + +#. type: textblock +#: dh:534 msgid "" -"\t# Example assumes debhelper/12.8 and compat 10+\n" -"\texecute_after_dh_fixperms-arch:\n" -"\t\tchmod 4755 debian/foo/usr/bin/foo\n" -"\n" +"Adds L<dh_systemd_enable(1)> and L<dh_systemd_start(1)> to the sequence in " +"compat level 10 or below. Obsolete in compat 11 or later." msgstr "" -"\toverride_dh_fixperms:\n" -"\t\tdh_fixperms\n" -"\t\tchmod 4755 debian/foo/usr/bin/foo\n" -"\n" #. type: =head1 -#: dh:424 +#: dh:539 msgid "INTERNALS" msgstr "FUNCIONAMIENTO INTERNO" #. type: textblock -#: dh:426 +#: dh:541 msgid "" "If you're curious about B<dh>'s internals, here's how it works under the " "hood." @@ -4635,7 +5131,7 @@ msgstr "" "puede ver como funciona por dentro." #. type: textblock -#: dh:428 +#: dh:543 msgid "" "In compat 10 (or later), B<dh> creates a stamp file F<debian/debhelper-build-" "stamp> after the build step(s) are complete to avoid re-running them. It is " @@ -4646,7 +5142,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:436 +#: dh:551 msgid "" "Inside an override target, B<dh_*> commands will create a log file F<debian/" "package.debhelper.log> to keep track of which packages the command(s) have " @@ -4655,7 +5151,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:441 +#: dh:556 #, fuzzy #| msgid "" #| "Each debhelper command will record when it's successfully run in F<debian/" @@ -4674,7 +5170,7 @@ msgstr "" "esas órdenes otra vez." #. type: textblock -#: dh:446 +#: dh:561 #, fuzzy #| msgid "" #| "Each time B<dh> is run, it examines the log, and finds the last logged " @@ -4692,7 +5188,7 @@ msgstr "" "before>, B<--after> y B<--remaining> pueden anular este comportamiento." #. type: textblock -#: dh:450 +#: dh:565 msgid "" "A sequence can also run dependent targets in debian/rules. For example, the " "\"binary\" sequence runs the \"install\" target." @@ -4702,7 +5198,7 @@ msgstr "" "ejecuta el objeto «install»." #. type: textblock -#: dh:453 +#: dh:568 msgid "" "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass " "information through to debhelper commands that are run inside override " @@ -4715,7 +5211,7 @@ msgstr "" "entorno, como el nombre sugiere, está sujeto a cambios en cualquier momento." #. type: textblock -#: dh:458 +#: dh:573 msgid "" "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> " "sequences are passed the B<-i> option to ensure they only work on " @@ -4732,19 +5228,19 @@ msgstr "" # type: textblock #. type: textblock -#: dh:737 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 -#: dh_auto_install:101 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:186 -#: dh_clean:193 dh_compress:246 dh_dwz:165 dh_fixperms:168 dh_gconf:109 -#: dh_gencontrol:212 dh_icons:79 dh_install:381 dh_installchangelogs:304 -#: dh_installcron:82 dh_installdeb:416 dh_installdebconf:132 dh_installdirs:135 -#: dh_installdocs:458 dh_installemacsen:143 dh_installexamples:182 -#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:434 -#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:421 +#: dh:876 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 +#: dh_auto_install:107 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:180 +#: dh_clean:193 dh_compress:247 dh_dwz:167 dh_fixperms:168 dh_gencontrol:212 +#: dh_icons:79 dh_install:381 dh_installchangelogs:369 dh_installcron:84 +#: dh_installdeb:423 dh_installdebconf:237 dh_installdirs:135 +#: dh_installdocs:441 dh_installemacsen:143 dh_installexamples:186 +#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:417 +#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:424 #: dh_installmanpages:202 dh_installmenu:94 dh_installmime:67 -#: dh_installmodules:113 dh_installpam:66 dh_installppp:72 dh_installudev:106 -#: dh_installwm:136 dh_installxfonts:94 dh_link:170 dh_lintian:64 +#: dh_installmodules:113 dh_installpam:75 dh_installppp:72 dh_installudev:106 +#: dh_installwm:134 dh_installxfonts:94 dh_link:170 dh_lintian:64 #: dh_listpackages:38 dh_makeshlibs:460 dh_md5sums:122 dh_movefiles:165 -#: dh_perl:178 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 +#: dh_perl:192 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 #: dh_testroot:97 dh_usrlocal:140 msgid "This program is a part of debhelper." msgstr "Este programa es parte de debhelper." @@ -4793,7 +5289,7 @@ msgstr "" "construcción manualmente." #. type: textblock -#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:48 +#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:54 #: dh_auto_test:36 msgid "" "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build " @@ -4804,9 +5300,9 @@ msgstr "" # type: =item #. type: =item -#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:59 +#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:65 #: dh_auto_test:41 dh_builddeb:48 dh_dwz:62 dh_gencontrol:42 -#: dh_installdebconf:72 dh_installinit:167 dh_makeshlibs:179 dh_shlibdeps:41 +#: dh_installdebconf:72 dh_installinit:166 dh_makeshlibs:179 dh_shlibdeps:41 msgid "B<--> I<params>" msgstr "B<--> I<parámetros>" @@ -4980,11 +5476,28 @@ msgstr "" #. type: textblock #: dh_auto_install:32 msgid "" -"Unless B<--destdir> option is specified, the files are installed into debian/" -"I<package>/ if there is only one binary package. In the multiple binary " -"package case, the files are instead installed into F<debian/tmp/>, and " -"should be moved from there to the appropriate package build directory using " -"L<dh_install(1)>." +"In compat 15 or later, B<dh_auto_install> will use F<debian/tmp> as the " +"default B<--destdir> and should be moved from there to the appropriate " +"package build directory using L<dh_install(1)> or similar tools. Though if " +"the B<single-binary> addon for L<dh(1)> is activated, then it will pass an " +"explicit B<< --destdir=debian/I<package>/ >> to B<dh_auto_install>." +msgstr "" + +#. type: textblock +#: dh_auto_install:38 +#, fuzzy +#| msgid "" +#| "Unless B<--destdir> option is specified, the files are installed into " +#| "debian/I<package>/ if there is only one binary package. In the multiple " +#| "binary package case, the files are instead installed into F<debian/tmp/>, " +#| "and should be moved from there to the appropriate package build directory " +#| "using L<dh_install(1)>." +msgid "" +"For earlier compat levels then unless B<--destdir> option is specified, the " +"files are installed into debian/I<package>/ if there is only one binary " +"package. In the multiple binary package case, the files are instead " +"installed into F<debian/tmp/>, and should be moved from there to the " +"appropriate package build directory using L<dh_install(1)> or similar tools." msgstr "" "A menos que se defina la opción B<--destdir>, los ficheros se instalan en " "«debian/I<paquete>/» si sólo hay un paquete binario. En el caso de varios " @@ -4993,7 +5506,7 @@ msgstr "" "L<dh_install(1)>." #. type: textblock -#: dh_auto_install:38 +#: dh_auto_install:44 msgid "" "B<DESTDIR> is used to tell make where to install the files. If the Makefile " "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set " @@ -5005,7 +5518,7 @@ msgstr "" "ficheros F<Makefile>." #. type: textblock -#: dh_auto_install:42 +#: dh_auto_install:48 msgid "" "This is intended to work for about 90% of packages. If it doesn't work, or " "tries to use the wrong install target, you're encouraged to skip using " @@ -5018,12 +5531,12 @@ msgstr "" # type: =item #. type: =item -#: dh_auto_install:53 dh_builddeb:38 +#: dh_auto_install:59 dh_builddeb:38 msgid "B<--destdir=>I<directory>" msgstr "B<--destdir=>I<directorio>" #. type: textblock -#: dh_auto_install:55 +#: dh_auto_install:61 msgid "" "Install files into the specified I<directory>. If this option is not " "specified, destination directory is determined automatically as described in " @@ -5034,7 +5547,7 @@ msgstr "" "describe en la sección L</B<DESCRIPCIÓN>>." #. type: textblock -#: dh_auto_install:61 +#: dh_auto_install:67 msgid "" "Pass I<params> to the program that is run, after the parameters that " "B<dh_auto_install> usually passes." @@ -5138,8 +5651,8 @@ msgstr "" "construcción del paquete." #. type: =head1 -#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_gconf:26 dh_install:40 -#: dh_installcatalogs:39 dh_installchangelogs:47 dh_installcron:24 +#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_install:40 +#: dh_installcatalogs:39 dh_installchangelogs:53 dh_installcron:24 #: dh_installdeb:25 dh_installdebconf:37 dh_installdirs:28 dh_installdocs:40 #: dh_installemacsen:30 dh_installexamples:31 dh_installifupdown:25 #: dh_installinfo:28 dh_installinit:41 dh_installinitramfs:30 @@ -5421,8 +5934,8 @@ msgid "" msgstr "" #. type: textblock -#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:95 -#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:39 dh_installinfo:36 +#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:102 +#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:43 dh_installinfo:36 #: dh_installman:81 dh_installwm:36 dh_link:64 msgid "" "Supports substitution variables in compat 13 and later as documented in " @@ -5431,7 +5944,7 @@ msgstr "" # type: =item #. type: =item -#: dh_clean:53 dh_installchangelogs:75 +#: dh_clean:53 dh_installchangelogs:81 msgid "B<-k>, B<--keep>" msgstr "B<-k>, B<--keep>" @@ -5610,7 +6123,7 @@ msgstr "" # type: =item #. type: =item -#: dh_compress:68 dh_installdocs:184 dh_installexamples:85 dh_installinfo:60 +#: dh_compress:68 dh_installdocs:184 dh_installexamples:89 dh_installinfo:60 #: dh_installmanpages:47 dh_movefiles:58 dh_testdir:30 msgid "I<file> ..." msgstr "I<fichero> ..." @@ -5623,7 +6136,7 @@ msgstr "Añade estos ficheros a la lista de ficheros a comprimir." # type: =head1 #. type: =head1 -#: dh_compress:74 dh_perl:64 dh_strip:133 dh_usrlocal:66 +#: dh_compress:74 dh_perl:65 dh_strip:133 dh_usrlocal:66 msgid "CONFORMS TO" msgstr "CONFORME A" @@ -5837,98 +6350,6 @@ msgstr "" "nombre. Puede utilizar la opción varias veces para construir una lista de " "ficheros a excluir." -# type: textblock -#. type: textblock -#: dh_gconf:5 -#, fuzzy -#| msgid "dh_gconf - install GConf defaults files and register schemas" -msgid "" -"dh_gconf - install GConf defaults files and register schemas (deprecated)" -msgstr "" -"dh_gconf - Instala ficheros de valores predeterminados de GConf y registra " -"esquemas" - -# type: textblock -#. type: textblock -#: dh_gconf:17 -msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" -msgstr "B<dh_gconf> [S<I<opciones-de-debhelper>>] [B<--priority=>I<número>]" - -# type: textblock -#. type: textblock -#: dh_gconf:21 -msgid "" -"B<dh_gconf> is a debhelper program that is responsible for installing GConf " -"defaults files and registering GConf schemas." -msgstr "" -"B<dh_gconf> es un programa de debhelper responsable de la instalación de " -"ficheros de valores predeterminados de GConf («defaults») y de registrar " -"esquemas de GConf." - -#. type: textblock -#: dh_gconf:24 -msgid "" -"An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>." -msgstr "" -"Se generará una dependencia apropiada sobre gconf2 en B<${misc:Depends}>." - -#. type: =item -#: dh_gconf:30 -msgid "debian/I<package>.gconf-defaults" -msgstr "debian/I<paquete>.gconf-defaults" - -# type: textblock -#. type: textblock -#: dh_gconf:32 -msgid "" -"Installed into F<usr/share/gconf/defaults/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" -"Se instala en F<usr/share/gconf/defaults/10_paquete> en el directorio de " -"construcción del paquete, reemplazando I<paquete> por el nombre del paquete." - -#. type: =item -#: dh_gconf:35 -msgid "debian/I<package>.gconf-mandatory" -msgstr "debian/I<paquete>.gconf-mandatory" - -# type: textblock -#. type: textblock -#: dh_gconf:37 -msgid "" -"Installed into F<usr/share/gconf/mandatory/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" -"Se instala en F<usr/share/gconf/mandatory/10_paquete> en el directorio de " -"construcción del paquete, reemplazando I<paquete> por el nombre del paquete." - -# type: =item -#. type: =item -#: dh_gconf:46 -msgid "B<--priority> I<priority>" -msgstr "B<--priority> I<prioridad>" - -# type: textblock -#. type: textblock -#: dh_gconf:48 -msgid "" -"Use I<priority> (which should be a 2-digit number) as the defaults priority " -"instead of B<10>. Higher values than ten can be used by derived " -"distributions (B<20>), CDD distributions (B<50>), or site-specific packages " -"(B<90>)." -msgstr "" -"Utiliza I<prioridad> (que deberÃa ser un número de dos dÃgitos) como la " -"prioridad predeterminada, en lugar de 10. Otros pueden utilizar valores " -"superiores a B<10>, como las distribuciones derivadas (B<20>), " -"distribuciones de Debian personalizadas CDD (B<50>) y paquetes de sitios web " -"especÃficos (B<90>)." - -# type: textblock -#. type: textblock -#: dh_gconf:113 -msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" -msgstr "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" - # type: textblock #. type: textblock #: dh_gencontrol:5 @@ -6021,10 +6442,10 @@ msgstr "B<dh_icons> [S<I<opciones-de-debhelper>>] [B<-n>]" #, fuzzy #| msgid "" #| "B<dh_icons> is a debhelper program that updates Freedesktop icon caches " -#| "when needed, using the B<update-icon-caches> program provided by GTK" -#| "+2.12. Currently this program does not handle installation of the files, " -#| "though it may do so at a later date. It takes care of adding maintainer " -#| "script fragments to call B<update-icon-caches>." +#| "when needed, using the B<update-icon-caches> program provided by " +#| "GTK+2.12. Currently this program does not handle installation of the " +#| "files, though it may do so at a later date. It takes care of adding " +#| "maintainer script fragments to call B<update-icon-caches>." msgid "" "B<dh_icons> is a debhelper program that updates caches of Freedesktop icons " "when needed, using the B<update-icon-caches> program provided by GTK+2.12. " @@ -6061,7 +6482,7 @@ msgstr "" # type: =item #. type: =item #: dh_icons:37 dh_installcatalogs:60 dh_installdebconf:68 dh_installemacsen:60 -#: dh_installinit:82 dh_installinitramfs:47 dh_installmenu:48 +#: dh_installinit:81 dh_installinitramfs:47 dh_installmenu:48 #: dh_installmodules:45 dh_installwm:51 dh_makeshlibs:147 dh_usrlocal:54 msgid "B<-n>, B<--no-scripts>" msgstr "B<-n>, B<--no-scripts>" @@ -6261,7 +6682,7 @@ msgstr "" # type: =item #. type: =item -#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:53 +#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:57 #: dh_installinfo:50 dh_installman:100 dh_movefiles:45 msgid "B<--sourcedir=>I<dir>" msgstr "B<--sourcedir=>I<directorio>" @@ -6548,7 +6969,7 @@ msgstr "No modifica los scripts F<postinst>/F<postrm>/F<prerm>." # type: textblock #. type: textblock -#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:207 +#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:206 #: dh_installmodules:59 dh_installudev:52 dh_installwm:68 dh_usrlocal:62 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " @@ -6582,17 +7003,21 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:17 +#: dh_installchangelogs:18 +#, fuzzy +#| msgid "" +#| "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " +#| "[I<upstream>]" msgid "" "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " -"[I<upstream>]" +"[B<--no-trim>] [I<upstream>]" msgstr "" "B<dh_installchangelogs> [S<I<opciones-de-debhelper>>] [B<-k>] [B<-" "X>I<elemento>] [I<fuente-original-de-software>]" # type: textblock #. type: textblock -#: dh_installchangelogs:21 +#: dh_installchangelogs:22 msgid "" "B<dh_installchangelogs> is a debhelper program that is responsible for " "installing changelogs into package build directories." @@ -6602,7 +7027,7 @@ msgstr "" "construcción del paquete." #. type: textblock -#: dh_installchangelogs:24 +#: dh_installchangelogs:25 #, fuzzy #| msgid "" #| "An upstream F<changelog> file may be specified as an option. If none is " @@ -6619,7 +7044,7 @@ msgstr "" "compatibilidad y superior)." #. type: textblock -#: dh_installchangelogs:28 +#: dh_installchangelogs:29 msgid "" "In non-native packages, B<dh_installchangelogs> will first look for " "changelog files installed by the upstream build system into F<< usr/share/" @@ -6635,7 +7060,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:40 +#: dh_installchangelogs:41 #, fuzzy #| msgid "" #| "If there is an upstream F<changelog> file, it will be be installed as " @@ -6659,29 +7084,38 @@ msgstr "" "convertido a texto simple utilizando B<html2text> para generar F<usr/share/" "doc/paquete/changelog>." +#. type: textblock +#: dh_installchangelogs:48 +msgid "" +"The B<debchange>-style Debian changelogs are trimmed to include only entries " +"more recent than the release date of I<oldstable>. No trimming will be " +"performed if the B<--no-trim> option is passed or if the " +"B<DEB_BUILD_OPTIONS> environment variable contains B<notrimdch>." +msgstr "" + #. type: =item -#: dh_installchangelogs:51 +#: dh_installchangelogs:57 msgid "F<debian/changelog>" msgstr "F<debian/changelog>" #. type: =item -#: dh_installchangelogs:53 +#: dh_installchangelogs:59 msgid "F<debian/NEWS>" msgstr "F<debian/NEWS>" #. type: =item -#: dh_installchangelogs:55 +#: dh_installchangelogs:61 msgid "debian/I<package>.changelog" msgstr "debian/I<paquete>.changelog" #. type: =item -#: dh_installchangelogs:57 +#: dh_installchangelogs:63 msgid "debian/I<package>.NEWS" msgstr "debian/I<paquete>.NEWS" # type: textblock #. type: textblock -#: dh_installchangelogs:59 +#: dh_installchangelogs:65 msgid "" "Automatically installed into usr/share/doc/I<package>/ in the package build " "directory." @@ -6690,7 +7124,7 @@ msgstr "" "construcción del paquete." #. type: textblock -#: dh_installchangelogs:62 +#: dh_installchangelogs:68 msgid "" "Use the package specific name if I<package> needs a different F<NEWS> or " "F<changelog> file." @@ -6699,7 +7133,7 @@ msgstr "" "F<changelog> o F<NEWS> diferente." #. type: textblock -#: dh_installchangelogs:65 +#: dh_installchangelogs:71 msgid "" "The F<changelog> file is installed with a name of changelog for native " "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file " @@ -6711,7 +7145,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:77 +#: dh_installchangelogs:83 msgid "" "Keep the original name of the upstream changelog. This will be accomplished " "by installing the upstream changelog as F<changelog>, and making a symlink " @@ -6728,7 +7162,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:85 +#: dh_installchangelogs:91 msgid "" "Exclude upstream F<changelog> files that contain I<item> anywhere in their " "filename from being installed." @@ -6737,19 +7171,34 @@ msgstr "" "principal que contengan I<elemento> en alguna parte de su nombre." #. type: textblock -#: dh_installchangelogs:88 +#: dh_installchangelogs:94 msgid "Note that directory name of the changelog is also part of the match." msgstr "" # type: =item #. type: =item -#: dh_installchangelogs:90 +#: dh_installchangelogs:96 +#, fuzzy +#| msgid "B<--no-start>" +msgid "B<--no-trim>" +msgstr "B<--no-start>" + +#. type: textblock +#: dh_installchangelogs:98 +msgid "" +"Install the full changelog, not its trimmed version that includes only " +"recent entries." +msgstr "" + +# type: =item +#. type: =item +#: dh_installchangelogs:101 msgid "I<upstream>" msgstr "I<upstream>" # type: textblock #. type: textblock -#: dh_installchangelogs:92 +#: dh_installchangelogs:103 msgid "Install this file as the upstream changelog." msgstr "" "Instala este fichero como el fichero de cambios del desarrollador principal." @@ -6793,17 +7242,24 @@ msgstr "debian/I<paquete>.cron.monthly" #. type: =item #: dh_installcron:34 +#, fuzzy +#| msgid "debian/I<package>.cron.daily" +msgid "debian/I<package>.cron.yearly" +msgstr "debian/I<paquete>.cron.daily" + +#. type: =item +#: dh_installcron:36 msgid "debian/I<package>.cron.hourly" msgstr "debian/I<paquete>.cron.hourly" #. type: =item -#: dh_installcron:36 +#: dh_installcron:38 msgid "debian/I<package>.cron.d" msgstr "debian/I<paquete>.cron.d" # type: textblock #. type: textblock -#: dh_installcron:38 +#: dh_installcron:40 msgid "" "Installed into the appropriate F<etc/cron.*/> directory in the package build " "directory." @@ -6813,15 +7269,15 @@ msgstr "" # type: =item #. type: =item -#: dh_installcron:47 dh_installifupdown:46 dh_installinit:175 +#: dh_installcron:49 dh_installifupdown:46 dh_installinit:174 #: dh_installlogcheck:49 dh_installlogrotate:29 dh_installmodules:49 -#: dh_installpam:38 dh_installppp:42 dh_installudev:38 dh_systemd_enable:95 +#: dh_installpam:42 dh_installppp:42 dh_installudev:38 dh_systemd_enable:94 msgid "B<--name=>I<name>" msgstr "B<--name=>I<nombre>" # type: textblock #. type: textblock -#: dh_installcron:49 +#: dh_installcron:51 msgid "" "Look for files named F<debian/package.name.cron.*> and install them as F<etc/" "cron.*/name>, instead of using the usual files and installing them as the " @@ -6929,17 +7385,17 @@ msgstr "I<paquete>.conffiles" #. type: textblock #: dh_installdeb:59 msgid "" -"Historically, this file was needed to manually mark files files as " -"conffiles. However, it has become de facto obsolete since debhelper " -"automatically computed which files should be marked as conffiles." +"This file will be installed into the F<DEBIAN> directory. The provided file " +"will be enriched by debhelper to include all the B<conffiles> auto-detected " +"by debhelper (the maintainer should not list there as debhelper assumes it " +"should handle that part)." msgstr "" #. type: textblock -#: dh_installdeb:63 +#: dh_installdeb:64 msgid "" -"In compatibility level up and including 11, this control file will be " -"installed into the F<DEBIAN> directory. In compatibility level 12 and " -"later, the file is silently ignored." +"This file is primarily useful for using \"special\" entries such as the B<< " +"remove-on-upgrade >> feature from dpkg." msgstr "" #. type: =item @@ -7010,13 +7466,23 @@ msgid "" "enabled as a warning since compat 10 and as a hard error in compat 12." msgstr "" +#. type: textblock +#: dh_installdeb:95 +msgid "" +"Where possible, B<dh_installdeb> may choose to rewrite some or all of the " +"entries into equivalent features supported in dpkg without relying on " +"maintainer scripts at its sole discretion (examples include rewriting " +"B<rm_conffile> into dpkg's B<remove-on-upgrade>). The minimum requirement " +"for activating this feature is that debhelper runs in compat 10 or later." +msgstr "" + #. type: =item -#: dh_installdeb:104 +#: dh_installdeb:111 dh_installdebconf:76 msgid "B<-D>I<TOKEN=VALUE>, B<--define> I<TOKEN=VALUE>" msgstr "" #. type: textblock -#: dh_installdeb:106 +#: dh_installdeb:113 dh_installdebconf:78 msgid "" "Define tokens to be replaced inside the maintainer scripts when it is " "generated. Please note that the limitations described in L</Limitations in " @@ -7025,7 +7491,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:111 +#: dh_installdeb:118 dh_installdebconf:83 msgid "" "In the simple case, this parameter will cause B<< #I<TOKEN># >> to be " "replaced by I<VALUE>. If I<VALUE> starts with a literal I<@>-sign, then " @@ -7034,18 +7500,18 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:116 +#: dh_installdeb:123 dh_installdebconf:88 msgid "" "An explicit declared token with this parameter will replace built-in tokens." msgstr "" #. type: textblock -#: dh_installdeb:119 +#: dh_installdeb:126 dh_installdebconf:91 msgid "Test examples to aid with the understanding:" msgstr "" #. type: verbatim -#: dh_installdeb:121 +#: dh_installdeb:128 #, no-wrap msgid "" "\tcat >> debian/postinst <<EOF\n" @@ -7058,14 +7524,14 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:128 +#: dh_installdeb:135 dh_installdebconf:100 msgid "" "In this example, B<#SIMPLE#> will expand to B<direct> and B<#FILEBASED#> " "will expand to B<Complex value>." msgstr "" #. type: textblock -#: dh_installdeb:131 +#: dh_installdeb:138 msgid "" "It is also possible to set package-specific values for a given token. This " "is useful when B<dh_installdeb> is acting on multiple packages that need " @@ -7074,12 +7540,12 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:136 +#: dh_installdeb:143 dh_installdebconf:108 msgid "This can be used as in the following example:" msgstr "" #. type: verbatim -#: dh_installdeb:138 +#: dh_installdeb:145 #, no-wrap msgid "" "\tcat >> debian/foo.postinst <<EOF\n" @@ -7100,7 +7566,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:153 +#: dh_installdeb:160 msgid "" "In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." "postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and to B<unique-" @@ -7108,7 +7574,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:157 +#: dh_installdeb:164 msgid "" "Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." "g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> and it " @@ -7116,12 +7582,12 @@ msgid "" msgstr "" #. type: =head1 -#: dh_installdeb:163 +#: dh_installdeb:170 dh_installdebconf:135 msgid "SUBSTITUTION IN MAINTAINER SCRIPTS" msgstr "" #. type: textblock -#: dh_installdeb:165 +#: dh_installdeb:172 msgid "" "The B<dh_installdeb> will automatically replace the following tokens inside " "a provided maintainer script (if not replaced via B<-D>/B<--define>):" @@ -7129,14 +7595,14 @@ msgstr "" # type: =head1 #. type: =item -#: dh_installdeb:170 +#: dh_installdeb:177 #, fuzzy #| msgid "DEBHELPER COMMANDS" msgid "#DEBHELPER#" msgstr "ÓRDENES DE DEBHELPER" #. type: textblock -#: dh_installdeb:172 +#: dh_installdeb:179 msgid "" "This token is by default replaced with generated shell snippets debhelper " "commands. This includes the snippets generated by B<dh_installdeb> from " @@ -7144,12 +7610,12 @@ msgid "" msgstr "" #. type: =item -#: dh_installdeb:176 +#: dh_installdeb:183 dh_installdebconf:142 msgid "#DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME>#" msgstr "" #. type: textblock -#: dh_installdeb:178 +#: dh_installdeb:185 dh_installdebconf:144 msgid "" "These tokens are replaced with the respective variable from L<dpkg-" "architecture(1)>. In almost all cases, you will want use the B<< " @@ -7158,19 +7624,19 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:183 +#: dh_installdeb:190 dh_installdebconf:149 msgid "" "On a best effort, tokens of this pattern that do not match a variable in " "L<dpkg-architecture(1)> will be left as-is." msgstr "" #. type: =item -#: dh_installdeb:186 +#: dh_installdeb:193 dh_installdebconf:152 msgid "#ENV.I<NAME>#" msgstr "" #. type: textblock -#: dh_installdeb:188 +#: dh_installdeb:195 dh_installdebconf:154 msgid "" "These tokens of this form will be replaced with value of the corresponding " "environment variable. If the environment variable is unset, the token is " @@ -7178,37 +7644,37 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:193 +#: dh_installdeb:200 dh_installdebconf:159 msgid "" "Note that there are limits on which names can be used (see L</Limitations in " "token names>)." msgstr "" #. type: =item -#: dh_installdeb:196 +#: dh_installdeb:203 dh_installdebconf:162 msgid "#PACKAGE#" msgstr "" #. type: textblock -#: dh_installdeb:198 +#: dh_installdeb:205 dh_installdebconf:164 msgid "" "This token is by default replaced by the package name, which will contain " "the concrete script." msgstr "" #. type: =head2 -#: dh_installdeb:203 +#: dh_installdeb:210 dh_installdebconf:169 msgid "Limitations in token names" msgstr "" #. type: textblock -#: dh_installdeb:205 +#: dh_installdeb:212 dh_installdebconf:171 msgid "" "All tokens intended to be substituted must match the regex: #[A-Za-z0-9_.+]+#" msgstr "" #. type: textblock -#: dh_installdeb:207 +#: dh_installdeb:214 msgid "" "Tokens that do not match that regex will be silently ignored if found in the " "script template. Invalid token names passed to B<-D> or B<--define> will " @@ -7358,6 +7824,80 @@ msgstr "No modifica el script F<postrm>." msgid "Pass the params to B<po2debconf>." msgstr "Introduce los «parámetros» a B<po2debconf>." +#. type: verbatim +#: dh_installdebconf:93 +#, no-wrap +msgid "" +"\tcat >> debian/config <<EOF\n" +"\t#SIMPLE#\n" +"\t#FILEBASED#\n" +"\tEOF\n" +"\techo -n \"Complex value\" > some-file\n" +" dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +"\n" +msgstr "" + +#. type: textblock +#: dh_installdebconf:103 +msgid "" +"It is also possible to set package-specific values for a given token. This " +"is useful when B<dh_installdebconf> is acting on multiple packages that need " +"different values for the same token. This is done by prefixing the token " +"name with B<< pkg.I<package-name>. >>." +msgstr "" + +#. type: verbatim +#: dh_installdebconf:110 +#, no-wrap +msgid "" +"\tcat >> debian/foo.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/bar.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/baz.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +" dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \\\n" +" --define pkg.baz.TOKEN=unique-baz-value\n" +"\n" +msgstr "" + +#. type: textblock +#: dh_installdebconf:125 +msgid "" +"In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." +"config>, to B<unique-bar-value> in F<debian/bar.config> and to B<unique-baz-" +"value> in F<debian/baz.config>." +msgstr "" + +#. type: textblock +#: dh_installdebconf:129 +msgid "" +"Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." +"g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.config> and it " +"will be replaced by B<unique-bar-value>." +msgstr "" + +#. type: textblock +#: dh_installdebconf:137 +msgid "" +"The B<dh_installdebconf> will automatically replace the following tokens " +"inside a provided maintainer script (if not replaced via B<-D>/B<--define>):" +msgstr "" + +#. type: textblock +#: dh_installdebconf:173 +msgid "" +"Tokens that do not match that regex will be silently ignored if found in the " +"script template. Invalid token names passed to B<-D> or B<--define> will " +"cause B<dh_installdebconf> to reject the command with an error in most cases." +msgstr "" + # type: textblock #. type: textblock #: dh_installdirs:5 @@ -7687,7 +8227,7 @@ msgstr "" "nombre. Tenga en cuenta que esto incluye ficheros de doc-base." #. type: textblock -#: dh_installdocs:116 dh_installexamples:55 dh_installinfo:52 dh_installman:102 +#: dh_installdocs:116 dh_installexamples:59 dh_installinfo:52 dh_installman:102 msgid "" "Look in the specified directory for files to be installed. This option " "requires compat 11 or later (it is silently ignored in compat 10 or earlier)." @@ -7714,14 +8254,14 @@ msgstr "" # type: =item #. type: =item -#: dh_installdocs:124 dh_installexamples:63 +#: dh_installdocs:124 dh_installexamples:67 #, fuzzy #| msgid "B<--mainpackage=>I<package>" msgid "B<--doc-main-package=>I<main-package>" msgstr "B<--mainpackage=>I<paquete>" #. type: textblock -#: dh_installdocs:126 dh_installexamples:65 +#: dh_installdocs:126 dh_installexamples:69 msgid "" "Set the main package for a documentation package. This is used to install " "the documentation of the documentation package in F<< /usr/share/doc/I<main-" @@ -7729,7 +8269,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdocs:131 dh_installexamples:70 +#: dh_installdocs:131 dh_installexamples:74 msgid "" "In compat 11 (or later), this option is only useful if debhelper's auto-" "detection of the main package is wrong. The option can also be used to " @@ -8079,9 +8619,18 @@ msgstr "debian/I<paquete>.examples" msgid "Lists example files or directories to be installed." msgstr "Lista ficheros de ejemplo o directorios a instalar." +#. type: textblock +#: dh_installexamples:39 +msgid "" +"If upstream provides an F<examples> directory, you will often want to use " +"B<examples/*> rather than B<examples> in this file. The latter would create " +"F<< /usr/share/doc/I<package>/examples/examples >>, which is rarely what you " +"want." +msgstr "" + # type: textblock #. type: textblock -#: dh_installexamples:50 +#: dh_installexamples:54 msgid "" "Install any files specified by command line parameters in ALL packages acted " "on." @@ -8090,7 +8639,7 @@ msgstr "" "órdenes en TODOS los paquetes sobre los que actúa." #. type: textblock -#: dh_installexamples:58 +#: dh_installexamples:62 #, fuzzy #| msgid "" #| "Note that this is not the same as the B<--sourcedirectory> option used by " @@ -8109,7 +8658,7 @@ msgstr "" "nivel de compatibilidad 7 y posterior." #. type: textblock -#: dh_installexamples:75 +#: dh_installexamples:79 msgid "" "This option cannot be used when B<dh_installexamples> is instructed to act " "on multiple packages. If you need this option, you will generally need to " @@ -8118,7 +8667,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installexamples:82 +#: dh_installexamples:86 msgid "" "Exclude files that contain I<item> anywhere in their filename from being " "installed." @@ -8128,7 +8677,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installexamples:87 +#: dh_installexamples:91 msgid "" "Install these files (or directories) as examples into the first package " "acted on. (Or into all packages if B<-A> is specified.)" @@ -8138,7 +8687,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installexamples:94 +#: dh_installexamples:98 msgid "" "Note that B<dh_installexamples> will happily copy entire directory " "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to " @@ -8415,8 +8964,9 @@ msgstr "debian/I<paquete>.mime" #| "If this exists, it is installed into etc/init/I<package>.conf in the " #| "package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"in the package build directory. Only used in compat levels 10 and below." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> in the package build directory. Only used in compat levels 10 and " +"below." msgstr "" "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " "construcción del paquete." @@ -8437,26 +8987,25 @@ msgstr "debian/I<paquete>.files" #| "package build directory." msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.) Only used in compat levels 10 and below." +"the package build directory. Only used in compat levels 10 and below." msgstr "" "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " "construcción del paquete." # type: textblock #. type: textblock -#: dh_installinit:84 +#: dh_installinit:83 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts." msgstr "No modifica los scripts F<postinst>/F<postrm>/F<prerm>." # type: =item #. type: =item -#: dh_installinit:86 +#: dh_installinit:85 msgid "B<-o>, B<--only-scripts>" msgstr "B<-o>, B<--only-scripts>" #. type: textblock -#: dh_installinit:88 +#: dh_installinit:87 #, fuzzy #| msgid "" #| "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually " @@ -8476,7 +9025,7 @@ msgstr "" "encuentre." #. type: textblock -#: dh_installinit:93 +#: dh_installinit:92 msgid "" "B<Caveat>: This will bypass all the regular checks and I<unconditionally> " "modify the scripts. You will almost certainly want to use this with B<-p> " @@ -8484,7 +9033,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh_installinit:98 +#: dh_installinit:97 #, no-wrap msgid "" " override_dh_installinit:\n" @@ -8495,13 +9044,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:102 +#: dh_installinit:101 msgid "B<-R>, B<--restart-after-upgrade>" msgstr "B<-R>, B<--restart-after-upgrade>" # type: textblock #. type: textblock -#: dh_installinit:104 +#: dh_installinit:103 #, fuzzy #| msgid "" #| "Do not stop the init script until after the package upgrade has been " @@ -8517,7 +9066,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installinit:107 +#: dh_installinit:106 #, fuzzy #| msgid "" #| "Do not stop the init script until after the package upgrade has been " @@ -8533,7 +9082,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installinit:110 dh_systemd_start:45 +#: dh_installinit:109 dh_systemd_start:45 msgid "" "This can be useful for daemons that should not have a possibly long downtime " "during upgrade. But you should make sure that the daemon will not get " @@ -8547,14 +9096,14 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:115 dh_systemd_start:50 +#: dh_installinit:114 dh_systemd_start:50 #, fuzzy #| msgid "B<-R>, B<--restart-after-upgrade>" msgid "B<--no-restart-after-upgrade>" msgstr "B<-R>, B<--restart-after-upgrade>" #. type: textblock -#: dh_installinit:117 dh_systemd_start:52 +#: dh_installinit:116 dh_systemd_start:52 msgid "" "Undo a previous B<--restart-after-upgrade> (or the default of compat 10). " "If no other options are given, this will cause the service to be stopped in " @@ -8563,19 +9112,19 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:122 dh_systemd_start:57 +#: dh_installinit:121 dh_systemd_start:57 msgid "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" msgstr "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" #. type: textblock -#: dh_installinit:124 +#: dh_installinit:123 msgid "" "Do not stop init script on upgrade. This has the side-effect of not " "restarting the service as a part of the upgrade." msgstr "" #. type: textblock -#: dh_installinit:127 +#: dh_installinit:126 msgid "" "If you want to restart the service with minimal downtime, please use B<--" "restart-after-upgrade> (default in compat 10 or later). If you want the " @@ -8584,7 +9133,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:132 +#: dh_installinit:131 msgid "" "Note that the B<--no-restart-on-upgrade> alias is deprecated and will be " "removed in compat 12. This is to avoid confusion with the B<--no-restart-" @@ -8594,13 +9143,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:137 dh_systemd_start:61 +#: dh_installinit:136 dh_systemd_start:61 msgid "B<--no-start>" msgstr "B<--no-start>" # type: textblock #. type: textblock -#: dh_installinit:139 +#: dh_installinit:138 msgid "" "Do not start the init script on install or upgrade, or stop it on removal. " "Only call B<update-rc.d>. Useful for rcS scripts." @@ -8611,14 +9160,14 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:142 dh_systemd_enable:87 +#: dh_installinit:141 dh_systemd_enable:86 #, fuzzy #| msgid "B<--no-act>" msgid "B<--no-enable>" msgstr "B<--no-act>" #. type: textblock -#: dh_installinit:144 +#: dh_installinit:143 msgid "" "Disable the init script on purge, but do not enable them on install. This " "implies a versioned dependency on B<< init-system-helpers (E<gt>= 1.51) >> " @@ -8627,7 +9176,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:149 +#: dh_installinit:148 msgid "" "B<Note> that this option does not affect whether the services are started. " "Please remember to also use B<--no-start> if the service should not be " @@ -8636,7 +9185,7 @@ msgstr "" # type: =item #. type: textblock -#: dh_installinit:153 +#: dh_installinit:152 #, fuzzy #| msgid "B<-u>I<params> B<--update-rcd-params=>I<params>" msgid "" @@ -8646,13 +9195,13 @@ msgstr "B<-u>I<parámetros> B<--update-rcd-params=>I<parámetros>" # type: =item #. type: =item -#: dh_installinit:156 +#: dh_installinit:155 msgid "B<-d>, B<--remove-d>" msgstr "B<-d>, B<--remove-d>" # type: textblock #. type: textblock -#: dh_installinit:158 +#: dh_installinit:157 msgid "" "Remove trailing B<d> from the name of the package, and use the result for " "the filename the upstart job file is installed as in F<etc/init/> , and for " @@ -8670,13 +9219,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:165 +#: dh_installinit:164 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>" msgstr "B<-u>I<parámetros> B<--update-rcd-params=>I<parámetros>" # type: textblock #. type: textblock -#: dh_installinit:169 +#: dh_installinit:168 #, fuzzy #| msgid "" #| "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> will " @@ -8690,13 +9239,13 @@ msgstr "" "introduce B<defaults> a L<update-rc.d(8)>." #. type: textblock -#: dh_installinit:173 +#: dh_installinit:172 msgid "Cannot be combined with B<--no-enable>." msgstr "" # type: textblock #. type: textblock -#: dh_installinit:177 +#: dh_installinit:176 msgid "" "Install the init script (and default file) as well as upstart job file using " "the filename I<name> instead of the default filename, which is the package " @@ -8715,13 +9264,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:185 +#: dh_installinit:184 msgid "B<--init-script=>I<scriptname>" msgstr "B<--init-script=>I<nombre-script>" # type: textblock #. type: textblock -#: dh_installinit:187 +#: dh_installinit:186 msgid "" "Use I<scriptname> as the filename the init script is installed as in F<etc/" "init.d/> (and also use it as the filename for the defaults file, if it is " @@ -8740,7 +9289,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installinit:194 +#: dh_installinit:193 msgid "" "This parameter is deprecated, use the B<--name> parameter instead. This " "parameter is incompatible with the use of upstart jobs." @@ -8750,13 +9299,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:197 +#: dh_installinit:196 msgid "B<--error-handler=>I<function>" msgstr "B<--error-handler=>I<función>" # type: textblock #. type: textblock -#: dh_installinit:199 +#: dh_installinit:198 msgid "" "Call the named shell I<function> if running the init script fails. The " "function should be provided in the F<prerm> and F<postinst> scripts, before " @@ -8768,19 +9317,19 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installinit:432 +#: dh_installinit:415 #, fuzzy #| msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>" msgid "L<debhelper(7)>, L<dh_installsystemd(1)>" msgstr "L<debhelper(7)>, L<dpkg-shlibdeps(1)>" #. type: textblock -#: dh_installinit:440 +#: dh_installinit:423 msgid "Steve Langasek <steve.langasek@canonical.com>" msgstr "Steve Langasek <steve.langasek@canonical.com>" #. type: textblock -#: dh_installinit:442 +#: dh_installinit:425 msgid "Michael Stapelberg <stapelberg@debian.org>" msgstr "" @@ -9622,18 +10171,33 @@ msgstr "debian/I<paquete>.pam" # type: textblock #. type: textblock #: dh_installpam:30 -msgid "Installed into etc/pam.d/I<package> in the package build directory." +#, fuzzy +#| msgid "Installed into etc/pam.d/I<package> in the package build directory." +msgid "Installed into usr/lib/pam.d/I<package> in the package build directory." msgstr "" "Instalado en «etc/pam.d/I<paquete>» en el directorio de construcción del " "paquete." +#. type: textblock +#: dh_installpam:32 +msgid "" +"Until compatibility level 14 this file was installed under etc/pam.d/" +"I<package>. Please consider using the \"rm_conffile\" feature from " +"L<dh_installdeb(1)> to ensure the proper removal of previous PAM files." +msgstr "" + # type: textblock #. type: textblock -#: dh_installpam:40 +#: dh_installpam:44 +#, fuzzy +#| msgid "" +#| "Look for files named debian/I<package>.I<name>.pam and install them as " +#| "etc/pam.d/I<name>, instead of using the usual files and installing them " +#| "using the package name." msgid "" -"Look for files named debian/I<package>.I<name>.pam and install them as etc/" -"pam.d/I<name>, instead of using the usual files and installing them using " -"the package name." +"Look for files named debian/I<package>.I<name>.pam and install them as usr/" +"lib/pam.d/I<name>, instead of using the usual files and installing them " +"using the package name." msgstr "" "Busca ficheros con el nombre «debian/I<nombre>.I<paquete>.pam» y los instala " "como «etc/pam.d/I<nombre>», en vez de utilizar los ficheros habituales e " @@ -9918,8 +10482,8 @@ msgid "" "Depends}>.)" msgstr "" "Su paquete debe depender de B<xfonts-utils> para que las órdenes B<update-" -"fonts->I<*> estén disponibles. (Este programa añade la dependencia a B<" -"${misc:Depends}>.)" +"fonts->I<*> estén disponibles. (Este programa añade la dependencia a " +"B<${misc:Depends}>.)" # type: textblock #. type: textblock @@ -10783,9 +11347,13 @@ msgstr "B<-x>, B<--include-conffiles>" # type: textblock #. type: textblock #: dh_md5sums:37 +#, fuzzy +#| msgid "" +#| "Include conffiles in the md5sums list. Note that this information is " +#| "redundant since it is included elsewhere in Debian packages." msgid "" "Include conffiles in the md5sums list. Note that this information is " -"redundant since it is included elsewhere in Debian packages." +"redundant since it is included in F</var/lib/dpkg/status> in Debian packages." msgstr "" "Incluye conffiles en la lista «md5sums». Note que esta información es " "redundante puesto que está incluida en otro lugar de los paquetes de Debian." @@ -10939,7 +11507,7 @@ msgstr "dh_perl - Calcula dependencias de Perl y limpia después de MakeMaker" # type: textblock #. type: textblock -#: dh_perl:19 +#: dh_perl:20 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]" msgstr "" "B<dh_perl> [S<I<opciones-de-debhelper>>] [B<-d>] [S<I<directorios-" @@ -10947,17 +11515,17 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:23 +#: dh_perl:24 msgid "" -"B<dh_perl> is a debhelper program that is responsible for generating the B<" -"${perl:Depends}> substitutions and adding them to substvars files." +"B<dh_perl> is a debhelper program that is responsible for generating the " +"B<${perl:Depends}> substitutions and adding them to substvars files." msgstr "" "B<dh_perl> es un programa de debhelper que se encarga de generar las " "sustituciones en B<${perl:Depends}> y añadirlas a los ficheros «substvars»." # type: textblock #. type: textblock -#: dh_perl:26 +#: dh_perl:27 msgid "" "The program will look at Perl scripts and modules in your package, and will " "use this information to generate a dependency on B<perl> or B<perlapi>. The " @@ -10971,7 +11539,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:31 +#: dh_perl:32 msgid "" "B<dh_perl> also cleans up empty directories that MakeMaker can generate when " "installing Perl modules." @@ -10981,13 +11549,13 @@ msgstr "" # type: =item #. type: =item -#: dh_perl:38 +#: dh_perl:39 msgid "B<-d>" msgstr "B<-d>" # type: textblock #. type: textblock -#: dh_perl:40 +#: dh_perl:41 msgid "" "In some specific cases you may want to depend on B<perl-base> rather than " "the full B<perl> package. If so, you can pass the -d option to make " @@ -11002,7 +11570,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:45 +#: dh_perl:46 msgid "" "Note that this flag may cause no dependency on B<perl-base> to be generated " "at all. B<perl-base> is Essential, so its dependency can be left out, unless " @@ -11015,13 +11583,13 @@ msgstr "" # type: =item #. type: =item -#: dh_perl:49 +#: dh_perl:50 msgid "B<-V>" msgstr "B<-V>" # type: textblock #. type: textblock -#: dh_perl:51 +#: dh_perl:52 msgid "" "By default, scripts and architecture independent modules don't depend on any " "specific version of B<perl>. The B<-V> option causes the current version of " @@ -11033,13 +11601,13 @@ msgstr "" # type: =item #. type: =item -#: dh_perl:55 +#: dh_perl:56 msgid "I<library dirs>" msgstr "I<directorios-de-biblioteca>" # type: textblock #. type: textblock -#: dh_perl:57 +#: dh_perl:58 msgid "" "If your package installs Perl modules in non-standard directories, you can " "make B<dh_perl> check those directories by passing their names on the " @@ -11053,19 +11621,19 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:66 +#: dh_perl:67 msgid "Debian policy, version 3.8.3" msgstr "Normas de Debian, versión 3.8.3" # type: textblock #. type: textblock -#: dh_perl:68 +#: dh_perl:69 msgid "Perl policy, version 1.20" msgstr "Normas de Perl, versión 1.20" # type: textblock #. type: textblock -#: dh_perl:182 +#: dh_perl:196 msgid "Brendan O'Dea <bod@debian.org>" msgstr "Brendan O'Dea <bod@debian.org>" @@ -11604,8 +12172,8 @@ msgid "" "adding B<noautodbgsym> to the B<DEB_BUILD_OPTIONS> environment variable. " "However, B<dh_strip> will still add debuglinks to ELF binaries when this " "flag is set. This is to ensure that the regular deb package will be " -"identical with and without this flag (assuming it is otherwise \"bit-for-bit" -"\" reproducible)." +"identical with and without this flag (assuming it is otherwise \"bit-for-" +"bit\" reproducible)." msgstr "" # type: textblock @@ -11890,8 +12458,9 @@ msgstr "debian/I<paquete>.logcheck.ignore.server" #| "If this exists, it is installed into etc/init/I<package>.conf in the " #| "package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"(or lib/systemd/system/I<package>@.service) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> (or F<< lib/systemd/system/I<package>@.service >>) in the package " +"build directory." msgstr "" "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " "construcción del paquete." @@ -11901,18 +12470,17 @@ msgstr "" #: dh_systemd_enable:52 #, fuzzy #| msgid "" -#| "If this exists, it is installed into etc/init/I<package>.conf in the " -#| "package build directory." +#| "If this exists, it is installed into etc/init.d/I<package> in the package " +#| "build directory." msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.)" +"the package build directory." msgstr "" -"Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " +"Si existe, se instala en «etc/init/I<paquete>» en el directorio de " "construcción del paquete." #. type: =item -#: dh_systemd_enable:56 +#: dh_systemd_enable:55 #, fuzzy #| msgid "debian/I<package>.manpages" msgid "debian/I<package>.target, debian/I<package>@.target" @@ -11920,20 +12488,21 @@ msgstr "debian/I<paquete>.manpages" # type: textblock #. type: textblock -#: dh_systemd_enable:58 +#: dh_systemd_enable:57 #, fuzzy #| msgid "" #| "If this exists, it is installed into etc/init/I<package>.conf in the " #| "package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.target " -"(or lib/systemd/system/I<package>@.target) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"target >> (or F<< lib/systemd/system/I<package>@.target >>) in the package " +"build directory." msgstr "" "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " "construcción del paquete." #. type: =item -#: dh_systemd_enable:61 +#: dh_systemd_enable:60 #, fuzzy #| msgid "debian/I<package>.manpages" msgid "debian/I<package>.socket, debian/I<package>@.socket" @@ -11941,20 +12510,21 @@ msgstr "debian/I<paquete>.manpages" # type: textblock #. type: textblock -#: dh_systemd_enable:63 +#: dh_systemd_enable:62 #, fuzzy #| msgid "" #| "If this exists, it is installed into etc/init/I<package>.conf in the " #| "package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.socket " -"(or lib/systemd/system/I<package>@.socket) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"socket >> (or F<< lib/systemd/system/I<package>@.socket >>) in the package " +"build directory." msgstr "" "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " "construcción del paquete." #. type: =item -#: dh_systemd_enable:66 +#: dh_systemd_enable:65 #, fuzzy #| msgid "debian/I<package>.menu" msgid "debian/I<package>.mount" @@ -11962,20 +12532,20 @@ msgstr "debian/I<paquete>.menu" # type: textblock #. type: textblock -#: dh_systemd_enable:68 +#: dh_systemd_enable:67 #, fuzzy #| msgid "" #| "If this exists, it is installed into etc/init/I<package>.conf in the " #| "package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.mount in " -"the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.mount " +">> in the package build directory." msgstr "" "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " "construcción del paquete." #. type: =item -#: dh_systemd_enable:71 +#: dh_systemd_enable:70 #, fuzzy #| msgid "debian/I<package>.manpages" msgid "debian/I<package>.path, debian/I<package>@.path" @@ -11983,20 +12553,21 @@ msgstr "debian/I<paquete>.manpages" # type: textblock #. type: textblock -#: dh_systemd_enable:73 +#: dh_systemd_enable:72 #, fuzzy #| msgid "" #| "If this exists, it is installed into etc/init/I<package>.conf in the " #| "package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.path (or " -"lib/systemd/system/I<package>@.path) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.path " +">> (or F<< lib/systemd/system/I<package>@.path >>) in the package build " +"directory." msgstr "" "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " "construcción del paquete." #. type: =item -#: dh_systemd_enable:76 +#: dh_systemd_enable:75 #, fuzzy #| msgid "debian/I<package>.manpages" msgid "debian/I<package>.timer, debian/I<package>@.timer" @@ -12004,25 +12575,26 @@ msgstr "debian/I<paquete>.manpages" # type: textblock #. type: textblock -#: dh_systemd_enable:78 +#: dh_systemd_enable:77 #, fuzzy #| msgid "" #| "If this exists, it is installed into etc/init/I<package>.conf in the " #| "package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.timer (or " -"lib/systemd/system/I<package>@.timer) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.timer " +">> (or F<< lib/systemd/system/I<package>@.timer >>) in the package build " +"directory." msgstr "" "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " "construcción del paquete." #. type: textblock -#: dh_systemd_enable:89 +#: dh_systemd_enable:88 msgid "Disable the service(s) on purge, but do not enable them on install." msgstr "" #. type: textblock -#: dh_systemd_enable:91 +#: dh_systemd_enable:90 msgid "" "B<Note> that this option does not affect whether the services are started. " "That is controlled by L<dh_systemd_start(1)> (using e.g. its B<--no-start> " @@ -12031,7 +12603,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_systemd_enable:97 +#: dh_systemd_enable:96 #, fuzzy #| msgid "" #| "Install the init script (and default file) as well as upstart job file " @@ -12057,7 +12629,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_systemd_enable:106 dh_systemd_start:70 +#: dh_systemd_enable:105 dh_systemd_start:70 #, fuzzy #| msgid "" #| "Note that this command is not idempotent. L<dh_prep(1)> should be called " @@ -12074,7 +12646,7 @@ msgstr "" "desarrollador contengan partes duplicadas." #. type: textblock -#: dh_systemd_enable:111 +#: dh_systemd_enable:110 msgid "" "Note that B<dh_systemd_enable> should be run before B<dh_installinit>. The " "default sequence in B<dh> does the right thing, this note is only relevant " @@ -12082,12 +12654,12 @@ msgid "" msgstr "" #. type: textblock -#: dh_systemd_enable:283 +#: dh_systemd_enable:282 msgid "L<dh_systemd_start(1)>, L<debhelper(7)>" msgstr "" #. type: textblock -#: dh_systemd_enable:287 dh_systemd_start:286 +#: dh_systemd_enable:286 dh_systemd_start:286 msgid "pkg-systemd-maintainers@lists.alioth.debian.org" msgstr "" @@ -12211,6 +12783,119 @@ msgstr "" "Este nivel de compatibilidad aún está en desarrollo, utilÃcelo con " "precaución." +# type: textblock +#, fuzzy +#~| msgid "" +#~| "Set to B<1> to enable verbose mode. Debhelper will output every command " +#~| "it runs that modifies files on the build system." +#~ msgid "" +#~ "Set to B<1> to enable verbose mode. Debhelper will output every command " +#~ "it runs. Also enables verbose build logs for some build systems like " +#~ "autoconf." +#~ msgstr "" +#~ "Defina como B<1> para activar el modo explicativo. Debhelper mostrará " +#~ "todas las órdenes utilizadas que modifiquen ficheros en el sistema en el " +#~ "que se hace la construcción." + +# type: textblock +#, fuzzy +#~| msgid "" +#~| "If this exists, it is installed into etc/init/I<package>.conf in the " +#~| "package build directory." +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.) Only used in compat levels 10 and below." +#~ msgstr "" +#~ "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " +#~ "construcción del paquete." + +# type: textblock +#, fuzzy +#~| msgid "" +#~| "If this exists, it is installed into etc/init/I<package>.conf in the " +#~| "package build directory." +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.)" +#~ msgstr "" +#~ "Si existe, se instala en «etc/init/I<paquete>.conf» en el directorio de " +#~ "construcción del paquete." + +# type: textblock +#, fuzzy +#~| msgid "dh_gconf - install GConf defaults files and register schemas" +#~ msgid "" +#~ "dh_gconf - install GConf defaults files and register schemas (deprecated)" +#~ msgstr "" +#~ "dh_gconf - Instala ficheros de valores predeterminados de GConf y " +#~ "registra esquemas" + +# type: textblock +#~ msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" +#~ msgstr "B<dh_gconf> [S<I<opciones-de-debhelper>>] [B<--priority=>I<número>]" + +# type: textblock +#~ msgid "" +#~ "B<dh_gconf> is a debhelper program that is responsible for installing " +#~ "GConf defaults files and registering GConf schemas." +#~ msgstr "" +#~ "B<dh_gconf> es un programa de debhelper responsable de la instalación de " +#~ "ficheros de valores predeterminados de GConf («defaults») y de registrar " +#~ "esquemas de GConf." + +#~ msgid "" +#~ "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}" +#~ ">." +#~ msgstr "" +#~ "Se generará una dependencia apropiada sobre gconf2 en B<${misc:Depends}>." + +#~ msgid "debian/I<package>.gconf-defaults" +#~ msgstr "debian/I<paquete>.gconf-defaults" + +# type: textblock +#~ msgid "" +#~ "Installed into F<usr/share/gconf/defaults/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "Se instala en F<usr/share/gconf/defaults/10_paquete> en el directorio de " +#~ "construcción del paquete, reemplazando I<paquete> por el nombre del " +#~ "paquete." + +#~ msgid "debian/I<package>.gconf-mandatory" +#~ msgstr "debian/I<paquete>.gconf-mandatory" + +# type: textblock +#~ msgid "" +#~ "Installed into F<usr/share/gconf/mandatory/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "Se instala en F<usr/share/gconf/mandatory/10_paquete> en el directorio de " +#~ "construcción del paquete, reemplazando I<paquete> por el nombre del " +#~ "paquete." + +# type: =item +#~ msgid "B<--priority> I<priority>" +#~ msgstr "B<--priority> I<prioridad>" + +# type: textblock +#~ msgid "" +#~ "Use I<priority> (which should be a 2-digit number) as the defaults " +#~ "priority instead of B<10>. Higher values than ten can be used by derived " +#~ "distributions (B<20>), CDD distributions (B<50>), or site-specific " +#~ "packages (B<90>)." +#~ msgstr "" +#~ "Utiliza I<prioridad> (que deberÃa ser un número de dos dÃgitos) como la " +#~ "prioridad predeterminada, en lugar de 10. Otros pueden utilizar valores " +#~ "superiores a B<10>, como las distribuciones derivadas (B<20>), " +#~ "distribuciones de Debian personalizadas CDD (B<50>) y paquetes de sitios " +#~ "web especÃficos (B<90>)." + +# type: textblock +#~ msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" +#~ msgstr "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" + # type: textblock #, fuzzy #~| msgid "" @@ -13182,10 +13867,10 @@ msgstr "" #~ "\n" #~ msgid "" -#~ "Note that in the example above, dh will arrange for \"debian/rules build" -#~ "\" to call your build-indep and build-arch targets. You do no need to " -#~ "explicitly define those dependencies in the rules file when using dh with " -#~ "compatibility level v9. This example would be more complicated with " +#~ "Note that in the example above, dh will arrange for \"debian/rules " +#~ "build\" to call your build-indep and build-arch targets. You do no need " +#~ "to explicitly define those dependencies in the rules file when using dh " +#~ "with compatibility level v9. This example would be more complicated with " #~ "earlier compatibility levels." #~ msgstr "" #~ "Tenga en cuenta que en el ejemplo anterior, dh hace que «debian/rules " @@ -13209,10 +13894,10 @@ msgstr "" #~ "definir manualmente las dependencias entre objetivos de ese fichero." #~ msgid "" -#~ "Note that in the example above, dh will arrange for \"debian/rules build" -#~ "\" to call your build-indep and build-arch targets. You do no need to " -#~ "explicitly define the dependencies in the rules file when using dh with " -#~ "compatibility level v9. This example would be more complicated with " +#~ "Note that in the example above, dh will arrange for \"debian/rules " +#~ "build\" to call your build-indep and build-arch targets. You do no need " +#~ "to explicitly define the dependencies in the rules file when using dh " +#~ "with compatibility level v9. This example would be more complicated with " #~ "earlier compatibility levels." #~ msgstr "" #~ "Tenga en cuenta que en el ejemplo anterior, dh hace que «debian/rules " diff --git a/man/po4a/po/fr.po b/man/po4a/po/fr.po index b0adcf60008a8905666da5b5f54dccede6c3683a..4402d365cbc7125ff1db262018b0d4710e083122 100644 --- a/man/po4a/po/fr.po +++ b/man/po4a/po/fr.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: debhelper manpages\n" -"POT-Creation-Date: 2021-01-31 23:36+0100\n" +"POT-Creation-Date: 2022-11-20 19:46+0100\n" "PO-Revision-Date: 2021-02-13 10:02+0100\n" "Last-Translator: Jean-Pierre Giraud <jean-pierregiraud@neuf.fr>\n" "Language-Team: French <debian-l10n-french@lists.debian.org>\n" @@ -19,10 +19,11 @@ msgstr "" # type: =head1 #. type: =head1 -#: debhelper.pod:3 debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 -#: dh_auto_clean:3 dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 -#: dh_bugfiles:3 dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 -#: dh_gconf:3 dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 +#: debhelper.pod:3 debhelper-compat-upgrade-checklist.pod:3 +#: debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 dh_auto_clean:3 +#: dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 dh_bugfiles:3 +#: dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 +#: dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 #: dh_installchangelogs:3 dh_installcron:3 dh_installdeb:3 dh_installdebconf:3 #: dh_installdirs:3 dh_installdocs:5 dh_installemacsen:3 dh_installexamples:5 #: dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installinitramfs:3 @@ -44,19 +45,20 @@ msgstr "debhelper - Ensemble d'outils regroupés sous le nom de debhelper" # type: =head1 #. type: =head1 -#: debhelper.pod:7 debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 -#: dh_auto_clean:16 dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 -#: dh_bugfiles:15 dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 -#: dh_fixperms:16 dh_gconf:15 dh_gencontrol:16 dh_icons:16 dh_install:15 -#: dh_installcatalogs:17 dh_installchangelogs:15 dh_installcron:15 -#: dh_installdeb:15 dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 +#: debhelper.pod:7 debhelper-compat-upgrade-checklist.pod:7 +#: debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 dh_auto_clean:16 +#: dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 dh_bugfiles:15 +#: dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 dh_fixperms:16 +#: dh_gencontrol:16 dh_icons:16 dh_install:15 dh_installcatalogs:17 +#: dh_installchangelogs:16 dh_installcron:15 dh_installdeb:15 +#: dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 #: dh_installemacsen:15 dh_installexamples:17 dh_installifupdown:15 #: dh_installinfo:15 dh_installinit:16 dh_installinitramfs:15 #: dh_installlogcheck:15 dh_installlogrotate:15 dh_installman:16 #: dh_installmanpages:16 dh_installmenu:15 dh_installmime:15 #: dh_installmodules:16 dh_installpam:15 dh_installppp:15 dh_installudev:15 #: dh_installwm:15 dh_installxfonts:15 dh_link:16 dh_lintian:15 -#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:17 +#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:18 #: dh_prep:15 dh_shlibdeps:17 dh_strip:16 dh_testdir:15 dh_testroot:9 #: dh_usrlocal:19 dh_systemd_enable:16 dh_systemd_start:17 msgid "SYNOPSIS" @@ -74,19 +76,19 @@ msgstr "" # type: =head1 #. type: =head1 -#: debhelper.pod:11 dh:26 dh_auto_build:20 dh_auto_clean:20 -#: dh_auto_configure:20 dh_auto_install:22 dh_auto_test:20 dh_bugfiles:19 -#: dh_builddeb:21 dh_clean:19 dh_compress:21 dh_dwz:20 dh_fixperms:20 -#: dh_gconf:19 dh_gencontrol:20 dh_icons:20 dh_install:19 dh_installcatalogs:21 -#: dh_installchangelogs:19 dh_installcron:19 dh_installdeb:19 -#: dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 +#: debhelper.pod:11 debhelper-compat-upgrade-checklist.pod:17 dh:26 +#: dh_auto_build:20 dh_auto_clean:20 dh_auto_configure:20 dh_auto_install:22 +#: dh_auto_test:20 dh_bugfiles:19 dh_builddeb:21 dh_clean:19 dh_compress:21 +#: dh_dwz:20 dh_fixperms:20 dh_gencontrol:20 dh_icons:20 dh_install:19 +#: dh_installcatalogs:21 dh_installchangelogs:20 dh_installcron:19 +#: dh_installdeb:19 dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 #: dh_installemacsen:19 dh_installexamples:21 dh_installifupdown:19 #: dh_installinfo:19 dh_installinit:20 dh_installinitramfs:19 #: dh_installlogcheck:19 dh_installlogrotate:19 dh_installman:20 #: dh_installmanpages:20 dh_installmenu:19 dh_installmime:19 #: dh_installmodules:20 dh_installpam:19 dh_installppp:19 dh_installudev:19 #: dh_installwm:19 dh_installxfonts:19 dh_link:20 dh_lintian:19 -#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:21 +#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:22 #: dh_prep:19 dh_shlibdeps:21 dh_strip:20 dh_testdir:19 dh_testroot:13 #: dh_usrlocal:23 dh_systemd_enable:20 dh_systemd_start:21 msgid "DESCRIPTION" @@ -694,21 +696,36 @@ msgstr "B<-v>, B<--verbose>" # type: textblock #. type: textblock #: debhelper.pod:277 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." +msgid "Verbose mode: show commands that modify the package build directory." +msgstr "" +"Mode verbeux : affiche toutes les commandes qui modifient le répertoire de " +"construction du paquet." + +# type: textblock +#. type: textblock +#: debhelper.pod:279 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." msgid "" -"Verbose mode: show all commands that modify the package build directory." +"Note that verbose mode may also output other \"internal\" commands that do " +"not directly affect the package build directory." msgstr "" "Mode verbeux : affiche toutes les commandes qui modifient le répertoire de " "construction du paquet." # type: =item #. type: =item -#: debhelper.pod:279 dh:266 +#: debhelper.pod:282 dh:307 msgid "B<--no-act>" msgstr "B<--no-act>" # type: textblock #. type: textblock -#: debhelper.pod:281 +#: debhelper.pod:284 msgid "" "Do not really do anything. If used with -v, the result is that the command " "will output what it would have done." @@ -719,13 +736,13 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:284 +#: debhelper.pod:287 msgid "B<-a>, B<--arch>" msgstr "B<-a>, B<--arch>" # type: textblock #. type: textblock -#: debhelper.pod:286 +#: debhelper.pod:289 msgid "" "Act on architecture dependent packages that should be built for the " "B<DEB_HOST_ARCH> architecture." @@ -734,25 +751,25 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:289 +#: debhelper.pod:292 msgid "B<-i>, B<--indep>" msgstr "B<-i>, B<--indep>" # type: textblock #. type: textblock -#: debhelper.pod:291 +#: debhelper.pod:294 msgid "Act on all architecture independent packages." msgstr "Construit tous les paquets indépendants de l'architecture." # type: =item #. type: =item -#: debhelper.pod:293 +#: debhelper.pod:296 msgid "B<-p>I<package>, B<--package=>I<package>" msgstr "B<-p>I<paquet>, B<--package=>I<paquet>" # type: textblock #. type: textblock -#: debhelper.pod:295 +#: debhelper.pod:298 msgid "" "Act on the package named I<package>. This option may be specified multiple " "times to make debhelper operate on a given set of packages." @@ -762,29 +779,29 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:298 +#: debhelper.pod:301 msgid "B<-s>, B<--same-arch>" msgstr "B<-s>, B<--same-arch>" #. type: textblock -#: debhelper.pod:300 +#: debhelper.pod:303 msgid "Deprecated alias of B<-a>." msgstr "Alias obsolète pour B<-a>." #. type: textblock -#: debhelper.pod:302 dh_install:80 dh_install:89 +#: debhelper.pod:305 dh_install:80 dh_install:89 msgid "This option is removed in compat 12." msgstr "Cette option est supprimée dans le niveau de compatibilité 12." # type: =item #. type: =item -#: debhelper.pod:304 +#: debhelper.pod:307 msgid "B<-N>I<package>, B<--no-package=>I<package>" msgstr "B<-N>I<paquet>, B<--no-package=>I<paquet>" # type: textblock #. type: textblock -#: debhelper.pod:306 +#: debhelper.pod:309 msgid "" "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option " "lists the package as one that should be acted on." @@ -794,12 +811,12 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:309 +#: debhelper.pod:312 msgid "B<--remaining-packages>" msgstr "B<--remaining-packages>" #. type: textblock -#: debhelper.pod:311 +#: debhelper.pod:314 msgid "" "Do not act on the packages which have already been acted on by this " "debhelper command earlier (i.e. if the command is present in the package " @@ -817,13 +834,13 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:317 +#: debhelper.pod:320 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" msgstr "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" # type: textblock #. type: textblock -#: debhelper.pod:319 +#: debhelper.pod:322 msgid "" "Use I<tmpdir> for package build directory. The default is debian/I<package>" msgstr "" @@ -832,13 +849,13 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:321 +#: debhelper.pod:324 msgid "B<--mainpackage=>I<package>" msgstr "B<--mainpackage=>I<paquet>" # type: textblock #. type: textblock -#: debhelper.pod:323 +#: debhelper.pod:326 msgid "" "This little-used option changes the package which debhelper considers the " "\"main package\", that is, the first one listed in F<debian/control>, and " @@ -852,12 +869,12 @@ msgstr "" "fichier F<debian/control>." #. type: =item -#: debhelper.pod:328 +#: debhelper.pod:331 msgid "B<-O=>I<option>|I<bundle>" msgstr "B<-O=>I<option>|I<ensemble>" #. type: textblock -#: debhelper.pod:330 +#: debhelper.pod:333 msgid "" "This is used by L<dh(1)> when passing user-specified options to all the " "commands it runs. If the command supports the specified option or option " @@ -872,13 +889,13 @@ msgstr "" # type: =head1 #. type: =head1 -#: debhelper.pod:337 +#: debhelper.pod:340 msgid "COMMON DEBHELPER OPTIONS" msgstr "OPTIONS COURANTES DE DEBHELPER" # type: textblock #. type: textblock -#: debhelper.pod:339 +#: debhelper.pod:342 msgid "" "The following command line options are supported by some debhelper " "programs. See the man page of each program for a complete explanation of " @@ -890,13 +907,13 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:345 +#: debhelper.pod:348 msgid "B<-n>" msgstr "B<-n>" # type: textblock #. type: textblock -#: debhelper.pod:347 +#: debhelper.pod:350 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts." msgstr "" "Ne pas modifier les scripts de maintenance du paquet (F<postinst>, " @@ -904,15 +921,15 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:349 dh_compress:56 dh_dwz:56 dh_installchangelogs:83 -#: dh_installdocs:109 dh_installexamples:80 dh_link:78 dh_makeshlibs:154 +#: debhelper.pod:352 dh_compress:56 dh_dwz:56 dh_installchangelogs:89 +#: dh_installdocs:109 dh_installexamples:84 dh_link:78 dh_makeshlibs:154 #: dh_md5sums:40 dh_shlibdeps:34 dh_strip:42 msgid "B<-X>I<item>, B<--exclude=>I<item>" msgstr "B<-X>I<élément>, B<--exclude=>I<élément>" # type: textblock #. type: textblock -#: debhelper.pod:351 +#: debhelper.pod:354 msgid "" "Exclude an item from processing. This option may be used multiple times, to " "exclude more than one thing. The I<item> is typically part of a filename, " @@ -925,15 +942,15 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:355 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 -#: dh_installdocs:104 dh_installexamples:48 dh_installinfo:45 dh_installman:90 +#: debhelper.pod:358 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 +#: dh_installdocs:104 dh_installexamples:52 dh_installinfo:45 dh_installman:90 #: dh_installwm:55 dh_link:73 msgid "B<-A>, B<--all>" msgstr "B<-A>, B<--all>" # type: textblock #. type: textblock -#: debhelper.pod:357 +#: debhelper.pod:360 msgid "" "Makes files or other items that are specified on the command line take " "effect in ALL packages acted on, not just the first." @@ -943,12 +960,12 @@ msgstr "" "premier." #. type: =head1 -#: debhelper.pod:362 +#: debhelper.pod:365 msgid "BUILD SYSTEM OPTIONS" msgstr "OPTIONS DU PROCESSUS DE CONSTRUCTION" #. type: textblock -#: debhelper.pod:364 +#: debhelper.pod:367 msgid "" "The following command line options are supported by all of the " "B<dh_auto_>I<*> debhelper programs. These programs support a variety of " @@ -966,14 +983,14 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:373 +#: debhelper.pod:376 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>" msgstr "" "B<-S>I<processus de construction>, B<--" "buildsystem=>I<processus_de_construction>" #. type: textblock -#: debhelper.pod:375 +#: debhelper.pod:378 msgid "" "Force use of the specified I<buildsystem>, instead of trying to auto-select " "one which might be applicable for the package." @@ -982,7 +999,7 @@ msgstr "" "déterminer automatiquement celui qui pourrait être utilisable pour le paquet." #. type: textblock -#: debhelper.pod:378 +#: debhelper.pod:381 msgid "Pass B<none> as I<buildsystem> to disable auto-selection." msgstr "" "Indique B<none> comme I<buildsystem> pour désactiver la sélection " @@ -990,7 +1007,7 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:380 +#: debhelper.pod:383 msgid "" "B<-D>I<directory>, B<--sourcedir=>I<directory>, B<--" "sourcedirectory=>I<directory>" @@ -999,7 +1016,7 @@ msgstr "" "sourcedirectory=>I<répertoire>" #. type: textblock -#: debhelper.pod:382 +#: debhelper.pod:385 msgid "" "Assume that the original package source tree is at the specified " "I<directory> rather than the top level directory of the Debian source " @@ -1009,7 +1026,7 @@ msgstr "" "indiqué plutôt qu'au plus haut niveau de l'arborescence du paquet source." #. type: textblock -#: debhelper.pod:386 +#: debhelper.pod:389 msgid "" "B<Warning>: The B<--sourcedir> variant matches a similar named option in " "B<dh_install> and B<dh_missing> (etc.) for historical reasons. While they " @@ -1025,7 +1042,7 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:392 +#: debhelper.pod:395 msgid "" "B<-B>[I<directory>], B<--builddir>[I<=directory>], B<--" "builddirectory>[I<=directory>]" @@ -1034,7 +1051,7 @@ msgstr "" "builddirectory=>[I<répertoire>]" #. type: textblock -#: debhelper.pod:394 +#: debhelper.pod:397 msgid "" "Enable out of source building and use the specified I<directory> as the " "build directory. If I<directory> parameter is omitted, a default build " @@ -1046,7 +1063,7 @@ msgstr "" "sera choisi." #. type: textblock -#: debhelper.pod:398 +#: debhelper.pod:401 msgid "" "If this option is not specified, building will be done in source by default " "unless the build system requires or prefers out of source tree building. In " @@ -1059,7 +1076,7 @@ msgstr "" "utilisé même si B<--builddirectory> n'est pas indiqué." #. type: textblock -#: debhelper.pod:403 +#: debhelper.pod:406 msgid "" "If the build system prefers out of source tree building but still allows in " "source building, the latter can be re-enabled by passing a build directory " @@ -1073,12 +1090,12 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:407 +#: debhelper.pod:410 msgid "B<--parallel>, B<--no-parallel>" msgstr "B<--parallel>, B<--no-parallel>" #. type: textblock -#: debhelper.pod:409 +#: debhelper.pod:412 msgid "" "Control whether parallel builds should be used if underlying build system " "supports them. The number of parallel jobs is controlled by the " @@ -1092,7 +1109,7 @@ msgstr "" "limites spécifiques du système de construction." #. type: textblock -#: debhelper.pod:415 +#: debhelper.pod:418 msgid "" "If neither option is specified, debhelper currently defaults to B<--" "parallel> in compat 10 (or later) and B<--no-parallel> otherwise." @@ -1102,7 +1119,7 @@ msgstr "" "supérieur), et la désactive (B<--no-parallel>) dans les autres niveaux." #. type: textblock -#: debhelper.pod:418 +#: debhelper.pod:421 msgid "" "As an optimization, B<dh> will try to avoid passing these options to " "subprocesses, if they are unnecessary and the only options passed. Notably " @@ -1115,12 +1132,12 @@ msgstr "" "pas de paramètre I<parallel> (ou si sa valeur est B<1>)." #. type: =item -#: debhelper.pod:423 +#: debhelper.pod:426 msgid "B<--max-parallel=>I<maximum>" msgstr "B<--max-parallel=>I<maximum>" #. type: textblock -#: debhelper.pod:425 +#: debhelper.pod:428 msgid "" "This option implies B<--parallel> and allows further limiting the number of " "jobs that can be used in a parallel build. If the package build is known to " @@ -1134,7 +1151,7 @@ msgstr "" "censée fonctionner, ou que vous souhaitez mettre en Å“uvre." #. type: textblock -#: debhelper.pod:430 +#: debhelper.pod:433 msgid "" "Notably, setting the maximum to 1 is effectively the same as using B<--no-" "parallel>." @@ -1143,23 +1160,28 @@ msgstr "" "parallel>." #. type: =item -#: debhelper.pod:433 +#: debhelper.pod:436 msgid "B<--reload-all-buildenv-variables>" msgstr "B<--reload-all-buildenv-variables>" #. type: textblock -#: debhelper.pod:435 +#: debhelper.pod:438 +#, fuzzy +#| msgid "" +#| "By default, L<dh(1)> will compute several environment (e.g. by using " +#| "L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> " +#| "tool recompute them." msgid "" -"By default, L<dh(1)> will compute several environment (e.g. by using L<dpkg-" -"buildflags(1)>) and cache them to avoid having all B<dh_auto_*> tool " -"recompute them." +"By default, L<dh(1)> will compute several environment variables (e.g. by " +"using L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> " +"tool recompute them." msgstr "" "Par défaut, L<dh(1)> calculera plusieurs environnements (par exemple en " "utilisant L<dpkg-buildflags(1)>) et les met en cache pour éviter que tous " "les outils B<dh_auto_*> les recalculent." #. type: textblock -#: debhelper.pod:439 +#: debhelper.pod:442 msgid "" "When passing this option, the concrete B<dh_auto_*> tool will ignore the " "cache from L<dh(1)> and retrigger a rebuild of these variables. This is " @@ -1173,8 +1195,9 @@ msgstr "" "mais avec des options B<...FLAGS> différentes. Un exemple concret pourrait " "être la nécessité de modifier le paramètre B<-0> dans B<CFLAGS> dans la " "seconde construction." + #. type: verbatim -#: debhelper.pod:446 +#: debhelper.pod:449 #, no-wrap msgid "" " export DEB_CFLAGS_MAINT_APPEND=-O3\n" @@ -1184,7 +1207,7 @@ msgstr "" "\n" #. type: verbatim -#: debhelper.pod:448 +#: debhelper.pod:451 #, no-wrap msgid "" " %:\n" @@ -1196,7 +1219,7 @@ msgstr "" "\n" #. type: verbatim -#: debhelper.pod:451 +#: debhelper.pod:454 #, no-wrap msgid "" " override_dh_auto_configure:\n" @@ -1212,7 +1235,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:456 +#: debhelper.pod:459 msgid "" "Without B<--reload-all-buildenv-variables> in the second call to " "L<dh_auto_configure(1)>, the change in B<DEB_CFLAGS_MAINT_APPEND> would be " @@ -1225,7 +1248,7 @@ msgstr "" "valeur mise en cache de B<CFLAGS> fixée par L<dh(1)>." #. type: textblock -#: debhelper.pod:461 +#: debhelper.pod:464 msgid "" "This option is only available with B<< debhelper (>= 12.7~) >> when the " "package uses compatibility level 9 or later." @@ -1235,12 +1258,12 @@ msgstr "" # type: =item #. type: =item -#: debhelper.pod:464 dh:258 +#: debhelper.pod:467 dh:299 msgid "B<--list>, B<-l>" msgstr "B<--list>, B<-l>" #. type: textblock -#: debhelper.pod:466 +#: debhelper.pod:469 msgid "" "List all build systems supported by debhelper on this system. The list " "includes both default and third party build systems (marked as such). Also " @@ -1254,13 +1277,13 @@ msgstr "" "l'option B<--buildsystem>." #. type: =head1 -#: debhelper.pod:473 +#: debhelper.pod:476 msgid "COMPATIBILITY LEVELS" msgstr "NIVEAUX DE COMPATIBILITÉ" # type: textblock #. type: textblock -#: debhelper.pod:475 +#: debhelper.pod:478 msgid "" "From time to time, major non-backwards-compatible changes need to be made to " "debhelper, to keep it clean and well-designed as needs change and its author " @@ -1280,7 +1303,7 @@ msgstr "" # type: textblock #. type: textblock -#: debhelper.pod:482 +#: debhelper.pod:485 msgid "" "In current debhelper, you can specify the compatibility level in F<debian/" "control> by adding a Build-Depends on the debhelper-compat package. For " @@ -1294,7 +1317,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: debhelper.pod:486 +#: debhelper.pod:489 #, no-wrap msgid "" " Build-Depends: debhelper-compat (= #RECOMMENDED_COMPAT#)\n" @@ -1304,7 +1327,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:488 +#: debhelper.pod:491 msgid "" "This also serves as an appropriate versioned build dependency on a " "sufficient version of the debhelper package, so you do not need to specify a " @@ -1320,29 +1343,47 @@ msgstr "" "de compatibilité)." #. type: textblock -#: debhelper.pod:494 +#: debhelper.pod:497 +#, fuzzy +#| msgid "" +#| "Note that debhelper does not provide debhelper-compat for experimental or " +#| "beta compatibility levels; packages experimenting with those " +#| "compatibility levels should use F<debian/compat> or B<DH_COMPAT>." msgid "" "Note that debhelper does not provide debhelper-compat for experimental or " "beta compatibility levels; packages experimenting with those compatibility " -"levels should use F<debian/compat> or B<DH_COMPAT>." +"levels should use F<debian/compat> (or, if only for selected commands, " +"B<DH_COMPAT>)." msgstr "" "Veuillez noter que debhelper ne fournit pas debhelper-compat pour " "experimental ou pour les niveaux en version bêta. Les paquets qui souhaitent " "expérimenter avec cela devraient utiliser F<debian/compat> ou B<DH_COMPAT>." #. type: textblock -#: debhelper.pod:498 +#: debhelper.pod:501 +#, fuzzy +#| msgid "" +#| "Prior versions of debhelper required specifying the compatibility level " +#| "in the file F<debian/compat>, and current debhelper still supports this " +#| "for backward compatibility, though a package may not specify a " +#| "compatibility level via multiple methods at once. To use this method, " +#| "F<debian/compat> should contain the compatibility level as a single " +#| "number, and no other content. If you specify the compatibility level by " +#| "this method, your package will also need a versioned build dependency on " +#| "a version of the debhelper package equal to (or greater than) the " +#| "compatibility level your package uses. So, if you specify compatibility " +#| "level #RECOMMENDED_COMPAT# in F<debian/compat>, ensure F<debian/control> " +#| "has:" msgid "" "Prior versions of debhelper required specifying the compatibility level in " "the file F<debian/compat>, and current debhelper still supports this for " -"backward compatibility, though a package may not specify a compatibility " -"level via multiple methods at once. To use this method, F<debian/compat> " -"should contain the compatibility level as a single number, and no other " -"content. If you specify the compatibility level by this method, your package " -"will also need a versioned build dependency on a version of the debhelper " -"package equal to (or greater than) the compatibility level your package " -"uses. So, if you specify compatibility level #RECOMMENDED_COMPAT# in " -"F<debian/compat>, ensure F<debian/control> has:" +"backward compatibility. To use this method, the F<debian/compat> file should " +"contain the compatibility level as a single number, and no other content. If " +"you specify the compatibility level by this method, your package will also " +"need a versioned build dependency on a version of the debhelper package " +"equal to (or greater than) the compatibility level your package uses. So, if " +"you specify compatibility level #RECOMMENDED_COMPAT# in F<debian/compat>, " +"ensure F<debian/control> has:" msgstr "" "Les versions précédentes de debhelper nécessitaient d'indiquer le niveau de " "compatibilité dans le fichier F<debian/compat>, et la version actuelle " @@ -1358,7 +1399,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: debhelper.pod:509 +#: debhelper.pod:511 #, no-wrap msgid "" " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#~)\n" @@ -1367,9 +1408,29 @@ msgstr "" " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#~)\n" "\n" +#. type: textblock +#: debhelper.pod:513 +msgid "" +"Note that you must use either the build-dependency on debhelper-compat or " +"the F<debian/compat> file. Whenever possible, the debhelper-compat build-" +"dependency is recommended." +msgstr "" + +#. type: textblock +#: debhelper.pod:517 +msgid "" +"If needed be, the B<DH_COMPAT> environment variable can be used to override " +"the compat level for a given command. The feature is mostly useful for " +"either temporarily upgrading a few commands to a new compat level or keeping " +"a few commands on a lower compat level. The feature is best used sparingly " +"as it effectively introduces special-cases into the F<debian/rules> file " +"that may be surprising to maintainers or reviewers (or, in the long term, to " +"yourself)." +msgstr "" + # type: textblock #. type: textblock -#: debhelper.pod:511 +#: debhelper.pod:525 msgid "" "Unless otherwise indicated, all debhelper documentation assumes that you are " "using the most recent compatibility level, and in most cases does not " @@ -1387,1192 +1448,1457 @@ msgstr "" # type: =head2 #. type: =head2 -#: debhelper.pod:518 +#: debhelper.pod:532 msgid "Supported compatibility levels" msgstr "Niveaux de compatibilité pris en charge" -# type: textblock -#. type: textblock -#: debhelper.pod:520 -msgid "These are the available compatibility levels:" -msgstr "Les niveaux de compatibilité sont les suivants :" - -#. type: =item -#: debhelper.pod:524 debhelper-obsolete-compat.pod:89 -msgid "v5" -msgstr "v5" - -# type: textblock -#. type: textblock -#: debhelper.pod:526 debhelper-obsolete-compat.pod:91 -msgid "This is the lowest supported compatibility level." -msgstr "C'est le niveau de compatibilité le plus bas pris en charge." - #. type: textblock -#: debhelper.pod:528 +#: debhelper.pod:534 msgid "" -"If you are upgrading from an earlier compatibility level, please review " -"L<debhelper-obsolete-compat(7)>." +"The list of supported compatibility levels and the related upgrade check " +"list has moved to L<debhelper-compat-upgrade-checklist(7)>." msgstr "" -"Si vous mettez à jour depuis un niveau de compatibilité antérieur, veuillez " -"consulter L<debhelper-obsolete-compat(7)>." -# type: textblock -#. type: textblock -#: debhelper.pod:531 debhelper.pod:563 debhelper.pod:593 debhelper.pod:624 -#: debhelper.pod:685 debhelper-obsolete-compat.pod:28 -#: debhelper-obsolete-compat.pod:35 debhelper-obsolete-compat.pod:58 -#: debhelper-obsolete-compat.pod:87 -msgid "This mode is deprecated." -msgstr "Ce mode est déconseillé." +# type: =head1 +#. type: =head1 +#: debhelper.pod:537 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 +#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:96 +#: dh_installinit:204 dh_installinitramfs:60 dh_installman:131 +#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 +#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:103 +#: dh_systemd_start:68 +msgid "NOTES" +msgstr "REMARQUES" -#. type: =item -#: debhelper.pod:533 -msgid "v6" -msgstr "v6" +# type: =head2 +#. type: =head2 +#: debhelper.pod:539 +msgid "Multiple binary package support" +msgstr "Prise en charge de plusieurs paquets binaires" # type: textblock #. type: textblock -#: debhelper.pod:535 -msgid "Changes from v5 are:" -msgstr "Les changements par rapport à la version 5 sont :" - -# type: =item -#. type: =item -#: debhelper.pod:539 debhelper.pod:544 debhelper.pod:550 debhelper.pod:556 -#: debhelper.pod:571 debhelper.pod:578 debhelper.pod:582 debhelper.pod:586 -#: debhelper.pod:601 debhelper.pod:605 debhelper.pod:613 debhelper.pod:618 -#: debhelper.pod:632 debhelper.pod:637 debhelper.pod:644 debhelper.pod:649 -#: debhelper.pod:654 debhelper.pod:662 debhelper.pod:668 debhelper.pod:673 -#: debhelper.pod:678 debhelper.pod:693 debhelper.pod:698 debhelper.pod:704 -#: debhelper.pod:710 debhelper.pod:715 debhelper.pod:721 debhelper.pod:730 -#: debhelper.pod:740 debhelper.pod:746 debhelper.pod:769 debhelper.pod:776 -#: debhelper.pod:782 debhelper.pod:788 debhelper.pod:794 debhelper.pod:823 -#: debhelper.pod:829 debhelper.pod:841 debhelper.pod:849 debhelper.pod:855 -#: debhelper.pod:860 debhelper.pod:865 debhelper.pod:870 debhelper.pod:878 -#: debhelper.pod:888 debhelper.pod:898 debhelper.pod:905 debhelper.pod:917 -#: debhelper.pod:922 debhelper.pod:950 debhelper.pod:967 debhelper.pod:977 -#: debhelper.pod:981 debhelper.pod:986 debhelper.pod:991 debhelper.pod:998 -#: debhelper.pod:1004 debhelper.pod:1012 debhelper.pod:1018 debhelper.pod:1022 -#: debhelper.pod:1027 debhelper.pod:1032 debhelper.pod:1041 debhelper.pod:1057 -#: debhelper.pod:1064 debhelper.pod:1080 debhelper.pod:1088 debhelper.pod:1093 -#: debhelper.pod:1108 debhelper.pod:1116 debhelper.pod:1124 debhelper.pod:1133 -#: debhelper.pod:1139 debhelper.pod:1149 debhelper.pod:1157 debhelper.pod:1163 -#: debhelper.pod:1177 debhelper.pod:1188 debhelper.pod:1202 debhelper.pod:1213 -#: debhelper.pod:1231 debhelper.pod:1245 debhelper-obsolete-compat.pod:43 -#: debhelper-obsolete-compat.pod:48 debhelper-obsolete-compat.pod:52 -#: debhelper-obsolete-compat.pod:66 debhelper-obsolete-compat.pod:71 -#: debhelper-obsolete-compat.pod:76 debhelper-obsolete-compat.pod:81 -#: debhelper-obsolete-compat.pod:97 debhelper-obsolete-compat.pod:101 -#: debhelper-obsolete-compat.pod:106 debhelper-obsolete-compat.pod:110 -#: dh_testroot:36 dh_testroot:41 dh_testroot:46 -msgid "-" -msgstr "-" +#: debhelper.pod:541 +msgid "" +"If your source package generates more than one binary package, debhelper " +"programs will default to acting on all binary packages when run. If your " +"source package happens to generate one architecture dependent package, and " +"another architecture independent package, this is not the correct behavior, " +"because you need to generate the architecture dependent packages in the " +"binary-arch F<debian/rules> target, and the architecture independent " +"packages in the binary-indep F<debian/rules> target." +msgstr "" +"Si le paquet source produit plus d'un paquet binaire, les programmes de " +"debhelper construiront tous les paquets binaires. Si le paquet source doit " +"construire un paquet dépendant de l'architecture et un paquet indépendant de " +"l'architecture, ce comportement ne conviendra pas. En effet, il convient de " +"construire les paquets dépendants de l'architecture dans « binary-arch » de " +"F<debian/rules>, et les paquets indépendants de l'architecture dans « binary-" +"indep »." # type: textblock #. type: textblock -#: debhelper.pod:541 +#: debhelper.pod:549 msgid "" -"Commands that generate maintainer script fragments will order the fragments " -"in reverse order for the F<prerm> and F<postrm> scripts." +"To facilitate this, as well as give you more control over which packages are " +"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" +"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " +"are given, debhelper programs default to acting on all packages listed in " +"the control file, with the exceptions below." msgstr "" -"Les commandes qui génèrent des lignes de codes de maintenance les mettront " -"dans l'ordre inverse dans les scripts F<prerm> et F<postrm>." +"Pour résoudre ce problème, et pour un meilleur contrôle sur la construction " +"des paquets par debhelper, tous les programmes de debhelper acceptent les " +"options B<-a>, B<-i>, B<-p> et B<-s>. Ces options sont cumulatives. Si " +"aucune n'est précisée, les programmes de debhelper construisent tous les " +"paquets énumérés dans le fichier de contrôle, avec les exceptions ci-dessous." -# type: textblock #. type: textblock -#: debhelper.pod:546 +#: debhelper.pod:555 msgid "" -"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." -"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " -"directory." +"First, any package whose B<Architecture> field in B<debian/control> does not " +"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " +"section 5.6.8>)." msgstr "" -"B<dh_installwm> installera un lien vers une page de manuel esclave pour F<x-" -"window-manager.1.gz> s'il voit la page de manuel dans le répertoire F<usr/" -"share/man/man1> du répertoire de construction du paquet." +"Tout d'abord, chaque paquet dont le champ B<Architecture> de I<debian/" +"control> ne contient pas l'architecture B<DEB_HOST_ARCH> sera exclu " +"(L<Charte Debian, section 5.6.8>)." -# type: textblock #. type: textblock -#: debhelper.pod:552 +#: debhelper.pod:559 msgid "" -"B<dh_builddeb> did not previously delete everything matching " -"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " -"B<CVS:.svn:.git>. Now it does." +"Also, some additional packages may be excluded based on the contents of the " +"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " +"binary package stanzas in B<debian/control>, according to the draft policy " +"at L<https://wiki.debian.org/BuildProfileSpec>." msgstr "" -"Auparavant, B<dh_builddeb> ne supprimait pas les associations créées avec " -"B<DH_ALWAYS_EXCLUDE> s'il était configuré sur une liste d'éléments tels que " -"B<CVS:.svn:.git>. Maintenant il le fait." +"De plus, quelques autres paquets peuvent être exclus suivant le contenu de " +"la variable d'environnement B<DEB_BUILD_PROFILES> et les champs B<Build-" +"Profiles> des paragraphes I<debian/control> dans les paquets binaires, " +"conformément au brouillon de la charte (voir L<https://wiki.debian.org/" +"BuildProfileSpec>)." + +#. type: =head3 +#: debhelper.pod:564 +msgid "Interaction between package selections and Build-Profiles" +msgstr "Interaction entre les sélections de paquets et les Build-Profiles" -# type: textblock #. type: textblock -#: debhelper.pod:558 +#: debhelper.pod:566 msgid "" -"B<dh_installman> allows overwriting existing man pages in the package build " -"directory. In previous compatibility levels it silently refuses to do this." +"Build-Profiles affect which packages are included in the package selections " +"mechanisms in debhelper. Generally, the package selections are described " +"from the assumption that all packages are enabled. This section describes " +"how the selections react when a package is disabled due to the active Build-" +"Profiles (or lack of active Build-Profiles)." msgstr "" -"B<dh_installman> permet d'écraser les pages de manuel existantes dans le " -"répertoire de construction du paquet. Auparavant, il refusait en silence de " -"le faire." +"Les profils de construction (« Build-Profiles ») ont un effet sur le choix " +"des paquets inclus dans les mécanismes de sélection de paquets de debhelper. " +"Généralement, les sélections partent du principe que tous les paquets sont " +"activés. Cette section décrit comment les sélections fonctionnent lorsqu'un " +"paquet est désactivé par un profil de construction (ou par son absence)." #. type: =item -#: debhelper.pod:565 -msgid "v7" -msgstr "v7" +#: debhelper.pod:574 +msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +msgstr "" +"B<-a>/B<--arch>, B<-i>/B<--indep> ou aucune option de sélection (un simple " +"appel « dh_X »)" -# type: textblock #. type: textblock -#: debhelper.pod:567 -msgid "Changes from v6 are:" -msgstr "Les changements par rapport à la version 6 sont :" +#: debhelper.pod:576 +msgid "" +"The package disabled by Build-Profiles is silently excluded from the " +"selection." +msgstr "" +"Le paquet désactivé par le profil est silencieusement exclu de la sélection." -# type: textblock #. type: textblock -#: debhelper.pod:573 +#: debhelper.pod:579 msgid "" -"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " -"doesn't find them in the current directory (or wherever you tell it look " -"using B<--sourcedir>). This allows B<dh_install> to interoperate with " -"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " -"special parameters." +"Note you will receive a warning if I<all> packages related to these " +"selections are disabled. In that case, it generally does not make sense to " +"do the build in the first place." msgstr "" -"B<dh_install> cherchera récursivement les fichiers dans F<debian/tmp> s'il " -"ne les trouve pas dans le répertoire courant (ou dans le répertoire indiqué " -"par B<--sourcedir>). Cela permet à B<dh_install> d'interopérer avec " -"B<dh_auto_install> qui place les fichiers dans F<debian/tmp>, sans " -"nécessiter de paramètres particuliers." +"Veuillez noter que vous recevrez un avertissement si I<tous> les paquets " +"relatifs à cette sélection sont désactivés. Dans ce cas, il est généralement " +"d'aucune utilité de construire." + +# type: =item +#. type: =item +#: debhelper.pod:583 +msgid "-N I<package> / --no-package I<package>" +msgstr "B<-N> I<paquet> / B<--no-package> I<paquet>" -# type: textblock #. type: textblock -#: debhelper.pod:580 -msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." -msgstr "" -"B<dh_clean> lit le répertoire F<debian/clean> et supprime les fichiers qui y " -"sont mentionnés." +#: debhelper.pod:585 +msgid "The option is accepted and effectively does nothing." +msgstr "Cette option est acceptée et ne fait rien." + +# type: =item +#. type: =item +#: debhelper.pod:587 +msgid "-p I<package> / --package I<package>" +msgstr "B<-p> I<paquet> / B<--package> I<paquet>" -# type: textblock #. type: textblock -#: debhelper.pod:584 -msgid "B<dh_clean> will delete toplevel F<*-stamp> files." -msgstr "B<dh_clean> supprime les fichiers F<*-stamp>." +#: debhelper.pod:589 +msgid "The option is accepted, but debhelper will not act on the package." +msgstr "Cette option est acceptée, mais debhelper n'agira pas sur le paquet." -# type: textblock #. type: textblock -#: debhelper.pod:588 +#: debhelper.pod:593 msgid "" -"B<dh_installchangelogs> will guess at what file is the upstream changelog if " -"none is specified." +"Note that it does not matter whether a package is enabled or disabled by " +"default." msgstr "" -"B<dh_installchangelogs> déterminera à quel fichier correspond le changelog " -"amont si rien n'est indiqué." +"Veuillez noter que cela n'a pas d'importance que le paquet soit activé ou " +"désactivé par défaut." -#. type: =item -#: debhelper.pod:595 -msgid "v8" -msgstr "v8" +# type: =head2 +#. type: =head2 +#: debhelper.pod:596 +msgid "Automatic generation of Debian install scripts" +msgstr "Génération automatique des scripts Debian d’installation" # type: textblock #. type: textblock -#: debhelper.pod:597 -msgid "Changes from v7 are:" -msgstr "Les changements par rapport à la version 7 sont :" +#: debhelper.pod:598 +msgid "" +"Some debhelper commands will automatically generate parts of Debian " +"maintainer scripts. If you want these automatically generated things " +"included in your existing Debian maintainer scripts, then you need to add " +"B<#DEBHELPER#> to your scripts, in the place the code should be added. " +"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " +"B<dh_installdeb>." +msgstr "" +"Certaines commandes de debhelper produisent automatiquement des lignes de " +"code de maintenance du paquet. Pour les inclure dans vos propres scripts de " +"maintenance du paquet, il convient d'ajouter B<#DEBHELPER#> à l'endroit où " +"les lignes de code générées devront être insérées. B<#DEBHELPER#> sera " +"remplacé, par les lignes de code générées automatiquement, lors de " +"l'exécution de B<dh_installdeb>." +# type: textblock #. type: textblock -#: debhelper.pod:603 +#: debhelper.pod:605 msgid "" -"Commands will fail rather than warning when they are passed unknown options." +"If a script does not exist at all and debhelper needs to add something to " +"it, then debhelper will create the complete script." msgstr "" -"Les commandes échoueront plutôt que de produire une alerte lorsqu'elles " -"recevront des options inconnues." +"Si un script de maintenance n'existe pas et que debhelper doit y inclure " +"quelque chose, alors debhelper créera le script de maintenance complètement." +# type: textblock #. type: textblock -#: debhelper.pod:607 +#: debhelper.pod:608 msgid "" -"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " -"generates shlibs files for. So B<-X> can be used to exclude libraries. " -"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " -"processed before will be passed to it, a behavior change that can cause some " -"packages to fail to build." +"All debhelper commands that automatically generate code in this way let it " +"be disabled by the -n parameter (see above)." msgstr "" -"B<dh_makeshlibs> va exécuter le programme B<dpkg-gensymbols> sur toutes les " -"bibliothèques partagées qu'il génère pour les fichiers shlibs. B<-X> peut " -"alors être utilisé pour exclure certaines bibliothèques. En outre, les " -"bibliothèques rangées à des emplacements inhabituels que B<pkg-gensymbols> " -"n'aurait pas traitées avant qu'elles ne lui soient transmises, induisent un " -"changement de comportement qui peut causer l'échec de la construction de " -"certains paquets." +"Toutes les commandes de debhelper qui produisent automatiquement des lignes " +"de code de cette façon peuvent inhiber cette production grâce à l'option B<-" +"n> (voir ci-dessus)." +# type: textblock #. type: textblock -#: debhelper.pod:615 +#: debhelper.pod:611 msgid "" -"B<dh> requires the sequence to run be specified as the first parameter, and " -"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo $@>" -"\"." +"Note that the inserted code will be shell code, so you cannot directly use " +"it in a Perl script. If you would like to embed it into a Perl script, here " +"is one way to do that (note that I made sure that $1, $2, etc are set with " +"the set command):" msgstr "" -"B<dh> exige que la séquence à exécuter soit indiquée en tant que premier " -"paramètre. Tous les commutateurs doivent venir après. C'est-à -dire qu'il " -"faut écrire « B<dh $@ --toto> », et non « B<dh --toto $@> »" +"Nota : Les lignes de code insérées seront écrites dans le langage de " +"l'interpréteur de commandes (shell). De ce fait, il est impossible de les " +"placer directement dans un script Perl. Pour les insérer dans un script " +"Perl, voici une solution (s'assurer que $1, $2, etc., sont bien définis par " +"la commande set) :" -#. type: textblock -#: debhelper.pod:620 +#. type: verbatim +#: debhelper.pod:616 +#, no-wrap msgid "" -"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " -"F<Makefile.PL>." +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"The debhelper script failed with error code: ${exit_code}\");\n" +" } else {\n" +" die(\"The debhelper script was killed by signal: ${signal}\");\n" +" }\n" +" }\n" +"\n" msgstr "" -"B<dh_auto_*> utilise préférentiellement B<Module::Build> de Perl au lieu de " -"F<Makefile.PL>." +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"Le script debhelper a échoué avec le code d'erreur : ${exit_code}\");\n" +" } else {\n" +" die(\"Le script debhelper a été tué par le signal : ${signal}\");\n" +" }\n" +" }\n" +"\n" -#. type: =item -#: debhelper.pod:626 -msgid "v9" -msgstr "v9" +# type: =head2 +#. type: =head2 +#: debhelper.pod:629 +msgid "Automatic generation of miscellaneous dependencies." +msgstr "Génération automatique des diverses dépendances." # type: textblock #. type: textblock -#: debhelper.pod:628 -msgid "Changes from v8 are:" -msgstr "Les changements par rapport à la version 8 sont :" - -#. type: textblock -#: debhelper.pod:634 +#: debhelper.pod:631 msgid "" -"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " -"directories to autoconf in --libdir and --libexecdir." +"Some debhelper commands may make the generated package need to depend on " +"some other packages. For example, if you use L<dh_installdebconf(1)>, your " +"package will generally need to depend on debconf. Or if you use " +"L<dh_installxfonts(1)>, your package will generally need to depend on a " +"particular version of xutils. Keeping track of these miscellaneous " +"dependencies can be annoying since they are dependent on how debhelper does " +"things, so debhelper offers a way to automate it." msgstr "" -"Prise en charge multiarchitecture. En particulier, B<dh_auto_configure> " -"passe les répertoires multiarchitectures à B<autoconf> dans B<--libdir> et " -"B<--libexecdir>." +"Certaines commandes de debhelper peuvent nécessiter des dépendances entre le " +"paquet construit et d'autres paquets. Par exemple, si " +"L<dh_installdebconf(1)> est employé, le paquet devra dépendre de debconf. Si " +"L<dh_installxfonts(1)> est employé, le paquet deviendra dépendant d'une " +"version particulière de xutils. Maintenir ces dépendances induites peut être " +"pénible puisqu'elles découlent de la façon dont debhelper travaille. C'est " +"pourquoi debhelper offre une solution d'automatisation." +# type: textblock #. type: textblock #: debhelper.pod:639 msgid "" -"dh is aware of the usual dependencies between targets in debian/rules. So, " -"\"dh binary\" will run any build, build-arch, build-indep, install, etc " -"targets that exist in the rules file. There's no need to define an explicit " -"binary target with explicit dependencies on the other targets." +"All commands of this type, besides documenting what dependencies may be " +"needed on their man pages, will automatically generate a substvar called " +"B<${misc:Depends}>. If you put that token into your F<debian/control> file, " +"it will be expanded to the dependencies debhelper figures you need." msgstr "" -"B<dh> connaît les dépendances classiques entre les cibles de F<debian/" -"rules>. Donc « B<dh binary> » exécutera toutes les cibles build, build-arch, " -"build-indep, install, etc., présentes dans le fichier I<rules>. Il n'est pas " -"nécessaire de définir une cible binary avec des dépendances explicites sur " -"les autres cibles." +"Toutes les commandes de ce type, outre qu'elles documentent, dans leur page " +"de manuel, les dépendances qu'elle induisent, généreront automatiquement une " +"variable de substitution nommée B<${misc:depends}>. Si cette variable est " +"exploitée dans le dossier F<debian/control>, il sera automatiquement enrichi " +"des dépendances induites par debhelper." +# type: textblock #. type: textblock -#: debhelper.pod:646 +#: debhelper.pod:644 msgid "" -"B<dh_strip> compresses debugging symbol files to reduce the installed size " -"of -dbg packages." +"This is entirely independent of the standard B<${shlibs:Depends}> generated " +"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " +"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " +"guesses don't match reality." msgstr "" -"B<dh_strip> compresse les fichiers de symboles de mise au point pour réduire " -"la taille d'installation des paquets -dbg." +"Ce processus est entièrement indépendant de B<${shlibs:Depends}> standard, " +"produite par L<dh_makeshlibs(1)>, et de B<${perl:Depends}> produite par " +"L<dh_perl(1)>. Il est également possible de choisir de ne pas les utiliser " +"si les conjectures de debhelper ne correspondent pas à la réalité." + +# type: =head2 +#. type: =head2 +#: debhelper.pod:649 +msgid "Package build directories" +msgstr "Répertoires de construction du paquet" +# type: textblock #. type: textblock #: debhelper.pod:651 msgid "" -"B<dh_auto_configure> does not include the source package name in --" -"libexecdir when using autoconf." +"By default, all debhelper programs assume that the temporary directory used " +"for assembling the tree of files in a package is debian/I<package>." msgstr "" -"B<dh_auto_configure> n'inclut pas le nom du paquet source dans B<--" -"libexecdir> en utilisant B<autoconf>." - -#. type: textblock -#: debhelper.pod:656 -msgid "B<dh> does not default to enabling --with=python-support" -msgstr "B<dh> n'active pas B<--with=python-support> par défaut." +"Par défaut, tous les programmes de debhelper supposent que le répertoire " +"temporaire utilisé pour construire l'arborescence des fichiers d'un paquet " +"est debian/I<paquet>." +# type: textblock #. type: textblock -#: debhelper.pod:658 +#: debhelper.pod:654 msgid "" -"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " -"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " -"regardless of compat level)" +"Sometimes, you might want to use some other temporary directory. This is " +"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/" +"tmp>\", will use B<debian/tmp> as the temporary directory. Note that if you " +"use B<-P>, the debhelper programs can only be acting on a single package at " +"a time. So if you have a package that builds many binary packages, you will " +"need to also use the B<-p> flag to specify which binary package the " +"debhelper program will act on." msgstr "" -"(Obsolète puisque l'outil B<dh_pysupport> a été retiré de Debian Stretch. " -"Depuis debhelper 10.3, B<dh> n'active plus cette séquence quel que soit le " -"niveau de compatibilité)" +"Parfois, il peut être souhaitable d'utiliser un autre répertoire temporaire. " +"C'est obtenu grâce à l'attribut B<-P>. Par exemple, B<dh_installdocs -" +"Pdebian/tmp> utilisera B<debian/tmp> comme répertoire temporaire. Nota : " +"L'usage de B<-P> implique que les programmes de debhelper ne construisent " +"qu'un seul paquet à la fois. De ce fait, si le paquet source génère " +"plusieurs paquets binaires, il faudra employer également le paramètre B<-p> " +"pour préciser l'unique paquet binaire à construire." + +# type: =head2 +#. type: =head2 +#: debhelper.pod:662 +msgid "udebs" +msgstr "udebs" +# type: textblock #. type: textblock #: debhelper.pod:664 msgid "" -"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " -"variables listed by B<dpkg-buildflags>, unless they are already set." +"Debhelper includes support for udebs. To create a udeb with debhelper, add " +"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " +"Debhelper will try to create udebs that comply with debian-installer policy, " +"by making the generated package files end in F<.udeb>, not installing any " +"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " +"and F<config> scripts, etc." msgstr "" -"Tous les programmes debhelper B<dh_auto_>I<*> et B<dh> configurent les " -"variables d'environnement renvoyées par B<dpkg-buildflags>, sauf si elles " -"sont déjà configurées." +"Debhelper prend en charge la construction des udebs. Pour créer un udeb avec " +"debhelper, il faut ajouter « B<Package-Type: udeb> » aux lignes de paquet " +"dans F<debian/control>. Debhelper essayera de construire des udebs, " +"conformément aux règles de l'installateur Debian, en suffixant les fichiers " +"de paquets générés avec F<.udeb>, en n'installant aucune documentation dans " +"un udeb, en omettant les scripts F<preinst>, F<postrm>, F<prerm> et " +"F<config>, etc." + +# type: =head1 +#. type: =head1 +#: debhelper.pod:671 +msgid "ENVIRONMENT" +msgstr "VARIABLES D'ENVIRONNEMENT" #. type: textblock -#: debhelper.pod:670 +#: debhelper.pod:673 msgid "" -"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " -"to perl F<Makefile.PL> and F<Build.PL>" +"This section describes some of the environment variables that influences the " +"behaviour of debhelper or which debhelper interacts with." msgstr "" -"B<dh_auto_configure> passe les CFLAGS, CPPFLAGS et LDFLAGS de B<dpkg-" -"buildflags> à F<Makefile.PL> et F<Build.PL> de Perl." +"Cette section décrit certaines des variables d'environnement qui influencent " +"le comportement de debhelper ou avec lesquelles debhelper est en interaction." #. type: textblock -#: debhelper.pod:675 +#: debhelper.pod:676 msgid "" -"B<dh_strip> puts separated debug symbols in a location based on their build-" -"id." +"It is important to note that these must be actual environment variables in " +"order to affect the behaviour of debhelper (not simply F<Makefile> " +"variables). To specify them properly in F<debian/rules>, be sure to " +"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." msgstr "" -"B<dh_strip> place les symboles de mise au point séparés à un endroit en " -"fonction de leur identifiant de construction (build-id)." +"Il est important de noter que celles-ci doivent être des variables " +"existantes pour affecter le comportement de debhelper (pas simplement des " +"variables de F<Makefile>). Pour les définir proprement dans le fichier " +"F<debian/rules>, assurez-vous de les exporter (« B<export> »). Par exemple " +"« B<export DH_VERBOSE> »." + +# type: =item +#. type: =item +#: debhelper.pod:683 +msgid "B<DH_VERBOSE>" +msgstr "B<DH_VERBOSE>" #. type: textblock -#: debhelper.pod:680 +#: debhelper.pod:685 msgid "" -"Executable debhelper config files are run and their output used as the " -"configuration." +"Set to a non-empty value to enable verbose mode. Please see the B<-v> / B<--" +"verbose> option for details." msgstr "" -"Les fichiers de configuration exécutables de debhelper sont exécutés et leur " -"sortie est utilisée comme configuration." +# type: =item #. type: =item -#: debhelper.pod:687 -msgid "v10" -msgstr "v10" +#: debhelper.pod:688 +msgid "B<DH_QUIET>" +msgstr "B<DH_QUIET>" -# type: textblock #. type: textblock -#: debhelper.pod:689 -msgid "Changes from v9 are:" -msgstr "Les changements par rapport à la version 9 sont :" +#: debhelper.pod:690 +#, fuzzy +#| msgid "" +#| "Set to B<1> to enable quiet mode. Debhelper will not output commands " +#| "calling the upstream build system nor will dh print which subcommands are " +#| "called and depending on the upstream build system might make that more " +#| "quiet, too. This makes it easier to spot important messages but makes " +#| "the output quite useless as buildd log. Ignored if DH_VERBOSE is also " +#| "set." +msgid "" +"Set to a non-empty value to enable quiet mode. Debhelper will not output " +"commands calling the upstream build system nor will dh print which " +"subcommands are called and depending on the upstream build system might make " +"that more quiet, too. This makes it easier to spot important messages but " +"makes the output quite useless as buildd log." +msgstr "" +"Mettre cette variable à B<1> valide le mode silencieux. Debhelper " +"n'affichera aucune commande appelant le système de construction amont, et dh " +"n'affichera aucune des sous-commandes appelées. En fonction du système de " +"construction amont, cela pourra le rendre encore plus silencieux. Cela " +"facilite la détection des messages importants, mais rend la sortie inutile " +"en tant que journal de construction. Cette valeur est ignorée si " +"B<DH_VERBOSE> est aussi positionnée." #. type: textblock -#: debhelper.pod:695 -msgid "" -"B<dh_installinit> will no longer install a file named debian/I<package> as " -"an init script." +#: debhelper.pod:696 +msgid "Ignored if DH_VERBOSE is also set or B<-v> / B<--verbose> is passed." msgstr "" -"B<dh_installinit> n'installe plus de fichier nommé debian/<paquet> comme " -"script d'initialisation." +# type: =item +#. type: =item +#: debhelper.pod:698 +msgid "B<DH_COMPAT>" +msgstr "B<DH_COMPAT>" + +# type: textblock #. type: textblock #: debhelper.pod:700 msgid "" -"B<dh_installdocs> will error out if it detects links created with --link-doc " -"between packages of architecture \"all\" and non-\"all\" as it breaks " -"binNMUs." +"Temporarily specifies what compatibility level debhelper should run at, " +"overriding any value specified via Build-Depends on debhelper-compat or via " +"the F<debian/compat> file." msgstr "" -"B<dh_installdocs> renverra une erreur s'il détecte des liens créés avec B<--" -"link-doc> entre des paquets de l'architecture « all » et non-« all » car " -"cela casse les binNMUs (envois de binaires par quelqu'un d'autre que le " -"responsable)." +"Indique temporairement le niveau de compatibilité avec lequel debhelper doit " +"fonctionner. Cette valeur supplante toute valeur précisée par Build-Depends " +"sur debhelper-compat ou dans F<debian/compat>." + +# type: =item +#. type: =item +#: debhelper.pod:704 +msgid "B<DH_NO_ACT>" +msgstr "B<DH_NO_ACT>" +# type: textblock #. type: textblock #: debhelper.pod:706 -msgid "" -"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." -"shlibs file. This is now done by B<dh_makeshlibs> instead." -msgstr "" -"B<dh_installdeb> n'installe plus de fichier debian/<paquet>.shlibs fourni " -"par le responsable du paquet. Cela est maintenant effectué par " -"B<dh_makeshlibs>." +msgid "Set to B<1> to enable no-act mode." +msgstr "Mettre cette variable à B<1> pour activer le mode simulation (no-act)." + +# type: =item +#. type: =item +#: debhelper.pod:708 +msgid "B<DH_OPTIONS>" +msgstr "B<DH_OPTIONS>" #. type: textblock -#: debhelper.pod:712 +#: debhelper.pod:710 msgid "" -"B<dh_installwm> refuses to create a broken package if no man page can be " -"found (required to register for the x-window-manager alternative)." +"All debhelper tools will parse command line arguments listed in this " +"variable before any command option (as if they had been prepended to the " +"command line arguments). Unfortunately, some third-party provided tools may " +"not support this variable and will ignore these command line arguments." msgstr "" -"B<dh_installwm> refuse de créer un paquet cassé si aucune page de manuel ne " -"peut être trouvée (requis pour l'inscription de l'alternative x-window-" -"manager)." +"Tous les outils de debhelper analyseront les arguments de la ligne de " +"commande listés dans cette variable avant toute option de commande (comme " +"s'ils avaient été ajoutés au début des arguments de la ligne de commande). " +"Malheureusement, certains outils tiers peuvent ne pas prendre en compte " +"cette variable et ignoreront ces arguments." #. type: textblock -#: debhelper.pod:717 +#: debhelper.pod:715 msgid "" -"Debhelper will default to B<--parallel> for all buildsystems that support " -"parallel building. This can be disabled by using either B<--no-parallel> or " -"passing B<--max-parallel> with a value of 1." +"When using L<dh(1)>, it can be passed options that will be passed on to each " +"debhelper command, which is generally better than using DH_OPTIONS." msgstr "" -"Debhelper active par défaut la parallélisation pour tous les systèmes de " -"construction qui le gèrent. Cela peut être désactivé en utilisant l'option " -"B<--no-parallel> ou en passant la valeur B<1> à l'option B<--max-parallel>." +"En utilisant L<dh(1)>, des options peuvent être passées à chaque commande " +"debhelper, ce qui est généralement mieux que d'utiliser B<DH_OPTIONS>." + +# type: =item +#. type: =item +#: debhelper.pod:718 +msgid "B<DH_ALWAYS_EXCLUDE>" +msgstr "B<DH_ALWAYS_EXCLUDE>" +# type: textblock #. type: textblock -#: debhelper.pod:723 +#: debhelper.pod:720 msgid "" -"The B<dh> command will not accept any of the deprecated \"manual sequence " -"control\" parameters (B<--before>, B<--after>, etc.). Please use override " -"targets instead." +"If set, this adds the value the variable is set to to the B<-X> options of " +"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " +"B<rm -rf> anything that matches the value in your package build tree." msgstr "" -"La commande B<dh> n'acceptera aucun des paramètres obsolètes de « manual " -"sequence control » (B<--before>, B<--after>, etc.). Veuillez utiliser les " -"cibles de réécritures à la place." +"Si cette variable possède une valeur, elle sera ajoutée à l'option B<-X> de " +"toutes les commandes qui admettent cette option. De plus, B<dh_builddeb> " +"fera un B<rm -rf> pour chaque chose correspondant à la valeur dans l'arbre " +"de construction de paquet." +# type: textblock #. type: textblock -#: debhelper.pod:727 +#: debhelper.pod:724 msgid "" -"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " -"any of these since debhelper/12.4." +"This can be useful if you are doing a build from a CVS source tree, in which " +"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " +"sneaking into the package you build. Or, if a package has a source tarball " +"that (unwisely) includes CVS directories, you might want to export " +"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " +"your package is built." msgstr "" -"B<Application rétroactive aux niveaux de compatibilité antérieurs> : B<dh> " -"n'accepte plus aucun de ces paramètres depuis debhelper 12.4." +"Cela peut être utile pour construire un paquet à partir d'une arborescence " +"CVS. Dans ce cas, le réglage de B<DH_ALWAYS_EXCLUDE=CVS> empêchera les " +"répertoires CVS d'interférer subrepticement dans le paquet en construction. " +"Ou, si un paquet possède une source compressée, (maladroitement) présente " +"dans un répertoire CVS, il peut être utile d'exporter " +"B<DH_ALWAYS_EXCLUDE=CVS> dans F<debian/rules>, pour que cette variable soit " +"prise en compte quel que soit l'endroit où le paquet est construit." +# type: textblock #. type: textblock -#: debhelper.pod:732 +#: debhelper.pod:731 msgid "" -"The B<dh> command will no longer use log files to track which commands have " -"been run. The B<dh> command I<still> keeps track of whether it already ran " -"the \"build\" sequence and skip it if it did." +"Multiple things to exclude can be separated with colons, as in " +"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" msgstr "" -"La commande B<dh> n'utilisera plus les fichiers journaux pour enregistrer " -"quelles commandes ont été exécutées. La commande B<dh> se souvient " -"I<toujours> si la séquence « build » a été effectuée et l'omet si c'est le " -"cas." +"Des exclusions multiples peuvent être séparées avec des caractères deux " +"points, comme dans F<DH_ALWAYS_EXCLUDE=CVS:.svn>." + +# type: =item +#. type: =item +#: debhelper.pod:734 +msgid "B<DH_EXTRA_ADDONS>" +msgstr "B<DH_EXTRA_ADDONS>" #. type: textblock #: debhelper.pod:736 -msgid "The main effects of this are:" -msgstr "Les principales conséquences de cela sont :" +msgid "" +"If set, this adds the specified dh addons to be run in the appropriate " +"places in the sequence of commands. This is equivalent to specifying the " +"addon to run with the --with flag in the debian/rules file. Any --without " +"calls specifying an addon in this environment variable will not be run." +msgstr "" +"Les rajouts à B<dh> indiqués seront exécutés lors de la séquence de " +"commandes. Cela équivaut à les indiquer avec le drapeau B<--with> dans le " +"fichier F<debian/rules>. Les rajouts précédés de B<--without> ne seront pas " +"exécutés, même s'ils sont indiqués dans cette variable d'environnement." #. type: textblock -#: debhelper.pod:742 +#: debhelper.pod:741 msgid "" -"With this, it is now easier to debug the I<install> or/and I<binary> " -"sequences because they can now trivially be re-run (without having to do a " -"full \"clean and rebuild\" cycle)" +"This is intended to be used by downstreams or specific local configurations " +"that require a debhelper addon to be run during multiple builds without " +"having to patch a large number of rules file. If at all possible, this " +"should be avoided in favor of a --with flag in the rules file." msgstr "" -"Il est maintenant plus facile de déboguer les séquences I<install> et " -"I<binary> parce qu'elles peuvent maintenant être facilement re-exécutées " -"(sans avoir à refaire un cycle complet de « clean & rebuild »)" +"Cela est prévu pour être utilisé par les dérivées ou les configurations " +"locales spécifiques qui ont besoin d'un rajout lors de plusieurs " +"construction, sans avoir à modifier un grand nombre de fichier F<rules>. Il " +"est préférable d'éviter cette méthode et d'utiliser plutôt les drapeaux B<--" +"with> dans le fichier F<rules>." + +#. type: =item +#: debhelper.pod:746 +msgid "B<DH_COLORS>, B<DPKG_COLORS>" +msgstr "B<DH_COLORS>, B<DPKG_COLORS>" #. type: textblock #: debhelper.pod:748 msgid "" -"The main caveat is that B<dh_*> now only keeps track of what happened in a " -"single override target. When all the calls to a given B<dh_cmd> command " -"happens in the same override target everything will work as before." +"These variables can be used to control whether debhelper commands should use " +"colors in their textual output. Can be set to \"always\", \"auto\" (the " +"default), or \"never\"." msgstr "" -"La principale précaution est que B<dh_*> enregistre uniquement ce qui s'est " -"passé dans une unique cible de réécriture. Lorsque tous les appels à une " -"commande B<dh_cmd> donnée arrivent dans la même cible de réécriture, tout " -"fonctionnera comme avant." +"Ces variables peuvent être utilisées pour contrôler comment les commandes de " +"debhelper peuvent utiliser la couleur dans leurs sorties textuelles. Les " +"réglages peuvent être « always », « auto » (par défaut) ou « never »." #. type: textblock -#: debhelper.pod:753 -msgid "Example of where it can go wrong:" -msgstr "Exemple de ce qui pourrait mal se passer :" - -#. type: verbatim -#: debhelper.pod:755 -#, no-wrap +#: debhelper.pod:752 msgid "" -" override_dh_foo:\n" -" dh_foo -pmy-pkg\n" -"\n" +"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " +"debhelper uses it on the assumption that you want the same color setting for " +"dpkg and debhelper. In the off-hand chance you want different color setting " +"for debhelper, you can use B<DH_COLORS> instead or in addition to " +"B<DPKG_COLORS>." msgstr "" -" override_dh_toto:\n" -" dh_toto -pmon_paquet\n" -"\n" +"Notez que B<DPKG_COLOR> affecte aussi un certain nombre d'outils liés à dpkg " +"et debhelper l'utilise en supposant que vous voulez les même réglages de " +"couleur pour dpkg et debhelper. Au cas où vous voudriez un autre jeu de " +"couleurs pour debhelper, vous pouvez utiliser B<DH_COLORS> à la place ou en " +"plus de B<DPKG_COLORS>." -#. type: verbatim +#. type: =item #: debhelper.pod:758 -#, no-wrap +msgid "B<NO_COLOR>" +msgstr "B<NO_COLOR>" + +#. type: textblock +#: debhelper.pod:760 msgid "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" +"If no explicit request for color has been given (e.g. B<DH_COLORS> and " +"B<DPKG_COLORS> are both unset), the presence of this environment variable " +"cause the default color setting to be \"never\"." msgstr "" -" override_dh_titi:\n" -" dh_titi\n" -" dh_toto --remaining\n" -"\n" +"Si aucune demande explicite de couleur n'a été passée (par exemple, ni " +"B<DH_COLORS>, ni B<DPKG_COLORS> n'ont été configurées), la présence de cette " +"variable d'environnement fera que le réglage des couleurs par défaut sera " +"« never »." #. type: textblock -#: debhelper.pod:762 +#: debhelper.pod:764 msgid "" -"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" -"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " -"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." +"The variable is defined according to L<https://no-color.org/>. In this " +"project, the environment variables (such as B<DH_COLORS>) are considered an " +"explicit request for color." msgstr "" -"Dans ce cas, l'appel à B<dh_foo --remaining> inclura I<aussi> I<mon_paquet>, " -"car B<dh_foo -pmon_paquet> a été exécuté dans une cible de réécriture " -"différente. Ce problème n'est pas limité à B<--remaining> et concerne aussi " -"B<-a>, B<-i>, etc." +"Cette variable est définie conformément à L<https://no-color.org/>. Dans ce " +"projet, les variables d'environnement (comme B<DH_COLORS>) sont considérées " +"comme une demande explicite de couleur." -#. type: textblock -#: debhelper.pod:771 +#. type: =item +#: debhelper.pod:768 msgid "" -"The B<dh_installdeb> command now shell-escapes the lines in the " -"F<maintscript> config file. This was the original intent but it did not " -"work properly and packages have begun to rely on the incomplete shell " -"escaping (e.g. quoting file names)." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" msgstr "" -"À présent, la commande B<dh_installdeb> échappe les caractères du shell dans " -"les lignes du fichier de config F<maintscript>. C'était l'intention " -"originale mais cela n'a jamais fonctionné correctement et les paquets ont " -"commencé à compter sur l'échappement incomplet (p. ex. en encadrant les noms " -"de fichiers de guillemets)." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" #. type: textblock -#: debhelper.pod:778 +#: debhelper.pod:770 msgid "" -"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " -"For packages needing the previous behaviour, please use B<--no-restart-after-" -"upgrade>." +"By default (in any non-deprecated compat level), debhelper will " +"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " +"unset. If you need to change the default flags, please use the features " +"from L<dpkg-buildflags(1)> to do this (e.g. " +"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" +"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." msgstr "" -"La commande B<dh_installinit> utilise maintenant B<--restart-after-upgrade> " -"par défaut. Les paquets nécessitant le comportement précédent devraient " -"utiliser l'option B<--no-restart-after-upgrade>." +"Par défaut (dans tout niveau de compatibilité non obsolète), debhelper " +"réglera automatiquement ces paramètres en utilisant L<dpkg-buildflags(1)> " +"quand ils ne sont pas définis. S'il est nécessaire de changer les paramètres " +"par défaut, veuillez utiliser les fonctions de L<dpkg-buildflags(1)> pour le " +"faire (par exemple, B<DEB_BUILD_MAINT_OPTIONS=hardening=all> ou " +"B<DEB_CPPFLAGS_MAINT_APPEND=-DCUSTOM_MACRO=true>) au lieu de configurer " +"directement les variables concrètes." + +#. type: =item +#: debhelper.pod:777 +msgid "B<HOME>, B<XDG_*>" +msgstr "B<HOME>, B<XDG_*>" #. type: textblock -#: debhelper.pod:784 +#: debhelper.pod:779 msgid "" -"The B<autoreconf> sequence is now enabled by default. Please pass B<--" -"without autoreconf> to B<dh> if this is not desirable for a given package" +"In compat 13 and later, these environment variables are reset before " +"invoking the upstream build system via the B<dh_auto_*> helpers. The " +"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " +"(B<dh_auto_test> only) will be set to a writable directory. All remaining " +"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " +"cleared." msgstr "" -"La séquence B<autoreconf> est maintenant activée par défaut. Veuillez passer " -"l'option B<--without autoreconf> à B<dh> si cela n'est pas voulu pour " -"certains paquets." +"À partir du niveau de compatibilité 13, ces variables d'environnement sont " +"réinitialisées avant d'invoquer le système de construction amont à l'aide " +"des outils B<dh_auto_*>. Les variables B<HOME> (pour tout outil " +"B<dh_auto_*>) et B<XDG_RUNTIME_DIR> (pour B<dh_auto_test> seulement) seront " +"réglées dans un répertoire accessible en écriture. Toutes les autres " +"variables et B<XDG_RUNTIME_DIR> (sauf durant B<dh_auto_test>) seront vidées." #. type: textblock -#: debhelper.pod:790 +#: debhelper.pod:785 msgid "" -"The B<systemd> sequence is now enabled by default. Please pass B<--without " -"systemd> to B<dh> if this is not desirable for a given package." +"The B<HOME> directory will be created as an empty directory but it will be " +"reused between calls to B<dh_auto_*>. Any content will persist until " +"explicitly deleted or B<dh_clean>." msgstr "" -"La séquence B<systemd> est maintenant activée par défaut. Veuillez passer " -"l'option B<--without systemd> à B<dh> si cela n'est pas voulu pour certains " -"paquets." +"Le répertoire B<HOME> sera créé comme un répertoire vide mais il sera " +"réutilisé entre les appels à B<dh_auto_*>. Tout son contenu restera jusqu'à " +"ce qu'il soit explicitement supprimé ou jusqu'à l'exécution de B<dh_clean>." + +# type: =item +#. type: =item +#: debhelper.pod:789 +msgid "B<DEB_BUILD_OPTIONS>" +msgstr "B<DEB_BUILD_OPTIONS>" #. type: textblock -#: debhelper.pod:796 +#: debhelper.pod:791 msgid "" -"B<Retroactively removed>: B<dh> no longer creates the package build " -"directory when skipping running debhelper commands. This will not affect " -"packages that only build with debhelper commands, but it may expose bugs in " -"commands not included in debhelper." +"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " +"variable." msgstr "" -"B<Supprimé rétroactivement> : B<dh> ne crée plus le répertoire de " -"construction du paquet lors de l'omission des commandes de debhelper en " -"cours. Cela n'affectera pas les paquets qui se construisent uniquement avec " -"debhelper, mais pourrait faire apparaître des bogues dans les commandes qui " -"ne sont pas incluses avec debhelper." +"Veuillez consulter L</Paramètres pris en charge dans DEB_BUILD_OPTIONS> pour " +"cet environnement." #. type: textblock -#: debhelper.pod:801 +#: debhelper.pod:794 msgid "" -"This compatibility feature had a bug since its inception in " -"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " -"there has been no reports of issues caused by this bug in those ~5 years, " -"this item have been removed rather than fixed." +"Please note that this variable should I<not> be altered by package " +"maintainers inside F<debian/rules> to change the behaviour of debhelper. " +"Instead, where the package maintainer need these features, they should look " +"disabling the relevant feature directly (e.g. by overriding the concrete " +"tools)." msgstr "" -"Cette fonctionnalité de compatibilité avait un bogue depuis sa création dans " -"debhelper/9.20130516, qui la faisait échouer en compat 9 et précédent. Comme " -"il n'y a eu aucun rapport de problème causé par ce bogue en 5 ans, cela a " -"été supprimé plutôt que corrigé." +"Veuillez noter que cette variable ne devrait B<pas> être modifiée par les " +"responsables de paquet dans F<debian/rules> pour changer le comportement de " +"debhelper. Ils devraient plutôt rechercher à désactiver la fonction " +"correspondante directement (par exemple en surchargeant les outils " +"spécifiques)." +# type: =item #. type: =item -#: debhelper.pod:808 -msgid "v11" -msgstr "v11" +#: debhelper.pod:799 +msgid "B<DEB_BUILD_MAINT_OPTIONS>" +msgstr "B<DEB_BUILD_MAINT_OPTIONS>" + +#. type: textblock +#: debhelper.pod:801 +msgid "" +"This is a dpkg specific environment variable (see e.g. L<dpkg-" +"buildflags(1)>). The debhelper tool suite silently ignores it." +msgstr "" +"C'est une variable d'environnement spécifique à dpkg (voir par exemple " +"L<dpkg-buildflags(1)>). La suite d'outils de debhelper l'ignore " +"silencieusement." -# type: textblock #. type: textblock +#: debhelper.pod:804 +msgid "" +"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " +"which make some people mistakenly assume that debhelper will also react to " +"this variable." +msgstr "" +"Cela est documenté ici parce qu'elle porte un nom identique à " +"B<DEB_BUILD_OPTIONS>, ce qui fait que certaines personnes pensent par erreur " +"que debhelper réagit aussi à cette variable." + +#. type: =head2 #: debhelper.pod:810 -msgid "This mode is discouraged." -msgstr "Ce mode est déconseillé." +msgid "Supported flags in DEB_BUILD_OPTIONS" +msgstr "Paramètres pris en charge dans DEB_BUILD_OPTIONS" #. type: textblock #: debhelper.pod:812 msgid "" -"The compat 11 is discouraged for new packages as it suffers from feature " -"interaction between L<dh_installinit> and L<dh_installsystemd> causing " -"services to not run correctly in some cases. Please consider using " -"compatibility mode 10 or 12 instead. More details about the issue are " -"available in Debian#887904 and L<https://lists.debian.org/debian-" -"release/2019/04/msg01442.html>." +"The debhelper tool suite reacts to the following flags in " +"B<DEB_BUILD_OPTIONS>." msgstr "" -"Le niveau de compatibilité 11 est déconseillé pour les nouveaux paquets " -"parce qu'il souffre d'une interaction de fonctionnalités entre " -"L<dh_installinit> et L<dh_installsystemd> faisant que les services ne " -"fonctionnent pas correctement dans certains cas. Vous devriez envisager " -"l'utilisation à la place des modes de compatibilité 10 ou 12. Plus de " -"détails sur ce problème sont disponibles dans le bogue Debian n° 887904 et " -"dans le message L<https://lists.debian.org/debian-release/2019/04/msg01442." -"html>." +"La suite d'outils de debhelper réagit aux paramètres suivants dans " +"B<DEB_BUILD_OPTIONS>." + +#. type: =item +#: debhelper.pod:816 +msgid "B<dherroron=obsolete-compat-levels>" +msgstr "B<dherroron=obsolete-compat-levels>" -# type: textblock #. type: textblock -#: debhelper.pod:819 -msgid "Changes from v10 are:" -msgstr "Les changements par rapport à la version 10 sont :" +#: debhelper.pod:818 +msgid "I<This is a debhelper specific value.>" +msgstr "I<C'est une valeur spécifique à debhelper.>" #. type: textblock -#: debhelper.pod:825 +#: debhelper.pod:820 msgid "" -"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " -"generates maintainer scripts for those files. Please use the new " -"B<dh_installsystemd> helper." +"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " +"debhelper tools will promote deprecation warnings for usage of old soon to " +"be removed compat levels into errors." msgstr "" -"B<dh_installinit> n'installe plus de fichiers F<service> ou F<tmpfile>, ni " -"ne crée de scripts de maintenance pour ces fichiers. Veuillez utiliser le " -"nouvel assistant B<dh_installsystemd> à la place." +"Quand B<dherroron> est présent et réglé à B<obsolete-compat-levels>, alors " +"les outils de debhelper présenteront dans les erreurs des alertes sur " +"l'utilisation des niveaux de compatibilité anciens sur le point d'être " +"obsolètes" #. type: textblock -#: debhelper.pod:831 +#: debhelper.pod:824 msgid "" -"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " -"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " -"sequence for B<dh> has also been removed. If you need to disable the " -"B<dh_installsystemd> helper tool, please use an empty override target." +"This is useful for automated checking for code relying on deprecated compat " +"levels that is scheduled for removal." msgstr "" -"Les outils B<dh_systemd_enable> et B<dh_systemd_start> ont été remplacés par " -"un nouvel assistant B<dh_installsystemd>. Pour la même raison, la séquence " -"B<systemd> de B<dh> a aussi été retirée. Si vous avez besoin de désactiver " -"B<dh_installsystemd>, veuillez utiliser une cible de réécriture vide." +"C'est utile pour la vérification automatique de code se basant sur des " +"niveaux de compatibilité dont la suppression est programmée." #. type: textblock -#: debhelper.pod:837 -msgid "" -"Please note that the B<dh_installsystemd> tool has a slightly different " -"behaviour in some cases (e.g. when using the B<--name> parameter)." +#: debhelper.pod:827 +msgid "This option is intended for testing purposes; not production builds." msgstr "" -"Veuillez noter que B<dh_installsystemd> a un comportement légèrement " -"différent dans certains cas (par exemple lors de l'utilisation du paramètre " -"B<--name>)." +"Cette option est destinée aux tests et non aux constructions pour la " +"production." + +#. type: =item +#: debhelper.pod:829 +msgid "B<nostrip>" +msgstr "B<nostrip>" #. type: textblock -#: debhelper.pod:843 +#: debhelper.pod:831 debhelper.pod:854 debhelper.pod:868 msgid "" -"B<dh_installdirs> no longer creates debian/I<package> directories unless " -"explicitly requested (or it has to create a subdirectory in it)." +"I<This value will change the content of the debs being built. The .deb " +"packages built when this is set is therefore not bit-for-bit reproducible " +"with a regular build in the general case.>" msgstr "" -"B<dh_installdirs> ne crée plus les répertoires debian/I<paquet> sans qu'on " -"le lui demande explicitement (ou il doit créer un sous-répertoire à " -"l'intérieur)." +"I<Cette valeur changera le contenu des paquets .deb en construction. Les " +"paquets .deb construits avec ce réglage ne seront donc pas reproductibles " +"bit à bit par rapport à une construction normale en cas général.>" #. type: textblock -#: debhelper.pod:847 -msgid "The vast majority of all packages will be unaffected by this change." +#: debhelper.pod:835 +msgid "" +"This value will cause the official debhelper tools will skip actions and " +"helpers that either remove, detach or deduplicate debugging symbols in ELF " +"binaries." msgstr "" -"La grande majorité des paquets ne seront pas affectés par ce changement." +"Cette valeur fera que les outils officiels de debhelper ignoreront les " +"actions et les outils qui suppriment, détachent ou dédoublent les symboles " +"de débogage dans les binaires ELF." #. type: textblock -#: debhelper.pod:851 -msgid "" -"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" -"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " -"or B<cmake>) are unaffected by this change." -msgstr "" -"Le système de construction B<makefile> passe maintenant les options " -"B<INSTALL=\"install --strip-program=true\"> à L<make(1)>. Les systèmes " -"dérivés (comme B<configure> ou B<cmake>) ne sont pas affectés par ce " -"changement." +#: debhelper.pod:839 +msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." +msgstr "Cette valeur affecte L<dh_dwz(1)> et L<dh_strip(1)>." + +#. type: =item +#: debhelper.pod:841 +msgid "B<nocheck>" +msgstr "B<nocheck>" #. type: textblock -#: debhelper.pod:857 +#: debhelper.pod:843 msgid "" -"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" -"configure>." +"This value will cause the official debhelper build systems to skip runs of " +"upstream test suites." msgstr "" -"Le système de construction B<autoconf> passe maintenant l'option B<--" -"runstatedir=/run> à F<./configure>." +"Cette valeur fera que les systèmes de construction officiels de debhelper " +"ignoreront l'exécution des suites de tests de l'amont." #. type: textblock -#: debhelper.pod:862 +#: debhelper.pod:846 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " -"L<cmake(1)>." +"Package maintainers looking to avoid running the upstream tests should " +"B<not> rely on this. Instead, they can add an empty override target to skip " +"B<dh_auto_test>." msgstr "" -"Le système de construction B<cmake> passe maintenant l'option B<-" -"DCMAKE_INSTALL_RUNSTATEDIR=/run> à L<cmake(1)>." +"Les responsables de paquet cherchant à éviter l'exécution des tests de " +"l'amont ne devraient B<pas> recourir à cela. Ils peuvent plutôt ajouter une " +"cible de réécriture vide pour ignorer B<dh_auto_test>." + +#. type: textblock +#: debhelper.pod:850 +msgid "This value affects L<dh_auto_test(1)>." +msgstr "Cette valeur affecte L<dh_auto_test(1)>." + +#. type: =item +#: debhelper.pod:852 +msgid "B<nodoc>" +msgstr "B<nodoc>" #. type: textblock -#: debhelper.pod:867 +#: debhelper.pod:858 msgid "" -"B<dh_installman> will now prefer detecting the language from the path name " -"rather than the extension." +"This value will cause several debhelper tools to skip installation of " +"documentation such as manpages or upstream provided documentation. " +"Additionally, the tools will also ignore if declared documentation is " +"\"missing\" on the assumption that the documentation has not been built." msgstr "" -"B<dh_installman> préfère maintenant détecter le langage à partir du chemin " -"plutôt que de l'extension." +"Cette valeur fera que plusieurs outils de debhelper ignoreront " +"l'installation de documentation comme les pages de manuel ou la " +"documentation fournie par l'amont. En plus, les outils ne sauront pas si la " +"documentation déclarée est « missing » en partant du principe que la " +"documentation n'a pas été construite." #. type: textblock -#: debhelper.pod:872 +#: debhelper.pod:863 msgid "" -"B<dh_auto_install> will now only create the destination directory it needs. " -"Previously, it would create the package build directory for all packages. " -"This will not affect packages that only build with debhelper commands, but " -"it may expose bugs in commands not included in debhelper." +"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " +"working with documentation." msgstr "" -"B<dh_auto_install> crée maintenant uniquement le répertoire de destination " -"nécessaire. Auparavant, le répertoire de construction de chaque paquet était " -"créé. Cela n'affectera pas les paquets qui se construisent uniquement avec " -"debhelper, mais pourrait faire apparaître des bogues dans les commandes qui " -"ne sont pas incluses avec debhelper." +"Cette valeur affecte des outils comme L<dh_installdocs(1)> qui B<sait> qu'il " +"travaille sur la documentation." + +#. type: =item +#: debhelper.pod:866 +#, fuzzy +#| msgid "B<nostrip>" +msgid "B<notrimdch>" +msgstr "B<nostrip>" #. type: textblock -#: debhelper.pod:880 +#: debhelper.pod:872 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now error out if their config has a pattern that does not " -"match anything or reference a path that does not exist." +"This value will cause L<dh_installchangelogs(1)> to act as if it had been " +"passed the B<--no-trim> option, forcing it to forgo removing older entries " +"from changelogs." msgstr "" -"Les outils B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo> et " -"B<dh_installman> renvoient maintenant une erreur si leur configuration " -"contient un motif qui ne correspond à rien ou qui référence un chemin qui " -"n'existe pas." + +# type: =item +#. type: =item +#: debhelper.pod:876 +msgid "B<noautodbgsym>, B<noddebs>" +msgstr "B<noautodbgsym>, B<noddebs>" #. type: textblock -#: debhelper.pod:884 +#: debhelper.pod:878 msgid "" -"Known exceptions include building with the B<nodoc> profile, where the above " -"tools will silently permit failed matches where the patterns are used to " -"specify documentation." +"I<The official name is noautodbgsym. The noddebs variant is accepted for " +"historical reasons.>" msgstr "" -"Les exceptions connues incluent la construction avec le profil B<nodoc>, où " -"les outils ci-dessus permettront un échec silencieux de la correspondance " -"lorsque le motif est utilisé pour spécifier la documentation." +"I<Le nom officiel est noautodbgsym. La variante noddebs est acceptée pour " +"des raisons historiques.>" #. type: textblock -#: debhelper.pod:890 +#: debhelper.pod:881 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " -"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " -"B<dh_install>." +"This value causes debhelper to skip the generation of automatically " +"generated debug symbol packages." msgstr "" -"Les outils B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo> et " -"B<dh_installman> acceptent maintenant le paramètre B<--sourcedir> avec la " -"même signification que dans B<dh_install>. De plus, ils se rabattent sur " -"F<debian/tmp> comme B<dh_install>." +"Cette valeur fait que debhelper ignore la création des paquets de symboles " +"de débogage générés automatiquement." #. type: textblock -#: debhelper.pod:895 -msgid "" -"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " -"incorrectly ignore B<--sourcedir>." -msgstr "" -"Note de migration : un bogue dans debhelper 11 jusqu'à 11.1.5 faisait que " -"B<dh_installinfo> ignorait B<--sourcedir> de manière incorrecte." +#: debhelper.pod:884 +msgid "This value affects L<dh_strip(1)>." +msgstr "Cette valeur affecte L<dh_strip(1)>." + +# type: =item +#. type: =item +#: debhelper.pod:886 +msgid "B<parallel=N>" +msgstr "B<parallel=N>" #. type: textblock -#: debhelper.pod:900 +#: debhelper.pod:888 msgid "" -"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)." +"This value enables debhelper to use up to B<N> threads or processes (subject " +"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " +"debhelper tools work with parallel tasks and may silently ignore the request." msgstr "" -"Les systèmes de construction B<perl-makemaker> et B<perl-build> ne passent " -"plus l'option B<-I.> à Perl. Les paquets qui ont encore besoin de ce " -"comportement peuvent l'émuler en utilisant la variable d'environnement " -"B<PERL5LIB>. Par exemple en ajoutant B<export PERL5LIB=.> dans leur fichier " -"F<debian/rules> (ou équivalent)." +"Cette valeur à permet debhelper d'utiliser jusqu'à B<N> threads ou processus " +"(soumis à des paramètres comme B<--no-parallel> et B<--max-parallel=M>). " +"Tous les outils de debhelper ne fonctionnent pas avec des tâches parallèles " +"et peuvent ignorer silencieusement la requête." #. type: textblock -#: debhelper.pod:907 +#: debhelper.pod:893 msgid "" -"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " -"any of the B<dh_auto_*> tools. It was added as a temporary work around to " -"avoid a lot of packages failing to build at the same time." +"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " +"will attempt to run the underlying upstream build system with that number of " +"threads." msgstr "" -"La variable d'environnement B<PERL_USE_UNSAFE_INC> n'est plus définie par " -"B<dh>, ni aucun des outils B<dh_auto_*>. Cela avait été ajouté comme " -"contournement temporaire, pour éviter les échecs de construction d’un grand " -"nombre de paquets en même temps." +"Cette valeur affecte de nombreux outils de debhelper et en particulier " +"B<dh_auto_*> qui tentera d'exécuter le système de construction amont sous-" +"jacent avec ce nombre de thread." + +#. type: =item +#: debhelper.pod:897 +msgid "B<terse>" +msgstr "B<terse>" #. type: textblock -#: debhelper.pod:912 +#: debhelper.pod:899 msgid "" -"Note this item will eventually become obsolete as upstream intends to drop " -"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " -"drops support for it, then this variable will be removed retroactively from " -"existing compat levels as well." +"This value will cause the official debhelper build systems to configure " +"upstream builds to be terse (i.e. reduce verbosity in their output). This " +"is subject to the upstream and the debhelper build system supporting such " +"features." msgstr "" -"De plus, cette fonction deviendra peut-être obsolète car l'amont a " -"l'intention de retirer la prise en charge de la variable d'environnement " -"B<PERL_USE_UNSAFE_INC>. Lorsque ce sera le cas, cette variable sera aussi " -"supprimée rétroactivement des niveaux de compatibilité existants." +"Cette valeur fera que les systèmes de construction officiels de debhelper " +"configurent les constructions de l'amont pour qu'elles soient laconiques " +"(c'est-à -dire réduisent la verbosité de leurs sorties). Cela est subordonné " +"à la prise en charge par les systèmes de construction de l'amont et de " +"debhelper de ces fonctionnalités." #. type: textblock -#: debhelper.pod:919 +#: debhelper.pod:904 msgid "" -"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " -"non-zero exit from analysing a given file." +"This value affects most B<dh_auto_*> tools directly. For commands provided " +"by the debhelper package, it also causes the tools to act like the " +"B<DH_QUIET> environment variable was non-empty." msgstr "" -"L'assistant B<dh_makeshlibs> termine maintenant sur une erreur si objdump " -"renvoie une valeur de sortie différente de zéro lors de l'analyse d'un " -"fichier." #. type: textblock -#: debhelper.pod:924 +#: debhelper.pod:910 +msgid "Unknown flags are silently ignored." +msgstr "Les paramètres inconnus sont ignorés silencieusement." + +#. type: textblock +#: debhelper.pod:912 msgid "" -"The B<dh_installdocs> and B<dh_installexamples> tools may now install " -"I<most> of the documentation in a different path to comply with the " -"recommendation from Debian policy §12.3 (since version 3.9.7)." +"Note third-party debhelper-like tools or third-party provided build systems " +"may or may not react to the above flags. This tends to depend on " +"implementation details of the tool." +msgstr "" +"Veuillez noter que les outils tiers dans le style de debhelper ou les " +"systèmes de construction fournis par des tiers peuvent réagir ou non aux " +"paramètres ci-dessus. Cela dépend généralement des détails d'implémentation " +"des outils" + +# type: =head1 +#. type: =head1 +#: debhelper.pod:916 debhelper-compat-upgrade-checklist.pod:753 +#: debhelper-obsolete-compat.pod:178 dh:872 dh_auto_build:53 dh_auto_clean:55 +#: dh_auto_configure:58 dh_auto_install:103 dh_auto_test:64 dh_bugfiles:133 +#: dh_builddeb:176 dh_clean:189 dh_compress:243 dh_dwz:163 dh_fixperms:164 +#: dh_gencontrol:208 dh_icons:75 dh_install:377 dh_installcatalogs:128 +#: dh_installchangelogs:365 dh_installcron:80 dh_installdeb:419 +#: dh_installdebconf:233 dh_installdirs:131 dh_installdocs:437 +#: dh_installemacsen:138 dh_installexamples:182 dh_installifupdown:72 +#: dh_installinfo:123 dh_installinit:413 dh_installinitramfs:91 +#: dh_installlogcheck:81 dh_installlogrotate:53 dh_installman:420 +#: dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 +#: dh_installmodules:109 dh_installpam:71 dh_installppp:68 dh_installudev:102 +#: dh_installwm:130 dh_installxfonts:90 dh_link:166 dh_lintian:60 +#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 +#: dh_perl:188 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 +#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:280 dh_systemd_start:280 +msgid "SEE ALSO" +msgstr "VOIR AUSSI" + +#. type: =item +#: debhelper.pod:920 +msgid "L<debhelper-compat-upgrade-checklist(7)>" msgstr "" -"Les outils B<dh_installdocs> et B<dh_installexamples> pourraient maintenant " -"installer I<la plupart> de la documentation dans un répertoire différent, " -"pour satisfaire les recommandations de la Charte Debian §12.3 (depuis la " -"version 3.9.7)." #. type: textblock -#: debhelper.pod:928 +#: debhelper.pod:922 msgid "" -"Note that if a given source package only contains a single binary package in " -"F<debian/control> or none of the packages are I<-doc> packages, then this " -"change is not relevant for that source package and you can skip to the next " -"change." +"List of supported compat levels and an upgrade checklist for each of them." msgstr "" -"Si un paquet source contient un seul paquet binaire dans F<debian/control>, " -"ou si aucun des paquets n'est un paquet I<-doc>, alors ce changement n'a pas " -"d'effet pour ce paquet source, et vous pouvez aller au changement suivant." +# type: =item +#. type: =item +#: debhelper.pod:924 +msgid "F</usr/share/doc/debhelper/examples/>" +msgstr "F</usr/share/doc/debhelper/examples/>" + +# type: textblock #. type: textblock -#: debhelper.pod:933 -msgid "" -"By default, these tools will now attempt to determine a \"main package for " -"the documentation\" (called a I<doc-main-package> from here on) for every I<-" -"doc> package. If they find such a I<doc-main-package>, they will now " -"install the documentation into the path F<< /usr/share/doc/I<doc-main-" -"package> >> in the given doc package. I.e. the path can change but the " -"documentation is still shipped in the I<-doc> package." +#: debhelper.pod:926 +msgid "A set of example F<debian/rules> files that use debhelper." msgstr "" -"Par défaut, ces outils essaient maintenant de déterminer un « paquet " -"principal pour la documentation » (que l'on appellera I<doc-main-package>) " -"pour chaque paquet I<-doc>. S'ils trouvent un tel I<doc-main-package>, ils " -"installeront la documentation sous F<< /usr/share/doc/I<doc-main-package> >> " -"pour le paquet considéré. C'est-à -dire que le chemin peut changer, mais la " -"documentation est toujours fournie par le paquet I<-doc>." +"Un ensemble d'exemples de fichiers F<debian/rules> qui utilisent debhelper." + +# type: =item +#. type: =item +#: debhelper.pod:928 +msgid "L<http://joeyh.name/code/debhelper/>" +msgstr "L<http://joeyh.name/code/debhelper/>" + +# type: textblock +#. type: textblock +#: debhelper.pod:930 +msgid "Debhelper web site." +msgstr "Le site internet de debhelper." + +# type: =head1 +#. type: =head1 +#: debhelper.pod:934 dh:878 dh_auto_build:59 dh_auto_clean:61 +#: dh_auto_configure:64 dh_auto_install:109 dh_auto_test:70 dh_bugfiles:141 +#: dh_builddeb:182 dh_clean:195 dh_compress:249 dh_dwz:169 dh_fixperms:170 +#: dh_gencontrol:214 dh_icons:81 dh_install:383 dh_installcatalogs:134 +#: dh_installchangelogs:371 dh_installcron:86 dh_installdeb:425 +#: dh_installdebconf:239 dh_installdirs:137 dh_installdocs:443 +#: dh_installemacsen:145 dh_installexamples:188 dh_installifupdown:78 +#: dh_installinfo:129 dh_installinitramfs:99 dh_installlogcheck:87 +#: dh_installlogrotate:59 dh_installman:426 dh_installmanpages:204 +#: dh_installmenu:96 dh_installmime:69 dh_installmodules:115 dh_installpam:77 +#: dh_installppp:74 dh_installudev:108 dh_installwm:136 dh_installxfonts:96 +#: dh_link:172 dh_lintian:68 dh_listpackages:40 dh_makeshlibs:462 +#: dh_md5sums:124 dh_movefiles:167 dh_perl:194 dh_prep:76 dh_shlibdeps:210 +#: dh_strip:441 dh_testdir:68 dh_testroot:99 dh_usrlocal:142 +msgid "AUTHOR" +msgstr "AUTEUR" + +# type: textblock +#. type: textblock +#: debhelper.pod:936 dh:880 dh_auto_build:61 dh_auto_clean:63 +#: dh_auto_configure:66 dh_auto_install:111 dh_auto_test:72 dh_builddeb:184 +#: dh_clean:197 dh_compress:251 dh_fixperms:172 dh_gencontrol:216 +#: dh_install:385 dh_installchangelogs:373 dh_installcron:88 dh_installdeb:427 +#: dh_installdebconf:241 dh_installdirs:139 dh_installdocs:445 +#: dh_installemacsen:147 dh_installexamples:190 dh_installifupdown:80 +#: dh_installinfo:131 dh_installinit:421 dh_installlogrotate:61 +#: dh_installman:428 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 +#: dh_installmodules:117 dh_installpam:79 dh_installppp:76 dh_installudev:110 +#: dh_installwm:138 dh_installxfonts:98 dh_link:174 dh_listpackages:42 +#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 +#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 +msgid "Joey Hess <joeyh@debian.org>" +msgstr "Joey Hess <joeyh@debian.org>" #. type: textblock -#: debhelper.pod:941 +#: debhelper-compat-upgrade-checklist.pod:5 +#, fuzzy +#| msgid "" +#| "debhelper-obsolete-compat - List of no longer supported compat levels" msgid "" -"The B<--doc-main-package> option can be used when the auto-detection is " -"insufficient or to reset the path to its previous value if there is a reason " -"to diverge from Debian policy recommendation." +"debhelper-compat-upgrade-checklist - Upgrade checklist for supported " +"debhelper compat levels" msgstr "" -"L'option B<--doc-main-package> peut être utilisée si la détection " -"automatique est insuffisante, ou pour réinitialiser le chemin à sa valeur " -"précédente s'il y a une raison de diverger des recommandations de la " -"Charte Debian." +"debhelper-obsolete-compat - Liste les niveaux de compatibilité qui ne sont " +"plus pris en charge" #. type: textblock -#: debhelper.pod:945 +#: debhelper-compat-upgrade-checklist.pod:9 msgid "" -"Some documentation will not be affected by this change. These exceptions " -"include the copyright file, changelog files, README.Debian, etc. These " -"files will still be installed in the path F<< /usr/share/doc/I<package> >>." +"This document is an upgrade checklist of all the supported debhelper compat " +"levels. It also lists all the support debhelper compat levels." msgstr "" -"Quelques documents ne sont pas affectés par ce changement. En particulier le " -"fichier copyright, les fichiers changelog, README.Debian, etc. Ces fichiers " -"seront toujours installés sous F<< /usr/share/doc/I<package> >>." #. type: textblock -#: debhelper.pod:952 +#: debhelper-compat-upgrade-checklist.pod:12 msgid "" -"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " -"to determine which files to process. Instead, they open the file and look " -"for an ELF header to determine if a given file is an shared object or an ELF " -"executable." +"Information about how to declare the compat level is in L<debhelper(7)/" +"COMPATIBILITY LEVELS>." msgstr "" -"Les outils B<dh_strip> et B<dh_shlibdeps> n'utilisent plus les motifs de " -"noms de fichiers pour déterminer les fichiers à traiter. À la place, ils " -"ouvrent le fichier et cherchent un en-tête ELF pour déterminer si ce fichier " -"est un objet partagé ou un exécutable ELF." #. type: textblock -#: debhelper.pod:957 -msgid "This change may cause the tools to process more files than previously." +#: debhelper-compat-upgrade-checklist.pod:14 +#, fuzzy +#| msgid "" +#| "If you are upgrading from an earlier compatibility level, please review " +#| "L<debhelper-obsolete-compat(7)>." +msgid "" +"If you are upgrading from a (now) obsolete compat level, then please refer " +"to L<debhelper-obsolete-compat(7)>." msgstr "" -"Ce changement peut forcer les outils à traiter plus de fichiers qu'avant." +"Si vous mettez à jour depuis un niveau de compatibilité antérieur, veuillez " +"consulter L<debhelper-obsolete-compat(7)>." -#. type: =item -#: debhelper.pod:961 -msgid "v12" -msgstr "v12" +# type: textblock +#. type: =head2 +#: debhelper-compat-upgrade-checklist.pod:19 +#, fuzzy +#| msgid "This is the lowest supported compatibility level." +msgid "Upgrade checklist for supported compatibility levels" +msgstr "C'est le niveau de compatibilité le plus bas pris en charge." # type: textblock #. type: textblock -#: debhelper.pod:963 -msgid "Changes from v11 are:" -msgstr "Les changements par rapport à la version 11 sont :" +#: debhelper-compat-upgrade-checklist.pod:21 +msgid "These are the available compatibility levels:" +msgstr "Les niveaux de compatibilité sont les suivants :" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:25 +#, fuzzy +#| msgid "v5" +msgid "v15" +msgstr "v5" #. type: textblock -#: debhelper.pod:969 +#: debhelper-compat-upgrade-checklist.pod:27 +#: debhelper-compat-upgrade-checklist.pod:51 strings-kept-translations.pod:9 msgid "" -"The B<dh_makeshlibs> tool now generates shlibs files with versioned " -"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " -"is now the default." +"This compatibility level is still open for development; use with caution." msgstr "" -"B<dh_makeshlibs> génère maintenant des fichiers shlibs avec des dépendances " -"versionnées par défaut. Cela veut dire que B<-VUpstream-Version> (ou B<-V>) " -"est maintenant le comportement par défaut." +"Ce niveau de compatibilité est encore en développement ; à utiliser avec " +"précaution." +# type: textblock #. type: textblock -#: debhelper.pod:973 -msgid "" -"If an unversioned dependency in the shlibs file is wanted, this can be " -"obtained by passing B<-VNone> instead. However, please see " -"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." -msgstr "" -"Si une dépendance non versionnée est requise, cela peut être obtenu en " -"passant B<-VNone> à la place. Veuillez tout de même consulter " -"L<dh_makeshlibs(1)> pour l'utilisation des dépendances non versionnées." +#: debhelper-compat-upgrade-checklist.pod:29 +#, fuzzy +#| msgid "Changes from v4 are:" +msgid "Changes from v14 are:" +msgstr "Les changements par rapport à la version 4 sont :" # type: =item +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:33 +#: debhelper-compat-upgrade-checklist.pod:57 +#: debhelper-compat-upgrade-checklist.pod:63 +#: debhelper-compat-upgrade-checklist.pod:68 +#: debhelper-compat-upgrade-checklist.pod:74 +#: debhelper-compat-upgrade-checklist.pod:90 +#: debhelper-compat-upgrade-checklist.pod:95 +#: debhelper-compat-upgrade-checklist.pod:103 +#: debhelper-compat-upgrade-checklist.pod:120 +#: debhelper-compat-upgrade-checklist.pod:128 +#: debhelper-compat-upgrade-checklist.pod:136 +#: debhelper-compat-upgrade-checklist.pod:145 +#: debhelper-compat-upgrade-checklist.pod:151 +#: debhelper-compat-upgrade-checklist.pod:161 +#: debhelper-compat-upgrade-checklist.pod:169 +#: debhelper-compat-upgrade-checklist.pod:175 +#: debhelper-compat-upgrade-checklist.pod:189 +#: debhelper-compat-upgrade-checklist.pod:200 +#: debhelper-compat-upgrade-checklist.pod:214 +#: debhelper-compat-upgrade-checklist.pod:225 +#: debhelper-compat-upgrade-checklist.pod:241 +#: debhelper-compat-upgrade-checklist.pod:251 +#: debhelper-compat-upgrade-checklist.pod:255 +#: debhelper-compat-upgrade-checklist.pod:260 +#: debhelper-compat-upgrade-checklist.pod:265 +#: debhelper-compat-upgrade-checklist.pod:272 +#: debhelper-compat-upgrade-checklist.pod:278 +#: debhelper-compat-upgrade-checklist.pod:286 +#: debhelper-compat-upgrade-checklist.pod:292 +#: debhelper-compat-upgrade-checklist.pod:296 +#: debhelper-compat-upgrade-checklist.pod:301 +#: debhelper-compat-upgrade-checklist.pod:306 +#: debhelper-compat-upgrade-checklist.pod:315 +#: debhelper-compat-upgrade-checklist.pod:331 +#: debhelper-compat-upgrade-checklist.pod:340 +#: debhelper-compat-upgrade-checklist.pod:356 +#: debhelper-compat-upgrade-checklist.pod:364 +#: debhelper-compat-upgrade-checklist.pod:369 +#: debhelper-compat-upgrade-checklist.pod:391 +#: debhelper-compat-upgrade-checklist.pod:397 +#: debhelper-compat-upgrade-checklist.pod:409 +#: debhelper-compat-upgrade-checklist.pod:417 +#: debhelper-compat-upgrade-checklist.pod:423 +#: debhelper-compat-upgrade-checklist.pod:428 +#: debhelper-compat-upgrade-checklist.pod:433 +#: debhelper-compat-upgrade-checklist.pod:438 +#: debhelper-compat-upgrade-checklist.pod:446 +#: debhelper-compat-upgrade-checklist.pod:456 +#: debhelper-compat-upgrade-checklist.pod:466 +#: debhelper-compat-upgrade-checklist.pod:473 +#: debhelper-compat-upgrade-checklist.pod:485 +#: debhelper-compat-upgrade-checklist.pod:490 +#: debhelper-compat-upgrade-checklist.pod:518 +#: debhelper-compat-upgrade-checklist.pod:535 +#: debhelper-compat-upgrade-checklist.pod:540 +#: debhelper-compat-upgrade-checklist.pod:546 +#: debhelper-compat-upgrade-checklist.pod:552 +#: debhelper-compat-upgrade-checklist.pod:557 +#: debhelper-compat-upgrade-checklist.pod:563 +#: debhelper-compat-upgrade-checklist.pod:572 +#: debhelper-compat-upgrade-checklist.pod:582 +#: debhelper-compat-upgrade-checklist.pod:588 +#: debhelper-compat-upgrade-checklist.pod:611 +#: debhelper-compat-upgrade-checklist.pod:618 +#: debhelper-compat-upgrade-checklist.pod:624 +#: debhelper-compat-upgrade-checklist.pod:630 +#: debhelper-compat-upgrade-checklist.pod:636 +#: debhelper-compat-upgrade-checklist.pod:656 +#: debhelper-compat-upgrade-checklist.pod:661 +#: debhelper-compat-upgrade-checklist.pod:668 +#: debhelper-compat-upgrade-checklist.pod:673 +#: debhelper-compat-upgrade-checklist.pod:678 +#: debhelper-compat-upgrade-checklist.pod:686 +#: debhelper-compat-upgrade-checklist.pod:692 +#: debhelper-compat-upgrade-checklist.pod:697 +#: debhelper-compat-upgrade-checklist.pod:702 +#: debhelper-compat-upgrade-checklist.pod:717 +#: debhelper-compat-upgrade-checklist.pod:721 +#: debhelper-compat-upgrade-checklist.pod:729 +#: debhelper-compat-upgrade-checklist.pod:734 debhelper-obsolete-compat.pod:29 +#: debhelper-obsolete-compat.pod:36 debhelper-obsolete-compat.pod:40 +#: debhelper-obsolete-compat.pod:44 debhelper-obsolete-compat.pod:57 +#: debhelper-obsolete-compat.pod:62 debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:74 debhelper-obsolete-compat.pod:89 +#: debhelper-obsolete-compat.pod:93 debhelper-obsolete-compat.pod:98 +#: debhelper-obsolete-compat.pod:102 debhelper-obsolete-compat.pod:114 +#: debhelper-obsolete-compat.pod:119 debhelper-obsolete-compat.pod:124 +#: debhelper-obsolete-compat.pod:129 debhelper-obsolete-compat.pod:143 +#: debhelper-obsolete-compat.pod:148 debhelper-obsolete-compat.pod:152 +#: dh_testroot:36 dh_testroot:41 dh_testroot:46 +msgid "-" +msgstr "-" + #. type: textblock -#: debhelper.pod:979 +#: debhelper-compat-upgrade-checklist.pod:35 msgid "" -"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " -"instead." +"The B<dh_auto_install> tool no longer defaults to B<< --destdir=debian/" +"I<package> >> for source packages only producing a single binary. If this " +"behaviour is wanted, the package should explicitly activate the B<single-" +"binary> dh addon (e.g., by adding B<dh-sequence-single-binary> to B<Build-" +"Depends>) or pass B<--destdir> to B<dh_auto_install>." msgstr "" -"L'option B<-s> (B<--same-arch>) est supprimée. Veuillez utiliser B<-a> (B<--" -"arch>) à la place." #. type: textblock -#: debhelper.pod:983 +#: debhelper-compat-upgrade-checklist.pod:41 +#: debhelper-compat-upgrade-checklist.pod:84 msgid "" -"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." +"The rationale for this change to avoid \"surprises\" when adding a second " +"binary package later. Previously, debhelper would silently change behaviour " +"often resulting in empty binary packages being uploaded to the archive by " +"mistake. With the new behaviour, the B<single-binary> addon will detect the " +"mismatch and warn the maintainer of what is about to happen." msgstr "" -"Appeler B<dh_clean -k> provoque maintenant une erreur à la place de " -"l'avertissement d'obsolescence." +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:49 +msgid "v14" +msgstr "v14" + +# type: textblock #. type: textblock -#: debhelper.pod:988 -msgid "" -"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " -"removed. Please use the new name B<--no-stop-on-upgrade>" -msgstr "" -"L'option B<--no-restart-on-upgrade> de B<dh_installinit> a été supprimée. " -"Veuillez utiliser le nouveau nom B<--no-stop-on-upgrade>." +#: debhelper-compat-upgrade-checklist.pod:53 +msgid "Changes from v13 are:" +msgstr "Les changements par rapport à la version 13 sont :" #. type: textblock -#: debhelper.pod:993 +#: debhelper-compat-upgrade-checklist.pod:59 +#, fuzzy +#| msgid "" +#| "The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> and B<-" +#| "DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some " +#| "reproducibility issues." msgid "" -"There was a bug in the B<doit> (and similar) functions from L<Debian::" -"Debhelper::Dh_Lib> that made them spawn a shell in one particular " -"circumstance. This bug is now removed and will cause helpers that rely on " -"the bug to fail with a \"command not found\"-error." -msgstr "" -"Il y avait un bogue dans les fonctions B<doit> (et équivalent) de L<Debian::" -"Debhelper::Dh_Lib> qui créait un shell dans une circonstance particulière. " -"Ce bogue est maintenant supprimé et provoquera une erreur de type « commande " -"non trouvée » dans les outils qui l'utilisaient." - -#. type: textblock -#: debhelper.pod:1000 -msgid "" -"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " -"removed. Please use B<dh_missing> and its corresponding options, which can " -"also see the files installed by other helpers." -msgstr "" -"Les options B<--list-missing> et B<--fail-missing> de B<dh_install> ont été " -"supprimées. Veuillez utiliser B<dh_missing> et ses options correspondantes, " -"qui peuvent aussi voir les fichiers installés par les autres outils." - -#. type: textblock -#: debhelper.pod:1006 -msgid "" -"The B<dh_installinit> helper no longer installs configuration for the " -"upstart init system. Instead, it will abort the build if it finds an old " -"upstart configuration file. The error is there to remind the package " -"maintainer to ensure the proper removal of the conffiles shipped in previous " -"versions of the package (if any)." -msgstr "" -"L'outil B<dh_installinit> n'installe plus de configuration pour upstart. À " -"la place, il abandonnera la construction s'il trouve un ancien fichier de " -"configuration upstart. Cela pour rappeler au mainteneur de s'assurer de " -"correctement supprimer les anciens fichiers de configuration livrés dans les " -"anciennes versions du paquet." - -#. type: textblock -#: debhelper.pod:1014 -msgid "" -"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" -"maintscript-helper(1)> commands and will error out if the commands appear to " -"be invalid." -msgstr "" -"L'outil B<dh_installdeb> valide basiquement quelques commandes L<dpkg-" -"maintscript-helper(1)> et renvoie une erreur si la commande semble " -"incorrecte." - -#. type: textblock -#: debhelper.pod:1020 -msgid "The B<dh_missing> tool will now default to B<--list-missing>." -msgstr "" -"Le comportement par défaut de B<dh_missing> est maintenant B<--list-missing>." - -#. type: textblock -#: debhelper.pod:1024 -msgid "" -"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" -"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." -msgstr "" -"B<dh_makeshlibs> passera maintenant les bibliothèques à L<dpkg-" -"gensymbols(1)> si le binaire ELF a un SONAME (contenant « .so »)." - -#. type: textblock -#: debhelper.pod:1029 -msgid "" -"The B<dh_compress> tool no longer compresses examples (i.e. anything " -"installed in F<</usr/share/doc/I<package>/examples>>.)" -msgstr "" -"B<dh_compress> ne compresse plus les exemples (c'est-à -dire tout ce qui est " -"installé dans F<</usr/share/doc/I<paquet>/examples>>)." - -#. type: textblock -#: debhelper.pod:1034 -msgid "" -"The standard sequence in B<dh> now includes B<dh_dwz> and " -"B<dh_installinitramfs> by default. This makes the B<dwz> and " -"B<installinitramfs> sequences obsolete and they will now fail with an " -"error. If you want to skip these commands, then please insert an empty " -"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" -msgstr "" -"La séquence standard de B<dh> comprend maintenant B<dh_dwz> et " -"B<dh_installinitramfs> par défaut. Cela rend les séquences B<dwz> et " -"B<installinitramfs> obsolètes et elles échoueront avec une erreur. Si vous " -"souhaitez sauter ces commandes, veuillez insérer des cibles de réécriture " -"vides pour elles dans F<debian/rules> (par exemple I<override_dh_dwz:>)." - -#. type: textblock -#: debhelper.pod:1043 -msgid "" -"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" -"libexecdir> variable and thus relies on the build system default - which " -"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." +"The B<cmake> buildsystem now passes B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to " +"L<cmake(1)> to avoid some reproducibility issues." msgstr "" -"Les systèmes de construction B<meson> et B<autoconf> ne positionnent plus " -"explicitement la variable B<--libexecdir>, et s'appuient donc sur le système " -"de construction par défaut – qui devrait être B</usr/libexec> (selon la " -"FHS 3.0, adoptée dans la Charte Debian 4.1.5)." +"Le système de construction B<cmake> passe maintenant les options B<-" +"DCMAKE_SKIP_RPATH=ON> et B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> à L<cmake(1)> " +"pour éviter des problèmes de reproductibilité." #. type: textblock -#: debhelper.pod:1048 -msgid "" -"If a particular upstream package does not use the correct default, the " -"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " -"via the following example:" -msgstr "" -"Si un paquet amont particulier n'utilise pas la bonne valeur par défaut, le " -"paramètre peut souvent être passé manuellement avec L<dh_auto_configure(1)>. " -"Par exemple :" - -# type: verbatim -#. type: verbatim -#: debhelper.pod:1052 -#, no-wrap +#: debhelper-compat-upgrade-checklist.pod:65 +#, fuzzy +#| msgid "" +#| "The tool B<dh_installsysusers> is now included in the default sequence." msgid "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" +"The tool B<dh_installsysusers> is now included in the default sequence. This " +"helper tool will process systemd sysusers files." msgstr "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" - -#. type: textblock -#: debhelper.pod:1055 -msgid "Note the B<--> before the B<--libexecdir> parameter." -msgstr "Remarquez le B<--> avant le paramètre B<--libexecdir>." +"L'outil B<dh_installsysusers> est maintenant inclus dans la séquence par " +"défaut." #. type: textblock -#: debhelper.pod:1059 +#: debhelper-compat-upgrade-checklist.pod:70 msgid "" -"The B<dh_installdeb> tool no longer installs the maintainer provided " -"F<conffiles> file. The file has mostly been obsolete since compatibility " -"level 3, where B<dh_installdeb> began to automatically compute the resulting " -"F<conffiles> control file." +"Use of the B<dh_gconf> command in override and hook targets now causes an " +"error. The B<dh_gconf> command has been a no-op for years and was removed " +"in debhelper 13.4." msgstr "" -"B<dh_installdeb> n'installe plus le fichier F<conffiles> fournit par le " -"responsable. Ce fichier est obsolète depuis le niveau de compatibilité 3, " -"lorsque B<dh_installdeb> a commencé à calculer automatiquement le " -"F<conffiles> résultant du fichier control." #. type: textblock -#: debhelper.pod:1066 +#: debhelper-compat-upgrade-checklist.pod:76 msgid "" -"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " -"handling systemd services that have a sysvinit alternative. Both tools must " -"now be used in such a case to ensure the service is properly started under " -"both sysvinit and systemd." +"The B<dh> sequencer will warn if the B<single-binary> addon is implicitly " +"activated to warn maintainers of the pending compat 15 change in " +"B<dh_auto_install>." msgstr "" -"B<dh_installsystemd> ne s'appuie plus sur B<dh_installinit> pour s'occuper " -"des services systemd qui ont une alternative pour sysvinit. Les deux outils " -"doivent maintenant être utilisés dans ce cas pour s'assurer que le service " -"est démarré correctement, à la fois avec systemd et sysvinit." #. type: textblock -#: debhelper.pod:1071 +#: debhelper-compat-upgrade-checklist.pod:79 msgid "" -"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" -"start>) then you will probably need one for B<dh_installsystemd> as well now." +"Maintainers are urged to either explicitly activate the B<single-binary> " +"addon to preserve the existing behaviour (e.g., by adding B<dh-sequence-" +"single-binary> to Build-Depends), or explicitly passing B<--destdir> to " +"B<dh_auto_install> if used and then passing B<--without single-binary> to " +"B<dh> (the latter to silence the warning)." msgstr "" -"Si vous avez une réécriture pour B<dh_installinit> (par exemple pour " -"l'appeler avec B<--no-start>), vous en aurez sûrement besoin d'une pour " -"B<dh_installsystemd> aussi." #. type: textblock -#: debhelper.pod:1075 +#: debhelper-compat-upgrade-checklist.pod:92 msgid "" -"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " -"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists B<" -"${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to compat " -"12." +"The B<dh_installalternatives> tool will now be run after B<dh_link> rather " +"than after B<dh_installinitramfs> in the default B<dh> sequence." msgstr "" -"Ce changement amène B<dh_installinit> à injecter un champ I<misc:Pre-" -"Depends> sur B<< init-system-helpers (>= 1.54~) >>. Veuillez vous assurer " -"que le paquet utilise B<${misc:Pre-Depends}> dans son champ B<Pre-Depends> " -"avant de mettre à niveau vers la compat 12." #. type: textblock -#: debhelper.pod:1082 +#: debhelper-compat-upgrade-checklist.pod:97 msgid "" -"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " -"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " -"packages and not only during the building process. Please set " -"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " -"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." +"The B<dh_installpam> tool will now install PAM configuration files under " +"F<< /usr/lib/pam.d/I<package> >> instead of F<< /etc/pam.d/I<package> >>." msgstr "" -"L'outil tiers B<dh_golang> (du paquet B<dh-golang>) utilise maintenant la " -"variable B<DH_GOLANG_EXCLUDE> pour l'installation des sources dans les " -"paquets -dev, et plus uniquement lors de la construction. Veuillez " -"positionner B<DH_GOLANG_EXCLUDES_ALL> à faux pour obtenir le comportement " -"précédent. Consultez B<Debian::Debhelper::Buildsystem::golang(3pm)> pour " -"plus de détails et des exemples." #. type: textblock -#: debhelper.pod:1090 +#: debhelper-compat-upgrade-checklist.pod:100 +#, fuzzy +#| msgid "" +#| "In compatibility level 11, this file will trigger an error with a " +#| "reminder about ensuring the proper removal of the upstart file in the " +#| "previous package version. Please consider using the \"rm_conffile\" " +#| "feature from L<dh_installdeb(1)> to ensure the proper removal of previous " +#| "upstart files." msgid "" -"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " -"default." +"Please consider using the \"rm_conffile\" feature from L<dh_installdeb(1)> " +"to ensure the proper removal of previous PAM files." msgstr "" -"B<dh_installsystemduser> est maintenant inclus par défaut dans la séquence " -"B<dh> standard." +"Dans le niveau de compatibilité 11, ce fichier provoquera une erreur " +"contenant un rappel pour correctement supprimer le fichier upstart de la " +"version précédente du paquet. Veuillez utiliser la fonction « rm_conffile » " +"de L<dh_installdeb(1)> pour vous assurer de la suppression correcte des " +"fichiers upstart." #. type: textblock -#: debhelper.pod:1095 -msgid "" -"The B<python-distutils> buildsystem is now removed. Please use the third-" -"party build system B<pybuild> instead." +#: debhelper-compat-upgrade-checklist.pod:105 +#, fuzzy +#| msgid "" +#| "The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " +#| "test> when running the test suite. Any override of B<dh_auto_test> that " +#| "passes extra parameters to upstream test runner should be reviewed as " +#| "B<meson test> is not command line compatible with B<ninja test>." +msgid "" +"The B<meson+ninja> and B<cmake> build systems now use B<meson install> and " +"B<cmake --install>, respectively, instead of B<ninja install> and B<make " +"install> in the L<dh_auto_install(1)> call. Any override of " +"B<dh_auto_install> that passes extra parameters to the upstream build system " +"should be reviewed." msgstr "" -"Le système de construction B<python-distutils> est supprimé. Veuillez " -"utiliser le système tiers B<pybuild> à la place." +"Le système de construction B<meson+ninja> utilise maintenant B<meson test> à " +"la place de B<ninja test> pour la suite de tests. Chaque réécriture de " +"B<dh_auto_test> qui passe des paramètres supplémentaires aux tests amont " +"devrait être vérifiée, car B<meson test> n'est pas compatible avec B<ninja " +"test>." #. type: =item -#: debhelper.pod:1100 +#: debhelper-compat-upgrade-checklist.pod:112 msgid "v13" msgstr "v13" # type: textblock #. type: textblock -#: debhelper.pod:1102 +#: debhelper-compat-upgrade-checklist.pod:114 msgid "This is the recommended mode of operation." msgstr "C'est la version dont l'usage est recommandé." # type: textblock #. type: textblock -#: debhelper.pod:1104 +#: debhelper-compat-upgrade-checklist.pod:116 msgid "Changes from v12 are:" msgstr "Les changements par rapport à la version 12 sont :" #. type: textblock -#: debhelper.pod:1110 +#: debhelper-compat-upgrade-checklist.pod:122 msgid "" "The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " "test> when running the test suite. Any override of B<dh_auto_test> that " @@ -2586,7 +2912,7 @@ msgstr "" "test>." #. type: textblock -#: debhelper.pod:1118 +#: debhelper-compat-upgrade-checklist.pod:130 msgid "" "All debhelper like tools based on the official debhelper library (including " "B<dh> and the official B<dh_*> tools) no longer accepts abbreviated command " @@ -2600,7 +2926,7 @@ msgstr "" "passent de longues options de ligne de commande." #. type: textblock -#: debhelper.pod:1126 +#: debhelper-compat-upgrade-checklist.pod:138 msgid "" "The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, B<dh_makeshlibs>, " "B<dh_shlibdeps>) are now only run for arch dependent packages by default (i." @@ -2616,7 +2942,7 @@ msgstr "" "Build-Depends explicite à B<dh-sequence-elf-tools>." #. type: textblock -#: debhelper.pod:1135 +#: debhelper-compat-upgrade-checklist.pod:147 msgid "" "The third-party B<gradle> build system (from B<gradle-debian-helper> " "package) now runs the upstream-provided test suite automatically. To " @@ -2628,7 +2954,7 @@ msgstr "" "B<dh_auto_test>." #. type: textblock -#: debhelper.pod:1141 +#: debhelper-compat-upgrade-checklist.pod:153 msgid "" "The B<dh_installman> tool now aborts if it sees conflicting definitions of a " "manpage. This typically happens if the upstream build system is installing " @@ -2646,7 +2972,7 @@ msgstr "" "versions sont identiques)." #. type: textblock -#: debhelper.pod:1151 +#: debhelper-compat-upgrade-checklist.pod:163 msgid "" "The B<dh_auto_*> helpers now reset the environment variables B<HOME> and " "common B<XDG_*> variable. Please see description of the environment " @@ -2658,12 +2984,12 @@ msgstr "" "comment elles sont gérées." #. type: textblock -#: debhelper.pod:1155 +#: debhelper-compat-upgrade-checklist.pod:167 msgid "I<This feature changed between debhelper 13 and debhelper 13.2.>" msgstr "I<Cette fonctionnalité a changé entre debhelper 13 et debhelper 13.2.>" #. type: textblock -#: debhelper.pod:1159 +#: debhelper-compat-upgrade-checklist.pod:171 msgid "" "The B<dh> command will now error if an override or hook target for an " "obsolete command are present in F<debian/rules> (e.g. " @@ -2674,7 +3000,7 @@ msgstr "" "(par exemple, B<override_dh_systemd_enable:>)." #. type: textblock -#: debhelper.pod:1165 +#: debhelper-compat-upgrade-checklist.pod:177 msgid "" "The B<dh_missing> command will now default to B<--fail-missing>. This can " "be reverted to a non-fatal warning by explicitly passing B<--list-missing> " @@ -2685,7 +3011,7 @@ msgstr "" "l'option B<--list-missing> comme dans le niveau de compatibilité 12." #. type: textblock -#: debhelper.pod:1169 +#: debhelper-compat-upgrade-checklist.pod:181 msgid "" "If you do not want the warning either, please omit the call to " "B<dh_missing>. If you use the B<dh> command sequencer, then you can do this " @@ -2698,7 +3024,7 @@ msgstr "" "rules> du paquet correspondant. Comme dans l’exemple :" #. type: verbatim -#: debhelper.pod:1174 +#: debhelper-compat-upgrade-checklist.pod:186 #, no-wrap msgid "" " # Disable dh_missing\n" @@ -2710,7 +3036,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:1179 +#: debhelper-compat-upgrade-checklist.pod:191 msgid "" "The B<dh> command sequencer now runs B<dh_installtmpfiles> in the default " "sequence. The B<dh_installtmpfiles> takes over handling of tmpfiles.d " @@ -2723,7 +3049,7 @@ msgstr "" "dans B<dh_installsystemd> est désormais désactivée." #. type: textblock -#: debhelper.pod:1184 +#: debhelper-compat-upgrade-checklist.pod:196 msgid "" "Note that B<dh_installtmpfiles> responds to F<< debian/I<package>.tmpfiles " ">> where B<dh_installsystemd> used a name without the trailing \"s\"." @@ -2732,7 +3058,7 @@ msgstr "" "où B<dh_installsystemd> utilisait un nom sans le « s » final." #. type: textblock -#: debhelper.pod:1190 +#: debhelper-compat-upgrade-checklist.pod:202 msgid "" "Many B<dh_*> tools now support limited variable expansion via the B<${foo}> " "syntax. In many cases, this can be used to reference paths that contain " @@ -2746,11 +3072,11 @@ msgstr "" "être utilisé pour référencer des chemins qui contiennent soit des espaces, " "soit des valeurs L<dpkg-architecture(1)>. Bien que cela puisse réduire le " "besoin de L<dh-exec(1)> dans certains cas, ce B<n'est pas> une alternative à " -"L<dh-exec(1)> en général. Si un filtrage, un renommage, etc. est " -"nécessaire, le paquet aura encore besoin de L<dh-exec(1)>." +"L<dh-exec(1)> en général. Si un filtrage, un renommage, etc. est nécessaire, " +"le paquet aura encore besoin de L<dh-exec(1)>." #. type: textblock -#: debhelper.pod:1197 +#: debhelper-compat-upgrade-checklist.pod:209 msgid "" "Please see L</Substitutions in debhelper config files> for syntax and " "available substitution variables. To B<dh_*> tool writers, substitution " @@ -2763,7 +3089,7 @@ msgstr "" "intervient comme élément des fonctions B<filearray> et B<filedoublearray>." #. type: textblock -#: debhelper.pod:1204 +#: debhelper-compat-upgrade-checklist.pod:216 msgid "" "The B<dh> command sequencer will now skip all hook and override targets for " "B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> lists " @@ -2775,7 +3101,7 @@ msgstr "" "correspondantes." #. type: textblock -#: debhelper.pod:1208 +#: debhelper-compat-upgrade-checklist.pod:220 msgid "" "Any package relying on these targets to always be run should instead move " "relevant logic out of those targets. E.g. non-test related packaging code " @@ -2789,7 +3115,7 @@ msgstr "" "B<execute_before_dh_auto_install>." #. type: textblock -#: debhelper.pod:1215 +#: debhelper-compat-upgrade-checklist.pod:227 msgid "" "The B<cmake> buildsystem now passes B<-" "DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> to L<cmake(1)> to speed up automatic " @@ -2802,7 +3128,7 @@ msgstr "" "avez besoin de revenir au comportement antérieur, réécrivez le paramètre :" #. type: verbatim -#: debhelper.pod:1219 +#: debhelper-compat-upgrade-checklist.pod:231 #, no-wrap msgid "" " dh_auto_configure -- -DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ...\n" @@ -2812,1134 +3138,1093 @@ msgstr "" "\n" #. type: =item -#: debhelper.pod:1223 -msgid "v14" -msgstr "v14" - -#. type: textblock -#: debhelper.pod:1225 strings-kept-translations.pod:9 -msgid "" -"This compatibility level is still open for development; use with caution." -msgstr "" -"Ce niveau de compatibilité est encore en développement ; à utiliser avec " -"précaution." +#: debhelper-compat-upgrade-checklist.pod:235 +msgid "v12" +msgstr "v12" # type: textblock #. type: textblock -#: debhelper.pod:1227 -msgid "Changes from v13 are:" -msgstr "Les changements par rapport à la version 13 sont :" +#: debhelper-compat-upgrade-checklist.pod:237 +msgid "Changes from v11 are:" +msgstr "Les changements par rapport à la version 11 sont :" #. type: textblock -#: debhelper.pod:1233 +#: debhelper-compat-upgrade-checklist.pod:243 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> and B<-" -"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some " -"reproducibility issues." +"The B<dh_makeshlibs> tool now generates shlibs files with versioned " +"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " +"is now the default." msgstr "" -"Le système de construction B<cmake> passe maintenant les options B<-" -"DCMAKE_SKIP_RPATH=ON> et B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> à L<cmake(1)> " -"pour éviter des problèmes de reproductibilité." +"B<dh_makeshlibs> génère maintenant des fichiers shlibs avec des dépendances " +"versionnées par défaut. Cela veut dire que B<-VUpstream-Version> (ou B<-V>) " +"est maintenant le comportement par défaut." #. type: textblock -#: debhelper.pod:1237 +#: debhelper-compat-upgrade-checklist.pod:247 msgid "" -"This can cause issues with running binaries directly from the build " -"directories as they might now require a manually set B<LD_LIBRARY_PATH>. If " -"you need to override this change, we recommend that you try to pass the B<-" -"DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the problem " -"(leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). This should " -"undo the need for B<LD_LIBRARY_PATH> and avoid the reproducibility issues on " -"Linux, where B<$ORIGIN> is supported by the runtime linkers." +"If an unversioned dependency in the shlibs file is wanted, this can be " +"obtained by passing B<-VNone> instead. However, please see " +"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." msgstr "" -"Cela peut provoquer des problèmes avec l'exécution de binaires directement à " -"partir des répertoires de construction parce qu'ils pourraient maintenant " -"requérir une configuration manuelle de B<LD_LIBRARY_PATH>. S'il est " -"nécessaire de réécrire cette modification, il est recommandé d'essayer de " -"passer d'abord l'option B<-DCMAKE_SKIP_RPATH=OFF> pour voir si cela corrige " -"le problème (laissant B<CMAKE_BUILD_RPATH_USE_ORIGIN> à sa nouvelle valeur " -"par défaut). Cela devrait supprimer la nécessité de B<LD_LIBRARY_PATH> et " -"éviter les problèmes de reproductibilité dans Linux où B<$ORIGIN> est pris " -"en charge par les créateurs de liens lors de l'exécution." +"Si une dépendance non versionnée est requise, cela peut être obtenu en " +"passant B<-VNone> à la place. Veuillez tout de même consulter " +"L<dh_makeshlibs(1)> pour l'utilisation des dépendances non versionnées." +# type: =item #. type: textblock -#: debhelper.pod:1247 -msgid "The tool B<dh_installsysusers> is now included in the default sequence." +#: debhelper-compat-upgrade-checklist.pod:253 +msgid "" +"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " +"instead." msgstr "" -"L'outil B<dh_installsysusers> est maintenant inclus dans la séquence par " -"défaut." - -# type: =head1 -#. type: =head1 -#: debhelper.pod:1253 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 -#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:92 -#: dh_installinit:205 dh_installinitramfs:60 dh_installman:131 -#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 -#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:104 -#: dh_systemd_start:68 -msgid "NOTES" -msgstr "REMARQUES" - -# type: =head2 -#. type: =head2 -#: debhelper.pod:1255 -msgid "Multiple binary package support" -msgstr "Prise en charge de plusieurs paquets binaires" +"L'option B<-s> (B<--same-arch>) est supprimée. Veuillez utiliser B<-a> (B<--" +"arch>) à la place." -# type: textblock #. type: textblock -#: debhelper.pod:1257 +#: debhelper-compat-upgrade-checklist.pod:257 msgid "" -"If your source package generates more than one binary package, debhelper " -"programs will default to acting on all binary packages when run. If your " -"source package happens to generate one architecture dependent package, and " -"another architecture independent package, this is not the correct behavior, " -"because you need to generate the architecture dependent packages in the " -"binary-arch F<debian/rules> target, and the architecture independent " -"packages in the binary-indep F<debian/rules> target." +"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." msgstr "" -"Si le paquet source produit plus d'un paquet binaire, les programmes de " -"debhelper construiront tous les paquets binaires. Si le paquet source doit " -"construire un paquet dépendant de l'architecture et un paquet indépendant de " -"l'architecture, ce comportement ne conviendra pas. En effet, il convient de " -"construire les paquets dépendants de l'architecture dans « binary-arch » de " -"F<debian/rules>, et les paquets indépendants de l'architecture dans « binary-" -"indep »." +"Appeler B<dh_clean -k> provoque maintenant une erreur à la place de " +"l'avertissement d'obsolescence." -# type: textblock #. type: textblock -#: debhelper.pod:1265 +#: debhelper-compat-upgrade-checklist.pod:262 msgid "" -"To facilitate this, as well as give you more control over which packages are " -"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" -"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " -"are given, debhelper programs default to acting on all packages listed in " -"the control file, with the exceptions below." +"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " +"removed. Please use the new name B<--no-stop-on-upgrade>" msgstr "" -"Pour résoudre ce problème, et pour un meilleur contrôle sur la construction " -"des paquets par debhelper, tous les programmes de debhelper acceptent les " -"options B<-a>, B<-i>, B<-p> et B<-s>. Ces options sont cumulatives. Si " -"aucune n'est précisée, les programmes de debhelper construisent tous les " -"paquets énumérés dans le fichier de contrôle, avec les exceptions ci-dessous." +"L'option B<--no-restart-on-upgrade> de B<dh_installinit> a été supprimée. " +"Veuillez utiliser le nouveau nom B<--no-stop-on-upgrade>." #. type: textblock -#: debhelper.pod:1271 +#: debhelper-compat-upgrade-checklist.pod:267 msgid "" -"First, any package whose B<Architecture> field in B<debian/control> does not " -"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " -"section 5.6.8>)." -msgstr "" -"Tout d'abord, chaque paquet dont le champ B<Architecture> de I<debian/" -"control> ne contient pas l'architecture B<DEB_HOST_ARCH> sera exclu " -"(L<Charte Debian, section 5.6.8>)." - -#. type: textblock -#: debhelper.pod:1275 -msgid "" -"Also, some additional packages may be excluded based on the contents of the " -"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " -"binary package stanzas in B<debian/control>, according to the draft policy " -"at L<https://wiki.debian.org/BuildProfileSpec>." +"There was a bug in the B<doit> (and similar) functions from L<Debian::" +"Debhelper::Dh_Lib> that made them spawn a shell in one particular " +"circumstance. This bug is now removed and will cause helpers that rely on " +"the bug to fail with a \"command not found\"-error." msgstr "" -"De plus, quelques autres paquets peuvent être exclus suivant le contenu de " -"la variable d'environnement B<DEB_BUILD_PROFILES> et les champs B<Build-" -"Profiles> des paragraphes I<debian/control> dans les paquets binaires, " -"conformément au brouillon de la charte (voir L<https://wiki.debian.org/" -"BuildProfileSpec>)." - -#. type: =head3 -#: debhelper.pod:1280 -msgid "Interaction between package selections and Build-Profiles" -msgstr "Interaction entre les sélections de paquets et les Build-Profiles" +"Il y avait un bogue dans les fonctions B<doit> (et équivalent) de L<Debian::" +"Debhelper::Dh_Lib> qui créait un shell dans une circonstance particulière. " +"Ce bogue est maintenant supprimé et provoquera une erreur de type « commande " +"non trouvée » dans les outils qui l'utilisaient." #. type: textblock -#: debhelper.pod:1282 +#: debhelper-compat-upgrade-checklist.pod:274 msgid "" -"Build-Profiles affect which packages are included in the package selections " -"mechanisms in debhelper. Generally, the package selections are described " -"from the assumption that all packages are enabled. This section describes " -"how the selections react when a package is disabled due to the active Build-" -"Profiles (or lack of active Build-Profiles)." -msgstr "" -"Les profils de construction (« Build-Profiles ») ont un effet sur le choix " -"des paquets inclus dans les mécanismes de sélection de paquets de debhelper. " -"Généralement, les sélections partent du principe que tous les paquets sont " -"activés. Cette section décrit comment les sélections fonctionnent lorsqu'un " -"paquet est désactivé par un profil de construction (ou par son absence)." - -#. type: =item -#: debhelper.pod:1290 -msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " +"removed. Please use B<dh_missing> and its corresponding options, which can " +"also see the files installed by other helpers." msgstr "" -"B<-a>/B<--arch>, B<-i>/B<--indep> ou aucune option de sélection (un simple " -"appel « dh_X »)" +"Les options B<--list-missing> et B<--fail-missing> de B<dh_install> ont été " +"supprimées. Veuillez utiliser B<dh_missing> et ses options correspondantes, " +"qui peuvent aussi voir les fichiers installés par les autres outils." #. type: textblock -#: debhelper.pod:1292 +#: debhelper-compat-upgrade-checklist.pod:280 msgid "" -"The package disabled by Build-Profiles is silently excluded from the " -"selection." +"The B<dh_installinit> helper no longer installs configuration for the " +"upstart init system. Instead, it will abort the build if it finds an old " +"upstart configuration file. The error is there to remind the package " +"maintainer to ensure the proper removal of the conffiles shipped in previous " +"versions of the package (if any)." msgstr "" -"Le paquet désactivé par le profil est silencieusement exclu de la sélection." +"L'outil B<dh_installinit> n'installe plus de configuration pour upstart. À " +"la place, il abandonnera la construction s'il trouve un ancien fichier de " +"configuration upstart. Cela pour rappeler au mainteneur de s'assurer de " +"correctement supprimer les anciens fichiers de configuration livrés dans les " +"anciennes versions du paquet." #. type: textblock -#: debhelper.pod:1295 +#: debhelper-compat-upgrade-checklist.pod:288 msgid "" -"Note you will receive a warning if I<all> packages related to these " -"selections are disabled. In that case, it generally does not make sense to " -"do the build in the first place." +"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" +"maintscript-helper(1)> commands and will error out if the commands appear to " +"be invalid." msgstr "" -"Veuillez noter que vous recevrez un avertissement si I<tous> les paquets " -"relatifs à cette sélection sont désactivés. Dans ce cas, il est généralement " -"d'aucune utilité de construire." - -# type: =item -#. type: =item -#: debhelper.pod:1299 -msgid "-N I<package> / --no-package I<package>" -msgstr "B<-N> I<paquet> / B<--no-package> I<paquet>" - -#. type: textblock -#: debhelper.pod:1301 -msgid "The option is accepted and effectively does nothing." -msgstr "Cette option est acceptée et ne fait rien." - -# type: =item -#. type: =item -#: debhelper.pod:1303 -msgid "-p I<package> / --package I<package>" -msgstr "B<-p> I<paquet> / B<--package> I<paquet>" +"L'outil B<dh_installdeb> valide basiquement quelques commandes L<dpkg-" +"maintscript-helper(1)> et renvoie une erreur si la commande semble " +"incorrecte." #. type: textblock -#: debhelper.pod:1305 -msgid "The option is accepted, but debhelper will not act on the package." -msgstr "Cette option est acceptée, mais debhelper n'agira pas sur le paquet." +#: debhelper-compat-upgrade-checklist.pod:294 +msgid "The B<dh_missing> tool will now default to B<--list-missing>." +msgstr "" +"Le comportement par défaut de B<dh_missing> est maintenant B<--list-missing>." #. type: textblock -#: debhelper.pod:1309 +#: debhelper-compat-upgrade-checklist.pod:298 msgid "" -"Note that it does not matter whether a package is enabled or disabled by " -"default." +"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" +"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." msgstr "" -"Veuillez noter que cela n'a pas d'importance que le paquet soit activé ou " -"désactivé par défaut." - -# type: =head2 -#. type: =head2 -#: debhelper.pod:1312 -msgid "Automatic generation of Debian install scripts" -msgstr "Génération automatique des scripts Debian d’installation" +"B<dh_makeshlibs> passera maintenant les bibliothèques à L<dpkg-" +"gensymbols(1)> si le binaire ELF a un SONAME (contenant « .so »)." -# type: textblock #. type: textblock -#: debhelper.pod:1314 +#: debhelper-compat-upgrade-checklist.pod:303 msgid "" -"Some debhelper commands will automatically generate parts of Debian " -"maintainer scripts. If you want these automatically generated things " -"included in your existing Debian maintainer scripts, then you need to add " -"B<#DEBHELPER#> to your scripts, in the place the code should be added. " -"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " -"B<dh_installdeb>." +"The B<dh_compress> tool no longer compresses examples (i.e. anything " +"installed in F<</usr/share/doc/I<package>/examples>>.)" msgstr "" -"Certaines commandes de debhelper produisent automatiquement des lignes de " -"code de maintenance du paquet. Pour les inclure dans vos propres scripts de " -"maintenance du paquet, il convient d'ajouter B<#DEBHELPER#> à l'endroit où " -"les lignes de code générées devront être insérées. B<#DEBHELPER#> sera " -"remplacé, par les lignes de code générées automatiquement, lors de " -"l'exécution de B<dh_installdeb>." +"B<dh_compress> ne compresse plus les exemples (c'est-à -dire tout ce qui est " +"installé dans F<</usr/share/doc/I<paquet>/examples>>)." -# type: textblock #. type: textblock -#: debhelper.pod:1321 +#: debhelper-compat-upgrade-checklist.pod:308 msgid "" -"If a script does not exist at all and debhelper needs to add something to " -"it, then debhelper will create the complete script." +"The standard sequence in B<dh> now includes B<dh_dwz> and " +"B<dh_installinitramfs> by default. This makes the B<dwz> and " +"B<installinitramfs> sequences obsolete and they will now fail with an " +"error. If you want to skip these commands, then please insert an empty " +"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" msgstr "" -"Si un script de maintenance n'existe pas et que debhelper doit y inclure " -"quelque chose, alors debhelper créera le script de maintenance complètement." +"La séquence standard de B<dh> comprend maintenant B<dh_dwz> et " +"B<dh_installinitramfs> par défaut. Cela rend les séquences B<dwz> et " +"B<installinitramfs> obsolètes et elles échoueront avec une erreur. Si vous " +"souhaitez sauter ces commandes, veuillez insérer des cibles de réécriture " +"vides pour elles dans F<debian/rules> (par exemple I<override_dh_dwz:>)." -# type: textblock #. type: textblock -#: debhelper.pod:1324 +#: debhelper-compat-upgrade-checklist.pod:317 msgid "" -"All debhelper commands that automatically generate code in this way let it " -"be disabled by the -n parameter (see above)." +"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" +"libexecdir> variable and thus relies on the build system default - which " +"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." msgstr "" -"Toutes les commandes de debhelper qui produisent automatiquement des lignes " -"de code de cette façon peuvent inhiber cette production grâce à l'option B<-" -"n> (voir ci-dessus)." +"Les systèmes de construction B<meson> et B<autoconf> ne positionnent plus " +"explicitement la variable B<--libexecdir>, et s'appuient donc sur le système " +"de construction par défaut – qui devrait être B</usr/libexec> (selon la " +"FHS 3.0, adoptée dans la Charte Debian 4.1.5)." -# type: textblock #. type: textblock -#: debhelper.pod:1327 +#: debhelper-compat-upgrade-checklist.pod:322 msgid "" -"Note that the inserted code will be shell code, so you cannot directly use " -"it in a Perl script. If you would like to embed it into a Perl script, here " -"is one way to do that (note that I made sure that $1, $2, etc are set with " -"the set command):" +"If a particular upstream package does not use the correct default, the " +"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " +"via the following example:" msgstr "" -"Nota : Les lignes de code insérées seront écrites dans le langage de " -"l'interpréteur de commandes (shell). De ce fait, il est impossible de les " -"placer directement dans un script Perl. Pour les insérer dans un script " -"Perl, voici une solution (s'assurer que $1, $2, etc., sont bien définis par " -"la commande set) :" +"Si un paquet amont particulier n'utilise pas la bonne valeur par défaut, le " +"paramètre peut souvent être passé manuellement avec L<dh_auto_configure(1)>. " +"Par exemple :" +# type: verbatim #. type: verbatim -#: debhelper.pod:1332 +#: debhelper-compat-upgrade-checklist.pod:326 #, no-wrap msgid "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"The debhelper script failed with error code: ${exit_code}\");\n" -" } else {\n" -" die(\"The debhelper script was killed by signal: ${signal}\");\n" -" }\n" -" }\n" +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" "\n" msgstr "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"Le script debhelper a échoué avec le code d'erreur : ${exit_code}\");\n" -" } else {\n" -" die(\"Le script debhelper a été tué par le signal : ${signal}\");\n" -" }\n" -" }\n" +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" "\n" -# type: =head2 -#. type: =head2 -#: debhelper.pod:1345 -msgid "Automatic generation of miscellaneous dependencies." -msgstr "Génération automatique des diverses dépendances." +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:329 +msgid "Note the B<--> before the B<--libexecdir> parameter." +msgstr "Remarquez le B<--> avant le paramètre B<--libexecdir>." -# type: textblock #. type: textblock -#: debhelper.pod:1347 -msgid "" -"Some debhelper commands may make the generated package need to depend on " -"some other packages. For example, if you use L<dh_installdebconf(1)>, your " -"package will generally need to depend on debconf. Or if you use " -"L<dh_installxfonts(1)>, your package will generally need to depend on a " -"particular version of xutils. Keeping track of these miscellaneous " -"dependencies can be annoying since they are dependent on how debhelper does " -"things, so debhelper offers a way to automate it." +#: debhelper-compat-upgrade-checklist.pod:333 +msgid "B<Retroactively removed in debhelper/13.5>:" msgstr "" -"Certaines commandes de debhelper peuvent nécessiter des dépendances entre le " -"paquet construit et d'autres paquets. Par exemple, si " -"L<dh_installdebconf(1)> est employé, le paquet devra dépendre de debconf. Si " -"L<dh_installxfonts(1)> est employé, le paquet deviendra dépendant d'une " -"version particulière de xutils. Maintenir ces dépendances induites peut être " -"pénible puisqu'elles découlent de la façon dont debhelper travaille. C'est " -"pourquoi debhelper offre une solution d'automatisation." -# type: textblock #. type: textblock -#: debhelper.pod:1355 +#: debhelper-compat-upgrade-checklist.pod:335 +#, fuzzy +#| msgid "" +#| "The B<dh_installdeb> tool no longer installs the maintainer provided " +#| "F<conffiles> file. The file has mostly been obsolete since compatibility " +#| "level 3, where B<dh_installdeb> began to automatically compute the " +#| "resulting F<conffiles> control file." msgid "" -"All commands of this type, besides documenting what dependencies may be " -"needed on their man pages, will automatically generate a substvar called B<" -"${misc:Depends}>. If you put that token into your F<debian/control> file, it " -"will be expanded to the dependencies debhelper figures you need." +"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+." msgstr "" -"Toutes les commandes de ce type, outre qu'elles documentent, dans leur page " -"de manuel, les dépendances qu'elle induisent, généreront automatiquement une " -"variable de substitution nommée B<${misc:depends}>. Si cette variable est " -"exploitée dans le dossier F<debian/control>, il sera automatiquement enrichi " -"des dépendances induites par debhelper." +"B<dh_installdeb> n'installe plus le fichier F<conffiles> fournit par le " +"responsable. Ce fichier est obsolète depuis le niveau de compatibilité 3, " +"lorsque B<dh_installdeb> a commencé à calculer automatiquement le " +"F<conffiles> résultant du fichier control." -# type: textblock #. type: textblock -#: debhelper.pod:1360 +#: debhelper-compat-upgrade-checklist.pod:342 msgid "" -"This is entirely independent of the standard B<${shlibs:Depends}> generated " -"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " -"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " -"guesses don't match reality." +"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " +"handling systemd services that have a sysvinit alternative. Both tools must " +"now be used in such a case to ensure the service is properly started under " +"both sysvinit and systemd." msgstr "" -"Ce processus est entièrement indépendant de B<${shlibs:Depends}> standard, " -"produite par L<dh_makeshlibs(1)>, et de B<${perl:Depends}> produite par " -"L<dh_perl(1)>. Il est également possible de choisir de ne pas les utiliser " -"si les conjectures de debhelper ne correspondent pas à la réalité." - -# type: =head2 -#. type: =head2 -#: debhelper.pod:1365 -msgid "Package build directories" -msgstr "Répertoires de construction du paquet" +"B<dh_installsystemd> ne s'appuie plus sur B<dh_installinit> pour s'occuper " +"des services systemd qui ont une alternative pour sysvinit. Les deux outils " +"doivent maintenant être utilisés dans ce cas pour s'assurer que le service " +"est démarré correctement, à la fois avec systemd et sysvinit." -# type: textblock #. type: textblock -#: debhelper.pod:1367 +#: debhelper-compat-upgrade-checklist.pod:347 msgid "" -"By default, all debhelper programs assume that the temporary directory used " -"for assembling the tree of files in a package is debian/I<package>." +"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" +"start>) then you will probably need one for B<dh_installsystemd> as well now." msgstr "" -"Par défaut, tous les programmes de debhelper supposent que le répertoire " -"temporaire utilisé pour construire l'arborescence des fichiers d'un paquet " -"est debian/I<paquet>." +"Si vous avez une réécriture pour B<dh_installinit> (par exemple pour " +"l'appeler avec B<--no-start>), vous en aurez sûrement besoin d'une pour " +"B<dh_installsystemd> aussi." -# type: textblock #. type: textblock -#: debhelper.pod:1370 +#: debhelper-compat-upgrade-checklist.pod:351 msgid "" -"Sometimes, you might want to use some other temporary directory. This is " -"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/tmp>" -"\", will use B<debian/tmp> as the temporary directory. Note that if you use " -"B<-P>, the debhelper programs can only be acting on a single package at a " -"time. So if you have a package that builds many binary packages, you will " -"need to also use the B<-p> flag to specify which binary package the " -"debhelper program will act on." +"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " +"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists " +"B<${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to " +"compat 12." msgstr "" -"Parfois, il peut être souhaitable d'utiliser un autre répertoire temporaire. " -"C'est obtenu grâce à l'attribut B<-P>. Par exemple, B<dh_installdocs -" -"Pdebian/tmp> utilisera B<debian/tmp> comme répertoire temporaire. Nota : " -"L'usage de B<-P> implique que les programmes de debhelper ne construisent " -"qu'un seul paquet à la fois. De ce fait, si le paquet source génère " -"plusieurs paquets binaires, il faudra employer également le paramètre B<-p> " -"pour préciser l'unique paquet binaire à construire." +"Ce changement amène B<dh_installinit> à injecter un champ I<misc:Pre-" +"Depends> sur B<< init-system-helpers (>= 1.54~) >>. Veuillez vous assurer " +"que le paquet utilise B<${misc:Pre-Depends}> dans son champ B<Pre-Depends> " +"avant de mettre à niveau vers la compat 12." -# type: =head2 -#. type: =head2 -#: debhelper.pod:1378 -msgid "udebs" -msgstr "udebs" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:358 +msgid "" +"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " +"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " +"packages and not only during the building process. Please set " +"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " +"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." +msgstr "" +"L'outil tiers B<dh_golang> (du paquet B<dh-golang>) utilise maintenant la " +"variable B<DH_GOLANG_EXCLUDE> pour l'installation des sources dans les " +"paquets -dev, et plus uniquement lors de la construction. Veuillez " +"positionner B<DH_GOLANG_EXCLUDES_ALL> à faux pour obtenir le comportement " +"précédent. Consultez B<Debian::Debhelper::Buildsystem::golang(3pm)> pour " +"plus de détails et des exemples." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:366 +msgid "" +"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " +"default." +msgstr "" +"B<dh_installsystemduser> est maintenant inclus par défaut dans la séquence " +"B<dh> standard." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:371 +msgid "" +"The B<python-distutils> buildsystem is now removed. Please use the third-" +"party build system B<pybuild> instead." +msgstr "" +"Le système de construction B<python-distutils> est supprimé. Veuillez " +"utiliser le système tiers B<pybuild> à la place." + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:376 +msgid "v11" +msgstr "v11" # type: textblock #. type: textblock -#: debhelper.pod:1380 +#: debhelper-compat-upgrade-checklist.pod:378 +msgid "This mode is discouraged." +msgstr "Ce mode est déconseillé." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:380 msgid "" -"Debhelper includes support for udebs. To create a udeb with debhelper, add " -"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " -"Debhelper will try to create udebs that comply with debian-installer policy, " -"by making the generated package files end in F<.udeb>, not installing any " -"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " -"and F<config> scripts, etc." +"The compat 11 is discouraged for new packages as it suffers from feature " +"interaction between L<dh_installinit> and L<dh_installsystemd> causing " +"services to not run correctly in some cases. Please consider using " +"compatibility mode 10 or 12 instead. More details about the issue are " +"available in Debian#887904 and L<https://lists.debian.org/debian-" +"release/2019/04/msg01442.html>." msgstr "" -"Debhelper prend en charge la construction des udebs. Pour créer un udeb avec " -"debhelper, il faut ajouter « B<Package-Type: udeb> » aux lignes de paquet " -"dans F<debian/control>. Debhelper essayera de construire des udebs, " -"conformément aux règles de l'installateur Debian, en suffixant les fichiers " -"de paquets générés avec F<.udeb>, en n'installant aucune documentation dans " -"un udeb, en omettant les scripts F<preinst>, F<postrm>, F<prerm> et " -"F<config>, etc." +"Le niveau de compatibilité 11 est déconseillé pour les nouveaux paquets " +"parce qu'il souffre d'une interaction de fonctionnalités entre " +"L<dh_installinit> et L<dh_installsystemd> faisant que les services ne " +"fonctionnent pas correctement dans certains cas. Vous devriez envisager " +"l'utilisation à la place des modes de compatibilité 10 ou 12. Plus de " +"détails sur ce problème sont disponibles dans le bogue Debian n° 887904 et " +"dans le message L<https://lists.debian.org/debian-release/2019/04/msg01442." +"html>." -# type: =head1 -#. type: =head1 -#: debhelper.pod:1387 -msgid "ENVIRONMENT" -msgstr "VARIABLES D'ENVIRONNEMENT" +# type: textblock +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:387 +msgid "Changes from v10 are:" +msgstr "Les changements par rapport à la version 10 sont :" #. type: textblock -#: debhelper.pod:1389 +#: debhelper-compat-upgrade-checklist.pod:393 msgid "" -"This section describes some of the environment variables that influences the " -"behaviour of debhelper or which debhelper interacts with." +"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " +"generates maintainer scripts for those files. Please use the new " +"B<dh_installsystemd> helper." msgstr "" -"Cette section décrit certaines des variables d'environnement qui influencent " -"le comportement de debhelper ou avec lesquelles debhelper est en interaction." +"B<dh_installinit> n'installe plus de fichiers F<service> ou F<tmpfile>, ni " +"ne crée de scripts de maintenance pour ces fichiers. Veuillez utiliser le " +"nouvel assistant B<dh_installsystemd> à la place." #. type: textblock -#: debhelper.pod:1392 +#: debhelper-compat-upgrade-checklist.pod:399 msgid "" -"It is important to note that these must be actual environment variables in " -"order to affect the behaviour of debhelper (not simply F<Makefile> " -"variables). To specify them properly in F<debian/rules>, be sure to " -"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." +"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " +"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " +"sequence for B<dh> has also been removed. If you need to disable the " +"B<dh_installsystemd> helper tool, please use an empty override target." msgstr "" -"Il est important de noter que celles-ci doivent être des variables " -"existantes pour affecter le comportement de debhelper (pas simplement des " -"variables de F<Makefile>). Pour les définir proprement dans le fichier " -"F<debian/rules>, assurez-vous de les exporter (« B<export> »). Par exemple " -"« B<export DH_VERBOSE> »." +"Les outils B<dh_systemd_enable> et B<dh_systemd_start> ont été remplacés par " +"un nouvel assistant B<dh_installsystemd>. Pour la même raison, la séquence " +"B<systemd> de B<dh> a aussi été retirée. Si vous avez besoin de désactiver " +"B<dh_installsystemd>, veuillez utiliser une cible de réécriture vide." -# type: =item -#. type: =item -#: debhelper.pod:1399 -msgid "B<DH_VERBOSE>" -msgstr "B<DH_VERBOSE>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:405 +msgid "" +"Please note that the B<dh_installsystemd> tool has a slightly different " +"behaviour in some cases (e.g. when using the B<--name> parameter)." +msgstr "" +"Veuillez noter que B<dh_installsystemd> a un comportement légèrement " +"différent dans certains cas (par exemple lors de l'utilisation du paramètre " +"B<--name>)." -# type: textblock #. type: textblock -#: debhelper.pod:1401 +#: debhelper-compat-upgrade-checklist.pod:411 msgid "" -"Set to B<1> to enable verbose mode. Debhelper will output every command it " -"runs. Also enables verbose build logs for some build systems like autoconf." +"B<dh_installdirs> no longer creates debian/I<package> directories unless " +"explicitly requested (or it has to create a subdirectory in it)." msgstr "" -"Mettre cette variable à B<1> valide le mode verbeux. Debhelper affichera " -"chaque commande exécutée. Valide aussi les journaux de construction bavards " -"pour certains systèmes de construction comme autoconf." +"B<dh_installdirs> ne crée plus les répertoires debian/I<paquet> sans qu'on " +"le lui demande explicitement (ou il doit créer un sous-répertoire à " +"l'intérieur)." -# type: =item -#. type: =item -#: debhelper.pod:1404 -msgid "B<DH_QUIET>" -msgstr "B<DH_QUIET>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:415 +msgid "The vast majority of all packages will be unaffected by this change." +msgstr "" +"La grande majorité des paquets ne seront pas affectés par ce changement." #. type: textblock -#: debhelper.pod:1406 +#: debhelper-compat-upgrade-checklist.pod:419 msgid "" -"Set to B<1> to enable quiet mode. Debhelper will not output commands calling " -"the upstream build system nor will dh print which subcommands are called and " -"depending on the upstream build system might make that more quiet, too. " -"This makes it easier to spot important messages but makes the output quite " -"useless as buildd log. Ignored if DH_VERBOSE is also set." +"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" +"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " +"or B<cmake>) are unaffected by this change." msgstr "" -"Mettre cette variable à B<1> valide le mode silencieux. Debhelper " -"n'affichera aucune commande appelant le système de construction amont, et dh " -"n'affichera aucune des sous-commandes appelées. En fonction du système de " -"construction amont, cela pourra le rendre encore plus silencieux. Cela " -"facilite la détection des messages importants, mais rend la sortie inutile " -"en tant que journal de construction. Cette valeur est ignorée si " -"B<DH_VERBOSE> est aussi positionnée." +"Le système de construction B<makefile> passe maintenant les options " +"B<INSTALL=\"install --strip-program=true\"> à L<make(1)>. Les systèmes " +"dérivés (comme B<configure> ou B<cmake>) ne sont pas affectés par ce " +"changement." -# type: =item -#. type: =item -#: debhelper.pod:1413 -msgid "B<DH_COMPAT>" -msgstr "B<DH_COMPAT>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:425 +msgid "" +"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" +"configure>." +msgstr "" +"Le système de construction B<autoconf> passe maintenant l'option B<--" +"runstatedir=/run> à F<./configure>." -# type: textblock #. type: textblock -#: debhelper.pod:1415 +#: debhelper-compat-upgrade-checklist.pod:430 msgid "" -"Temporarily specifies what compatibility level debhelper should run at, " -"overriding any value specified via Build-Depends on debhelper-compat or via " -"the F<debian/compat> file." +"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " +"L<cmake(1)>." msgstr "" -"Indique temporairement le niveau de compatibilité avec lequel debhelper doit " -"fonctionner. Cette valeur supplante toute valeur précisée par Build-Depends " -"sur debhelper-compat ou dans F<debian/compat>." +"Le système de construction B<cmake> passe maintenant l'option B<-" +"DCMAKE_INSTALL_RUNSTATEDIR=/run> à L<cmake(1)>." -# type: =item -#. type: =item -#: debhelper.pod:1419 -msgid "B<DH_NO_ACT>" -msgstr "B<DH_NO_ACT>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:435 +msgid "" +"B<dh_installman> will now prefer detecting the language from the path name " +"rather than the extension." +msgstr "" +"B<dh_installman> préfère maintenant détecter le langage à partir du chemin " +"plutôt que de l'extension." -# type: textblock #. type: textblock -#: debhelper.pod:1421 -msgid "Set to B<1> to enable no-act mode." -msgstr "Mettre cette variable à B<1> pour activer le mode simulation (no-act)." +#: debhelper-compat-upgrade-checklist.pod:440 +msgid "" +"B<dh_auto_install> will now only create the destination directory it needs. " +"Previously, it would create the package build directory for all packages. " +"This will not affect packages that only build with debhelper commands, but " +"it may expose bugs in commands not included in debhelper." +msgstr "" +"B<dh_auto_install> crée maintenant uniquement le répertoire de destination " +"nécessaire. Auparavant, le répertoire de construction de chaque paquet était " +"créé. Cela n'affectera pas les paquets qui se construisent uniquement avec " +"debhelper, mais pourrait faire apparaître des bogues dans les commandes qui " +"ne sont pas incluses avec debhelper." -# type: =item -#. type: =item -#: debhelper.pod:1423 -msgid "B<DH_OPTIONS>" -msgstr "B<DH_OPTIONS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:448 +msgid "" +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now error out if their config has a pattern that does not " +"match anything or reference a path that does not exist." +msgstr "" +"Les outils B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo> et " +"B<dh_installman> renvoient maintenant une erreur si leur configuration " +"contient un motif qui ne correspond à rien ou qui référence un chemin qui " +"n'existe pas." #. type: textblock -#: debhelper.pod:1425 +#: debhelper-compat-upgrade-checklist.pod:452 msgid "" -"All debhelper tools will parse command line arguments listed in this " -"variable before any command option (as if they had been prepended to the " -"command line arguments). Unfortunately, some third-party provided tools may " -"not support this variable and will ignore these command line arguments." +"Known exceptions include building with the B<nodoc> profile, where the above " +"tools will silently permit failed matches where the patterns are used to " +"specify documentation." msgstr "" -"Tous les outils de debhelper analyseront les arguments de la ligne de " -"commande listés dans cette variable avant toute option de commande (comme " -"s'ils avaient été ajoutés au début des arguments de la ligne de commande). " -"Malheureusement, certains outils tiers peuvent ne pas prendre en compte " -"cette variable et ignoreront ces arguments." +"Les exceptions connues incluent la construction avec le profil B<nodoc>, où " +"les outils ci-dessus permettront un échec silencieux de la correspondance " +"lorsque le motif est utilisé pour spécifier la documentation." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:458 +msgid "" +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " +"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " +"B<dh_install>." +msgstr "" +"Les outils B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo> et " +"B<dh_installman> acceptent maintenant le paramètre B<--sourcedir> avec la " +"même signification que dans B<dh_install>. De plus, ils se rabattent sur " +"F<debian/tmp> comme B<dh_install>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:463 +msgid "" +"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " +"incorrectly ignore B<--sourcedir>." +msgstr "" +"Note de migration : un bogue dans debhelper 11 jusqu'à 11.1.5 faisait que " +"B<dh_installinfo> ignorait B<--sourcedir> de manière incorrecte." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:468 +msgid "" +"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)." +msgstr "" +"Les systèmes de construction B<perl-makemaker> et B<perl-build> ne passent " +"plus l'option B<-I.> à Perl. Les paquets qui ont encore besoin de ce " +"comportement peuvent l'émuler en utilisant la variable d'environnement " +"B<PERL5LIB>. Par exemple en ajoutant B<export PERL5LIB=.> dans leur fichier " +"F<debian/rules> (ou équivalent)." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:475 +msgid "" +"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " +"any of the B<dh_auto_*> tools. It was added as a temporary work around to " +"avoid a lot of packages failing to build at the same time." +msgstr "" +"La variable d'environnement B<PERL_USE_UNSAFE_INC> n'est plus définie par " +"B<dh>, ni aucun des outils B<dh_auto_*>. Cela avait été ajouté comme " +"contournement temporaire, pour éviter les échecs de construction d’un grand " +"nombre de paquets en même temps." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:480 +msgid "" +"Note this item will eventually become obsolete as upstream intends to drop " +"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " +"drops support for it, then this variable will be removed retroactively from " +"existing compat levels as well." +msgstr "" +"De plus, cette fonction deviendra peut-être obsolète car l'amont a " +"l'intention de retirer la prise en charge de la variable d'environnement " +"B<PERL_USE_UNSAFE_INC>. Lorsque ce sera le cas, cette variable sera aussi " +"supprimée rétroactivement des niveaux de compatibilité existants." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:487 +msgid "" +"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " +"non-zero exit from analysing a given file." +msgstr "" +"L'assistant B<dh_makeshlibs> termine maintenant sur une erreur si objdump " +"renvoie une valeur de sortie différente de zéro lors de l'analyse d'un " +"fichier." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:492 +msgid "" +"The B<dh_installdocs> and B<dh_installexamples> tools may now install " +"I<most> of the documentation in a different path to comply with the " +"recommendation from Debian policy §12.3 (since version 3.9.7)." +msgstr "" +"Les outils B<dh_installdocs> et B<dh_installexamples> pourraient maintenant " +"installer I<la plupart> de la documentation dans un répertoire différent, " +"pour satisfaire les recommandations de la Charte Debian §12.3 (depuis la " +"version 3.9.7)." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:496 +msgid "" +"Note that if a given source package only contains a single binary package in " +"F<debian/control> or none of the packages are I<-doc> packages, then this " +"change is not relevant for that source package and you can skip to the next " +"change." +msgstr "" +"Si un paquet source contient un seul paquet binaire dans F<debian/control>, " +"ou si aucun des paquets n'est un paquet I<-doc>, alors ce changement n'a pas " +"d'effet pour ce paquet source, et vous pouvez aller au changement suivant." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:501 +msgid "" +"By default, these tools will now attempt to determine a \"main package for " +"the documentation\" (called a I<doc-main-package> from here on) for every I<-" +"doc> package. If they find such a I<doc-main-package>, they will now " +"install the documentation into the path F<< /usr/share/doc/I<doc-main-" +"package> >> in the given doc package. I.e. the path can change but the " +"documentation is still shipped in the I<-doc> package." +msgstr "" +"Par défaut, ces outils essaient maintenant de déterminer un « paquet " +"principal pour la documentation » (que l'on appellera I<doc-main-package>) " +"pour chaque paquet I<-doc>. S'ils trouvent un tel I<doc-main-package>, ils " +"installeront la documentation sous F<< /usr/share/doc/I<doc-main-package> >> " +"pour le paquet considéré. C'est-à -dire que le chemin peut changer, mais la " +"documentation est toujours fournie par le paquet I<-doc>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:509 +msgid "" +"The B<--doc-main-package> option can be used when the auto-detection is " +"insufficient or to reset the path to its previous value if there is a reason " +"to diverge from Debian policy recommendation." +msgstr "" +"L'option B<--doc-main-package> peut être utilisée si la détection " +"automatique est insuffisante, ou pour réinitialiser le chemin à sa valeur " +"précédente s'il y a une raison de diverger des recommandations de la " +"Charte Debian." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:513 +msgid "" +"Some documentation will not be affected by this change. These exceptions " +"include the copyright file, changelog files, README.Debian, etc. These " +"files will still be installed in the path F<< /usr/share/doc/I<package> >>." +msgstr "" +"Quelques documents ne sont pas affectés par ce changement. En particulier le " +"fichier copyright, les fichiers changelog, README.Debian, etc. Ces fichiers " +"seront toujours installés sous F<< /usr/share/doc/I<package> >>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:520 +msgid "" +"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " +"to determine which files to process. Instead, they open the file and look " +"for an ELF header to determine if a given file is an shared object or an ELF " +"executable." +msgstr "" +"Les outils B<dh_strip> et B<dh_shlibdeps> n'utilisent plus les motifs de " +"noms de fichiers pour déterminer les fichiers à traiter. À la place, ils " +"ouvrent le fichier et cherchent un en-tête ELF pour déterminer si ce fichier " +"est un objet partagé ou un exécutable ELF." #. type: textblock -#: debhelper.pod:1430 -msgid "" -"When using L<dh(1)>, it can be passed options that will be passed on to each " -"debhelper command, which is generally better than using DH_OPTIONS." +#: debhelper-compat-upgrade-checklist.pod:525 +msgid "This change may cause the tools to process more files than previously." msgstr "" -"En utilisant L<dh(1)>, des options peuvent être passées à chaque commande " -"debhelper, ce qui est généralement mieux que d'utiliser B<DH_OPTIONS>." +"Ce changement peut forcer les outils à traiter plus de fichiers qu'avant." -# type: =item #. type: =item -#: debhelper.pod:1433 -msgid "B<DH_ALWAYS_EXCLUDE>" -msgstr "B<DH_ALWAYS_EXCLUDE>" +#: debhelper-compat-upgrade-checklist.pod:529 +msgid "v10" +msgstr "v10" # type: textblock #. type: textblock -#: debhelper.pod:1435 +#: debhelper-compat-upgrade-checklist.pod:531 +msgid "Changes from v9 are:" +msgstr "Les changements par rapport à la version 9 sont :" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:537 msgid "" -"If set, this adds the value the variable is set to to the B<-X> options of " -"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " -"B<rm -rf> anything that matches the value in your package build tree." +"B<dh_installinit> will no longer install a file named debian/I<package> as " +"an init script." msgstr "" -"Si cette variable possède une valeur, elle sera ajoutée à l'option B<-X> de " -"toutes les commandes qui admettent cette option. De plus, B<dh_builddeb> " -"fera un B<rm -rf> pour chaque chose correspondant à la valeur dans l'arbre " -"de construction de paquet." +"B<dh_installinit> n'installe plus de fichier nommé debian/<paquet> comme " +"script d'initialisation." -# type: textblock #. type: textblock -#: debhelper.pod:1439 +#: debhelper-compat-upgrade-checklist.pod:542 msgid "" -"This can be useful if you are doing a build from a CVS source tree, in which " -"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " -"sneaking into the package you build. Or, if a package has a source tarball " -"that (unwisely) includes CVS directories, you might want to export " -"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " -"your package is built." +"B<dh_installdocs> will error out if it detects links created with --link-doc " +"between packages of architecture \"all\" and non-\"all\" as it breaks " +"binNMUs." msgstr "" -"Cela peut être utile pour construire un paquet à partir d'une arborescence " -"CVS. Dans ce cas, le réglage de B<DH_ALWAYS_EXCLUDE=CVS> empêchera les " -"répertoires CVS d'interférer subrepticement dans le paquet en construction. " -"Ou, si un paquet possède une source compressée, (maladroitement) présente " -"dans un répertoire CVS, il peut être utile d'exporter " -"B<DH_ALWAYS_EXCLUDE=CVS> dans F<debian/rules>, pour que cette variable soit " -"prise en compte quel que soit l'endroit où le paquet est construit." +"B<dh_installdocs> renverra une erreur s'il détecte des liens créés avec B<--" +"link-doc> entre des paquets de l'architecture « all » et non-« all » car " +"cela casse les binNMUs (envois de binaires par quelqu'un d'autre que le " +"responsable)." -# type: textblock #. type: textblock -#: debhelper.pod:1446 +#: debhelper-compat-upgrade-checklist.pod:548 msgid "" -"Multiple things to exclude can be separated with colons, as in " -"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" +"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." +"shlibs file. This is now done by B<dh_makeshlibs> instead." msgstr "" -"Des exclusions multiples peuvent être séparées avec des caractères deux " -"points, comme dans F<DH_ALWAYS_EXCLUDE=CVS:.svn>." - -# type: =item -#. type: =item -#: debhelper.pod:1449 -msgid "B<DH_EXTRA_ADDONS>" -msgstr "B<DH_EXTRA_ADDONS>" +"B<dh_installdeb> n'installe plus de fichier debian/<paquet>.shlibs fourni " +"par le responsable du paquet. Cela est maintenant effectué par " +"B<dh_makeshlibs>." #. type: textblock -#: debhelper.pod:1451 +#: debhelper-compat-upgrade-checklist.pod:554 msgid "" -"If set, this adds the specified dh addons to be run in the appropriate " -"places in the sequence of commands. This is equivalent to specifying the " -"addon to run with the --with flag in the debian/rules file. Any --without " -"calls specifying an addon in this environment variable will not be run." +"B<dh_installwm> refuses to create a broken package if no man page can be " +"found (required to register for the x-window-manager alternative)." msgstr "" -"Les rajouts à B<dh> indiqués seront exécutés lors de la séquence de " -"commandes. Cela équivaut à les indiquer avec le drapeau B<--with> dans le " -"fichier F<debian/rules>. Les rajouts précédés de B<--without> ne seront pas " -"exécutés, même s'ils sont indiqués dans cette variable d'environnement." +"B<dh_installwm> refuse de créer un paquet cassé si aucune page de manuel ne " +"peut être trouvée (requis pour l'inscription de l'alternative x-window-" +"manager)." #. type: textblock -#: debhelper.pod:1456 +#: debhelper-compat-upgrade-checklist.pod:559 msgid "" -"This is intended to be used by downstreams or specific local configurations " -"that require a debhelper addon to be run during multiple builds without " -"having to patch a large number of rules file. If at all possible, this " -"should be avoided in favor of a --with flag in the rules file." +"Debhelper will default to B<--parallel> for all buildsystems that support " +"parallel building. This can be disabled by using either B<--no-parallel> or " +"passing B<--max-parallel> with a value of 1." msgstr "" -"Cela est prévu pour être utilisé par les dérivées ou les configurations " -"locales spécifiques qui ont besoin d'un rajout lors de plusieurs " -"construction, sans avoir à modifier un grand nombre de fichier F<rules>. Il " -"est préférable d'éviter cette méthode et d'utiliser plutôt les drapeaux B<--" -"with> dans le fichier F<rules>." - -#. type: =item -#: debhelper.pod:1461 -msgid "B<DH_COLORS>, B<DPKG_COLORS>" -msgstr "B<DH_COLORS>, B<DPKG_COLORS>" +"Debhelper active par défaut la parallélisation pour tous les systèmes de " +"construction qui le gèrent. Cela peut être désactivé en utilisant l'option " +"B<--no-parallel> ou en passant la valeur B<1> à l'option B<--max-parallel>." #. type: textblock -#: debhelper.pod:1463 +#: debhelper-compat-upgrade-checklist.pod:565 msgid "" -"These variables can be used to control whether debhelper commands should use " -"colors in their textual output. Can be set to \"always\", \"auto\" (the " -"default), or \"never\"." +"The B<dh> command will not accept any of the deprecated \"manual sequence " +"control\" parameters (B<--before>, B<--after>, etc.). Please use override " +"targets instead." msgstr "" -"Ces variables peuvent être utilisées pour contrôler comment les commandes de " -"debhelper peuvent utiliser la couleur dans leurs sorties textuelles. Les " -"réglages peuvent être « always », « auto » (par défaut) ou « never »." +"La commande B<dh> n'acceptera aucun des paramètres obsolètes de « manual " +"sequence control » (B<--before>, B<--after>, etc.). Veuillez utiliser les " +"cibles de réécritures à la place." #. type: textblock -#: debhelper.pod:1467 +#: debhelper-compat-upgrade-checklist.pod:569 msgid "" -"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " -"debhelper uses it on the assumption that you want the same color setting for " -"dpkg and debhelper. In the off-hand chance you want different color setting " -"for debhelper, you can use B<DH_COLORS> instead or in addition to " -"B<DPKG_COLORS>." +"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " +"any of these since debhelper/12.4." msgstr "" -"Notez que B<DPKG_COLOR> affecte aussi un certain nombre d'outils liés à dpkg " -"et debhelper l'utilise en supposant que vous voulez les même réglages de " -"couleur pour dpkg et debhelper. Au cas où vous voudriez un autre jeu de " -"couleurs pour debhelper, vous pouvez utiliser B<DH_COLORS> à la place ou en " -"plus de B<DPKG_COLORS>." - -#. type: =item -#: debhelper.pod:1473 -msgid "B<NO_COLOR>" -msgstr "B<NO_COLOR>" +"B<Application rétroactive aux niveaux de compatibilité antérieurs> : B<dh> " +"n'accepte plus aucun de ces paramètres depuis debhelper 12.4." #. type: textblock -#: debhelper.pod:1475 +#: debhelper-compat-upgrade-checklist.pod:574 msgid "" -"If no explicit request for color has been given (e.g. B<DH_COLORS> and " -"B<DPKG_COLORS> are both unset), the presence of this environment variable " -"cause the default color setting to be \"never\"." +"The B<dh> command will no longer use log files to track which commands have " +"been run. The B<dh> command I<still> keeps track of whether it already ran " +"the \"build\" sequence and skip it if it did." msgstr "" -"Si aucune demande explicite de couleur n'a été passée (par exemple, ni " -"B<DH_COLORS>, ni B<DPKG_COLORS> n'ont été configurées), la présence de cette " -"variable d'environnement fera que le réglage des couleurs par défaut sera " -"« never »." +"La commande B<dh> n'utilisera plus les fichiers journaux pour enregistrer " +"quelles commandes ont été exécutées. La commande B<dh> se souvient " +"I<toujours> si la séquence « build » a été effectuée et l'omet si c'est le " +"cas." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:578 +msgid "The main effects of this are:" +msgstr "Les principales conséquences de cela sont :" #. type: textblock -#: debhelper.pod:1479 +#: debhelper-compat-upgrade-checklist.pod:584 msgid "" -"The variable is defined according to L<https://no-color.org/>. In this " -"project, the environment variables (such as B<DH_COLORS>) are considered an " -"explicit request for color." +"With this, it is now easier to debug the I<install> or/and I<binary> " +"sequences because they can now trivially be re-run (without having to do a " +"full \"clean and rebuild\" cycle)" msgstr "" -"Cette variable est définie conformément à L<https://no-color.org/>. Dans ce " -"projet, les variables d'environnement (comme B<DH_COLORS>) sont considérées " -"comme une demande explicite de couleur." +"Il est maintenant plus facile de déboguer les séquences I<install> et " +"I<binary> parce qu'elles peuvent maintenant être facilement re-exécutées " +"(sans avoir à refaire un cycle complet de « clean & rebuild »)" -#. type: =item -#: debhelper.pod:1483 +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:590 msgid "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +"The main caveat is that B<dh_*> now only keeps track of what happened in a " +"single override target. When all the calls to a given B<dh_cmd> command " +"happens in the same override target everything will work as before." msgstr "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +"La principale précaution est que B<dh_*> enregistre uniquement ce qui s'est " +"passé dans une unique cible de réécriture. Lorsque tous les appels à une " +"commande B<dh_cmd> donnée arrivent dans la même cible de réécriture, tout " +"fonctionnera comme avant." #. type: textblock -#: debhelper.pod:1485 +#: debhelper-compat-upgrade-checklist.pod:595 +msgid "Example of where it can go wrong:" +msgstr "Exemple de ce qui pourrait mal se passer :" + +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:597 +#, no-wrap msgid "" -"By default (in any non-deprecated compat level), debhelper will " -"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " -"unset. If you need to change the default flags, please use the features " -"from L<dpkg-buildflags(1)> to do this (e.g. " -"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" -"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." +" override_dh_foo:\n" +" dh_foo -pmy-pkg\n" +"\n" msgstr "" -"Par défaut (dans tout niveau de compatibilité non obsolète), debhelper " -"réglera automatiquement ces paramètres en utilisant L<dpkg-buildflags(1)> " -"quand ils ne sont pas définis. S'il est nécessaire de changer les paramètres " -"par défaut, veuillez utiliser les fonctions de L<dpkg-buildflags(1)> pour le " -"faire (par exemple, B<DEB_BUILD_MAINT_OPTIONS=hardening=all> ou " -"B<DEB_CPPFLAGS_MAINT_APPEND=-DCUSTOM_MACRO=true>) au lieu de configurer " -"directement les variables concrètes." +" override_dh_toto:\n" +" dh_toto -pmon_paquet\n" +"\n" -#. type: =item -#: debhelper.pod:1492 -msgid "B<HOME>, B<XDG_*>" -msgstr "B<HOME>, B<XDG_*>" +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:600 +#, no-wrap +msgid "" +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" +msgstr "" +" override_dh_titi:\n" +" dh_titi\n" +" dh_toto --remaining\n" +"\n" #. type: textblock -#: debhelper.pod:1494 +#: debhelper-compat-upgrade-checklist.pod:604 msgid "" -"In compat 13 and later, these environment variables are reset before " -"invoking the upstream build system via the B<dh_auto_*> helpers. The " -"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " -"(B<dh_auto_test> only) will be set to a writable directory. All remaining " -"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " -"cleared." +"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" +"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " +"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." msgstr "" -"À partir du niveau de compatibilité 13, ces variables d'environnement sont " -"réinitialisées avant d'invoquer le système de construction amont à l'aide " -"des outils B<dh_auto_*>. Les variables B<HOME> (pour tout outil " -"B<dh_auto_*>) et B<XDG_RUNTIME_DIR> (pour B<dh_auto_test> seulement) seront " -"réglées dans un répertoire accessible en écriture. Toutes les autres " -"variables et B<XDG_RUNTIME_DIR> (sauf durant B<dh_auto_test>) seront vidées." +"Dans ce cas, l'appel à B<dh_foo --remaining> inclura I<aussi> I<mon_paquet>, " +"car B<dh_foo -pmon_paquet> a été exécuté dans une cible de réécriture " +"différente. Ce problème n'est pas limité à B<--remaining> et concerne aussi " +"B<-a>, B<-i>, etc." #. type: textblock -#: debhelper.pod:1500 +#: debhelper-compat-upgrade-checklist.pod:613 msgid "" -"The B<HOME> directory will be created as an empty directory but it will be " -"reused between calls to B<dh_auto_*>. Any content will persist until " -"explicitly deleted or B<dh_clean>." +"The B<dh_installdeb> command now shell-escapes the lines in the " +"F<maintscript> config file. This was the original intent but it did not " +"work properly and packages have begun to rely on the incomplete shell " +"escaping (e.g. quoting file names)." msgstr "" -"Le répertoire B<HOME> sera créé comme un répertoire vide mais il sera " -"réutilisé entre les appels à B<dh_auto_*>. Tout son contenu restera jusqu'à " -"ce qu'il soit explicitement supprimé ou jusqu'à l'exécution de B<dh_clean>." - -# type: =item -#. type: =item -#: debhelper.pod:1504 -msgid "B<DEB_BUILD_OPTIONS>" -msgstr "B<DEB_BUILD_OPTIONS>" +"À présent, la commande B<dh_installdeb> échappe les caractères du shell dans " +"les lignes du fichier de config F<maintscript>. C'était l'intention " +"originale mais cela n'a jamais fonctionné correctement et les paquets ont " +"commencé à compter sur l'échappement incomplet (p. ex. en encadrant les noms " +"de fichiers de guillemets)." #. type: textblock -#: debhelper.pod:1506 +#: debhelper-compat-upgrade-checklist.pod:620 msgid "" -"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " -"variable." +"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " +"For packages needing the previous behaviour, please use B<--no-restart-after-" +"upgrade>." msgstr "" -"Veuillez consulter L</Paramètres pris en charge dans DEB_BUILD_OPTIONS> pour " -"cet environnement." +"La commande B<dh_installinit> utilise maintenant B<--restart-after-upgrade> " +"par défaut. Les paquets nécessitant le comportement précédent devraient " +"utiliser l'option B<--no-restart-after-upgrade>." #. type: textblock -#: debhelper.pod:1509 +#: debhelper-compat-upgrade-checklist.pod:626 msgid "" -"Please note that this variable should I<not> be altered by package " -"maintainers inside F<debian/rules> to change the behaviour of debhelper. " -"Instead, where the package maintainer need these features, they should look " -"disabling the relevant feature directly (e.g. by overriding the concrete " -"tools)." +"The B<autoreconf> sequence is now enabled by default. Please pass B<--" +"without autoreconf> to B<dh> if this is not desirable for a given package" msgstr "" -"Veuillez noter que cette variable ne devrait B<pas> être modifiée par les " -"responsables de paquet dans F<debian/rules> pour changer le comportement de " -"debhelper. Ils devraient plutôt rechercher à désactiver la fonction " -"correspondante directement (par exemple en surchargeant les outils " -"spécifiques)." - -# type: =item -#. type: =item -#: debhelper.pod:1514 -msgid "B<DEB_MAINT_BUILD_OPTIONS>" -msgstr "B<DEB_MAINT_BUILD_OPTIONS>" +"La séquence B<autoreconf> est maintenant activée par défaut. Veuillez passer " +"l'option B<--without autoreconf> à B<dh> si cela n'est pas voulu pour " +"certains paquets." #. type: textblock -#: debhelper.pod:1516 +#: debhelper-compat-upgrade-checklist.pod:632 msgid "" -"This is a dpkg specific environment variable (see e.g. L<dpkg-" -"buildflags(1)>). The debhelper tool suite silently ignores it." +"The B<systemd> sequence is now enabled by default. Please pass B<--without " +"systemd> to B<dh> if this is not desirable for a given package." msgstr "" -"C'est une variable d'environnement spécifique à dpkg (voir par exemple " -"L<dpkg-buildflags(1)>). La suite d'outils de debhelper l'ignore " -"silencieusement." +"La séquence B<systemd> est maintenant activée par défaut. Veuillez passer " +"l'option B<--without systemd> à B<dh> si cela n'est pas voulu pour certains " +"paquets." #. type: textblock -#: debhelper.pod:1519 +#: debhelper-compat-upgrade-checklist.pod:638 msgid "" -"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " -"which make some people mistakenly assume that debhelper will also react to " -"this variable." +"B<Retroactively removed>: B<dh> no longer creates the package build " +"directory when skipping running debhelper commands. This will not affect " +"packages that only build with debhelper commands, but it may expose bugs in " +"commands not included in debhelper." msgstr "" -"Cela est documenté ici parce qu'elle porte un nom identique à " -"B<DEB_BUILD_OPTIONS>, ce qui fait que certaines personnes pensent par erreur " -"que debhelper réagit aussi à cette variable." - -#. type: =head2 -#: debhelper.pod:1525 -msgid "Supported flags in DEB_BUILD_OPTIONS" -msgstr "Paramètres pris en charge dans DEB_BUILD_OPTIONS" +"B<Supprimé rétroactivement> : B<dh> ne crée plus le répertoire de " +"construction du paquet lors de l'omission des commandes de debhelper en " +"cours. Cela n'affectera pas les paquets qui se construisent uniquement avec " +"debhelper, mais pourrait faire apparaître des bogues dans les commandes qui " +"ne sont pas incluses avec debhelper." #. type: textblock -#: debhelper.pod:1527 +#: debhelper-compat-upgrade-checklist.pod:643 msgid "" -"The debhelper tool suite reacts to the following flags in " -"B<DEB_BUILD_OPTIONS>." +"This compatibility feature had a bug since its inception in " +"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " +"there has been no reports of issues caused by this bug in those ~5 years, " +"this item have been removed rather than fixed." msgstr "" -"La suite d'outils de debhelper réagit aux paramètres suivants dans " -"B<DEB_BUILD_OPTIONS>." +"Cette fonctionnalité de compatibilité avait un bogue depuis sa création dans " +"debhelper/9.20130516, qui la faisait échouer en compat 9 et précédent. Comme " +"il n'y a eu aucun rapport de problème causé par ce bogue en 5 ans, cela a " +"été supprimé plutôt que corrigé." #. type: =item -#: debhelper.pod:1531 -msgid "B<dherroron=obsolete-compat-levels>" -msgstr "B<dherroron=obsolete-compat-levels>" +#: debhelper-compat-upgrade-checklist.pod:650 +msgid "v9" +msgstr "v9" +# type: textblock #. type: textblock -#: debhelper.pod:1533 -msgid "I<This is a debhelper specific value.>" -msgstr "I<C'est une valeur spécifique à debhelper.>" +#: debhelper-compat-upgrade-checklist.pod:652 +msgid "Changes from v8 are:" +msgstr "Les changements par rapport à la version 8 sont :" #. type: textblock -#: debhelper.pod:1535 +#: debhelper-compat-upgrade-checklist.pod:658 msgid "" -"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " -"debhelper tools will promote deprecation warnings for usage of old soon to " -"be removed compat levels into errors." +"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " +"directories to autoconf in --libdir and --libexecdir." msgstr "" -"Quand B<dherroron> est présent et réglé à B<obsolete-compat-levels>, alors " -"les outils de debhelper présenteront dans les erreurs des alertes sur " -"l'utilisation des niveaux de compatibilité anciens sur le point d'être " -"obsolètes" +"Prise en charge multiarchitecture. En particulier, B<dh_auto_configure> " +"passe les répertoires multiarchitectures à B<autoconf> dans B<--libdir> et " +"B<--libexecdir>." #. type: textblock -#: debhelper.pod:1539 +#: debhelper-compat-upgrade-checklist.pod:663 msgid "" -"This is useful for automated checking for code relying on deprecated compat " -"levels that is scheduled for removal." +"dh is aware of the usual dependencies between targets in debian/rules. So, " +"\"dh binary\" will run any build, build-arch, build-indep, install, etc " +"targets that exist in the rules file. There's no need to define an explicit " +"binary target with explicit dependencies on the other targets." msgstr "" -"C'est utile pour la vérification automatique de code se basant sur des " -"niveaux de compatibilité dont la suppression est programmée." +"B<dh> connaît les dépendances classiques entre les cibles de F<debian/" +"rules>. Donc « B<dh binary> » exécutera toutes les cibles build, build-arch, " +"build-indep, install, etc., présentes dans le fichier I<rules>. Il n'est pas " +"nécessaire de définir une cible binary avec des dépendances explicites sur " +"les autres cibles." #. type: textblock -#: debhelper.pod:1542 -msgid "This option is intended for testing purposes; not production builds." +#: debhelper-compat-upgrade-checklist.pod:670 +msgid "" +"B<dh_strip> compresses debugging symbol files to reduce the installed size " +"of -dbg packages." msgstr "" -"Cette option est destinée aux tests et non aux constructions pour la " -"production." - -#. type: =item -#: debhelper.pod:1544 -msgid "B<nostrip>" -msgstr "B<nostrip>" +"B<dh_strip> compresse les fichiers de symboles de mise au point pour réduire " +"la taille d'installation des paquets -dbg." #. type: textblock -#: debhelper.pod:1546 debhelper.pod:1569 +#: debhelper-compat-upgrade-checklist.pod:675 msgid "" -"I<This value will change the content of the debs being built. The .deb " -"packages built when this is set is therefore not bit-for-bit reproducible " -"with a regular build in the general case.>" +"B<dh_auto_configure> does not include the source package name in --" +"libexecdir when using autoconf." msgstr "" -"I<Cette valeur changera le contenu des paquets .deb en construction. Les " -"paquets .deb construits avec ce réglage ne seront donc pas reproductibles " -"bit à bit par rapport à une construction normale en cas général.>" +"B<dh_auto_configure> n'inclut pas le nom du paquet source dans B<--" +"libexecdir> en utilisant B<autoconf>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:680 +msgid "B<dh> does not default to enabling --with=python-support" +msgstr "B<dh> n'active pas B<--with=python-support> par défaut." #. type: textblock -#: debhelper.pod:1550 +#: debhelper-compat-upgrade-checklist.pod:682 msgid "" -"This value will cause the official debhelper tools will skip actions and " -"helpers that either remove, detach or deduplicate debugging symbols in ELF " -"binaries." +"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " +"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " +"regardless of compat level)" msgstr "" -"Cette valeur fera que les outils officiels de debhelper ignoreront les " -"actions et les outils qui suppriment, détachent ou dédoublent les symboles " -"de débogage dans les binaires ELF." +"(Obsolète puisque l'outil B<dh_pysupport> a été retiré de Debian Stretch. " +"Depuis debhelper 10.3, B<dh> n'active plus cette séquence quel que soit le " +"niveau de compatibilité)" #. type: textblock -#: debhelper.pod:1554 -msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." -msgstr "Cette valeur affecte L<dh_dwz(1)> et L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:688 +msgid "" +"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " +"variables listed by B<dpkg-buildflags>, unless they are already set." +msgstr "" +"Tous les programmes debhelper B<dh_auto_>I<*> et B<dh> configurent les " +"variables d'environnement renvoyées par B<dpkg-buildflags>, sauf si elles " +"sont déjà configurées." -#. type: =item -#: debhelper.pod:1556 -msgid "B<nocheck>" -msgstr "B<nocheck>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:694 +msgid "" +"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " +"to perl F<Makefile.PL> and F<Build.PL>" +msgstr "" +"B<dh_auto_configure> passe les CFLAGS, CPPFLAGS et LDFLAGS de B<dpkg-" +"buildflags> à F<Makefile.PL> et F<Build.PL> de Perl." #. type: textblock -#: debhelper.pod:1558 +#: debhelper-compat-upgrade-checklist.pod:699 msgid "" -"This value will cause the official debhelper build systems to skip runs of " -"upstream test suites." +"B<dh_strip> puts separated debug symbols in a location based on their build-" +"id." msgstr "" -"Cette valeur fera que les systèmes de construction officiels de debhelper " -"ignoreront l'exécution des suites de tests de l'amont." +"B<dh_strip> place les symboles de mise au point séparés à un endroit en " +"fonction de leur identifiant de construction (build-id)." #. type: textblock -#: debhelper.pod:1561 +#: debhelper-compat-upgrade-checklist.pod:704 msgid "" -"Package maintainers looking to avoid running the upstream tests should " -"B<not> rely on this. Instead, they can add an empty override target to skip " -"B<dh_auto_test>." +"Executable debhelper config files are run and their output used as the " +"configuration." msgstr "" -"Les responsables de paquet cherchant à éviter l'exécution des tests de " -"l'amont ne devraient B<pas> recourir à cela. Ils peuvent plutôt ajouter une " -"cible de réécriture vide pour ignorer B<dh_auto_test>." +"Les fichiers de configuration exécutables de debhelper sont exécutés et leur " +"sortie est utilisée comme configuration." +# type: textblock #. type: textblock -#: debhelper.pod:1565 -msgid "This value affects L<dh_auto_test(1)>." -msgstr "Cette valeur affecte L<dh_auto_test(1)>." +#: debhelper-compat-upgrade-checklist.pod:709 +#: debhelper-compat-upgrade-checklist.pod:740 +#: debhelper-compat-upgrade-checklist.pod:744 debhelper-obsolete-compat.pod:81 +#: debhelper-obsolete-compat.pod:135 debhelper-obsolete-compat.pod:158 +#: debhelper-obsolete-compat.pod:165 debhelper-obsolete-compat.pod:174 +msgid "This mode is deprecated." +msgstr "Ce mode est déconseillé." #. type: =item -#: debhelper.pod:1567 -msgid "B<nodoc>" -msgstr "B<nodoc>" +#: debhelper-compat-upgrade-checklist.pod:711 +msgid "v8" +msgstr "v8" +# type: textblock #. type: textblock -#: debhelper.pod:1573 -msgid "" -"This value will cause several debhelper tools to skip installation of " -"documentation such as manpages or upstream provided documentation. " -"Additionally, the tools will also ignore if declared documentation is " -"\"missing\" on the assumption that the documentation has not been built." -msgstr "" -"Cette valeur fera que plusieurs outils de debhelper ignoreront " -"l'installation de documentation comme les pages de manuel ou la " -"documentation fournie par l'amont. En plus, les outils ne sauront pas si la " -"documentation déclarée est « missing » en partant du principe que la " -"documentation n'a pas été construite." +#: debhelper-compat-upgrade-checklist.pod:713 +msgid "Changes from v7 are:" +msgstr "Les changements par rapport à la version 7 sont :" #. type: textblock -#: debhelper.pod:1578 +#: debhelper-compat-upgrade-checklist.pod:719 msgid "" -"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " -"working with documentation." +"Commands will fail rather than warning when they are passed unknown options." msgstr "" -"Cette valeur affecte des outils comme L<dh_installdocs(1)> qui B<sait> qu'il " -"travaille sur la documentation." - -# type: =item -#. type: =item -#: debhelper.pod:1581 -msgid "B<noautodbgsym>, B<noddebs>" -msgstr "B<noautodbgsym>, B<noddebs>" +"Les commandes échoueront plutôt que de produire une alerte lorsqu'elles " +"recevront des options inconnues." #. type: textblock -#: debhelper.pod:1583 +#: debhelper-compat-upgrade-checklist.pod:723 msgid "" -"I<The official name is autodbgsym. The noddebs variant is accepted for " -"historical reasons.>" +"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " +"generates shlibs files for. So B<-X> can be used to exclude libraries. " +"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " +"processed before will be passed to it, a behavior change that can cause some " +"packages to fail to build." msgstr "" -"I<Le nom officiel est autodbgsym. La variante noddebs est acceptée pour des " -"raisons historiques.>" +"B<dh_makeshlibs> va exécuter le programme B<dpkg-gensymbols> sur toutes les " +"bibliothèques partagées qu'il génère pour les fichiers shlibs. B<-X> peut " +"alors être utilisé pour exclure certaines bibliothèques. En outre, les " +"bibliothèques rangées à des emplacements inhabituels que B<pkg-gensymbols> " +"n'aurait pas traitées avant qu'elles ne lui soient transmises, induisent un " +"changement de comportement qui peut causer l'échec de la construction de " +"certains paquets." #. type: textblock -#: debhelper.pod:1586 +#: debhelper-compat-upgrade-checklist.pod:731 msgid "" -"This value causes debhelper to skip the generation of automatically " -"generated debug symbol packages." +"B<dh> requires the sequence to run be specified as the first parameter, and " +"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo " +"$@>\"." msgstr "" -"Cette valeur fait que debhelper ignore la création des paquets de symboles " -"de débogage générés automatiquement." +"B<dh> exige que la séquence à exécuter soit indiquée en tant que premier " +"paramètre. Tous les commutateurs doivent venir après. C'est-à -dire qu'il " +"faut écrire « B<dh $@ --toto> », et non « B<dh --toto $@> »" #. type: textblock -#: debhelper.pod:1589 -msgid "This value affects L<dh_strip(1)>." -msgstr "Cette valeur affecte L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:736 +msgid "" +"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " +"F<Makefile.PL>." +msgstr "" +"B<dh_auto_*> utilise préférentiellement B<Module::Build> de Perl au lieu de " +"F<Makefile.PL>." -# type: =item #. type: =item -#: debhelper.pod:1591 -msgid "B<parallel=N>" -msgstr "B<parallel=N>" +#: debhelper-compat-upgrade-checklist.pod:742 debhelper-obsolete-compat.pod:21 +msgid "v7" +msgstr "v7" +# type: textblock #. type: textblock -#: debhelper.pod:1593 -msgid "" -"This value enables debhelper to use up to B<N> threads or processes (subject " -"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " -"debhelper tools work with parallel tasks and may silently ignore the request." -msgstr "" -"Cette valeur à permet debhelper d'utiliser jusqu'à B<N> threads ou processus " -"(soumis à des paramètres comme B<--no-parallel> et B<--max-parallel=M>). " -"Tous les outils de debhelper ne fonctionnent pas avec des tâches parallèles " -"et peuvent ignorer silencieusement la requête." +#: debhelper-compat-upgrade-checklist.pod:746 debhelper-obsolete-compat.pod:23 +msgid "This is the lowest supported compatibility level." +msgstr "C'est le niveau de compatibilité le plus bas pris en charge." #. type: textblock -#: debhelper.pod:1598 +#: debhelper-compat-upgrade-checklist.pod:748 msgid "" -"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " -"will attempt to run the underlying upstream build system with that number of " -"threads." +"If you are upgrading from an earlier compatibility level, please review " +"L<debhelper-obsolete-compat(7)>." msgstr "" -"Cette valeur affecte de nombreux outils de debhelper et en particulier " -"B<dh_auto_*> qui tentera d'exécuter le système de construction amont sous-" -"jacent avec ce nombre de thread." +"Si vous mettez à jour depuis un niveau de compatibilité antérieur, veuillez " +"consulter L<debhelper-obsolete-compat(7)>." +# type: textblock #. type: =item -#: debhelper.pod:1602 -msgid "B<terse>" -msgstr "B<terse>" +#: debhelper-compat-upgrade-checklist.pod:757 +#, fuzzy +#| msgid "L<debhelper(7)>" +msgid "L<debhelper-obsolete-compat(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1604 +#: debhelper-compat-upgrade-checklist.pod:759 msgid "" -"This value will cause the official debhelper build systems to configure " -"upstream builds to be terse (i.e. reduce verbosity in their output). This " -"is subject to the upstream and the debhelper build system supporting such " -"features." +"Upgrading from a (now) obsolete compatibility level? This document covers " +"the upgrade checklist up to the earliest supported level." msgstr "" -"Cette valeur fera que les systèmes de construction officiels de debhelper " -"configurent les constructions de l'amont pour qu'elles soient laconiques " -"(c'est-à -dire réduisent la verbosité de leurs sorties). Cela est subordonné " -"à la prise en charge par les systèmes de construction de l'amont et de " -"debhelper de ces fonctionnalités." - -#. type: textblock -#: debhelper.pod:1609 -msgid "This value affects most B<dh_auto_*> tools." -msgstr "Cette valeur affecte la plupart des outils de B<dh_auto_*>." +# type: textblock #. type: textblock -#: debhelper.pod:1613 -msgid "Unknown flags are silently ignored." -msgstr "Les paramètres inconnus sont ignorés silencieusement." +#: debhelper-compat-upgrade-checklist.pod:762 debhelper-obsolete-compat.pod:180 +#: dh:874 dh_auto_build:55 dh_auto_clean:57 dh_auto_configure:60 +#: dh_auto_install:105 dh_auto_test:66 dh_builddeb:178 dh_clean:191 +#: dh_compress:245 dh_dwz:165 dh_fixperms:166 dh_gencontrol:210 dh_install:379 +#: dh_installcatalogs:130 dh_installchangelogs:367 dh_installcron:82 +#: dh_installdeb:421 dh_installdebconf:235 dh_installdirs:133 +#: dh_installdocs:439 dh_installexamples:184 dh_installifupdown:74 +#: dh_installinfo:125 dh_installlogcheck:83 dh_installlogrotate:55 +#: dh_installman:422 dh_installmanpages:200 dh_installmime:65 +#: dh_installmodules:111 dh_installpam:73 dh_installppp:70 dh_installudev:104 +#: dh_installwm:132 dh_installxfonts:92 dh_link:168 dh_listpackages:36 +#: dh_makeshlibs:458 dh_md5sums:120 dh_movefiles:163 dh_perl:190 dh_prep:72 +#: dh_strip:437 dh_testdir:64 dh_testroot:95 dh_usrlocal:138 +#: dh_systemd_start:282 +msgid "L<debhelper(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1615 +#: debhelper-compat-upgrade-checklist.pod:764 msgid "" -"Note third-party debhelper-like tools or third-party provided build systems " -"may or may not react to the above flags. This tends to depend on " -"implementation details of the tool." +"General information about the debhelper framework. This document also covers " +"how to declare your chosen debhelper compat level." msgstr "" -"Veuillez noter que les outils tiers dans le style de debhelper ou les " -"systèmes de construction fournis par des tiers peuvent réagir ou non aux " -"paramètres ci-dessus. Cela dépend généralement des détails d'implémentation " -"des outils" # type: =head1 #. type: =head1 -#: debhelper.pod:1619 debhelper-obsolete-compat.pod:118 dh:733 dh_auto_build:53 -#: dh_auto_clean:55 dh_auto_configure:58 dh_auto_install:97 dh_auto_test:64 -#: dh_bugfiles:133 dh_builddeb:182 dh_clean:189 dh_compress:242 dh_dwz:161 -#: dh_fixperms:164 dh_gconf:105 dh_gencontrol:208 dh_icons:75 dh_install:377 -#: dh_installcatalogs:128 dh_installchangelogs:300 dh_installcron:78 -#: dh_installdeb:412 dh_installdebconf:128 dh_installdirs:131 -#: dh_installdocs:454 dh_installemacsen:138 dh_installexamples:178 -#: dh_installifupdown:72 dh_installinfo:123 dh_installinit:430 -#: dh_installinitramfs:91 dh_installlogcheck:81 dh_installlogrotate:53 -#: dh_installman:417 dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 -#: dh_installmodules:109 dh_installpam:62 dh_installppp:68 dh_installudev:102 -#: dh_installwm:132 dh_installxfonts:90 dh_link:166 dh_lintian:60 -#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 -#: dh_perl:174 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 -#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:281 dh_systemd_start:280 -msgid "SEE ALSO" -msgstr "VOIR AUSSI" - -# type: =item -#. type: =item -#: debhelper.pod:1623 -msgid "F</usr/share/doc/debhelper/examples/>" -msgstr "F</usr/share/doc/debhelper/examples/>" - -# type: textblock -#. type: textblock -#: debhelper.pod:1625 -msgid "A set of example F<debian/rules> files that use debhelper." -msgstr "" -"Un ensemble d'exemples de fichiers F<debian/rules> qui utilisent debhelper." - -# type: =item -#. type: =item -#: debhelper.pod:1627 -msgid "L<http://joeyh.name/code/debhelper/>" -msgstr "L<http://joeyh.name/code/debhelper/>" +#: debhelper-compat-upgrade-checklist.pod:769 debhelper-obsolete-compat.pod:182 +#: dh_installinit:419 dh_systemd_enable:284 dh_systemd_start:284 +msgid "AUTHORS" +msgstr "AUTEURS" -# type: textblock #. type: textblock -#: debhelper.pod:1629 -msgid "Debhelper web site." -msgstr "Le site internet de debhelper." - -# type: =head1 -#. type: =head1 -#: debhelper.pod:1633 dh:739 dh_auto_build:59 dh_auto_clean:61 -#: dh_auto_configure:64 dh_auto_install:103 dh_auto_test:70 dh_bugfiles:141 -#: dh_builddeb:188 dh_clean:195 dh_compress:248 dh_dwz:167 dh_fixperms:170 -#: dh_gconf:111 dh_gencontrol:214 dh_icons:81 dh_install:383 -#: dh_installcatalogs:134 dh_installchangelogs:306 dh_installcron:84 -#: dh_installdeb:418 dh_installdebconf:134 dh_installdirs:137 -#: dh_installdocs:460 dh_installemacsen:145 dh_installexamples:184 -#: dh_installifupdown:78 dh_installinfo:129 dh_installinitramfs:99 -#: dh_installlogcheck:87 dh_installlogrotate:59 dh_installman:423 -#: dh_installmanpages:204 dh_installmenu:96 dh_installmime:69 -#: dh_installmodules:115 dh_installpam:68 dh_installppp:74 dh_installudev:108 -#: dh_installwm:138 dh_installxfonts:96 dh_link:172 dh_lintian:68 -#: dh_listpackages:40 dh_makeshlibs:462 dh_md5sums:124 dh_movefiles:167 -#: dh_perl:180 dh_prep:76 dh_shlibdeps:210 dh_strip:441 dh_testdir:68 -#: dh_testroot:99 dh_usrlocal:142 -msgid "AUTHOR" -msgstr "AUTEUR" +#: debhelper-compat-upgrade-checklist.pod:771 debhelper-obsolete-compat.pod:184 +#: dh_dwz:171 dh_installinitramfs:101 +msgid "Niels Thykier <niels@thykier.net>" +msgstr "Niels Thykier <niels@thykier.net>" -# type: textblock #. type: textblock -#: debhelper.pod:1635 dh:741 dh_auto_build:61 dh_auto_clean:63 -#: dh_auto_configure:66 dh_auto_install:105 dh_auto_test:72 dh_builddeb:190 -#: dh_clean:197 dh_compress:250 dh_fixperms:172 dh_gencontrol:216 -#: dh_install:385 dh_installchangelogs:308 dh_installcron:86 dh_installdeb:420 -#: dh_installdebconf:136 dh_installdirs:139 dh_installdocs:462 -#: dh_installemacsen:147 dh_installexamples:186 dh_installifupdown:80 -#: dh_installinfo:131 dh_installinit:438 dh_installlogrotate:61 -#: dh_installman:425 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 -#: dh_installmodules:117 dh_installpam:70 dh_installppp:76 dh_installudev:110 -#: dh_installwm:140 dh_installxfonts:98 dh_link:174 dh_listpackages:42 -#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 -#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 -msgid "Joey Hess <joeyh@debian.org>" -msgstr "Joey Hess <joeyh@debian.org>" +#: debhelper-compat-upgrade-checklist.pod:773 debhelper-obsolete-compat.pod:186 +msgid "Joey Hess" +msgstr "Joey Hess" #. type: textblock #: debhelper-obsolete-compat.pod:3 @@ -3981,97 +4266,166 @@ msgstr "" "La liste suivante répertorie les niveaux de compatibilité qui ne sont plus " "pris en charge, ainsi que les changements de l'un à l'autre." -#. type: =item -#: debhelper-obsolete-compat.pod:21 -msgid "v1" -msgstr "v1" +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:25 +msgid "Changes from v6 are:" +msgstr "Les changements par rapport à la version 6 sont :" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:23 +#: debhelper-obsolete-compat.pod:31 msgid "" -"This is the original debhelper compatibility level, and so it is the default " -"one. In this mode, debhelper will use F<debian/tmp> as the package tree " -"directory for the first binary package listed in the control file, while " -"using debian/I<package> for all other packages listed in the F<control> file." +"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " +"doesn't find them in the current directory (or wherever you tell it look " +"using B<--sourcedir>). This allows B<dh_install> to interoperate with " +"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " +"special parameters." msgstr "" -"C'est le niveau initial de compatibilité de debhelper d'où son numéro 1. " -"Dans ce mode, debhelper emploiera F<debian/tmp> comme répertoire de " -"l'arborescence du premier paquet binaire énuméré dans le fichier F<control> " -"et « debian/I<paquet> » pour tous les autres." +"B<dh_install> cherchera récursivement les fichiers dans F<debian/tmp> s'il " +"ne les trouve pas dans le répertoire courant (ou dans le répertoire indiqué " +"par B<--sourcedir>). Cela permet à B<dh_install> d'interopérer avec " +"B<dh_auto_install> qui place les fichiers dans F<debian/tmp>, sans " +"nécessiter de paramètres particuliers." -#. type: =item -#: debhelper-obsolete-compat.pod:30 -msgid "v2" -msgstr "v2" +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:38 +msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +msgstr "" +"B<dh_clean> lit le répertoire F<debian/clean> et supprime les fichiers qui y " +"sont mentionnés." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:42 +msgid "B<dh_clean> will delete toplevel F<*-stamp> files." +msgstr "B<dh_clean> supprime les fichiers F<*-stamp>." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:32 +#: debhelper-obsolete-compat.pod:46 msgid "" -"In this mode, debhelper will consistently use debian/I<package> as the " -"package tree directory for every package that is built." +"B<dh_installchangelogs> will guess at what file is the upstream changelog if " +"none is specified." msgstr "" -"Dans ce mode, debhelper emploiera uniformément « debian/I<paquet> » comme " -"répertoire de l'arborescence de chaque paquet construit." +"B<dh_installchangelogs> déterminera à quel fichier correspond le changelog " +"amont si rien n'est indiqué." #. type: =item -#: debhelper-obsolete-compat.pod:37 -msgid "v3" -msgstr "v3" +#: debhelper-obsolete-compat.pod:51 +msgid "v6" +msgstr "v6" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:39 -msgid "This mode works like v2, with the following additions:" -msgstr "Ce mode fonctionne comme v2 mais avec les ajouts suivants :" +#: debhelper-obsolete-compat.pod:53 +msgid "Changes from v5 are:" +msgstr "Les changements par rapport à la version 5 sont :" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:45 +#: debhelper-obsolete-compat.pod:59 msgid "" -"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " -"To turn this off and use those characters raw, just prefix with a backslash." +"Commands that generate maintainer script fragments will order the fragments " +"in reverse order for the F<prerm> and F<postrm> scripts." msgstr "" -"Les fichiers de configuration de debhelper acceptent les jokers B<*> et B<?> " -"lorsque cela a un sens. Pour désactiver cette substitution et utiliser ces " -"caractères tels quels, il suffit de les préfixer avec une barre contre-" -"oblique (backslash)." +"Les commandes qui génèrent des lignes de codes de maintenance les mettront " +"dans l'ordre inverse dans les scripts F<prerm> et F<postrm>." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:50 +#: debhelper-obsolete-compat.pod:64 msgid "" -"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " -"B<ldconfig>." +"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." +"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " +"directory." msgstr "" -"Les scripts de maintenance du paquet (F<postinst> et F<postrm>) feront appel " -"à B<ldconfig> quand B<dh_makeshlibs> sera lancé." +"B<dh_installwm> installera un lien vers une page de manuel esclave pour F<x-" +"window-manager.1.gz> s'il voit la page de manuel dans le répertoire F<usr/" +"share/man/man1> du répertoire de construction du paquet." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:54 +#: debhelper-obsolete-compat.pod:70 msgid "" -"Every file in F<etc/> is automatically flagged as a conffile by " -"B<dh_installdeb>." +"B<dh_builddeb> did not previously delete everything matching " +"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " +"B<CVS:.svn:.git>. Now it does." msgstr "" -"Chaque fichier de F<etc/> est automatiquement marqué par B<dh_installdeb> " -"comme un fichier de configuration." +"Auparavant, B<dh_builddeb> ne supprimait pas les associations créées avec " +"B<DH_ALWAYS_EXCLUDE> s'il était configuré sur une liste d'éléments tels que " +"B<CVS:.svn:.git>. Maintenant il le fait." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:76 +msgid "" +"B<dh_installman> allows overwriting existing man pages in the package build " +"directory. In previous compatibility levels it silently refuses to do this." +msgstr "" +"B<dh_installman> permet d'écraser les pages de manuel existantes dans le " +"répertoire de construction du paquet. Auparavant, il refusait en silence de " +"le faire." + +#. type: =item +#: debhelper-obsolete-compat.pod:83 +msgid "v5" +msgstr "v5" + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:85 +msgid "Changes from v4 are:" +msgstr "Les changements par rapport à la version 4 sont :" + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:91 +msgid "Comments are ignored in debhelper config files." +msgstr "" +"Les commentaires sont ignorés dans les fichiers de configuration de " +"debhelper." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:95 +msgid "" +"B<dh_strip --dbg-package> now specifies the name of a package to put " +"debugging symbols in, not the packages to take the symbols from." +msgstr "" +"B<dh_strip --dbg-package> indique maintenant le nom du paquet qui doit " +"recevoir les symboles de mise au point et non les paquets d'où proviennent " +"ces symboles." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:100 +msgid "B<dh_installdocs> skips installing empty files." +msgstr "B<dh_installdocs> saute l'installation des fichiers vides." + +# type: textblock +#. type: textblock +#: debhelper-obsolete-compat.pod:104 +msgid "B<dh_install> errors out if wildcards expand to nothing." +msgstr "" +"B<dh_install> génère des erreurs si les jokers (wildcards) ne correspondent " +"à rien." #. type: =item -#: debhelper-obsolete-compat.pod:60 +#: debhelper-obsolete-compat.pod:108 msgid "v4" msgstr "v4" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:62 +#: debhelper-obsolete-compat.pod:110 msgid "Changes from v3 are:" msgstr "Les changements par rapport à la version 3 sont :" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:116 msgid "" "B<dh_makeshlibs -V> will not include the Debian part of the version number " "in the generated dependency line in the shlibs file." @@ -4081,7 +4435,7 @@ msgstr "" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:73 +#: debhelper-obsolete-compat.pod:121 msgid "" "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> " "to supplement the B<${shlibs:Depends}> field." @@ -4091,7 +4445,7 @@ msgstr "" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:78 +#: debhelper-obsolete-compat.pod:126 msgid "" "B<dh_fixperms> will make all files in F<bin/> directories and in F<etc/init." "d> executable." @@ -4101,85 +4455,88 @@ msgstr "" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:83 +#: debhelper-obsolete-compat.pod:131 msgid "B<dh_link> will correct existing links to conform with policy." msgstr "" "B<dh_link> corrigera les liens existants pour les rendre conformes à la " "Charte Debian." -# type: textblock -#. type: textblock -#: debhelper-obsolete-compat.pod:93 -msgid "Changes from v4 are:" -msgstr "Les changements par rapport à la version 4 sont :" +#. type: =item +#: debhelper-obsolete-compat.pod:137 +msgid "v3" +msgstr "v3" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:99 -msgid "Comments are ignored in debhelper config files." -msgstr "" -"Les commentaires sont ignorés dans les fichiers de configuration de " -"debhelper." +#: debhelper-obsolete-compat.pod:139 +msgid "This mode works like v2, with the following additions:" +msgstr "Ce mode fonctionne comme v2 mais avec les ajouts suivants :" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:103 +#: debhelper-obsolete-compat.pod:145 msgid "" -"B<dh_strip --dbg-package> now specifies the name of a package to put " -"debugging symbols in, not the packages to take the symbols from." +"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " +"To turn this off and use those characters raw, just prefix with a backslash." msgstr "" -"B<dh_strip --dbg-package> indique maintenant le nom du paquet qui doit " -"recevoir les symboles de mise au point et non les paquets d'où proviennent " -"ces symboles." +"Les fichiers de configuration de debhelper acceptent les jokers B<*> et B<?> " +"lorsque cela a un sens. Pour désactiver cette substitution et utiliser ces " +"caractères tels quels, il suffit de les préfixer avec une barre contre-" +"oblique (backslash)." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:108 -msgid "B<dh_installdocs> skips installing empty files." -msgstr "B<dh_installdocs> saute l'installation des fichiers vides." +#: debhelper-obsolete-compat.pod:150 +msgid "" +"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " +"B<ldconfig>." +msgstr "" +"Les scripts de maintenance du paquet (F<postinst> et F<postrm>) feront appel " +"à B<ldconfig> quand B<dh_makeshlibs> sera lancé." # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:112 -msgid "B<dh_install> errors out if wildcards expand to nothing." +#: debhelper-obsolete-compat.pod:154 +msgid "" +"Every file in F<etc/> is automatically flagged as a conffile by " +"B<dh_installdeb>." msgstr "" -"B<dh_install> génère des erreurs si les jokers (wildcards) ne correspondent " -"à rien." +"Chaque fichier de F<etc/> est automatiquement marqué par B<dh_installdeb> " +"comme un fichier de configuration." + +#. type: =item +#: debhelper-obsolete-compat.pod:160 +msgid "v2" +msgstr "v2" # type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:120 dh:735 dh_auto_build:55 dh_auto_clean:57 -#: dh_auto_configure:60 dh_auto_install:99 dh_auto_test:66 dh_builddeb:184 -#: dh_clean:191 dh_compress:244 dh_dwz:163 dh_fixperms:166 dh_gconf:107 -#: dh_gencontrol:210 dh_install:379 dh_installcatalogs:130 -#: dh_installchangelogs:302 dh_installcron:80 dh_installdeb:414 -#: dh_installdebconf:130 dh_installdirs:133 dh_installdocs:456 -#: dh_installexamples:180 dh_installifupdown:74 dh_installinfo:125 -#: dh_installlogcheck:83 dh_installlogrotate:55 dh_installman:419 -#: dh_installmanpages:200 dh_installmime:65 dh_installmodules:111 -#: dh_installpam:64 dh_installppp:70 dh_installudev:104 dh_installwm:134 -#: dh_installxfonts:92 dh_link:168 dh_listpackages:36 dh_makeshlibs:458 -#: dh_md5sums:120 dh_movefiles:163 dh_perl:176 dh_prep:72 dh_strip:437 -#: dh_testdir:64 dh_testroot:95 dh_usrlocal:138 dh_systemd_start:282 -msgid "L<debhelper(7)>" -msgstr "L<debhelper(7)>" - -# type: =head1 -#. type: =head1 -#: debhelper-obsolete-compat.pod:122 dh_installinit:436 dh_systemd_enable:285 -#: dh_systemd_start:284 -msgid "AUTHORS" -msgstr "AUTEURS" +#: debhelper-obsolete-compat.pod:162 +msgid "" +"In this mode, debhelper will consistently use debian/I<package> as the " +"package tree directory for every package that is built." +msgstr "" +"Dans ce mode, debhelper emploiera uniformément « debian/I<paquet> » comme " +"répertoire de l'arborescence de chaque paquet construit." -#. type: textblock -#: debhelper-obsolete-compat.pod:124 dh_dwz:169 dh_installinitramfs:101 -msgid "Niels Thykier <niels@thykier.net>" -msgstr "Niels Thykier <niels@thykier.net>" +#. type: =item +#: debhelper-obsolete-compat.pod:167 +msgid "v1" +msgstr "v1" +# type: textblock #. type: textblock -#: debhelper-obsolete-compat.pod:126 -msgid "Joey Hess" -msgstr "Joey Hess" +#: debhelper-obsolete-compat.pod:169 +msgid "" +"This is the original debhelper compatibility level, and so it is the default " +"one. In this mode, debhelper will use F<debian/tmp> as the package tree " +"directory for the first binary package listed in the control file, while " +"using debian/I<package> for all other packages listed in the F<control> file." +msgstr "" +"C'est le niveau initial de compatibilité de debhelper d'où son numéro 1. " +"Dans ce mode, debhelper emploiera F<debian/tmp> comme répertoire de " +"l'arborescence du premier paquet binaire énuméré dans le fichier F<control> " +"et « debian/I<paquet> » pour tous les autres." # type: textblock #. type: textblock @@ -4299,11 +4656,17 @@ msgstr "" #. type: textblock #: dh:65 +#, fuzzy +#| msgid "" +#| "The override and hook targets can also be defined to run only when " +#| "building architecture dependent or architecture independent packages. Use " +#| "targets with names like B<override_>I<dh_command>B<-arch> and " +#| "B<execute_after>I<dh_command>B<-indep>." msgid "" "The override and hook targets can also be defined to run only when building " "architecture dependent or architecture independent packages. Use targets " "with names like B<override_>I<dh_command>B<-arch> and " -"B<execute_after>I<dh_command>B<-indep>." +"B<execute_after_>I<dh_command>B<-indep>." msgstr "" "Les cibles de réécriture et d'accroche peuvent aussi être définies pour " "n'être exécutées que lors de la construction de paquets dépendants ou " @@ -4326,10 +4689,16 @@ msgstr "Cibles complètement vides" #. type: textblock #: dh:75 +#, fuzzy +#| msgid "" +#| "As a special optimization, B<dh> will skip a target if it is completely " +#| "empty. This is mostly useful for override targets, where the command " +#| "will simply be skipped without the overhead of invoking a dummy target." msgid "" "As a special optimization, B<dh> will skip a target if it is completely " -"empty. This is mostly useful for override targets, where the command will " -"simply be skipped without the overhead of invoking a dummy target." +"empty and does not depend on any other target. This is mostly useful for " +"override targets, where the command will simply be skipped without the " +"overhead of invoking a dummy target." msgstr "" "Comme optimisation particulière, B<dh> ignorera une cible si elle est " "complètement vide. C'est surtout utile pour les cibles réécrites où la " @@ -4337,13 +4706,13 @@ msgstr "" "factice." #. type: textblock -#: dh:79 +#: dh:80 msgid "Note that the target has to be completely empty for this to work:" msgstr "" "Notez que la cible doit être complètement vide pour que cela fonctionne :" #. type: verbatim -#: dh:81 +#: dh:82 #, no-wrap msgid "" " # Skip dh_bar - the good and optimized way\n" @@ -4357,7 +4726,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:86 +#: dh:87 #, no-wrap msgid "" " # Skip dh_foo - the slow way\n" @@ -4373,21 +4742,92 @@ msgstr "" "\n" #. type: =head2 -#: dh:91 +#: dh:92 msgid "Verifying targets are picked up by dh" msgstr "La vérification des cibles est récupérée par B<dh>" #. type: textblock -#: dh:93 +#: dh:94 +msgid "" +"As of debhelper 13.10, you can use L<dh_assistant(1)> to see which override " +"and hook targets will be seen by B<dh>. Here is an example run of " +"L<dh_assistant(1)> along with its output:" +msgstr "" + +#. type: verbatim +#: dh:98 +#, no-wrap +msgid "" +" $ dh_assistant detect-hook-targets\n" +" {\n" +" \"commands-not-in-path\": [\n" +" \"dh_foo\"\n" +" ],\n" +" \"hook-targets\": [\n" +" {\n" +" \"command\": \"dh_strip_nondeterminism\",\n" +" \"is-empty\": true,\n" +" \"package-section-param\": null,\n" +" \"target-name\": \"override_dh_strip_nondeterminism\"\n" +" },\n" +" {\n" +" \"command\": \"dh_foo\",\n" +" \"is-empty\": false,\n" +" \"package-section-param\": \"-a\",\n" +" \"target-name\": \"override_dh_foo-arch\"\n" +" }\n" +" ]\n" +" }\n" +"\n" +msgstr "" + +#. type: textblock +#: dh:119 +msgid "" +"The B<commands-not-in-path> is useful for spotting mistakes in the hook " +"target names. A non-empty value implies one of more hook targets are " +"related to a command that is either not installed or no command with that " +"name exists at all. It is generally worth double checking these." +msgstr "" + +#. type: textblock +#: dh:124 +msgid "" +"Additionally, the B<is-empty> attribute for each hook target can be used for " +"seeing whether a hook target triggers the L</Completely empty targets> " +"optimization." +msgstr "" + +#. type: textblock +#: dh:127 +msgid "" +"If you are interested in the other attributes, please read the " +"L<dh_assistant(1)> for the details." +msgstr "" + +#. type: =head3 +#: dh:130 +#, fuzzy +#| msgid "Verifying targets are picked up by dh" +msgid "" +"Verifying targets are picked up by dh (when debhelper is older than 13.10)" +msgstr "La vérification des cibles est récupérée par B<dh>" + +#. type: textblock +#: dh:134 +#, fuzzy +#| msgid "" +#| "If you want to confirm that B<dh> has seen an override or a hook target, " +#| "you can use the following command as an example:" msgid "" -"If you want to confirm that B<dh> has seen an override or a hook target, you " +"On older versions of debhelper, you have to use B<dh> with B<--no-act>. You " "can use the following command as an example:" msgstr "" "Si vous voulez confirmer que B<dh> a vu une cible de réécriture ou " "d'accroche, vous pouvez utiliser la commande suivante comme exemple :" #. type: verbatim -#: dh:96 +#: dh:137 #, no-wrap msgid "" " $ dh binary --no-act | grep dh_install | head -n5\n" @@ -4407,7 +4847,7 @@ msgstr "" "\n" #. type: textblock -#: dh:103 +#: dh:144 msgid "" "The B<debian/rules execute_after_dh_install> in the output, which signals " "that B<dh> registered a B<execute_after_dh_install> target and would run it " @@ -4418,7 +4858,7 @@ msgstr "" "immédiatement après L<dh_install(1)>." #. type: textblock -#: dh:107 +#: dh:148 msgid "" "Note that L</Completely empty targets> will be omitted in the listing " "above. This makes it a bit harder to spot as you are looking for the " @@ -4429,12 +4869,12 @@ msgstr "" "l'omission d'un nom de commande. Mais autrement, le principe reste le même." #. type: =head2 -#: dh:111 +#: dh:152 msgid "Caveats with hook targets and makefile conditionals" msgstr "Mises en garde sur les cibles d'accroche et les conditions de makefile" #. type: textblock -#: dh:113 +#: dh:154 msgid "" "If you choose to wrap a hook target in makefile conditionals, please be " "aware that B<dh> computes all the hook targets a head of time and caches the " @@ -4449,7 +4889,7 @@ msgstr "" "d'accroche plus tard et supposera que la réponse n'a pas changé." #. type: textblock -#: dh:119 +#: dh:160 msgid "" "The parsing and caching I<often> happens before B<dh> knows whether it will " "build arch:any (-a) or/and arch:all (-i) packages, which can produce " @@ -4462,7 +4902,7 @@ msgstr "" "L<dh_listpackages(1)> fait partie des conditions." #. type: textblock -#: dh:124 +#: dh:165 msgid "" "Most of the problems can be avoided by making the hook target unconditional " "and then have the \"body\" be partially or completely conditional. As an " @@ -4473,7 +4913,7 @@ msgstr "" "complètement conditionnel. Par exemple :" #. type: verbatim -#: dh:128 +#: dh:169 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. The hook target\n" @@ -4507,7 +4947,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:142 +#: dh:183 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -4541,7 +4981,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:157 +#: dh:198 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -4576,7 +5016,7 @@ msgstr "" "\n" #. type: textblock -#: dh:171 +#: dh:212 msgid "" "These recipes are also relevant for conditional dependency targets, which " "are often seen in a variant of the following example:" @@ -4586,7 +5026,7 @@ msgstr "" "suivant :" #. type: verbatim -#: dh:174 +#: dh:215 #, no-wrap msgid "" " COND_TASKS =\n" @@ -4604,7 +5044,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:180 +#: dh:221 #, no-wrap msgid "" " maybe-run-this:\n" @@ -4616,7 +5056,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:183 +#: dh:224 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. Either the\n" @@ -4642,7 +5082,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:194 +#: dh:235 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -4670,7 +5110,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:205 +#: dh:246 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -4691,7 +5131,7 @@ msgstr "" "\n" #. type: textblock -#: dh:213 +#: dh:254 msgid "" "When in doubt, pick the relevant B<SIMPLE> case in the examples above that " "match your need." @@ -4701,31 +5141,31 @@ msgstr "" # type: =head1 #. type: =head1 -#: dh:216 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 -#: dh_auto_install:46 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 -#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gconf:42 dh_gencontrol:38 -#: dh_icons:33 dh_install:69 dh_installcatalogs:56 dh_installchangelogs:71 -#: dh_installcron:43 dh_installdeb:100 dh_installdebconf:64 dh_installdirs:45 -#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:44 -#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:78 +#: dh:257 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 +#: dh_auto_install:52 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 +#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gencontrol:38 dh_icons:33 +#: dh_install:69 dh_installcatalogs:56 dh_installchangelogs:77 +#: dh_installcron:45 dh_installdeb:107 dh_installdebconf:64 dh_installdirs:45 +#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:48 +#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:77 #: dh_installinitramfs:43 dh_installlogcheck:45 dh_installlogrotate:25 #: dh_installman:86 dh_installmanpages:43 dh_installmenu:44 -#: dh_installmodules:41 dh_installpam:34 dh_installppp:38 dh_installudev:34 +#: dh_installmodules:41 dh_installpam:38 dh_installppp:38 dh_installudev:34 #: dh_installwm:41 dh_link:69 dh_makeshlibs:67 dh_md5sums:31 dh_movefiles:41 -#: dh_perl:34 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 -#: dh_usrlocal:50 dh_systemd_enable:83 dh_systemd_start:33 +#: dh_perl:35 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 +#: dh_usrlocal:50 dh_systemd_enable:82 dh_systemd_start:33 msgid "OPTIONS" msgstr "OPTIONS" # type: =item #. type: =item -#: dh:220 +#: dh:261 msgid "B<--with> I<addon>[B<,>I<addon> ...]" msgstr "B<--with> I<rajout>[B<,>I<rajout> ...]" # type: textblock #. type: textblock -#: dh:222 +#: dh:263 msgid "" "Add the debhelper commands specified by the given addon to appropriate " "places in the sequence of commands that is run. This option can be repeated " @@ -4742,7 +5182,7 @@ msgstr "" "de l'interface de ces rajouts." #. type: textblock -#: dh:229 +#: dh:270 msgid "" "A B<Build-Depends> relation on the package B<dh-sequence->I<addon> implies a " "B<--with> I<addon>. This avoids the need for an explicit B<--with> in " @@ -4761,7 +5201,7 @@ msgstr "" "profils (par exemple pour faciliter l'amorçage)." #. type: textblock -#: dh:238 +#: dh:279 msgid "" "Since debhelper 12.5, addons can also be activated in B<indep>-only mode " "(via B<Build-Depends-Indep>) or B<arch>-only mode (via B<Build-Depends-" @@ -4775,7 +5215,7 @@ msgstr "" "qui simplifie la gestion des dépendances pour les constructions croisées." #. type: textblock -#: dh:244 +#: dh:285 msgid "" "Please note that addons activated via B<Build-Depends-Indep> or B<Build-" "Depends-Arch> are subject to additional limitations to ensure the result is " @@ -4795,12 +5235,12 @@ msgstr "" # type: =item #. type: =item -#: dh:252 +#: dh:293 msgid "B<--without> I<addon>" msgstr "B<--without> I<rajout>" #. type: textblock -#: dh:254 +#: dh:295 msgid "" "The inverse of B<--with>, disables using the given addon. This option can be " "repeated more than once, or multiple addons to disable can be listed, " @@ -4812,12 +5252,12 @@ msgstr "" # type: textblock #. type: textblock -#: dh:260 +#: dh:301 msgid "List all available addons." msgstr "Liste tous les rajouts disponibles." #. type: textblock -#: dh:262 +#: dh:303 msgid "" "When called only with this option, B<dh> can be called from any directory (i." "e. it does not need access to files from a source package)." @@ -4827,7 +5267,7 @@ msgstr "" "aucun fichier d'un paquet source)." #. type: textblock -#: dh:268 +#: dh:309 msgid "" "Prints commands that would run for a given sequence, but does not run them." msgstr "" @@ -4835,7 +5275,7 @@ msgstr "" "les exécuter." #. type: textblock -#: dh:270 +#: dh:311 msgid "" "Note that dh normally skips running commands that it knows will do nothing. " "With --no-act, the full list of commands in a sequence is printed." @@ -4846,7 +5286,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:275 +#: dh:316 msgid "" "Other options passed to B<dh> are passed on to each command it runs. This " "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for " @@ -4858,14 +5298,14 @@ msgstr "" # type: =head1 #. type: =head1 -#: dh:279 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 +#: dh:320 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 #: dh_makeshlibs:185 dh_shlibdeps:78 msgid "EXAMPLES" msgstr "EXEMPLES" # type: textblock #. type: textblock -#: dh:281 +#: dh:322 msgid "" "To see what commands are included in a sequence, without actually doing " "anything:" @@ -4875,7 +5315,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:284 +#: dh:325 #, no-wrap msgid "" "\tdh binary-arch --no-act\n" @@ -4886,7 +5326,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:286 +#: dh:327 msgid "" "This is a very simple rules file, for packages where the default sequences " "of commands work with no additional options." @@ -4896,7 +5336,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:289 dh:296 dh:310 dh:323 dh:334 dh:392 dh:403 +#: dh:330 dh:337 dh:351 dh:364 dh:375 dh:433 dh:444 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4911,7 +5351,7 @@ msgstr "" # type: verbatim #. type: textblock -#: dh:293 +#: dh:334 msgid "" "Often you'll want to pass an option to a specific debhelper command. The " "easy way to do with is by adding an override target for that command." @@ -4922,7 +5362,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:300 +#: dh:341 #, no-wrap msgid "" "\toverride_dh_strip:\n" @@ -4935,7 +5375,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:303 +#: dh:344 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4948,7 +5388,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:306 +#: dh:347 msgid "" "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> " "can't guess what to do for a strange package. Here's how to avoid running " @@ -4961,7 +5401,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:314 +#: dh:355 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4974,7 +5414,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:317 +#: dh:358 #, no-wrap msgid "" "\toverride_dh_auto_build:\n" @@ -4987,7 +5427,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:320 +#: dh:361 msgid "" "Another common case is wanting to do something manually before or after a " "particular debhelper command is run." @@ -4997,7 +5437,8 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:327 +#: dh:368 +#, no-wrap msgid "" "\t# Example assumes debhelper/12.8 and compat 10+\n" "\texecute_after_dh_fixperms:\n" @@ -5010,7 +5451,7 @@ msgstr "" "\n" #. type: textblock -#: dh:331 +#: dh:372 msgid "" "If you are on an older debhelper or compatibility level, the above example " "would have to be written as." @@ -5021,7 +5462,8 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:338 +#: dh:379 +#, no-wrap msgid "" "\t# Older debhelper versions or using compat 9 or lower.\n" "\toverride_dh_fixperms:\n" @@ -5037,7 +5479,7 @@ msgstr "" "\n" #. type: textblock -#: dh:343 +#: dh:384 msgid "" "Python tools are not run by dh by default, due to the continual change in " "that area. Here is how to use B<dh_python2>." @@ -5048,7 +5490,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:346 +#: dh:387 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -5063,7 +5505,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:350 +#: dh:391 msgid "" "Here is how to force use of Perl's B<Module::Build> build system, which can " "be necessary if debhelper wrongly detects that the package uses MakeMaker." @@ -5074,7 +5516,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:354 +#: dh:395 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -5089,7 +5531,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:358 +#: dh:399 msgid "" "Here is an example of overriding where the B<dh_auto_>I<*> commands find the " "package's source, for a package where the source is located in a " @@ -5100,7 +5542,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:362 +#: dh:403 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -5114,7 +5556,7 @@ msgstr "" "\n" #. type: textblock -#: dh:366 +#: dh:407 msgid "" "And here is an example of how to tell the B<dh_auto_>I<*> commands to build " "in a subdirectory, which will be removed on B<clean>." @@ -5125,7 +5567,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:369 +#: dh:410 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -5139,7 +5581,7 @@ msgstr "" "\n" #. type: textblock -#: dh:373 +#: dh:414 msgid "" "If your package can be built in parallel, please either use compat 10 or " "pass B<--parallel> to dh. Then B<dpkg-buildpackage -j> will work." @@ -5150,7 +5592,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:376 +#: dh:417 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -5164,7 +5606,7 @@ msgstr "" "\n" #. type: textblock -#: dh:380 +#: dh:421 msgid "" "If your package cannot be built reliably while using multiple threads, " "please pass B<--no-parallel> to dh (or the relevant B<dh_auto_>I<*> command):" @@ -5175,7 +5617,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:385 +#: dh:426 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -5189,7 +5631,7 @@ msgstr "" "\n" #. type: textblock -#: dh:389 +#: dh:430 msgid "" "Here is a way to prevent B<dh> from running several commands that you don't " "want it to run, by defining empty override targets for each command." @@ -5199,7 +5641,7 @@ msgstr "" "voulez pas lancer." #. type: verbatim -#: dh:396 +#: dh:437 #, no-wrap msgid "" "\t# Commands not to run:\n" @@ -5211,7 +5653,7 @@ msgstr "" "\n" #. type: textblock -#: dh:399 +#: dh:440 msgid "" "A long build process for a separate documentation package can be separated " "out using architecture independent overrides. These will be skipped when " @@ -5224,7 +5666,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:407 +#: dh:448 #, no-wrap msgid "" "\toverride_dh_auto_build-indep:\n" @@ -5236,7 +5678,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:410 +#: dh:451 #, no-wrap msgid "" "\t# No tests needed for docs\n" @@ -5249,7 +5691,7 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:413 +#: dh:454 #, no-wrap msgid "" "\toverride_dh_auto_install-indep:\n" @@ -5261,7 +5703,7 @@ msgstr "" "\n" #. type: textblock -#: dh:416 +#: dh:457 msgid "" "Adding to the example above, suppose you need to chmod a file, but only when " "building the architecture dependent package, as it's not present when " @@ -5274,7 +5716,8 @@ msgstr "" # type: verbatim #. type: verbatim -#: dh:420 +#: dh:461 +#, no-wrap msgid "" "\t# Example assumes debhelper/12.8 and compat 10+\n" "\texecute_after_dh_fixperms-arch:\n" @@ -5286,13 +5729,168 @@ msgstr "" "\t\tchmod 4755 debian/truc/usr/bin/truc\n" "\n" +# type: =head1 +#. type: =head1 +#: dh:465 +#, fuzzy +#| msgid "DEBHELPER COMMANDS" +msgid "DEBHELPER PROVIDED DH ADDONS" +msgstr "COMMANDES DE DEBHELPER" + +#. type: textblock +#: dh:467 +msgid "" +"The primary purpose of B<dh> addons is to provide easy integration with " +"third-party provided features for debhelper. However, debhelper itself also " +"provide a few sequences that can be useful in some cases. These are " +"documented in this list:" +msgstr "" + +#. type: =item +#: dh:474 +msgid "build-stamp" +msgstr "" + +#. type: textblock +#: dh:476 +msgid "" +"A special addon for controlling whether B<dh> (in compat 10 or later) will " +"create stamp files to tell whether the build target has been run " +"successfully. See L</INTERNALS> for more details." +msgstr "" + +#. type: textblock +#: dh:480 +#, fuzzy +#| msgid "The previous behaviour can restored by using B<--with build-stamp>" +msgid "" +"This addon is active by default but can disabled by using B<dh $@ --without " +"build-stamp>" +msgstr "" +"Le comportement précédent peut être retrouvé en utilisant B<--with build-" +"stamp>" + +#. type: =item +#: dh:483 +msgid "dwz (obsolete)" +msgstr "" + +#. type: textblock +#: dh:485 +msgid "" +"Adds L<dh_dwz(1)> to the sequence in compat level 11 or below. Obsolete in " +"compat 12 or later." +msgstr "" + +#. type: =item +#: dh:488 +msgid "elf-tools" +msgstr "" + +#. type: textblock +#: dh:490 +msgid "" +"This addon adds tools related to ELF files to the sequence such as " +"L<dh_strip(1)> and L<dh_shlibdeps(1)>" +msgstr "" + +#. type: textblock +#: dh:493 +msgid "" +"This addon is I<conditionally> active by default for architecture specific " +"packages - that is, it is skipped for arch:all packages. In the special " +"case where you need these tools to work on arch:all packages, you can use " +"B<--with elf-tools> to activate it unconditionally." +msgstr "" + +#. type: =item +#: dh:499 +msgid "installinitramfs (obsolete)" +msgstr "" + +#. type: textblock +#: dh:501 +msgid "" +"Adds L<dh_installinitramfs(1)> to the sequence in compat level 11 or below. " +"Obsolete in compat 12 or later." +msgstr "" + +#. type: =item +#: dh:504 +msgid "root-sequence (internal)" +msgstr "" + +#. type: textblock +#: dh:506 +msgid "This is reserved for internal usage." +msgstr "" + +#. type: =item +#: dh:508 +msgid "single-binary" +msgstr "" + +#. type: textblock +#: dh:510 +msgid "" +"A special-purpose addon that makes debhelper run in \"single binary\" mode." +msgstr "" + +#. type: textblock +#: dh:512 +msgid "" +"When active, it will pass B<< --destdir=debian/I<package>/ >> to " +"L<dh_auto_install(1)>. This makes every file \"installed\" by the upstream " +"build system part of the (only) binary package by default without having to " +"use other helpers such as L<dh_install(1)>." +msgstr "" + +#. type: textblock +#: dh:517 +msgid "" +"The addon will refuse to activate when the source package lists 2 or more " +"binary packages in F<debian/control> as a precaution." +msgstr "" + +#. type: textblock +#: dh:520 +msgid "" +"Before compat 15. this behaviour was the default when there was only a " +"single binary package listed in F<debian/control>. In compat 15 and later, " +"this addon must explicitly be activated for this feature to work." +msgstr "" + +#. type: textblock +#: dh:524 +msgid "" +"The rationale for requiring this as an explicit choice is that if it is " +"implicit then debhelper will silently change behaviour on adding a new " +"binary package. This has caused many RC bugs when maintainers renamed a " +"binary and added transitional packages with the intention of supporting " +"seamless upgrades. The result would often be two empty binary packages that " +"were uploaded to archive with users frustrated as their \"upgrade\" removed " +"their programs." +msgstr "" + +#. type: =item +#: dh:532 +msgid "systemd (obsolete)" +msgstr "" + +#. type: textblock +#: dh:534 +msgid "" +"Adds L<dh_systemd_enable(1)> and L<dh_systemd_start(1)> to the sequence in " +"compat level 10 or below. Obsolete in compat 11 or later." +msgstr "" + #. type: =head1 -#: dh:424 +#: dh:539 msgid "INTERNALS" msgstr "FONCTIONNEMENT INTERNE" #. type: textblock -#: dh:426 +#: dh:541 msgid "" "If you're curious about B<dh>'s internals, here's how it works under the " "hood." @@ -5301,7 +5899,7 @@ msgstr "" "ce qu'il y a sous le capot." #. type: textblock -#: dh:428 +#: dh:543 msgid "" "In compat 10 (or later), B<dh> creates a stamp file F<debian/debhelper-build-" "stamp> after the build step(s) are complete to avoid re-running them. It is " @@ -5319,7 +5917,7 @@ msgstr "" "tant que « root » ou avec L<fakeroot(1)>)." #. type: textblock -#: dh:436 +#: dh:551 msgid "" "Inside an override target, B<dh_*> commands will create a log file F<debian/" "package.debhelper.log> to keep track of which packages the command(s) have " @@ -5333,7 +5931,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:441 +#: dh:556 msgid "" "In compat 9 or earlier, each debhelper command will record when it's " "successfully run in F<debian/package.debhelper.log>. (Which B<dh_clean> " @@ -5349,7 +5947,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:446 +#: dh:561 msgid "" "Each time B<dh> is run (in compat 9 or earlier), it examines the log, and " "finds the last logged command that is in the specified sequence. It then " @@ -5360,7 +5958,7 @@ msgstr "" "indiquée. Puis il exécute la commande suivante dans cette séquence." #. type: textblock -#: dh:450 +#: dh:565 msgid "" "A sequence can also run dependent targets in debian/rules. For example, the " "\"binary\" sequence runs the \"install\" target." @@ -5369,7 +5967,7 @@ msgstr "" "Par exemple, la suite « binary » exécute la cible « install »." #. type: textblock -#: dh:453 +#: dh:568 msgid "" "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass " "information through to debhelper commands that are run inside override " @@ -5384,7 +5982,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh:458 +#: dh:573 msgid "" "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> " "sequences are passed the B<-i> option to ensure they only work on " @@ -5401,19 +5999,19 @@ msgstr "" # type: textblock #. type: textblock -#: dh:737 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 -#: dh_auto_install:101 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:186 -#: dh_clean:193 dh_compress:246 dh_dwz:165 dh_fixperms:168 dh_gconf:109 -#: dh_gencontrol:212 dh_icons:79 dh_install:381 dh_installchangelogs:304 -#: dh_installcron:82 dh_installdeb:416 dh_installdebconf:132 dh_installdirs:135 -#: dh_installdocs:458 dh_installemacsen:143 dh_installexamples:182 -#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:434 -#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:421 +#: dh:876 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 +#: dh_auto_install:107 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:180 +#: dh_clean:193 dh_compress:247 dh_dwz:167 dh_fixperms:168 dh_gencontrol:212 +#: dh_icons:79 dh_install:381 dh_installchangelogs:369 dh_installcron:84 +#: dh_installdeb:423 dh_installdebconf:237 dh_installdirs:135 +#: dh_installdocs:441 dh_installemacsen:143 dh_installexamples:186 +#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:417 +#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:424 #: dh_installmanpages:202 dh_installmenu:94 dh_installmime:67 -#: dh_installmodules:113 dh_installpam:66 dh_installppp:72 dh_installudev:106 -#: dh_installwm:136 dh_installxfonts:94 dh_link:170 dh_lintian:64 +#: dh_installmodules:113 dh_installpam:75 dh_installppp:72 dh_installudev:106 +#: dh_installwm:134 dh_installxfonts:94 dh_link:170 dh_lintian:64 #: dh_listpackages:38 dh_makeshlibs:460 dh_md5sums:122 dh_movefiles:165 -#: dh_perl:178 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 +#: dh_perl:192 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 #: dh_testroot:97 dh_usrlocal:140 msgid "This program is a part of debhelper." msgstr "Ce programme fait partie de debhelper." @@ -5466,7 +6064,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:48 +#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:54 #: dh_auto_test:36 msgid "" "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build " @@ -5478,9 +6076,9 @@ msgstr "" # type: =item #. type: =item -#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:59 +#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:65 #: dh_auto_test:41 dh_builddeb:48 dh_dwz:62 dh_gencontrol:42 -#: dh_installdebconf:72 dh_installinit:167 dh_makeshlibs:179 dh_shlibdeps:41 +#: dh_installdebconf:72 dh_installinit:166 dh_makeshlibs:179 dh_shlibdeps:41 msgid "B<--> I<params>" msgstr "B<--> I<paramètres>" @@ -5669,15 +6267,32 @@ msgstr "" "d'installation. De ce fait b<dh_auto_install> n'installera pas les fichiers " "construits avec B<Ant>." -# type: textblock #. type: textblock #: dh_auto_install:32 msgid "" -"Unless B<--destdir> option is specified, the files are installed into debian/" -"I<package>/ if there is only one binary package. In the multiple binary " -"package case, the files are instead installed into F<debian/tmp/>, and " -"should be moved from there to the appropriate package build directory using " -"L<dh_install(1)>." +"In compat 15 or later, B<dh_auto_install> will use F<debian/tmp> as the " +"default B<--destdir> and should be moved from there to the appropriate " +"package build directory using L<dh_install(1)> or similar tools. Though if " +"the B<single-binary> addon for L<dh(1)> is activated, then it will pass an " +"explicit B<< --destdir=debian/I<package>/ >> to B<dh_auto_install>." +msgstr "" + +# type: textblock +#. type: textblock +#: dh_auto_install:38 +#, fuzzy +#| msgid "" +#| "Unless B<--destdir> option is specified, the files are installed into " +#| "debian/I<package>/ if there is only one binary package. In the multiple " +#| "binary package case, the files are instead installed into F<debian/tmp/>, " +#| "and should be moved from there to the appropriate package build directory " +#| "using L<dh_install(1)>." +msgid "" +"For earlier compat levels then unless B<--destdir> option is specified, the " +"files are installed into debian/I<package>/ if there is only one binary " +"package. In the multiple binary package case, the files are instead " +"installed into F<debian/tmp/>, and should be moved from there to the " +"appropriate package build directory using L<dh_install(1)> or similar tools." msgstr "" "À moins que l'option B<--destdir> soit indiquée, les fichiers sont installés " "dans debian/I<Paquet>/ s'il n'y a qu'un seul paquet binaire. Dans le cas de " @@ -5687,7 +6302,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_auto_install:38 +#: dh_auto_install:44 msgid "" "B<DESTDIR> is used to tell make where to install the files. If the Makefile " "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set " @@ -5700,7 +6315,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_auto_install:42 +#: dh_auto_install:48 msgid "" "This is intended to work for about 90% of packages. If it doesn't work, or " "tries to use the wrong install target, you're encouraged to skip using " @@ -5713,13 +6328,13 @@ msgstr "" # type: =item #. type: =item -#: dh_auto_install:53 dh_builddeb:38 +#: dh_auto_install:59 dh_builddeb:38 msgid "B<--destdir=>I<directory>" msgstr "B<--destdir=>I<répertoire>" # type: textblock #. type: textblock -#: dh_auto_install:55 +#: dh_auto_install:61 msgid "" "Install files into the specified I<directory>. If this option is not " "specified, destination directory is determined automatically as described in " @@ -5731,7 +6346,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_auto_install:61 +#: dh_auto_install:67 msgid "" "Pass I<params> to the program that is run, after the parameters that " "B<dh_auto_install> usually passes." @@ -5840,8 +6455,8 @@ msgstr "" # type: =head1 #. type: =head1 -#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_gconf:26 dh_install:40 -#: dh_installcatalogs:39 dh_installchangelogs:47 dh_installcron:24 +#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_install:40 +#: dh_installcatalogs:39 dh_installchangelogs:53 dh_installcron:24 #: dh_installdeb:25 dh_installdebconf:37 dh_installdirs:28 dh_installdocs:40 #: dh_installemacsen:30 dh_installexamples:31 dh_installifupdown:25 #: dh_installinfo:28 dh_installinit:41 dh_installinitramfs:30 @@ -6071,6 +6686,7 @@ msgstr "" # type: verbatim #. type: verbatim #: dh_clean:25 +#, no-wrap msgid "" "It removes the package build directories, and removes some other files including\n" "F<debian/files>, and any detritus left behind by other debhelper commands. It\n" @@ -6116,8 +6732,8 @@ msgstr "" "terminer par un « slash ». Tout le contenu de ces répertoires sera supprimé." #. type: textblock -#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:95 -#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:39 dh_installinfo:36 +#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:102 +#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:43 dh_installinfo:36 #: dh_installman:81 dh_installwm:36 dh_link:64 msgid "" "Supports substitution variables in compat 13 and later as documented in " @@ -6128,7 +6744,7 @@ msgstr "" # type: =item #. type: =item -#: dh_clean:53 dh_installchangelogs:75 +#: dh_clean:53 dh_installchangelogs:81 msgid "B<-k>, B<--keep>" msgstr "B<-k>, B<--keep>" @@ -6310,7 +6926,7 @@ msgstr "" # type: =item #. type: =item -#: dh_compress:68 dh_installdocs:184 dh_installexamples:85 dh_installinfo:60 +#: dh_compress:68 dh_installdocs:184 dh_installexamples:89 dh_installinfo:60 #: dh_installmanpages:47 dh_movefiles:58 dh_testdir:30 msgid "I<file> ..." msgstr "I<fichier> ..." @@ -6323,7 +6939,7 @@ msgstr "Ajoute ces fichiers à la liste des fichiers à compresser." # type: =head1 #. type: =head1 -#: dh_compress:74 dh_perl:64 dh_strip:133 dh_usrlocal:66 +#: dh_compress:74 dh_perl:65 dh_strip:133 dh_usrlocal:66 msgid "CONFORMS TO" msgstr "CONFORMITÉ" @@ -6389,8 +7005,8 @@ msgstr "" "sans si L<dwz(1)> n'en crée pas un (mais se termine néanmoins avec succès). " "Cela arrive généralement quand les fichiers de débogage ne contiennent pas " "de symboles de débogage (par exemple, en absence de -g passé au compilateur) " -"ou quand les symboles de débogage sont compressés (voir le bogue Debian n° " -"931891). Si B<--dwz-multifile> est passé, alors B<dh_dwz> s’interrompra " +"ou quand les symboles de débogage sont compressés (voir le bogue Debian " +"n° 931891). Si B<--dwz-multifile> est passé, alors B<dh_dwz> s’interrompra " "avec une erreur si L<dwz(1)> ne crée pas un I<multifile>." #. type: textblock @@ -6510,140 +7126,46 @@ msgid "" "from any libraries, headers, Perl modules, or desktop files that have it " "set. It makes all files in the standard F<bin> and F<sbin> directories, " "F<usr/games/> and F<etc/init.d> executable (since v4). Finally, it removes " -"the setuid and setgid bits from all files in the package." -msgstr "" -"B<dh_fixperms> règle à 644 les droits sur tous les fichiers de F<usr/share/" -"doc> à l'exclusion de ceux contenus dans le répertoire F<examples/>. Il " -"règle également à 644 les droits de toutes les pages de manuel. Il enlève " -"l'autorisation d'écrire au groupe et aux autres utilisateurs sur tous les " -"fichiers. Il retire le droit d'exécution sur toutes les bibliothèques, en-" -"têtes (header), modules Perl ou fichiers desktop. Il rend exécutables tous " -"les fichiers de F<bin/>, F<sbin/>, F</usr/games/> et F<etc/init.d> (à partir " -"de la version 4 seulement). Pour finir il annule les bits setuid et setgid " -"de tous les fichiers du paquet." - -#. type: textblock -#: dh_fixperms:36 -msgid "" -"When the I<Rules-Requires-Root> field has the (effective) value of I<binary-" -"targets>, B<dh_fixperms> will also reset the ownership of all paths to " -"\"root:root\"." -msgstr "" -"Lorsque le champ I<Rules-Requires-Root> a la valeur I<binary-targets>, " -"B<dh_fixperms> réinitialisera aussi la propriété de tous les chemins à « root:" -"root »." - -# type: =item -#. type: =item -#: dh_fixperms:44 -msgid "B<-X>I<item>, B<--exclude> I<item>" -msgstr "B<-X>I<élément>, B<--exclude> I<élément>" - -# type: textblock -#. type: textblock -#: dh_fixperms:46 -msgid "" -"Exclude files that contain I<item> anywhere in their filename from having " -"their permissions changed. You may use this option multiple times to build " -"up a list of things to exclude." -msgstr "" -"Permet d'exclure de la modification des droits les fichiers qui comportent " -"I<élément> n'importe où dans leur nom. Cette option peut être employée " -"plusieurs fois afin d'exclure une liste d'éléments." - -# type: textblock -#. type: textblock -#: dh_gconf:5 -msgid "" -"dh_gconf - install GConf defaults files and register schemas (deprecated)" -msgstr "" -"dh_gconf - Installer les fichiers par défaut de GConf et inscrire les " -"schémas (obsolète)" - -# type: textblock -#. type: textblock -#: dh_gconf:17 -msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" -msgstr "B<dh_gconf> [S<I<options_de_debhelper>>] [B<--priority=>I<priorité>>]" - -# type: textblock -#. type: textblock -#: dh_gconf:21 -msgid "" -"B<dh_gconf> is a debhelper program that is responsible for installing GConf " -"defaults files and registering GConf schemas." -msgstr "" -"B<dh_gconf> est un programme de la suite debhelper chargé de l'installation " -"des fichiers par défaut de GConf et de l'inscription des schémas GConf." - -# type: textblock -#. type: textblock -#: dh_gconf:24 -msgid "" -"An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>." -msgstr "" -"Une dépendance appropriée envers gconf2 sera inscrite dans B<${misc:Depends}" -">." - -# type: =item -#. type: =item -#: dh_gconf:30 -msgid "debian/I<package>.gconf-defaults" -msgstr "debian/I<paquet>.gconf-defaults" - -# type: textblock -#. type: textblock -#: dh_gconf:32 -msgid "" -"Installed into F<usr/share/gconf/defaults/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" -"Les fichiers seront installés dans le répertoire de construction du paquet " -"sous F<usr/share/gconf/defaults/10_paquet> où le mot I<paquet> sera remplacé " -"par le nom du paquet." - -# type: =item -#. type: =item -#: dh_gconf:35 -msgid "debian/I<package>.gconf-mandatory" -msgstr "debian/I<paquet>.gconf-mandatory" +"the setuid and setgid bits from all files in the package." +msgstr "" +"B<dh_fixperms> règle à 644 les droits sur tous les fichiers de F<usr/share/" +"doc> à l'exclusion de ceux contenus dans le répertoire F<examples/>. Il " +"règle également à 644 les droits de toutes les pages de manuel. Il enlève " +"l'autorisation d'écrire au groupe et aux autres utilisateurs sur tous les " +"fichiers. Il retire le droit d'exécution sur toutes les bibliothèques, en-" +"têtes (header), modules Perl ou fichiers desktop. Il rend exécutables tous " +"les fichiers de F<bin/>, F<sbin/>, F</usr/games/> et F<etc/init.d> (à partir " +"de la version 4 seulement). Pour finir il annule les bits setuid et setgid " +"de tous les fichiers du paquet." -# type: textblock #. type: textblock -#: dh_gconf:37 +#: dh_fixperms:36 msgid "" -"Installed into F<usr/share/gconf/mandatory/10_package> in the package build " -"directory, with I<package> replaced by the package name." +"When the I<Rules-Requires-Root> field has the (effective) value of I<binary-" +"targets>, B<dh_fixperms> will also reset the ownership of all paths to " +"\"root:root\"." msgstr "" -"Les fichiers seront installés dans le répertoire de construction du paquet " -"sous F<usr/share/gconf/mandatory/defaults/10_paquet> où le mot I<paquet> " -"sera remplacé par le nom du paquet." +"Lorsque le champ I<Rules-Requires-Root> a la valeur I<binary-targets>, " +"B<dh_fixperms> réinitialisera aussi la propriété de tous les chemins à « root:" +"root »." # type: =item #. type: =item -#: dh_gconf:46 -msgid "B<--priority> I<priority>" -msgstr "B<--priority> I<priorité>" +#: dh_fixperms:44 +msgid "B<-X>I<item>, B<--exclude> I<item>" +msgstr "B<-X>I<élément>, B<--exclude> I<élément>" # type: textblock #. type: textblock -#: dh_gconf:48 +#: dh_fixperms:46 msgid "" -"Use I<priority> (which should be a 2-digit number) as the defaults priority " -"instead of B<10>. Higher values than ten can be used by derived " -"distributions (B<20>), CDD distributions (B<50>), or site-specific packages " -"(B<90>)." +"Exclude files that contain I<item> anywhere in their filename from having " +"their permissions changed. You may use this option multiple times to build " +"up a list of things to exclude." msgstr "" -"Détermine la I<priorité> (sous forme d'un nombre à deux chiffres) en " -"remplacement de la priorité par défaut B<10>. Des valeurs plus élevées " -"peuvent être utilisées pour les distributions dérivées (B<20>), les " -"distributions CDD (B<50>), ou les paquets spécifiques à un site (B<90>)." - -# type: textblock -#. type: textblock -#: dh_gconf:113 -msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" -msgstr "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" +"Permet d'exclure de la modification des droits les fichiers qui comportent " +"I<élément> n'importe où dans leur nom. Cette option peut être employée " +"plusieurs fois afin d'exclure une liste d'éléments." # type: textblock #. type: textblock @@ -6766,7 +7288,7 @@ msgstr "" # type: =item #. type: =item #: dh_icons:37 dh_installcatalogs:60 dh_installdebconf:68 dh_installemacsen:60 -#: dh_installinit:82 dh_installinitramfs:47 dh_installmenu:48 +#: dh_installinit:81 dh_installinitramfs:47 dh_installmenu:48 #: dh_installmodules:45 dh_installwm:51 dh_makeshlibs:147 dh_usrlocal:54 msgid "B<-n>, B<--no-scripts>" msgstr "B<-n>, B<--no-scripts>" @@ -6965,7 +7487,7 @@ msgstr "" # type: =item #. type: =item -#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:53 +#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:57 #: dh_installinfo:50 dh_installman:100 dh_movefiles:45 msgid "B<--sourcedir=>I<dir>" msgstr "B<--sourcedir=>I<répertoire>" @@ -7268,7 +7790,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:207 +#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:206 #: dh_installmodules:59 dh_installudev:52 dh_installwm:68 dh_usrlocal:62 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " @@ -7303,17 +7825,21 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:17 +#: dh_installchangelogs:18 +#, fuzzy +#| msgid "" +#| "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " +#| "[I<upstream>]" msgid "" "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " -"[I<upstream>]" +"[B<--no-trim>] [I<upstream>]" msgstr "" "B<dh_installchangelogs> [I<options_de_debhelper>] [B<-k>] [B<-X>I<élément>] " "[I<journal-amont>]" # type: textblock #. type: textblock -#: dh_installchangelogs:21 +#: dh_installchangelogs:22 msgid "" "B<dh_installchangelogs> is a debhelper program that is responsible for " "installing changelogs into package build directories." @@ -7324,7 +7850,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:24 +#: dh_installchangelogs:25 msgid "" "An upstream F<changelog> file may be specified as an option. If none is " "specified, B<dh_installchangelogs> may look for files with names that seem " @@ -7336,7 +7862,7 @@ msgstr "" "dans les paragraphes suivants." #. type: textblock -#: dh_installchangelogs:28 +#: dh_installchangelogs:29 msgid "" "In non-native packages, B<dh_installchangelogs> will first look for " "changelog files installed by the upstream build system into F<< usr/share/" @@ -7361,7 +7887,7 @@ msgstr "" "extensions courantes (telles que F<.txt>, F<.md> et F<.rst>)." #. type: textblock -#: dh_installchangelogs:40 +#: dh_installchangelogs:41 msgid "" "If a changelog file is specified and is an F<html> file (determined by file " "extension), it will be installed as F<usr/share/doc/package/changelog.html> " @@ -7377,33 +7903,42 @@ msgstr "" "n'est spécifiée, un court F<usr/share/doc/paquet/changelog> est généré, " "dirigeant les lecteurs vers le changelog HTML." +#. type: textblock +#: dh_installchangelogs:48 +msgid "" +"The B<debchange>-style Debian changelogs are trimmed to include only entries " +"more recent than the release date of I<oldstable>. No trimming will be " +"performed if the B<--no-trim> option is passed or if the " +"B<DEB_BUILD_OPTIONS> environment variable contains B<notrimdch>." +msgstr "" + # type: =item #. type: =item -#: dh_installchangelogs:51 +#: dh_installchangelogs:57 msgid "F<debian/changelog>" msgstr "F<debian/changelog>" # type: =item #. type: =item -#: dh_installchangelogs:53 +#: dh_installchangelogs:59 msgid "F<debian/NEWS>" msgstr "F<debian/NEWS>" # type: =item #. type: =item -#: dh_installchangelogs:55 +#: dh_installchangelogs:61 msgid "debian/I<package>.changelog" msgstr "debian/I<paquet>.changelog" # type: =item #. type: =item -#: dh_installchangelogs:57 +#: dh_installchangelogs:63 msgid "debian/I<package>.NEWS" msgstr "debian/I<paquet>.NEWS" # type: textblock #. type: textblock -#: dh_installchangelogs:59 +#: dh_installchangelogs:65 msgid "" "Automatically installed into usr/share/doc/I<package>/ in the package build " "directory." @@ -7413,7 +7948,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:62 +#: dh_installchangelogs:68 msgid "" "Use the package specific name if I<package> needs a different F<NEWS> or " "F<changelog> file." @@ -7423,7 +7958,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:65 +#: dh_installchangelogs:71 msgid "" "The F<changelog> file is installed with a name of changelog for native " "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file " @@ -7435,7 +7970,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:77 +#: dh_installchangelogs:83 msgid "" "Keep the original name of the upstream changelog. This will be accomplished " "by installing the upstream changelog as F<changelog>, and making a symlink " @@ -7451,7 +7986,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installchangelogs:85 +#: dh_installchangelogs:91 msgid "" "Exclude upstream F<changelog> files that contain I<item> anywhere in their " "filename from being installed." @@ -7460,20 +7995,35 @@ msgstr "" "où dans leur nom." #. type: textblock -#: dh_installchangelogs:88 +#: dh_installchangelogs:94 msgid "Note that directory name of the changelog is also part of the match." msgstr "" "Note : le nom de dossier du changelog fait aussi partie de la correspondance." # type: =item #. type: =item -#: dh_installchangelogs:90 +#: dh_installchangelogs:96 +#, fuzzy +#| msgid "B<--no-start>" +msgid "B<--no-trim>" +msgstr "B<--no-start>" + +#. type: textblock +#: dh_installchangelogs:98 +msgid "" +"Install the full changelog, not its trimmed version that includes only " +"recent entries." +msgstr "" + +# type: =item +#. type: =item +#: dh_installchangelogs:101 msgid "I<upstream>" msgstr "I<journal-amont>" # type: textblock #. type: textblock -#: dh_installchangelogs:92 +#: dh_installchangelogs:103 msgid "Install this file as the upstream changelog." msgstr "" "Installe ce fichier en tant que journal amont de suivi des modifications." @@ -7521,18 +8071,26 @@ msgstr "debian/I<paquet>.cron.monthly" # type: =item #. type: =item #: dh_installcron:34 +#, fuzzy +#| msgid "debian/I<package>.cron.daily" +msgid "debian/I<package>.cron.yearly" +msgstr "debian/I<paquet>.cron.daily" + +# type: =item +#. type: =item +#: dh_installcron:36 msgid "debian/I<package>.cron.hourly" msgstr "debian/I<paquet>.cron.hourly" # type: =item #. type: =item -#: dh_installcron:36 +#: dh_installcron:38 msgid "debian/I<package>.cron.d" msgstr "debian/I<paquet>.cron.d" # type: textblock #. type: textblock -#: dh_installcron:38 +#: dh_installcron:40 msgid "" "Installed into the appropriate F<etc/cron.*/> directory in the package build " "directory." @@ -7542,15 +8100,15 @@ msgstr "" # type: =item #. type: =item -#: dh_installcron:47 dh_installifupdown:46 dh_installinit:175 +#: dh_installcron:49 dh_installifupdown:46 dh_installinit:174 #: dh_installlogcheck:49 dh_installlogrotate:29 dh_installmodules:49 -#: dh_installpam:38 dh_installppp:42 dh_installudev:38 dh_systemd_enable:95 +#: dh_installpam:42 dh_installppp:42 dh_installudev:38 dh_systemd_enable:94 msgid "B<--name=>I<name>" msgstr "B<--name=>I<nom>" # type: textblock #. type: textblock -#: dh_installcron:49 +#: dh_installcron:51 msgid "" "Look for files named F<debian/package.name.cron.*> and install them as F<etc/" "cron.*/name>, instead of using the usual files and installing them as the " @@ -7676,24 +8234,18 @@ msgstr "I<paquet>.conffiles" #. type: textblock #: dh_installdeb:59 msgid "" -"Historically, this file was needed to manually mark files files as " -"conffiles. However, it has become de facto obsolete since debhelper " -"automatically computed which files should be marked as conffiles." +"This file will be installed into the F<DEBIAN> directory. The provided file " +"will be enriched by debhelper to include all the B<conffiles> auto-detected " +"by debhelper (the maintainer should not list there as debhelper assumes it " +"should handle that part)." msgstr "" -"Historiquement ce fichier était nécessaire pour marquer manuellement les " -"fichiers comme des conffiles. Cependant il est devenu obsolète de facto " -"depuis que debhelper détermine automatiquement quels fichiers doivent être " -"marqués comme conffiles." #. type: textblock -#: dh_installdeb:63 +#: dh_installdeb:64 msgid "" -"In compatibility level up and including 11, this control file will be " -"installed into the F<DEBIAN> directory. In compatibility level 12 and " -"later, the file is silently ignored." +"This file is primarily useful for using \"special\" entries such as the B<< " +"remove-on-upgrade >> feature from dpkg." msgstr "" -"Jusqu'à la version 11, ce fichier de contrôle était installé dans le dossier " -"F<DEBIAN>. À partir de la version 12, ce fichier est ignoré en silence." # type: =item #. type: =item @@ -7772,13 +8324,23 @@ msgstr "" "habituelles. Cette validation renvoie un avertissement depuis la version 10, " "et une erreur en version 12." +#. type: textblock +#: dh_installdeb:95 +msgid "" +"Where possible, B<dh_installdeb> may choose to rewrite some or all of the " +"entries into equivalent features supported in dpkg without relying on " +"maintainer scripts at its sole discretion (examples include rewriting " +"B<rm_conffile> into dpkg's B<remove-on-upgrade>). The minimum requirement " +"for activating this feature is that debhelper runs in compat 10 or later." +msgstr "" + #. type: =item -#: dh_installdeb:104 +#: dh_installdeb:111 dh_installdebconf:76 msgid "B<-D>I<TOKEN=VALUE>, B<--define> I<TOKEN=VALUE>" msgstr "B<-D>I<ITEM=VALEUR>, B<--define> I<ITEM=VALEUR>" #. type: textblock -#: dh_installdeb:106 +#: dh_installdeb:113 dh_installdebconf:78 msgid "" "Define tokens to be replaced inside the maintainer scripts when it is " "generated. Please note that the limitations described in L</Limitations in " @@ -7791,7 +8353,7 @@ msgstr "" "ligne de commande. Les noms d'item non valables déclencheront une erreur." #. type: textblock -#: dh_installdeb:111 +#: dh_installdeb:118 dh_installdebconf:83 msgid "" "In the simple case, this parameter will cause B<< #I<TOKEN># >> to be " "replaced by I<VALUE>. If I<VALUE> starts with a literal I<@>-sign, then " @@ -7803,7 +8365,7 @@ msgstr "" "est censé pointer vers un fichier contenant la valeur réelle à insérer." #. type: textblock -#: dh_installdeb:116 +#: dh_installdeb:123 dh_installdebconf:88 msgid "" "An explicit declared token with this parameter will replace built-in tokens." msgstr "" @@ -7811,12 +8373,12 @@ msgstr "" "internes." #. type: textblock -#: dh_installdeb:119 +#: dh_installdeb:126 dh_installdebconf:91 msgid "Test examples to aid with the understanding:" msgstr "Exemples de tests pour aider à mieux comprendre :" #. type: verbatim -#: dh_installdeb:121 +#: dh_installdeb:128 #, no-wrap msgid "" "\tcat >> debian/postinst <<EOF\n" @@ -7836,7 +8398,7 @@ msgstr "" "\n" #. type: textblock -#: dh_installdeb:128 +#: dh_installdeb:135 dh_installdebconf:100 msgid "" "In this example, B<#SIMPLE#> will expand to B<direct> and B<#FILEBASED#> " "will expand to B<Complex value>." @@ -7845,7 +8407,7 @@ msgstr "" "sera développé en B<valeur_complexe>." #. type: textblock -#: dh_installdeb:131 +#: dh_installdeb:138 msgid "" "It is also possible to set package-specific values for a given token. This " "is useful when B<dh_installdeb> is acting on multiple packages that need " @@ -7858,12 +8420,12 @@ msgstr "" "obtenu en préfixant le nom de l'item par B<< pkg.I<nom-paquet>. >>." #. type: textblock -#: dh_installdeb:136 +#: dh_installdeb:143 dh_installdebconf:108 msgid "This can be used as in the following example:" msgstr "Cela peut être utilisé comme dans l'exemple suivant :" #. type: verbatim -#: dh_installdeb:138 +#: dh_installdeb:145 #, no-wrap msgid "" "\tcat >> debian/foo.postinst <<EOF\n" @@ -7899,7 +8461,7 @@ msgstr "" "\n" #. type: textblock -#: dh_installdeb:153 +#: dh_installdeb:160 msgid "" "In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." "postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and to B<unique-" @@ -7910,7 +8472,7 @@ msgstr "" "B<valeur-unique-truc> dans F<debian/truc.postinst>." #. type: textblock -#: dh_installdeb:157 +#: dh_installdeb:164 msgid "" "Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." "g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> and it " @@ -7922,12 +8484,12 @@ msgstr "" "titi>." #. type: =head1 -#: dh_installdeb:163 +#: dh_installdeb:170 dh_installdebconf:135 msgid "SUBSTITUTION IN MAINTAINER SCRIPTS" msgstr "SUBSTITUTION DANS LES SCRIPTS DU RESPONSABLE" #. type: textblock -#: dh_installdeb:165 +#: dh_installdeb:172 msgid "" "The B<dh_installdeb> will automatically replace the following tokens inside " "a provided maintainer script (if not replaced via B<-D>/B<--define>):" @@ -7938,12 +8500,12 @@ msgstr "" # type: =head1 #. type: =item -#: dh_installdeb:170 +#: dh_installdeb:177 msgid "#DEBHELPER#" msgstr "#DEBHELPER#" #. type: textblock -#: dh_installdeb:172 +#: dh_installdeb:179 msgid "" "This token is by default replaced with generated shell snippets debhelper " "commands. This includes the snippets generated by B<dh_installdeb> from " @@ -7955,12 +8517,12 @@ msgstr "" "présent)." #. type: =item -#: dh_installdeb:176 +#: dh_installdeb:183 dh_installdebconf:142 msgid "#DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME>#" msgstr "#DEB_HOST_I<NOM>#, #DEB_BUILD_I<NOM>#, #DEB_TARGET_I<NOM>#" #. type: textblock -#: dh_installdeb:178 +#: dh_installdeb:185 dh_installdebconf:144 msgid "" "These tokens are replaced with the respective variable from L<dpkg-" "architecture(1)>. In almost all cases, you will want use the B<< " @@ -7973,7 +8535,7 @@ msgstr "" "la valeur correcte lors d'une construction croisée." #. type: textblock -#: dh_installdeb:183 +#: dh_installdeb:190 dh_installdebconf:149 msgid "" "On a best effort, tokens of this pattern that do not match a variable in " "L<dpkg-architecture(1)> will be left as-is." @@ -7982,12 +8544,12 @@ msgstr "" "une variable de L<dpkg-architecture(1)> seront laissés tels quels." #. type: =item -#: dh_installdeb:186 +#: dh_installdeb:193 dh_installdebconf:152 msgid "#ENV.I<NAME>#" msgstr "#ENV.I<NOM>#" #. type: textblock -#: dh_installdeb:188 +#: dh_installdeb:195 dh_installdebconf:154 msgid "" "These tokens of this form will be replaced with value of the corresponding " "environment variable. If the environment variable is unset, the token is " @@ -7998,7 +8560,7 @@ msgstr "" "définie, l'item est remplacé par une chaîne vide." #. type: textblock -#: dh_installdeb:193 +#: dh_installdeb:200 dh_installdebconf:159 msgid "" "Note that there are limits on which names can be used (see L</Limitations in " "token names>)." @@ -8007,12 +8569,12 @@ msgstr "" "Restrictions dans les noms d'item>)." #. type: =item -#: dh_installdeb:196 +#: dh_installdeb:203 dh_installdebconf:162 msgid "#PACKAGE#" msgstr "#PACKAGE#" #. type: textblock -#: dh_installdeb:198 +#: dh_installdeb:205 dh_installdebconf:164 msgid "" "This token is by default replaced by the package name, which will contain " "the concrete script." @@ -8021,12 +8583,12 @@ msgstr "" "script réel." #. type: =head2 -#: dh_installdeb:203 +#: dh_installdeb:210 dh_installdebconf:169 msgid "Limitations in token names" msgstr "Restrictions dans les noms d'item" #. type: textblock -#: dh_installdeb:205 +#: dh_installdeb:212 dh_installdebconf:171 msgid "" "All tokens intended to be substituted must match the regex: #[A-Za-z0-9_.+]+#" msgstr "" @@ -8034,7 +8596,7 @@ msgstr "" "rationnelle : #[A-Za-z0-9_.+]+#" #. type: textblock -#: dh_installdeb:207 +#: dh_installdeb:214 msgid "" "Tokens that do not match that regex will be silently ignored if found in the " "script template. Invalid token names passed to B<-D> or B<--define> will " @@ -8194,6 +8756,172 @@ msgstr "Empêche la modification du script de maintenance F<postrm>." msgid "Pass the params to B<po2debconf>." msgstr "Passe les paramètres à B<po2debconf>." +#. type: verbatim +#: dh_installdebconf:93 +#, fuzzy, no-wrap +#| msgid "" +#| "\tcat >> debian/postinst <<EOF\n" +#| "\t#SIMPLE#\n" +#| "\t#FILEBASED#\n" +#| "\tEOF\n" +#| "\techo -n \"Complex value\" > some-file\n" +#| " dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +#| "\n" +msgid "" +"\tcat >> debian/config <<EOF\n" +"\t#SIMPLE#\n" +"\t#FILEBASED#\n" +"\tEOF\n" +"\techo -n \"Complex value\" > some-file\n" +" dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +"\n" +msgstr "" +"\tcat >> debian/postinst <<EOF\n" +"\t#SIMPLE#\n" +"\t#FILEBASED#\n" +"\tEOF\n" +"\techo -n \"valeur_complexe\" > un_fichier\n" +" dh_installdeb --define SIMPLE=direct --define FILEBASED=@un_fichier\n" +"\n" + +#. type: textblock +#: dh_installdebconf:103 +#, fuzzy +#| msgid "" +#| "It is also possible to set package-specific values for a given token. " +#| "This is useful when B<dh_installdeb> is acting on multiple packages that " +#| "need different values for the same token. This is done by prefixing the " +#| "token name with B<< pkg.I<package-name>. >>." +msgid "" +"It is also possible to set package-specific values for a given token. This " +"is useful when B<dh_installdebconf> is acting on multiple packages that need " +"different values for the same token. This is done by prefixing the token " +"name with B<< pkg.I<package-name>. >>." +msgstr "" +"Il est aussi possible de fixer des valeurs spécifiques à un paquet pour un " +"item donné. Cela est utilisé quand B<dh_installdeb> agit sur plusieurs " +"paquets qui ont besoin de valeurs distinctes pour le même item. Cela est " +"obtenu en préfixant le nom de l'item par B<< pkg.I<nom-paquet>. >>." + +#. type: verbatim +#: dh_installdebconf:110 +#, fuzzy, no-wrap +#| msgid "" +#| "\tcat >> debian/foo.postinst <<EOF\n" +#| "\t# Script for #PACKAGE#\n" +#| "\t#TOKEN#\n" +#| "\tEOF\n" +#| "\tcat >> debian/bar.postinst <<EOF\n" +#| "\t# Script for #PACKAGE#\n" +#| "\t#TOKEN#\n" +#| "\tEOF\n" +#| "\tcat >> debian/baz.postinst <<EOF\n" +#| "\t# Script for #PACKAGE#\n" +#| "\t#TOKEN#\n" +#| "\tEOF\n" +#| " dh_installdeb -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \\\n" +#| " --define pkg.baz.TOKEN=unique-baz-value\n" +#| "\n" +msgid "" +"\tcat >> debian/foo.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/bar.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/baz.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +" dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \\\n" +" --define pkg.baz.TOKEN=unique-baz-value\n" +"\n" +msgstr "" +"\tcat >> debian/toto.postinst <<EOF\n" +"\t# Script pour #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/titi.postinst <<EOF\n" +"\t# Script pour #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/truc.postinst <<EOF\n" +"\t# Script pour #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +" dh_installdeb -ptoto -ptiti -ptruc --define TOKEN=default --define pkg.titi.TOKEN=valeur-unique-titi \\\n" +" --define pkg.truc.TOKEN=valeur-unique-truc\n" +"\n" + +#. type: textblock +#: dh_installdebconf:125 +#, fuzzy +#| msgid "" +#| "In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." +#| "postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and to " +#| "B<unique-baz-value> in F<debian/baz.postinst>." +msgid "" +"In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." +"config>, to B<unique-bar-value> in F<debian/bar.config> and to B<unique-baz-" +"value> in F<debian/baz.config>." +msgstr "" +"Dans cet exemple, B<#TOKEN#> sera développé en B<default> dans F<debian/toto." +"postinst>, en B<valeur-unique-titi> dans F<debian/titi.postinst> et en " +"B<valeur-unique-truc> dans F<debian/truc.postinst>." + +#. type: textblock +#: dh_installdebconf:129 +#, fuzzy +#| msgid "" +#| "Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. " +#| "E.g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> " +#| "and it will be replaced by B<unique-bar-value>." +msgid "" +"Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." +"g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.config> and it " +"will be replaced by B<unique-bar-value>." +msgstr "" +"Notez que les items de B<#pkg.*#> seront visibles dans tous les scripts " +"actifs. Par exemple, il est possible de faire référence à B<#pkg.titi." +"TOKEN#> dans F<debian/toto.postinst> et il sera remplacé par B<valeur-unique-" +"titi>." + +#. type: textblock +#: dh_installdebconf:137 +#, fuzzy +#| msgid "" +#| "The B<dh_installdeb> will automatically replace the following tokens " +#| "inside a provided maintainer script (if not replaced via B<-D>/B<--" +#| "define>):" +msgid "" +"The B<dh_installdebconf> will automatically replace the following tokens " +"inside a provided maintainer script (if not replaced via B<-D>/B<--define>):" +msgstr "" +"B<dh_installdeb> remplacera automatiquement les items suivants dans un " +"script fourni par le responsable (s'il n'est pas remplacé au moyen de B<-D> " +"ou B<--define>) :" + +#. type: textblock +#: dh_installdebconf:173 +#, fuzzy +#| msgid "" +#| "Tokens that do not match that regex will be silently ignored if found in " +#| "the script template. Invalid token names passed to B<-D> or B<--define> " +#| "will cause B<dh_installdeb> to reject the command with an error in most " +#| "cases." +msgid "" +"Tokens that do not match that regex will be silently ignored if found in the " +"script template. Invalid token names passed to B<-D> or B<--define> will " +"cause B<dh_installdebconf> to reject the command with an error in most cases." +msgstr "" +"Les items qui ne correspondent pas à cette expression rationnelle seront " +"ignorés silencieusement s'ils sont présents dans un modèle de script. Les " +"noms d'item non valables passés à B<-D> ou B<--define> feront que " +"B<dh_installdeb> rejettera la commande avec une erreur dans la plupart des " +"cas." + # type: textblock #. type: textblock #: dh_installdirs:5 @@ -8560,7 +9288,7 @@ msgstr "" "de l'installation. Il est à noter que cela inclut les fichiers doc-base." #. type: textblock -#: dh_installdocs:116 dh_installexamples:55 dh_installinfo:52 dh_installman:102 +#: dh_installdocs:116 dh_installexamples:59 dh_installinfo:52 dh_installman:102 msgid "" "Look in the specified directory for files to be installed. This option " "requires compat 11 or later (it is silently ignored in compat 10 or earlier)." @@ -8584,12 +9312,12 @@ msgstr "" # type: =item #. type: =item -#: dh_installdocs:124 dh_installexamples:63 +#: dh_installdocs:124 dh_installexamples:67 msgid "B<--doc-main-package=>I<main-package>" msgstr "B<--doc-main-package=>I<paquet-principal>" #. type: textblock -#: dh_installdocs:126 dh_installexamples:65 +#: dh_installdocs:126 dh_installexamples:69 msgid "" "Set the main package for a documentation package. This is used to install " "the documentation of the documentation package in F<< /usr/share/doc/I<main-" @@ -8601,7 +9329,7 @@ msgstr "" "Debian 3.9.7 au paragraphe 12.3." #. type: textblock -#: dh_installdocs:131 dh_installexamples:70 +#: dh_installdocs:131 dh_installexamples:74 msgid "" "In compat 11 (or later), this option is only useful if debhelper's auto-" "detection of the main package is wrong. The option can also be used to " @@ -8983,9 +9711,18 @@ msgstr "debian/I<paquet>.examples" msgid "Lists example files or directories to be installed." msgstr "Liste les fichiers ou les répertoires d'exemples à installer." +#. type: textblock +#: dh_installexamples:39 +msgid "" +"If upstream provides an F<examples> directory, you will often want to use " +"B<examples/*> rather than B<examples> in this file. The latter would create " +"F<< /usr/share/doc/I<package>/examples/examples >>, which is rarely what you " +"want." +msgstr "" + # type: textblock #. type: textblock -#: dh_installexamples:50 +#: dh_installexamples:54 msgid "" "Install any files specified by command line parameters in ALL packages acted " "on." @@ -8994,7 +9731,7 @@ msgstr "" "B<tous> les paquets construits." #. type: textblock -#: dh_installexamples:58 +#: dh_installexamples:62 msgid "" "Note that this is not the same as the B<--sourcedirectory> option used by " "the B<dh_auto_>I<*> commands. You rarely need to use this option, since " @@ -9007,7 +9744,7 @@ msgstr "" "dans F<debian/tmp> depuis la version 11 de debhelper." #. type: textblock -#: dh_installexamples:75 +#: dh_installexamples:79 msgid "" "This option cannot be used when B<dh_installexamples> is instructed to act " "on multiple packages. If you need this option, you will generally need to " @@ -9020,7 +9757,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installexamples:82 +#: dh_installexamples:86 msgid "" "Exclude files that contain I<item> anywhere in their filename from being " "installed." @@ -9030,7 +9767,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installexamples:87 +#: dh_installexamples:91 msgid "" "Install these files (or directories) as examples into the first package " "acted on. (Or into all packages if B<-A> is specified.)" @@ -9040,7 +9777,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installexamples:94 +#: dh_installexamples:98 msgid "" "Note that B<dh_installexamples> will happily copy entire directory " "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to " @@ -9316,12 +10053,13 @@ msgstr "debian/I<paquet>.service" #. type: textblock #: dh_installinit:67 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"in the package build directory. Only used in compat levels 10 and below." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> in the package build directory. Only used in compat levels 10 and " +"below." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous lib/systemd/system/I<paquet>.service. Cela n'est utilisé que dans les " -"niveaux de compatibilité 10 et inférieurs." +"sous F<< lib/systemd/system/I<paquet>.service >>. Cela n'est utilisé que " +"dans les niveaux de compatibilité 10 et inférieurs." # type: =item #. type: =item @@ -9332,19 +10070,22 @@ msgstr "debian/I<paquet>.tmpfile" # type: textblock #. type: textblock #: dh_installinit:72 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into F<< lib/systemd/system/I<package>." +#| "service >> in the package build directory. Only used in compat levels 10 " +#| "and below." msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.) Only used in compat levels 10 and below." +"the package build directory. Only used in compat levels 10 and below." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous usr/lib/tmpfiles.d/I<paquet>.conf (les mécanismes tmpfiles.d ne sont " -"pour l'instant utilisés que par systemd). Cela n'est utilisé que dans les " -"niveaux de compatibilité 10 et inférieurs." +"sous F<< lib/systemd/system/I<paquet>.service >>. Cela n'est utilisé que " +"dans les niveaux de compatibilité 10 et inférieurs." # type: textblock #. type: textblock -#: dh_installinit:84 +#: dh_installinit:83 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts." msgstr "" "Empêche la modification des scripts de maintenance F<postinst>, F<postrm>, " @@ -9352,13 +10093,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:86 +#: dh_installinit:85 msgid "B<-o>, B<--only-scripts>" msgstr "B<-o>, B<--only-scripts>" # type: textblock #. type: textblock -#: dh_installinit:88 +#: dh_installinit:87 msgid "" "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install " "any init script, default files, upstart job or systemd service file. May be " @@ -9372,7 +10113,7 @@ msgstr "" "B<dh_installinit>." #. type: textblock -#: dh_installinit:93 +#: dh_installinit:92 msgid "" "B<Caveat>: This will bypass all the regular checks and I<unconditionally> " "modify the scripts. You will almost certainly want to use this with B<-p> " @@ -9384,7 +10125,7 @@ msgstr "" "affectés par l'appel. Par exemple :" #. type: verbatim -#: dh_installinit:98 +#: dh_installinit:97 #, no-wrap msgid "" " override_dh_installinit:\n" @@ -9399,13 +10140,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:102 +#: dh_installinit:101 msgid "B<-R>, B<--restart-after-upgrade>" msgstr "B<-R>, B<--restart-after-upgrade>" # type: textblock #. type: textblock -#: dh_installinit:104 +#: dh_installinit:103 msgid "" "Do not stop the init script until after the package upgrade has been " "completed. This is the default behaviour in compat 10." @@ -9416,7 +10157,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installinit:107 +#: dh_installinit:106 msgid "" "In early compat levels, the default was to stop the script in the F<prerm>, " "and starts it again in the F<postinst>." @@ -9426,7 +10167,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installinit:110 dh_systemd_start:45 +#: dh_installinit:109 dh_systemd_start:45 msgid "" "This can be useful for daemons that should not have a possibly long downtime " "during upgrade. But you should make sure that the daemon will not get " @@ -9440,12 +10181,12 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:115 dh_systemd_start:50 +#: dh_installinit:114 dh_systemd_start:50 msgid "B<--no-restart-after-upgrade>" msgstr "B<--no-restart-after-upgrade>" #. type: textblock -#: dh_installinit:117 dh_systemd_start:52 +#: dh_installinit:116 dh_systemd_start:52 msgid "" "Undo a previous B<--restart-after-upgrade> (or the default of compat 10). " "If no other options are given, this will cause the service to be stopped in " @@ -9458,12 +10199,12 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:122 dh_systemd_start:57 +#: dh_installinit:121 dh_systemd_start:57 msgid "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" msgstr "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" #. type: textblock -#: dh_installinit:124 +#: dh_installinit:123 msgid "" "Do not stop init script on upgrade. This has the side-effect of not " "restarting the service as a part of the upgrade." @@ -9472,7 +10213,7 @@ msgstr "" "secondaire de ne pas redémarrer le service lors de la mise à niveau." #. type: textblock -#: dh_installinit:127 +#: dh_installinit:126 msgid "" "If you want to restart the service with minimal downtime, please use B<--" "restart-after-upgrade> (default in compat 10 or later). If you want the " @@ -9486,7 +10227,7 @@ msgstr "" "after-upgrade> (notez le « after-upgrade »)." #. type: textblock -#: dh_installinit:132 +#: dh_installinit:131 msgid "" "Note that the B<--no-restart-on-upgrade> alias is deprecated and will be " "removed in compat 12. This is to avoid confusion with the B<--no-restart-" @@ -9501,13 +10242,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:137 dh_systemd_start:61 +#: dh_installinit:136 dh_systemd_start:61 msgid "B<--no-start>" msgstr "B<--no-start>" # type: textblock #. type: textblock -#: dh_installinit:139 +#: dh_installinit:138 msgid "" "Do not start the init script on install or upgrade, or stop it on removal. " "Only call B<update-rc.d>. Useful for rcS scripts." @@ -9518,12 +10259,12 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:142 dh_systemd_enable:87 +#: dh_installinit:141 dh_systemd_enable:86 msgid "B<--no-enable>" msgstr "B<--no-enable>" #. type: textblock -#: dh_installinit:144 +#: dh_installinit:143 msgid "" "Disable the init script on purge, but do not enable them on install. This " "implies a versioned dependency on B<< init-system-helpers (E<gt>= 1.51) >> " @@ -9537,7 +10278,7 @@ msgstr "" "defaults-disabled >>." #. type: textblock -#: dh_installinit:149 +#: dh_installinit:148 msgid "" "B<Note> that this option does not affect whether the services are started. " "Please remember to also use B<--no-start> if the service should not be " @@ -9548,7 +10289,7 @@ msgstr "" # type: =item #. type: textblock -#: dh_installinit:153 +#: dh_installinit:152 msgid "" "Cannot be combined with B<-u>I<params>, B<--update-rcd-params=>I<params>, or " "B<--> I<params>." @@ -9558,13 +10299,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:156 +#: dh_installinit:155 msgid "B<-d>, B<--remove-d>" msgstr "B<-d>, B<--remove-d>" # type: textblock #. type: textblock -#: dh_installinit:158 +#: dh_installinit:157 msgid "" "Remove trailing B<d> from the name of the package, and use the result for " "the filename the upstart job file is installed as in F<etc/init/> , and for " @@ -9582,13 +10323,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:165 +#: dh_installinit:164 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>" msgstr "B<-u>I<paramètres> B<--update-rcd-params=>I<paramètres>" # type: textblock #. type: textblock -#: dh_installinit:169 +#: dh_installinit:168 msgid "" "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> (or " "B<defaults-disabled> with B<--no-enable>) will be passed to L<update-rc." @@ -9599,13 +10340,13 @@ msgstr "" "L<update-rc.d(8)>." #. type: textblock -#: dh_installinit:173 +#: dh_installinit:172 msgid "Cannot be combined with B<--no-enable>." msgstr "Ne peut pas être combiné à B<--no-enable>." # type: textblock #. type: textblock -#: dh_installinit:177 +#: dh_installinit:176 msgid "" "Install the init script (and default file) as well as upstart job file using " "the filename I<name> instead of the default filename, which is the package " @@ -9623,13 +10364,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:185 +#: dh_installinit:184 msgid "B<--init-script=>I<scriptname>" msgstr "B<--init-script=>I<nom-du-script>" # type: textblock #. type: textblock -#: dh_installinit:187 +#: dh_installinit:186 msgid "" "Use I<scriptname> as the filename the init script is installed as in F<etc/" "init.d/> (and also use it as the filename for the defaults file, if it is " @@ -9646,7 +10387,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installinit:194 +#: dh_installinit:193 msgid "" "This parameter is deprecated, use the B<--name> parameter instead. This " "parameter is incompatible with the use of upstart jobs." @@ -9656,13 +10397,13 @@ msgstr "" # type: =item #. type: =item -#: dh_installinit:197 +#: dh_installinit:196 msgid "B<--error-handler=>I<function>" msgstr "B<--error-handler=>I<fonction>" # type: textblock #. type: textblock -#: dh_installinit:199 +#: dh_installinit:198 msgid "" "Call the named shell I<function> if running the init script fails. The " "function should be provided in the F<prerm> and F<postinst> scripts, before " @@ -9674,18 +10415,18 @@ msgstr "" # type: textblock #. type: textblock -#: dh_installinit:432 +#: dh_installinit:415 msgid "L<debhelper(7)>, L<dh_installsystemd(1)>" msgstr "L<debhelper(7)>, L<dh_installsystemd(1)>" # type: textblock #. type: textblock -#: dh_installinit:440 +#: dh_installinit:423 msgid "Steve Langasek <steve.langasek@canonical.com>" msgstr "Steve Langasek <steve.langasek@canonical.com>" #. type: textblock -#: dh_installinit:442 +#: dh_installinit:425 msgid "Michael Stapelberg <stapelberg@debian.org>" msgstr "Michael Stapelberg <stapelberg@debian.org>" @@ -10543,18 +11284,45 @@ msgstr "debian/I<paquet>.pam" # type: textblock #. type: textblock #: dh_installpam:30 -msgid "Installed into etc/pam.d/I<package> in the package build directory." +#, fuzzy +#| msgid "Installed into etc/pam.d/I<package> in the package build directory." +msgid "Installed into usr/lib/pam.d/I<package> in the package build directory." msgstr "" "Installé dans le répertoire de construction du paquet, sous etc/pam.d/" "I<paquet>." +#. type: textblock +#: dh_installpam:32 +#, fuzzy +#| msgid "" +#| "In compatibility level 11, this file will trigger an error with a " +#| "reminder about ensuring the proper removal of the upstart file in the " +#| "previous package version. Please consider using the \"rm_conffile\" " +#| "feature from L<dh_installdeb(1)> to ensure the proper removal of previous " +#| "upstart files." +msgid "" +"Until compatibility level 14 this file was installed under etc/pam.d/" +"I<package>. Please consider using the \"rm_conffile\" feature from " +"L<dh_installdeb(1)> to ensure the proper removal of previous PAM files." +msgstr "" +"Dans le niveau de compatibilité 11, ce fichier provoquera une erreur " +"contenant un rappel pour correctement supprimer le fichier upstart de la " +"version précédente du paquet. Veuillez utiliser la fonction « rm_conffile » " +"de L<dh_installdeb(1)> pour vous assurer de la suppression correcte des " +"fichiers upstart." + # type: textblock #. type: textblock -#: dh_installpam:40 +#: dh_installpam:44 +#, fuzzy +#| msgid "" +#| "Look for files named debian/I<package>.I<name>.pam and install them as " +#| "etc/pam.d/I<name>, instead of using the usual files and installing them " +#| "using the package name." msgid "" -"Look for files named debian/I<package>.I<name>.pam and install them as etc/" -"pam.d/I<name>, instead of using the usual files and installing them using " -"the package name." +"Look for files named debian/I<package>.I<name>.pam and install them as usr/" +"lib/pam.d/I<name>, instead of using the usual files and installing them " +"using the package name." msgstr "" "Recherche les fichiers nommés debian/I<paquet>.I<nom>.pam et les installe " "sous etc/pam.d/I<nom> au lieu d'utiliser les fichiers habituels et de les " @@ -10832,8 +11600,8 @@ msgid "" "Depends}>.)" msgstr "" "Le paquet doit dépendre de B<xfonts-utils> afin que la commande B<update-" -"fonts->I<*> soit disponible. B<dh_installxfonts> ajoute cette dépendance à B<" -"${misc:Depends}>." +"fonts->I<*> soit disponible. B<dh_installxfonts> ajoute cette dépendance à " +"B<${misc:Depends}>." # type: textblock #. type: textblock @@ -11743,9 +12511,13 @@ msgstr "B<-x>, B<--include-conffiles>" # type: textblock #. type: textblock #: dh_md5sums:37 +#, fuzzy +#| msgid "" +#| "Include conffiles in the md5sums list. Note that this information is " +#| "redundant since it is included elsewhere in Debian packages." msgid "" "Include conffiles in the md5sums list. Note that this information is " -"redundant since it is included elsewhere in Debian packages." +"redundant since it is included in F</var/lib/dpkg/status> in Debian packages." msgstr "" "Inclut les fichiers de configuration (conffiles) dans la liste des sommes " "md5. Nota : Cette information est superflue puisqu'elle est incluse par " @@ -11901,7 +12673,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:19 +#: dh_perl:20 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]" msgstr "" "B<dh_perl> [S<I<options_de_debhelper>>] [B<-d>] [S<I<répertoires de " @@ -11909,10 +12681,10 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:23 +#: dh_perl:24 msgid "" -"B<dh_perl> is a debhelper program that is responsible for generating the B<" -"${perl:Depends}> substitutions and adding them to substvars files." +"B<dh_perl> is a debhelper program that is responsible for generating the " +"B<${perl:Depends}> substitutions and adding them to substvars files." msgstr "" "B<dh_perl> est le programme de la suite debhelper chargé de produire les " "substitutions B<${perl:Depends}> et de les ajouter aux fichiers des " @@ -11920,7 +12692,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:26 +#: dh_perl:27 msgid "" "The program will look at Perl scripts and modules in your package, and will " "use this information to generate a dependency on B<perl> or B<perlapi>. The " @@ -11934,7 +12706,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:31 +#: dh_perl:32 msgid "" "B<dh_perl> also cleans up empty directories that MakeMaker can generate when " "installing Perl modules." @@ -11944,13 +12716,13 @@ msgstr "" # type: =item #. type: =item -#: dh_perl:38 +#: dh_perl:39 msgid "B<-d>" msgstr "B<-d>" # type: textblock #. type: textblock -#: dh_perl:40 +#: dh_perl:41 msgid "" "In some specific cases you may want to depend on B<perl-base> rather than " "the full B<perl> package. If so, you can pass the -d option to make " @@ -11965,7 +12737,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:45 +#: dh_perl:46 msgid "" "Note that this flag may cause no dependency on B<perl-base> to be generated " "at all. B<perl-base> is Essential, so its dependency can be left out, unless " @@ -11977,13 +12749,13 @@ msgstr "" # type: =item #. type: =item -#: dh_perl:49 +#: dh_perl:50 msgid "B<-V>" msgstr "B<-V>" # type: textblock #. type: textblock -#: dh_perl:51 +#: dh_perl:52 msgid "" "By default, scripts and architecture independent modules don't depend on any " "specific version of B<perl>. The B<-V> option causes the current version of " @@ -11996,13 +12768,13 @@ msgstr "" # type: =item #. type: =item -#: dh_perl:55 +#: dh_perl:56 msgid "I<library dirs>" msgstr "I<répertoires de bibliothèque>" # type: textblock #. type: textblock -#: dh_perl:57 +#: dh_perl:58 msgid "" "If your package installs Perl modules in non-standard directories, you can " "make B<dh_perl> check those directories by passing their names on the " @@ -12016,19 +12788,19 @@ msgstr "" # type: textblock #. type: textblock -#: dh_perl:66 +#: dh_perl:67 msgid "Debian policy, version 3.8.3" msgstr "Charte Debian, version 3.8.3" # type: textblock #. type: textblock -#: dh_perl:68 +#: dh_perl:69 msgid "Perl policy, version 1.20" msgstr "Charte Perl, version 1.20" # type: textblock #. type: textblock -#: dh_perl:182 +#: dh_perl:196 msgid "Brendan O'Dea <bod@debian.org>" msgstr "Brendan O'Dea <bod@debian.org>" @@ -12573,8 +13345,8 @@ msgid "" "adding B<noautodbgsym> to the B<DEB_BUILD_OPTIONS> environment variable. " "However, B<dh_strip> will still add debuglinks to ELF binaries when this " "flag is set. This is to ensure that the regular deb package will be " -"identical with and without this flag (assuming it is otherwise \"bit-for-bit" -"\" reproducible)." +"identical with and without this flag (assuming it is otherwise \"bit-for-" +"bit\" reproducible)." msgstr "" "La création automatique des paquets de symboles de débogage peut être " "empêchée en ajoutant B<noautodbgsym> à la variable d'environnement " @@ -12911,119 +13683,131 @@ msgstr "debian/I<paquet>.service, debian/I<paquet>@.service" # type: textblock #. type: textblock #: dh_systemd_enable:47 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into F<< lib/systemd/system/I<package>." +#| "service >>(or F<< lib/systemd/system/I<package>@.service >>) in the " +#| "package build directory." msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"(or lib/systemd/system/I<package>@.service) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> (or F<< lib/systemd/system/I<package>@.service >>) in the package " +"build directory." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous lib/systemd/system/I<paquet>.service (ou lib/systemd/system/I<paquet>@." -"service)." +"sous F<< lib/systemd/system/I<paquet>.service >> (ou F<< usr/lib/systemd/" +"system/I<paquet>@.service >>)." # type: textblock #. type: textblock #: dh_systemd_enable:52 +#, fuzzy +#| msgid "" +#| "If this exists, it is installed into etc/init.d/I<package> in the package " +#| "build directory." msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.)" +"the package build directory." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous usr/lib/tmpfiles.d/I<paquet>.conf (les mécanismes tmpfiles.d ne sont " -"pour l'instant utilisés que par systemd)." +"sous etc/init.d/I<paquet>." # type: =item #. type: =item -#: dh_systemd_enable:56 +#: dh_systemd_enable:55 msgid "debian/I<package>.target, debian/I<package>@.target" msgstr "debian/I<paquet>.target, debian/I<paquet>@.target" # type: textblock #. type: textblock -#: dh_systemd_enable:58 +#: dh_systemd_enable:57 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.target " -"(or lib/systemd/system/I<package>@.target) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"target >> (or F<< lib/systemd/system/I<package>@.target >>) in the package " +"build directory." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous lib/systemd/system/I<paquet>.target (ou lib/systemd/system/I<paquet>@." -"target)." +"sous F<< lib/systemd/system/I<paquet>.target >> (ou F<< usr/lib/systemd/" +"system/I<paquet>@.target >>)." # type: =item #. type: =item -#: dh_systemd_enable:61 +#: dh_systemd_enable:60 msgid "debian/I<package>.socket, debian/I<package>@.socket" msgstr "debian/I<paquet>.socket, debian/I<paquet>@.socket" # type: textblock #. type: textblock -#: dh_systemd_enable:63 +#: dh_systemd_enable:62 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.socket " -"(or lib/systemd/system/I<package>@.socket) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"socket >> (or F<< lib/systemd/system/I<package>@.socket >>) in the package " +"build directory." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous lib/systemd/system/I<paquet>.socket (ou lib/systemd/system/I<paquet>@." -"socket)." +"sous F<< lib/systemd/system/I<paquet>.socket >> (ou F<< usr/lib/systemd/" +"system/I<paquet>@.socket >>)." # type: =item #. type: =item -#: dh_systemd_enable:66 +#: dh_systemd_enable:65 msgid "debian/I<package>.mount" msgstr "debian/I<paquet>.mount" # type: textblock #. type: textblock -#: dh_systemd_enable:68 +#: dh_systemd_enable:67 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.mount in " -"the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.mount " +">> in the package build directory." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous lib/systemd/system/I<paquet>.mount." +"sous F<< lib/systemd/system/I<paquet>.mount >>." # type: =item #. type: =item -#: dh_systemd_enable:71 +#: dh_systemd_enable:70 msgid "debian/I<package>.path, debian/I<package>@.path" msgstr "debian/I<paquet>.path, debian/I<paquet>@.path" # type: textblock #. type: textblock -#: dh_systemd_enable:73 +#: dh_systemd_enable:72 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.path (or " -"lib/systemd/system/I<package>@.path) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.path " +">> (or F<< lib/systemd/system/I<package>@.path >>) in the package build " +"directory." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous lib/systemd/system/I<paquet>.path (ou lib/systemd/system/I<paquet>@." -"path)." +"sous F<< lib/systemd/system/I<paquet>.path >> (ou F<< usr/lib/systemd/system/" +"I<paquet>@.path >>)." # type: =item #. type: =item -#: dh_systemd_enable:76 +#: dh_systemd_enable:75 msgid "debian/I<package>.timer, debian/I<package>@.timer" msgstr "debian/I<paquet>.timer, debian/I<paquet>@.timer" # type: textblock #. type: textblock -#: dh_systemd_enable:78 +#: dh_systemd_enable:77 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.timer (or " -"lib/systemd/system/I<package>@.timer) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.timer " +">> (or F<< lib/systemd/system/I<package>@.timer >>) in the package build " +"directory." msgstr "" "S'il existe, il est installé dans le répertoire de construction du paquet, " -"sous lib/systemd/system/I<paquet>.timer (ou lib/systemd/system/I<paquet>@." -"timer)." +"sous F<< lib/systemd/system/I<paquet>.timer >> (ou F<< usr/lib/systemd/" +"system/I<paquet>@.timer >>)." #. type: textblock -#: dh_systemd_enable:89 +#: dh_systemd_enable:88 msgid "Disable the service(s) on purge, but do not enable them on install." msgstr "" "Désactiver le(s) service(s) lors de la purge, mais ne pas l'activer à " "l'installation." #. type: textblock -#: dh_systemd_enable:91 +#: dh_systemd_enable:90 msgid "" "B<Note> that this option does not affect whether the services are started. " "That is controlled by L<dh_systemd_start(1)> (using e.g. its B<--no-start> " @@ -13035,7 +13819,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_systemd_enable:97 +#: dh_systemd_enable:96 msgid "" "Install the service file as I<name.service> instead of the default filename, " "which is the I<package.service>. When this parameter is used, " @@ -13049,7 +13833,7 @@ msgstr "" # type: textblock #. type: textblock -#: dh_systemd_enable:106 dh_systemd_start:70 +#: dh_systemd_enable:105 dh_systemd_start:70 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " "between invocations of this command (with the same arguments). Otherwise, it " @@ -13062,7 +13846,7 @@ msgstr "" "scripts de maintenance du paquet." #. type: textblock -#: dh_systemd_enable:111 +#: dh_systemd_enable:110 msgid "" "Note that B<dh_systemd_enable> should be run before B<dh_installinit>. The " "default sequence in B<dh> does the right thing, this note is only relevant " @@ -13073,12 +13857,12 @@ msgstr "" "n'est valable que lorsque B<dh_systemd_enable> est appelé manuellement." #. type: textblock -#: dh_systemd_enable:283 +#: dh_systemd_enable:282 msgid "L<dh_systemd_start(1)>, L<debhelper(7)>" msgstr "L<dh_systemd_start(1)>, L<debhelper(7)>" #. type: textblock -#: dh_systemd_enable:287 dh_systemd_start:286 +#: dh_systemd_enable:286 dh_systemd_start:286 msgid "pkg-systemd-maintainers@lists.alioth.debian.org" msgstr "pkg-systemd-maintainers@lists.alioth.debian.org" @@ -13191,6 +13975,155 @@ msgstr "" "Ce niveau de compatibilité est en phase de test ; des changements peuvent " "encore survenir." +# type: textblock +#~ msgid "" +#~ "Set to B<1> to enable verbose mode. Debhelper will output every command " +#~ "it runs. Also enables verbose build logs for some build systems like " +#~ "autoconf." +#~ msgstr "" +#~ "Mettre cette variable à B<1> valide le mode verbeux. Debhelper affichera " +#~ "chaque commande exécutée. Valide aussi les journaux de construction " +#~ "bavards pour certains systèmes de construction comme autoconf." + +#~ msgid "This value affects most B<dh_auto_*> tools." +#~ msgstr "Cette valeur affecte la plupart des outils de B<dh_auto_*>." + +# type: textblock +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.) Only used in compat levels 10 and below." +#~ msgstr "" +#~ "S'il existe, il est installé dans le répertoire de construction du " +#~ "paquet, sous usr/lib/tmpfiles.d/I<paquet>.conf (les mécanismes tmpfiles.d " +#~ "ne sont pour l'instant utilisés que par systemd). Cela n'est utilisé que " +#~ "dans les niveaux de compatibilité 10 et inférieurs." + +# type: textblock +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.)" +#~ msgstr "" +#~ "S'il existe, il est installé dans le répertoire de construction du " +#~ "paquet, sous usr/lib/tmpfiles.d/I<paquet>.conf (les mécanismes tmpfiles.d " +#~ "ne sont pour l'instant utilisés que par systemd)." + +#~ msgid "" +#~ "This can cause issues with running binaries directly from the build " +#~ "directories as they might now require a manually set B<LD_LIBRARY_PATH>. " +#~ "If you need to override this change, we recommend that you try to pass " +#~ "the B<-DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the " +#~ "problem (leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). " +#~ "This should undo the need for B<LD_LIBRARY_PATH> and avoid the " +#~ "reproducibility issues on Linux, where B<$ORIGIN> is supported by the " +#~ "runtime linkers." +#~ msgstr "" +#~ "Cela peut provoquer des problèmes avec l'exécution de binaires " +#~ "directement à partir des répertoires de construction parce qu'ils " +#~ "pourraient maintenant requérir une configuration manuelle de " +#~ "B<LD_LIBRARY_PATH>. S'il est nécessaire de réécrire cette modification, " +#~ "il est recommandé d'essayer de passer d'abord l'option B<-" +#~ "DCMAKE_SKIP_RPATH=OFF> pour voir si cela corrige le problème (laissant " +#~ "B<CMAKE_BUILD_RPATH_USE_ORIGIN> à sa nouvelle valeur par défaut). Cela " +#~ "devrait supprimer la nécessité de B<LD_LIBRARY_PATH> et éviter les " +#~ "problèmes de reproductibilité dans Linux où B<$ORIGIN> est pris en charge " +#~ "par les créateurs de liens lors de l'exécution." + +#~ msgid "" +#~ "Historically, this file was needed to manually mark files files as " +#~ "conffiles. However, it has become de facto obsolete since debhelper " +#~ "automatically computed which files should be marked as conffiles." +#~ msgstr "" +#~ "Historiquement ce fichier était nécessaire pour marquer manuellement les " +#~ "fichiers comme des conffiles. Cependant il est devenu obsolète de facto " +#~ "depuis que debhelper détermine automatiquement quels fichiers doivent " +#~ "être marqués comme conffiles." + +#~ msgid "" +#~ "In compatibility level up and including 11, this control file will be " +#~ "installed into the F<DEBIAN> directory. In compatibility level 12 and " +#~ "later, the file is silently ignored." +#~ msgstr "" +#~ "Jusqu'à la version 11, ce fichier de contrôle était installé dans le " +#~ "dossier F<DEBIAN>. À partir de la version 12, ce fichier est ignoré en " +#~ "silence." + +# type: textblock +#~ msgid "" +#~ "dh_gconf - install GConf defaults files and register schemas (deprecated)" +#~ msgstr "" +#~ "dh_gconf - Installer les fichiers par défaut de GConf et inscrire les " +#~ "schémas (obsolète)" + +# type: textblock +#~ msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" +#~ msgstr "" +#~ "B<dh_gconf> [S<I<options_de_debhelper>>] [B<--priority=>I<priorité>>]" + +# type: textblock +#~ msgid "" +#~ "B<dh_gconf> is a debhelper program that is responsible for installing " +#~ "GConf defaults files and registering GConf schemas." +#~ msgstr "" +#~ "B<dh_gconf> est un programme de la suite debhelper chargé de " +#~ "l'installation des fichiers par défaut de GConf et de l'inscription des " +#~ "schémas GConf." + +# type: textblock +#~ msgid "" +#~ "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}" +#~ ">." +#~ msgstr "" +#~ "Une dépendance appropriée envers gconf2 sera inscrite dans B<${misc:" +#~ "Depends}>." + +# type: =item +#~ msgid "debian/I<package>.gconf-defaults" +#~ msgstr "debian/I<paquet>.gconf-defaults" + +# type: textblock +#~ msgid "" +#~ "Installed into F<usr/share/gconf/defaults/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "Les fichiers seront installés dans le répertoire de construction du " +#~ "paquet sous F<usr/share/gconf/defaults/10_paquet> où le mot I<paquet> " +#~ "sera remplacé par le nom du paquet." + +# type: =item +#~ msgid "debian/I<package>.gconf-mandatory" +#~ msgstr "debian/I<paquet>.gconf-mandatory" + +# type: textblock +#~ msgid "" +#~ "Installed into F<usr/share/gconf/mandatory/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "Les fichiers seront installés dans le répertoire de construction du " +#~ "paquet sous F<usr/share/gconf/mandatory/defaults/10_paquet> où le mot " +#~ "I<paquet> sera remplacé par le nom du paquet." + +# type: =item +#~ msgid "B<--priority> I<priority>" +#~ msgstr "B<--priority> I<priorité>" + +# type: textblock +#~ msgid "" +#~ "Use I<priority> (which should be a 2-digit number) as the defaults " +#~ "priority instead of B<10>. Higher values than ten can be used by derived " +#~ "distributions (B<20>), CDD distributions (B<50>), or site-specific " +#~ "packages (B<90>)." +#~ msgstr "" +#~ "Détermine la I<priorité> (sous forme d'un nombre à deux chiffres) en " +#~ "remplacement de la priorité par défaut B<10>. Des valeurs plus élevées " +#~ "peuvent être utilisées pour les distributions dérivées (B<20>), les " +#~ "distributions CDD (B<50>), ou les paquets spécifiques à un site (B<90>)." + +# type: textblock +#~ msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" +#~ msgstr "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" + # type: textblock #~ msgid "" #~ "B<dh_clean> should be the last debhelper command run in the B<clean> " @@ -13735,8 +14668,8 @@ msgstr "" #~ msgid "" #~ "B<dh> no longer creates a stamp (or log) file to record whether the build " #~ "already ran or not. This means that unless upstream's build system " -#~ "correctly tracks this, the build will be run twice (once for the \"build" -#~ "\" target and once for the \"binary\" target)." +#~ "correctly tracks this, the build will be run twice (once for the " +#~ "\"build\" target and once for the \"binary\" target)." #~ msgstr "" #~ "B<dh> ne crée plus de fichier témoin (ou de journal) pour savoir si la " #~ "construction a déjà eu lieu. Cela signifie que, sauf si le système de " @@ -13751,11 +14684,6 @@ msgstr "" #~ "(« clean », par exemple B<dpkg-buildpackage -nc>) se comportera comme " #~ "attendu." -#~ msgid "The previous behaviour can restored by using B<--with build-stamp>" -#~ msgstr "" -#~ "Le comportement précédent peut être retrouvé en utilisant B<--with build-" -#~ "stamp>" - #~ msgid "" #~ "In compat 11, this file is no longer installed the format has been " #~ "deprecated. Please migrate to a desktop file instead." diff --git a/man/po4a/po/ja.po b/man/po4a/po/ja.po index 6197e2d567412ffc456a866e6b8442c3c9ca667c..e7d71ad0d62448226aa9f9d518058ab0382fb661 100644 --- a/man/po4a/po/ja.po +++ b/man/po4a/po/ja.po @@ -6,7 +6,7 @@ msgid "" msgstr "" "Project-Id-Version: debhelper 9.20141107\n" -"POT-Creation-Date: 2021-02-22 09:37+0100\n" +"POT-Creation-Date: 2022-11-20 19:46+0100\n" "PO-Revision-Date: 2016-09-17 20:45+0900\n" "Last-Translator: Hideki Yamane <henrich@debian.org>\n" "Language-Team: Debian JP Project <debian-doc@debian.or.jp>\n" @@ -17,10 +17,11 @@ msgstr "" "Last-Reviewer: Hideki Yamane <henrich@debian.org>\n" #. type: =head1 -#: debhelper.pod:3 debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 -#: dh_auto_clean:3 dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 -#: dh_bugfiles:3 dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 -#: dh_gconf:3 dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 +#: debhelper.pod:3 debhelper-compat-upgrade-checklist.pod:3 +#: debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 dh_auto_clean:3 +#: dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 dh_bugfiles:3 +#: dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 +#: dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 #: dh_installchangelogs:3 dh_installcron:3 dh_installdeb:3 dh_installdebconf:3 #: dh_installdirs:3 dh_installdocs:5 dh_installemacsen:3 dh_installexamples:5 #: dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installinitramfs:3 @@ -40,19 +41,20 @@ msgid "debhelper - the debhelper tool suite" msgstr "debhelper - debhelper 関連ツール群" #. type: =head1 -#: debhelper.pod:7 debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 -#: dh_auto_clean:16 dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 -#: dh_bugfiles:15 dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 -#: dh_fixperms:16 dh_gconf:15 dh_gencontrol:16 dh_icons:16 dh_install:15 -#: dh_installcatalogs:17 dh_installchangelogs:15 dh_installcron:15 -#: dh_installdeb:15 dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 +#: debhelper.pod:7 debhelper-compat-upgrade-checklist.pod:7 +#: debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 dh_auto_clean:16 +#: dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 dh_bugfiles:15 +#: dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 dh_fixperms:16 +#: dh_gencontrol:16 dh_icons:16 dh_install:15 dh_installcatalogs:17 +#: dh_installchangelogs:16 dh_installcron:15 dh_installdeb:15 +#: dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 #: dh_installemacsen:15 dh_installexamples:17 dh_installifupdown:15 #: dh_installinfo:15 dh_installinit:16 dh_installinitramfs:15 #: dh_installlogcheck:15 dh_installlogrotate:15 dh_installman:16 #: dh_installmanpages:16 dh_installmenu:15 dh_installmime:15 #: dh_installmodules:16 dh_installpam:15 dh_installppp:15 dh_installudev:15 #: dh_installwm:15 dh_installxfonts:15 dh_link:16 dh_lintian:15 -#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:17 +#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:18 #: dh_prep:15 dh_shlibdeps:17 dh_strip:16 dh_testdir:15 dh_testroot:9 #: dh_usrlocal:19 dh_systemd_enable:16 dh_systemd_start:17 msgid "SYNOPSIS" @@ -68,19 +70,19 @@ msgstr "" "N>I<package>] [B<-P>I<tmpdir>]" #. type: =head1 -#: debhelper.pod:11 dh:26 dh_auto_build:20 dh_auto_clean:20 -#: dh_auto_configure:20 dh_auto_install:22 dh_auto_test:20 dh_bugfiles:19 -#: dh_builddeb:21 dh_clean:19 dh_compress:21 dh_dwz:20 dh_fixperms:20 -#: dh_gconf:19 dh_gencontrol:20 dh_icons:20 dh_install:19 dh_installcatalogs:21 -#: dh_installchangelogs:19 dh_installcron:19 dh_installdeb:19 -#: dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 +#: debhelper.pod:11 debhelper-compat-upgrade-checklist.pod:17 dh:26 +#: dh_auto_build:20 dh_auto_clean:20 dh_auto_configure:20 dh_auto_install:22 +#: dh_auto_test:20 dh_bugfiles:19 dh_builddeb:21 dh_clean:19 dh_compress:21 +#: dh_dwz:20 dh_fixperms:20 dh_gencontrol:20 dh_icons:20 dh_install:19 +#: dh_installcatalogs:21 dh_installchangelogs:20 dh_installcron:19 +#: dh_installdeb:19 dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 #: dh_installemacsen:19 dh_installexamples:21 dh_installifupdown:19 #: dh_installinfo:19 dh_installinit:20 dh_installinitramfs:19 #: dh_installlogcheck:19 dh_installlogrotate:19 dh_installman:20 #: dh_installmanpages:20 dh_installmenu:19 dh_installmime:19 #: dh_installmodules:20 dh_installpam:19 dh_installppp:19 dh_installudev:19 #: dh_installwm:19 dh_installxfonts:19 dh_link:20 dh_lintian:19 -#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:21 +#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:22 #: dh_prep:19 dh_shlibdeps:21 dh_strip:20 dh_testdir:19 dh_testroot:13 #: dh_usrlocal:23 dh_systemd_enable:20 dh_systemd_start:21 msgid "DESCRIPTION" @@ -584,19 +586,33 @@ msgstr "B<-v>, B<--verbose>" #. type: textblock #: debhelper.pod:277 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." +msgid "Verbose mode: show commands that modify the package build directory." +msgstr "" +"冗長出力モード。パッケージビルドディレクトリを変更ã™ã‚‹ã‚ˆã†ãªã‚³ãƒžãƒ³ãƒ‰ã‚’å…¨ã¦è¡¨" +"示ã—ã¾ã™ã€‚" + +#. type: textblock +#: debhelper.pod:279 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." msgid "" -"Verbose mode: show all commands that modify the package build directory." +"Note that verbose mode may also output other \"internal\" commands that do " +"not directly affect the package build directory." msgstr "" "冗長出力モード。パッケージビルドディレクトリを変更ã™ã‚‹ã‚ˆã†ãªã‚³ãƒžãƒ³ãƒ‰ã‚’å…¨ã¦è¡¨" "示ã—ã¾ã™ã€‚" #. type: =item -#: debhelper.pod:279 dh:266 +#: debhelper.pod:282 dh:307 msgid "B<--no-act>" msgstr "B<--no-act>" #. type: textblock -#: debhelper.pod:281 +#: debhelper.pod:284 msgid "" "Do not really do anything. If used with -v, the result is that the command " "will output what it would have done." @@ -605,12 +621,12 @@ msgstr "" "è¡Œã†ã‹ãŒå‡ºåŠ›ã•ã‚Œã¾ã™ã€‚" #. type: =item -#: debhelper.pod:284 +#: debhelper.pod:287 msgid "B<-a>, B<--arch>" msgstr "B<-a>, B<--arch>" #. type: textblock -#: debhelper.pod:286 +#: debhelper.pod:289 msgid "" "Act on architecture dependent packages that should be built for the " "B<DEB_HOST_ARCH> architecture." @@ -619,22 +635,22 @@ msgstr "" "るよã†ã«å‹•ä½œã—ã¾ã™ã€‚" #. type: =item -#: debhelper.pod:289 +#: debhelper.pod:292 msgid "B<-i>, B<--indep>" msgstr "B<-i>, B<--indep>" #. type: textblock -#: debhelper.pod:291 +#: debhelper.pod:294 msgid "Act on all architecture independent packages." msgstr "å…¨ã¦ã®ã‚¢ãƒ¼ã‚テクãƒãƒ£éžä¾å˜ãƒ‘ッケージã«å¯¾ã—ã¦å‡¦ç†ã‚’è¡Œã„ã¾ã™ã€‚" #. type: =item -#: debhelper.pod:293 +#: debhelper.pod:296 msgid "B<-p>I<package>, B<--package=>I<package>" msgstr "B<-p>I<package>, B<--package=>I<package>" #. type: textblock -#: debhelper.pod:295 +#: debhelper.pod:298 msgid "" "Act on the package named I<package>. This option may be specified multiple " "times to make debhelper operate on a given set of packages." @@ -643,29 +659,29 @@ msgstr "" "debhelper ã«å‡¦ç†ã•ã›ã‚‹éš›ã«ã¯ã€ç¹°ã‚Šè¿”ã—列挙ã—ã¦æŒ‡å®šã—ã¦ãã ã•ã„。" #. type: =item -#: debhelper.pod:298 +#: debhelper.pod:301 msgid "B<-s>, B<--same-arch>" msgstr "B<-s>, B<--same-arch>" #. type: textblock -#: debhelper.pod:300 +#: debhelper.pod:303 msgid "Deprecated alias of B<-a>." msgstr "廃æ¢ã•ã‚ŒãŸ B<-a> ã®ã‚¨ã‚¤ãƒªã‚¢ã‚¹ã§ã™ã€‚" #. type: textblock -#: debhelper.pod:302 dh_install:80 dh_install:89 +#: debhelper.pod:305 dh_install:80 dh_install:89 #, fuzzy #| msgid "The option is removed in compat 11." msgid "This option is removed in compat 12." msgstr "ã“ã®ã‚ªãƒ—ションã¯äº’æ›æ€§ãƒ¬ãƒ™ãƒ« 11 ã§å»ƒæ¢ã•ã‚Œã¦ã„ã¾ã™ã€‚" #. type: =item -#: debhelper.pod:304 +#: debhelper.pod:307 msgid "B<-N>I<package>, B<--no-package=>I<package>" msgstr "B<-N>I<package>, B<--no-package=>I<package>" #. type: textblock -#: debhelper.pod:306 +#: debhelper.pod:309 msgid "" "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option " "lists the package as one that should be acted on." @@ -674,12 +690,12 @@ msgstr "" "指定ã•ã‚Œã¦ã„るパッケージã«ã¤ã„ã¦ã¯å‡¦ç†ã‚’è¡Œã‚ãªã„よã†ã«ã—ã¾ã™ã€‚" #. type: =item -#: debhelper.pod:309 +#: debhelper.pod:312 msgid "B<--remaining-packages>" msgstr "B<--remaining-packages>" #. type: textblock -#: debhelper.pod:311 +#: debhelper.pod:314 msgid "" "Do not act on the packages which have already been acted on by this " "debhelper command earlier (i.e. if the command is present in the package " @@ -694,12 +710,12 @@ msgstr "" "ã³å‡ºã—ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆè¨å®šã«ã‚ˆã‚‹å‡¦ç†ã‚’è¡Œã†ã¨ã„ã†äº‹ãŒã§ãã¾ã™ã€‚" #. type: =item -#: debhelper.pod:317 +#: debhelper.pod:320 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" msgstr "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" #. type: textblock -#: debhelper.pod:319 +#: debhelper.pod:322 msgid "" "Use I<tmpdir> for package build directory. The default is debian/I<package>" msgstr "" @@ -707,12 +723,12 @@ msgstr "" "debian/I<package> ディレクトリãŒä½¿ã‚ã‚Œã¾ã™ã€‚" #. type: =item -#: debhelper.pod:321 +#: debhelper.pod:324 msgid "B<--mainpackage=>I<package>" msgstr "B<--mainpackage=>I<package>" #. type: textblock -#: debhelper.pod:323 +#: debhelper.pod:326 msgid "" "This little-used option changes the package which debhelper considers the " "\"main package\", that is, the first one listed in F<debian/control>, and " @@ -725,12 +741,12 @@ msgstr "" "F<debian/foo> ファイルãŒä½¿ã‚れるよã†ã«ãªã‚Šã¾ã™ã€‚" #. type: =item -#: debhelper.pod:328 +#: debhelper.pod:331 msgid "B<-O=>I<option>|I<bundle>" msgstr "B<-O=>I<option>|I<bundle>" #. type: textblock -#: debhelper.pod:330 +#: debhelper.pod:333 msgid "" "This is used by L<dh(1)> when passing user-specified options to all the " "commands it runs. If the command supports the specified option or option " @@ -744,12 +760,12 @@ msgstr "" "オプションã¯ç„¡è¦–ã•ã‚Œã¾ã™ã€‚" #. type: =head1 -#: debhelper.pod:337 +#: debhelper.pod:340 msgid "COMMON DEBHELPER OPTIONS" msgstr "DEBHELPER ã®å…±é€šã‚ªãƒ—ション" #. type: textblock -#: debhelper.pod:339 +#: debhelper.pod:342 msgid "" "The following command line options are supported by some debhelper " "programs. See the man page of each program for a complete explanation of " @@ -760,24 +776,24 @@ msgstr "" "man ページをå‚ç…§ã—ã¦ãã ã•ã„。" #. type: =item -#: debhelper.pod:345 +#: debhelper.pod:348 msgid "B<-n>" msgstr "B<-n>" #. type: textblock -#: debhelper.pod:347 +#: debhelper.pod:350 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts." msgstr "F<postinst>, F<postrm> ç‰ã®ã‚¹ã‚¯ãƒªãƒ—トã«å¤‰æ›´ã‚’åŠ ãˆã¾ã›ã‚“。" #. type: =item -#: debhelper.pod:349 dh_compress:56 dh_dwz:56 dh_installchangelogs:83 -#: dh_installdocs:109 dh_installexamples:80 dh_link:78 dh_makeshlibs:154 +#: debhelper.pod:352 dh_compress:56 dh_dwz:56 dh_installchangelogs:89 +#: dh_installdocs:109 dh_installexamples:84 dh_link:78 dh_makeshlibs:154 #: dh_md5sums:40 dh_shlibdeps:34 dh_strip:42 msgid "B<-X>I<item>, B<--exclude=>I<item>" msgstr "B<-X>I<item>, B<--exclude=>I<item>" #. type: textblock -#: debhelper.pod:351 +#: debhelper.pod:354 #, fuzzy #| msgid "" #| "Exclude an item from processing. This option may be used multiple times, " @@ -793,14 +809,14 @@ msgstr "" "ã•ã‚ŒãŸãƒ†ã‚ストãŒå«ã¾ã‚Œã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã¯ã™ã¹ã¦é™¤å¤–ã•ã‚Œã¾ã™ã€‚" #. type: =item -#: debhelper.pod:355 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 -#: dh_installdocs:104 dh_installexamples:48 dh_installinfo:45 dh_installman:90 +#: debhelper.pod:358 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 +#: dh_installdocs:104 dh_installexamples:52 dh_installinfo:45 dh_installman:90 #: dh_installwm:55 dh_link:73 msgid "B<-A>, B<--all>" msgstr "B<-A>, B<--all>" #. type: textblock -#: debhelper.pod:357 +#: debhelper.pod:360 msgid "" "Makes files or other items that are specified on the command line take " "effect in ALL packages acted on, not just the first." @@ -809,12 +825,12 @@ msgstr "" "ジã ã‘ã§ãªã全パッケージã«å¯¾ã—ã¦å‡¦ç†ã‚’è¡Œã„ã¾ã™ã€‚" #. type: =head1 -#: debhelper.pod:362 +#: debhelper.pod:365 msgid "BUILD SYSTEM OPTIONS" msgstr "ビルドシステム用オプション" #. type: textblock -#: debhelper.pod:364 +#: debhelper.pod:367 msgid "" "The following command line options are supported by all of the " "B<dh_auto_>I<*> debhelper programs. These programs support a variety of " @@ -832,12 +848,12 @@ msgstr "" "ã™ã€‚" #. type: =item -#: debhelper.pod:373 +#: debhelper.pod:376 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>" msgstr "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>" #. type: textblock -#: debhelper.pod:375 +#: debhelper.pod:378 msgid "" "Force use of the specified I<buildsystem>, instead of trying to auto-select " "one which might be applicable for the package." @@ -846,12 +862,12 @@ msgstr "" "ã§æŒ‡å®šã—ãŸãƒ“ルドシステムを強制的ã«ä½¿ç”¨ã—ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:378 +#: debhelper.pod:381 msgid "Pass B<none> as I<buildsystem> to disable auto-selection." msgstr "" #. type: =item -#: debhelper.pod:380 +#: debhelper.pod:383 #, fuzzy #| msgid "B<-D>I<directory>, B<--sourcedirectory=>I<directory>" msgid "" @@ -860,7 +876,7 @@ msgid "" msgstr "B<-D>I<directory>, B<--sourcedirectory=>I<directory>" #. type: textblock -#: debhelper.pod:382 +#: debhelper.pod:385 msgid "" "Assume that the original package source tree is at the specified " "I<directory> rather than the top level directory of the Debian source " @@ -870,7 +886,7 @@ msgstr "" "リã§ã¯ãªãã€I<directory> ã§æŒ‡å®šã—ãŸå ´æ‰€ã«ã‚ã‚‹ã¨ä»®å®šã—ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:386 +#: debhelper.pod:389 msgid "" "B<Warning>: The B<--sourcedir> variant matches a similar named option in " "B<dh_install> and B<dh_missing> (etc.) for historical reasons. While they " @@ -880,7 +896,7 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:392 +#: debhelper.pod:395 #, fuzzy #| msgid "B<-B>[I<directory>], B<--builddirectory=>[I<directory>]" msgid "" @@ -889,7 +905,7 @@ msgid "" msgstr "B<-B>[I<directory>], B<--builddirectory=>[I<directory>]" #. type: textblock -#: debhelper.pod:394 +#: debhelper.pod:397 msgid "" "Enable out of source building and use the specified I<directory> as the " "build directory. If I<directory> parameter is omitted, a default build " @@ -900,7 +916,7 @@ msgstr "" "ã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ãƒ“ルドディレクトリãŒåˆ©ç”¨ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:398 +#: debhelper.pod:401 msgid "" "If this option is not specified, building will be done in source by default " "unless the build system requires or prefers out of source tree building. In " @@ -913,7 +929,7 @@ msgstr "" "ã•ã‚Œã¦ã„ãªãã¦ã‚‚デフォルトã®ãƒ“ルドディレクトリãŒä½¿ç”¨ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:403 +#: debhelper.pod:406 msgid "" "If the build system prefers out of source tree building but still allows in " "source building, the latter can be re-enabled by passing a build directory " @@ -925,12 +941,12 @@ msgstr "" "ドを行ã†ã‚ˆã†ã«ã§ãã¾ã™ã€‚" #. type: =item -#: debhelper.pod:407 +#: debhelper.pod:410 msgid "B<--parallel>, B<--no-parallel>" msgstr "B<--parallel>, B<--no-parallel>" #. type: textblock -#: debhelper.pod:409 +#: debhelper.pod:412 msgid "" "Control whether parallel builds should be used if underlying build system " "supports them. The number of parallel jobs is controlled by the " @@ -943,7 +959,7 @@ msgstr "" "ルã€4.9.1ç« >)。ビルドシステム固有ã®åˆ¶é™ã«å½±éŸ¿ã‚’å—ã‘ã‚‹å ´åˆã‚‚ã‚ã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:415 +#: debhelper.pod:418 msgid "" "If neither option is specified, debhelper currently defaults to B<--" "parallel> in compat 10 (or later) and B<--no-parallel> otherwise." @@ -954,7 +970,7 @@ msgstr "" # FIXME: typo: unnecessary #. type: textblock -#: debhelper.pod:418 +#: debhelper.pod:421 msgid "" "As an optimization, B<dh> will try to avoid passing these options to " "subprocesses, if they are unnecessary and the only options passed. Notably " @@ -967,12 +983,12 @@ msgstr "" "ãªã„ (ã¾ãŸã¯ã“ã®å€¤ãŒ 1 ã§ã‚ã‚‹) å ´åˆã«èµ·ã“ã‚Šã¾ã™ã€‚" #. type: =item -#: debhelper.pod:423 +#: debhelper.pod:426 msgid "B<--max-parallel=>I<maximum>" msgstr "B<--max-parallel=>I<maximum>" #. type: textblock -#: debhelper.pod:425 +#: debhelper.pod:428 msgid "" "This option implies B<--parallel> and allows further limiting the number of " "jobs that can be used in a parallel build. If the package build is known to " @@ -985,7 +1001,7 @@ msgstr "" "を指定ã§ãã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:430 +#: debhelper.pod:433 msgid "" "Notably, setting the maximum to 1 is effectively the same as using B<--no-" "parallel>." @@ -994,20 +1010,20 @@ msgstr "" "ã™ã€‚" #. type: =item -#: debhelper.pod:433 +#: debhelper.pod:436 msgid "B<--reload-all-buildenv-variables>" msgstr "" #. type: textblock -#: debhelper.pod:435 +#: debhelper.pod:438 msgid "" -"By default, L<dh(1)> will compute several environment (e.g. by using L<dpkg-" -"buildflags(1)>) and cache them to avoid having all B<dh_auto_*> tool " -"recompute them." +"By default, L<dh(1)> will compute several environment variables (e.g. by " +"using L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> " +"tool recompute them." msgstr "" #. type: textblock -#: debhelper.pod:439 +#: debhelper.pod:442 msgid "" "When passing this option, the concrete B<dh_auto_*> tool will ignore the " "cache from L<dh(1)> and retrigger a rebuild of these variables. This is " @@ -1017,7 +1033,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:446 +#: debhelper.pod:449 #, no-wrap msgid "" " export DEB_CFLAGS_MAINT_APPEND=-O3\n" @@ -1025,7 +1041,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:448 +#: debhelper.pod:451 #, no-wrap msgid "" " %:\n" @@ -1034,7 +1050,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:451 +#: debhelper.pod:454 #, no-wrap msgid "" " override_dh_auto_configure:\n" @@ -1045,7 +1061,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:456 +#: debhelper.pod:459 msgid "" "Without B<--reload-all-buildenv-variables> in the second call to " "L<dh_auto_configure(1)>, the change in B<DEB_CFLAGS_MAINT_APPEND> would be " @@ -1054,19 +1070,19 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:461 +#: debhelper.pod:464 msgid "" "This option is only available with B<< debhelper (>= 12.7~) >> when the " "package uses compatibility level 9 or later." msgstr "" #. type: =item -#: debhelper.pod:464 dh:258 +#: debhelper.pod:467 dh:299 msgid "B<--list>, B<-l>" msgstr "B<--list>, B<-l>" #. type: textblock -#: debhelper.pod:466 +#: debhelper.pod:469 msgid "" "List all build systems supported by debhelper on this system. The list " "includes both default and third party build systems (marked as such). Also " @@ -1080,12 +1096,12 @@ msgstr "" "示ã—ã¾ã™ã€‚" #. type: =head1 -#: debhelper.pod:473 +#: debhelper.pod:476 msgid "COMPATIBILITY LEVELS" msgstr "互æ›æ€§ãƒ¬ãƒ™ãƒ«" #. type: textblock -#: debhelper.pod:475 +#: debhelper.pod:478 #, fuzzy #| msgid "" #| "From time to time, major non-backwards-compatible changes need to be made " @@ -1113,7 +1129,7 @@ msgstr "" "ル㯠F<debian/compat> ファイルã§æŒ‡å®šã•ã‚Œã€ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã¯å¿…é ˆã¨ãªã£ã¦ã„ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:482 +#: debhelper.pod:485 #, fuzzy #| msgid "" #| "Tell debhelper what compatibility level to use by writing a number to " @@ -1127,7 +1143,7 @@ msgstr "" "ãˆã¾ã™ã€‚例ãˆã°ã€v#RECOMMENDED_COMPAT# モードを使ã†ã«ã¯æ¬¡ã®æ§˜ã«ã—ã¾ã™:" #. type: verbatim -#: debhelper.pod:486 +#: debhelper.pod:489 #, fuzzy, no-wrap #| msgid "" #| " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#)\n" @@ -1140,7 +1156,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:488 +#: debhelper.pod:491 msgid "" "This also serves as an appropriate versioned build dependency on a " "sufficient version of the debhelper package, so you do not need to specify a " @@ -1150,30 +1166,30 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:494 +#: debhelper.pod:497 msgid "" "Note that debhelper does not provide debhelper-compat for experimental or " "beta compatibility levels; packages experimenting with those compatibility " -"levels should use F<debian/compat> or B<DH_COMPAT>." +"levels should use F<debian/compat> (or, if only for selected commands, " +"B<DH_COMPAT>)." msgstr "" #. type: textblock -#: debhelper.pod:498 +#: debhelper.pod:501 msgid "" "Prior versions of debhelper required specifying the compatibility level in " "the file F<debian/compat>, and current debhelper still supports this for " -"backward compatibility, though a package may not specify a compatibility " -"level via multiple methods at once. To use this method, F<debian/compat> " -"should contain the compatibility level as a single number, and no other " -"content. If you specify the compatibility level by this method, your package " -"will also need a versioned build dependency on a version of the debhelper " -"package equal to (or greater than) the compatibility level your package " -"uses. So, if you specify compatibility level #RECOMMENDED_COMPAT# in " -"F<debian/compat>, ensure F<debian/control> has:" +"backward compatibility. To use this method, the F<debian/compat> file should " +"contain the compatibility level as a single number, and no other content. If " +"you specify the compatibility level by this method, your package will also " +"need a versioned build dependency on a version of the debhelper package " +"equal to (or greater than) the compatibility level your package uses. So, if " +"you specify compatibility level #RECOMMENDED_COMPAT# in F<debian/compat>, " +"ensure F<debian/control> has:" msgstr "" #. type: verbatim -#: debhelper.pod:509 +#: debhelper.pod:511 #, fuzzy, no-wrap #| msgid "" #| " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#)\n" @@ -1186,7 +1202,27 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:511 +#: debhelper.pod:513 +msgid "" +"Note that you must use either the build-dependency on debhelper-compat or " +"the F<debian/compat> file. Whenever possible, the debhelper-compat build-" +"dependency is recommended." +msgstr "" + +#. type: textblock +#: debhelper.pod:517 +msgid "" +"If needed be, the B<DH_COMPAT> environment variable can be used to override " +"the compat level for a given command. The feature is mostly useful for " +"either temporarily upgrading a few commands to a new compat level or keeping " +"a few commands on a lower compat level. The feature is best used sparingly " +"as it effectively introduces special-cases into the F<debian/rules> file " +"that may be surprising to maintainers or reviewers (or, in the long term, to " +"yourself)." +msgstr "" + +#. type: textblock +#: debhelper.pod:525 msgid "" "Unless otherwise indicated, all debhelper documentation assumes that you are " "using the most recent compatibility level, and in most cases does not " @@ -1201,1042 +1237,1267 @@ msgstr "" "ã™ã€‚" #. type: =head2 -#: debhelper.pod:518 +#: debhelper.pod:532 #, fuzzy #| msgid "This is the lowest supported compatibility level." msgid "Supported compatibility levels" msgstr "ã“ã‚Œã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„る最低é™ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã§ã™ã€‚" #. type: textblock -#: debhelper.pod:520 -msgid "These are the available compatibility levels:" -msgstr "利用å¯èƒ½ãªäº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã¯ä»¥ä¸‹ã®é€šã‚Šã§ã™:" - -#. type: =item -#: debhelper.pod:524 debhelper-obsolete-compat.pod:89 -msgid "v5" -msgstr "v5" - -#. type: textblock -#: debhelper.pod:526 debhelper-obsolete-compat.pod:91 -msgid "This is the lowest supported compatibility level." -msgstr "ã“ã‚Œã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„る最低é™ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã§ã™ã€‚" - -#. type: textblock -#: debhelper.pod:528 +#: debhelper.pod:534 msgid "" -"If you are upgrading from an earlier compatibility level, please review " -"L<debhelper-obsolete-compat(7)>." +"The list of supported compatibility levels and the related upgrade check " +"list has moved to L<debhelper-compat-upgrade-checklist(7)>." msgstr "" -"ã“れ以å‰ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã‹ã‚‰ã‚¢ãƒƒãƒ—グレードã—よã†ã¨ã—ã¦ã„ã‚‹å ´åˆã€L<debhelper-" -"obsolete-compat(7)> を確èªã—ã¦ä¸‹ã•ã„。" - -#. type: textblock -#: debhelper.pod:531 debhelper.pod:563 debhelper.pod:593 debhelper.pod:624 -#: debhelper.pod:685 debhelper-obsolete-compat.pod:28 -#: debhelper-obsolete-compat.pod:35 debhelper-obsolete-compat.pod:58 -#: debhelper-obsolete-compat.pod:87 -msgid "This mode is deprecated." -msgstr "ã“ã®ãƒ¢ãƒ¼ãƒ‰ã¯å»ƒæ¢ã•ã‚Œã¾ã—ãŸã€‚" - -#. type: =item -#: debhelper.pod:533 -msgid "v6" -msgstr "v6" -#. type: textblock -#: debhelper.pod:535 -msgid "Changes from v5 are:" -msgstr "v5 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +#. type: =head1 +#: debhelper.pod:537 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 +#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:96 +#: dh_installinit:204 dh_installinitramfs:60 dh_installman:131 +#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 +#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:103 +#: dh_systemd_start:68 +msgid "NOTES" +msgstr "付記" -#. type: =item -#: debhelper.pod:539 debhelper.pod:544 debhelper.pod:550 debhelper.pod:556 -#: debhelper.pod:571 debhelper.pod:578 debhelper.pod:582 debhelper.pod:586 -#: debhelper.pod:601 debhelper.pod:605 debhelper.pod:613 debhelper.pod:618 -#: debhelper.pod:632 debhelper.pod:637 debhelper.pod:644 debhelper.pod:649 -#: debhelper.pod:654 debhelper.pod:662 debhelper.pod:668 debhelper.pod:673 -#: debhelper.pod:678 debhelper.pod:693 debhelper.pod:698 debhelper.pod:704 -#: debhelper.pod:710 debhelper.pod:715 debhelper.pod:721 debhelper.pod:730 -#: debhelper.pod:740 debhelper.pod:746 debhelper.pod:769 debhelper.pod:776 -#: debhelper.pod:782 debhelper.pod:788 debhelper.pod:794 debhelper.pod:823 -#: debhelper.pod:829 debhelper.pod:841 debhelper.pod:849 debhelper.pod:855 -#: debhelper.pod:860 debhelper.pod:865 debhelper.pod:870 debhelper.pod:878 -#: debhelper.pod:888 debhelper.pod:898 debhelper.pod:905 debhelper.pod:917 -#: debhelper.pod:922 debhelper.pod:950 debhelper.pod:967 debhelper.pod:977 -#: debhelper.pod:981 debhelper.pod:986 debhelper.pod:991 debhelper.pod:998 -#: debhelper.pod:1004 debhelper.pod:1012 debhelper.pod:1018 debhelper.pod:1022 -#: debhelper.pod:1027 debhelper.pod:1032 debhelper.pod:1041 debhelper.pod:1057 -#: debhelper.pod:1064 debhelper.pod:1080 debhelper.pod:1088 debhelper.pod:1093 -#: debhelper.pod:1108 debhelper.pod:1116 debhelper.pod:1124 debhelper.pod:1133 -#: debhelper.pod:1139 debhelper.pod:1149 debhelper.pod:1157 debhelper.pod:1163 -#: debhelper.pod:1177 debhelper.pod:1188 debhelper.pod:1202 debhelper.pod:1213 -#: debhelper.pod:1231 debhelper.pod:1245 debhelper-obsolete-compat.pod:43 -#: debhelper-obsolete-compat.pod:48 debhelper-obsolete-compat.pod:52 -#: debhelper-obsolete-compat.pod:66 debhelper-obsolete-compat.pod:71 -#: debhelper-obsolete-compat.pod:76 debhelper-obsolete-compat.pod:81 -#: debhelper-obsolete-compat.pod:97 debhelper-obsolete-compat.pod:101 -#: debhelper-obsolete-compat.pod:106 debhelper-obsolete-compat.pod:110 -#: dh_testroot:36 dh_testroot:41 dh_testroot:46 -msgid "-" -msgstr "-" +#. type: =head2 +#: debhelper.pod:539 +msgid "Multiple binary package support" +msgstr "複数ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージã®ã‚µãƒãƒ¼ãƒˆ" #. type: textblock #: debhelper.pod:541 msgid "" -"Commands that generate maintainer script fragments will order the fragments " -"in reverse order for the F<prerm> and F<postrm> scripts." +"If your source package generates more than one binary package, debhelper " +"programs will default to acting on all binary packages when run. If your " +"source package happens to generate one architecture dependent package, and " +"another architecture independent package, this is not the correct behavior, " +"because you need to generate the architecture dependent packages in the " +"binary-arch F<debian/rules> target, and the architecture independent " +"packages in the binary-indep F<debian/rules> target." msgstr "" -"メンテナンス用スクリプトã®ä¸€éƒ¨ã‚’生æˆã™ã‚‹ã‚³ãƒžãƒ³ãƒ‰ã¯ã€F<prerm> 㨠F<postrm> ス" -"クリプト用ã«ã“ã‚Œã‚‰ã‚’é€†é †ã«ä¸¦ã³æ›¿ãˆã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" +"ソースパッケージãŒè¤‡æ•°ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージを生æˆã™ã‚‹å ´åˆã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯ " +"debhelper ã¯å®Ÿè¡Œæ™‚ã«ã™ã¹ã¦ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージを生æˆã—ã¾ã™ã€‚ã“ã®å ´åˆã‚½ãƒ¼ã‚¹" +"パッケージãŒã€ã‚¢ãƒ¼ã‚テクãƒãƒ£ä¾å˜ãƒ‘ッケージã¨ã‚¢ãƒ¼ã‚テクãƒãƒ£éžä¾å˜ãƒ‘ッケージを" +"åŒæ™‚ã«ç”Ÿæˆã™ã‚‹ã¨ã—ãŸã‚‰ã€ã“ã®æŒ¯ã‚‹èˆžã„ã¯æ£ã—ãã‚ã‚Šã¾ã›ã‚“。ã¨ã„ã†ã®ã‚‚ã€F<debian/" +"rules> ã§ã¯ã€ã‚¢ãƒ¼ã‚テクãƒãƒ£ä¾å˜ãƒ‘ッケージを生æˆã™ã‚‹ãªã‚‰ binary-arch ターゲッ" +"ト内ã§ç”Ÿæˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ã‚¢ãƒ¼ã‚テクãƒãƒ£éžä¾å˜ã®ãƒ‘ッケージãªã‚‰ã°ã€binary-" +"indep ターゲットã§ç”Ÿæˆã™ã‚‹å¿…è¦ãŒã‚る為ã§ã™ã€‚" #. type: textblock -#: debhelper.pod:546 +#: debhelper.pod:549 msgid "" -"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." -"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " -"directory." +"To facilitate this, as well as give you more control over which packages are " +"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" +"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " +"are given, debhelper programs default to acting on all packages listed in " +"the control file, with the exceptions below." msgstr "" -"B<dh_installwm> 㯠F<x-window-manager.1.gz> ã¨ã„ㆠslave 㪠man ページã¸ãƒªãƒ³" -"クを作るよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã¯ãƒ‘ッケージビルドディレクトリ内㮠F<usr/share/" -"man/man1> ディレクトリ㫠man ページãŒã‚ã‚‹å ´åˆã«è¡Œã‚ã‚Œã¾ã™ã€‚" +"ã“れを容易ã«ã™ã‚‹ç‚ºã€ã©ã®ãƒ‘ッケージ㌠debhelper プãƒã‚°ãƒ©ãƒ ã«ã‚ˆã£ã¦å‡¦ç†ã•ã‚Œã‚‹ã‹" +"をよりコントãƒãƒ¼ãƒ«ã™ã‚‹ã®ã¨åŒæ§˜ã€ã™ã¹ã¦ã® debhelper プãƒã‚°ãƒ©ãƒ 㯠B<-a>, B<-" +"i>, B<-p>, B<-s> パラメータを解釈ã§ãã¾ã™ã€‚ã“れらã®ãƒ‘ラメータã¯é‡è¤‡å¯èƒ½ã§ã™ã€‚" +"何も指定ã—ãªã„å ´åˆã€debhelper プãƒã‚°ãƒ©ãƒ ã¯ã€ä»¥ä¸‹ã®ä¾‹å¤–を除ã„㦠control ファイ" +"ルã«åˆ—挙ã•ã‚ŒãŸã™ã¹ã¦ã®ãƒ‘ッケージã«å¯¾ã—ã¦å‡¦ç†ã‚’è¡Œã„ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:552 +#: debhelper.pod:555 msgid "" -"B<dh_builddeb> did not previously delete everything matching " -"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " -"B<CVS:.svn:.git>. Now it does." +"First, any package whose B<Architecture> field in B<debian/control> does not " +"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " +"section 5.6.8>)." msgstr "" -"B<dh_builddeb> ã¯ã€B<CVS:.svn:.git> ã®ã‚ˆã†ã«é™¤å¤–ã™ã‚‹å¯¾è±¡ã‚’ " -"B<DH_ALWAYS_EXCLUDE> ã«æŒ‡å®šã—ã¦ã‚‚該当ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã‚’削除ã—ã¦ã„ã¾ã›ã‚“ã§ã—ãŸã€‚本" -"互æ›æ€§ãƒ¬ãƒ™ãƒ«ã§ã¯å‰Šé™¤ã™ã‚‹ã‚ˆã†ã«ãªã£ã¦ã„ã¾ã™ã€‚" +"ã¾ãšã€B<debian/control> ä¸ã® B<Architecture> フィールド㌠B<DEB_HOST_ARCH> " +"アーã‚テクãƒãƒ£ã«ä¸€è‡´ã—ãªã„å…¨ã¦ã®ãƒ‘ッケージãŒé™¤å¤–ã•ã‚Œã¾ã™ (L<Debian ãƒãƒªã‚·ãƒ¼ " +"5.6.8 ç« >)。" #. type: textblock -#: debhelper.pod:558 +#: debhelper.pod:559 msgid "" -"B<dh_installman> allows overwriting existing man pages in the package build " -"directory. In previous compatibility levels it silently refuses to do this." +"Also, some additional packages may be excluded based on the contents of the " +"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " +"binary package stanzas in B<debian/control>, according to the draft policy " +"at L<https://wiki.debian.org/BuildProfileSpec>." msgstr "" -"B<dh_installman> ã¯ã€ãƒ‘ッケージビルドディレクトリã«ã™ã§ã«å˜åœ¨ã™ã‚‹ man ページ" -"を上書ãã—ã¦ã‚‚良ããªã‚Šã¾ã—ãŸã€‚ã“れより以å‰ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã®å…ƒã§ã¯ã€ã“ã®ã‚ˆã†ãª" -"動作ã¯ä½•ã®è¦å‘Šã‚‚ãªã拒絶ã•ã‚Œã¦ã„ã¾ã—ãŸã€‚" - -#. type: =item -#: debhelper.pod:565 -msgid "v7" -msgstr "v7" +"ã¾ãŸã€L<https://wiki.debian.org/BuildProfileSpec> ã«ã‚るドラフトã®ãƒãƒªã‚·ãƒ¼ã«" +"よるã¨ã€B<DEB_BUILD_PROFILES> 環境変数㨠B<debian/control> ä¸ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッ" +"ケージ節㮠B<Build-Profiles> フィールドã®å†…容を元ã«è¿½åŠ ã§ãƒ‘ッケージãŒé™¤å¤–ã•ã‚Œ" +"ã¾ã™ã€‚" -#. type: textblock -#: debhelper.pod:567 -msgid "Changes from v6 are:" -msgstr "v6 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +#. type: =head3 +#: debhelper.pod:564 +msgid "Interaction between package selections and Build-Profiles" +msgstr "" #. type: textblock -#: debhelper.pod:573 +#: debhelper.pod:566 msgid "" -"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " -"doesn't find them in the current directory (or wherever you tell it look " -"using B<--sourcedir>). This allows B<dh_install> to interoperate with " -"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " -"special parameters." +"Build-Profiles affect which packages are included in the package selections " +"mechanisms in debhelper. Generally, the package selections are described " +"from the assumption that all packages are enabled. This section describes " +"how the selections react when a package is disabled due to the active Build-" +"Profiles (or lack of active Build-Profiles)." msgstr "" -"ã‚‚ã—ã€F<debian/tmp> 以下ã«ã‚るよã†ãªãƒ•ã‚¡ã‚¤ãƒ«ãŒã€ã‚«ãƒ¬ãƒ³ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ãªã„å ´" -"åˆ (ã‚‚ã—ãã¯ã€B<--sourcedir> ã§æŒ‡å®šã—ãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ãªã„å ´åˆ) ã€" -"B<dh_install> 㯠F<debian/tmp> を探ã—ã«ã„ãよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã®æŒ¯ã‚‹èˆžã„ã®å¤‰" -"æ›´ã«ã‚ˆã‚Šã€B<dh_install> ã«ç‰¹ã«ä½•ã‹å¼•æ•°ã‚’指定ã—ãªãã¦ã‚‚ã€F<debian/tmp> ã«ã‚¤ãƒ³" -"ストールã—よã†ã¨ã™ã‚‹ B<dh_auto_install> ã¨å”調ã—ã¦å‹•ä½œã§ãるよã†ã«ãªã‚Šã¾ã—" -"ãŸã€‚" -#. type: textblock -#: debhelper.pod:580 -msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +#. type: =item +#: debhelper.pod:574 +msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" msgstr "" -"B<dh_clean> 㯠F<debian/clean> ã‚’èªã¿ã€ãã“ã«è¨˜è¼‰ã•ã‚Œã¦ã„るファイルを消ã™ã‚ˆã†" -"ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper.pod:584 -msgid "B<dh_clean> will delete toplevel F<*-stamp> files." +#: debhelper.pod:576 +msgid "" +"The package disabled by Build-Profiles is silently excluded from the " +"selection." msgstr "" -"B<dh_clean> ã¯ãƒ“ルドディレクトリã®æœ€ä¸Šä½ã®éšŽå±¤ã«ã‚ã‚‹ F<*-stamp> ファイルを消" -"ã™ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper.pod:588 +#: debhelper.pod:579 msgid "" -"B<dh_installchangelogs> will guess at what file is the upstream changelog if " -"none is specified." +"Note you will receive a warning if I<all> packages related to these " +"selections are disabled. In that case, it generally does not make sense to " +"do the build in the first place." msgstr "" -"B<dh_installchangelogs> ã¯ã€ä½•ã‚‚指定ã—ãªãã¦ã‚‚ã©ã®ãƒ•ã‚¡ã‚¤ãƒ«ãŒ upstream ã® " -"changelog ã§ã‚ã‚‹ã‹ã‚’推定ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: =item -#: debhelper.pod:595 -msgid "v8" -msgstr "v8" +#: debhelper.pod:583 +#, fuzzy +#| msgid "B<-N>I<package>, B<--no-package=>I<package>" +msgid "-N I<package> / --no-package I<package>" +msgstr "B<-N>I<package>, B<--no-package=>I<package>" #. type: textblock -#: debhelper.pod:597 -msgid "Changes from v7 are:" -msgstr "v7 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +#: debhelper.pod:585 +msgid "The option is accepted and effectively does nothing." +msgstr "" + +#. type: =item +#: debhelper.pod:587 +#, fuzzy +#| msgid "B<-p>I<package>, B<--package=>I<package>" +msgid "-p I<package> / --package I<package>" +msgstr "B<-p>I<package>, B<--package=>I<package>" #. type: textblock -#: debhelper.pod:603 -msgid "" -"Commands will fail rather than warning when they are passed unknown options." +#: debhelper.pod:589 +msgid "The option is accepted, but debhelper will not act on the package." msgstr "" -"未定義ã®ã‚ªãƒ—ションを渡ãã†ã¨ã™ã‚‹ã¨ã€è¦å‘Šæ–‡ã‚’出ã—ã¦å‡¦ç†ç¶šè¡Œã™ã‚‹ã®ã§ã¯ãªãã€ã‚¨" -"ラーã«ã—ã¦å‡¦ç†ã‚’失敗ã•ã›ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper.pod:607 +#: debhelper.pod:593 msgid "" -"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " -"generates shlibs files for. So B<-X> can be used to exclude libraries. " -"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " -"processed before will be passed to it, a behavior change that can cause some " -"packages to fail to build." +"Note that it does not matter whether a package is enabled or disabled by " +"default." msgstr "" -"B<dh_makeshlibs> ã¯ã€shlibs ファイルを作æˆã™ã‚‹ç‚ºã«ã€B<dpkg-gensymbols> ã‚’ã™ã¹" -"ã¦ã®å…±æœ‰ãƒ©ã‚¤ãƒ–ラリã«å¯¾ã—ã¦å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚B<-X> を指定ã™ã‚‹ã¨å®Ÿè¡Œã‚’" -"除外ã™ã‚‹ãƒ©ã‚¤ãƒ–ラリを指定ã§ãã¾ã™ã€‚ã¾ãŸã€é€šå¸¸ã§ã¯ãªã„å ´æ‰€ã«ãƒ©ã‚¤ãƒ–ラリãŒã‚る為 " -"B<dh_makeshlibs> ã¸æ¸¡ã™å‰ã« B<dpkg-gensymbols> ãŒå‡¦ç†ã§ããªã„よã†ãªå ´åˆã€ãƒ‘ッ" -"ケージã®ãƒ“ルドãŒå¤±æ•—ã«çµ‚ã‚るよã†ã«ãªã‚Šã¾ã—ãŸã€‚" + +# note: it should be "Debian maintainer scripts"? +#. type: =head2 +#: debhelper.pod:596 +msgid "Automatic generation of Debian install scripts" +msgstr "メンテナスクリプトã®è‡ªå‹•ç”Ÿæˆ" #. type: textblock -#: debhelper.pod:615 +#: debhelper.pod:598 msgid "" -"B<dh> requires the sequence to run be specified as the first parameter, and " -"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo $@>" -"\"." +"Some debhelper commands will automatically generate parts of Debian " +"maintainer scripts. If you want these automatically generated things " +"included in your existing Debian maintainer scripts, then you need to add " +"B<#DEBHELPER#> to your scripts, in the place the code should be added. " +"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " +"B<dh_installdeb>." msgstr "" -"B<dh> ã¯æœ€åˆã®ãƒ‘ラメータã¨ã—ã¦ã€ä¸€é€£ã®å‡¦ç†ã®åå‰ã‚’指定ã—ã€ãã®æ¬¡ã«ã‚ªãƒ—ション" -"を記載ã—ãªã‘ã‚Œã°ãªã‚‰ãªããªã‚Šã¾ã—ãŸã€‚ã¤ã¾ã‚Šã€\"B<dh $@ --foo>\" ãŒæ£ã—" -"ãã€\"B<dh --foo $@>\" ã¯é–“é•ã„ã¨ãªã‚Šã¾ã™ã€‚" +"debhelper コマンドã«ã¯ã€Debian メンテナスクリプトã®ä¸€éƒ¨ã‚’自動的ã«ç”Ÿæˆã™ã‚‹ã‚‚ã®" +"ãŒã‚ã‚Šã¾ã™ã€‚ã‚‚ã—ã€æ—¢å˜ã® Debian メンテナスクリプトã«è‡ªå‹•ç”Ÿæˆã•ã‚ŒãŸéƒ¨åˆ†ã‚’å«ã‚€" +"よã†ã«ã—ãŸã‘ã‚Œã°ã€ã‚³ãƒ¼ãƒ‰ã‚’è¿½åŠ ã—ãŸã„å ´æ‰€ã« B<#DEBHELPER#> ã¨è¿½è¨˜ã—ã¦ãã ã•" +"ã„。B<#DEBHELPER#> 㯠B<dh_installdeb> ãŒå®Ÿè¡Œã•ã‚Œã‚‹éš›ã«ã€è‡ªå‹•ç”Ÿæˆã•ã‚ŒãŸã‚³ãƒ¼ãƒ‰" +"ã¸ç½®æ›ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:620 +#: debhelper.pod:605 msgid "" -"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " -"F<Makefile.PL>." +"If a script does not exist at all and debhelper needs to add something to " +"it, then debhelper will create the complete script." msgstr "" -"B<dh_auto_>I<*> 㯠F<Makefile.PL> ファイルよりもã€Perl ã® B<Module::Build> モ" -"ジュールを優先ã—ã¦åˆ©ç”¨ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" - -#. type: =item -#: debhelper.pod:626 -msgid "v9" -msgstr "v9" - -#. type: textblock -#: debhelper.pod:628 -msgid "Changes from v8 are:" -msgstr "v8 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +"スクリプトãŒã¾ã£ãŸãå˜åœ¨ã—ãªã„㌠debhelper ãŒä½•ã‹ã‚’スクリプトã«è¿½åŠ ã™ã‚‹å¿…è¦ãŒ" +"ã‚ã‚‹å ´åˆã€debhelper ã¯ã‚¹ã‚¯ãƒªãƒ—トを一å¼ç”Ÿæˆã—ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:634 +#: debhelper.pod:608 msgid "" -"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " -"directories to autoconf in --libdir and --libexecdir." +"All debhelper commands that automatically generate code in this way let it " +"be disabled by the -n parameter (see above)." msgstr "" -"multiarch をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚特㫠B<dh_auto_configure> 㯠autoconfコマンド㸠" -"--libdir ã‚„ --libexecdir ã« multiarch 用途ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã‚’渡ã™ã‚ˆã†ã«ãªã£ã¦ã„" -"ã¾ã™ã€‚" +"-n パラメーターを指定ã™ã‚‹ã¨ã€ã“ã®ã‚ˆã†ãª debhelper プãƒã‚°ãƒ©ãƒ ã«ã‚ˆã‚‹ã‚¹ã‚¯ãƒªãƒ—ト" +"ã®è‡ªå‹•ç”Ÿæˆã‚’è¡Œã‚ãªã„よã†ã«ã§ãã¾ã™ (上記å‚ç…§)。" #. type: textblock -#: debhelper.pod:639 +#: debhelper.pod:611 msgid "" -"dh is aware of the usual dependencies between targets in debian/rules. So, " -"\"dh binary\" will run any build, build-arch, build-indep, install, etc " -"targets that exist in the rules file. There's no need to define an explicit " -"binary target with explicit dependencies on the other targets." +"Note that the inserted code will be shell code, so you cannot directly use " +"it in a Perl script. If you would like to embed it into a Perl script, here " +"is one way to do that (note that I made sure that $1, $2, etc are set with " +"the set command):" msgstr "" -"dh コマンド㯠debian/rules ã«è¨˜è¼‰ã•ã‚Œã¦ã„るターゲット間ã®ä¸€èˆ¬çš„ãªä¾å˜æ€§ã‚’考慮" -"ã—ã¾ã™ã€‚ãã®ãŸã‚ã€\"dh binary\" 㯠rules ファイルã«å˜åœ¨ã™ã‚‹ build, build-" -"arch, build-indep, install ç‰ã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã‚’実行ã—ã¦ã„ãã¾ã™ã€‚ã¤ã¾ã‚Šã€ä»–ã®ã‚¿ãƒ¼" -"ゲットã«é–¢ã™ã‚‹ä¾å˜é–¢ä¿‚ã‚’ã„ã¡ã„ã¡ç´°ã‹ã明示ã—㟠binary ターゲットを用æ„ã™ã‚‹å¿…" -"è¦ã¯ã‚ã‚Šã¾ã›ã‚“。" +"挿入ã•ã‚Œã‚‹ã‚³ãƒ¼ãƒ‰ã¯ã‚·ã‚§ãƒ«ã‚¹ã‚¯ãƒªãƒ—トãªã®ã§ã€Perl スクリプトã«ã¯ç›´æŽ¥åŸ‹ã‚è¾¼ã‚ãªã„" +"事ã«æ³¨æ„ã—ã¦ãã ã•ã„。もã—何ã‹ã‚’ Perl スクリプトã«åŸ‹ã‚è¾¼ã¿ãŸã„å ´åˆã€ä»¥ä¸‹ã«ä¸€" +"例を挙ã’ã¾ã™ ($1, $2 ç‰ã¯ set コマンドã«ã‚ˆã‚Šè¨å®šã•ã‚Œã‚‹äº‹ã«æ³¨æ„):" + +#. type: verbatim +#: debhelper.pod:616 +#, no-wrap +msgid "" +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"The debhelper script failed with error code: ${exit_code}\");\n" +" } else {\n" +" die(\"The debhelper script was killed by signal: ${signal}\");\n" +" }\n" +" }\n" +"\n" +msgstr "" +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"debhelper スクリプトã¯å¤±æ•—ã—ã¾ã—ãŸã€‚エラーコード: ${exit_code}\");\n" +" } else {\n" +" die(\"debhelper スクリプトã¯ä»¥ä¸‹ã®ã‚·ã‚°ãƒŠãƒ«ã§çµ‚了ã•ã‚Œã¾ã—ãŸ: ${signal}\");\n" +" }\n" +" }\n" +"\n" + +#. type: =head2 +#: debhelper.pod:629 +msgid "Automatic generation of miscellaneous dependencies." +msgstr "様々ãªä¾å˜é–¢ä¿‚ã®è‡ªå‹•ç”Ÿæˆ" #. type: textblock -#: debhelper.pod:646 +#: debhelper.pod:631 msgid "" -"B<dh_strip> compresses debugging symbol files to reduce the installed size " -"of -dbg packages." +"Some debhelper commands may make the generated package need to depend on " +"some other packages. For example, if you use L<dh_installdebconf(1)>, your " +"package will generally need to depend on debconf. Or if you use " +"L<dh_installxfonts(1)>, your package will generally need to depend on a " +"particular version of xutils. Keeping track of these miscellaneous " +"dependencies can be annoying since they are dependent on how debhelper does " +"things, so debhelper offers a way to automate it." msgstr "" -"B<dh_strip> ã¯ãƒ‡ãƒãƒƒã‚°ã‚·ãƒ³ãƒœãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã‚’圧縮ã—ã€-dbg パッケージã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" -"時ã«å¿…è¦ã¨ã™ã‚‹å®¹é‡ã‚’削減ã—ã¾ã™ã€‚" +"debhelper ã¯ä»–ã®ãƒ‘ッケージã«ä¾å˜ã™ã‚‹ã‚ˆã†ãªãƒ‘ッケージを作æˆã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾" +"ã™ã€‚例ãˆã°ã€L<dh_installdebconf(1)> を使ã†ã¨ã€ãƒ“ルドã—ãŸãƒ‘ッケージ㯠debconf " +"パッケージã«ã‚‚ä¾å˜ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚ã‚ã‚‹ã„㯠L<dh_installxfonts(1)> を使ã†" +"ã¨ã€ç‰¹å®šã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® xutils ã«ä¾å˜ã™ã‚‹ã“ã¨ã«ãªã‚Šã¾ã™ã€‚ã“れらã®æ§˜ã€…ãªä¾å˜é–¢" +"係を追ã„ã‹ã‘ã‚‹ã®ã¯ã€debhelper ãŒã©ã®ã‚ˆã†ãªå‡¦ç†ã‚’è¡Œã†ã‹ã«ã‚ˆã‚‹ãŸã‚ã«é¢å€’ãªã“ã¨" +"ã«ãªã‚ŠãŒã¡ã§ã™ã€‚ãã®ãŸã‚ã€debhelper 㯠自動的ã«ä¾å˜é–¢ä¿‚を解決ã™ã‚‹æ©Ÿèƒ½ã‚’æä¾›ã—" +"ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:651 +#: debhelper.pod:639 msgid "" -"B<dh_auto_configure> does not include the source package name in --" -"libexecdir when using autoconf." +"All commands of this type, besides documenting what dependencies may be " +"needed on their man pages, will automatically generate a substvar called " +"B<${misc:Depends}>. If you put that token into your F<debian/control> file, " +"it will be expanded to the dependencies debhelper figures you need." msgstr "" -"B<dh_auto_configure> ã¯ã€autoconf を使ã£ãŸã¨ãã«ã€--libexecdir ã«ã‚½ãƒ¼ã‚¹ãƒ‘ッ" -"ケージåã‚’è¿½åŠ ã—ãªããªã‚Šã¾ã—ãŸã€‚" +"ä»–ã®ãƒ‘ッケージã«ä¾å˜ã™ã‚‹ã‚ˆã†ãªãƒ‘ッケージを生æˆã™ã‚‹ debhelper コマンドã¯ã€ä½•ã«" +"ä¾å˜ã™ã‚‹ã‹ã«ã¤ã„㦠man ページã«è¨˜è¼‰ã—ã¦ã‚ã‚‹ä»–ã«ã€B<${misc:Depends}> ã¨å‘¼ã°ã‚Œ" +"る変数をã€è‡ªå‹•çš„ã«ç”Ÿæˆã—ãŸä¾å˜æƒ…å ±ã¨ç½®ãæ›ãˆã¾ã™ã€‚ã‚‚ã— F<debian/control> ã«ã“" +"ã®å¤‰æ•°ã‚’指定ã™ã‚Œã°ã€debhelper ã¯å¿…è¦ã¨ã™ã‚‹ä¾å˜é–¢ä¿‚を自動的ã«å±•é–‹ã™ã‚‹ã‚ˆã†ã«ãª" +"ã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:656 -msgid "B<dh> does not default to enabling --with=python-support" +#: debhelper.pod:644 +msgid "" +"This is entirely independent of the standard B<${shlibs:Depends}> generated " +"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " +"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " +"guesses don't match reality." msgstr "" -"B<dh> 㯠--with=python-support オプションをã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯ç„¡åŠ¹ã«ã™ã‚‹ã‚ˆã†ã«ãª" -"ã‚Šã¾ã—ãŸã€‚" +"ã“ã®å¤‰æ•°ã¯ã€L<dh_makeshlibs(1)> ã«ã‚ˆã‚Šç”Ÿæˆã•ã‚ŒãŸæ¨™æº–ã® B<${shlibs:Depends}> " +"変数ã¨ã¯ã¾ã£ãŸã関連をæŒã¡ã¾ã›ã‚“。ã¾ãŸã€L<dh_perl(1)> ã«ã‚ˆã‚Šç”Ÿæˆã•ã‚ŒãŸ " +"B<${perl:Depends}> 変数もåŒæ§˜ã§ã™ã€‚debhelper コマンドã®æŽ¨æ¸¬ãŒå®ŸçŠ¶ã«åˆã‚ãªã„å ´" +"åˆã¯ã€ã“れらを使ã‚ãªã„よã†ã«ã™ã‚‹ã“ã¨ã‚‚å¯èƒ½ã§ã™ã€‚" + +#. type: =head2 +#: debhelper.pod:649 +msgid "Package build directories" +msgstr "パッケージビルドディレクトリ" #. type: textblock -#: debhelper.pod:658 +#: debhelper.pod:651 msgid "" -"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " -"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " -"regardless of compat level)" +"By default, all debhelper programs assume that the temporary directory used " +"for assembling the tree of files in a package is debian/I<package>." msgstr "" +"デフォルトã§ã¯ã€ã™ã¹ã¦ã® debhelper プãƒã‚°ãƒ©ãƒ ã¯ãƒ‘ッケージã«å«ã‚るファイル群を" +"ã¾ã¨ã‚る一時ディレクトリã¨ã—㦠debian/I<package> ディレクトリを使用ã—ã¾ã™ã€‚" + +#. type: textblock +#: debhelper.pod:654 +msgid "" +"Sometimes, you might want to use some other temporary directory. This is " +"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/" +"tmp>\", will use B<debian/tmp> as the temporary directory. Note that if you " +"use B<-P>, the debhelper programs can only be acting on a single package at " +"a time. So if you have a package that builds many binary packages, you will " +"need to also use the B<-p> flag to specify which binary package the " +"debhelper program will act on." +msgstr "" +"時折ã€åˆ¥ã®ä¸€æ™‚ディレクトリを利用ã—ãŸããªã‚‹å ´åˆãŒã‚ã‚‹ã§ã—ょã†ã€‚ã“ã®å ´åˆã¯ã€B<-" +"P> フラグを利用ã—ã¦ãã ã•ã„。例ãˆã°ã€\"B<dh_installdocs -Pdebian/tmp>\" ã§" +"㯠B<debian/tmp> を一時ディレクトリã¨ã—ã¦åˆ©ç”¨ã§ãã¾ã™ã€‚ãŸã ã—ã€B<-P> を使ã†" +"ã¨ã€debhelper プãƒã‚°ãƒ©ãƒ ã¯ä¸€åº¦ã« 1 ã¤ã®ãƒ‘ッケージã®å‡¦ç†ã—ã‹ã§ãã¾ã›ã‚“。ãã®" +"為ã€è¤‡æ•°ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージを生æˆã™ã‚‹ã‚ˆã†ãªå ´åˆã€ã©ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージã«å¯¾" +"ã—㦠debhelper ãŒä½œç”¨ã™ã‚‹ã‹ã‚’指定ã™ã‚‹ãŸã‚ã« B<-p> フラグを併用ã™ã‚‹å¿…è¦ãŒã‚ã‚Š" +"ã¾ã™ã€‚" + +#. type: =head2 +#: debhelper.pod:662 +msgid "udebs" +msgstr "udeb パッケージã«ã¤ã„ã¦" #. type: textblock #: debhelper.pod:664 msgid "" -"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " -"variables listed by B<dpkg-buildflags>, unless they are already set." +"Debhelper includes support for udebs. To create a udeb with debhelper, add " +"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " +"Debhelper will try to create udebs that comply with debian-installer policy, " +"by making the generated package files end in F<.udeb>, not installing any " +"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " +"and F<config> scripts, etc." msgstr "" -"ã™ã¹ã¦ã® B<dh_auto_>I<*> debhelper プãƒã‚°ãƒ©ãƒ 㨠B<dh> コマンドã¯ã€B<dpkg-" -"buildflags> ã§æŒ‡å®šã•ã‚Œã‚‹ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã—ã¾ã™ã€‚ã™ã§ã«è©²å½“ã™ã‚‹ç’°å¢ƒå¤‰æ•°ãŒè¨å®šã•" -"ã‚Œã¦ã„ã‚‹å ´åˆã¯è¨å®šã‚’è¡Œã„ã¾ã›ã‚“。" +"debhelper 㯠udeb もサãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚debhelper 㧠udeb パッケージを作æˆã™" +"ã‚‹ã«ã¯ã€\"B<Package-Type: udeb>\" ã‚’ F<debian/control> ã®ãƒ‘ッケージ定義ã«åŠ ãˆ" +"ã¦ãã ã•ã„。debhelper 㯠udeb ファイルを debian-installer ãƒãƒªã‚·ãƒ¼ã«ã‚ã‚ã›ã¦" +"ビルドã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ‘ッケージã®æ‹¡å¼µå㌠F<.udeb> ã¨ãªã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã§ã€ã„ã‹ãª" +"るドã‚ュメントやã€F<preinst>, F<postrm>, F<prerm>, F<config> スクリプトç‰ã‚‚çœ" +"ã„ãŸã‚‚ã®ã§ã™ã€‚" + +#. type: =head1 +#: debhelper.pod:671 +msgid "ENVIRONMENT" +msgstr "環境変数" #. type: textblock -#: debhelper.pod:670 +#: debhelper.pod:673 msgid "" -"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " -"to perl F<Makefile.PL> and F<Build.PL>" +"This section describes some of the environment variables that influences the " +"behaviour of debhelper or which debhelper interacts with." msgstr "" -"B<dh_auto_configure> ã¯ã€B<dpkg-buildflags> ã«ã‚ˆã£ã¦è¨å®šã•ã‚Œã‚‹CFLAGSã€" -"CPPFLAGS, LDFLAGS パラメータを F<Makefile.PL> ã‚„ F<Build.PL> ã¸å¼•ã渡ã—ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:675 +#: debhelper.pod:676 +#, fuzzy +#| msgid "" +#| "The following environment variables can influence the behavior of " +#| "debhelper. It is important to note that these must be actual environment " +#| "variables in order to function properly (not simply F<Makefile> " +#| "variables). To specify them properly in F<debian/rules>, be sure to " +#| "\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." msgid "" -"B<dh_strip> puts separated debug symbols in a location based on their build-" -"id." +"It is important to note that these must be actual environment variables in " +"order to affect the behaviour of debhelper (not simply F<Makefile> " +"variables). To specify them properly in F<debian/rules>, be sure to " +"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." msgstr "" -"B<dh_strip> 㯠build-id ã«åŸºã¥ãå ´æ‰€ã«ã€åˆ†é›¢ã—ãŸãƒ‡ãƒãƒƒã‚°ã‚·ãƒ³ãƒœãƒ«ã‚’é…ç½®ã—ã¾" +"以下ã®ç’°å¢ƒå¤‰æ•°ã¯ debhelper ã®æŒ¯ã‚‹èˆžã„ã«å½±éŸ¿ã‚’与ãˆã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚æ£ã—ã動作" +"ã™ã‚‹ãŸã‚ã«ã¯ã€(å˜ãªã‚‹ F<Makefile> 変数ã§ã¯ãªã) 実際ã®ç’°å¢ƒå¤‰æ•°ã§ã‚ã‚‹å¿…è¦ãŒã‚" +"ã‚‹ã“ã¨ã«æ³¨æ„ã™ã‚‹ã®ãŒé‡è¦ã§ã™ã€‚ã“れらをæ£ã—ã F<debian/rules> ã§æŒ‡å®šã™ã‚‹ã«ã¯ã€" +"å¿…ãš \"B<export>\" ã—ã¦ãã ã•ã„。例ãˆã° \"B<export DH_VERBOSE>\" ãªã©ã¨ã—ã¾" "ã™ã€‚" +#. type: =item +#: debhelper.pod:683 +msgid "B<DH_VERBOSE>" +msgstr "B<DH_VERBOSE>" + #. type: textblock -#: debhelper.pod:680 +#: debhelper.pod:685 msgid "" -"Executable debhelper config files are run and their output used as the " -"configuration." +"Set to a non-empty value to enable verbose mode. Please see the B<-v> / B<--" +"verbose> option for details." msgstr "" -"実行å¯èƒ½æ¨©é™ã‚’付与ã—㟠debhelper 用ã®è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã¯ã€å®Ÿè¡Œã•ã‚Œå‡ºåŠ›ãŒè¨å®šã¨ã—ã¦" -"扱ã‚ã‚Œã¾ã™ã€‚" #. type: =item -#: debhelper.pod:687 -msgid "v10" -msgstr "v10" +#: debhelper.pod:688 +msgid "B<DH_QUIET>" +msgstr "B<DH_QUIET>" #. type: textblock -#: debhelper.pod:689 -msgid "Changes from v9 are:" -msgstr "v9 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +#: debhelper.pod:690 +#, fuzzy +#| msgid "" +#| "Set to B<1> to enable quiet mode. Debhelper will not output commands " +#| "calling the upstream build system nor will dh print which subcommands are " +#| "called and depending on the upstream build system might make that more " +#| "quiet, too. This makes it easier to spot important messages but makes " +#| "the output quite useless as buildd log. Ignored if DH_VERBOSE is also " +#| "set." +msgid "" +"Set to a non-empty value to enable quiet mode. Debhelper will not output " +"commands calling the upstream build system nor will dh print which " +"subcommands are called and depending on the upstream build system might make " +"that more quiet, too. This makes it easier to spot important messages but " +"makes the output quite useless as buildd log." +msgstr "" +"quiet モードを有効ã«ã™ã‚‹ã«ã¯ B<1> を指定ã—ã¦ä¸‹ã•ã„。debhelper㯠upstream ã®ãƒ“" +"ルドシステムã®å‘¼ã³å‡ºã—コマンドやã€dh ãŒã©ã®ã‚µãƒ–コマンドãŒå‘¼ã³å‡ºã•ã‚ŒãŸã®ã‹ã‚‚出" +"力ã—ãªããªã‚Šã€upstream ã®ãƒ“ルドシステムã«ã‚ˆã£ã¦ã¯ã•ã‚‰ã«é™ã‹ã«ãªã‚Šã¾ã™ã€‚ã“ã‚Œã¯" +"é‡è¦ãªãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã«æ³¨ç›®ã™ã‚‹ã®ãŒç°¡å˜ã«ãªã‚Šã¾ã™ãŒã€buildd ã®ãƒã‚°ã¨ã—ã¦ã¯å‡ºåŠ›ã¯æ¥µ" +"ã‚ã¦ä½¿ã„物ã«ãªã‚‰ãªããªã‚Šã¾ã™ã€‚DH_VERBOSE ãŒåŒæ™‚ã«ã‚»ãƒƒãƒˆã•ã‚Œã¦ã„ã‚‹ã¨ç„¡è¦–ã•ã‚Œã¾" +"ã™ã€‚" #. type: textblock -#: debhelper.pod:695 -msgid "" -"B<dh_installinit> will no longer install a file named debian/I<package> as " -"an init script." +#: debhelper.pod:696 +msgid "Ignored if DH_VERBOSE is also set or B<-v> / B<--verbose> is passed." msgstr "" -"B<dh_installinit> ã¯ã€init スクリプトã¨ã—㦠debian/I<package> ã¨ã„ã†åå‰ã§" -"ファイルをインストールã—ãªããªã‚Šã¾ã—ãŸã€‚" + +#. type: =item +#: debhelper.pod:698 +msgid "B<DH_COMPAT>" +msgstr "B<DH_COMPAT>" #. type: textblock #: debhelper.pod:700 +#, fuzzy +#| msgid "" +#| "Temporarily specifies what compatibility level debhelper should run at, " +#| "overriding any value in F<debian/compat>." msgid "" -"B<dh_installdocs> will error out if it detects links created with --link-doc " -"between packages of architecture \"all\" and non-\"all\" as it breaks " -"binNMUs." +"Temporarily specifies what compatibility level debhelper should run at, " +"overriding any value specified via Build-Depends on debhelper-compat or via " +"the F<debian/compat> file." msgstr "" -"B<dh_installdocs> ã¯ã€ã‚¢ãƒ¼ã‚テクãƒãƒ£ \"all\" ã¨ éž \"all\" ã®ãƒ‘ッケージ間㧠" -"--link-doc ã§ä½œã‚‰ã‚ŒãŸãƒªãƒ³ã‚¯ãŒ binNMU を壊ã™ã®ã‚’検知ã—ã¦ã‚¨ãƒ©ãƒ¼ã‚’åã出ã™ã‚ˆã†ã«" -"ãªã‚Šã¾ã™ã€‚" +"ã“ã®ç’°å¢ƒå¤‰æ•°ã¯ã€debhelper ã‚’ã©ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã§å®Ÿè¡Œã™ã‚‹ã‹ã‚’一時的ã«æŒ‡å®šã™ã‚‹ã‚‚" +"ã®ã§ã™ã€‚ã“ã¡ã‚‰ã‚’指定ã™ã‚‹ã¨ F<debian/compat> ã®å€¤ã‚’上書ãã—ã¾ã™ã€‚" + +#. type: =item +#: debhelper.pod:704 +msgid "B<DH_NO_ACT>" +msgstr "B<DH_NO_ACT>" #. type: textblock #: debhelper.pod:706 -msgid "" -"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." -"shlibs file. This is now done by B<dh_makeshlibs> instead." -msgstr "" -"B<dh_installdeb>ã¯ã€ãƒ¡ãƒ³ãƒ†ãƒŠãŒæä¾›ã—㟠debian/I<package>.shlibs ファイルをイ" -"ンストールã—ãªããªã‚Šã¾ã—ãŸã€‚ç¾åœ¨ã“ã‚Œã¯ã€B<dh_makeshlibs> ã«ã‚ˆã£ã¦ä»£ã‚ã‚Šã«è¡Œã‚" -"ã‚Œã¾ã™ã€‚" +msgid "Set to B<1> to enable no-act mode." +msgstr "B<1> ã«è¨å®šã™ã‚‹ã¨ã€ä½•ã‚‚ã—ãªã„ (no-act) モードã«ãªã‚Šã¾ã™ã€‚" + +#. type: =item +#: debhelper.pod:708 +msgid "B<DH_OPTIONS>" +msgstr "B<DH_OPTIONS>" #. type: textblock -#: debhelper.pod:712 +#: debhelper.pod:710 msgid "" -"B<dh_installwm> refuses to create a broken package if no man page can be " -"found (required to register for the x-window-manager alternative)." +"All debhelper tools will parse command line arguments listed in this " +"variable before any command option (as if they had been prepended to the " +"command line arguments). Unfortunately, some third-party provided tools may " +"not support this variable and will ignore these command line arguments." msgstr "" -"B<dh_installwm> ã¯ã€man ページãŒè¦‹ã¤ã‹ã‚‰ãªã„å ´åˆã«å£Šã‚ŒãŸãƒ‘ッケージを作æˆã™ã‚‹" -"ã®ã‚’æ‹’å¦ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—㟠(x-window-manager ã® alternative 登録ã«å¿…è¦)。" #. type: textblock -#: debhelper.pod:717 +#: debhelper.pod:715 msgid "" -"Debhelper will default to B<--parallel> for all buildsystems that support " -"parallel building. This can be disabled by using either B<--no-parallel> or " -"passing B<--max-parallel> with a value of 1." +"When using L<dh(1)>, it can be passed options that will be passed on to each " +"debhelper command, which is generally better than using DH_OPTIONS." msgstr "" -"debhelper ã¯ã€ä¸¦åˆ—ビルドをサãƒãƒ¼ãƒˆã—ã¦ã„ã‚‹å…¨ã¦ã®ãƒ“ルドシステムã§ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆ" -"㧠B<--parallel> を使用ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€B<--no-parallel> を使ã†ã‹ B<--max-" -"parallel> 㸠1 ã®å€¤ã‚’渡ã™ã“ã¨ã§ç„¡åŠ¹ã«ã§ãã¾ã™ã€‚" +"L<dh(1)> を使ãˆã°ã€ç¶šã„ã¦å‘¼ã³å‡ºã•ã‚Œã‚‹ debhelper コマンドã«æŒ‡å®šã—ãŸã‚ªãƒ—ション" +"を渡ã™ã“ã¨ãŒã§ãã¾ã™ã€‚大抵ã®å ´åˆã€ã“ã¡ã‚‰ã®æ–¹ãŒ DH_OPTIONS を使ã†ã‚ˆã‚Šã‚‚良ã„æ–¹" +"法ã§ã™ã€‚" + +#. type: =item +#: debhelper.pod:718 +msgid "B<DH_ALWAYS_EXCLUDE>" +msgstr "B<DH_ALWAYS_EXCLUDE>" #. type: textblock -#: debhelper.pod:723 +#: debhelper.pod:720 msgid "" -"The B<dh> command will not accept any of the deprecated \"manual sequence " -"control\" parameters (B<--before>, B<--after>, etc.). Please use override " -"targets instead." +"If set, this adds the value the variable is set to to the B<-X> options of " +"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " +"B<rm -rf> anything that matches the value in your package build tree." msgstr "" -"B<dh> コマンドã¯ã€ä½¿ã‚ã‚Œãªããªã£ãŸ \"手動シーケンスコントãƒãƒ¼ãƒ«\" パラメー" -"ター(B<--before>, B<--after> ãªã©)ã‚’å—ã‘付ã‘ãªããªã‚Šã¾ã™ã€‚代ã‚ã‚Šã« override " -"ターゲットを使ã£ã¦ãã ã•ã„。" +"ã“ã¡ã‚‰ãŒè¨å®šã•ã‚Œã¦ã„ã‚‹ã¨ã€B<-X> オプションをサãƒãƒ¼ãƒˆã™ã‚‹ã™ã¹ã¦ã®ã‚³ãƒžãƒ³ãƒ‰ã«å¯¾" +"ã—ã€B<-X> オプションã®å€¤ã¨ã—ã¦ç’°å¢ƒå¤‰æ•°ã®å€¤ã‚’指定ã—ã¾ã™ã€‚ã•ã‚‰ã«ã€" +"B<dh_builddeb> コマンドã¯ãƒ“ルドツリーã®å…ƒã§ç’°å¢ƒå¤‰æ•°ã®å€¤ã«åŸºã¥ãパターンã«ãƒžãƒƒ" +"ãƒã™ã‚‹ã‚‚ã®å…¨éƒ¨ã‚’ B<rm -rf> ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:727 +#: debhelper.pod:724 msgid "" -"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " -"any of these since debhelper/12.4." +"This can be useful if you are doing a build from a CVS source tree, in which " +"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " +"sneaking into the package you build. Or, if a package has a source tarball " +"that (unwisely) includes CVS directories, you might want to export " +"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " +"your package is built." msgstr "" +"ã“れ㯠CVS ソースツリーã‹ã‚‰ãƒ‘ッケージビルドをã™ã‚‹å ´åˆã«ä¾¿åˆ©ãªå ´åˆãŒã‚ã‚Šã¾ã™ã€‚" +"例ãˆã°ã€B<DH_ALWAYS_EXCLUDE=CVS> を指定ã™ã‚Œã°ã€CVS ディレクトリãŒãƒ“ルドã®éš›ã«" +"検索ã•ã‚Œã‚‹ã®ã‚’防ãã“ã¨ãŒã§ãã¾ã™ã€‚ã‚ã‚‹ã„ã¯ã€ã‚½ãƒ¼ã‚¹ã® tarball ã«ã™ã§ã« CVS " +"ディレクトリ㌠(æ„šã‹ã«ã‚‚) å«ã¾ã‚Œã¦ã„ã‚‹å ´åˆã€F<debian/rules> 㧠" +"B<DH_ALWAYS_EXCLUDE=CVS> 環境変数を export ã™ã‚Œã°ã€ã©ã“ã§ãƒ‘ッケージをビルドã—" +"よã†ã¨ã‚‚効果を発æ®ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:732 +#: debhelper.pod:731 msgid "" -"The B<dh> command will no longer use log files to track which commands have " -"been run. The B<dh> command I<still> keeps track of whether it already ran " -"the \"build\" sequence and skip it if it did." +"Multiple things to exclude can be separated with colons, as in " +"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" msgstr "" -"B<dh> コマンドã¯ã©ã®ã‚³ãƒžãƒ³ãƒ‰ãŒå®Ÿè¡Œã•ã‚ŒãŸã®ã‹ã‚’追跡ã™ã‚‹ã®ã«ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã‚’使ã‚" -"ãªããªã‚Šã¾ã™ã€‚B<dh> コマンド㯠I<ä¾ç„¶ã¨ã—ã¦> 既㫠\"build\" シーケンスを実行" -"ã—ãŸã‹ã©ã†ã‹ã‚’記録ã—ã€ã‚‚ã—実行ã•ã‚Œã¦ã„ãŸã‚‰ã‚¹ã‚ップã—ã¾ã™ã€‚" +"除外ã—ãŸã„ã‚‚ã®ã‚’複数指定ã—ãŸã„å ´åˆã¯ã€B<DH_ALWAYS_EXCLUDE=CVS:.svn> ã®ã‚ˆã†ã«" +"コãƒãƒ³ã§åŒºåˆ‡ã£ã¦ãã ã•ã„。" + +#. type: =item +#: debhelper.pod:734 +#, fuzzy +#| msgid "B<DH_OPTIONS>" +msgid "B<DH_EXTRA_ADDONS>" +msgstr "B<DH_OPTIONS>" #. type: textblock #: debhelper.pod:736 -msgid "The main effects of this are:" -msgstr "ã“ã‚Œã®ä¸»ãªå½±éŸ¿:" +msgid "" +"If set, this adds the specified dh addons to be run in the appropriate " +"places in the sequence of commands. This is equivalent to specifying the " +"addon to run with the --with flag in the debian/rules file. Any --without " +"calls specifying an addon in this environment variable will not be run." +msgstr "" #. type: textblock -#: debhelper.pod:742 +#: debhelper.pod:741 msgid "" -"With this, it is now easier to debug the I<install> or/and I<binary> " -"sequences because they can now trivially be re-run (without having to do a " -"full \"clean and rebuild\" cycle)" +"This is intended to be used by downstreams or specific local configurations " +"that require a debhelper addon to be run during multiple builds without " +"having to patch a large number of rules file. If at all possible, this " +"should be avoided in favor of a --with flag in the rules file." +msgstr "" + +#. type: =item +#: debhelper.pod:746 +msgid "B<DH_COLORS>, B<DPKG_COLORS>" msgstr "" -"ã“ã‚Œã«ã‚ˆã‚Šã€I<install> åŠã³ I<binary> シーケンスを (\"clean åŠã³ rebuild\" ã®" -"サイクルを全ã¦å®Ÿæ–½ã™ã‚‹å¿…è¦ãŒç„¡ããªã‚Š) 気軽ã«å†å®Ÿè¡Œå¯èƒ½ã«ãªã£ãŸãŸã‚ã€ãƒ‡ãƒãƒƒã‚°" -"ãŒã‚ˆã‚Šç°¡å˜ã«ãªã£ã¦ã„ã¾ã™ã€‚" -# FIXME: 訳ã—ã¦ã‚‚ã‚ã‹ã‚‰ãªã„... #. type: textblock #: debhelper.pod:748 -#, fuzzy msgid "" -"The main caveat is that B<dh_*> now only keeps track of what happened in a " -"single override target. When all the calls to a given B<dh_cmd> command " -"happens in the same override target everything will work as before." +"These variables can be used to control whether debhelper commands should use " +"colors in their textual output. Can be set to \"always\", \"auto\" (the " +"default), or \"never\"." msgstr "" -"主ãªæ³¨æ„点ã¨ã—ã¦ã¯ã€B<dh_*> ã¯å˜ä¸€ã® override ターゲット内ã§ä½•ãŒèµ·ã“ã£ãŸã®ã‹" -"ã ã‘を記録ã™ã‚‹ã‚ˆã†ã«ãªã£ãŸã“ã¨ã§ã™ã€‚指定ã•ã‚ŒãŸ B<dh_cmd> コマンドã¸ã®å…¨ã¦ã®å‘¼" -"ã³å‡ºã—ãŒåŒä¸€ã® override ターゲット内ã§èµ·ããŸå ´åˆã¯ã€ä»¥å‰ã¨åŒæ§˜ã«å…¨ã¦ãŒå‹•ä½œã—" -"ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:753 -msgid "Example of where it can go wrong:" -msgstr "å‹•ã‹ãªããªã‚‹å¯èƒ½æ€§ãŒã‚る例:" - -#. type: verbatim -#: debhelper.pod:755 -#, no-wrap +#: debhelper.pod:752 msgid "" -" override_dh_foo:\n" -" dh_foo -pmy-pkg\n" -"\n" +"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " +"debhelper uses it on the assumption that you want the same color setting for " +"dpkg and debhelper. In the off-hand chance you want different color setting " +"for debhelper, you can use B<DH_COLORS> instead or in addition to " +"B<DPKG_COLORS>." msgstr "" -" override_dh_foo:\n" -" dh_foo -pmy-pkg\n" -"\n" -#. type: verbatim +#. type: =item #: debhelper.pod:758 -#, no-wrap -msgid "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" +msgid "B<NO_COLOR>" msgstr "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" #. type: textblock -#: debhelper.pod:762 +#: debhelper.pod:760 msgid "" -"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" -"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " -"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." +"If no explicit request for color has been given (e.g. B<DH_COLORS> and " +"B<DPKG_COLORS> are both unset), the presence of this environment variable " +"cause the default color setting to be \"never\"." msgstr "" -"ã“ã®å ´åˆã€B<dh_foo --remaining> ã®å‘¼ã³å‡ºã—ã¯ã€B<dh_foo -pmy-pkg> ãŒåˆ†ã‹ã‚Œã¦ã„" -"ã‚‹ override ターゲット内ã«ã‚ã‚‹ãŸã‚ã€I<my-pkg> I<ã‚‚>å«ã¿ã¾ã™ã€‚ã“ã®å•é¡Œã¯ B<--" -"remaining> ã«é™ã‚‰ãš B<-a>, B<-i> ãªã©ã‚‚å«ã¿ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:771 +#: debhelper.pod:764 msgid "" -"The B<dh_installdeb> command now shell-escapes the lines in the " -"F<maintscript> config file. This was the original intent but it did not " -"work properly and packages have begun to rely on the incomplete shell " -"escaping (e.g. quoting file names)." +"The variable is defined according to L<https://no-color.org/>. In this " +"project, the environment variables (such as B<DH_COLORS>) are considered an " +"explicit request for color." msgstr "" -"B<dh_installdeb> コマンド㯠F<maintscript> è¨å®šãƒ•ã‚¡ã‚¤ãƒ«å†…ã®è¡Œã‚’シェルエスケー" -"プã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã¯å…ƒã€…æ„図ã—ã¦ã„ãŸå‹•ä½œã§ã—ãŸãŒæ£ã—ã動作ã—ã¦ãŠã‚‰" -"ãšã€ãƒ‘ッケージãŒä¸å®Œå…¨ãªã‚·ã‚§ãƒ«ã‚¨ã‚¹ã‚±ãƒ¼ãƒ— (例: ファイルåã®ã‚¯ã‚©ãƒ¼ãƒˆ) ã«ä¾å˜ã™" -"るよã†ã«ãªã£ã¦ã„ã¾ã—ãŸã€‚" -#. type: textblock -#: debhelper.pod:778 +#. type: =item +#: debhelper.pod:768 msgid "" -"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " -"For packages needing the previous behaviour, please use B<--no-restart-after-" -"upgrade>." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" msgstr "" -"B<dh_installinit> コマンドã¯æ¨™æº–㧠B<--restart-after-upgrade> を利用ã™ã‚‹ã‚ˆã†" -"ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã®å‹•ä½œãŒå¿…è¦ãªãƒ‘ッケージã«ã¯ B<--no-restart-after-upgrade> " -"を利用ã—ã¦ãã ã•ã„。" #. type: textblock -#: debhelper.pod:784 +#: debhelper.pod:770 msgid "" -"The B<autoreconf> sequence is now enabled by default. Please pass B<--" -"without autoreconf> to B<dh> if this is not desirable for a given package" +"By default (in any non-deprecated compat level), debhelper will " +"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " +"unset. If you need to change the default flags, please use the features " +"from L<dpkg-buildflags(1)> to do this (e.g. " +"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" +"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." +msgstr "" + +#. type: =item +#: debhelper.pod:777 +msgid "B<HOME>, B<XDG_*>" msgstr "" -"B<autoreconf> シーケンスãŒæ¨™æº–ã§æœ‰åŠ¹ã«ãªã‚Šã¾ã—ãŸã€‚指定ã®ãƒ‘ッケージã§ã“ã®å‹•ä½œ" -"を望ã¾ãªã„å ´åˆã¯ã€B<dh> ã« B<--without autoreconf> を指定ã—ã¦ãã ã•ã„。" #. type: textblock -#: debhelper.pod:790 +#: debhelper.pod:779 msgid "" -"The B<systemd> sequence is now enabled by default. Please pass B<--without " -"systemd> to B<dh> if this is not desirable for a given package." +"In compat 13 and later, these environment variables are reset before " +"invoking the upstream build system via the B<dh_auto_*> helpers. The " +"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " +"(B<dh_auto_test> only) will be set to a writable directory. All remaining " +"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " +"cleared." msgstr "" -"B<systemd> シーケンスãŒæ¨™æº–ã§æœ‰åŠ¹ã«ãªã‚Šã¾ã—ãŸã€‚指定ã®ãƒ‘ッケージã§ã“ã®å‹•ä½œã‚’望" -"ã¾ãªã„å ´åˆã¯ã€B<dh> ã« B<--without systemd> を指定ã—ã¦ãã ã•ã„。" #. type: textblock -#: debhelper.pod:796 +#: debhelper.pod:785 +msgid "" +"The B<HOME> directory will be created as an empty directory but it will be " +"reused between calls to B<dh_auto_*>. Any content will persist until " +"explicitly deleted or B<dh_clean>." +msgstr "" + +#. type: =item +#: debhelper.pod:789 #, fuzzy -#| msgid "" -#| "B<dh> no longer creates the package build directory when skipping running " -#| "debhelper commands. This will not affect packages that only build with " -#| "debhelper commands, but it may expose bugs in commands not included in " -#| "debhelper." +#| msgid "B<DH_OPTIONS>" +msgid "B<DEB_BUILD_OPTIONS>" +msgstr "B<DH_OPTIONS>" + +#. type: textblock +#: debhelper.pod:791 msgid "" -"B<Retroactively removed>: B<dh> no longer creates the package build " -"directory when skipping running debhelper commands. This will not affect " -"packages that only build with debhelper commands, but it may expose bugs in " -"commands not included in debhelper." +"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " +"variable." msgstr "" -"B<dh> ã¯ã€å®Ÿè¡Œã—ã¦ã„ã‚‹ debhelper コマンドをスã‚ップã—ãŸå ´åˆã«ã¯ãƒ‘ッケージビル" -"ドディレクトリを作æˆã—ãªããªã‚Šã¾ã—ãŸã€‚ã“れ㯠debhelper コマンドã®ã¿ã‚’使ã£ã¦ãƒ“" -"ルドã•ã‚Œã¦ã„るパッケージã«ã¯å½±éŸ¿ã—ã¾ã›ã‚“ãŒã€debhelper ã«å«ã¾ã‚Œã¦ã„ãªã„コマン" -"ドã®ãƒã‚°ã‚’æš´ãã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。" #. type: textblock -#: debhelper.pod:801 +#: debhelper.pod:794 msgid "" -"This compatibility feature had a bug since its inception in " -"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " -"there has been no reports of issues caused by this bug in those ~5 years, " -"this item have been removed rather than fixed." +"Please note that this variable should I<not> be altered by package " +"maintainers inside F<debian/rules> to change the behaviour of debhelper. " +"Instead, where the package maintainer need these features, they should look " +"disabling the relevant feature directly (e.g. by overriding the concrete " +"tools)." msgstr "" #. type: =item -#: debhelper.pod:808 -msgid "v11" -msgstr "v11" +#: debhelper.pod:799 +#, fuzzy +#| msgid "B<DH_OPTIONS>" +msgid "B<DEB_BUILD_MAINT_OPTIONS>" +msgstr "B<DH_OPTIONS>" #. type: textblock +#: debhelper.pod:801 +msgid "" +"This is a dpkg specific environment variable (see e.g. L<dpkg-" +"buildflags(1)>). The debhelper tool suite silently ignores it." +msgstr "" + +#. type: textblock +#: debhelper.pod:804 +msgid "" +"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " +"which make some people mistakenly assume that debhelper will also react to " +"this variable." +msgstr "" + +#. type: =head2 #: debhelper.pod:810 -#, fuzzy -#| msgid "This mode is deprecated." -msgid "This mode is discouraged." -msgstr "ã“ã®ãƒ¢ãƒ¼ãƒ‰ã¯å»ƒæ¢ã•ã‚Œã¾ã—ãŸã€‚" +msgid "Supported flags in DEB_BUILD_OPTIONS" +msgstr "" #. type: textblock #: debhelper.pod:812 msgid "" -"The compat 11 is discouraged for new packages as it suffers from feature " -"interaction between L<dh_installinit> and L<dh_installsystemd> causing " -"services to not run correctly in some cases. Please consider using " -"compatibility mode 10 or 12 instead. More details about the issue are " -"available in Debian#887904 and L<https://lists.debian.org/debian-" -"release/2019/04/msg01442.html>." +"The debhelper tool suite reacts to the following flags in " +"B<DEB_BUILD_OPTIONS>." +msgstr "" + +#. type: =item +#: debhelper.pod:816 +msgid "B<dherroron=obsolete-compat-levels>" msgstr "" #. type: textblock -#: debhelper.pod:819 -msgid "Changes from v10 are:" -msgstr "v10 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +#: debhelper.pod:818 +msgid "I<This is a debhelper specific value.>" +msgstr "" #. type: textblock -#: debhelper.pod:825 -#, fuzzy -#| msgid "" -#| "B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " -#| "generates maintainer scripts for those files. Use B<dh_systemd_enable> " -#| "and B<dh_systemd_start> instead." +#: debhelper.pod:820 msgid "" -"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " -"generates maintainer scripts for those files. Please use the new " -"B<dh_installsystemd> helper." +"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " +"debhelper tools will promote deprecation warnings for usage of old soon to " +"be removed compat levels into errors." msgstr "" -"B<dh_installinit> 㯠F<service> ファイルや F<tmpfile> ファイルをインストール" -"ã—ãªããªã‚Šã€ã•ã‚‰ã«ã¯ã“れらã®ãƒ•ã‚¡ã‚¤ãƒ«ã«å¯¾ã™ã‚‹ãƒ¡ãƒ³ãƒ†ãƒŠã‚¹ã‚¯ãƒªãƒ—トも生æˆã—ãªããª" -"ã‚Šã¾ã—ãŸã€‚代ã‚ã‚Šã« B<dh_systemd_enable> ã‚„ B<dh_systemd_start> を使ã£ã¦ãã ã•" -"ã„。" #. type: textblock -#: debhelper.pod:831 +#: debhelper.pod:824 msgid "" -"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " -"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " -"sequence for B<dh> has also been removed. If you need to disable the " -"B<dh_installsystemd> helper tool, please use an empty override target." +"This is useful for automated checking for code relying on deprecated compat " +"levels that is scheduled for removal." msgstr "" #. type: textblock -#: debhelper.pod:837 -msgid "" -"Please note that the B<dh_installsystemd> tool has a slightly different " -"behaviour in some cases (e.g. when using the B<--name> parameter)." +#: debhelper.pod:827 +msgid "This option is intended for testing purposes; not production builds." +msgstr "" + +#. type: =item +#: debhelper.pod:829 +msgid "B<nostrip>" msgstr "" #. type: textblock -#: debhelper.pod:843 +#: debhelper.pod:831 debhelper.pod:854 debhelper.pod:868 msgid "" -"B<dh_installdirs> no longer creates debian/I<package> directories unless " -"explicitly requested (or it has to create a subdirectory in it)." +"I<This value will change the content of the debs being built. The .deb " +"packages built when this is set is therefore not bit-for-bit reproducible " +"with a regular build in the general case.>" msgstr "" #. type: textblock -#: debhelper.pod:847 -msgid "The vast majority of all packages will be unaffected by this change." +#: debhelper.pod:835 +msgid "" +"This value will cause the official debhelper tools will skip actions and " +"helpers that either remove, detach or deduplicate debugging symbols in ELF " +"binaries." msgstr "" #. type: textblock -#: debhelper.pod:851 -msgid "" -"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" -"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " -"or B<cmake>) are unaffected by this change." +#: debhelper.pod:839 +msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." +msgstr "" + +#. type: =item +#: debhelper.pod:841 +msgid "B<nocheck>" msgstr "" #. type: textblock -#: debhelper.pod:857 +#: debhelper.pod:843 msgid "" -"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" -"configure>." +"This value will cause the official debhelper build systems to skip runs of " +"upstream test suites." msgstr "" #. type: textblock -#: debhelper.pod:862 +#: debhelper.pod:846 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " -"L<cmake(1)>." +"Package maintainers looking to avoid running the upstream tests should " +"B<not> rely on this. Instead, they can add an empty override target to skip " +"B<dh_auto_test>." msgstr "" #. type: textblock -#: debhelper.pod:867 -msgid "" -"B<dh_installman> will now prefer detecting the language from the path name " -"rather than the extension." +#: debhelper.pod:850 +msgid "This value affects L<dh_auto_test(1)>." +msgstr "" + +#. type: =item +#: debhelper.pod:852 +msgid "B<nodoc>" msgstr "" #. type: textblock -#: debhelper.pod:872 -#, fuzzy -#| msgid "" -#| "B<dh> no longer creates the package build directory when skipping running " -#| "debhelper commands. This will not affect packages that only build with " -#| "debhelper commands, but it may expose bugs in commands not included in " -#| "debhelper." +#: debhelper.pod:858 msgid "" -"B<dh_auto_install> will now only create the destination directory it needs. " -"Previously, it would create the package build directory for all packages. " -"This will not affect packages that only build with debhelper commands, but " -"it may expose bugs in commands not included in debhelper." +"This value will cause several debhelper tools to skip installation of " +"documentation such as manpages or upstream provided documentation. " +"Additionally, the tools will also ignore if declared documentation is " +"\"missing\" on the assumption that the documentation has not been built." msgstr "" -"B<dh> ã¯ã€å®Ÿè¡Œã—ã¦ã„ã‚‹ debhelper コマンドをスã‚ップã—ãŸå ´åˆã«ã¯ãƒ‘ッケージビル" -"ドディレクトリを作æˆã—ãªããªã‚Šã¾ã—ãŸã€‚ã“れ㯠debhelper コマンドã®ã¿ã‚’使ã£ã¦ãƒ“" -"ルドã•ã‚Œã¦ã„るパッケージã«ã¯å½±éŸ¿ã—ã¾ã›ã‚“ãŒã€debhelper ã«å«ã¾ã‚Œã¦ã„ãªã„コマン" -"ドã®ãƒã‚°ã‚’æš´ãã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。" #. type: textblock -#: debhelper.pod:880 +#: debhelper.pod:863 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now error out if their config has a pattern that does not " -"match anything or reference a path that does not exist." +"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " +"working with documentation." +msgstr "" + +#. type: =item +#: debhelper.pod:866 +msgid "B<notrimdch>" msgstr "" #. type: textblock -#: debhelper.pod:884 +#: debhelper.pod:872 msgid "" -"Known exceptions include building with the B<nodoc> profile, where the above " -"tools will silently permit failed matches where the patterns are used to " -"specify documentation." +"This value will cause L<dh_installchangelogs(1)> to act as if it had been " +"passed the B<--no-trim> option, forcing it to forgo removing older entries " +"from changelogs." msgstr "" +#. type: =item +#: debhelper.pod:876 +#, fuzzy +#| msgid "B<--ddebs>, B<--no-ddebs>" +msgid "B<noautodbgsym>, B<noddebs>" +msgstr "B<--ddebs>, B<--no-ddebs>" + #. type: textblock -#: debhelper.pod:890 +#: debhelper.pod:878 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " -"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " -"B<dh_install>." +"I<The official name is noautodbgsym. The noddebs variant is accepted for " +"historical reasons.>" msgstr "" #. type: textblock -#: debhelper.pod:895 +#: debhelper.pod:881 msgid "" -"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " -"incorrectly ignore B<--sourcedir>." +"This value causes debhelper to skip the generation of automatically " +"generated debug symbol packages." msgstr "" #. type: textblock -#: debhelper.pod:900 -msgid "" -"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)." +#: debhelper.pod:884 +msgid "This value affects L<dh_strip(1)>." +msgstr "" + +#. type: =item +#: debhelper.pod:886 +msgid "B<parallel=N>" msgstr "" #. type: textblock -#: debhelper.pod:907 +#: debhelper.pod:888 msgid "" -"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " -"any of the B<dh_auto_*> tools. It was added as a temporary work around to " -"avoid a lot of packages failing to build at the same time." +"This value enables debhelper to use up to B<N> threads or processes (subject " +"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " +"debhelper tools work with parallel tasks and may silently ignore the request." msgstr "" #. type: textblock -#: debhelper.pod:912 +#: debhelper.pod:893 msgid "" -"Note this item will eventually become obsolete as upstream intends to drop " -"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " -"drops support for it, then this variable will be removed retroactively from " -"existing compat levels as well." +"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " +"will attempt to run the underlying upstream build system with that number of " +"threads." msgstr "" -#. type: textblock -#: debhelper.pod:919 -msgid "" -"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " -"non-zero exit from analysing a given file." +#. type: =item +#: debhelper.pod:897 +msgid "B<terse>" msgstr "" #. type: textblock -#: debhelper.pod:924 +#: debhelper.pod:899 msgid "" -"The B<dh_installdocs> and B<dh_installexamples> tools may now install " -"I<most> of the documentation in a different path to comply with the " -"recommendation from Debian policy §12.3 (since version 3.9.7)." +"This value will cause the official debhelper build systems to configure " +"upstream builds to be terse (i.e. reduce verbosity in their output). This " +"is subject to the upstream and the debhelper build system supporting such " +"features." msgstr "" #. type: textblock -#: debhelper.pod:928 +#: debhelper.pod:904 msgid "" -"Note that if a given source package only contains a single binary package in " -"F<debian/control> or none of the packages are I<-doc> packages, then this " -"change is not relevant for that source package and you can skip to the next " -"change." +"This value affects most B<dh_auto_*> tools directly. For commands provided " +"by the debhelper package, it also causes the tools to act like the " +"B<DH_QUIET> environment variable was non-empty." msgstr "" #. type: textblock -#: debhelper.pod:933 -msgid "" -"By default, these tools will now attempt to determine a \"main package for " -"the documentation\" (called a I<doc-main-package> from here on) for every I<-" -"doc> package. If they find such a I<doc-main-package>, they will now " -"install the documentation into the path F<< /usr/share/doc/I<doc-main-" -"package> >> in the given doc package. I.e. the path can change but the " -"documentation is still shipped in the I<-doc> package." +#: debhelper.pod:910 +msgid "Unknown flags are silently ignored." msgstr "" #. type: textblock -#: debhelper.pod:941 +#: debhelper.pod:912 msgid "" -"The B<--doc-main-package> option can be used when the auto-detection is " -"insufficient or to reset the path to its previous value if there is a reason " -"to diverge from Debian policy recommendation." +"Note third-party debhelper-like tools or third-party provided build systems " +"may or may not react to the above flags. This tends to depend on " +"implementation details of the tool." msgstr "" -#. type: textblock -#: debhelper.pod:945 -msgid "" -"Some documentation will not be affected by this change. These exceptions " -"include the copyright file, changelog files, README.Debian, etc. These " -"files will still be installed in the path F<< /usr/share/doc/I<package> >>." +#. type: =head1 +#: debhelper.pod:916 debhelper-compat-upgrade-checklist.pod:753 +#: debhelper-obsolete-compat.pod:178 dh:872 dh_auto_build:53 dh_auto_clean:55 +#: dh_auto_configure:58 dh_auto_install:103 dh_auto_test:64 dh_bugfiles:133 +#: dh_builddeb:176 dh_clean:189 dh_compress:243 dh_dwz:163 dh_fixperms:164 +#: dh_gencontrol:208 dh_icons:75 dh_install:377 dh_installcatalogs:128 +#: dh_installchangelogs:365 dh_installcron:80 dh_installdeb:419 +#: dh_installdebconf:233 dh_installdirs:131 dh_installdocs:437 +#: dh_installemacsen:138 dh_installexamples:182 dh_installifupdown:72 +#: dh_installinfo:123 dh_installinit:413 dh_installinitramfs:91 +#: dh_installlogcheck:81 dh_installlogrotate:53 dh_installman:420 +#: dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 +#: dh_installmodules:109 dh_installpam:71 dh_installppp:68 dh_installudev:102 +#: dh_installwm:130 dh_installxfonts:90 dh_link:166 dh_lintian:60 +#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 +#: dh_perl:188 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 +#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:280 dh_systemd_start:280 +msgid "SEE ALSO" +msgstr "å‚ç…§" + +#. type: =item +#: debhelper.pod:920 +msgid "L<debhelper-compat-upgrade-checklist(7)>" msgstr "" #. type: textblock -#: debhelper.pod:952 +#: debhelper.pod:922 msgid "" -"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " -"to determine which files to process. Instead, they open the file and look " -"for an ELF header to determine if a given file is an shared object or an ELF " -"executable." +"List of supported compat levels and an upgrade checklist for each of them." msgstr "" +#. type: =item +#: debhelper.pod:924 +msgid "F</usr/share/doc/debhelper/examples/>" +msgstr "F</usr/share/doc/debhelper/examples/>" + #. type: textblock -#: debhelper.pod:957 -msgid "This change may cause the tools to process more files than previously." +#: debhelper.pod:926 +msgid "A set of example F<debian/rules> files that use debhelper." msgstr "" +"debhelper を使ã†ã¨ãã® F<debian/rules> ファイルã®ä¾‹ãŒæ ¼ç´ã•ã‚Œã¦ã„ã¾ã™ã€‚" #. type: =item -#: debhelper.pod:961 -#, fuzzy -#| msgid "v1" -msgid "v12" -msgstr "v1" +#: debhelper.pod:928 +msgid "L<http://joeyh.name/code/debhelper/>" +msgstr "L<http://joeyh.name/code/debhelper/>" #. type: textblock -#: debhelper.pod:963 -#, fuzzy -#| msgid "Changes from v10 are:" -msgid "Changes from v11 are:" -msgstr "v10 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +#: debhelper.pod:930 +msgid "Debhelper web site." +msgstr "Debhelper ã® Web サイトã§ã™ã€‚" -#. type: textblock -#: debhelper.pod:969 -msgid "" -"The B<dh_makeshlibs> tool now generates shlibs files with versioned " -"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " -"is now the default." -msgstr "" +#. type: =head1 +#: debhelper.pod:934 dh:878 dh_auto_build:59 dh_auto_clean:61 +#: dh_auto_configure:64 dh_auto_install:109 dh_auto_test:70 dh_bugfiles:141 +#: dh_builddeb:182 dh_clean:195 dh_compress:249 dh_dwz:169 dh_fixperms:170 +#: dh_gencontrol:214 dh_icons:81 dh_install:383 dh_installcatalogs:134 +#: dh_installchangelogs:371 dh_installcron:86 dh_installdeb:425 +#: dh_installdebconf:239 dh_installdirs:137 dh_installdocs:443 +#: dh_installemacsen:145 dh_installexamples:188 dh_installifupdown:78 +#: dh_installinfo:129 dh_installinitramfs:99 dh_installlogcheck:87 +#: dh_installlogrotate:59 dh_installman:426 dh_installmanpages:204 +#: dh_installmenu:96 dh_installmime:69 dh_installmodules:115 dh_installpam:77 +#: dh_installppp:74 dh_installudev:108 dh_installwm:136 dh_installxfonts:96 +#: dh_link:172 dh_lintian:68 dh_listpackages:40 dh_makeshlibs:462 +#: dh_md5sums:124 dh_movefiles:167 dh_perl:194 dh_prep:76 dh_shlibdeps:210 +#: dh_strip:441 dh_testdir:68 dh_testroot:99 dh_usrlocal:142 +msgid "AUTHOR" +msgstr "作者" #. type: textblock -#: debhelper.pod:973 -msgid "" -"If an unversioned dependency in the shlibs file is wanted, this can be " -"obtained by passing B<-VNone> instead. However, please see " -"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." -msgstr "" +#: debhelper.pod:936 dh:880 dh_auto_build:61 dh_auto_clean:63 +#: dh_auto_configure:66 dh_auto_install:111 dh_auto_test:72 dh_builddeb:184 +#: dh_clean:197 dh_compress:251 dh_fixperms:172 dh_gencontrol:216 +#: dh_install:385 dh_installchangelogs:373 dh_installcron:88 dh_installdeb:427 +#: dh_installdebconf:241 dh_installdirs:139 dh_installdocs:445 +#: dh_installemacsen:147 dh_installexamples:190 dh_installifupdown:80 +#: dh_installinfo:131 dh_installinit:421 dh_installlogrotate:61 +#: dh_installman:428 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 +#: dh_installmodules:117 dh_installpam:79 dh_installppp:76 dh_installudev:110 +#: dh_installwm:138 dh_installxfonts:98 dh_link:174 dh_listpackages:42 +#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 +#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 +msgid "Joey Hess <joeyh@debian.org>" +msgstr "Joey Hess <joeyh@debian.org>" #. type: textblock -#: debhelper.pod:979 +#: debhelper-compat-upgrade-checklist.pod:5 #, fuzzy -#| msgid "The B<-s> (B<--same-arch>) option is removed." +#| msgid "" +#| "debhelper-obsolete-compat - List of no longer supported compat levels" msgid "" -"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " -"instead." -msgstr "B<-s>, B<--same-arch> オプションã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚" +"debhelper-compat-upgrade-checklist - Upgrade checklist for supported " +"debhelper compat levels" +msgstr "debhelper-obsolete-compat - サãƒãƒ¼ãƒˆã•ã‚Œãªããªã£ãŸäº’æ›æ€§ãƒ¬ãƒ™ãƒ«ä¸€è¦§" -# TRANS: 実際㮠warning ã«åˆã‚ã›ã¦ deprecate ã¨ã™ã‚‹ #. type: textblock -#: debhelper.pod:983 +#: debhelper-compat-upgrade-checklist.pod:9 msgid "" -"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." +"This document is an upgrade checklist of all the supported debhelper compat " +"levels. It also lists all the support debhelper compat levels." msgstr "" -"B<dh_clean -k> ã®èµ·å‹•ã¯ deprecate è¦å‘Šã§ã¯ãªãエラーを起ã“ã™ã‚ˆã†ã«ãªã‚Šã¾ã—" -"ãŸã€‚" #. type: textblock -#: debhelper.pod:988 +#: debhelper-compat-upgrade-checklist.pod:12 msgid "" -"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " -"removed. Please use the new name B<--no-stop-on-upgrade>" +"Information about how to declare the compat level is in L<debhelper(7)/" +"COMPATIBILITY LEVELS>." msgstr "" #. type: textblock -#: debhelper.pod:993 +#: debhelper-compat-upgrade-checklist.pod:14 +#, fuzzy +#| msgid "" +#| "If you are upgrading from an earlier compatibility level, please review " +#| "L<debhelper-obsolete-compat(7)>." msgid "" -"There was a bug in the B<doit> (and similar) functions from L<Debian::" -"Debhelper::Dh_Lib> that made them spawn a shell in one particular " -"circumstance. This bug is now removed and will cause helpers that rely on " -"the bug to fail with a \"command not found\"-error." +"If you are upgrading from a (now) obsolete compat level, then please refer " +"to L<debhelper-obsolete-compat(7)>." msgstr "" +"ã“れ以å‰ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã‹ã‚‰ã‚¢ãƒƒãƒ—グレードã—よã†ã¨ã—ã¦ã„ã‚‹å ´åˆã€L<debhelper-" +"obsolete-compat(7)> を確èªã—ã¦ä¸‹ã•ã„。" -#. type: textblock -#: debhelper.pod:1000 -msgid "" -"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " -"removed. Please use B<dh_missing> and its corresponding options, which can " -"also see the files installed by other helpers." -msgstr "" +#. type: =head2 +#: debhelper-compat-upgrade-checklist.pod:19 +#, fuzzy +#| msgid "This is the lowest supported compatibility level." +msgid "Upgrade checklist for supported compatibility levels" +msgstr "ã“ã‚Œã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„る最低é™ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã§ã™ã€‚" #. type: textblock -#: debhelper.pod:1006 -msgid "" -"The B<dh_installinit> helper no longer installs configuration for the " -"upstart init system. Instead, it will abort the build if it finds an old " -"upstart configuration file. The error is there to remind the package " -"maintainer to ensure the proper removal of the conffiles shipped in previous " -"versions of the package (if any)." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:21 +msgid "These are the available compatibility levels:" +msgstr "利用å¯èƒ½ãªäº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã¯ä»¥ä¸‹ã®é€šã‚Šã§ã™:" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:25 +#, fuzzy +#| msgid "v5" +msgid "v15" +msgstr "v5" #. type: textblock -#: debhelper.pod:1014 +#: debhelper-compat-upgrade-checklist.pod:27 +#: debhelper-compat-upgrade-checklist.pod:51 strings-kept-translations.pod:9 msgid "" -"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" -"maintscript-helper(1)> commands and will error out if the commands appear to " -"be invalid." +"This compatibility level is still open for development; use with caution." msgstr "" +"ã“ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã¯æœªã 開発ä¸ã®çŠ¶æ…‹ã§ã™ã€‚使ã†å ´åˆã¯æ³¨æ„ã—ã¦ä½¿ã£ã¦ãã ã•ã„。" #. type: textblock -#: debhelper.pod:1020 -msgid "The B<dh_missing> tool will now default to B<--list-missing>." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:29 +#, fuzzy +#| msgid "Changes from v4 are:" +msgid "Changes from v14 are:" +msgstr "v4 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" -#. type: textblock -#: debhelper.pod:1024 -msgid "" -"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" -"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." -msgstr "" +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:33 +#: debhelper-compat-upgrade-checklist.pod:57 +#: debhelper-compat-upgrade-checklist.pod:63 +#: debhelper-compat-upgrade-checklist.pod:68 +#: debhelper-compat-upgrade-checklist.pod:74 +#: debhelper-compat-upgrade-checklist.pod:90 +#: debhelper-compat-upgrade-checklist.pod:95 +#: debhelper-compat-upgrade-checklist.pod:103 +#: debhelper-compat-upgrade-checklist.pod:120 +#: debhelper-compat-upgrade-checklist.pod:128 +#: debhelper-compat-upgrade-checklist.pod:136 +#: debhelper-compat-upgrade-checklist.pod:145 +#: debhelper-compat-upgrade-checklist.pod:151 +#: debhelper-compat-upgrade-checklist.pod:161 +#: debhelper-compat-upgrade-checklist.pod:169 +#: debhelper-compat-upgrade-checklist.pod:175 +#: debhelper-compat-upgrade-checklist.pod:189 +#: debhelper-compat-upgrade-checklist.pod:200 +#: debhelper-compat-upgrade-checklist.pod:214 +#: debhelper-compat-upgrade-checklist.pod:225 +#: debhelper-compat-upgrade-checklist.pod:241 +#: debhelper-compat-upgrade-checklist.pod:251 +#: debhelper-compat-upgrade-checklist.pod:255 +#: debhelper-compat-upgrade-checklist.pod:260 +#: debhelper-compat-upgrade-checklist.pod:265 +#: debhelper-compat-upgrade-checklist.pod:272 +#: debhelper-compat-upgrade-checklist.pod:278 +#: debhelper-compat-upgrade-checklist.pod:286 +#: debhelper-compat-upgrade-checklist.pod:292 +#: debhelper-compat-upgrade-checklist.pod:296 +#: debhelper-compat-upgrade-checklist.pod:301 +#: debhelper-compat-upgrade-checklist.pod:306 +#: debhelper-compat-upgrade-checklist.pod:315 +#: debhelper-compat-upgrade-checklist.pod:331 +#: debhelper-compat-upgrade-checklist.pod:340 +#: debhelper-compat-upgrade-checklist.pod:356 +#: debhelper-compat-upgrade-checklist.pod:364 +#: debhelper-compat-upgrade-checklist.pod:369 +#: debhelper-compat-upgrade-checklist.pod:391 +#: debhelper-compat-upgrade-checklist.pod:397 +#: debhelper-compat-upgrade-checklist.pod:409 +#: debhelper-compat-upgrade-checklist.pod:417 +#: debhelper-compat-upgrade-checklist.pod:423 +#: debhelper-compat-upgrade-checklist.pod:428 +#: debhelper-compat-upgrade-checklist.pod:433 +#: debhelper-compat-upgrade-checklist.pod:438 +#: debhelper-compat-upgrade-checklist.pod:446 +#: debhelper-compat-upgrade-checklist.pod:456 +#: debhelper-compat-upgrade-checklist.pod:466 +#: debhelper-compat-upgrade-checklist.pod:473 +#: debhelper-compat-upgrade-checklist.pod:485 +#: debhelper-compat-upgrade-checklist.pod:490 +#: debhelper-compat-upgrade-checklist.pod:518 +#: debhelper-compat-upgrade-checklist.pod:535 +#: debhelper-compat-upgrade-checklist.pod:540 +#: debhelper-compat-upgrade-checklist.pod:546 +#: debhelper-compat-upgrade-checklist.pod:552 +#: debhelper-compat-upgrade-checklist.pod:557 +#: debhelper-compat-upgrade-checklist.pod:563 +#: debhelper-compat-upgrade-checklist.pod:572 +#: debhelper-compat-upgrade-checklist.pod:582 +#: debhelper-compat-upgrade-checklist.pod:588 +#: debhelper-compat-upgrade-checklist.pod:611 +#: debhelper-compat-upgrade-checklist.pod:618 +#: debhelper-compat-upgrade-checklist.pod:624 +#: debhelper-compat-upgrade-checklist.pod:630 +#: debhelper-compat-upgrade-checklist.pod:636 +#: debhelper-compat-upgrade-checklist.pod:656 +#: debhelper-compat-upgrade-checklist.pod:661 +#: debhelper-compat-upgrade-checklist.pod:668 +#: debhelper-compat-upgrade-checklist.pod:673 +#: debhelper-compat-upgrade-checklist.pod:678 +#: debhelper-compat-upgrade-checklist.pod:686 +#: debhelper-compat-upgrade-checklist.pod:692 +#: debhelper-compat-upgrade-checklist.pod:697 +#: debhelper-compat-upgrade-checklist.pod:702 +#: debhelper-compat-upgrade-checklist.pod:717 +#: debhelper-compat-upgrade-checklist.pod:721 +#: debhelper-compat-upgrade-checklist.pod:729 +#: debhelper-compat-upgrade-checklist.pod:734 debhelper-obsolete-compat.pod:29 +#: debhelper-obsolete-compat.pod:36 debhelper-obsolete-compat.pod:40 +#: debhelper-obsolete-compat.pod:44 debhelper-obsolete-compat.pod:57 +#: debhelper-obsolete-compat.pod:62 debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:74 debhelper-obsolete-compat.pod:89 +#: debhelper-obsolete-compat.pod:93 debhelper-obsolete-compat.pod:98 +#: debhelper-obsolete-compat.pod:102 debhelper-obsolete-compat.pod:114 +#: debhelper-obsolete-compat.pod:119 debhelper-obsolete-compat.pod:124 +#: debhelper-obsolete-compat.pod:129 debhelper-obsolete-compat.pod:143 +#: debhelper-obsolete-compat.pod:148 debhelper-obsolete-compat.pod:152 +#: dh_testroot:36 dh_testroot:41 dh_testroot:46 +msgid "-" +msgstr "-" #. type: textblock -#: debhelper.pod:1029 +#: debhelper-compat-upgrade-checklist.pod:35 msgid "" -"The B<dh_compress> tool no longer compresses examples (i.e. anything " -"installed in F<</usr/share/doc/I<package>/examples>>.)" +"The B<dh_auto_install> tool no longer defaults to B<< --destdir=debian/" +"I<package> >> for source packages only producing a single binary. If this " +"behaviour is wanted, the package should explicitly activate the B<single-" +"binary> dh addon (e.g., by adding B<dh-sequence-single-binary> to B<Build-" +"Depends>) or pass B<--destdir> to B<dh_auto_install>." msgstr "" #. type: textblock -#: debhelper.pod:1034 +#: debhelper-compat-upgrade-checklist.pod:41 +#: debhelper-compat-upgrade-checklist.pod:84 msgid "" -"The standard sequence in B<dh> now includes B<dh_dwz> and " -"B<dh_installinitramfs> by default. This makes the B<dwz> and " -"B<installinitramfs> sequences obsolete and they will now fail with an " -"error. If you want to skip these commands, then please insert an empty " -"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" +"The rationale for this change to avoid \"surprises\" when adding a second " +"binary package later. Previously, debhelper would silently change behaviour " +"often resulting in empty binary packages being uploaded to the archive by " +"mistake. With the new behaviour, the B<single-binary> addon will detect the " +"mismatch and warn the maintainer of what is about to happen." msgstr "" -#. type: textblock -#: debhelper.pod:1043 -msgid "" -"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" -"libexecdir> variable and thus relies on the build system default - which " -"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." -msgstr "" +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:49 +#, fuzzy +#| msgid "v1" +msgid "v14" +msgstr "v1" #. type: textblock -#: debhelper.pod:1048 -msgid "" -"If a particular upstream package does not use the correct default, the " -"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " -"via the following example:" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:53 +#, fuzzy +#| msgid "Changes from v3 are:" +msgid "Changes from v13 are:" +msgstr "v3 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" -#. type: verbatim -#: debhelper.pod:1052 -#, fuzzy, no-wrap -#| msgid "" -#| "\toverride_dh_auto_configure:\n" -#| "\t\tdh_auto_configure -- --with-foo --disable-bar\n" -#| "\n" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:59 msgid "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" +"The B<cmake> buildsystem now passes B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to " +"L<cmake(1)> to avoid some reproducibility issues." msgstr "" -"\toverride_dh_auto_configure:\n" -"\t\tdh_auto_configure -- --with-foo --disable-bar\n" -"\n" #. type: textblock -#: debhelper.pod:1055 -msgid "Note the B<--> before the B<--libexecdir> parameter." +#: debhelper-compat-upgrade-checklist.pod:65 +msgid "" +"The tool B<dh_installsysusers> is now included in the default sequence. This " +"helper tool will process systemd sysusers files." msgstr "" #. type: textblock -#: debhelper.pod:1059 +#: debhelper-compat-upgrade-checklist.pod:70 msgid "" -"The B<dh_installdeb> tool no longer installs the maintainer provided " -"F<conffiles> file. The file has mostly been obsolete since compatibility " -"level 3, where B<dh_installdeb> began to automatically compute the resulting " -"F<conffiles> control file." +"Use of the B<dh_gconf> command in override and hook targets now causes an " +"error. The B<dh_gconf> command has been a no-op for years and was removed " +"in debhelper 13.4." msgstr "" #. type: textblock -#: debhelper.pod:1066 +#: debhelper-compat-upgrade-checklist.pod:76 msgid "" -"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " -"handling systemd services that have a sysvinit alternative. Both tools must " -"now be used in such a case to ensure the service is properly started under " -"both sysvinit and systemd." +"The B<dh> sequencer will warn if the B<single-binary> addon is implicitly " +"activated to warn maintainers of the pending compat 15 change in " +"B<dh_auto_install>." msgstr "" #. type: textblock -#: debhelper.pod:1071 +#: debhelper-compat-upgrade-checklist.pod:79 msgid "" -"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" -"start>) then you will probably need one for B<dh_installsystemd> as well now." +"Maintainers are urged to either explicitly activate the B<single-binary> " +"addon to preserve the existing behaviour (e.g., by adding B<dh-sequence-" +"single-binary> to Build-Depends), or explicitly passing B<--destdir> to " +"B<dh_auto_install> if used and then passing B<--without single-binary> to " +"B<dh> (the latter to silence the warning)." msgstr "" #. type: textblock -#: debhelper.pod:1075 +#: debhelper-compat-upgrade-checklist.pod:92 msgid "" -"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " -"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists B<" -"${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to compat " -"12." +"The B<dh_installalternatives> tool will now be run after B<dh_link> rather " +"than after B<dh_installinitramfs> in the default B<dh> sequence." msgstr "" #. type: textblock -#: debhelper.pod:1082 +#: debhelper-compat-upgrade-checklist.pod:97 msgid "" -"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " -"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " -"packages and not only during the building process. Please set " -"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " -"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." +"The B<dh_installpam> tool will now install PAM configuration files under " +"F<< /usr/lib/pam.d/I<package> >> instead of F<< /etc/pam.d/I<package> >>." msgstr "" #. type: textblock -#: debhelper.pod:1090 +#: debhelper-compat-upgrade-checklist.pod:100 msgid "" -"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " -"default." +"Please consider using the \"rm_conffile\" feature from L<dh_installdeb(1)> " +"to ensure the proper removal of previous PAM files." msgstr "" #. type: textblock -#: debhelper.pod:1095 +#: debhelper-compat-upgrade-checklist.pod:105 msgid "" -"The B<python-distutils> buildsystem is now removed. Please use the third-" -"party build system B<pybuild> instead." +"The B<meson+ninja> and B<cmake> build systems now use B<meson install> and " +"B<cmake --install>, respectively, instead of B<ninja install> and B<make " +"install> in the L<dh_auto_install(1)> call. Any override of " +"B<dh_auto_install> that passes extra parameters to the upstream build system " +"should be reviewed." msgstr "" #. type: =item -#: debhelper.pod:1100 +#: debhelper-compat-upgrade-checklist.pod:112 #, fuzzy #| msgid "v1" msgid "v13" msgstr "v1" #. type: textblock -#: debhelper.pod:1102 +#: debhelper-compat-upgrade-checklist.pod:114 msgid "This is the recommended mode of operation." msgstr "ã“ã‚ŒãŒå‹•ä½œæŽ¨å¥¨ãƒ¢ãƒ¼ãƒ‰ã§ã™ã€‚" #. type: textblock -#: debhelper.pod:1104 +#: debhelper-compat-upgrade-checklist.pod:116 #, fuzzy #| msgid "Changes from v10 are:" msgid "Changes from v12 are:" msgstr "v10 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" #. type: textblock -#: debhelper.pod:1110 +#: debhelper-compat-upgrade-checklist.pod:122 msgid "" "The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " "test> when running the test suite. Any override of B<dh_auto_test> that " @@ -2245,7 +2506,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1118 +#: debhelper-compat-upgrade-checklist.pod:130 msgid "" "All debhelper like tools based on the official debhelper library (including " "B<dh> and the official B<dh_*> tools) no longer accepts abbreviated command " @@ -2254,7 +2515,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1126 +#: debhelper-compat-upgrade-checklist.pod:138 msgid "" "The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, B<dh_makeshlibs>, " "B<dh_shlibdeps>) are now only run for arch dependent packages by default (i." @@ -2264,7 +2525,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1135 +#: debhelper-compat-upgrade-checklist.pod:147 msgid "" "The third-party B<gradle> build system (from B<gradle-debian-helper> " "package) now runs the upstream-provided test suite automatically. To " @@ -2272,7 +2533,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1141 +#: debhelper-compat-upgrade-checklist.pod:153 msgid "" "The B<dh_installman> tool now aborts if it sees conflicting definitions of a " "manpage. This typically happens if the upstream build system is installing " @@ -2283,7 +2544,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1151 +#: debhelper-compat-upgrade-checklist.pod:163 msgid "" "The B<dh_auto_*> helpers now reset the environment variables B<HOME> and " "common B<XDG_*> variable. Please see description of the environment " @@ -2291,12 +2552,12 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1155 +#: debhelper-compat-upgrade-checklist.pod:167 msgid "I<This feature changed between debhelper 13 and debhelper 13.2.>" msgstr "" #. type: textblock -#: debhelper.pod:1159 +#: debhelper-compat-upgrade-checklist.pod:171 msgid "" "The B<dh> command will now error if an override or hook target for an " "obsolete command are present in F<debian/rules> (e.g. " @@ -2304,7 +2565,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1165 +#: debhelper-compat-upgrade-checklist.pod:177 msgid "" "The B<dh_missing> command will now default to B<--fail-missing>. This can " "be reverted to a non-fatal warning by explicitly passing B<--list-missing> " @@ -2312,7 +2573,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1169 +#: debhelper-compat-upgrade-checklist.pod:181 msgid "" "If you do not want the warning either, please omit the call to " "B<dh_missing>. If you use the B<dh> command sequencer, then you can do this " @@ -2321,7 +2582,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:1174 +#: debhelper-compat-upgrade-checklist.pod:186 #, no-wrap msgid "" " # Disable dh_missing\n" @@ -2330,7 +2591,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1179 +#: debhelper-compat-upgrade-checklist.pod:191 msgid "" "The B<dh> command sequencer now runs B<dh_installtmpfiles> in the default " "sequence. The B<dh_installtmpfiles> takes over handling of tmpfiles.d " @@ -2339,14 +2600,14 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1184 +#: debhelper-compat-upgrade-checklist.pod:196 msgid "" "Note that B<dh_installtmpfiles> responds to F<< debian/I<package>.tmpfiles " ">> where B<dh_installsystemd> used a name without the trailing \"s\"." msgstr "" #. type: textblock -#: debhelper.pod:1190 +#: debhelper-compat-upgrade-checklist.pod:202 msgid "" "Many B<dh_*> tools now support limited variable expansion via the B<${foo}> " "syntax. In many cases, this can be used to reference paths that contain " @@ -2357,7 +2618,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1197 +#: debhelper-compat-upgrade-checklist.pod:209 msgid "" "Please see L</Substitutions in debhelper config files> for syntax and " "available substitution variables. To B<dh_*> tool writers, substitution " @@ -2366,7 +2627,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1204 +#: debhelper-compat-upgrade-checklist.pod:216 msgid "" "The B<dh> command sequencer will now skip all hook and override targets for " "B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> lists " @@ -2374,7 +2635,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1208 +#: debhelper-compat-upgrade-checklist.pod:220 msgid "" "Any package relying on these targets to always be run should instead move " "relevant logic out of those targets. E.g. non-test related packaging code " @@ -2383,7 +2644,7 @@ msgid "" msgstr "" #. type: textblock -#: debhelper.pod:1215 +#: debhelper-compat-upgrade-checklist.pod:227 msgid "" "The B<cmake> buildsystem now passes B<-" "DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> to L<cmake(1)> to speed up automatic " @@ -2392,7 +2653,7 @@ msgid "" msgstr "" #. type: verbatim -#: debhelper.pod:1219 +#: debhelper-compat-upgrade-checklist.pod:231 #, no-wrap msgid "" " dh_auto_configure -- -DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ...\n" @@ -2400,969 +2661,939 @@ msgid "" msgstr "" #. type: =item -#: debhelper.pod:1223 +#: debhelper-compat-upgrade-checklist.pod:235 #, fuzzy #| msgid "v1" -msgid "v14" +msgid "v12" msgstr "v1" #. type: textblock -#: debhelper.pod:1225 strings-kept-translations.pod:9 +#: debhelper-compat-upgrade-checklist.pod:237 +#, fuzzy +#| msgid "Changes from v10 are:" +msgid "Changes from v11 are:" +msgstr "v10 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:243 +msgid "" +"The B<dh_makeshlibs> tool now generates shlibs files with versioned " +"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " +"is now the default." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:247 +msgid "" +"If an unversioned dependency in the shlibs file is wanted, this can be " +"obtained by passing B<-VNone> instead. However, please see " +"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." +msgstr "" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:253 +#, fuzzy +#| msgid "The B<-s> (B<--same-arch>) option is removed." +msgid "" +"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " +"instead." +msgstr "B<-s>, B<--same-arch> オプションã¯å‰Šé™¤ã•ã‚Œã¾ã—ãŸã€‚" + +# TRANS: 実際㮠warning ã«åˆã‚ã›ã¦ deprecate ã¨ã™ã‚‹ +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:257 +msgid "" +"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." +msgstr "" +"B<dh_clean -k> ã®èµ·å‹•ã¯ deprecate è¦å‘Šã§ã¯ãªãエラーを起ã“ã™ã‚ˆã†ã«ãªã‚Šã¾ã—" +"ãŸã€‚" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:262 msgid "" -"This compatibility level is still open for development; use with caution." +"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " +"removed. Please use the new name B<--no-stop-on-upgrade>" msgstr "" -"ã“ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã¯æœªã 開発ä¸ã®çŠ¶æ…‹ã§ã™ã€‚使ã†å ´åˆã¯æ³¨æ„ã—ã¦ä½¿ã£ã¦ãã ã•ã„。" #. type: textblock -#: debhelper.pod:1227 -#, fuzzy -#| msgid "Changes from v3 are:" -msgid "Changes from v13 are:" -msgstr "v3 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +#: debhelper-compat-upgrade-checklist.pod:267 +msgid "" +"There was a bug in the B<doit> (and similar) functions from L<Debian::" +"Debhelper::Dh_Lib> that made them spawn a shell in one particular " +"circumstance. This bug is now removed and will cause helpers that rely on " +"the bug to fail with a \"command not found\"-error." +msgstr "" #. type: textblock -#: debhelper.pod:1233 +#: debhelper-compat-upgrade-checklist.pod:274 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> and B<-" -"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some " -"reproducibility issues." +"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " +"removed. Please use B<dh_missing> and its corresponding options, which can " +"also see the files installed by other helpers." msgstr "" #. type: textblock -#: debhelper.pod:1237 +#: debhelper-compat-upgrade-checklist.pod:280 msgid "" -"This can cause issues with running binaries directly from the build " -"directories as they might now require a manually set B<LD_LIBRARY_PATH>. If " -"you need to override this change, we recommend that you try to pass the B<-" -"DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the problem " -"(leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). This should " -"undo the need for B<LD_LIBRARY_PATH> and avoid the reproducibility issues on " -"Linux, where B<$ORIGIN> is supported by the runtime linkers." +"The B<dh_installinit> helper no longer installs configuration for the " +"upstart init system. Instead, it will abort the build if it finds an old " +"upstart configuration file. The error is there to remind the package " +"maintainer to ensure the proper removal of the conffiles shipped in previous " +"versions of the package (if any)." msgstr "" #. type: textblock -#: debhelper.pod:1247 -msgid "The tool B<dh_installsysusers> is now included in the default sequence." +#: debhelper-compat-upgrade-checklist.pod:288 +msgid "" +"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" +"maintscript-helper(1)> commands and will error out if the commands appear to " +"be invalid." msgstr "" -#. type: =head1 -#: debhelper.pod:1253 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 -#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:92 -#: dh_installinit:205 dh_installinitramfs:60 dh_installman:131 -#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 -#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:104 -#: dh_systemd_start:68 -msgid "NOTES" -msgstr "付記" - -#. type: =head2 -#: debhelper.pod:1255 -msgid "Multiple binary package support" -msgstr "複数ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージã®ã‚µãƒãƒ¼ãƒˆ" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:294 +msgid "The B<dh_missing> tool will now default to B<--list-missing>." +msgstr "" #. type: textblock -#: debhelper.pod:1257 +#: debhelper-compat-upgrade-checklist.pod:298 msgid "" -"If your source package generates more than one binary package, debhelper " -"programs will default to acting on all binary packages when run. If your " -"source package happens to generate one architecture dependent package, and " -"another architecture independent package, this is not the correct behavior, " -"because you need to generate the architecture dependent packages in the " -"binary-arch F<debian/rules> target, and the architecture independent " -"packages in the binary-indep F<debian/rules> target." +"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" +"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." msgstr "" -"ソースパッケージãŒè¤‡æ•°ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージを生æˆã™ã‚‹å ´åˆã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯ " -"debhelper ã¯å®Ÿè¡Œæ™‚ã«ã™ã¹ã¦ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージを生æˆã—ã¾ã™ã€‚ã“ã®å ´åˆã‚½ãƒ¼ã‚¹" -"パッケージãŒã€ã‚¢ãƒ¼ã‚テクãƒãƒ£ä¾å˜ãƒ‘ッケージã¨ã‚¢ãƒ¼ã‚テクãƒãƒ£éžä¾å˜ãƒ‘ッケージを" -"åŒæ™‚ã«ç”Ÿæˆã™ã‚‹ã¨ã—ãŸã‚‰ã€ã“ã®æŒ¯ã‚‹èˆžã„ã¯æ£ã—ãã‚ã‚Šã¾ã›ã‚“。ã¨ã„ã†ã®ã‚‚ã€F<debian/" -"rules> ã§ã¯ã€ã‚¢ãƒ¼ã‚テクãƒãƒ£ä¾å˜ãƒ‘ッケージを生æˆã™ã‚‹ãªã‚‰ binary-arch ターゲッ" -"ト内ã§ç”Ÿæˆã™ã‚‹å¿…è¦ãŒã‚ã‚Šã€ã‚¢ãƒ¼ã‚テクãƒãƒ£éžä¾å˜ã®ãƒ‘ッケージãªã‚‰ã°ã€binary-" -"indep ターゲットã§ç”Ÿæˆã™ã‚‹å¿…è¦ãŒã‚る為ã§ã™ã€‚" #. type: textblock -#: debhelper.pod:1265 +#: debhelper-compat-upgrade-checklist.pod:303 msgid "" -"To facilitate this, as well as give you more control over which packages are " -"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" -"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " -"are given, debhelper programs default to acting on all packages listed in " -"the control file, with the exceptions below." +"The B<dh_compress> tool no longer compresses examples (i.e. anything " +"installed in F<</usr/share/doc/I<package>/examples>>.)" msgstr "" -"ã“れを容易ã«ã™ã‚‹ç‚ºã€ã©ã®ãƒ‘ッケージ㌠debhelper プãƒã‚°ãƒ©ãƒ ã«ã‚ˆã£ã¦å‡¦ç†ã•ã‚Œã‚‹ã‹" -"をよりコントãƒãƒ¼ãƒ«ã™ã‚‹ã®ã¨åŒæ§˜ã€ã™ã¹ã¦ã® debhelper プãƒã‚°ãƒ©ãƒ 㯠B<-a>, B<-" -"i>, B<-p>, B<-s> パラメータを解釈ã§ãã¾ã™ã€‚ã“れらã®ãƒ‘ラメータã¯é‡è¤‡å¯èƒ½ã§ã™ã€‚" -"何も指定ã—ãªã„å ´åˆã€debhelper プãƒã‚°ãƒ©ãƒ ã¯ã€ä»¥ä¸‹ã®ä¾‹å¤–を除ã„㦠control ファイ" -"ルã«åˆ—挙ã•ã‚ŒãŸã™ã¹ã¦ã®ãƒ‘ッケージã«å¯¾ã—ã¦å‡¦ç†ã‚’è¡Œã„ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1271 +#: debhelper-compat-upgrade-checklist.pod:308 msgid "" -"First, any package whose B<Architecture> field in B<debian/control> does not " -"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " -"section 5.6.8>)." +"The standard sequence in B<dh> now includes B<dh_dwz> and " +"B<dh_installinitramfs> by default. This makes the B<dwz> and " +"B<installinitramfs> sequences obsolete and they will now fail with an " +"error. If you want to skip these commands, then please insert an empty " +"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" msgstr "" -"ã¾ãšã€B<debian/control> ä¸ã® B<Architecture> フィールド㌠B<DEB_HOST_ARCH> " -"アーã‚テクãƒãƒ£ã«ä¸€è‡´ã—ãªã„å…¨ã¦ã®ãƒ‘ッケージãŒé™¤å¤–ã•ã‚Œã¾ã™ (L<Debian ãƒãƒªã‚·ãƒ¼ " -"5.6.8 ç« >)。" #. type: textblock -#: debhelper.pod:1275 +#: debhelper-compat-upgrade-checklist.pod:317 msgid "" -"Also, some additional packages may be excluded based on the contents of the " -"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " -"binary package stanzas in B<debian/control>, according to the draft policy " -"at L<https://wiki.debian.org/BuildProfileSpec>." +"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" +"libexecdir> variable and thus relies on the build system default - which " +"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." msgstr "" -"ã¾ãŸã€L<https://wiki.debian.org/BuildProfileSpec> ã«ã‚るドラフトã®ãƒãƒªã‚·ãƒ¼ã«" -"よるã¨ã€B<DEB_BUILD_PROFILES> 環境変数㨠B<debian/control> ä¸ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッ" -"ケージ節㮠B<Build-Profiles> フィールドã®å†…容を元ã«è¿½åŠ ã§ãƒ‘ッケージãŒé™¤å¤–ã•ã‚Œ" -"ã¾ã™ã€‚" -#. type: =head3 -#: debhelper.pod:1280 -msgid "Interaction between package selections and Build-Profiles" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:322 +msgid "" +"If a particular upstream package does not use the correct default, the " +"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " +"via the following example:" msgstr "" -#. type: textblock -#: debhelper.pod:1282 +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:326 +#, fuzzy, no-wrap +#| msgid "" +#| "\toverride_dh_auto_configure:\n" +#| "\t\tdh_auto_configure -- --with-foo --disable-bar\n" +#| "\n" msgid "" -"Build-Profiles affect which packages are included in the package selections " -"mechanisms in debhelper. Generally, the package selections are described " -"from the assumption that all packages are enabled. This section describes " -"how the selections react when a package is disabled due to the active Build-" -"Profiles (or lack of active Build-Profiles)." +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" +"\n" msgstr "" +"\toverride_dh_auto_configure:\n" +"\t\tdh_auto_configure -- --with-foo --disable-bar\n" +"\n" -#. type: =item -#: debhelper.pod:1290 -msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:329 +msgid "Note the B<--> before the B<--libexecdir> parameter." msgstr "" #. type: textblock -#: debhelper.pod:1292 -msgid "" -"The package disabled by Build-Profiles is silently excluded from the " -"selection." +#: debhelper-compat-upgrade-checklist.pod:333 +msgid "B<Retroactively removed in debhelper/13.5>:" msgstr "" #. type: textblock -#: debhelper.pod:1295 +#: debhelper-compat-upgrade-checklist.pod:335 msgid "" -"Note you will receive a warning if I<all> packages related to these " -"selections are disabled. In that case, it generally does not make sense to " -"do the build in the first place." +"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+." msgstr "" -#. type: =item -#: debhelper.pod:1299 -#, fuzzy -#| msgid "B<-N>I<package>, B<--no-package=>I<package>" -msgid "-N I<package> / --no-package I<package>" -msgstr "B<-N>I<package>, B<--no-package=>I<package>" - #. type: textblock -#: debhelper.pod:1301 -msgid "The option is accepted and effectively does nothing." +#: debhelper-compat-upgrade-checklist.pod:342 +msgid "" +"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " +"handling systemd services that have a sysvinit alternative. Both tools must " +"now be used in such a case to ensure the service is properly started under " +"both sysvinit and systemd." msgstr "" -#. type: =item -#: debhelper.pod:1303 -#, fuzzy -#| msgid "B<-p>I<package>, B<--package=>I<package>" -msgid "-p I<package> / --package I<package>" -msgstr "B<-p>I<package>, B<--package=>I<package>" - #. type: textblock -#: debhelper.pod:1305 -msgid "The option is accepted, but debhelper will not act on the package." +#: debhelper-compat-upgrade-checklist.pod:347 +msgid "" +"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" +"start>) then you will probably need one for B<dh_installsystemd> as well now." msgstr "" #. type: textblock -#: debhelper.pod:1309 +#: debhelper-compat-upgrade-checklist.pod:351 msgid "" -"Note that it does not matter whether a package is enabled or disabled by " -"default." +"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " +"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists " +"B<${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to " +"compat 12." msgstr "" -# note: it should be "Debian maintainer scripts"? -#. type: =head2 -#: debhelper.pod:1312 -msgid "Automatic generation of Debian install scripts" -msgstr "メンテナスクリプトã®è‡ªå‹•ç”Ÿæˆ" - #. type: textblock -#: debhelper.pod:1314 +#: debhelper-compat-upgrade-checklist.pod:358 msgid "" -"Some debhelper commands will automatically generate parts of Debian " -"maintainer scripts. If you want these automatically generated things " -"included in your existing Debian maintainer scripts, then you need to add " -"B<#DEBHELPER#> to your scripts, in the place the code should be added. " -"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " -"B<dh_installdeb>." +"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " +"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " +"packages and not only during the building process. Please set " +"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " +"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." msgstr "" -"debhelper コマンドã«ã¯ã€Debian メンテナスクリプトã®ä¸€éƒ¨ã‚’自動的ã«ç”Ÿæˆã™ã‚‹ã‚‚ã®" -"ãŒã‚ã‚Šã¾ã™ã€‚ã‚‚ã—ã€æ—¢å˜ã® Debian メンテナスクリプトã«è‡ªå‹•ç”Ÿæˆã•ã‚ŒãŸéƒ¨åˆ†ã‚’å«ã‚€" -"よã†ã«ã—ãŸã‘ã‚Œã°ã€ã‚³ãƒ¼ãƒ‰ã‚’è¿½åŠ ã—ãŸã„å ´æ‰€ã« B<#DEBHELPER#> ã¨è¿½è¨˜ã—ã¦ãã ã•" -"ã„。B<#DEBHELPER#> 㯠B<dh_installdeb> ãŒå®Ÿè¡Œã•ã‚Œã‚‹éš›ã«ã€è‡ªå‹•ç”Ÿæˆã•ã‚ŒãŸã‚³ãƒ¼ãƒ‰" -"ã¸ç½®æ›ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1321 +#: debhelper-compat-upgrade-checklist.pod:366 msgid "" -"If a script does not exist at all and debhelper needs to add something to " -"it, then debhelper will create the complete script." +"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " +"default." msgstr "" -"スクリプトãŒã¾ã£ãŸãå˜åœ¨ã—ãªã„㌠debhelper ãŒä½•ã‹ã‚’スクリプトã«è¿½åŠ ã™ã‚‹å¿…è¦ãŒ" -"ã‚ã‚‹å ´åˆã€debhelper ã¯ã‚¹ã‚¯ãƒªãƒ—トを一å¼ç”Ÿæˆã—ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1324 +#: debhelper-compat-upgrade-checklist.pod:371 msgid "" -"All debhelper commands that automatically generate code in this way let it " -"be disabled by the -n parameter (see above)." +"The B<python-distutils> buildsystem is now removed. Please use the third-" +"party build system B<pybuild> instead." msgstr "" -"-n パラメーターを指定ã™ã‚‹ã¨ã€ã“ã®ã‚ˆã†ãª debhelper プãƒã‚°ãƒ©ãƒ ã«ã‚ˆã‚‹ã‚¹ã‚¯ãƒªãƒ—ト" -"ã®è‡ªå‹•ç”Ÿæˆã‚’è¡Œã‚ãªã„よã†ã«ã§ãã¾ã™ (上記å‚ç…§)。" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:376 +msgid "v11" +msgstr "v11" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:378 +#, fuzzy +#| msgid "This mode is deprecated." +msgid "This mode is discouraged." +msgstr "ã“ã®ãƒ¢ãƒ¼ãƒ‰ã¯å»ƒæ¢ã•ã‚Œã¾ã—ãŸã€‚" #. type: textblock -#: debhelper.pod:1327 +#: debhelper-compat-upgrade-checklist.pod:380 msgid "" -"Note that the inserted code will be shell code, so you cannot directly use " -"it in a Perl script. If you would like to embed it into a Perl script, here " -"is one way to do that (note that I made sure that $1, $2, etc are set with " -"the set command):" +"The compat 11 is discouraged for new packages as it suffers from feature " +"interaction between L<dh_installinit> and L<dh_installsystemd> causing " +"services to not run correctly in some cases. Please consider using " +"compatibility mode 10 or 12 instead. More details about the issue are " +"available in Debian#887904 and L<https://lists.debian.org/debian-" +"release/2019/04/msg01442.html>." msgstr "" -"挿入ã•ã‚Œã‚‹ã‚³ãƒ¼ãƒ‰ã¯ã‚·ã‚§ãƒ«ã‚¹ã‚¯ãƒªãƒ—トãªã®ã§ã€Perl スクリプトã«ã¯ç›´æŽ¥åŸ‹ã‚è¾¼ã‚ãªã„" -"事ã«æ³¨æ„ã—ã¦ãã ã•ã„。もã—何ã‹ã‚’ Perl スクリプトã«åŸ‹ã‚è¾¼ã¿ãŸã„å ´åˆã€ä»¥ä¸‹ã«ä¸€" -"例を挙ã’ã¾ã™ ($1, $2 ç‰ã¯ set コマンドã«ã‚ˆã‚Šè¨å®šã•ã‚Œã‚‹äº‹ã«æ³¨æ„):" -#. type: verbatim -#: debhelper.pod:1332 -#, no-wrap +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:387 +msgid "Changes from v10 are:" +msgstr "v10 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:393 +#, fuzzy +#| msgid "" +#| "B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " +#| "generates maintainer scripts for those files. Use B<dh_systemd_enable> " +#| "and B<dh_systemd_start> instead." msgid "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"The debhelper script failed with error code: ${exit_code}\");\n" -" } else {\n" -" die(\"The debhelper script was killed by signal: ${signal}\");\n" -" }\n" -" }\n" -"\n" +"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " +"generates maintainer scripts for those files. Please use the new " +"B<dh_installsystemd> helper." msgstr "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"debhelper スクリプトã¯å¤±æ•—ã—ã¾ã—ãŸã€‚エラーコード: ${exit_code}\");\n" -" } else {\n" -" die(\"debhelper スクリプトã¯ä»¥ä¸‹ã®ã‚·ã‚°ãƒŠãƒ«ã§çµ‚了ã•ã‚Œã¾ã—ãŸ: ${signal}\");\n" -" }\n" -" }\n" -"\n" - -#. type: =head2 -#: debhelper.pod:1345 -msgid "Automatic generation of miscellaneous dependencies." -msgstr "様々ãªä¾å˜é–¢ä¿‚ã®è‡ªå‹•ç”Ÿæˆ" +"B<dh_installinit> 㯠F<service> ファイルや F<tmpfile> ファイルをインストール" +"ã—ãªããªã‚Šã€ã•ã‚‰ã«ã¯ã“れらã®ãƒ•ã‚¡ã‚¤ãƒ«ã«å¯¾ã™ã‚‹ãƒ¡ãƒ³ãƒ†ãƒŠã‚¹ã‚¯ãƒªãƒ—トも生æˆã—ãªããª" +"ã‚Šã¾ã—ãŸã€‚代ã‚ã‚Šã« B<dh_systemd_enable> ã‚„ B<dh_systemd_start> を使ã£ã¦ãã ã•" +"ã„。" #. type: textblock -#: debhelper.pod:1347 +#: debhelper-compat-upgrade-checklist.pod:399 msgid "" -"Some debhelper commands may make the generated package need to depend on " -"some other packages. For example, if you use L<dh_installdebconf(1)>, your " -"package will generally need to depend on debconf. Or if you use " -"L<dh_installxfonts(1)>, your package will generally need to depend on a " -"particular version of xutils. Keeping track of these miscellaneous " -"dependencies can be annoying since they are dependent on how debhelper does " -"things, so debhelper offers a way to automate it." +"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " +"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " +"sequence for B<dh> has also been removed. If you need to disable the " +"B<dh_installsystemd> helper tool, please use an empty override target." msgstr "" -"debhelper ã¯ä»–ã®ãƒ‘ッケージã«ä¾å˜ã™ã‚‹ã‚ˆã†ãªãƒ‘ッケージを作æˆã™ã‚‹ã“ã¨ãŒã‚ã‚Šã¾" -"ã™ã€‚例ãˆã°ã€L<dh_installdebconf(1)> を使ã†ã¨ã€ãƒ“ルドã—ãŸãƒ‘ッケージ㯠debconf " -"パッケージã«ã‚‚ä¾å˜ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚ã‚ã‚‹ã„㯠L<dh_installxfonts(1)> を使ã†" -"ã¨ã€ç‰¹å®šã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã® xutils ã«ä¾å˜ã™ã‚‹ã“ã¨ã«ãªã‚Šã¾ã™ã€‚ã“れらã®æ§˜ã€…ãªä¾å˜é–¢" -"係を追ã„ã‹ã‘ã‚‹ã®ã¯ã€debhelper ãŒã©ã®ã‚ˆã†ãªå‡¦ç†ã‚’è¡Œã†ã‹ã«ã‚ˆã‚‹ãŸã‚ã«é¢å€’ãªã“ã¨" -"ã«ãªã‚ŠãŒã¡ã§ã™ã€‚ãã®ãŸã‚ã€debhelper 㯠自動的ã«ä¾å˜é–¢ä¿‚を解決ã™ã‚‹æ©Ÿèƒ½ã‚’æä¾›ã—" -"ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1355 +#: debhelper-compat-upgrade-checklist.pod:405 msgid "" -"All commands of this type, besides documenting what dependencies may be " -"needed on their man pages, will automatically generate a substvar called B<" -"${misc:Depends}>. If you put that token into your F<debian/control> file, it " -"will be expanded to the dependencies debhelper figures you need." +"Please note that the B<dh_installsystemd> tool has a slightly different " +"behaviour in some cases (e.g. when using the B<--name> parameter)." msgstr "" -"ä»–ã®ãƒ‘ッケージã«ä¾å˜ã™ã‚‹ã‚ˆã†ãªãƒ‘ッケージを生æˆã™ã‚‹ debhelper コマンドã¯ã€ä½•ã«" -"ä¾å˜ã™ã‚‹ã‹ã«ã¤ã„㦠man ページã«è¨˜è¼‰ã—ã¦ã‚ã‚‹ä»–ã«ã€B<${misc:Depends}> ã¨å‘¼ã°ã‚Œ" -"る変数をã€è‡ªå‹•çš„ã«ç”Ÿæˆã—ãŸä¾å˜æƒ…å ±ã¨ç½®ãæ›ãˆã¾ã™ã€‚ã‚‚ã— F<debian/control> ã«ã“" -"ã®å¤‰æ•°ã‚’指定ã™ã‚Œã°ã€debhelper ã¯å¿…è¦ã¨ã™ã‚‹ä¾å˜é–¢ä¿‚を自動的ã«å±•é–‹ã™ã‚‹ã‚ˆã†ã«ãª" -"ã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1360 +#: debhelper-compat-upgrade-checklist.pod:411 msgid "" -"This is entirely independent of the standard B<${shlibs:Depends}> generated " -"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " -"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " -"guesses don't match reality." +"B<dh_installdirs> no longer creates debian/I<package> directories unless " +"explicitly requested (or it has to create a subdirectory in it)." msgstr "" -"ã“ã®å¤‰æ•°ã¯ã€L<dh_makeshlibs(1)> ã«ã‚ˆã‚Šç”Ÿæˆã•ã‚ŒãŸæ¨™æº–ã® B<${shlibs:Depends}> " -"変数ã¨ã¯ã¾ã£ãŸã関連をæŒã¡ã¾ã›ã‚“。ã¾ãŸã€L<dh_perl(1)> ã«ã‚ˆã‚Šç”Ÿæˆã•ã‚ŒãŸ B<" -"${perl:Depends}> 変数もåŒæ§˜ã§ã™ã€‚debhelper コマンドã®æŽ¨æ¸¬ãŒå®ŸçŠ¶ã«åˆã‚ãªã„å ´åˆ" -"ã¯ã€ã“れらを使ã‚ãªã„よã†ã«ã™ã‚‹ã“ã¨ã‚‚å¯èƒ½ã§ã™ã€‚" -#. type: =head2 -#: debhelper.pod:1365 -msgid "Package build directories" -msgstr "パッケージビルドディレクトリ" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:415 +msgid "The vast majority of all packages will be unaffected by this change." +msgstr "" #. type: textblock -#: debhelper.pod:1367 +#: debhelper-compat-upgrade-checklist.pod:419 msgid "" -"By default, all debhelper programs assume that the temporary directory used " -"for assembling the tree of files in a package is debian/I<package>." +"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" +"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " +"or B<cmake>) are unaffected by this change." msgstr "" -"デフォルトã§ã¯ã€ã™ã¹ã¦ã® debhelper プãƒã‚°ãƒ©ãƒ ã¯ãƒ‘ッケージã«å«ã‚るファイル群を" -"ã¾ã¨ã‚る一時ディレクトリã¨ã—㦠debian/I<package> ディレクトリを使用ã—ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1370 +#: debhelper-compat-upgrade-checklist.pod:425 msgid "" -"Sometimes, you might want to use some other temporary directory. This is " -"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/tmp>" -"\", will use B<debian/tmp> as the temporary directory. Note that if you use " -"B<-P>, the debhelper programs can only be acting on a single package at a " -"time. So if you have a package that builds many binary packages, you will " -"need to also use the B<-p> flag to specify which binary package the " -"debhelper program will act on." +"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" +"configure>." msgstr "" -"時折ã€åˆ¥ã®ä¸€æ™‚ディレクトリを利用ã—ãŸããªã‚‹å ´åˆãŒã‚ã‚‹ã§ã—ょã†ã€‚ã“ã®å ´åˆã¯ã€B<-" -"P> フラグを利用ã—ã¦ãã ã•ã„。例ãˆã°ã€\"B<dh_installdocs -Pdebian/tmp>\" ã§" -"㯠B<debian/tmp> を一時ディレクトリã¨ã—ã¦åˆ©ç”¨ã§ãã¾ã™ã€‚ãŸã ã—ã€B<-P> を使ã†" -"ã¨ã€debhelper プãƒã‚°ãƒ©ãƒ ã¯ä¸€åº¦ã« 1 ã¤ã®ãƒ‘ッケージã®å‡¦ç†ã—ã‹ã§ãã¾ã›ã‚“。ãã®" -"為ã€è¤‡æ•°ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージを生æˆã™ã‚‹ã‚ˆã†ãªå ´åˆã€ã©ã®ãƒã‚¤ãƒŠãƒªãƒ‘ッケージã«å¯¾" -"ã—㦠debhelper ãŒä½œç”¨ã™ã‚‹ã‹ã‚’指定ã™ã‚‹ãŸã‚ã« B<-p> フラグを併用ã™ã‚‹å¿…è¦ãŒã‚ã‚Š" -"ã¾ã™ã€‚" - -#. type: =head2 -#: debhelper.pod:1378 -msgid "udebs" -msgstr "udeb パッケージã«ã¤ã„ã¦" #. type: textblock -#: debhelper.pod:1380 +#: debhelper-compat-upgrade-checklist.pod:430 msgid "" -"Debhelper includes support for udebs. To create a udeb with debhelper, add " -"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " -"Debhelper will try to create udebs that comply with debian-installer policy, " -"by making the generated package files end in F<.udeb>, not installing any " -"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " -"and F<config> scripts, etc." +"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " +"L<cmake(1)>." msgstr "" -"debhelper 㯠udeb もサãƒãƒ¼ãƒˆã—ã¦ã„ã¾ã™ã€‚debhelper 㧠udeb パッケージを作æˆã™" -"ã‚‹ã«ã¯ã€\"B<Package-Type: udeb>\" ã‚’ F<debian/control> ã®ãƒ‘ッケージ定義ã«åŠ ãˆ" -"ã¦ãã ã•ã„。debhelper 㯠udeb ファイルを debian-installer ãƒãƒªã‚·ãƒ¼ã«ã‚ã‚ã›ã¦" -"ビルドã—ã¾ã™ã€‚ã“ã‚Œã¯ã€ãƒ‘ッケージã®æ‹¡å¼µå㌠F<.udeb> ã¨ãªã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã§ã€ã„ã‹ãª" -"るドã‚ュメントやã€F<preinst>, F<postrm>, F<prerm>, F<config> スクリプトç‰ã‚‚çœ" -"ã„ãŸã‚‚ã®ã§ã™ã€‚" - -#. type: =head1 -#: debhelper.pod:1387 -msgid "ENVIRONMENT" -msgstr "環境変数" #. type: textblock -#: debhelper.pod:1389 +#: debhelper-compat-upgrade-checklist.pod:435 msgid "" -"This section describes some of the environment variables that influences the " -"behaviour of debhelper or which debhelper interacts with." +"B<dh_installman> will now prefer detecting the language from the path name " +"rather than the extension." msgstr "" #. type: textblock -#: debhelper.pod:1392 +#: debhelper-compat-upgrade-checklist.pod:440 #, fuzzy #| msgid "" -#| "The following environment variables can influence the behavior of " -#| "debhelper. It is important to note that these must be actual environment " -#| "variables in order to function properly (not simply F<Makefile> " -#| "variables). To specify them properly in F<debian/rules>, be sure to " -#| "\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." +#| "B<dh> no longer creates the package build directory when skipping running " +#| "debhelper commands. This will not affect packages that only build with " +#| "debhelper commands, but it may expose bugs in commands not included in " +#| "debhelper." msgid "" -"It is important to note that these must be actual environment variables in " -"order to affect the behaviour of debhelper (not simply F<Makefile> " -"variables). To specify them properly in F<debian/rules>, be sure to " -"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." +"B<dh_auto_install> will now only create the destination directory it needs. " +"Previously, it would create the package build directory for all packages. " +"This will not affect packages that only build with debhelper commands, but " +"it may expose bugs in commands not included in debhelper." msgstr "" -"以下ã®ç’°å¢ƒå¤‰æ•°ã¯ debhelper ã®æŒ¯ã‚‹èˆžã„ã«å½±éŸ¿ã‚’与ãˆã‚‹ã“ã¨ãŒã§ãã¾ã™ã€‚æ£ã—ã動作" -"ã™ã‚‹ãŸã‚ã«ã¯ã€(å˜ãªã‚‹ F<Makefile> 変数ã§ã¯ãªã) 実際ã®ç’°å¢ƒå¤‰æ•°ã§ã‚ã‚‹å¿…è¦ãŒã‚" -"ã‚‹ã“ã¨ã«æ³¨æ„ã™ã‚‹ã®ãŒé‡è¦ã§ã™ã€‚ã“れらをæ£ã—ã F<debian/rules> ã§æŒ‡å®šã™ã‚‹ã«ã¯ã€" -"å¿…ãš \"B<export>\" ã—ã¦ãã ã•ã„。例ãˆã° \"B<export DH_VERBOSE>\" ãªã©ã¨ã—ã¾" -"ã™ã€‚" - -#. type: =item -#: debhelper.pod:1399 -msgid "B<DH_VERBOSE>" -msgstr "B<DH_VERBOSE>" +"B<dh> ã¯ã€å®Ÿè¡Œã—ã¦ã„ã‚‹ debhelper コマンドをスã‚ップã—ãŸå ´åˆã«ã¯ãƒ‘ッケージビル" +"ドディレクトリを作æˆã—ãªããªã‚Šã¾ã—ãŸã€‚ã“れ㯠debhelper コマンドã®ã¿ã‚’使ã£ã¦ãƒ“" +"ルドã•ã‚Œã¦ã„るパッケージã«ã¯å½±éŸ¿ã—ã¾ã›ã‚“ãŒã€debhelper ã«å«ã¾ã‚Œã¦ã„ãªã„コマン" +"ドã®ãƒã‚°ã‚’æš´ãã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。" #. type: textblock -#: debhelper.pod:1401 +#: debhelper-compat-upgrade-checklist.pod:448 msgid "" -"Set to B<1> to enable verbose mode. Debhelper will output every command it " -"runs. Also enables verbose build logs for some build systems like autoconf." +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now error out if their config has a pattern that does not " +"match anything or reference a path that does not exist." msgstr "" -"B<1> を指定ã™ã‚‹ã¨å†—長出力モードã«ãªã‚Šã¾ã™ã€‚debhelper ã¯å‹•ä½œã™ã‚‹å…¨ã¦ã®ã‚³ãƒžãƒ³ãƒ‰" -"ã«ã¤ã„ã¦å‡ºåŠ›ã‚’è¡Œã†ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚ã¾ãŸã€autoconf ã®ã‚ˆã†ãªãƒ“ルドシステムã«ã¤ã„" -"ã¦ã‚‚冗長出力ã•ã‚ŒãŸãƒ“ルドãƒã‚°ã‚’有効ã«ã—ã¾ã™ã€‚" - -#. type: =item -#: debhelper.pod:1404 -msgid "B<DH_QUIET>" -msgstr "B<DH_QUIET>" #. type: textblock -#: debhelper.pod:1406 +#: debhelper-compat-upgrade-checklist.pod:452 msgid "" -"Set to B<1> to enable quiet mode. Debhelper will not output commands calling " -"the upstream build system nor will dh print which subcommands are called and " -"depending on the upstream build system might make that more quiet, too. " -"This makes it easier to spot important messages but makes the output quite " -"useless as buildd log. Ignored if DH_VERBOSE is also set." +"Known exceptions include building with the B<nodoc> profile, where the above " +"tools will silently permit failed matches where the patterns are used to " +"specify documentation." msgstr "" -"quiet モードを有効ã«ã™ã‚‹ã«ã¯ B<1> を指定ã—ã¦ä¸‹ã•ã„。debhelper㯠upstream ã®ãƒ“" -"ルドシステムã®å‘¼ã³å‡ºã—コマンドやã€dh ãŒã©ã®ã‚µãƒ–コマンドãŒå‘¼ã³å‡ºã•ã‚ŒãŸã®ã‹ã‚‚出" -"力ã—ãªããªã‚Šã€upstream ã®ãƒ“ルドシステムã«ã‚ˆã£ã¦ã¯ã•ã‚‰ã«é™ã‹ã«ãªã‚Šã¾ã™ã€‚ã“ã‚Œã¯" -"é‡è¦ãªãƒ¡ãƒƒã‚»ãƒ¼ã‚¸ã«æ³¨ç›®ã™ã‚‹ã®ãŒç°¡å˜ã«ãªã‚Šã¾ã™ãŒã€buildd ã®ãƒã‚°ã¨ã—ã¦ã¯å‡ºåŠ›ã¯æ¥µ" -"ã‚ã¦ä½¿ã„物ã«ãªã‚‰ãªããªã‚Šã¾ã™ã€‚DH_VERBOSE ãŒåŒæ™‚ã«ã‚»ãƒƒãƒˆã•ã‚Œã¦ã„ã‚‹ã¨ç„¡è¦–ã•ã‚Œã¾" -"ã™ã€‚" - -#. type: =item -#: debhelper.pod:1413 -msgid "B<DH_COMPAT>" -msgstr "B<DH_COMPAT>" #. type: textblock -#: debhelper.pod:1415 -#, fuzzy -#| msgid "" -#| "Temporarily specifies what compatibility level debhelper should run at, " -#| "overriding any value in F<debian/compat>." +#: debhelper-compat-upgrade-checklist.pod:458 msgid "" -"Temporarily specifies what compatibility level debhelper should run at, " -"overriding any value specified via Build-Depends on debhelper-compat or via " -"the F<debian/compat> file." +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " +"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " +"B<dh_install>." msgstr "" -"ã“ã®ç’°å¢ƒå¤‰æ•°ã¯ã€debhelper ã‚’ã©ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã§å®Ÿè¡Œã™ã‚‹ã‹ã‚’一時的ã«æŒ‡å®šã™ã‚‹ã‚‚" -"ã®ã§ã™ã€‚ã“ã¡ã‚‰ã‚’指定ã™ã‚‹ã¨ F<debian/compat> ã®å€¤ã‚’上書ãã—ã¾ã™ã€‚" - -#. type: =item -#: debhelper.pod:1419 -msgid "B<DH_NO_ACT>" -msgstr "B<DH_NO_ACT>" #. type: textblock -#: debhelper.pod:1421 -msgid "Set to B<1> to enable no-act mode." -msgstr "B<1> ã«è¨å®šã™ã‚‹ã¨ã€ä½•ã‚‚ã—ãªã„ (no-act) モードã«ãªã‚Šã¾ã™ã€‚" - -#. type: =item -#: debhelper.pod:1423 -msgid "B<DH_OPTIONS>" -msgstr "B<DH_OPTIONS>" +#: debhelper-compat-upgrade-checklist.pod:463 +msgid "" +"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " +"incorrectly ignore B<--sourcedir>." +msgstr "" #. type: textblock -#: debhelper.pod:1425 +#: debhelper-compat-upgrade-checklist.pod:468 msgid "" -"All debhelper tools will parse command line arguments listed in this " -"variable before any command option (as if they had been prepended to the " -"command line arguments). Unfortunately, some third-party provided tools may " -"not support this variable and will ignore these command line arguments." +"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)." msgstr "" #. type: textblock -#: debhelper.pod:1430 +#: debhelper-compat-upgrade-checklist.pod:475 msgid "" -"When using L<dh(1)>, it can be passed options that will be passed on to each " -"debhelper command, which is generally better than using DH_OPTIONS." +"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " +"any of the B<dh_auto_*> tools. It was added as a temporary work around to " +"avoid a lot of packages failing to build at the same time." msgstr "" -"L<dh(1)> を使ãˆã°ã€ç¶šã„ã¦å‘¼ã³å‡ºã•ã‚Œã‚‹ debhelper コマンドã«æŒ‡å®šã—ãŸã‚ªãƒ—ション" -"を渡ã™ã“ã¨ãŒã§ãã¾ã™ã€‚大抵ã®å ´åˆã€ã“ã¡ã‚‰ã®æ–¹ãŒ DH_OPTIONS を使ã†ã‚ˆã‚Šã‚‚良ã„æ–¹" -"法ã§ã™ã€‚" - -#. type: =item -#: debhelper.pod:1433 -msgid "B<DH_ALWAYS_EXCLUDE>" -msgstr "B<DH_ALWAYS_EXCLUDE>" #. type: textblock -#: debhelper.pod:1435 +#: debhelper-compat-upgrade-checklist.pod:480 msgid "" -"If set, this adds the value the variable is set to to the B<-X> options of " -"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " -"B<rm -rf> anything that matches the value in your package build tree." +"Note this item will eventually become obsolete as upstream intends to drop " +"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " +"drops support for it, then this variable will be removed retroactively from " +"existing compat levels as well." msgstr "" -"ã“ã¡ã‚‰ãŒè¨å®šã•ã‚Œã¦ã„ã‚‹ã¨ã€B<-X> オプションをサãƒãƒ¼ãƒˆã™ã‚‹ã™ã¹ã¦ã®ã‚³ãƒžãƒ³ãƒ‰ã«å¯¾" -"ã—ã€B<-X> オプションã®å€¤ã¨ã—ã¦ç’°å¢ƒå¤‰æ•°ã®å€¤ã‚’指定ã—ã¾ã™ã€‚ã•ã‚‰ã«ã€" -"B<dh_builddeb> コマンドã¯ãƒ“ルドツリーã®å…ƒã§ç’°å¢ƒå¤‰æ•°ã®å€¤ã«åŸºã¥ãパターンã«ãƒžãƒƒ" -"ãƒã™ã‚‹ã‚‚ã®å…¨éƒ¨ã‚’ B<rm -rf> ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1439 +#: debhelper-compat-upgrade-checklist.pod:487 msgid "" -"This can be useful if you are doing a build from a CVS source tree, in which " -"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " -"sneaking into the package you build. Or, if a package has a source tarball " -"that (unwisely) includes CVS directories, you might want to export " -"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " -"your package is built." +"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " +"non-zero exit from analysing a given file." msgstr "" -"ã“れ㯠CVS ソースツリーã‹ã‚‰ãƒ‘ッケージビルドをã™ã‚‹å ´åˆã«ä¾¿åˆ©ãªå ´åˆãŒã‚ã‚Šã¾ã™ã€‚" -"例ãˆã°ã€B<DH_ALWAYS_EXCLUDE=CVS> を指定ã™ã‚Œã°ã€CVS ディレクトリãŒãƒ“ルドã®éš›ã«" -"検索ã•ã‚Œã‚‹ã®ã‚’防ãã“ã¨ãŒã§ãã¾ã™ã€‚ã‚ã‚‹ã„ã¯ã€ã‚½ãƒ¼ã‚¹ã® tarball ã«ã™ã§ã« CVS " -"ディレクトリ㌠(æ„šã‹ã«ã‚‚) å«ã¾ã‚Œã¦ã„ã‚‹å ´åˆã€F<debian/rules> 㧠" -"B<DH_ALWAYS_EXCLUDE=CVS> 環境変数を export ã™ã‚Œã°ã€ã©ã“ã§ãƒ‘ッケージをビルドã—" -"よã†ã¨ã‚‚効果を発æ®ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1446 +#: debhelper-compat-upgrade-checklist.pod:492 msgid "" -"Multiple things to exclude can be separated with colons, as in " -"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" +"The B<dh_installdocs> and B<dh_installexamples> tools may now install " +"I<most> of the documentation in a different path to comply with the " +"recommendation from Debian policy §12.3 (since version 3.9.7)." msgstr "" -"除外ã—ãŸã„ã‚‚ã®ã‚’複数指定ã—ãŸã„å ´åˆã¯ã€B<DH_ALWAYS_EXCLUDE=CVS:.svn> ã®ã‚ˆã†ã«" -"コãƒãƒ³ã§åŒºåˆ‡ã£ã¦ãã ã•ã„。" -#. type: =item -#: debhelper.pod:1449 -#, fuzzy -#| msgid "B<DH_OPTIONS>" -msgid "B<DH_EXTRA_ADDONS>" -msgstr "B<DH_OPTIONS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:496 +msgid "" +"Note that if a given source package only contains a single binary package in " +"F<debian/control> or none of the packages are I<-doc> packages, then this " +"change is not relevant for that source package and you can skip to the next " +"change." +msgstr "" #. type: textblock -#: debhelper.pod:1451 +#: debhelper-compat-upgrade-checklist.pod:501 msgid "" -"If set, this adds the specified dh addons to be run in the appropriate " -"places in the sequence of commands. This is equivalent to specifying the " -"addon to run with the --with flag in the debian/rules file. Any --without " -"calls specifying an addon in this environment variable will not be run." +"By default, these tools will now attempt to determine a \"main package for " +"the documentation\" (called a I<doc-main-package> from here on) for every I<-" +"doc> package. If they find such a I<doc-main-package>, they will now " +"install the documentation into the path F<< /usr/share/doc/I<doc-main-" +"package> >> in the given doc package. I.e. the path can change but the " +"documentation is still shipped in the I<-doc> package." msgstr "" #. type: textblock -#: debhelper.pod:1456 +#: debhelper-compat-upgrade-checklist.pod:509 msgid "" -"This is intended to be used by downstreams or specific local configurations " -"that require a debhelper addon to be run during multiple builds without " -"having to patch a large number of rules file. If at all possible, this " -"should be avoided in favor of a --with flag in the rules file." +"The B<--doc-main-package> option can be used when the auto-detection is " +"insufficient or to reset the path to its previous value if there is a reason " +"to diverge from Debian policy recommendation." msgstr "" -#. type: =item -#: debhelper.pod:1461 -msgid "B<DH_COLORS>, B<DPKG_COLORS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:513 +msgid "" +"Some documentation will not be affected by this change. These exceptions " +"include the copyright file, changelog files, README.Debian, etc. These " +"files will still be installed in the path F<< /usr/share/doc/I<package> >>." msgstr "" #. type: textblock -#: debhelper.pod:1463 +#: debhelper-compat-upgrade-checklist.pod:520 msgid "" -"These variables can be used to control whether debhelper commands should use " -"colors in their textual output. Can be set to \"always\", \"auto\" (the " -"default), or \"never\"." +"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " +"to determine which files to process. Instead, they open the file and look " +"for an ELF header to determine if a given file is an shared object or an ELF " +"executable." msgstr "" #. type: textblock -#: debhelper.pod:1467 -msgid "" -"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " -"debhelper uses it on the assumption that you want the same color setting for " -"dpkg and debhelper. In the off-hand chance you want different color setting " -"for debhelper, you can use B<DH_COLORS> instead or in addition to " -"B<DPKG_COLORS>." +#: debhelper-compat-upgrade-checklist.pod:525 +msgid "This change may cause the tools to process more files than previously." msgstr "" #. type: =item -#: debhelper.pod:1473 -msgid "B<NO_COLOR>" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:529 +msgid "v10" +msgstr "v10" #. type: textblock -#: debhelper.pod:1475 -msgid "" -"If no explicit request for color has been given (e.g. B<DH_COLORS> and " -"B<DPKG_COLORS> are both unset), the presence of this environment variable " -"cause the default color setting to be \"never\"." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:531 +msgid "Changes from v9 are:" +msgstr "v9 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" #. type: textblock -#: debhelper.pod:1479 +#: debhelper-compat-upgrade-checklist.pod:537 msgid "" -"The variable is defined according to L<https://no-color.org/>. In this " -"project, the environment variables (such as B<DH_COLORS>) are considered an " -"explicit request for color." +"B<dh_installinit> will no longer install a file named debian/I<package> as " +"an init script." msgstr "" +"B<dh_installinit> ã¯ã€init スクリプトã¨ã—㦠debian/I<package> ã¨ã„ã†åå‰ã§" +"ファイルをインストールã—ãªããªã‚Šã¾ã—ãŸã€‚" -#. type: =item -#: debhelper.pod:1483 +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:542 msgid "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +"B<dh_installdocs> will error out if it detects links created with --link-doc " +"between packages of architecture \"all\" and non-\"all\" as it breaks " +"binNMUs." msgstr "" +"B<dh_installdocs> ã¯ã€ã‚¢ãƒ¼ã‚テクãƒãƒ£ \"all\" ã¨ éž \"all\" ã®ãƒ‘ッケージ間㧠" +"--link-doc ã§ä½œã‚‰ã‚ŒãŸãƒªãƒ³ã‚¯ãŒ binNMU を壊ã™ã®ã‚’検知ã—ã¦ã‚¨ãƒ©ãƒ¼ã‚’åã出ã™ã‚ˆã†ã«" +"ãªã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1485 +#: debhelper-compat-upgrade-checklist.pod:548 msgid "" -"By default (in any non-deprecated compat level), debhelper will " -"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " -"unset. If you need to change the default flags, please use the features " -"from L<dpkg-buildflags(1)> to do this (e.g. " -"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" -"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." +"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." +"shlibs file. This is now done by B<dh_makeshlibs> instead." msgstr "" +"B<dh_installdeb>ã¯ã€ãƒ¡ãƒ³ãƒ†ãƒŠãŒæä¾›ã—㟠debian/I<package>.shlibs ファイルをイ" +"ンストールã—ãªããªã‚Šã¾ã—ãŸã€‚ç¾åœ¨ã“ã‚Œã¯ã€B<dh_makeshlibs> ã«ã‚ˆã£ã¦ä»£ã‚ã‚Šã«è¡Œã‚" +"ã‚Œã¾ã™ã€‚" -#. type: =item -#: debhelper.pod:1492 -msgid "B<HOME>, B<XDG_*>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:554 +msgid "" +"B<dh_installwm> refuses to create a broken package if no man page can be " +"found (required to register for the x-window-manager alternative)." msgstr "" +"B<dh_installwm> ã¯ã€man ページãŒè¦‹ã¤ã‹ã‚‰ãªã„å ´åˆã«å£Šã‚ŒãŸãƒ‘ッケージを作æˆã™ã‚‹" +"ã®ã‚’æ‹’å¦ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—㟠(x-window-manager ã® alternative 登録ã«å¿…è¦)。" #. type: textblock -#: debhelper.pod:1494 +#: debhelper-compat-upgrade-checklist.pod:559 msgid "" -"In compat 13 and later, these environment variables are reset before " -"invoking the upstream build system via the B<dh_auto_*> helpers. The " -"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " -"(B<dh_auto_test> only) will be set to a writable directory. All remaining " -"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " -"cleared." +"Debhelper will default to B<--parallel> for all buildsystems that support " +"parallel building. This can be disabled by using either B<--no-parallel> or " +"passing B<--max-parallel> with a value of 1." msgstr "" +"debhelper ã¯ã€ä¸¦åˆ—ビルドをサãƒãƒ¼ãƒˆã—ã¦ã„ã‚‹å…¨ã¦ã®ãƒ“ルドシステムã§ã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆ" +"㧠B<--parallel> を使用ã—ã¾ã™ã€‚ã“ã‚Œã¯ã€B<--no-parallel> を使ã†ã‹ B<--max-" +"parallel> 㸠1 ã®å€¤ã‚’渡ã™ã“ã¨ã§ç„¡åŠ¹ã«ã§ãã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1500 +#: debhelper-compat-upgrade-checklist.pod:565 msgid "" -"The B<HOME> directory will be created as an empty directory but it will be " -"reused between calls to B<dh_auto_*>. Any content will persist until " -"explicitly deleted or B<dh_clean>." +"The B<dh> command will not accept any of the deprecated \"manual sequence " +"control\" parameters (B<--before>, B<--after>, etc.). Please use override " +"targets instead." msgstr "" - -#. type: =item -#: debhelper.pod:1504 -#, fuzzy -#| msgid "B<DH_OPTIONS>" -msgid "B<DEB_BUILD_OPTIONS>" -msgstr "B<DH_OPTIONS>" +"B<dh> コマンドã¯ã€ä½¿ã‚ã‚Œãªããªã£ãŸ \"手動シーケンスコントãƒãƒ¼ãƒ«\" パラメー" +"ター(B<--before>, B<--after> ãªã©)ã‚’å—ã‘付ã‘ãªããªã‚Šã¾ã™ã€‚代ã‚ã‚Šã« override " +"ターゲットを使ã£ã¦ãã ã•ã„。" #. type: textblock -#: debhelper.pod:1506 +#: debhelper-compat-upgrade-checklist.pod:569 msgid "" -"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " -"variable." +"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " +"any of these since debhelper/12.4." msgstr "" #. type: textblock -#: debhelper.pod:1509 +#: debhelper-compat-upgrade-checklist.pod:574 msgid "" -"Please note that this variable should I<not> be altered by package " -"maintainers inside F<debian/rules> to change the behaviour of debhelper. " -"Instead, where the package maintainer need these features, they should look " -"disabling the relevant feature directly (e.g. by overriding the concrete " -"tools)." +"The B<dh> command will no longer use log files to track which commands have " +"been run. The B<dh> command I<still> keeps track of whether it already ran " +"the \"build\" sequence and skip it if it did." msgstr "" +"B<dh> コマンドã¯ã©ã®ã‚³ãƒžãƒ³ãƒ‰ãŒå®Ÿè¡Œã•ã‚ŒãŸã®ã‹ã‚’追跡ã™ã‚‹ã®ã«ãƒã‚°ãƒ•ã‚¡ã‚¤ãƒ«ã‚’使ã‚" +"ãªããªã‚Šã¾ã™ã€‚B<dh> コマンド㯠I<ä¾ç„¶ã¨ã—ã¦> 既㫠\"build\" シーケンスを実行" +"ã—ãŸã‹ã©ã†ã‹ã‚’記録ã—ã€ã‚‚ã—実行ã•ã‚Œã¦ã„ãŸã‚‰ã‚¹ã‚ップã—ã¾ã™ã€‚" -#. type: =item -#: debhelper.pod:1514 -#, fuzzy -#| msgid "B<DH_OPTIONS>" -msgid "B<DEB_MAINT_BUILD_OPTIONS>" -msgstr "B<DH_OPTIONS>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:578 +msgid "The main effects of this are:" +msgstr "ã“ã‚Œã®ä¸»ãªå½±éŸ¿:" #. type: textblock -#: debhelper.pod:1516 +#: debhelper-compat-upgrade-checklist.pod:584 msgid "" -"This is a dpkg specific environment variable (see e.g. L<dpkg-" -"buildflags(1)>). The debhelper tool suite silently ignores it." +"With this, it is now easier to debug the I<install> or/and I<binary> " +"sequences because they can now trivially be re-run (without having to do a " +"full \"clean and rebuild\" cycle)" msgstr "" +"ã“ã‚Œã«ã‚ˆã‚Šã€I<install> åŠã³ I<binary> シーケンスを (\"clean åŠã³ rebuild\" ã®" +"サイクルを全ã¦å®Ÿæ–½ã™ã‚‹å¿…è¦ãŒç„¡ããªã‚Š) 気軽ã«å†å®Ÿè¡Œå¯èƒ½ã«ãªã£ãŸãŸã‚ã€ãƒ‡ãƒãƒƒã‚°" +"ãŒã‚ˆã‚Šç°¡å˜ã«ãªã£ã¦ã„ã¾ã™ã€‚" +# FIXME: 訳ã—ã¦ã‚‚ã‚ã‹ã‚‰ãªã„... #. type: textblock -#: debhelper.pod:1519 +#: debhelper-compat-upgrade-checklist.pod:590 +#, fuzzy msgid "" -"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " -"which make some people mistakenly assume that debhelper will also react to " -"this variable." -msgstr "" - -#. type: =head2 -#: debhelper.pod:1525 -msgid "Supported flags in DEB_BUILD_OPTIONS" +"The main caveat is that B<dh_*> now only keeps track of what happened in a " +"single override target. When all the calls to a given B<dh_cmd> command " +"happens in the same override target everything will work as before." msgstr "" +"主ãªæ³¨æ„点ã¨ã—ã¦ã¯ã€B<dh_*> ã¯å˜ä¸€ã® override ターゲット内ã§ä½•ãŒèµ·ã“ã£ãŸã®ã‹" +"ã ã‘を記録ã™ã‚‹ã‚ˆã†ã«ãªã£ãŸã“ã¨ã§ã™ã€‚指定ã•ã‚ŒãŸ B<dh_cmd> コマンドã¸ã®å…¨ã¦ã®å‘¼" +"ã³å‡ºã—ãŒåŒä¸€ã® override ターゲット内ã§èµ·ããŸå ´åˆã¯ã€ä»¥å‰ã¨åŒæ§˜ã«å…¨ã¦ãŒå‹•ä½œã—" +"ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1527 +#: debhelper-compat-upgrade-checklist.pod:595 +msgid "Example of where it can go wrong:" +msgstr "å‹•ã‹ãªããªã‚‹å¯èƒ½æ€§ãŒã‚る例:" + +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:597 +#, no-wrap msgid "" -"The debhelper tool suite reacts to the following flags in " -"B<DEB_BUILD_OPTIONS>." +" override_dh_foo:\n" +" dh_foo -pmy-pkg\n" +"\n" msgstr "" +" override_dh_foo:\n" +" dh_foo -pmy-pkg\n" +"\n" -#. type: =item -#: debhelper.pod:1531 -msgid "B<dherroron=obsolete-compat-levels>" +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:600 +#, no-wrap +msgid "" +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" msgstr "" +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" #. type: textblock -#: debhelper.pod:1533 -msgid "I<This is a debhelper specific value.>" +#: debhelper-compat-upgrade-checklist.pod:604 +msgid "" +"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" +"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " +"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." msgstr "" +"ã“ã®å ´åˆã€B<dh_foo --remaining> ã®å‘¼ã³å‡ºã—ã¯ã€B<dh_foo -pmy-pkg> ãŒåˆ†ã‹ã‚Œã¦ã„" +"ã‚‹ override ターゲット内ã«ã‚ã‚‹ãŸã‚ã€I<my-pkg> I<ã‚‚>å«ã¿ã¾ã™ã€‚ã“ã®å•é¡Œã¯ B<--" +"remaining> ã«é™ã‚‰ãš B<-a>, B<-i> ãªã©ã‚‚å«ã¿ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1535 +#: debhelper-compat-upgrade-checklist.pod:613 msgid "" -"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " -"debhelper tools will promote deprecation warnings for usage of old soon to " -"be removed compat levels into errors." +"The B<dh_installdeb> command now shell-escapes the lines in the " +"F<maintscript> config file. This was the original intent but it did not " +"work properly and packages have begun to rely on the incomplete shell " +"escaping (e.g. quoting file names)." msgstr "" +"B<dh_installdeb> コマンド㯠F<maintscript> è¨å®šãƒ•ã‚¡ã‚¤ãƒ«å†…ã®è¡Œã‚’シェルエスケー" +"プã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã¯å…ƒã€…æ„図ã—ã¦ã„ãŸå‹•ä½œã§ã—ãŸãŒæ£ã—ã動作ã—ã¦ãŠã‚‰" +"ãšã€ãƒ‘ッケージãŒä¸å®Œå…¨ãªã‚·ã‚§ãƒ«ã‚¨ã‚¹ã‚±ãƒ¼ãƒ— (例: ファイルåã®ã‚¯ã‚©ãƒ¼ãƒˆ) ã«ä¾å˜ã™" +"るよã†ã«ãªã£ã¦ã„ã¾ã—ãŸã€‚" #. type: textblock -#: debhelper.pod:1539 +#: debhelper-compat-upgrade-checklist.pod:620 msgid "" -"This is useful for automated checking for code relying on deprecated compat " -"levels that is scheduled for removal." +"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " +"For packages needing the previous behaviour, please use B<--no-restart-after-" +"upgrade>." msgstr "" +"B<dh_installinit> コマンドã¯æ¨™æº–㧠B<--restart-after-upgrade> を利用ã™ã‚‹ã‚ˆã†" +"ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã®å‹•ä½œãŒå¿…è¦ãªãƒ‘ッケージã«ã¯ B<--no-restart-after-upgrade> " +"を利用ã—ã¦ãã ã•ã„。" #. type: textblock -#: debhelper.pod:1542 -msgid "This option is intended for testing purposes; not production builds." +#: debhelper-compat-upgrade-checklist.pod:626 +msgid "" +"The B<autoreconf> sequence is now enabled by default. Please pass B<--" +"without autoreconf> to B<dh> if this is not desirable for a given package" msgstr "" +"B<autoreconf> シーケンスãŒæ¨™æº–ã§æœ‰åŠ¹ã«ãªã‚Šã¾ã—ãŸã€‚指定ã®ãƒ‘ッケージã§ã“ã®å‹•ä½œ" +"を望ã¾ãªã„å ´åˆã¯ã€B<dh> ã« B<--without autoreconf> を指定ã—ã¦ãã ã•ã„。" -#. type: =item -#: debhelper.pod:1544 -msgid "B<nostrip>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:632 +msgid "" +"The B<systemd> sequence is now enabled by default. Please pass B<--without " +"systemd> to B<dh> if this is not desirable for a given package." msgstr "" +"B<systemd> シーケンスãŒæ¨™æº–ã§æœ‰åŠ¹ã«ãªã‚Šã¾ã—ãŸã€‚指定ã®ãƒ‘ッケージã§ã“ã®å‹•ä½œã‚’望" +"ã¾ãªã„å ´åˆã¯ã€B<dh> ã« B<--without systemd> を指定ã—ã¦ãã ã•ã„。" #. type: textblock -#: debhelper.pod:1546 debhelper.pod:1569 +#: debhelper-compat-upgrade-checklist.pod:638 +#, fuzzy +#| msgid "" +#| "B<dh> no longer creates the package build directory when skipping running " +#| "debhelper commands. This will not affect packages that only build with " +#| "debhelper commands, but it may expose bugs in commands not included in " +#| "debhelper." msgid "" -"I<This value will change the content of the debs being built. The .deb " -"packages built when this is set is therefore not bit-for-bit reproducible " -"with a regular build in the general case.>" +"B<Retroactively removed>: B<dh> no longer creates the package build " +"directory when skipping running debhelper commands. This will not affect " +"packages that only build with debhelper commands, but it may expose bugs in " +"commands not included in debhelper." msgstr "" +"B<dh> ã¯ã€å®Ÿè¡Œã—ã¦ã„ã‚‹ debhelper コマンドをスã‚ップã—ãŸå ´åˆã«ã¯ãƒ‘ッケージビル" +"ドディレクトリを作æˆã—ãªããªã‚Šã¾ã—ãŸã€‚ã“れ㯠debhelper コマンドã®ã¿ã‚’使ã£ã¦ãƒ“" +"ルドã•ã‚Œã¦ã„るパッケージã«ã¯å½±éŸ¿ã—ã¾ã›ã‚“ãŒã€debhelper ã«å«ã¾ã‚Œã¦ã„ãªã„コマン" +"ドã®ãƒã‚°ã‚’æš´ãã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。" #. type: textblock -#: debhelper.pod:1550 +#: debhelper-compat-upgrade-checklist.pod:643 msgid "" -"This value will cause the official debhelper tools will skip actions and " -"helpers that either remove, detach or deduplicate debugging symbols in ELF " -"binaries." +"This compatibility feature had a bug since its inception in " +"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " +"there has been no reports of issues caused by this bug in those ~5 years, " +"this item have been removed rather than fixed." msgstr "" +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:650 +msgid "v9" +msgstr "v9" + #. type: textblock -#: debhelper.pod:1554 -msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:652 +msgid "Changes from v8 are:" +msgstr "v8 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:658 +msgid "" +"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " +"directories to autoconf in --libdir and --libexecdir." msgstr "" +"multiarch をサãƒãƒ¼ãƒˆã—ã¾ã™ã€‚特㫠B<dh_auto_configure> 㯠autoconfコマンド㸠" +"--libdir ã‚„ --libexecdir ã« multiarch 用途ã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã‚’渡ã™ã‚ˆã†ã«ãªã£ã¦ã„" +"ã¾ã™ã€‚" -#. type: =item -#: debhelper.pod:1556 -msgid "B<nocheck>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:663 +msgid "" +"dh is aware of the usual dependencies between targets in debian/rules. So, " +"\"dh binary\" will run any build, build-arch, build-indep, install, etc " +"targets that exist in the rules file. There's no need to define an explicit " +"binary target with explicit dependencies on the other targets." msgstr "" +"dh コマンド㯠debian/rules ã«è¨˜è¼‰ã•ã‚Œã¦ã„るターゲット間ã®ä¸€èˆ¬çš„ãªä¾å˜æ€§ã‚’考慮" +"ã—ã¾ã™ã€‚ãã®ãŸã‚ã€\"dh binary\" 㯠rules ファイルã«å˜åœ¨ã™ã‚‹ build, build-" +"arch, build-indep, install ç‰ã®ã‚¿ãƒ¼ã‚²ãƒƒãƒˆã‚’実行ã—ã¦ã„ãã¾ã™ã€‚ã¤ã¾ã‚Šã€ä»–ã®ã‚¿ãƒ¼" +"ゲットã«é–¢ã™ã‚‹ä¾å˜é–¢ä¿‚ã‚’ã„ã¡ã„ã¡ç´°ã‹ã明示ã—㟠binary ターゲットを用æ„ã™ã‚‹å¿…" +"è¦ã¯ã‚ã‚Šã¾ã›ã‚“。" #. type: textblock -#: debhelper.pod:1558 +#: debhelper-compat-upgrade-checklist.pod:670 msgid "" -"This value will cause the official debhelper build systems to skip runs of " -"upstream test suites." +"B<dh_strip> compresses debugging symbol files to reduce the installed size " +"of -dbg packages." msgstr "" +"B<dh_strip> ã¯ãƒ‡ãƒãƒƒã‚°ã‚·ãƒ³ãƒœãƒ«ãƒ•ã‚¡ã‚¤ãƒ«ã‚’圧縮ã—ã€-dbg パッケージã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«" +"時ã«å¿…è¦ã¨ã™ã‚‹å®¹é‡ã‚’削減ã—ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1561 +#: debhelper-compat-upgrade-checklist.pod:675 msgid "" -"Package maintainers looking to avoid running the upstream tests should " -"B<not> rely on this. Instead, they can add an empty override target to skip " -"B<dh_auto_test>." +"B<dh_auto_configure> does not include the source package name in --" +"libexecdir when using autoconf." msgstr "" +"B<dh_auto_configure> ã¯ã€autoconf を使ã£ãŸã¨ãã«ã€--libexecdir ã«ã‚½ãƒ¼ã‚¹ãƒ‘ッ" +"ケージåã‚’è¿½åŠ ã—ãªããªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper.pod:1565 -msgid "This value affects L<dh_auto_test(1)>." +#: debhelper-compat-upgrade-checklist.pod:680 +msgid "B<dh> does not default to enabling --with=python-support" msgstr "" +"B<dh> 㯠--with=python-support オプションをã€ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯ç„¡åŠ¹ã«ã™ã‚‹ã‚ˆã†ã«ãª" +"ã‚Šã¾ã—ãŸã€‚" -#. type: =item -#: debhelper.pod:1567 -msgid "B<nodoc>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:682 +msgid "" +"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " +"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " +"regardless of compat level)" msgstr "" #. type: textblock -#: debhelper.pod:1573 +#: debhelper-compat-upgrade-checklist.pod:688 msgid "" -"This value will cause several debhelper tools to skip installation of " -"documentation such as manpages or upstream provided documentation. " -"Additionally, the tools will also ignore if declared documentation is " -"\"missing\" on the assumption that the documentation has not been built." +"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " +"variables listed by B<dpkg-buildflags>, unless they are already set." msgstr "" +"ã™ã¹ã¦ã® B<dh_auto_>I<*> debhelper プãƒã‚°ãƒ©ãƒ 㨠B<dh> コマンドã¯ã€B<dpkg-" +"buildflags> ã§æŒ‡å®šã•ã‚Œã‚‹ç’°å¢ƒå¤‰æ•°ã‚’è¨å®šã—ã¾ã™ã€‚ã™ã§ã«è©²å½“ã™ã‚‹ç’°å¢ƒå¤‰æ•°ãŒè¨å®šã•" +"ã‚Œã¦ã„ã‚‹å ´åˆã¯è¨å®šã‚’è¡Œã„ã¾ã›ã‚“。" #. type: textblock -#: debhelper.pod:1578 +#: debhelper-compat-upgrade-checklist.pod:694 msgid "" -"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " -"working with documentation." +"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " +"to perl F<Makefile.PL> and F<Build.PL>" msgstr "" - -#. type: =item -#: debhelper.pod:1581 -#, fuzzy -#| msgid "B<--ddebs>, B<--no-ddebs>" -msgid "B<noautodbgsym>, B<noddebs>" -msgstr "B<--ddebs>, B<--no-ddebs>" +"B<dh_auto_configure> ã¯ã€B<dpkg-buildflags> ã«ã‚ˆã£ã¦è¨å®šã•ã‚Œã‚‹CFLAGSã€" +"CPPFLAGS, LDFLAGS パラメータを F<Makefile.PL> ã‚„ F<Build.PL> ã¸å¼•ã渡ã—ã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1583 +#: debhelper-compat-upgrade-checklist.pod:699 msgid "" -"I<The official name is autodbgsym. The noddebs variant is accepted for " -"historical reasons.>" +"B<dh_strip> puts separated debug symbols in a location based on their build-" +"id." msgstr "" +"B<dh_strip> 㯠build-id ã«åŸºã¥ãå ´æ‰€ã«ã€åˆ†é›¢ã—ãŸãƒ‡ãƒãƒƒã‚°ã‚·ãƒ³ãƒœãƒ«ã‚’é…ç½®ã—ã¾" +"ã™ã€‚" #. type: textblock -#: debhelper.pod:1586 +#: debhelper-compat-upgrade-checklist.pod:704 msgid "" -"This value causes debhelper to skip the generation of automatically " -"generated debug symbol packages." +"Executable debhelper config files are run and their output used as the " +"configuration." msgstr "" +"実行å¯èƒ½æ¨©é™ã‚’付与ã—㟠debhelper 用ã®è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã¯ã€å®Ÿè¡Œã•ã‚Œå‡ºåŠ›ãŒè¨å®šã¨ã—ã¦" +"扱ã‚ã‚Œã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1589 -msgid "This value affects L<dh_strip(1)>." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:709 +#: debhelper-compat-upgrade-checklist.pod:740 +#: debhelper-compat-upgrade-checklist.pod:744 debhelper-obsolete-compat.pod:81 +#: debhelper-obsolete-compat.pod:135 debhelper-obsolete-compat.pod:158 +#: debhelper-obsolete-compat.pod:165 debhelper-obsolete-compat.pod:174 +msgid "This mode is deprecated." +msgstr "ã“ã®ãƒ¢ãƒ¼ãƒ‰ã¯å»ƒæ¢ã•ã‚Œã¾ã—ãŸã€‚" #. type: =item -#: debhelper.pod:1591 -msgid "B<parallel=N>" -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:711 +msgid "v8" +msgstr "v8" #. type: textblock -#: debhelper.pod:1593 -msgid "" -"This value enables debhelper to use up to B<N> threads or processes (subject " -"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " -"debhelper tools work with parallel tasks and may silently ignore the request." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:713 +msgid "Changes from v7 are:" +msgstr "v7 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" #. type: textblock -#: debhelper.pod:1598 +#: debhelper-compat-upgrade-checklist.pod:719 msgid "" -"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " -"will attempt to run the underlying upstream build system with that number of " -"threads." +"Commands will fail rather than warning when they are passed unknown options." msgstr "" +"未定義ã®ã‚ªãƒ—ションを渡ãã†ã¨ã™ã‚‹ã¨ã€è¦å‘Šæ–‡ã‚’出ã—ã¦å‡¦ç†ç¶šè¡Œã™ã‚‹ã®ã§ã¯ãªãã€ã‚¨" +"ラーã«ã—ã¦å‡¦ç†ã‚’失敗ã•ã›ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" -#. type: =item -#: debhelper.pod:1602 -msgid "B<terse>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:723 +msgid "" +"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " +"generates shlibs files for. So B<-X> can be used to exclude libraries. " +"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " +"processed before will be passed to it, a behavior change that can cause some " +"packages to fail to build." msgstr "" +"B<dh_makeshlibs> ã¯ã€shlibs ファイルを作æˆã™ã‚‹ç‚ºã«ã€B<dpkg-gensymbols> ã‚’ã™ã¹" +"ã¦ã®å…±æœ‰ãƒ©ã‚¤ãƒ–ラリã«å¯¾ã—ã¦å®Ÿè¡Œã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚B<-X> を指定ã™ã‚‹ã¨å®Ÿè¡Œã‚’" +"除外ã™ã‚‹ãƒ©ã‚¤ãƒ–ラリを指定ã§ãã¾ã™ã€‚ã¾ãŸã€é€šå¸¸ã§ã¯ãªã„å ´æ‰€ã«ãƒ©ã‚¤ãƒ–ラリãŒã‚る為 " +"B<dh_makeshlibs> ã¸æ¸¡ã™å‰ã« B<dpkg-gensymbols> ãŒå‡¦ç†ã§ããªã„よã†ãªå ´åˆã€ãƒ‘ッ" +"ケージã®ãƒ“ルドãŒå¤±æ•—ã«çµ‚ã‚るよã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper.pod:1604 +#: debhelper-compat-upgrade-checklist.pod:731 msgid "" -"This value will cause the official debhelper build systems to configure " -"upstream builds to be terse (i.e. reduce verbosity in their output). This " -"is subject to the upstream and the debhelper build system supporting such " -"features." +"B<dh> requires the sequence to run be specified as the first parameter, and " +"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo " +"$@>\"." msgstr "" +"B<dh> ã¯æœ€åˆã®ãƒ‘ラメータã¨ã—ã¦ã€ä¸€é€£ã®å‡¦ç†ã®åå‰ã‚’指定ã—ã€ãã®æ¬¡ã«ã‚ªãƒ—ション" +"を記載ã—ãªã‘ã‚Œã°ãªã‚‰ãªããªã‚Šã¾ã—ãŸã€‚ã¤ã¾ã‚Šã€\"B<dh $@ --foo>\" ãŒæ£ã—" +"ãã€\"B<dh --foo $@>\" ã¯é–“é•ã„ã¨ãªã‚Šã¾ã™ã€‚" #. type: textblock -#: debhelper.pod:1609 -msgid "This value affects most B<dh_auto_*> tools." +#: debhelper-compat-upgrade-checklist.pod:736 +msgid "" +"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " +"F<Makefile.PL>." msgstr "" +"B<dh_auto_>I<*> 㯠F<Makefile.PL> ファイルよりもã€Perl ã® B<Module::Build> モ" +"ジュールを優先ã—ã¦åˆ©ç”¨ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:742 debhelper-obsolete-compat.pod:21 +msgid "v7" +msgstr "v7" #. type: textblock -#: debhelper.pod:1613 -msgid "Unknown flags are silently ignored." -msgstr "" +#: debhelper-compat-upgrade-checklist.pod:746 debhelper-obsolete-compat.pod:23 +msgid "This is the lowest supported compatibility level." +msgstr "ã“ã‚Œã¯ã‚µãƒãƒ¼ãƒˆã•ã‚Œã¦ã„る最低é™ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã§ã™ã€‚" #. type: textblock -#: debhelper.pod:1615 +#: debhelper-compat-upgrade-checklist.pod:748 msgid "" -"Note third-party debhelper-like tools or third-party provided build systems " -"may or may not react to the above flags. This tends to depend on " -"implementation details of the tool." +"If you are upgrading from an earlier compatibility level, please review " +"L<debhelper-obsolete-compat(7)>." msgstr "" - -#. type: =head1 -#: debhelper.pod:1619 debhelper-obsolete-compat.pod:118 dh:733 dh_auto_build:53 -#: dh_auto_clean:55 dh_auto_configure:58 dh_auto_install:97 dh_auto_test:64 -#: dh_bugfiles:133 dh_builddeb:182 dh_clean:189 dh_compress:242 dh_dwz:161 -#: dh_fixperms:164 dh_gconf:105 dh_gencontrol:208 dh_icons:75 dh_install:377 -#: dh_installcatalogs:128 dh_installchangelogs:300 dh_installcron:78 -#: dh_installdeb:412 dh_installdebconf:128 dh_installdirs:131 -#: dh_installdocs:454 dh_installemacsen:138 dh_installexamples:178 -#: dh_installifupdown:72 dh_installinfo:123 dh_installinit:430 -#: dh_installinitramfs:91 dh_installlogcheck:81 dh_installlogrotate:53 -#: dh_installman:417 dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 -#: dh_installmodules:109 dh_installpam:62 dh_installppp:68 dh_installudev:102 -#: dh_installwm:132 dh_installxfonts:90 dh_link:166 dh_lintian:60 -#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 -#: dh_perl:174 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 -#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:281 dh_systemd_start:280 -msgid "SEE ALSO" -msgstr "å‚ç…§" +"ã“れ以å‰ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã‹ã‚‰ã‚¢ãƒƒãƒ—グレードã—よã†ã¨ã—ã¦ã„ã‚‹å ´åˆã€L<debhelper-" +"obsolete-compat(7)> を確èªã—ã¦ä¸‹ã•ã„。" #. type: =item -#: debhelper.pod:1623 -msgid "F</usr/share/doc/debhelper/examples/>" -msgstr "F</usr/share/doc/debhelper/examples/>" +#: debhelper-compat-upgrade-checklist.pod:757 +#, fuzzy +#| msgid "L<debhelper(7)>" +msgid "L<debhelper-obsolete-compat(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1625 -msgid "A set of example F<debian/rules> files that use debhelper." +#: debhelper-compat-upgrade-checklist.pod:759 +msgid "" +"Upgrading from a (now) obsolete compatibility level? This document covers " +"the upgrade checklist up to the earliest supported level." msgstr "" -"debhelper を使ã†ã¨ãã® F<debian/rules> ファイルã®ä¾‹ãŒæ ¼ç´ã•ã‚Œã¦ã„ã¾ã™ã€‚" -#. type: =item -#: debhelper.pod:1627 -msgid "L<http://joeyh.name/code/debhelper/>" -msgstr "L<http://joeyh.name/code/debhelper/>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:762 debhelper-obsolete-compat.pod:180 +#: dh:874 dh_auto_build:55 dh_auto_clean:57 dh_auto_configure:60 +#: dh_auto_install:105 dh_auto_test:66 dh_builddeb:178 dh_clean:191 +#: dh_compress:245 dh_dwz:165 dh_fixperms:166 dh_gencontrol:210 dh_install:379 +#: dh_installcatalogs:130 dh_installchangelogs:367 dh_installcron:82 +#: dh_installdeb:421 dh_installdebconf:235 dh_installdirs:133 +#: dh_installdocs:439 dh_installexamples:184 dh_installifupdown:74 +#: dh_installinfo:125 dh_installlogcheck:83 dh_installlogrotate:55 +#: dh_installman:422 dh_installmanpages:200 dh_installmime:65 +#: dh_installmodules:111 dh_installpam:73 dh_installppp:70 dh_installudev:104 +#: dh_installwm:132 dh_installxfonts:92 dh_link:168 dh_listpackages:36 +#: dh_makeshlibs:458 dh_md5sums:120 dh_movefiles:163 dh_perl:190 dh_prep:72 +#: dh_strip:437 dh_testdir:64 dh_testroot:95 dh_usrlocal:138 +#: dh_systemd_start:282 +msgid "L<debhelper(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1629 -msgid "Debhelper web site." -msgstr "Debhelper ã® Web サイトã§ã™ã€‚" +#: debhelper-compat-upgrade-checklist.pod:764 +msgid "" +"General information about the debhelper framework. This document also covers " +"how to declare your chosen debhelper compat level." +msgstr "" #. type: =head1 -#: debhelper.pod:1633 dh:739 dh_auto_build:59 dh_auto_clean:61 -#: dh_auto_configure:64 dh_auto_install:103 dh_auto_test:70 dh_bugfiles:141 -#: dh_builddeb:188 dh_clean:195 dh_compress:248 dh_dwz:167 dh_fixperms:170 -#: dh_gconf:111 dh_gencontrol:214 dh_icons:81 dh_install:383 -#: dh_installcatalogs:134 dh_installchangelogs:306 dh_installcron:84 -#: dh_installdeb:418 dh_installdebconf:134 dh_installdirs:137 -#: dh_installdocs:460 dh_installemacsen:145 dh_installexamples:184 -#: dh_installifupdown:78 dh_installinfo:129 dh_installinitramfs:99 -#: dh_installlogcheck:87 dh_installlogrotate:59 dh_installman:423 -#: dh_installmanpages:204 dh_installmenu:96 dh_installmime:69 -#: dh_installmodules:115 dh_installpam:68 dh_installppp:74 dh_installudev:108 -#: dh_installwm:138 dh_installxfonts:96 dh_link:172 dh_lintian:68 -#: dh_listpackages:40 dh_makeshlibs:462 dh_md5sums:124 dh_movefiles:167 -#: dh_perl:180 dh_prep:76 dh_shlibdeps:210 dh_strip:441 dh_testdir:68 -#: dh_testroot:99 dh_usrlocal:142 -msgid "AUTHOR" +#: debhelper-compat-upgrade-checklist.pod:769 debhelper-obsolete-compat.pod:182 +#: dh_installinit:419 dh_systemd_enable:284 dh_systemd_start:284 +msgid "AUTHORS" msgstr "作者" #. type: textblock -#: debhelper.pod:1635 dh:741 dh_auto_build:61 dh_auto_clean:63 -#: dh_auto_configure:66 dh_auto_install:105 dh_auto_test:72 dh_builddeb:190 -#: dh_clean:197 dh_compress:250 dh_fixperms:172 dh_gencontrol:216 -#: dh_install:385 dh_installchangelogs:308 dh_installcron:86 dh_installdeb:420 -#: dh_installdebconf:136 dh_installdirs:139 dh_installdocs:462 -#: dh_installemacsen:147 dh_installexamples:186 dh_installifupdown:80 -#: dh_installinfo:131 dh_installinit:438 dh_installlogrotate:61 -#: dh_installman:425 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 -#: dh_installmodules:117 dh_installpam:70 dh_installppp:76 dh_installudev:110 -#: dh_installwm:140 dh_installxfonts:98 dh_link:174 dh_listpackages:42 -#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 -#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 -msgid "Joey Hess <joeyh@debian.org>" -msgstr "Joey Hess <joeyh@debian.org>" +#: debhelper-compat-upgrade-checklist.pod:771 debhelper-obsolete-compat.pod:184 +#: dh_dwz:171 dh_installinitramfs:101 +msgid "Niels Thykier <niels@thykier.net>" +msgstr "Niels Thykier <niels@thykier.net>" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:773 debhelper-obsolete-compat.pod:186 +msgid "Joey Hess" +msgstr "Joey Hess" #. type: textblock #: debhelper-obsolete-compat.pod:3 @@ -3400,89 +3631,150 @@ msgid "" "The following is the list of now obsolete compat levels and their changes." msgstr "以下ã¯éŽåŽ»ã®ã‚‚ã®ã¨ãªã£ãŸäº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã¨ãã®å¤‰æ›´ã®ä¸€è¦§ã§ã™ã€‚" -#. type: =item -#: debhelper-obsolete-compat.pod:21 -msgid "v1" -msgstr "v1" +#. type: textblock +#: debhelper-obsolete-compat.pod:25 +msgid "Changes from v6 are:" +msgstr "v6 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" #. type: textblock -#: debhelper-obsolete-compat.pod:23 +#: debhelper-obsolete-compat.pod:31 msgid "" -"This is the original debhelper compatibility level, and so it is the default " -"one. In this mode, debhelper will use F<debian/tmp> as the package tree " -"directory for the first binary package listed in the control file, while " -"using debian/I<package> for all other packages listed in the F<control> file." +"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " +"doesn't find them in the current directory (or wherever you tell it look " +"using B<--sourcedir>). This allows B<dh_install> to interoperate with " +"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " +"special parameters." msgstr "" -"ã“れ㯠debhelper ãŒå…ƒæ¥æŒã¤äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã§ã€ã“ã‚ŒãŒãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã™ã€‚ã“ã®ãƒ¢ãƒ¼ãƒ‰ã§" -"ã¯ã€debhelper ã¯F<debian/tmp> ã‚’ã€control ファイルã®æœ€åˆã«è¨˜è¼‰ã•ã‚Œã¦ã„ã‚‹ãƒã‚¤" -"ナリパッケージã®ãƒ“ルドディレクトリã¨ã—ã¦åˆ©ç”¨ã—よã†ã¨ã—ã¾ã™ã€‚ã¾ãŸã€debian/" -"I<package> ã‚’ F<control> 内ã«æŒ‡å®šã•ã‚Œã¦ã„る全パッケージã«å¯¾ã—ã¦é©ç”¨ã—ã¾ã™ã€‚" +"ã‚‚ã—ã€F<debian/tmp> 以下ã«ã‚るよã†ãªãƒ•ã‚¡ã‚¤ãƒ«ãŒã€ã‚«ãƒ¬ãƒ³ãƒˆãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ãªã„å ´" +"åˆ (ã‚‚ã—ãã¯ã€B<--sourcedir> ã§æŒ‡å®šã—ãŸãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã«ãªã„å ´åˆ) ã€" +"B<dh_install> 㯠F<debian/tmp> を探ã—ã«ã„ãよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã®æŒ¯ã‚‹èˆžã„ã®å¤‰" +"æ›´ã«ã‚ˆã‚Šã€B<dh_install> ã«ç‰¹ã«ä½•ã‹å¼•æ•°ã‚’指定ã—ãªãã¦ã‚‚ã€F<debian/tmp> ã«ã‚¤ãƒ³" +"ストールã—よã†ã¨ã™ã‚‹ B<dh_auto_install> ã¨å”調ã—ã¦å‹•ä½œã§ãるよã†ã«ãªã‚Šã¾ã—" +"ãŸã€‚" -#. type: =item -#: debhelper-obsolete-compat.pod:30 -msgid "v2" -msgstr "v2" +#. type: textblock +#: debhelper-obsolete-compat.pod:38 +msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +msgstr "" +"B<dh_clean> 㯠F<debian/clean> ã‚’èªã¿ã€ãã“ã«è¨˜è¼‰ã•ã‚Œã¦ã„るファイルを消ã™ã‚ˆã†" +"ã«ãªã‚Šã¾ã—ãŸã€‚" + +#. type: textblock +#: debhelper-obsolete-compat.pod:42 +msgid "B<dh_clean> will delete toplevel F<*-stamp> files." +msgstr "" +"B<dh_clean> ã¯ãƒ“ルドディレクトリã®æœ€ä¸Šä½ã®éšŽå±¤ã«ã‚ã‚‹ F<*-stamp> ファイルを消" +"ã™ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper-obsolete-compat.pod:32 +#: debhelper-obsolete-compat.pod:46 msgid "" -"In this mode, debhelper will consistently use debian/I<package> as the " -"package tree directory for every package that is built." +"B<dh_installchangelogs> will guess at what file is the upstream changelog if " +"none is specified." msgstr "" -"ã“ã®ãƒ¢ãƒ¼ãƒ‰ã‚’指定ã™ã‚‹ã¨ã€å¸¸ã« debian/I<package> を全パッケージã®ãƒ“ルドディレク" -"トリã¨ã—ã¦åˆ©ç”¨ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" +"B<dh_installchangelogs> ã¯ã€ä½•ã‚‚指定ã—ãªãã¦ã‚‚ã©ã®ãƒ•ã‚¡ã‚¤ãƒ«ãŒ upstream ã® " +"changelog ã§ã‚ã‚‹ã‹ã‚’推定ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: =item -#: debhelper-obsolete-compat.pod:37 -msgid "v3" -msgstr "v3" +#: debhelper-obsolete-compat.pod:51 +msgid "v6" +msgstr "v6" #. type: textblock -#: debhelper-obsolete-compat.pod:39 -msgid "This mode works like v2, with the following additions:" +#: debhelper-obsolete-compat.pod:53 +msgid "Changes from v5 are:" +msgstr "v5 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" + +#. type: textblock +#: debhelper-obsolete-compat.pod:59 +msgid "" +"Commands that generate maintainer script fragments will order the fragments " +"in reverse order for the F<prerm> and F<postrm> scripts." msgstr "" -"ã“ã®ãƒ¢ãƒ¼ãƒ‰ã¯ v2 ã®ãƒ¢ãƒ¼ãƒ‰ã¨åŒã˜å‹•ä½œã‚’ã—ã¾ã™ãŒã€ä»¥ä¸‹ã®è¿½åŠ 機能ãŒã‚ã‚Šã¾ã™:" +"メンテナンス用スクリプトã®ä¸€éƒ¨ã‚’生æˆã™ã‚‹ã‚³ãƒžãƒ³ãƒ‰ã¯ã€F<prerm> 㨠F<postrm> ス" +"クリプト用ã«ã“ã‚Œã‚‰ã‚’é€†é †ã«ä¸¦ã³æ›¿ãˆã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper-obsolete-compat.pod:45 +#: debhelper-obsolete-compat.pod:64 msgid "" -"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " -"To turn this off and use those characters raw, just prefix with a backslash." +"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." +"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " +"directory." msgstr "" -"debhelper ã®è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã¯ã€B<*> ã‚„ B<?> ã®ãƒ¯ã‚¤ãƒ«ãƒ‰ã‚«ãƒ¼ãƒ‰ã«ã‚ˆã‚‹ãƒ•ã‚¡ã‚¤ãƒ«å指定" -"ãŒåˆ©ç”¨ã§ãã¾ã™ã€‚ã“ã®æ©Ÿèƒ½ã‚’無効ã«ã—ã€ã“れらワイルドカード文å—ã‚’ãã®ã¾ã¾ã®æ–‡å—" -"ã¨ã—ã¦æ‰±ã†ã«ã¯ã€ãƒãƒƒã‚¯ã‚¹ãƒ©ãƒƒã‚·ãƒ¥ã‚’æ–‡å—ã®å‰ã«ç½®ã„ã¦ãã ã•ã„。" +"B<dh_installwm> 㯠F<x-window-manager.1.gz> ã¨ã„ㆠslave 㪠man ページã¸ãƒªãƒ³" +"クを作るよã†ã«ãªã‚Šã¾ã—ãŸã€‚ã“ã‚Œã¯ãƒ‘ッケージビルドディレクトリ内㮠F<usr/share/" +"man/man1> ディレクトリ㫠man ページãŒã‚ã‚‹å ´åˆã«è¡Œã‚ã‚Œã¾ã™ã€‚" #. type: textblock -#: debhelper-obsolete-compat.pod:50 +#: debhelper-obsolete-compat.pod:70 msgid "" -"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " -"B<ldconfig>." +"B<dh_builddeb> did not previously delete everything matching " +"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " +"B<CVS:.svn:.git>. Now it does." msgstr "" -"B<dh_makeshlibs> ã«ã‚ˆã‚Šã€F<postinst> ã‚„ F<postrm> スクリプト㌠B<ldconfig> ã‚’" -"呼ã³å‡ºã™ã‚ˆã†ã«ãªã£ã¦ã„ã¾ã™ã€‚" +"B<dh_builddeb> ã¯ã€B<CVS:.svn:.git> ã®ã‚ˆã†ã«é™¤å¤–ã™ã‚‹å¯¾è±¡ã‚’ " +"B<DH_ALWAYS_EXCLUDE> ã«æŒ‡å®šã—ã¦ã‚‚該当ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã‚’削除ã—ã¦ã„ã¾ã›ã‚“ã§ã—ãŸã€‚本" +"互æ›æ€§ãƒ¬ãƒ™ãƒ«ã§ã¯å‰Šé™¤ã™ã‚‹ã‚ˆã†ã«ãªã£ã¦ã„ã¾ã™ã€‚" + +#. type: textblock +#: debhelper-obsolete-compat.pod:76 +msgid "" +"B<dh_installman> allows overwriting existing man pages in the package build " +"directory. In previous compatibility levels it silently refuses to do this." +msgstr "" +"B<dh_installman> ã¯ã€ãƒ‘ッケージビルドディレクトリã«ã™ã§ã«å˜åœ¨ã™ã‚‹ man ページ" +"を上書ãã—ã¦ã‚‚良ããªã‚Šã¾ã—ãŸã€‚ã“れより以å‰ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã®å…ƒã§ã¯ã€ã“ã®ã‚ˆã†ãª" +"動作ã¯ä½•ã®è¦å‘Šã‚‚ãªã拒絶ã•ã‚Œã¦ã„ã¾ã—ãŸã€‚" + +#. type: =item +#: debhelper-obsolete-compat.pod:83 +msgid "v5" +msgstr "v5" + +#. type: textblock +#: debhelper-obsolete-compat.pod:85 +msgid "Changes from v4 are:" +msgstr "v4 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" + +#. type: textblock +#: debhelper-obsolete-compat.pod:91 +msgid "Comments are ignored in debhelper config files." +msgstr "debhelper è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã§ã®ã‚³ãƒ¡ãƒ³ãƒˆã¯ç„¡è¦–ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" + +#. type: textblock +#: debhelper-obsolete-compat.pod:95 +msgid "" +"B<dh_strip --dbg-package> now specifies the name of a package to put " +"debugging symbols in, not the packages to take the symbols from." +msgstr "" +"B<dh_strip --dbg-package> ã«ã‚ˆã‚Šã€ãƒ‡ãƒãƒƒã‚°ç”¨ã‚·ãƒ³ãƒœãƒ«ãƒ†ãƒ¼ãƒ–ルã«å¯¾ã—ã¦ãƒ‘ッケー" +"ジã®åå‰ã‚’指定ã§ãるよã†ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã¯ãƒ‡ãƒãƒƒã‚°ç”¨ã‚·ãƒ³ãƒœãƒ«ãƒ†ãƒ¼ãƒ–ルã‹ã‚‰" +"パッケージã®åå‰ã‚’å–り出ã—ã¦ã„ã¾ã—ãŸã€‚" #. type: textblock -#: debhelper-obsolete-compat.pod:54 -msgid "" -"Every file in F<etc/> is automatically flagged as a conffile by " -"B<dh_installdeb>." +#: debhelper-obsolete-compat.pod:100 +msgid "B<dh_installdocs> skips installing empty files." +msgstr "B<dh_installdocs> ã¯ç©ºãƒ•ã‚¡ã‚¤ãƒ«ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚’飛ã°ã—ã¾ã™ã€‚" + +#. type: textblock +#: debhelper-obsolete-compat.pod:104 +msgid "B<dh_install> errors out if wildcards expand to nothing." msgstr "" -"B<dh_installdeb> ã¯ã€F<etc/> 以下ã®ã™ã¹ã¦ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’自動的㫠conffile ã¨ã—ã¦" -"扱ã„ã¾ã™ã€‚" +"B<dh_install> ã¯ã€ãƒ¯ã‚¤ãƒ«ãƒ‰ã‚«ãƒ¼ãƒ‰ã«è©²å½“ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ãŒç„¡ã„時ã¯ã‚¨ãƒ©ãƒ¼ã‚’出力ã™ã‚‹" +"よã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: =item -#: debhelper-obsolete-compat.pod:60 +#: debhelper-obsolete-compat.pod:108 msgid "v4" msgstr "v4" #. type: textblock -#: debhelper-obsolete-compat.pod:62 +#: debhelper-obsolete-compat.pod:110 msgid "Changes from v3 are:" msgstr "v3 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" #. type: textblock -#: debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:116 msgid "" "B<dh_makeshlibs -V> will not include the Debian part of the version number " "in the generated dependency line in the shlibs file." @@ -3491,7 +3783,7 @@ msgstr "" "ジョン番å·ã«ã¤ã„ã¦ã€debian リビジョンをå«ã‚ãªã„よã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper-obsolete-compat.pod:73 +#: debhelper-obsolete-compat.pod:121 msgid "" "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> " "to supplement the B<${shlibs:Depends}> field." @@ -3500,7 +3792,7 @@ msgstr "" "指定ã™ã‚‹ã®ãŒæŽ¨å¥¨ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper-obsolete-compat.pod:78 +#: debhelper-obsolete-compat.pod:126 msgid "" "B<dh_fixperms> will make all files in F<bin/> directories and in F<etc/init." "d> executable." @@ -3509,76 +3801,82 @@ msgstr "" "ã¦ã®ãƒ•ã‚¡ã‚¤ãƒ«ã«å®Ÿè¡Œæ¨©é™ãŒä»˜ä¸Žã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" #. type: textblock -#: debhelper-obsolete-compat.pod:83 +#: debhelper-obsolete-compat.pod:131 msgid "B<dh_link> will correct existing links to conform with policy." msgstr "" "B<dh_link>ã¯ã€æ—¢å˜ã®ãƒªãƒ³ã‚¯ã§ã‚ã£ã¦ã‚‚ãƒãƒªã‚·ãƒ¼ã«åˆã‚ã›ã€ãƒªãƒ³ã‚¯ã‚’ä¿®æ£ã™ã‚‹ã‚ˆã†ã«" "ãªã‚Šã¾ã—ãŸã€‚" -#. type: textblock -#: debhelper-obsolete-compat.pod:93 -msgid "Changes from v4 are:" -msgstr "v4 ã‹ã‚‰ã®å¤‰æ›´ç‚¹:" +#. type: =item +#: debhelper-obsolete-compat.pod:137 +msgid "v3" +msgstr "v3" #. type: textblock -#: debhelper-obsolete-compat.pod:99 -msgid "Comments are ignored in debhelper config files." -msgstr "debhelper è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã§ã®ã‚³ãƒ¡ãƒ³ãƒˆã¯ç„¡è¦–ã•ã‚Œã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã—ãŸã€‚" +#: debhelper-obsolete-compat.pod:139 +msgid "This mode works like v2, with the following additions:" +msgstr "" +"ã“ã®ãƒ¢ãƒ¼ãƒ‰ã¯ v2 ã®ãƒ¢ãƒ¼ãƒ‰ã¨åŒã˜å‹•ä½œã‚’ã—ã¾ã™ãŒã€ä»¥ä¸‹ã®è¿½åŠ 機能ãŒã‚ã‚Šã¾ã™:" #. type: textblock -#: debhelper-obsolete-compat.pod:103 +#: debhelper-obsolete-compat.pod:145 msgid "" -"B<dh_strip --dbg-package> now specifies the name of a package to put " -"debugging symbols in, not the packages to take the symbols from." +"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " +"To turn this off and use those characters raw, just prefix with a backslash." msgstr "" -"B<dh_strip --dbg-package> ã«ã‚ˆã‚Šã€ãƒ‡ãƒãƒƒã‚°ç”¨ã‚·ãƒ³ãƒœãƒ«ãƒ†ãƒ¼ãƒ–ルã«å¯¾ã—ã¦ãƒ‘ッケー" -"ジã®åå‰ã‚’指定ã§ãるよã†ã«ãªã‚Šã¾ã—ãŸã€‚以å‰ã¯ãƒ‡ãƒãƒƒã‚°ç”¨ã‚·ãƒ³ãƒœãƒ«ãƒ†ãƒ¼ãƒ–ルã‹ã‚‰" -"パッケージã®åå‰ã‚’å–り出ã—ã¦ã„ã¾ã—ãŸã€‚" - -#. type: textblock -#: debhelper-obsolete-compat.pod:108 -msgid "B<dh_installdocs> skips installing empty files." -msgstr "B<dh_installdocs> ã¯ç©ºãƒ•ã‚¡ã‚¤ãƒ«ã®ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚’飛ã°ã—ã¾ã™ã€‚" +"debhelper ã®è¨å®šãƒ•ã‚¡ã‚¤ãƒ«ã¯ã€B<*> ã‚„ B<?> ã®ãƒ¯ã‚¤ãƒ«ãƒ‰ã‚«ãƒ¼ãƒ‰ã«ã‚ˆã‚‹ãƒ•ã‚¡ã‚¤ãƒ«å指定" +"ãŒåˆ©ç”¨ã§ãã¾ã™ã€‚ã“ã®æ©Ÿèƒ½ã‚’無効ã«ã—ã€ã“れらワイルドカード文å—ã‚’ãã®ã¾ã¾ã®æ–‡å—" +"ã¨ã—ã¦æ‰±ã†ã«ã¯ã€ãƒãƒƒã‚¯ã‚¹ãƒ©ãƒƒã‚·ãƒ¥ã‚’æ–‡å—ã®å‰ã«ç½®ã„ã¦ãã ã•ã„。" #. type: textblock -#: debhelper-obsolete-compat.pod:112 -msgid "B<dh_install> errors out if wildcards expand to nothing." +#: debhelper-obsolete-compat.pod:150 +msgid "" +"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " +"B<ldconfig>." msgstr "" -"B<dh_install> ã¯ã€ãƒ¯ã‚¤ãƒ«ãƒ‰ã‚«ãƒ¼ãƒ‰ã«è©²å½“ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ãŒç„¡ã„時ã¯ã‚¨ãƒ©ãƒ¼ã‚’出力ã™ã‚‹" -"よã†ã«ãªã‚Šã¾ã—ãŸã€‚" +"B<dh_makeshlibs> ã«ã‚ˆã‚Šã€F<postinst> ã‚„ F<postrm> スクリプト㌠B<ldconfig> ã‚’" +"呼ã³å‡ºã™ã‚ˆã†ã«ãªã£ã¦ã„ã¾ã™ã€‚" #. type: textblock -#: debhelper-obsolete-compat.pod:120 dh:735 dh_auto_build:55 dh_auto_clean:57 -#: dh_auto_configure:60 dh_auto_install:99 dh_auto_test:66 dh_builddeb:184 -#: dh_clean:191 dh_compress:244 dh_dwz:163 dh_fixperms:166 dh_gconf:107 -#: dh_gencontrol:210 dh_install:379 dh_installcatalogs:130 -#: dh_installchangelogs:302 dh_installcron:80 dh_installdeb:414 -#: dh_installdebconf:130 dh_installdirs:133 dh_installdocs:456 -#: dh_installexamples:180 dh_installifupdown:74 dh_installinfo:125 -#: dh_installlogcheck:83 dh_installlogrotate:55 dh_installman:419 -#: dh_installmanpages:200 dh_installmime:65 dh_installmodules:111 -#: dh_installpam:64 dh_installppp:70 dh_installudev:104 dh_installwm:134 -#: dh_installxfonts:92 dh_link:168 dh_listpackages:36 dh_makeshlibs:458 -#: dh_md5sums:120 dh_movefiles:163 dh_perl:176 dh_prep:72 dh_strip:437 -#: dh_testdir:64 dh_testroot:95 dh_usrlocal:138 dh_systemd_start:282 -msgid "L<debhelper(7)>" -msgstr "L<debhelper(7)>" +#: debhelper-obsolete-compat.pod:154 +msgid "" +"Every file in F<etc/> is automatically flagged as a conffile by " +"B<dh_installdeb>." +msgstr "" +"B<dh_installdeb> ã¯ã€F<etc/> 以下ã®ã™ã¹ã¦ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’自動的㫠conffile ã¨ã—ã¦" +"扱ã„ã¾ã™ã€‚" -#. type: =head1 -#: debhelper-obsolete-compat.pod:122 dh_installinit:436 dh_systemd_enable:285 -#: dh_systemd_start:284 -msgid "AUTHORS" -msgstr "作者" +#. type: =item +#: debhelper-obsolete-compat.pod:160 +msgid "v2" +msgstr "v2" #. type: textblock -#: debhelper-obsolete-compat.pod:124 dh_dwz:169 dh_installinitramfs:101 -msgid "Niels Thykier <niels@thykier.net>" -msgstr "Niels Thykier <niels@thykier.net>" +#: debhelper-obsolete-compat.pod:162 +msgid "" +"In this mode, debhelper will consistently use debian/I<package> as the " +"package tree directory for every package that is built." +msgstr "" +"ã“ã®ãƒ¢ãƒ¼ãƒ‰ã‚’指定ã™ã‚‹ã¨ã€å¸¸ã« debian/I<package> を全パッケージã®ãƒ“ルドディレク" +"トリã¨ã—ã¦åˆ©ç”¨ã™ã‚‹ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚" + +#. type: =item +#: debhelper-obsolete-compat.pod:167 +msgid "v1" +msgstr "v1" #. type: textblock -#: debhelper-obsolete-compat.pod:126 -msgid "Joey Hess" -msgstr "Joey Hess" +#: debhelper-obsolete-compat.pod:169 +msgid "" +"This is the original debhelper compatibility level, and so it is the default " +"one. In this mode, debhelper will use F<debian/tmp> as the package tree " +"directory for the first binary package listed in the control file, while " +"using debian/I<package> for all other packages listed in the F<control> file." +msgstr "" +"ã“れ㯠debhelper ãŒå…ƒæ¥æŒã¤äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã§ã€ã“ã‚ŒãŒãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã™ã€‚ã“ã®ãƒ¢ãƒ¼ãƒ‰ã§" +"ã¯ã€debhelper ã¯F<debian/tmp> ã‚’ã€control ファイルã®æœ€åˆã«è¨˜è¼‰ã•ã‚Œã¦ã„ã‚‹ãƒã‚¤" +"ナリパッケージã®ãƒ“ルドディレクトリã¨ã—ã¦åˆ©ç”¨ã—よã†ã¨ã—ã¾ã™ã€‚ã¾ãŸã€debian/" +"I<package> ã‚’ F<control> 内ã«æŒ‡å®šã•ã‚Œã¦ã„る全パッケージã«å¯¾ã—ã¦é©ç”¨ã—ã¾ã™ã€‚" #. type: textblock #: dh:5 @@ -3700,7 +3998,7 @@ msgid "" "The override and hook targets can also be defined to run only when building " "architecture dependent or architecture independent packages. Use targets " "with names like B<override_>I<dh_command>B<-arch> and " -"B<execute_after>I<dh_command>B<-indep>." +"B<execute_after_>I<dh_command>B<-indep>." msgstr "" "アーã‚テクãƒãƒ£ä¾å˜ãƒ‘ッケージを作るã¨ãã®ã¿ã€ã‚ã‚‹ã„ã¯ã‚¢ãƒ¼ã‚テクãƒãƒ£éžä¾å˜ãƒ‘ッ" "ケージを作るã¨ãã®ã¿å‹•ä½œã™ã‚‹ã‚ˆã†ã« override ターゲットを定義ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾" @@ -3725,17 +4023,18 @@ msgstr "" #: dh:75 msgid "" "As a special optimization, B<dh> will skip a target if it is completely " -"empty. This is mostly useful for override targets, where the command will " -"simply be skipped without the overhead of invoking a dummy target." +"empty and does not depend on any other target. This is mostly useful for " +"override targets, where the command will simply be skipped without the " +"overhead of invoking a dummy target." msgstr "" #. type: textblock -#: dh:79 +#: dh:80 msgid "Note that the target has to be completely empty for this to work:" msgstr "" #. type: verbatim -#: dh:81 +#: dh:82 #, no-wrap msgid "" " # Skip dh_bar - the good and optimized way\n" @@ -3745,7 +4044,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:86 +#: dh:87 #, no-wrap msgid "" " # Skip dh_foo - the slow way\n" @@ -3756,19 +4055,84 @@ msgid "" msgstr "" #. type: =head2 -#: dh:91 +#: dh:92 msgid "Verifying targets are picked up by dh" msgstr "" #. type: textblock -#: dh:93 +#: dh:94 +msgid "" +"As of debhelper 13.10, you can use L<dh_assistant(1)> to see which override " +"and hook targets will be seen by B<dh>. Here is an example run of " +"L<dh_assistant(1)> along with its output:" +msgstr "" + +#. type: verbatim +#: dh:98 +#, no-wrap +msgid "" +" $ dh_assistant detect-hook-targets\n" +" {\n" +" \"commands-not-in-path\": [\n" +" \"dh_foo\"\n" +" ],\n" +" \"hook-targets\": [\n" +" {\n" +" \"command\": \"dh_strip_nondeterminism\",\n" +" \"is-empty\": true,\n" +" \"package-section-param\": null,\n" +" \"target-name\": \"override_dh_strip_nondeterminism\"\n" +" },\n" +" {\n" +" \"command\": \"dh_foo\",\n" +" \"is-empty\": false,\n" +" \"package-section-param\": \"-a\",\n" +" \"target-name\": \"override_dh_foo-arch\"\n" +" }\n" +" ]\n" +" }\n" +"\n" +msgstr "" + +#. type: textblock +#: dh:119 +msgid "" +"The B<commands-not-in-path> is useful for spotting mistakes in the hook " +"target names. A non-empty value implies one of more hook targets are " +"related to a command that is either not installed or no command with that " +"name exists at all. It is generally worth double checking these." +msgstr "" + +#. type: textblock +#: dh:124 +msgid "" +"Additionally, the B<is-empty> attribute for each hook target can be used for " +"seeing whether a hook target triggers the L</Completely empty targets> " +"optimization." +msgstr "" + +#. type: textblock +#: dh:127 +msgid "" +"If you are interested in the other attributes, please read the " +"L<dh_assistant(1)> for the details." +msgstr "" + +#. type: =head3 +#: dh:130 +msgid "" +"Verifying targets are picked up by dh (when debhelper is older than 13.10)" +msgstr "" + +#. type: textblock +#: dh:134 msgid "" -"If you want to confirm that B<dh> has seen an override or a hook target, you " +"On older versions of debhelper, you have to use B<dh> with B<--no-act>. You " "can use the following command as an example:" msgstr "" #. type: verbatim -#: dh:96 +#: dh:137 #, no-wrap msgid "" " $ dh binary --no-act | grep dh_install | head -n5\n" @@ -3781,7 +4145,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:103 +#: dh:144 msgid "" "The B<debian/rules execute_after_dh_install> in the output, which signals " "that B<dh> registered a B<execute_after_dh_install> target and would run it " @@ -3789,7 +4153,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:107 +#: dh:148 msgid "" "Note that L</Completely empty targets> will be omitted in the listing " "above. This makes it a bit harder to spot as you are looking for the " @@ -3797,12 +4161,12 @@ msgid "" msgstr "" #. type: =head2 -#: dh:111 +#: dh:152 msgid "Caveats with hook targets and makefile conditionals" msgstr "" #. type: textblock -#: dh:113 +#: dh:154 msgid "" "If you choose to wrap a hook target in makefile conditionals, please be " "aware that B<dh> computes all the hook targets a head of time and caches the " @@ -3812,7 +4176,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:119 +#: dh:160 msgid "" "The parsing and caching I<often> happens before B<dh> knows whether it will " "build arch:any (-a) or/and arch:all (-i) packages, which can produce " @@ -3821,7 +4185,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:124 +#: dh:165 msgid "" "Most of the problems can be avoided by making the hook target unconditional " "and then have the \"body\" be partially or completely conditional. As an " @@ -3829,7 +4193,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:128 +#: dh:169 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. The hook target\n" @@ -3849,7 +4213,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:142 +#: dh:183 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -3869,7 +4233,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:157 +#: dh:198 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -3889,14 +4253,14 @@ msgid "" msgstr "" #. type: textblock -#: dh:171 +#: dh:212 msgid "" "These recipes are also relevant for conditional dependency targets, which " "are often seen in a variant of the following example:" msgstr "" #. type: verbatim -#: dh:174 +#: dh:215 #, no-wrap msgid "" " COND_TASKS =\n" @@ -3908,7 +4272,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:180 +#: dh:221 #, no-wrap msgid "" " maybe-run-this:\n" @@ -3917,7 +4281,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:183 +#: dh:224 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. Either the\n" @@ -3933,7 +4297,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:194 +#: dh:235 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -3950,7 +4314,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh:205 +#: dh:246 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -3963,36 +4327,36 @@ msgid "" msgstr "" #. type: textblock -#: dh:213 +#: dh:254 msgid "" "When in doubt, pick the relevant B<SIMPLE> case in the examples above that " "match your need." msgstr "" #. type: =head1 -#: dh:216 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 -#: dh_auto_install:46 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 -#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gconf:42 dh_gencontrol:38 -#: dh_icons:33 dh_install:69 dh_installcatalogs:56 dh_installchangelogs:71 -#: dh_installcron:43 dh_installdeb:100 dh_installdebconf:64 dh_installdirs:45 -#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:44 -#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:78 +#: dh:257 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 +#: dh_auto_install:52 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 +#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gencontrol:38 dh_icons:33 +#: dh_install:69 dh_installcatalogs:56 dh_installchangelogs:77 +#: dh_installcron:45 dh_installdeb:107 dh_installdebconf:64 dh_installdirs:45 +#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:48 +#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:77 #: dh_installinitramfs:43 dh_installlogcheck:45 dh_installlogrotate:25 #: dh_installman:86 dh_installmanpages:43 dh_installmenu:44 -#: dh_installmodules:41 dh_installpam:34 dh_installppp:38 dh_installudev:34 +#: dh_installmodules:41 dh_installpam:38 dh_installppp:38 dh_installudev:34 #: dh_installwm:41 dh_link:69 dh_makeshlibs:67 dh_md5sums:31 dh_movefiles:41 -#: dh_perl:34 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 -#: dh_usrlocal:50 dh_systemd_enable:83 dh_systemd_start:33 +#: dh_perl:35 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 +#: dh_usrlocal:50 dh_systemd_enable:82 dh_systemd_start:33 msgid "OPTIONS" msgstr "オプション" #. type: =item -#: dh:220 +#: dh:261 msgid "B<--with> I<addon>[B<,>I<addon> ...]" msgstr "B<--with> I<addon>[B<,>I<addon> ...]" #. type: textblock -#: dh:222 +#: dh:263 msgid "" "Add the debhelper commands specified by the given addon to appropriate " "places in the sequence of commands that is run. This option can be repeated " @@ -4008,7 +4372,7 @@ msgstr "" "ã«ã€ä¸€é€£ã®ã‚¢ãƒ‰ã‚ªãƒ³ç”¨ã‚¤ãƒ³ã‚¿ãƒ¼ãƒ•ã‚§ãƒ¼ã‚¹ã«ã¤ã„ã¦ã®ãƒ‰ã‚ュメントãŒã‚ã‚Šã¾ã™ã€‚" #. type: textblock -#: dh:229 +#: dh:270 msgid "" "A B<Build-Depends> relation on the package B<dh-sequence->I<addon> implies a " "B<--with> I<addon>. This avoids the need for an explicit B<--with> in " @@ -4020,7 +4384,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:238 +#: dh:279 msgid "" "Since debhelper 12.5, addons can also be activated in B<indep>-only mode " "(via B<Build-Depends-Indep>) or B<arch>-only mode (via B<Build-Depends-" @@ -4029,7 +4393,7 @@ msgid "" msgstr "" #. type: textblock -#: dh:244 +#: dh:285 msgid "" "Please note that addons activated via B<Build-Depends-Indep> or B<Build-" "Depends-Arch> are subject to additional limitations to ensure the result is " @@ -4040,12 +4404,12 @@ msgid "" msgstr "" #. type: =item -#: dh:252 +#: dh:293 msgid "B<--without> I<addon>" msgstr "B<--without> I<addon>" #. type: textblock -#: dh:254 +#: dh:295 msgid "" "The inverse of B<--with>, disables using the given addon. This option can be " "repeated more than once, or multiple addons to disable can be listed, " @@ -4055,19 +4419,19 @@ msgstr "" "ã—指定ã™ã‚‹ã“ã¨ã‚‚ã§ãã¾ã™ã—ã€ã‚¢ãƒ‰ã‚ªãƒ³åをカンマ区切りã§æŒ‡å®šã‚‚ã§ãã¾ã™ã€‚" #. type: textblock -#: dh:260 +#: dh:301 msgid "List all available addons." msgstr "利用å¯èƒ½ãªã‚¢ãƒ‰ã‚ªãƒ³ä¸€è¦§ã‚’表示ã™ã‚‹ã€‚" #. type: textblock -#: dh:262 +#: dh:303 msgid "" "When called only with this option, B<dh> can be called from any directory (i." "e. it does not need access to files from a source package)." msgstr "" #. type: textblock -#: dh:268 +#: dh:309 msgid "" "Prints commands that would run for a given sequence, but does not run them." msgstr "" @@ -4075,7 +4439,7 @@ msgstr "" "ã¯å®Ÿè¡Œã—ã¾ã›ã‚“。" #. type: textblock -#: dh:270 +#: dh:311 msgid "" "Note that dh normally skips running commands that it knows will do nothing. " "With --no-act, the full list of commands in a sequence is printed." @@ -4085,7 +4449,7 @@ msgstr "" "ã¦å‡ºåŠ›ã—ã¾ã™ã€‚" #. type: textblock -#: dh:275 +#: dh:316 msgid "" "Other options passed to B<dh> are passed on to each command it runs. This " "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for " @@ -4096,13 +4460,13 @@ msgstr "" "ãŸã€ä»–ã®ç‰¹åˆ¥ãªã‚ªãƒ—ションã«ã¤ã„ã¦ã‚‚åŒæ§˜ã¨ãªã‚Šã¾ã™ã€‚" #. type: =head1 -#: dh:279 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 +#: dh:320 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 #: dh_makeshlibs:185 dh_shlibdeps:78 msgid "EXAMPLES" msgstr "使用例" #. type: textblock -#: dh:281 +#: dh:322 msgid "" "To see what commands are included in a sequence, without actually doing " "anything:" @@ -4110,7 +4474,7 @@ msgstr "" "コマンドを実際ã«ã¯å‹•ä½œã•ã›ãšã€ä¸€é€£ã®å‹•ä½œã§ã©ã®ã‚³ãƒžãƒ³ãƒ‰ãŒå®Ÿè¡Œã•ã‚Œã‚‹ã‹ã‚’見る:" #. type: verbatim -#: dh:284 +#: dh:325 #, no-wrap msgid "" "\tdh binary-arch --no-act\n" @@ -4120,7 +4484,7 @@ msgstr "" "\n" #. type: textblock -#: dh:286 +#: dh:327 msgid "" "This is a very simple rules file, for packages where the default sequences " "of commands work with no additional options." @@ -4129,7 +4493,7 @@ msgstr "" "ション無ã—ã§ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã®ã‚³ãƒžãƒ³ãƒ‰ç¾¤ãŒå‘¼ã³å‡ºã•ã‚Œã¾ã™ã€‚" #. type: verbatim -#: dh:289 dh:296 dh:310 dh:323 dh:334 dh:392 dh:403 +#: dh:330 dh:337 dh:351 dh:364 dh:375 dh:433 dh:444 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4143,7 +4507,7 @@ msgstr "" "\n" #. type: textblock -#: dh:293 +#: dh:334 msgid "" "Often you'll want to pass an option to a specific debhelper command. The " "easy way to do with is by adding an override target for that command." @@ -4152,7 +4516,7 @@ msgstr "" "è¡Œã†æ–¹æ³•ã¯ã€ãã®ã‚³ãƒžãƒ³ãƒ‰ã¸ override ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§ã™ã€‚" #. type: verbatim -#: dh:300 +#: dh:341 #, fuzzy, no-wrap #| msgid "" #| "\toverride_dh_strip:\n" @@ -4168,7 +4532,7 @@ msgstr "" "\t\n" #. type: verbatim -#: dh:303 +#: dh:344 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4180,7 +4544,7 @@ msgstr "" "\n" #. type: textblock -#: dh:306 +#: dh:347 msgid "" "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> " "can't guess what to do for a strange package. Here's how to avoid running " @@ -4192,7 +4556,7 @@ msgstr "" "を実行ã•ã›ã‚‹æ–¹æ³•ã‚’示ã—ã¾ã™ã€‚ " #. type: verbatim -#: dh:314 +#: dh:355 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4204,7 +4568,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:317 +#: dh:358 #, no-wrap msgid "" "\toverride_dh_auto_build:\n" @@ -4216,7 +4580,7 @@ msgstr "" "\n" #. type: textblock -#: dh:320 +#: dh:361 msgid "" "Another common case is wanting to do something manually before or after a " "particular debhelper command is run." @@ -4225,7 +4589,7 @@ msgstr "" "ã—ãŸã„å ´åˆãŒã‚ã‚Šã¾ã™ã€‚" #. type: verbatim -#: dh:327 +#: dh:368 #, fuzzy, no-wrap #| msgid "" #| "\toverride_dh_fixperms:\n" @@ -4244,14 +4608,14 @@ msgstr "" "\n" #. type: textblock -#: dh:331 +#: dh:372 msgid "" "If you are on an older debhelper or compatibility level, the above example " "would have to be written as." msgstr "" #. type: verbatim -#: dh:338 +#: dh:379 #, fuzzy, no-wrap #| msgid "" #| "\toverride_dh_fixperms:\n" @@ -4271,7 +4635,7 @@ msgstr "" "\n" #. type: textblock -#: dh:343 +#: dh:384 #, fuzzy #| msgid "" #| "Python tools are not run by dh by default, due to the continual change in " @@ -4286,7 +4650,7 @@ msgstr "" "を実行ã—ã¾ã™)。ã“ã“ã§ã¯ã€B<dh_python2> ã‚’ã©ã®ã‚ˆã†ã«ã—ã¦ä½¿ã†ã‹ã‚’示ã—ã¾ã™ã€‚" #. type: verbatim -#: dh:346 +#: dh:387 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4300,7 +4664,7 @@ msgstr "" "\n" #. type: textblock -#: dh:350 +#: dh:391 msgid "" "Here is how to force use of Perl's B<Module::Build> build system, which can " "be necessary if debhelper wrongly detects that the package uses MakeMaker." @@ -4310,7 +4674,7 @@ msgstr "" "å¿…è¦ã¨ãªã‚Šã¾ã™ã€‚" #. type: verbatim -#: dh:354 +#: dh:395 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4324,7 +4688,7 @@ msgstr "" "\n" #. type: textblock -#: dh:358 +#: dh:399 msgid "" "Here is an example of overriding where the B<dh_auto_>I<*> commands find the " "package's source, for a package where the source is located in a " @@ -4335,7 +4699,7 @@ msgstr "" "ã™ã€‚" #. type: verbatim -#: dh:362 +#: dh:403 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4349,7 +4713,7 @@ msgstr "" "\n" #. type: textblock -#: dh:366 +#: dh:407 msgid "" "And here is an example of how to tell the B<dh_auto_>I<*> commands to build " "in a subdirectory, which will be removed on B<clean>." @@ -4359,7 +4723,7 @@ msgstr "" "ã«ãªã‚Šã¾ã™:" #. type: verbatim -#: dh:369 +#: dh:410 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4373,7 +4737,7 @@ msgstr "" "\n" #. type: textblock -#: dh:373 +#: dh:414 msgid "" "If your package can be built in parallel, please either use compat 10 or " "pass B<--parallel> to dh. Then B<dpkg-buildpackage -j> will work." @@ -4382,7 +4746,7 @@ msgstr "" "parallel> を指定ã—ã¦ä¸‹ã•ã„。ã™ã‚‹ã¨ B<dpkg-buildpackage -j> ãŒæœ‰åŠ¹ã«ãªã‚Šã¾ã™ã€‚" #. type: verbatim -#: dh:376 +#: dh:417 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4396,7 +4760,7 @@ msgstr "" "\n" #. type: textblock -#: dh:380 +#: dh:421 msgid "" "If your package cannot be built reliably while using multiple threads, " "please pass B<--no-parallel> to dh (or the relevant B<dh_auto_>I<*> command):" @@ -4405,7 +4769,7 @@ msgstr "" "連ã™ã‚‹ B<dh_auto_>I<*> コマンド)ã« B<--no-parallel> を指定ã—ã¦ä¸‹ã•ã„。" #. type: verbatim -#: dh:385 +#: dh:426 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4419,7 +4783,7 @@ msgstr "" "\n" #. type: textblock -#: dh:389 +#: dh:430 msgid "" "Here is a way to prevent B<dh> from running several commands that you don't " "want it to run, by defining empty override targets for each command." @@ -4429,7 +4793,7 @@ msgstr "" "ã¨ã«ã‚ˆã‚Šè¡Œã„ã¾ã™ã€‚" #. type: verbatim -#: dh:396 +#: dh:437 #, no-wrap msgid "" "\t# Commands not to run:\n" @@ -4441,7 +4805,7 @@ msgstr "" "\n" #. type: textblock -#: dh:399 +#: dh:440 msgid "" "A long build process for a separate documentation package can be separated " "out using architecture independent overrides. These will be skipped when " @@ -4452,79 +4816,231 @@ msgstr "" "ãã¾ã™ã€‚ã“ã†ã™ã‚‹ã¨ã€build-arch ã‚„ binary-arch を実行ã™ã‚‹ã¨ãã€ãƒ‰ã‚ュメント" "パッケージã®ãƒ“ルドãŒçœç•¥ã•ã‚Œã¾ã™ã€‚" -#. type: verbatim -#: dh:407 -#, no-wrap +#. type: verbatim +#: dh:448 +#, no-wrap +msgid "" +"\toverride_dh_auto_build-indep:\n" +"\t\t$(MAKE) -C docs\n" +"\n" +msgstr "" +"\toverride_dh_auto_build-indep:\n" +"\t\t$(MAKE) -C docs\n" +"\n" + +#. type: verbatim +#: dh:451 +#, no-wrap +msgid "" +"\t# No tests needed for docs\n" +"\toverride_dh_auto_test-indep:\n" +"\n" +msgstr "" +"\t# doc ターゲット実行時ã¯ãƒ†ã‚¹ãƒˆã¯ä¸è¦\n" +"\toverride_dh_auto_test-indep:\n" +"\n" + +#. type: verbatim +#: dh:454 +#, no-wrap +msgid "" +"\toverride_dh_auto_install-indep:\n" +"\t\t$(MAKE) -C docs install\n" +"\n" +msgstr "" +"\toverride_dh_auto_install-indep:\n" +"\t\t$(MAKE) -C docs install\n" +"\n" + +#. type: textblock +#: dh:457 +msgid "" +"Adding to the example above, suppose you need to chmod a file, but only when " +"building the architecture dependent package, as it's not present when " +"building only documentation." +msgstr "" +"上ã®ä¾‹ã«åŠ ãˆã€ãƒ•ã‚¡ã‚¤ãƒ«ã« chmod を実行ã—ãªã‘ã‚Œã°ãªã‚‰ãªã„ãŒãã‚Œã¯ã‚¢ãƒ¼ã‚テクãƒãƒ£" +"ä¾å˜ãƒ‘ッケージをビルドã™ã‚‹éš›ã®ã¿å¿…è¦ã§ã€ãƒ‰ã‚ュメントã®ã¿ã‚’ビルドã™ã‚‹æ™‚ã«ã¯å®Ÿ" +"è¡Œã—ãªã„ã¨ã—ãŸã‚‰ã©ã†ãªã‚‹ã§ã—ょã†ã‹ã€‚" + +#. type: verbatim +#: dh:461 +#, fuzzy, no-wrap +#| msgid "" +#| "\toverride_dh_fixperms:\n" +#| "\t\tdh_fixperms\n" +#| "\t\tchmod 4755 debian/foo/usr/bin/foo\n" +#| "\n" +msgid "" +"\t# Example assumes debhelper/12.8 and compat 10+\n" +"\texecute_after_dh_fixperms-arch:\n" +"\t\tchmod 4755 debian/foo/usr/bin/foo\n" +"\n" +msgstr "" +"\toverride_dh_fixperms:\n" +"\t\tdh_fixperms\n" +"\t\tchmod 4755 debian/foo/usr/bin/foo\n" +"\n" + +#. type: =head1 +#: dh:465 +#, fuzzy +#| msgid "DEBHELPER COMMANDS" +msgid "DEBHELPER PROVIDED DH ADDONS" +msgstr "DEBHELPER コマンド" + +#. type: textblock +#: dh:467 +msgid "" +"The primary purpose of B<dh> addons is to provide easy integration with " +"third-party provided features for debhelper. However, debhelper itself also " +"provide a few sequences that can be useful in some cases. These are " +"documented in this list:" +msgstr "" + +#. type: =item +#: dh:474 +msgid "build-stamp" +msgstr "" + +#. type: textblock +#: dh:476 +msgid "" +"A special addon for controlling whether B<dh> (in compat 10 or later) will " +"create stamp files to tell whether the build target has been run " +"successfully. See L</INTERNALS> for more details." +msgstr "" + +#. type: textblock +#: dh:480 +#, fuzzy +#| msgid "The previous behaviour can restored by using B<--with build-stamp>" +msgid "" +"This addon is active by default but can disabled by using B<dh $@ --without " +"build-stamp>" +msgstr "B<--with build-stamp> を使ãˆã°ä»¥å‰ã®å‹•ä½œã«æˆ»ã™ã“ã¨ãŒå‡ºæ¥ã¾ã™ã€‚" + +#. type: =item +#: dh:483 +msgid "dwz (obsolete)" +msgstr "" + +#. type: textblock +#: dh:485 +msgid "" +"Adds L<dh_dwz(1)> to the sequence in compat level 11 or below. Obsolete in " +"compat 12 or later." +msgstr "" + +#. type: =item +#: dh:488 +msgid "elf-tools" +msgstr "" + +#. type: textblock +#: dh:490 +msgid "" +"This addon adds tools related to ELF files to the sequence such as " +"L<dh_strip(1)> and L<dh_shlibdeps(1)>" +msgstr "" + +#. type: textblock +#: dh:493 +msgid "" +"This addon is I<conditionally> active by default for architecture specific " +"packages - that is, it is skipped for arch:all packages. In the special " +"case where you need these tools to work on arch:all packages, you can use " +"B<--with elf-tools> to activate it unconditionally." +msgstr "" + +#. type: =item +#: dh:499 +msgid "installinitramfs (obsolete)" +msgstr "" + +#. type: textblock +#: dh:501 +msgid "" +"Adds L<dh_installinitramfs(1)> to the sequence in compat level 11 or below. " +"Obsolete in compat 12 or later." +msgstr "" + +#. type: =item +#: dh:504 +msgid "root-sequence (internal)" +msgstr "" + +#. type: textblock +#: dh:506 +msgid "This is reserved for internal usage." +msgstr "" + +#. type: =item +#: dh:508 +msgid "single-binary" +msgstr "" + +#. type: textblock +#: dh:510 +msgid "" +"A special-purpose addon that makes debhelper run in \"single binary\" mode." +msgstr "" + +#. type: textblock +#: dh:512 msgid "" -"\toverride_dh_auto_build-indep:\n" -"\t\t$(MAKE) -C docs\n" -"\n" +"When active, it will pass B<< --destdir=debian/I<package>/ >> to " +"L<dh_auto_install(1)>. This makes every file \"installed\" by the upstream " +"build system part of the (only) binary package by default without having to " +"use other helpers such as L<dh_install(1)>." msgstr "" -"\toverride_dh_auto_build-indep:\n" -"\t\t$(MAKE) -C docs\n" -"\n" -#. type: verbatim -#: dh:410 -#, no-wrap +#. type: textblock +#: dh:517 msgid "" -"\t# No tests needed for docs\n" -"\toverride_dh_auto_test-indep:\n" -"\n" +"The addon will refuse to activate when the source package lists 2 or more " +"binary packages in F<debian/control> as a precaution." msgstr "" -"\t# doc ターゲット実行時ã¯ãƒ†ã‚¹ãƒˆã¯ä¸è¦\n" -"\toverride_dh_auto_test-indep:\n" -"\n" -#. type: verbatim -#: dh:413 -#, no-wrap +#. type: textblock +#: dh:520 msgid "" -"\toverride_dh_auto_install-indep:\n" -"\t\t$(MAKE) -C docs install\n" -"\n" +"Before compat 15. this behaviour was the default when there was only a " +"single binary package listed in F<debian/control>. In compat 15 and later, " +"this addon must explicitly be activated for this feature to work." msgstr "" -"\toverride_dh_auto_install-indep:\n" -"\t\t$(MAKE) -C docs install\n" -"\n" #. type: textblock -#: dh:416 +#: dh:524 msgid "" -"Adding to the example above, suppose you need to chmod a file, but only when " -"building the architecture dependent package, as it's not present when " -"building only documentation." +"The rationale for requiring this as an explicit choice is that if it is " +"implicit then debhelper will silently change behaviour on adding a new " +"binary package. This has caused many RC bugs when maintainers renamed a " +"binary and added transitional packages with the intention of supporting " +"seamless upgrades. The result would often be two empty binary packages that " +"were uploaded to archive with users frustrated as their \"upgrade\" removed " +"their programs." msgstr "" -"上ã®ä¾‹ã«åŠ ãˆã€ãƒ•ã‚¡ã‚¤ãƒ«ã« chmod を実行ã—ãªã‘ã‚Œã°ãªã‚‰ãªã„ãŒãã‚Œã¯ã‚¢ãƒ¼ã‚テクãƒãƒ£" -"ä¾å˜ãƒ‘ッケージをビルドã™ã‚‹éš›ã®ã¿å¿…è¦ã§ã€ãƒ‰ã‚ュメントã®ã¿ã‚’ビルドã™ã‚‹æ™‚ã«ã¯å®Ÿ" -"è¡Œã—ãªã„ã¨ã—ãŸã‚‰ã©ã†ãªã‚‹ã§ã—ょã†ã‹ã€‚" -#. type: verbatim -#: dh:420 -#, fuzzy, no-wrap -#| msgid "" -#| "\toverride_dh_fixperms:\n" -#| "\t\tdh_fixperms\n" -#| "\t\tchmod 4755 debian/foo/usr/bin/foo\n" -#| "\n" +#. type: =item +#: dh:532 +msgid "systemd (obsolete)" +msgstr "" + +#. type: textblock +#: dh:534 msgid "" -"\t# Example assumes debhelper/12.8 and compat 10+\n" -"\texecute_after_dh_fixperms-arch:\n" -"\t\tchmod 4755 debian/foo/usr/bin/foo\n" -"\n" +"Adds L<dh_systemd_enable(1)> and L<dh_systemd_start(1)> to the sequence in " +"compat level 10 or below. Obsolete in compat 11 or later." msgstr "" -"\toverride_dh_fixperms:\n" -"\t\tdh_fixperms\n" -"\t\tchmod 4755 debian/foo/usr/bin/foo\n" -"\n" #. type: =head1 -#: dh:424 +#: dh:539 msgid "INTERNALS" msgstr "内部動作" #. type: textblock -#: dh:426 +#: dh:541 msgid "" "If you're curious about B<dh>'s internals, here's how it works under the " "hood." @@ -4533,7 +5049,7 @@ msgstr "" "を記載ã—ã¾ã™ã€‚" #. type: textblock -#: dh:428 +#: dh:543 #, fuzzy #| msgid "" #| "In compat 10 (or later), B<dh> creates a stamp file F<debian/debhelper-" @@ -4558,7 +5074,7 @@ msgstr "" "ã¾ã™ã€‚" #. type: textblock -#: dh:436 +#: dh:551 #, fuzzy #| msgid "" #| "In compat 10 (or later), B<dh> creates a stamp file F<debian/debhelper-" @@ -4581,7 +5097,7 @@ msgstr "" "ã¾ã™ã€‚" #. type: textblock -#: dh:441 +#: dh:556 msgid "" "In compat 9 or earlier, each debhelper command will record when it's " "successfully run in F<debian/package.debhelper.log>. (Which B<dh_clean> " @@ -4595,7 +5111,7 @@ msgstr "" "ã‹ã‚Šã¾ã™ã€‚" #. type: textblock -#: dh:446 +#: dh:561 #, fuzzy #| msgid "" #| "Each time B<dh> is run (in compat 9 or earlier), it examines the log, and " @@ -4615,7 +5131,7 @@ msgstr "" "互æ›æ€§ãƒ¬ãƒ™ãƒ« 10 ã§ã¯ã“れらã¯å‰Šé™¤ã•ã‚Œã¦ã„ã¾ã™)。" #. type: textblock -#: dh:450 +#: dh:565 msgid "" "A sequence can also run dependent targets in debian/rules. For example, the " "\"binary\" sequence runs the \"install\" target." @@ -4625,7 +5141,7 @@ msgstr "" "ã¨ã€\"install\" ターゲットも実行ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh:453 +#: dh:568 msgid "" "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass " "information through to debhelper commands that are run inside override " @@ -4638,7 +5154,7 @@ msgstr "" "ãŠã‚Šã€ã©ã®æ™‚点ã§ã‚‚ debhelper コマンドã®å‹•ä½œã«å½±éŸ¿ã‚’与ãˆã¾ã™ã€‚" #. type: textblock -#: dh:458 +#: dh:573 msgid "" "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> " "sequences are passed the B<-i> option to ensure they only work on " @@ -4653,19 +5169,19 @@ msgstr "" "ã‚Œã€ã‚¢ãƒ¼ã‚テクãƒãƒ£ä¾å˜ãƒ‘ッケージã«ã®ã¿ç¢ºå®Ÿã«ä½œç”¨ã™ã‚‹ã‚ˆã†ã«å‹•ä½œã—ã¾ã™ã€‚ " #. type: textblock -#: dh:737 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 -#: dh_auto_install:101 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:186 -#: dh_clean:193 dh_compress:246 dh_dwz:165 dh_fixperms:168 dh_gconf:109 -#: dh_gencontrol:212 dh_icons:79 dh_install:381 dh_installchangelogs:304 -#: dh_installcron:82 dh_installdeb:416 dh_installdebconf:132 dh_installdirs:135 -#: dh_installdocs:458 dh_installemacsen:143 dh_installexamples:182 -#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:434 -#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:421 +#: dh:876 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 +#: dh_auto_install:107 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:180 +#: dh_clean:193 dh_compress:247 dh_dwz:167 dh_fixperms:168 dh_gencontrol:212 +#: dh_icons:79 dh_install:381 dh_installchangelogs:369 dh_installcron:84 +#: dh_installdeb:423 dh_installdebconf:237 dh_installdirs:135 +#: dh_installdocs:441 dh_installemacsen:143 dh_installexamples:186 +#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:417 +#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:424 #: dh_installmanpages:202 dh_installmenu:94 dh_installmime:67 -#: dh_installmodules:113 dh_installpam:66 dh_installppp:72 dh_installudev:106 -#: dh_installwm:136 dh_installxfonts:94 dh_link:170 dh_lintian:64 +#: dh_installmodules:113 dh_installpam:75 dh_installppp:72 dh_installudev:106 +#: dh_installwm:134 dh_installxfonts:94 dh_link:170 dh_lintian:64 #: dh_listpackages:38 dh_makeshlibs:460 dh_md5sums:122 dh_movefiles:165 -#: dh_perl:178 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 +#: dh_perl:192 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 #: dh_testroot:97 dh_usrlocal:140 msgid "This program is a part of debhelper." msgstr "ã“ã®ãƒ—ãƒã‚°ãƒ©ãƒ 㯠debhelper ã®ä¸€éƒ¨ã§ã™ã€‚" @@ -4712,7 +5228,7 @@ msgstr "" "ã—ã¦ã€ãƒ“ルド作æ¥ã‚’手動ã§å®Ÿè¡Œã—ã¦ãã ã•ã„。" #. type: textblock -#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:48 +#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:54 #: dh_auto_test:36 msgid "" "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build " @@ -4722,9 +5238,9 @@ msgstr "" "ムã¨ã€åˆ¶å¾¡ã‚ªãƒ—ションãŒåˆ—挙ã•ã‚Œã¦ã„ã¾ã™ã€‚" #. type: =item -#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:59 +#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:65 #: dh_auto_test:41 dh_builddeb:48 dh_dwz:62 dh_gencontrol:42 -#: dh_installdebconf:72 dh_installinit:167 dh_makeshlibs:179 dh_shlibdeps:41 +#: dh_installdebconf:72 dh_installinit:166 dh_makeshlibs:179 dh_shlibdeps:41 msgid "B<--> I<params>" msgstr "B<--> I<params>" @@ -4896,11 +5412,28 @@ msgstr "" #. type: textblock #: dh_auto_install:32 msgid "" -"Unless B<--destdir> option is specified, the files are installed into debian/" -"I<package>/ if there is only one binary package. In the multiple binary " -"package case, the files are instead installed into F<debian/tmp/>, and " -"should be moved from there to the appropriate package build directory using " -"L<dh_install(1)>." +"In compat 15 or later, B<dh_auto_install> will use F<debian/tmp> as the " +"default B<--destdir> and should be moved from there to the appropriate " +"package build directory using L<dh_install(1)> or similar tools. Though if " +"the B<single-binary> addon for L<dh(1)> is activated, then it will pass an " +"explicit B<< --destdir=debian/I<package>/ >> to B<dh_auto_install>." +msgstr "" + +#. type: textblock +#: dh_auto_install:38 +#, fuzzy +#| msgid "" +#| "Unless B<--destdir> option is specified, the files are installed into " +#| "debian/I<package>/ if there is only one binary package. In the multiple " +#| "binary package case, the files are instead installed into F<debian/tmp/>, " +#| "and should be moved from there to the appropriate package build directory " +#| "using L<dh_install(1)>." +msgid "" +"For earlier compat levels then unless B<--destdir> option is specified, the " +"files are installed into debian/I<package>/ if there is only one binary " +"package. In the multiple binary package case, the files are instead " +"installed into F<debian/tmp/>, and should be moved from there to the " +"appropriate package build directory using L<dh_install(1)> or similar tools." msgstr "" "B<--destdir> オプションを指定ã›ãšå˜ä¸€ã®ãƒã‚¤ãƒŠãƒªã®ã¿ç”Ÿæˆã™ã‚‹å ´åˆã€ãƒ•ã‚¡ã‚¤ãƒ«ã¯ " "debian/I<package>/ 以下ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚ã¾ãŸã€B<--destdir> オプション" @@ -4909,7 +5442,7 @@ msgstr "" "を使ã£ã¦é©åˆ‡ãªãƒ‘ッケージビルドディレクトリã«ç§»å‹•ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #. type: textblock -#: dh_auto_install:38 +#: dh_auto_install:44 msgid "" "B<DESTDIR> is used to tell make where to install the files. If the Makefile " "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set " @@ -4921,7 +5454,7 @@ msgstr "" "ã¨ã—ã¦æŒ‡å®šã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_auto_install:42 +#: dh_auto_install:48 msgid "" "This is intended to work for about 90% of packages. If it doesn't work, or " "tries to use the wrong install target, you're encouraged to skip using " @@ -4933,12 +5466,12 @@ msgstr "" "è¡Œã™ã‚‹ã“ã¨ã‚’推奨ã—ã¾ã™ã€‚" #. type: =item -#: dh_auto_install:53 dh_builddeb:38 +#: dh_auto_install:59 dh_builddeb:38 msgid "B<--destdir=>I<directory>" msgstr "B<--destdir=>I<directory>" #. type: textblock -#: dh_auto_install:55 +#: dh_auto_install:61 msgid "" "Install files into the specified I<directory>. If this option is not " "specified, destination directory is determined automatically as described in " @@ -4949,7 +5482,7 @@ msgstr "" "ã«è‡ªå‹•çš„ã«æŒ‡å®šã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_auto_install:61 +#: dh_auto_install:67 msgid "" "Pass I<params> to the program that is run, after the parameters that " "B<dh_auto_install> usually passes." @@ -5045,8 +5578,8 @@ msgstr "" "トリã¸ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã™ã‚‹ debhelper プãƒã‚°ãƒ©ãƒ ã§ã™ã€‚" #. type: =head1 -#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_gconf:26 dh_install:40 -#: dh_installcatalogs:39 dh_installchangelogs:47 dh_installcron:24 +#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_install:40 +#: dh_installcatalogs:39 dh_installchangelogs:53 dh_installcron:24 #: dh_installdeb:25 dh_installdebconf:37 dh_installdirs:28 dh_installdocs:40 #: dh_installemacsen:30 dh_installexamples:31 dh_installifupdown:25 #: dh_installinfo:28 dh_installinit:41 dh_installinitramfs:30 @@ -5309,8 +5842,8 @@ msgstr "" "ã‚ã‚Šã¾ã™>。ã“れらã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªå†…ã®å†…容ã¯åŒæ§˜ã«å‰Šé™¤ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:95 -#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:39 dh_installinfo:36 +#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:102 +#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:43 dh_installinfo:36 #: dh_installman:81 dh_installwm:36 dh_link:64 msgid "" "Supports substitution variables in compat 13 and later as documented in " @@ -5318,7 +5851,7 @@ msgid "" msgstr "" #. type: =item -#: dh_clean:53 dh_installchangelogs:75 +#: dh_clean:53 dh_installchangelogs:81 msgid "B<-k>, B<--keep>" msgstr "B<-k>, B<--keep>" @@ -5482,7 +6015,7 @@ msgstr "" "ル全ã¦ã‚’圧縮ã—ã¾ã™ã€‚" #. type: =item -#: dh_compress:68 dh_installdocs:184 dh_installexamples:85 dh_installinfo:60 +#: dh_compress:68 dh_installdocs:184 dh_installexamples:89 dh_installinfo:60 #: dh_installmanpages:47 dh_movefiles:58 dh_testdir:30 msgid "I<file> ..." msgstr "I<file> ..." @@ -5493,7 +6026,7 @@ msgid "Add these files to the list of files to compress." msgstr "ã“れらファイルを圧縮対象ã®ãƒ•ã‚¡ã‚¤ãƒ«ã¨ã—ã¦è¿½åŠ ã—ã¾ã™ã€‚" #. type: =head1 -#: dh_compress:74 dh_perl:64 dh_strip:133 dh_usrlocal:66 +#: dh_compress:74 dh_perl:65 dh_strip:133 dh_usrlocal:66 msgid "CONFORMS TO" msgstr "確èªã™ã¹ã事" @@ -5690,86 +6223,6 @@ msgstr "" "パーミッションã®å¤‰æ›´å¯¾è±¡ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‹ã‚‰ã€I<item> をファイルåã®ä¸€éƒ¨ã«æŒã¤ã‚‚ã®" "を除外ã—ã¾ã™ã€‚除外対象を列挙ã—ãŸã„å ´åˆã¯ã€ã“ã®ã‚ªãƒ—ションを複数回指定ã—ã¾ã™ã€‚" -#. type: textblock -#: dh_gconf:5 -#, fuzzy -#| msgid "dh_gconf - install GConf defaults files and register schemas" -msgid "" -"dh_gconf - install GConf defaults files and register schemas (deprecated)" -msgstr "" -"dh_gconf - GConf デフォルトファイルをインストールã—ã€ã‚¹ã‚ーマã«ç™»éŒ²ã™ã‚‹" - -#. type: textblock -#: dh_gconf:17 -msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" -msgstr "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" - -#. type: textblock -#: dh_gconf:21 -msgid "" -"B<dh_gconf> is a debhelper program that is responsible for installing GConf " -"defaults files and registering GConf schemas." -msgstr "" -"B<dh_gconf> 㯠GConf 用デフォルトファイルをインストールã—ã€GConf スã‚ーマã«ç™»" -"録ã™ã‚‹å½¹å‰²ã‚’担ㆠdebhelper プãƒã‚°ãƒ©ãƒ ã§ã™ã€‚" - -#. type: textblock -#: dh_gconf:24 -msgid "" -"An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>." -msgstr "gconf2 ã«é–¢ã™ã‚‹é©åˆ‡ãªä¾å˜é–¢ä¿‚㌠B<${misc:Depends}> ã«ç”Ÿæˆã•ã‚Œã¾ã™ã€‚" - -#. type: =item -#: dh_gconf:30 -msgid "debian/I<package>.gconf-defaults" -msgstr "debian/I<package>.gconf-defaults" - -#. type: textblock -#: dh_gconf:32 -msgid "" -"Installed into F<usr/share/gconf/defaults/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" -"パッケージビルドディレクトリã«ã‚ã‚‹ F<usr/share/gconf/defaults/10_package> ã¸" -"インストールãŒè¡Œã‚ã‚Œã¾ã™ã€‚ãªãŠã€I<package> ã¯ãƒ‘ッケージåã§ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚" - -#. type: =item -#: dh_gconf:35 -msgid "debian/I<package>.gconf-mandatory" -msgstr "debian/I<package>.gconf-mandatory" - -#. type: textblock -#: dh_gconf:37 -msgid "" -"Installed into F<usr/share/gconf/mandatory/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" -"パッケージビルドディレクトリã«ã‚ã‚‹ F<usr/share/gconf/mandatory/10_package> ã«" -"インストールã•ã‚Œã¾ã™ã€‚ãªãŠã€I<package> ã¯ãƒ‘ッケージåã§ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚" - -#. type: =item -#: dh_gconf:46 -msgid "B<--priority> I<priority>" -msgstr "B<--priority> I<priority>" - -#. type: textblock -#: dh_gconf:48 -msgid "" -"Use I<priority> (which should be a 2-digit number) as the defaults priority " -"instead of B<10>. Higher values than ten can be used by derived " -"distributions (B<20>), CDD distributions (B<50>), or site-specific packages " -"(B<90>)." -msgstr "" -"I<priority> (ã“ã‚Œã¯2æ¡ã®æ•°å—ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™) をデフォルトã®å„ªå…ˆé †ä½ã§ã‚" -"ã‚‹ B<10> ã®ä»£ã‚ã‚Šã«åˆ©ç”¨ã—ã¾ã™ã€‚用途ã«ã‚ˆã£ã¦ã¯ 10 より大ããªå€¤ã‚’利用ã™ã‚‹ã“ã¨ãŒ" -"ã§ãã¾ã™ã€‚例ãˆã°ã€æ´¾ç”Ÿãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューションã®å ´åˆ (B<20>)ã€CDD ディストリ" -"ビューション (B<50>)ã€ã‚ã‚‹ã„ã¯ã‚µã‚¤ãƒˆç‹¬è‡ªã®ãƒ‘ッケージ (B<90>) ã¨ãªã‚Šã¾ã™ã€‚" - -#. type: textblock -#: dh_gconf:113 -msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" -msgstr "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" - #. type: textblock #: dh_gencontrol:5 msgid "dh_gencontrol - generate and install control file" @@ -5871,7 +6324,7 @@ msgstr "" #. type: =item #: dh_icons:37 dh_installcatalogs:60 dh_installdebconf:68 dh_installemacsen:60 -#: dh_installinit:82 dh_installinitramfs:47 dh_installmenu:48 +#: dh_installinit:81 dh_installinitramfs:47 dh_installmenu:48 #: dh_installmodules:45 dh_installwm:51 dh_makeshlibs:147 dh_usrlocal:54 msgid "B<-n>, B<--no-scripts>" msgstr "B<-n>, B<--no-scripts>" @@ -6054,7 +6507,7 @@ msgid "" msgstr "" #. type: =item -#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:53 +#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:57 #: dh_installinfo:50 dh_installman:100 dh_movefiles:45 msgid "B<--sourcedir=>I<dir>" msgstr "B<--sourcedir=>I<dir>" @@ -6317,7 +6770,7 @@ msgstr "" "ãƒªã‚¬ãƒ¼ã‚’è¿½åŠ ã—ãªã„ã§ãã ã•ã„。" #. type: textblock -#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:207 +#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:206 #: dh_installmodules:59 dh_installudev:52 dh_installwm:68 dh_usrlocal:62 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " @@ -6346,16 +6799,20 @@ msgstr "" "dh_installchangelogs - ビルドディレクトリ㫠changelog をインストールã™ã‚‹" #. type: textblock -#: dh_installchangelogs:17 +#: dh_installchangelogs:18 +#, fuzzy +#| msgid "" +#| "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " +#| "[I<upstream>]" msgid "" "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " -"[I<upstream>]" +"[B<--no-trim>] [I<upstream>]" msgstr "" "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " "[I<upstream>]" #. type: textblock -#: dh_installchangelogs:21 +#: dh_installchangelogs:22 msgid "" "B<dh_installchangelogs> is a debhelper program that is responsible for " "installing changelogs into package build directories." @@ -6364,7 +6821,7 @@ msgstr "" "トールを担当ã™ã‚‹ debhelper コマンドã§ã™ã€‚" #. type: textblock -#: dh_installchangelogs:24 +#: dh_installchangelogs:25 #, fuzzy #| msgid "" #| "An upstream F<changelog> file may be specified as an option. If none is " @@ -6380,7 +6837,7 @@ msgstr "" "è¡Œãã¾ã™ (ã“ã‚Œã¯äº’æ›ãƒ¬ãƒ™ãƒ« v7 以上ã§è¡Œã‚ã‚Œã¾ã™)。" #. type: textblock -#: dh_installchangelogs:28 +#: dh_installchangelogs:29 msgid "" "In non-native packages, B<dh_installchangelogs> will first look for " "changelog files installed by the upstream build system into F<< usr/share/" @@ -6395,7 +6852,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installchangelogs:40 +#: dh_installchangelogs:41 #, fuzzy msgid "" "If a changelog file is specified and is an F<html> file (determined by file " @@ -6410,28 +6867,37 @@ msgstr "" "ストールã•ã‚Œã¾ã™ã€‚html changelog ãŒå¹³æ–‡ãƒ†ã‚ストã«å¤‰æ›ã•ã‚Œã‚‹ã¨ã€äºœç¨®ã¯ï¼’番ã‚" "ã® upstream changelog ファイルã¨ã—ã¦æŒ‡å®šã§ãã¾ã™ã€‚平文ã§ã¯ãªã„" +#. type: textblock +#: dh_installchangelogs:48 +msgid "" +"The B<debchange>-style Debian changelogs are trimmed to include only entries " +"more recent than the release date of I<oldstable>. No trimming will be " +"performed if the B<--no-trim> option is passed or if the " +"B<DEB_BUILD_OPTIONS> environment variable contains B<notrimdch>." +msgstr "" + #. type: =item -#: dh_installchangelogs:51 +#: dh_installchangelogs:57 msgid "F<debian/changelog>" msgstr "F<debian/changelog>" #. type: =item -#: dh_installchangelogs:53 +#: dh_installchangelogs:59 msgid "F<debian/NEWS>" msgstr "F<debian/NEWS>" #. type: =item -#: dh_installchangelogs:55 +#: dh_installchangelogs:61 msgid "debian/I<package>.changelog" msgstr "debian/I<package>.changelog" #. type: =item -#: dh_installchangelogs:57 +#: dh_installchangelogs:63 msgid "debian/I<package>.NEWS" msgstr "debian/I<package>.NEWS" #. type: textblock -#: dh_installchangelogs:59 +#: dh_installchangelogs:65 msgid "" "Automatically installed into usr/share/doc/I<package>/ in the package build " "directory." @@ -6440,7 +6906,7 @@ msgstr "" "I<package>/ é…下ã«è‡ªå‹•çš„ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_installchangelogs:62 +#: dh_installchangelogs:68 msgid "" "Use the package specific name if I<package> needs a different F<NEWS> or " "F<changelog> file." @@ -6449,7 +6915,7 @@ msgstr "" "ã¯ã€ãƒ‘ッケージ固有ã®åå‰ã‚’指定ã—ã¦ãã ã•ã„。" #. type: textblock -#: dh_installchangelogs:65 +#: dh_installchangelogs:71 msgid "" "The F<changelog> file is installed with a name of changelog for native " "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file " @@ -6460,7 +6926,7 @@ msgstr "" "ルã•ã‚Œã¾ã™ã€‚F<NEWS> ã¯å¿…ãš F<NEWS.Debian> ã®åå‰ã§ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_installchangelogs:77 +#: dh_installchangelogs:83 #, fuzzy msgid "" "Keep the original name of the upstream changelog. This will be accomplished " @@ -6477,7 +6943,7 @@ msgstr "" "利ã‹ã‚‚ã—ã‚Œã¾ã›ã‚“。" #. type: textblock -#: dh_installchangelogs:85 +#: dh_installchangelogs:91 msgid "" "Exclude upstream F<changelog> files that contain I<item> anywhere in their " "filename from being installed." @@ -6486,17 +6952,31 @@ msgstr "" "トール候補ã‹ã‚‰é™¤å¤–ã—ã¾ã™ã€‚" #. type: textblock -#: dh_installchangelogs:88 +#: dh_installchangelogs:94 msgid "Note that directory name of the changelog is also part of the match." msgstr "" #. type: =item -#: dh_installchangelogs:90 +#: dh_installchangelogs:96 +#, fuzzy +#| msgid "B<--no-start>" +msgid "B<--no-trim>" +msgstr "B<--no-start>" + +#. type: textblock +#: dh_installchangelogs:98 +msgid "" +"Install the full changelog, not its trimmed version that includes only " +"recent entries." +msgstr "" + +#. type: =item +#: dh_installchangelogs:101 msgid "I<upstream>" msgstr "I<upstream>" #. type: textblock -#: dh_installchangelogs:92 +#: dh_installchangelogs:103 msgid "Install this file as the upstream changelog." msgstr "" "ã“ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’開発元 (upstream) ã® changelog ã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã—ã¾ã™ã€‚" @@ -6537,16 +7017,23 @@ msgstr "debian/I<package>.cron.monthly" #. type: =item #: dh_installcron:34 +#, fuzzy +#| msgid "debian/I<package>.cron.daily" +msgid "debian/I<package>.cron.yearly" +msgstr "debian/I<package>.cron.daily" + +#. type: =item +#: dh_installcron:36 msgid "debian/I<package>.cron.hourly" msgstr "debian/I<package>.cron.hourly" #. type: =item -#: dh_installcron:36 +#: dh_installcron:38 msgid "debian/I<package>.cron.d" msgstr "debian/I<package>.cron.d" #. type: textblock -#: dh_installcron:38 +#: dh_installcron:40 msgid "" "Installed into the appropriate F<etc/cron.*/> directory in the package build " "directory." @@ -6555,14 +7042,14 @@ msgstr "" "れインストールã•ã‚Œã¾ã™ã€‚" #. type: =item -#: dh_installcron:47 dh_installifupdown:46 dh_installinit:175 +#: dh_installcron:49 dh_installifupdown:46 dh_installinit:174 #: dh_installlogcheck:49 dh_installlogrotate:29 dh_installmodules:49 -#: dh_installpam:38 dh_installppp:42 dh_installudev:38 dh_systemd_enable:95 +#: dh_installpam:42 dh_installppp:42 dh_installudev:38 dh_systemd_enable:94 msgid "B<--name=>I<name>" msgstr "B<--name=>I<name>" #. type: textblock -#: dh_installcron:49 +#: dh_installcron:51 #, fuzzy msgid "" "Look for files named F<debian/package.name.cron.*> and install them as F<etc/" @@ -6668,17 +7155,17 @@ msgstr "I<package>.conffiles" #. type: textblock #: dh_installdeb:59 msgid "" -"Historically, this file was needed to manually mark files files as " -"conffiles. However, it has become de facto obsolete since debhelper " -"automatically computed which files should be marked as conffiles." +"This file will be installed into the F<DEBIAN> directory. The provided file " +"will be enriched by debhelper to include all the B<conffiles> auto-detected " +"by debhelper (the maintainer should not list there as debhelper assumes it " +"should handle that part)." msgstr "" #. type: textblock -#: dh_installdeb:63 +#: dh_installdeb:64 msgid "" -"In compatibility level up and including 11, this control file will be " -"installed into the F<DEBIAN> directory. In compatibility level 12 and " -"later, the file is silently ignored." +"This file is primarily useful for using \"special\" entries such as the B<< " +"remove-on-upgrade >> feature from dpkg." msgstr "" #. type: =item @@ -6747,13 +7234,23 @@ msgid "" "enabled as a warning since compat 10 and as a hard error in compat 12." msgstr "" +#. type: textblock +#: dh_installdeb:95 +msgid "" +"Where possible, B<dh_installdeb> may choose to rewrite some or all of the " +"entries into equivalent features supported in dpkg without relying on " +"maintainer scripts at its sole discretion (examples include rewriting " +"B<rm_conffile> into dpkg's B<remove-on-upgrade>). The minimum requirement " +"for activating this feature is that debhelper runs in compat 10 or later." +msgstr "" + #. type: =item -#: dh_installdeb:104 +#: dh_installdeb:111 dh_installdebconf:76 msgid "B<-D>I<TOKEN=VALUE>, B<--define> I<TOKEN=VALUE>" msgstr "" #. type: textblock -#: dh_installdeb:106 +#: dh_installdeb:113 dh_installdebconf:78 msgid "" "Define tokens to be replaced inside the maintainer scripts when it is " "generated. Please note that the limitations described in L</Limitations in " @@ -6762,7 +7259,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:111 +#: dh_installdeb:118 dh_installdebconf:83 msgid "" "In the simple case, this parameter will cause B<< #I<TOKEN># >> to be " "replaced by I<VALUE>. If I<VALUE> starts with a literal I<@>-sign, then " @@ -6771,18 +7268,18 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:116 +#: dh_installdeb:123 dh_installdebconf:88 msgid "" "An explicit declared token with this parameter will replace built-in tokens." msgstr "" #. type: textblock -#: dh_installdeb:119 +#: dh_installdeb:126 dh_installdebconf:91 msgid "Test examples to aid with the understanding:" msgstr "" #. type: verbatim -#: dh_installdeb:121 +#: dh_installdeb:128 #, no-wrap msgid "" "\tcat >> debian/postinst <<EOF\n" @@ -6795,14 +7292,14 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:128 +#: dh_installdeb:135 dh_installdebconf:100 msgid "" "In this example, B<#SIMPLE#> will expand to B<direct> and B<#FILEBASED#> " "will expand to B<Complex value>." msgstr "" #. type: textblock -#: dh_installdeb:131 +#: dh_installdeb:138 msgid "" "It is also possible to set package-specific values for a given token. This " "is useful when B<dh_installdeb> is acting on multiple packages that need " @@ -6811,12 +7308,12 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:136 +#: dh_installdeb:143 dh_installdebconf:108 msgid "This can be used as in the following example:" msgstr "" #. type: verbatim -#: dh_installdeb:138 +#: dh_installdeb:145 #, no-wrap msgid "" "\tcat >> debian/foo.postinst <<EOF\n" @@ -6837,7 +7334,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:153 +#: dh_installdeb:160 msgid "" "In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." "postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and to B<unique-" @@ -6845,7 +7342,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:157 +#: dh_installdeb:164 msgid "" "Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." "g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> and it " @@ -6853,26 +7350,26 @@ msgid "" msgstr "" #. type: =head1 -#: dh_installdeb:163 +#: dh_installdeb:170 dh_installdebconf:135 msgid "SUBSTITUTION IN MAINTAINER SCRIPTS" msgstr "" #. type: textblock -#: dh_installdeb:165 +#: dh_installdeb:172 msgid "" "The B<dh_installdeb> will automatically replace the following tokens inside " "a provided maintainer script (if not replaced via B<-D>/B<--define>):" msgstr "" #. type: =item -#: dh_installdeb:170 +#: dh_installdeb:177 #, fuzzy #| msgid "DEBHELPER COMMANDS" msgid "#DEBHELPER#" msgstr "DEBHELPER コマンド" #. type: textblock -#: dh_installdeb:172 +#: dh_installdeb:179 msgid "" "This token is by default replaced with generated shell snippets debhelper " "commands. This includes the snippets generated by B<dh_installdeb> from " @@ -6880,12 +7377,12 @@ msgid "" msgstr "" #. type: =item -#: dh_installdeb:176 +#: dh_installdeb:183 dh_installdebconf:142 msgid "#DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME>#" msgstr "" #. type: textblock -#: dh_installdeb:178 +#: dh_installdeb:185 dh_installdebconf:144 msgid "" "These tokens are replaced with the respective variable from L<dpkg-" "architecture(1)>. In almost all cases, you will want use the B<< " @@ -6894,19 +7391,19 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:183 +#: dh_installdeb:190 dh_installdebconf:149 msgid "" "On a best effort, tokens of this pattern that do not match a variable in " "L<dpkg-architecture(1)> will be left as-is." msgstr "" #. type: =item -#: dh_installdeb:186 +#: dh_installdeb:193 dh_installdebconf:152 msgid "#ENV.I<NAME>#" msgstr "" #. type: textblock -#: dh_installdeb:188 +#: dh_installdeb:195 dh_installdebconf:154 msgid "" "These tokens of this form will be replaced with value of the corresponding " "environment variable. If the environment variable is unset, the token is " @@ -6914,37 +7411,37 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdeb:193 +#: dh_installdeb:200 dh_installdebconf:159 msgid "" "Note that there are limits on which names can be used (see L</Limitations in " "token names>)." msgstr "" #. type: =item -#: dh_installdeb:196 +#: dh_installdeb:203 dh_installdebconf:162 msgid "#PACKAGE#" msgstr "" #. type: textblock -#: dh_installdeb:198 +#: dh_installdeb:205 dh_installdebconf:164 msgid "" "This token is by default replaced by the package name, which will contain " "the concrete script." msgstr "" #. type: =head2 -#: dh_installdeb:203 +#: dh_installdeb:210 dh_installdebconf:169 msgid "Limitations in token names" msgstr "" #. type: textblock -#: dh_installdeb:205 +#: dh_installdeb:212 dh_installdebconf:171 msgid "" "All tokens intended to be substituted must match the regex: #[A-Za-z0-9_.+]+#" msgstr "" #. type: textblock -#: dh_installdeb:207 +#: dh_installdeb:214 msgid "" "Tokens that do not match that regex will be silently ignored if found in the " "script template. Invalid token names passed to B<-D> or B<--define> will " @@ -7081,6 +7578,80 @@ msgstr "F<postrm> ファイルã®å¤‰æ›´ã‚’è¡Œã„ã¾ã›ã‚“。" msgid "Pass the params to B<po2debconf>." msgstr "B<po2debconf> ã¸ãƒ‘ラメータを引ã渡ã—ã¾ã™ã€‚" +#. type: verbatim +#: dh_installdebconf:93 +#, no-wrap +msgid "" +"\tcat >> debian/config <<EOF\n" +"\t#SIMPLE#\n" +"\t#FILEBASED#\n" +"\tEOF\n" +"\techo -n \"Complex value\" > some-file\n" +" dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +"\n" +msgstr "" + +#. type: textblock +#: dh_installdebconf:103 +msgid "" +"It is also possible to set package-specific values for a given token. This " +"is useful when B<dh_installdebconf> is acting on multiple packages that need " +"different values for the same token. This is done by prefixing the token " +"name with B<< pkg.I<package-name>. >>." +msgstr "" + +#. type: verbatim +#: dh_installdebconf:110 +#, no-wrap +msgid "" +"\tcat >> debian/foo.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/bar.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/baz.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +" dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \\\n" +" --define pkg.baz.TOKEN=unique-baz-value\n" +"\n" +msgstr "" + +#. type: textblock +#: dh_installdebconf:125 +msgid "" +"In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." +"config>, to B<unique-bar-value> in F<debian/bar.config> and to B<unique-baz-" +"value> in F<debian/baz.config>." +msgstr "" + +#. type: textblock +#: dh_installdebconf:129 +msgid "" +"Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." +"g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.config> and it " +"will be replaced by B<unique-bar-value>." +msgstr "" + +#. type: textblock +#: dh_installdebconf:137 +msgid "" +"The B<dh_installdebconf> will automatically replace the following tokens " +"inside a provided maintainer script (if not replaced via B<-D>/B<--define>):" +msgstr "" + +#. type: textblock +#: dh_installdebconf:173 +msgid "" +"Tokens that do not match that regex will be silently ignored if found in the " +"script template. Invalid token names passed to B<-D> or B<--define> will " +"cause B<dh_installdebconf> to reject the command with an error in most cases." +msgstr "" + #. type: textblock #: dh_installdirs:5 msgid "dh_installdirs - create subdirectories in package build directories" @@ -7397,7 +7968,7 @@ msgstr "" "ã“ã‚Œã«ã¯ doc-base ã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚‚å«ã‚€ç‚¹ã«æ³¨æ„ãã ã•ã„。" #. type: textblock -#: dh_installdocs:116 dh_installexamples:55 dh_installinfo:52 dh_installman:102 +#: dh_installdocs:116 dh_installexamples:59 dh_installinfo:52 dh_installman:102 msgid "" "Look in the specified directory for files to be installed. This option " "requires compat 11 or later (it is silently ignored in compat 10 or earlier)." @@ -7423,14 +7994,14 @@ msgstr "" "F<debian/tmp> ã¸ãƒ•ã‚¡ã‚¤ãƒ«ã‚’探ã—ã«è¡Œã為ã§ã™ã€‚" #. type: =item -#: dh_installdocs:124 dh_installexamples:63 +#: dh_installdocs:124 dh_installexamples:67 #, fuzzy #| msgid "B<--mainpackage=>I<package>" msgid "B<--doc-main-package=>I<main-package>" msgstr "B<--mainpackage=>I<package>" #. type: textblock -#: dh_installdocs:126 dh_installexamples:65 +#: dh_installdocs:126 dh_installexamples:69 msgid "" "Set the main package for a documentation package. This is used to install " "the documentation of the documentation package in F<< /usr/share/doc/I<main-" @@ -7438,7 +8009,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installdocs:131 dh_installexamples:70 +#: dh_installdocs:131 dh_installexamples:74 msgid "" "In compat 11 (or later), this option is only useful if debhelper's auto-" "detection of the main package is wrong. The option can also be used to " @@ -7762,7 +8333,16 @@ msgstr "" "インストールã™ã‚‹äºˆå®šã®ä¾‹ã‚’示ã™ãƒ•ã‚¡ã‚¤ãƒ«ã‚‚ã—ãã¯ã€ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã‚’指定ã—ã¾ã™ã€‚" #. type: textblock -#: dh_installexamples:50 +#: dh_installexamples:39 +msgid "" +"If upstream provides an F<examples> directory, you will often want to use " +"B<examples/*> rather than B<examples> in this file. The latter would create " +"F<< /usr/share/doc/I<package>/examples/examples >>, which is rarely what you " +"want." +msgstr "" + +#. type: textblock +#: dh_installexamples:54 #, fuzzy msgid "" "Install any files specified by command line parameters in ALL packages acted " @@ -7772,7 +8352,7 @@ msgstr "" "イルをインストールã—ã¾ã™ã€‚" #. type: textblock -#: dh_installexamples:58 +#: dh_installexamples:62 #, fuzzy #| msgid "" #| "Note that this is not the same as the B<--sourcedirectory> option used by " @@ -7791,7 +8371,7 @@ msgstr "" "F<debian/tmp> ã¸ãƒ•ã‚¡ã‚¤ãƒ«ã‚’探ã—ã«è¡Œã為ã§ã™ã€‚" #. type: textblock -#: dh_installexamples:75 +#: dh_installexamples:79 msgid "" "This option cannot be used when B<dh_installexamples> is instructed to act " "on multiple packages. If you need this option, you will generally need to " @@ -7799,7 +8379,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installexamples:82 +#: dh_installexamples:86 msgid "" "Exclude files that contain I<item> anywhere in their filename from being " "installed." @@ -7808,7 +8388,7 @@ msgstr "" "ã—ã¾ã™ã€‚" #. type: textblock -#: dh_installexamples:87 +#: dh_installexamples:91 msgid "" "Install these files (or directories) as examples into the first package " "acted on. (Or into all packages if B<-A> is specified.)" @@ -7818,7 +8398,7 @@ msgstr "" "パッケージã«å¯¾ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã‚’è¡Œã„ã¾ã™)。" #. type: textblock -#: dh_installexamples:94 +#: dh_installexamples:98 msgid "" "Note that B<dh_installexamples> will happily copy entire directory " "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to " @@ -8064,8 +8644,9 @@ msgstr "debian/I<package>.service" #: dh_installinit:67 #, fuzzy msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"in the package build directory. Only used in compat levels 10 and below." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> in the package build directory. Only used in compat levels 10 and " +"below." msgstr "" "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" @@ -8080,24 +8661,23 @@ msgstr "debian/I<package>.tmpfile" #, fuzzy msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.) Only used in compat levels 10 and below." +"the package build directory. Only used in compat levels 10 and below." msgstr "" "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_installinit:84 +#: dh_installinit:83 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts." msgstr "F<postinst>/F<postrm>/F<prerm> スクリプトã¯å¤‰æ›´ã—ãªã„ã§ãã ã•ã„。" #. type: =item -#: dh_installinit:86 +#: dh_installinit:85 msgid "B<-o>, B<--only-scripts>" msgstr "B<-o>, B<--only-scripts>" #. type: textblock -#: dh_installinit:88 +#: dh_installinit:87 #, fuzzy msgid "" "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install " @@ -8113,7 +8693,7 @@ msgstr "" "ã†ãªå ´åˆã«éƒ½åˆãŒè‰¯ã„ã§ã™ã€‚" #. type: textblock -#: dh_installinit:93 +#: dh_installinit:92 msgid "" "B<Caveat>: This will bypass all the regular checks and I<unconditionally> " "modify the scripts. You will almost certainly want to use this with B<-p> " @@ -8121,7 +8701,7 @@ msgid "" msgstr "" #. type: verbatim -#: dh_installinit:98 +#: dh_installinit:97 #, no-wrap msgid "" " override_dh_installinit:\n" @@ -8135,12 +8715,12 @@ msgstr "" "\n" #. type: =item -#: dh_installinit:102 +#: dh_installinit:101 msgid "B<-R>, B<--restart-after-upgrade>" msgstr "B<-R>, B<--restart-after-upgrade>" #. type: textblock -#: dh_installinit:104 +#: dh_installinit:103 #, fuzzy msgid "" "Do not stop the init script until after the package upgrade has been " @@ -8152,7 +8732,7 @@ msgstr "" "続ãã‚’å†ã³å‘¼ã³å‡ºã—ã¾ã™ã€‚" #. type: textblock -#: dh_installinit:107 +#: dh_installinit:106 #, fuzzy msgid "" "In early compat levels, the default was to stop the script in the F<prerm>, " @@ -8164,7 +8744,7 @@ msgstr "" "続ãã‚’å†ã³å‘¼ã³å‡ºã—ã¾ã™ã€‚" #. type: textblock -#: dh_installinit:110 dh_systemd_start:45 +#: dh_installinit:109 dh_systemd_start:45 msgid "" "This can be useful for daemons that should not have a possibly long downtime " "during upgrade. But you should make sure that the daemon will not get " @@ -8177,12 +8757,12 @@ msgstr "" "å‚ç…§ã—ã¦æ··ä¹±ã—ãªã„ã“ã¨ã‚’ä¿è¨¼ã™ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™ã€‚" #. type: =item -#: dh_installinit:115 dh_systemd_start:50 +#: dh_installinit:114 dh_systemd_start:50 msgid "B<--no-restart-after-upgrade>" msgstr "B<--no-restart-after-upgrade>" #. type: textblock -#: dh_installinit:117 dh_systemd_start:52 +#: dh_installinit:116 dh_systemd_start:52 msgid "" "Undo a previous B<--restart-after-upgrade> (or the default of compat 10). " "If no other options are given, this will cause the service to be stopped in " @@ -8190,19 +8770,19 @@ msgid "" msgstr "" #. type: =item -#: dh_installinit:122 dh_systemd_start:57 +#: dh_installinit:121 dh_systemd_start:57 msgid "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" msgstr "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" #. type: textblock -#: dh_installinit:124 +#: dh_installinit:123 msgid "" "Do not stop init script on upgrade. This has the side-effect of not " "restarting the service as a part of the upgrade." msgstr "" #. type: textblock -#: dh_installinit:127 +#: dh_installinit:126 msgid "" "If you want to restart the service with minimal downtime, please use B<--" "restart-after-upgrade> (default in compat 10 or later). If you want the " @@ -8211,7 +8791,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:132 +#: dh_installinit:131 msgid "" "Note that the B<--no-restart-on-upgrade> alias is deprecated and will be " "removed in compat 12. This is to avoid confusion with the B<--no-restart-" @@ -8220,12 +8800,12 @@ msgid "" msgstr "" #. type: =item -#: dh_installinit:137 dh_systemd_start:61 +#: dh_installinit:136 dh_systemd_start:61 msgid "B<--no-start>" msgstr "B<--no-start>" #. type: textblock -#: dh_installinit:139 +#: dh_installinit:138 msgid "" "Do not start the init script on install or upgrade, or stop it on removal. " "Only call B<update-rc.d>. Useful for rcS scripts." @@ -8236,12 +8816,12 @@ msgstr "" "インストールã™ã‚‹éš›ã«ä¾¿åˆ©ã§ã™ã€‚" #. type: =item -#: dh_installinit:142 dh_systemd_enable:87 +#: dh_installinit:141 dh_systemd_enable:86 msgid "B<--no-enable>" msgstr "B<--no-enable>" #. type: textblock -#: dh_installinit:144 +#: dh_installinit:143 msgid "" "Disable the init script on purge, but do not enable them on install. This " "implies a versioned dependency on B<< init-system-helpers (E<gt>= 1.51) >> " @@ -8250,7 +8830,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:149 +#: dh_installinit:148 msgid "" "B<Note> that this option does not affect whether the services are started. " "Please remember to also use B<--no-start> if the service should not be " @@ -8258,7 +8838,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_installinit:153 +#: dh_installinit:152 #, fuzzy #| msgid "B<-u>I<params> B<--update-rcd-params=>I<params>" msgid "" @@ -8267,12 +8847,12 @@ msgid "" msgstr "B<-u>I<params> B<--update-rcd-params=>I<params>" #. type: =item -#: dh_installinit:156 +#: dh_installinit:155 msgid "B<-d>, B<--remove-d>" msgstr "B<-d>, B<--remove-d>" #. type: textblock -#: dh_installinit:158 +#: dh_installinit:157 #, fuzzy msgid "" "Remove trailing B<d> from the name of the package, and use the result for " @@ -8290,12 +8870,12 @@ msgstr "" "init-script> パラメータãŒä½œç”¨ã™ã‚‹ã‚ˆã‚Šå‰ã«å®Ÿè¡Œã•ã‚Œã¾ã™)。" #. type: =item -#: dh_installinit:165 +#: dh_installinit:164 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>" msgstr "B<-u>I<params> B<--update-rcd-params=>I<params>" #. type: textblock -#: dh_installinit:169 +#: dh_installinit:168 #, fuzzy #| msgid "" #| "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> will " @@ -8309,12 +8889,12 @@ msgstr "" "B<defaults> パラメータ㌠L<update-rc.d(8)> ã¸æ¸¡ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_installinit:173 +#: dh_installinit:172 msgid "Cannot be combined with B<--no-enable>." msgstr "" #. type: textblock -#: dh_installinit:177 +#: dh_installinit:176 msgid "" "Install the init script (and default file) as well as upstart job file using " "the filename I<name> instead of the default filename, which is the package " @@ -8332,12 +8912,12 @@ msgstr "" "ん。" #. type: =item -#: dh_installinit:185 +#: dh_installinit:184 msgid "B<--init-script=>I<scriptname>" msgstr "B<--init-script=>I<scriptname>" #. type: textblock -#: dh_installinit:187 +#: dh_installinit:186 msgid "" "Use I<scriptname> as the filename the init script is installed as in F<etc/" "init.d/> (and also use it as the filename for the defaults file, if it is " @@ -8355,7 +8935,7 @@ msgstr "" "ã™ã€‚" #. type: textblock -#: dh_installinit:194 +#: dh_installinit:193 msgid "" "This parameter is deprecated, use the B<--name> parameter instead. This " "parameter is incompatible with the use of upstart jobs." @@ -8365,12 +8945,12 @@ msgstr "" "ã†ã«ã¯å‡ºæ¥ã¦ã„ã¾ã›ã‚“。" #. type: =item -#: dh_installinit:197 +#: dh_installinit:196 msgid "B<--error-handler=>I<function>" msgstr "B<--error-handler=>I<function>" #. type: textblock -#: dh_installinit:199 +#: dh_installinit:198 msgid "" "Call the named shell I<function> if running the init script fails. The " "function should be provided in the F<prerm> and F<postinst> scripts, before " @@ -8382,19 +8962,19 @@ msgstr "" "ã™ã€‚ " #. type: textblock -#: dh_installinit:432 +#: dh_installinit:415 #, fuzzy #| msgid "L<debhelper(7)>, L<dpkg-shlibdeps(1)>" msgid "L<debhelper(7)>, L<dh_installsystemd(1)>" msgstr "L<debhelper(7)>, L<dpkg-shlibdeps(1)>" #. type: textblock -#: dh_installinit:440 +#: dh_installinit:423 msgid "Steve Langasek <steve.langasek@canonical.com>" msgstr "Steve Langasek <steve.langasek@canonical.com>" #. type: textblock -#: dh_installinit:442 +#: dh_installinit:425 msgid "Michael Stapelberg <stapelberg@debian.org>" msgstr "Michael Stapelberg <stapelberg@debian.org>" @@ -9162,17 +9742,32 @@ msgstr "debian/I<package>.pam" #. type: textblock #: dh_installpam:30 -msgid "Installed into etc/pam.d/I<package> in the package build directory." +#, fuzzy +#| msgid "Installed into etc/pam.d/I<package> in the package build directory." +msgid "Installed into usr/lib/pam.d/I<package> in the package build directory." msgstr "" "ã“れらファイルã¯ãƒ‘ッケージビルドディレクトリ内㮠etc/pam.d/I<package> ã¸ã‚¤ãƒ³" "ストールã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_installpam:40 +#: dh_installpam:32 msgid "" -"Look for files named debian/I<package>.I<name>.pam and install them as etc/" -"pam.d/I<name>, instead of using the usual files and installing them using " -"the package name." +"Until compatibility level 14 this file was installed under etc/pam.d/" +"I<package>. Please consider using the \"rm_conffile\" feature from " +"L<dh_installdeb(1)> to ensure the proper removal of previous PAM files." +msgstr "" + +#. type: textblock +#: dh_installpam:44 +#, fuzzy +#| msgid "" +#| "Look for files named debian/I<package>.I<name>.pam and install them as " +#| "etc/pam.d/I<name>, instead of using the usual files and installing them " +#| "using the package name." +msgid "" +"Look for files named debian/I<package>.I<name>.pam and install them as usr/" +"lib/pam.d/I<name>, instead of using the usual files and installing them " +"using the package name." msgstr "" "debian/I<package>.I<name>.pam ã¨åã®ã¤ãファイルを探ã—ã€etc/pam.d/I<name> 以" "下ã«ã“れらã®ãƒ•ã‚¡ã‚¤ãƒ«ã‚’インストールã—ã¾ã™ã€‚ã“ã¡ã‚‰ã®ã‚ªãƒ—ションを利用ã™ã‚‹ã¨é€šå¸¸" @@ -10219,9 +10814,13 @@ msgstr "B<-x>, B<--include-conffiles>" #. type: textblock #: dh_md5sums:37 +#, fuzzy +#| msgid "" +#| "Include conffiles in the md5sums list. Note that this information is " +#| "redundant since it is included elsewhere in Debian packages." msgid "" "Include conffiles in the md5sums list. Note that this information is " -"redundant since it is included elsewhere in Debian packages." +"redundant since it is included in F</var/lib/dpkg/status> in Debian packages." msgstr "" "md5sum 値をå–å¾—ã™ã‚‹ãƒ•ã‚¡ã‚¤ãƒ«ã¨ã—㦠conffile ã‚’å«ã‚ã¾ã™ã€‚ã“ã®æƒ…å ±ã¯ Debian パッ" "ケージã¨ã¯ç•°ãªã‚‹å ´æ‰€ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã‚‹ç‚ºã€è£œåŠ©ç›®çš„ã®æƒ…å ±ã¨ã—ã¦æ‰±ã‚ã‚Œã¾ã™" @@ -10356,23 +10955,23 @@ msgstr "" "dh_perl - Perlã¸ã®ä¾å˜é–¢ä¿‚を検討ã—ã€MakeMaker 実行後ã«ç”Ÿæˆã—ãŸã‚‚ã®ã‚’消去ã™ã‚‹" #. type: textblock -#: dh_perl:19 +#: dh_perl:20 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]" msgstr "" "B<dh_perl> [S<I<debhelper オプション>>] [B<-d>] [S<I<ライブラリディレクトリ" "> ...>]" #. type: textblock -#: dh_perl:23 +#: dh_perl:24 msgid "" -"B<dh_perl> is a debhelper program that is responsible for generating the B<" -"${perl:Depends}> substitutions and adding them to substvars files." +"B<dh_perl> is a debhelper program that is responsible for generating the " +"B<${perl:Depends}> substitutions and adding them to substvars files." msgstr "" "B<dh_perl> 㯠B<${perl:Depends}> ã®å†…容を生æˆã—ã€ã“ã®ä¾å˜æƒ…å ±ã« substvars " "ファイルã®æƒ…å ±ã‚’ä»˜ã‘åŠ ãˆã‚‹å½¹ç›®ã® debhelper プãƒã‚°ãƒ©ãƒ ã§ã™ã€‚" #. type: textblock -#: dh_perl:26 +#: dh_perl:27 msgid "" "The program will look at Perl scripts and modules in your package, and will " "use this information to generate a dependency on B<perl> or B<perlapi>. The " @@ -10385,7 +10984,7 @@ msgstr "" "ã«ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_perl:31 +#: dh_perl:32 msgid "" "B<dh_perl> also cleans up empty directories that MakeMaker can generate when " "installing Perl modules." @@ -10394,12 +10993,12 @@ msgstr "" "ã—ãŸç©ºã®ãƒ‡ã‚£ãƒ¬ã‚¯ãƒˆãƒªã‚’削除ã—ã¾ã™ã€‚" #. type: =item -#: dh_perl:38 +#: dh_perl:39 msgid "B<-d>" msgstr "B<-d>" #. type: textblock -#: dh_perl:40 +#: dh_perl:41 msgid "" "In some specific cases you may want to depend on B<perl-base> rather than " "the full B<perl> package. If so, you can pass the -d option to make " @@ -10412,7 +11011,7 @@ msgstr "" "ãŒå«ã¾ã‚Œã‚‹ã‚ˆã†ãªãƒ‘ッケージã®ã¿ã§å¿…è¦ã§ã™ã€‚" #. type: textblock -#: dh_perl:45 +#: dh_perl:46 msgid "" "Note that this flag may cause no dependency on B<perl-base> to be generated " "at all. B<perl-base> is Essential, so its dependency can be left out, unless " @@ -10424,12 +11023,12 @@ msgstr "" "base> ã®ç‰¹å®šã®ãƒãƒ¼ã‚¸ãƒ§ãƒ³ã«ä¾å˜ãŒç‰¹ã«å¿…è¦ãªå ´åˆã¯ãã®é™ã‚Šã§ã¯ã‚ã‚Šã¾ã›ã‚“。" #. type: =item -#: dh_perl:49 +#: dh_perl:50 msgid "B<-V>" msgstr "B<-V>" #. type: textblock -#: dh_perl:51 +#: dh_perl:52 msgid "" "By default, scripts and architecture independent modules don't depend on any " "specific version of B<perl>. The B<-V> option causes the current version of " @@ -10442,12 +11041,12 @@ msgstr "" "ン) ã‚’ã€ãƒ‘ッケージã®ä¾å˜æƒ…å ±ã¨ã—ã¦è¨å®šã—ã¾ã™ã€‚" #. type: =item -#: dh_perl:55 +#: dh_perl:56 msgid "I<library dirs>" msgstr "I<library dirs>" #. type: textblock -#: dh_perl:57 +#: dh_perl:58 msgid "" "If your package installs Perl modules in non-standard directories, you can " "make B<dh_perl> check those directories by passing their names on the " @@ -10460,17 +11059,17 @@ msgstr "" "ã®ã‚³ãƒžãƒ³ãƒ‰ã¯ F<vendorlib> 㨠F<vendorarch> ディレクトリã®ã¿ã‚’確èªã—ã¾ã™ã€‚" #. type: textblock -#: dh_perl:66 +#: dh_perl:67 msgid "Debian policy, version 3.8.3" msgstr "Debian ãƒãƒªã‚·ãƒ¼ ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 3.8.3" #. type: textblock -#: dh_perl:68 +#: dh_perl:69 msgid "Perl policy, version 1.20" msgstr "Perl ãƒãƒªã‚·ãƒ¼ ãƒãƒ¼ã‚¸ãƒ§ãƒ³ 1.20" #. type: textblock -#: dh_perl:182 +#: dh_perl:196 msgid "Brendan O'Dea <bod@debian.org>" msgstr "Brendan O'Dea <bod@debian.org>" @@ -10975,8 +11574,8 @@ msgid "" "adding B<noautodbgsym> to the B<DEB_BUILD_OPTIONS> environment variable. " "However, B<dh_strip> will still add debuglinks to ELF binaries when this " "flag is set. This is to ensure that the regular deb package will be " -"identical with and without this flag (assuming it is otherwise \"bit-for-bit" -"\" reproducible)." +"identical with and without this flag (assuming it is otherwise \"bit-for-" +"bit\" reproducible)." msgstr "" "デãƒãƒƒã‚°ã‚·ãƒ³ãƒœãƒ«ãƒ‘ッケージã®è‡ªå‹•ä½œæˆã¯ã€B<DEB_BUILD_OPTIONS> 環境変数㫠" "B<noautodbgsym> ã‚’è¿½åŠ ã™ã‚‹ã“ã¨ã§ã‚‚抑制ã§ãã¾ã™ã€‚ã—ã‹ã—ã€B<dh_strip> ã¯ã“ã®ãƒ•" @@ -11241,8 +11840,9 @@ msgstr "debian/I<package>.logcheck.ignore.server" #: dh_systemd_enable:47 #, fuzzy msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"(or lib/systemd/system/I<package>@.service) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> (or F<< lib/systemd/system/I<package>@.service >>) in the package " +"build directory." msgstr "" "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" @@ -11250,101 +11850,107 @@ msgstr "" #. type: textblock #: dh_systemd_enable:52 #, fuzzy +#| msgid "" +#| "If this exists, it is installed into etc/init.d/I<package> in the package " +#| "build directory." msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.)" +"the package build directory." msgstr "" -"ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" -"I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" +"ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㮠etc/init/" +"I<package> ディレクトリã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: =item -#: dh_systemd_enable:56 +#: dh_systemd_enable:55 #, fuzzy #| msgid "debian/I<package>.manpages" msgid "debian/I<package>.target, debian/I<package>@.target" msgstr "debian/I<package>.manpages" #. type: textblock -#: dh_systemd_enable:58 +#: dh_systemd_enable:57 #, fuzzy msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.target " -"(or lib/systemd/system/I<package>@.target) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"target >> (or F<< lib/systemd/system/I<package>@.target >>) in the package " +"build directory." msgstr "" "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: =item -#: dh_systemd_enable:61 +#: dh_systemd_enable:60 #, fuzzy #| msgid "debian/I<package>.manpages" msgid "debian/I<package>.socket, debian/I<package>@.socket" msgstr "debian/I<package>.manpages" #. type: textblock -#: dh_systemd_enable:63 +#: dh_systemd_enable:62 #, fuzzy msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.socket " -"(or lib/systemd/system/I<package>@.socket) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"socket >> (or F<< lib/systemd/system/I<package>@.socket >>) in the package " +"build directory." msgstr "" "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: =item -#: dh_systemd_enable:66 +#: dh_systemd_enable:65 #, fuzzy #| msgid "debian/I<package>.menu" msgid "debian/I<package>.mount" msgstr "debian/I<package>.menu" #. type: textblock -#: dh_systemd_enable:68 +#: dh_systemd_enable:67 #, fuzzy msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.mount in " -"the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.mount " +">> in the package build directory." msgstr "" "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: =item -#: dh_systemd_enable:71 +#: dh_systemd_enable:70 #, fuzzy #| msgid "debian/I<package>.manpages" msgid "debian/I<package>.path, debian/I<package>@.path" msgstr "debian/I<package>.manpages" #. type: textblock -#: dh_systemd_enable:73 +#: dh_systemd_enable:72 #, fuzzy msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.path (or " -"lib/systemd/system/I<package>@.path) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.path " +">> (or F<< lib/systemd/system/I<package>@.path >>) in the package build " +"directory." msgstr "" "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: =item -#: dh_systemd_enable:76 +#: dh_systemd_enable:75 #, fuzzy #| msgid "debian/I<package>.manpages" msgid "debian/I<package>.timer, debian/I<package>@.timer" msgstr "debian/I<package>.manpages" #. type: textblock -#: dh_systemd_enable:78 +#: dh_systemd_enable:77 #, fuzzy msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.timer (or " -"lib/systemd/system/I<package>@.timer) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.timer " +">> (or F<< lib/systemd/system/I<package>@.timer >>) in the package build " +"directory." msgstr "" "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" #. type: textblock -#: dh_systemd_enable:89 +#: dh_systemd_enable:88 #, fuzzy msgid "Disable the service(s) on purge, but do not enable them on install." msgstr "" @@ -11352,7 +11958,7 @@ msgstr "" "ん。" #. type: textblock -#: dh_systemd_enable:91 +#: dh_systemd_enable:90 msgid "" "B<Note> that this option does not affect whether the services are started. " "That is controlled by L<dh_systemd_start(1)> (using e.g. its B<--no-start> " @@ -11360,7 +11966,7 @@ msgid "" msgstr "" #. type: textblock -#: dh_systemd_enable:97 +#: dh_systemd_enable:96 #, fuzzy msgid "" "Install the service file as I<name.service> instead of the default filename, " @@ -11377,7 +11983,7 @@ msgstr "" "ん。" #. type: textblock -#: dh_systemd_enable:106 dh_systemd_start:70 +#: dh_systemd_enable:105 dh_systemd_start:70 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " "between invocations of this command (with the same arguments). Otherwise, it " @@ -11389,7 +11995,7 @@ msgstr "" "スクリプトä¸ã«åŒã˜å†…容ã®ã‚³ãƒ¼ãƒ‰ã‚’ç¹°ã‚Šè¿”ã—挿入ã—ã¦ã—ã¾ã„ã¾ã™ã€‚" #. type: textblock -#: dh_systemd_enable:111 +#: dh_systemd_enable:110 msgid "" "Note that B<dh_systemd_enable> should be run before B<dh_installinit>. The " "default sequence in B<dh> does the right thing, this note is only relevant " @@ -11397,12 +12003,12 @@ msgid "" msgstr "" #. type: textblock -#: dh_systemd_enable:283 +#: dh_systemd_enable:282 msgid "L<dh_systemd_start(1)>, L<debhelper(7)>" msgstr "L<dh_systemd_start(1)>, L<debhelper(7)>" #. type: textblock -#: dh_systemd_enable:287 dh_systemd_start:286 +#: dh_systemd_enable:286 dh_systemd_start:286 msgid "pkg-systemd-maintainers@lists.alioth.debian.org" msgstr "pkg-systemd-maintainers@lists.alioth.debian.org" @@ -11494,6 +12100,95 @@ msgstr "" msgid "This compatibility level is open for beta testing; changes may occur." msgstr "ã“ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã¯ãƒ™ãƒ¼ã‚¿ãƒ†ã‚¹ãƒˆä¸ã§ã™ã€‚変更ãŒåŠ ã‚ã‚Šã¾ã™ã€‚" +#~ msgid "" +#~ "Set to B<1> to enable verbose mode. Debhelper will output every command " +#~ "it runs. Also enables verbose build logs for some build systems like " +#~ "autoconf." +#~ msgstr "" +#~ "B<1> を指定ã™ã‚‹ã¨å†—長出力モードã«ãªã‚Šã¾ã™ã€‚debhelper ã¯å‹•ä½œã™ã‚‹å…¨ã¦ã®ã‚³ãƒž" +#~ "ンドã«ã¤ã„ã¦å‡ºåŠ›ã‚’è¡Œã†ã‚ˆã†ã«ãªã‚Šã¾ã™ã€‚ã¾ãŸã€autoconf ã®ã‚ˆã†ãªãƒ“ルドシステ" +#~ "ムã«ã¤ã„ã¦ã‚‚冗長出力ã•ã‚ŒãŸãƒ“ルドãƒã‚°ã‚’有効ã«ã—ã¾ã™ã€‚" + +#, fuzzy +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.) Only used in compat levels 10 and below." +#~ msgstr "" +#~ "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" +#~ "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" + +#, fuzzy +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.)" +#~ msgstr "" +#~ "ã‚‚ã—本ファイルãŒå˜åœ¨ã™ã‚Œã°ã€ãƒ‘ッケージビルドディレクトリ以下㫠etc/init/" +#~ "I<package>.conf ファイルã¨ã—ã¦ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" + +#, fuzzy +#~| msgid "dh_gconf - install GConf defaults files and register schemas" +#~ msgid "" +#~ "dh_gconf - install GConf defaults files and register schemas (deprecated)" +#~ msgstr "" +#~ "dh_gconf - GConf デフォルトファイルをインストールã—ã€ã‚¹ã‚ーマã«ç™»éŒ²ã™ã‚‹" + +#~ msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" +#~ msgstr "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" + +#~ msgid "" +#~ "B<dh_gconf> is a debhelper program that is responsible for installing " +#~ "GConf defaults files and registering GConf schemas." +#~ msgstr "" +#~ "B<dh_gconf> 㯠GConf 用デフォルトファイルをインストールã—ã€GConf スã‚ーマ" +#~ "ã«ç™»éŒ²ã™ã‚‹å½¹å‰²ã‚’担ㆠdebhelper プãƒã‚°ãƒ©ãƒ ã§ã™ã€‚" + +#~ msgid "" +#~ "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}" +#~ ">." +#~ msgstr "gconf2 ã«é–¢ã™ã‚‹é©åˆ‡ãªä¾å˜é–¢ä¿‚㌠B<${misc:Depends}> ã«ç”Ÿæˆã•ã‚Œã¾ã™ã€‚" + +#~ msgid "debian/I<package>.gconf-defaults" +#~ msgstr "debian/I<package>.gconf-defaults" + +#~ msgid "" +#~ "Installed into F<usr/share/gconf/defaults/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "パッケージビルドディレクトリã«ã‚ã‚‹ F<usr/share/gconf/defaults/10_package> " +#~ "ã¸ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ãŒè¡Œã‚ã‚Œã¾ã™ã€‚ãªãŠã€I<package> ã¯ãƒ‘ッケージåã§ç½®ãæ›ãˆã‚‰ã‚Œ" +#~ "ã¾ã™ã€‚" + +#~ msgid "debian/I<package>.gconf-mandatory" +#~ msgstr "debian/I<package>.gconf-mandatory" + +#~ msgid "" +#~ "Installed into F<usr/share/gconf/mandatory/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "パッケージビルドディレクトリã«ã‚ã‚‹ F<usr/share/gconf/" +#~ "mandatory/10_package> ã«ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚ãªãŠã€I<package> ã¯ãƒ‘ッケー" +#~ "ジåã§ç½®ãæ›ãˆã‚‰ã‚Œã¾ã™ã€‚" + +#~ msgid "B<--priority> I<priority>" +#~ msgstr "B<--priority> I<priority>" + +#~ msgid "" +#~ "Use I<priority> (which should be a 2-digit number) as the defaults " +#~ "priority instead of B<10>. Higher values than ten can be used by derived " +#~ "distributions (B<20>), CDD distributions (B<50>), or site-specific " +#~ "packages (B<90>)." +#~ msgstr "" +#~ "I<priority> (ã“ã‚Œã¯2æ¡ã®æ•°å—ã§ã‚ã‚‹å¿…è¦ãŒã‚ã‚Šã¾ã™) をデフォルトã®å„ªå…ˆé †ä½ã§" +#~ "ã‚ã‚‹ B<10> ã®ä»£ã‚ã‚Šã«åˆ©ç”¨ã—ã¾ã™ã€‚用途ã«ã‚ˆã£ã¦ã¯ 10 より大ããªå€¤ã‚’利用ã™ã‚‹" +#~ "ã“ã¨ãŒã§ãã¾ã™ã€‚例ãˆã°ã€æ´¾ç”Ÿãƒ‡ã‚£ã‚¹ãƒˆãƒªãƒ“ューションã®å ´åˆ (B<20>)ã€CDD ディ" +#~ "ストリビューション (B<50>)ã€ã‚ã‚‹ã„ã¯ã‚µã‚¤ãƒˆç‹¬è‡ªã®ãƒ‘ッケージ (B<90>) ã¨ãªã‚Š" +#~ "ã¾ã™ã€‚" + +#~ msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" +#~ msgstr "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" + #~ msgid "" #~ "B<dh_clean> should be the last debhelper command run in the B<clean> " #~ "target in F<debian/rules>." @@ -11898,9 +12593,6 @@ msgstr "ã“ã®äº’æ›æ€§ãƒ¬ãƒ™ãƒ«ã¯ãƒ™ãƒ¼ã‚¿ãƒ†ã‚¹ãƒˆä¸ã§ã™ã€‚変更ãŒåŠ ã‚ #~ "B<dh_installmenu> 㯠F<menu> ファイルをインストールã—ãªããªã‚Šã¾ã—ãŸã€‚ã¾ã " #~ "F<menu-method> ファイルã¯ã‚¤ãƒ³ã‚¹ãƒˆãƒ¼ãƒ«ã•ã‚Œã¾ã™ã€‚" -#~ msgid "The previous behaviour can restored by using B<--with build-stamp>" -#~ msgstr "B<--with build-stamp> を使ãˆã°ä»¥å‰ã®å‹•ä½œã«æˆ»ã™ã“ã¨ãŒå‡ºæ¥ã¾ã™ã€‚" - #~ msgid "" #~ "B<dh_installdocs> now installs user-supplied documentation (e.g. debian/" #~ "I<package>.docs) into F</usr/share/doc/mainpackage> rather than F</usr/" diff --git a/man/po4a/po/pt.po b/man/po4a/po/pt.po index 78860fd5bc81f183bb02b1b0007bea42ed22cd54..e80bddf2f31c3cd9b4eff82cbf0dbe51688844d3 100644 --- a/man/po4a/po/pt.po +++ b/man/po4a/po/pt.po @@ -2,13 +2,13 @@ # Copyright (C) 2014 The debhelper's copyright holder. # This file is distributed under the same license as the debhelper package. # -# Américo Monteiro <a_monteiro@gmx.com>, 2014 to 2021. +# Américo Monteiro <a_monteiro@gmx.com>, 2014 to 2022. msgid "" msgstr "" -"Project-Id-Version: debhelper 13.3.2\n" +"Project-Id-Version: debhelper 13.9.1\n" "Report-Msgid-Bugs-To: debhelper@packages.debian.org\n" -"POT-Creation-Date: 2021-02-22 09:37+0100\n" -"PO-Revision-Date: 2021-02-01 14:37+0000\n" +"POT-Creation-Date: 2022-11-20 19:46+0100\n" +"PO-Revision-Date: 2022-09-05 22:19+0100\n" "Last-Translator: Américo Monteiro <a_monteiro@gmx.com>\n" "Language-Team: Portuguese <>\n" "Language: pt\n" @@ -16,13 +16,14 @@ msgstr "" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" "Plural-Forms: nplurals=2; plural=(n != 1);\n" -"X-Generator: Lokalize 2.0\n" +"X-Generator: Lokalize 20.12.0\n" #. type: =head1 -#: debhelper.pod:3 debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 -#: dh_auto_clean:3 dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 -#: dh_bugfiles:3 dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 -#: dh_gconf:3 dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 +#: debhelper.pod:3 debhelper-compat-upgrade-checklist.pod:3 +#: debhelper-obsolete-compat.pod:1 dh:3 dh_auto_build:3 dh_auto_clean:3 +#: dh_auto_configure:3 dh_auto_install:3 dh_auto_test:3 dh_bugfiles:3 +#: dh_builddeb:5 dh_clean:3 dh_compress:3 dh_dwz:3 dh_fixperms:3 +#: dh_gencontrol:3 dh_icons:3 dh_install:3 dh_installcatalogs:3 #: dh_installchangelogs:3 dh_installcron:3 dh_installdeb:3 dh_installdebconf:3 #: dh_installdirs:3 dh_installdocs:5 dh_installemacsen:3 dh_installexamples:5 #: dh_installifupdown:3 dh_installinfo:3 dh_installinit:3 dh_installinitramfs:3 @@ -42,19 +43,20 @@ msgid "debhelper - the debhelper tool suite" msgstr "debhelper - a suite de ferramentas debhelper" #. type: =head1 -#: debhelper.pod:7 debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 -#: dh_auto_clean:16 dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 -#: dh_bugfiles:15 dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 -#: dh_fixperms:16 dh_gconf:15 dh_gencontrol:16 dh_icons:16 dh_install:15 -#: dh_installcatalogs:17 dh_installchangelogs:15 dh_installcron:15 -#: dh_installdeb:15 dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 +#: debhelper.pod:7 debhelper-compat-upgrade-checklist.pod:7 +#: debhelper-obsolete-compat.pod:5 dh:22 dh_auto_build:16 dh_auto_clean:16 +#: dh_auto_configure:16 dh_auto_install:18 dh_auto_test:16 dh_bugfiles:15 +#: dh_builddeb:17 dh_clean:15 dh_compress:17 dh_dwz:16 dh_fixperms:16 +#: dh_gencontrol:16 dh_icons:16 dh_install:15 dh_installcatalogs:17 +#: dh_installchangelogs:16 dh_installcron:15 dh_installdeb:15 +#: dh_installdebconf:15 dh_installdirs:15 dh_installdocs:17 #: dh_installemacsen:15 dh_installexamples:17 dh_installifupdown:15 #: dh_installinfo:15 dh_installinit:16 dh_installinitramfs:15 #: dh_installlogcheck:15 dh_installlogrotate:15 dh_installman:16 #: dh_installmanpages:16 dh_installmenu:15 dh_installmime:15 #: dh_installmodules:16 dh_installpam:15 dh_installppp:15 dh_installudev:15 #: dh_installwm:15 dh_installxfonts:15 dh_link:16 dh_lintian:15 -#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:17 +#: dh_listpackages:15 dh_makeshlibs:15 dh_md5sums:16 dh_movefiles:15 dh_perl:18 #: dh_prep:15 dh_shlibdeps:17 dh_strip:16 dh_testdir:15 dh_testroot:9 #: dh_usrlocal:19 dh_systemd_enable:16 dh_systemd_start:17 msgid "SYNOPSIS" @@ -70,19 +72,19 @@ msgstr "" "N>I<package>] [B<-P>I<tmpdir>]" #. type: =head1 -#: debhelper.pod:11 dh:26 dh_auto_build:20 dh_auto_clean:20 -#: dh_auto_configure:20 dh_auto_install:22 dh_auto_test:20 dh_bugfiles:19 -#: dh_builddeb:21 dh_clean:19 dh_compress:21 dh_dwz:20 dh_fixperms:20 -#: dh_gconf:19 dh_gencontrol:20 dh_icons:20 dh_install:19 dh_installcatalogs:21 -#: dh_installchangelogs:19 dh_installcron:19 dh_installdeb:19 -#: dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 +#: debhelper.pod:11 debhelper-compat-upgrade-checklist.pod:17 dh:26 +#: dh_auto_build:20 dh_auto_clean:20 dh_auto_configure:20 dh_auto_install:22 +#: dh_auto_test:20 dh_bugfiles:19 dh_builddeb:21 dh_clean:19 dh_compress:21 +#: dh_dwz:20 dh_fixperms:20 dh_gencontrol:20 dh_icons:20 dh_install:19 +#: dh_installcatalogs:21 dh_installchangelogs:20 dh_installcron:19 +#: dh_installdeb:19 dh_installdebconf:19 dh_installdirs:19 dh_installdocs:21 #: dh_installemacsen:19 dh_installexamples:21 dh_installifupdown:19 #: dh_installinfo:19 dh_installinit:20 dh_installinitramfs:19 #: dh_installlogcheck:19 dh_installlogrotate:19 dh_installman:20 #: dh_installmanpages:20 dh_installmenu:19 dh_installmime:19 #: dh_installmodules:20 dh_installpam:19 dh_installppp:19 dh_installudev:19 #: dh_installwm:19 dh_installxfonts:19 dh_link:20 dh_lintian:19 -#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:21 +#: dh_listpackages:19 dh_makeshlibs:19 dh_md5sums:20 dh_movefiles:19 dh_perl:22 #: dh_prep:19 dh_shlibdeps:21 dh_strip:20 dh_testdir:19 dh_testroot:13 #: dh_usrlocal:23 dh_systemd_enable:20 dh_systemd_start:21 msgid "DESCRIPTION" @@ -273,9 +275,9 @@ msgstr "" "ficheiros para arquitecturas ou sistemas operativos diferentes. Se existirem " "ficheiros chamados debian/I<pacote>.foo.I<ARCH> ou debian/I<pacote>.foo." "I<OS>, onde I<ARCH> e I<OS> são o mesmo que o resultado de \"B<dpkg-" -"architecture -qDEB_HOST_ARCH>\" / \"B<dpkg-architecture -qDEB_HOST_ARCH_OS>" -"\", então eles irão ser usados em preferência de outros ficheiros mais " -"gerais." +"architecture -qDEB_HOST_ARCH>\" / \"B<dpkg-architecture -" +"qDEB_HOST_ARCH_OS>\", então eles irão ser usados em preferência de outros " +"ficheiros mais gerais." #. type: textblock #: debhelper.pod:94 @@ -661,19 +663,33 @@ msgstr "B<-v>, B<--verbose>" #. type: textblock #: debhelper.pod:277 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." +msgid "Verbose mode: show commands that modify the package build directory." +msgstr "" +"Modo detalhado: mostra todos os comandos que modificam o directório de " +"compilação de pacotes." + +#. type: textblock +#: debhelper.pod:279 +#, fuzzy +#| msgid "" +#| "Verbose mode: show all commands that modify the package build directory." msgid "" -"Verbose mode: show all commands that modify the package build directory." +"Note that verbose mode may also output other \"internal\" commands that do " +"not directly affect the package build directory." msgstr "" "Modo detalhado: mostra todos os comandos que modificam o directório de " "compilação de pacotes." #. type: =item -#: debhelper.pod:279 dh:266 +#: debhelper.pod:282 dh:307 msgid "B<--no-act>" msgstr "B<--no-act>" #. type: textblock -#: debhelper.pod:281 +#: debhelper.pod:284 msgid "" "Do not really do anything. If used with -v, the result is that the command " "will output what it would have done." @@ -682,12 +698,12 @@ msgstr "" "mostra o que iria fazer." #. type: =item -#: debhelper.pod:284 +#: debhelper.pod:287 msgid "B<-a>, B<--arch>" msgstr "B<-a>, B<--arch>" #. type: textblock -#: debhelper.pod:286 +#: debhelper.pod:289 msgid "" "Act on architecture dependent packages that should be built for the " "B<DEB_HOST_ARCH> architecture." @@ -696,22 +712,22 @@ msgstr "" "arquitectura de compilação B<DEB_HOST_ARCH>." #. type: =item -#: debhelper.pod:289 +#: debhelper.pod:292 msgid "B<-i>, B<--indep>" msgstr "B<-i>, B<--indep>" #. type: textblock -#: debhelper.pod:291 +#: debhelper.pod:294 msgid "Act on all architecture independent packages." msgstr "Actua em todos os pacotes independentes da arquitectura." #. type: =item -#: debhelper.pod:293 +#: debhelper.pod:296 msgid "B<-p>I<package>, B<--package=>I<package>" msgstr "B<-p>I<pacote>, B<--package=>I<pacote>" #. type: textblock -#: debhelper.pod:295 +#: debhelper.pod:298 msgid "" "Act on the package named I<package>. This option may be specified multiple " "times to make debhelper operate on a given set of packages." @@ -720,27 +736,27 @@ msgstr "" "vezes para fazer o debhelper operar num determinado conjunto de pacotes." #. type: =item -#: debhelper.pod:298 +#: debhelper.pod:301 msgid "B<-s>, B<--same-arch>" msgstr "B<-s>, B<--same-arch>" #. type: textblock -#: debhelper.pod:300 +#: debhelper.pod:303 msgid "Deprecated alias of B<-a>." msgstr "Alias descontinuado de B<-a>." #. type: textblock -#: debhelper.pod:302 dh_install:80 dh_install:89 +#: debhelper.pod:305 dh_install:80 dh_install:89 msgid "This option is removed in compat 12." msgstr "Esta opção foi removida no nÃvel de compatibilidade 12." #. type: =item -#: debhelper.pod:304 +#: debhelper.pod:307 msgid "B<-N>I<package>, B<--no-package=>I<package>" msgstr "B<-N>I<pacote>, B<--no-package=>I<pacote>" #. type: textblock -#: debhelper.pod:306 +#: debhelper.pod:309 msgid "" "Do not act on the specified package even if an B<-a>, B<-i>, or B<-p> option " "lists the package as one that should be acted on." @@ -749,12 +765,12 @@ msgstr "" "listarem o pacote como um em que se deverá actuar." #. type: =item -#: debhelper.pod:309 +#: debhelper.pod:312 msgid "B<--remaining-packages>" msgstr "B<--remaining-packages>" #. type: textblock -#: debhelper.pod:311 +#: debhelper.pod:314 msgid "" "Do not act on the packages which have already been acted on by this " "debhelper command earlier (i.e. if the command is present in the package " @@ -770,12 +786,12 @@ msgstr "" "definições predefinidas." #. type: =item -#: debhelper.pod:317 +#: debhelper.pod:320 msgid "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" msgstr "B<-P>I<tmpdir>, B<--tmpdir=>I<tmpdir>" #. type: textblock -#: debhelper.pod:319 +#: debhelper.pod:322 msgid "" "Use I<tmpdir> for package build directory. The default is debian/I<package>" msgstr "" @@ -783,12 +799,12 @@ msgstr "" "debian/I<pacote>" #. type: =item -#: debhelper.pod:321 +#: debhelper.pod:324 msgid "B<--mainpackage=>I<package>" msgstr "B<--mainpackage=>I<pacote>" #. type: textblock -#: debhelper.pod:323 +#: debhelper.pod:326 msgid "" "This little-used option changes the package which debhelper considers the " "\"main package\", that is, the first one listed in F<debian/control>, and " @@ -801,12 +817,12 @@ msgstr "" "F<debian/package.foo> usuais." #. type: =item -#: debhelper.pod:328 +#: debhelper.pod:331 msgid "B<-O=>I<option>|I<bundle>" msgstr "B<-O=>I<opção>|I<bundle>" #. type: textblock -#: debhelper.pod:330 +#: debhelper.pod:333 msgid "" "This is used by L<dh(1)> when passing user-specified options to all the " "commands it runs. If the command supports the specified option or option " @@ -819,12 +835,12 @@ msgstr "" "alguma parte do conjunto de opções), será ignorado." #. type: =head1 -#: debhelper.pod:337 +#: debhelper.pod:340 msgid "COMMON DEBHELPER OPTIONS" msgstr "OPÇÕES COMUNS DO DEBHELPER" #. type: textblock -#: debhelper.pod:339 +#: debhelper.pod:342 msgid "" "The following command line options are supported by some debhelper " "programs. See the man page of each program for a complete explanation of " @@ -835,24 +851,24 @@ msgstr "" "sobre o que cada opção faz." #. type: =item -#: debhelper.pod:345 +#: debhelper.pod:348 msgid "B<-n>" msgstr "B<-n>" #. type: textblock -#: debhelper.pod:347 +#: debhelper.pod:350 msgid "Do not modify F<postinst>, F<postrm>, etc. scripts." msgstr "Não modifique os scripts F<postinst>, F<postrm>, etc." #. type: =item -#: debhelper.pod:349 dh_compress:56 dh_dwz:56 dh_installchangelogs:83 -#: dh_installdocs:109 dh_installexamples:80 dh_link:78 dh_makeshlibs:154 +#: debhelper.pod:352 dh_compress:56 dh_dwz:56 dh_installchangelogs:89 +#: dh_installdocs:109 dh_installexamples:84 dh_link:78 dh_makeshlibs:154 #: dh_md5sums:40 dh_shlibdeps:34 dh_strip:42 msgid "B<-X>I<item>, B<--exclude=>I<item>" msgstr "B<-X>I<item>, B<--exclude=>I<item>" #. type: textblock -#: debhelper.pod:351 +#: debhelper.pod:354 msgid "" "Exclude an item from processing. This option may be used multiple times, to " "exclude more than one thing. The I<item> is typically part of a filename, " @@ -864,14 +880,14 @@ msgstr "" "excluÃdo." #. type: =item -#: debhelper.pod:355 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 -#: dh_installdocs:104 dh_installexamples:48 dh_installinfo:45 dh_installman:90 +#: debhelper.pod:358 dh_bugfiles:57 dh_compress:63 dh_installdirs:49 +#: dh_installdocs:104 dh_installexamples:52 dh_installinfo:45 dh_installman:90 #: dh_installwm:55 dh_link:73 msgid "B<-A>, B<--all>" msgstr "B<-A>, B<--all>" #. type: textblock -#: debhelper.pod:357 +#: debhelper.pod:360 msgid "" "Makes files or other items that are specified on the command line take " "effect in ALL packages acted on, not just the first." @@ -881,12 +897,12 @@ msgstr "" "primeiro." #. type: =head1 -#: debhelper.pod:362 +#: debhelper.pod:365 msgid "BUILD SYSTEM OPTIONS" msgstr "OPÇÕES DO SISTEMA DE COMPILAÇÃO" #. type: textblock -#: debhelper.pod:364 +#: debhelper.pod:367 msgid "" "The following command line options are supported by all of the " "B<dh_auto_>I<*> debhelper programs. These programs support a variety of " @@ -904,12 +920,12 @@ msgstr "" "B<dh_auto_>I<*>." #. type: =item -#: debhelper.pod:373 +#: debhelper.pod:376 msgid "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>" msgstr "B<-S>I<buildsystem>, B<--buildsystem=>I<buildsystem>" #. type: textblock -#: debhelper.pod:375 +#: debhelper.pod:378 msgid "" "Force use of the specified I<buildsystem>, instead of trying to auto-select " "one which might be applicable for the package." @@ -918,12 +934,12 @@ msgstr "" "seleccionar um que pode ser aplicável para o pacote." #. type: textblock -#: debhelper.pod:378 +#: debhelper.pod:381 msgid "Pass B<none> as I<buildsystem> to disable auto-selection." msgstr "Passa B<none> como I<buildsystem> para desactivar a auto-selecção." #. type: =item -#: debhelper.pod:380 +#: debhelper.pod:383 msgid "" "B<-D>I<directory>, B<--sourcedir=>I<directory>, B<--" "sourcedirectory=>I<directory>" @@ -932,7 +948,7 @@ msgstr "" "sourcedirectory=>I<directory>" #. type: textblock -#: debhelper.pod:382 +#: debhelper.pod:385 msgid "" "Assume that the original package source tree is at the specified " "I<directory> rather than the top level directory of the Debian source " @@ -943,7 +959,7 @@ msgstr "" "pacotes fonte de Debian." #. type: textblock -#: debhelper.pod:386 +#: debhelper.pod:389 msgid "" "B<Warning>: The B<--sourcedir> variant matches a similar named option in " "B<dh_install> and B<dh_missing> (etc.) for historical reasons. While they " @@ -958,7 +974,7 @@ msgstr "" "(quando então passada para todas as ferramentas)." #. type: =item -#: debhelper.pod:392 +#: debhelper.pod:395 msgid "" "B<-B>[I<directory>], B<--builddir>[I<=directory>], B<--" "builddirectory>[I<=directory>]" @@ -967,7 +983,7 @@ msgstr "" "builddirectory>[I<=directory>]" #. type: textblock -#: debhelper.pod:394 +#: debhelper.pod:397 msgid "" "Enable out of source building and use the specified I<directory> as the " "build directory. If I<directory> parameter is omitted, a default build " @@ -978,7 +994,7 @@ msgstr "" "escolhido o directório de compilação predefinido." #. type: textblock -#: debhelper.pod:398 +#: debhelper.pod:401 msgid "" "If this option is not specified, building will be done in source by default " "unless the build system requires or prefers out of source tree building. In " @@ -991,7 +1007,7 @@ msgstr "" "compilação predefinido mesmo se B<--builddirectory> não seja especificado." #. type: textblock -#: debhelper.pod:403 +#: debhelper.pod:406 msgid "" "If the build system prefers out of source tree building but still allows in " "source building, the latter can be re-enabled by passing a build directory " @@ -1003,12 +1019,12 @@ msgstr "" "o directório fonte." #. type: =item -#: debhelper.pod:407 +#: debhelper.pod:410 msgid "B<--parallel>, B<--no-parallel>" msgstr "B<--parallel>, B<--no-parallel>" #. type: textblock -#: debhelper.pod:409 +#: debhelper.pod:412 msgid "" "Control whether parallel builds should be used if underlying build system " "supports them. The number of parallel jobs is controlled by the " @@ -1022,7 +1038,7 @@ msgstr "" "sistema de compilação." #. type: textblock -#: debhelper.pod:415 +#: debhelper.pod:418 msgid "" "If neither option is specified, debhelper currently defaults to B<--" "parallel> in compat 10 (or later) and B<--no-parallel> otherwise." @@ -1032,7 +1048,7 @@ msgstr "" "no-parallel> em caso contrário." #. type: textblock -#: debhelper.pod:418 +#: debhelper.pod:421 msgid "" "As an optimization, B<dh> will try to avoid passing these options to " "subprocesses, if they are unnecessary and the only options passed. Notably " @@ -1045,12 +1061,12 @@ msgstr "" "I<parallel> (ou o seu valor é 1)." #. type: =item -#: debhelper.pod:423 +#: debhelper.pod:426 msgid "B<--max-parallel=>I<maximum>" msgstr "B<--max-parallel=>I<máximo>" #. type: textblock -#: debhelper.pod:425 +#: debhelper.pod:428 msgid "" "This option implies B<--parallel> and allows further limiting the number of " "jobs that can be used in a parallel build. If the package build is known to " @@ -1064,7 +1080,7 @@ msgstr "" "deseje suportar." #. type: textblock -#: debhelper.pod:430 +#: debhelper.pod:433 msgid "" "Notably, setting the maximum to 1 is effectively the same as using B<--no-" "parallel>." @@ -1073,23 +1089,23 @@ msgstr "" "no-parallel>." #. type: =item -#: debhelper.pod:433 +#: debhelper.pod:436 msgid "B<--reload-all-buildenv-variables>" msgstr "B<--reload-all-buildenv-variables>" #. type: textblock -#: debhelper.pod:435 +#: debhelper.pod:438 msgid "" -"By default, L<dh(1)> will compute several environment (e.g. by using L<dpkg-" -"buildflags(1)>) and cache them to avoid having all B<dh_auto_*> tool " -"recompute them." +"By default, L<dh(1)> will compute several environment variables (e.g. by " +"using L<dpkg-buildflags(1)>) and cache them to avoid having all B<dh_auto_*> " +"tool recompute them." msgstr "" -"Por predefinição, o L<dh(1)> irá computar vários ambientes (ex. ao usar " -"L<dpkg-buildflags(1)>) e guarda-los em cache para evitar que todas as " -"ferramentas B<dh_auto_*> os recompute." +"Por predefinição, o L<dh(1)> irá computar várias variáveis de ambiente (ex. " +"ao usar L<dpkg-buildflags(1)>) e guarda-los em cache para evitar que todas " +"as ferramentas B<dh_auto_*> os recompute." #. type: textblock -#: debhelper.pod:439 +#: debhelper.pod:442 msgid "" "When passing this option, the concrete B<dh_auto_*> tool will ignore the " "cache from L<dh(1)> and retrigger a rebuild of these variables. This is " @@ -1104,7 +1120,7 @@ msgstr "" "precisar de alterar o parâmetro B<-O> em B<CFLAGS> na segunda compilação:" #. type: verbatim -#: debhelper.pod:446 +#: debhelper.pod:449 #, no-wrap msgid "" " export DEB_CFLAGS_MAINT_APPEND=-O3\n" @@ -1114,7 +1130,7 @@ msgstr "" "\n" #. type: verbatim -#: debhelper.pod:448 +#: debhelper.pod:451 #, no-wrap msgid "" " %:\n" @@ -1126,7 +1142,7 @@ msgstr "" "\n" #. type: verbatim -#: debhelper.pod:451 +#: debhelper.pod:454 #, no-wrap msgid "" " override_dh_auto_configure:\n" @@ -1142,7 +1158,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:456 +#: debhelper.pod:459 msgid "" "Without B<--reload-all-buildenv-variables> in the second call to " "L<dh_auto_configure(1)>, the change in B<DEB_CFLAGS_MAINT_APPEND> would be " @@ -1155,7 +1171,7 @@ msgstr "" "definido por L<dh(1)>." #. type: textblock -#: debhelper.pod:461 +#: debhelper.pod:464 msgid "" "This option is only available with B<< debhelper (>= 12.7~) >> when the " "package uses compatibility level 9 or later." @@ -1164,12 +1180,12 @@ msgstr "" "pacote usar nÃvel de compatibilidade 9 ou posterior." #. type: =item -#: debhelper.pod:464 dh:258 +#: debhelper.pod:467 dh:299 msgid "B<--list>, B<-l>" msgstr "B<--list>, B<-l>" #. type: textblock -#: debhelper.pod:466 +#: debhelper.pod:469 msgid "" "List all build systems supported by debhelper on this system. The list " "includes both default and third party build systems (marked as such). Also " @@ -1183,12 +1199,12 @@ msgstr "" "a opção B<--buildsystem>." #. type: =head1 -#: debhelper.pod:473 +#: debhelper.pod:476 msgid "COMPATIBILITY LEVELS" msgstr "NÃVEIS DE COMPATIBILIDADE" #. type: textblock -#: debhelper.pod:475 +#: debhelper.pod:478 msgid "" "From time to time, major non-backwards-compatible changes need to be made to " "debhelper, to keep it clean and well-designed as needs change and its author " @@ -1206,7 +1222,7 @@ msgstr "" "ele deve usar, e ele modifica o seu comportamento de várias maneiras." #. type: textblock -#: debhelper.pod:482 +#: debhelper.pod:485 msgid "" "In current debhelper, you can specify the compatibility level in F<debian/" "control> by adding a Build-Depends on the debhelper-compat package. For " @@ -1218,7 +1234,7 @@ msgstr "" "control> tem:" #. type: verbatim -#: debhelper.pod:486 +#: debhelper.pod:489 #, no-wrap msgid "" " Build-Depends: debhelper-compat (= #RECOMMENDED_COMPAT#)\n" @@ -1228,7 +1244,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:488 +#: debhelper.pod:491 msgid "" "This also serves as an appropriate versioned build dependency on a " "sufficient version of the debhelper package, so you do not need to specify a " @@ -1244,45 +1260,45 @@ msgstr "" "correcção de bug dentro de um nÃvel de compatibilidade)." #. type: textblock -#: debhelper.pod:494 +#: debhelper.pod:497 msgid "" "Note that debhelper does not provide debhelper-compat for experimental or " "beta compatibility levels; packages experimenting with those compatibility " -"levels should use F<debian/compat> or B<DH_COMPAT>." +"levels should use F<debian/compat> (or, if only for selected commands, " +"B<DH_COMPAT>)." msgstr "" "Note que o debhelper não fornece debhelper-compat para os nÃveis de " "compatibilidade experimental ou beta; os pacotes que experimentem com esses " -"nÃveis de compatibilidade devem usar F<debian/compat> ou B<DH_COMPAT>." +"nÃveis de compatibilidade devem usar F<debian/compat> ou, se apenas para " +"comandos selecionados, B<DH_COMPAT>." #. type: textblock -#: debhelper.pod:498 +#: debhelper.pod:501 msgid "" "Prior versions of debhelper required specifying the compatibility level in " "the file F<debian/compat>, and current debhelper still supports this for " -"backward compatibility, though a package may not specify a compatibility " -"level via multiple methods at once. To use this method, F<debian/compat> " -"should contain the compatibility level as a single number, and no other " -"content. If you specify the compatibility level by this method, your package " -"will also need a versioned build dependency on a version of the debhelper " -"package equal to (or greater than) the compatibility level your package " -"uses. So, if you specify compatibility level #RECOMMENDED_COMPAT# in " -"F<debian/compat>, ensure F<debian/control> has:" +"backward compatibility. To use this method, the F<debian/compat> file should " +"contain the compatibility level as a single number, and no other content. If " +"you specify the compatibility level by this method, your package will also " +"need a versioned build dependency on a version of the debhelper package " +"equal to (or greater than) the compatibility level your package uses. So, if " +"you specify compatibility level #RECOMMENDED_COMPAT# in F<debian/compat>, " +"ensure F<debian/control> has:" msgstr "" "As versões anteriores do debhelper requeriam o nÃvel de compatibilidade " "especificado no ficheiro F<debian/compat>, e o debhelper actual ainda " -"suporta isto para compatibilidade com as versões anteriores, apesar de um " -"pacote não poder especificar um nÃvel de compatibilidade via múltiplos " -"métodos de uma vez. Para usar este método, F<debian/compat> deve conter o " -"nÃvel de compatibilidade como um número singular, e nenhum outro conteúdo. " -"Se você especificar o nÃvel de compatibilidade neste método, o seu pacote " -"vai também precisar duma dependência de compilação baseada em versão de uma " -"versão do pacote debhelper igual (ou superior) ao nÃvel de compatibilidade " -"que o seu pacote usa. Assim, se você especificar o nÃvel de compatibilidade " +"suporta isto para compatibilidade com as versões anteriores Para usar este " +"método, o ficheiro F<debian/compat> deve conter o nÃvel de compatibilidade " +"como um número singular, e nenhum outro conteúdo. Se você especificar o " +"nÃvel de compatibilidade neste método, o seu pacote vai também precisar duma " +"dependência de compilação baseada em versão de uma versão do pacote " +"debhelper igual (ou superior) ao nÃvel de compatibilidade que o seu pacote " +"usa. Assim, se você especificar o nÃvel de compatibilidade " "#RECOMMENDED_COMPAT# em F<debian/compat>, assegure-se que F<debian/control> " -"tem:" +"contém:" #. type: verbatim -#: debhelper.pod:509 +#: debhelper.pod:511 #, no-wrap msgid "" " Build-Depends: debhelper (>= #RECOMMENDED_COMPAT#~)\n" @@ -1292,7 +1308,38 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:511 +#: debhelper.pod:513 +msgid "" +"Note that you must use either the build-dependency on debhelper-compat or " +"the F<debian/compat> file. Whenever possible, the debhelper-compat build-" +"dependency is recommended." +msgstr "" +"Note que você usar ou build-dependency em debhelper-compat ou o ficheiro " +"F<debian/compat>. Sempre que possÃvel, é recomendado a build-dependency do " +"debhelper-compat." + +#. type: textblock +#: debhelper.pod:517 +msgid "" +"If needed be, the B<DH_COMPAT> environment variable can be used to override " +"the compat level for a given command. The feature is mostly useful for " +"either temporarily upgrading a few commands to a new compat level or keeping " +"a few commands on a lower compat level. The feature is best used sparingly " +"as it effectively introduces special-cases into the F<debian/rules> file " +"that may be surprising to maintainers or reviewers (or, in the long term, to " +"yourself)." +msgstr "" +"Se necessário, a variável de ambiente B<DH_COMPAT> pode ser usada para " +"sobrepor o nÃvel de compatibilidade para um dado comando. Esta " +"funcionalidade é maioritariamente útil seja para actualizar temporariamente " +"alguns comandos para um novo nÃvel de compatibilidade ou manter alguns " +"comandos num nÃvel de compatibilidade inferior. Esta funcionalidade é melhor " +"ser usada com moderação pois introduz efectivamente casos-especiais no " +"ficheiro F<debian/rules> que podem ser surpreendentes para maintainers ou " +"revisores (ou, a longo prazo, para si)." + +#. type: textblock +#: debhelper.pod:525 msgid "" "Unless otherwise indicated, all debhelper documentation assumes that you are " "using the most recent compatibility level, and in most cases does not " @@ -1308,1169 +1355,1421 @@ msgstr "" "notas acerca do que é diferente nos nÃveis de compatibilidade anteriores." #. type: =head2 -#: debhelper.pod:518 +#: debhelper.pod:532 msgid "Supported compatibility levels" msgstr "NÃveis de compatibilidade suportados" #. type: textblock -#: debhelper.pod:520 -msgid "These are the available compatibility levels:" -msgstr "Estes são os nÃveis de compatibilidade disponÃveis:" - -#. type: =item -#: debhelper.pod:524 debhelper-obsolete-compat.pod:89 -msgid "v5" -msgstr "v5" - -#. type: textblock -#: debhelper.pod:526 debhelper-obsolete-compat.pod:91 -msgid "This is the lowest supported compatibility level." -msgstr "Este é o nÃvel de compatibilidade mais baixo suportado." - -#. type: textblock -#: debhelper.pod:528 +#: debhelper.pod:534 msgid "" -"If you are upgrading from an earlier compatibility level, please review " -"L<debhelper-obsolete-compat(7)>." +"The list of supported compatibility levels and the related upgrade check " +"list has moved to L<debhelper-compat-upgrade-checklist(7)>." msgstr "" -"Se você está a actualizar a partir de um nÃvel de compatibilidade anterior, " -"por favor reveja L<debhelper-obsolete-compat(7)>." +"A lista dos nÃveis de compatibilidade suportados e a lista de verificação de " +"actualizações relacionadas foi movida para L<debhelper-compat-upgrade-" +"checklist(7)>." -#. type: textblock -#: debhelper.pod:531 debhelper.pod:563 debhelper.pod:593 debhelper.pod:624 -#: debhelper.pod:685 debhelper-obsolete-compat.pod:28 -#: debhelper-obsolete-compat.pod:35 debhelper-obsolete-compat.pod:58 -#: debhelper-obsolete-compat.pod:87 -msgid "This mode is deprecated." -msgstr "Este modo está descontinuado." +#. type: =head1 +#: debhelper.pod:537 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 +#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:96 +#: dh_installinit:204 dh_installinitramfs:60 dh_installman:131 +#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 +#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:103 +#: dh_systemd_start:68 +msgid "NOTES" +msgstr "NOTAS" -#. type: =item -#: debhelper.pod:533 -msgid "v6" -msgstr "v6" +#. type: =head2 +#: debhelper.pod:539 +msgid "Multiple binary package support" +msgstr "Suporte a pacotes de múltiplos binários" #. type: textblock -#: debhelper.pod:535 -msgid "Changes from v5 are:" -msgstr "As alterações a partir de v5 são:" - -#. type: =item -#: debhelper.pod:539 debhelper.pod:544 debhelper.pod:550 debhelper.pod:556 -#: debhelper.pod:571 debhelper.pod:578 debhelper.pod:582 debhelper.pod:586 -#: debhelper.pod:601 debhelper.pod:605 debhelper.pod:613 debhelper.pod:618 -#: debhelper.pod:632 debhelper.pod:637 debhelper.pod:644 debhelper.pod:649 -#: debhelper.pod:654 debhelper.pod:662 debhelper.pod:668 debhelper.pod:673 -#: debhelper.pod:678 debhelper.pod:693 debhelper.pod:698 debhelper.pod:704 -#: debhelper.pod:710 debhelper.pod:715 debhelper.pod:721 debhelper.pod:730 -#: debhelper.pod:740 debhelper.pod:746 debhelper.pod:769 debhelper.pod:776 -#: debhelper.pod:782 debhelper.pod:788 debhelper.pod:794 debhelper.pod:823 -#: debhelper.pod:829 debhelper.pod:841 debhelper.pod:849 debhelper.pod:855 -#: debhelper.pod:860 debhelper.pod:865 debhelper.pod:870 debhelper.pod:878 -#: debhelper.pod:888 debhelper.pod:898 debhelper.pod:905 debhelper.pod:917 -#: debhelper.pod:922 debhelper.pod:950 debhelper.pod:967 debhelper.pod:977 -#: debhelper.pod:981 debhelper.pod:986 debhelper.pod:991 debhelper.pod:998 -#: debhelper.pod:1004 debhelper.pod:1012 debhelper.pod:1018 debhelper.pod:1022 -#: debhelper.pod:1027 debhelper.pod:1032 debhelper.pod:1041 debhelper.pod:1057 -#: debhelper.pod:1064 debhelper.pod:1080 debhelper.pod:1088 debhelper.pod:1093 -#: debhelper.pod:1108 debhelper.pod:1116 debhelper.pod:1124 debhelper.pod:1133 -#: debhelper.pod:1139 debhelper.pod:1149 debhelper.pod:1157 debhelper.pod:1163 -#: debhelper.pod:1177 debhelper.pod:1188 debhelper.pod:1202 debhelper.pod:1213 -#: debhelper.pod:1231 debhelper.pod:1245 debhelper-obsolete-compat.pod:43 -#: debhelper-obsolete-compat.pod:48 debhelper-obsolete-compat.pod:52 -#: debhelper-obsolete-compat.pod:66 debhelper-obsolete-compat.pod:71 -#: debhelper-obsolete-compat.pod:76 debhelper-obsolete-compat.pod:81 -#: debhelper-obsolete-compat.pod:97 debhelper-obsolete-compat.pod:101 -#: debhelper-obsolete-compat.pod:106 debhelper-obsolete-compat.pod:110 -#: dh_testroot:36 dh_testroot:41 dh_testroot:46 -msgid "-" -msgstr "-" +#: debhelper.pod:541 +msgid "" +"If your source package generates more than one binary package, debhelper " +"programs will default to acting on all binary packages when run. If your " +"source package happens to generate one architecture dependent package, and " +"another architecture independent package, this is not the correct behavior, " +"because you need to generate the architecture dependent packages in the " +"binary-arch F<debian/rules> target, and the architecture independent " +"packages in the binary-indep F<debian/rules> target." +msgstr "" +"Se o seu pacote fonte gerar mais do que um pacote binário, os programas do " +"debhelper, por predefinição, irão actuar em todos os pacotes binários quando " +"correm. No caso do seu pacote fonte gerar um pacote dependente de " +"arquitectura, e outro pacote independente da arquitectura, este não é o " +"comportamento correcto, porque você precisa de gerar os pacotes dependentes " +"de arquitectura no alvo F<debian/rules> binary-arch, e os pacotes " +"independentes de arquitectura no alvo F<debian/rules> binary-indep." #. type: textblock -#: debhelper.pod:541 +#: debhelper.pod:549 msgid "" -"Commands that generate maintainer script fragments will order the fragments " -"in reverse order for the F<prerm> and F<postrm> scripts." +"To facilitate this, as well as give you more control over which packages are " +"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" +"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " +"are given, debhelper programs default to acting on all packages listed in " +"the control file, with the exceptions below." msgstr "" -"Os comandos que geram fragmentos de script de maintainer irão ordenar os " -"fragmentos em ordem reversa para os scripts F<prerm> e F<postrm>." +"Para facilitar isto, e também para lhe dar mais controle sobre em quais " +"pacotes os programas debhelper actuam, todos os programas debhelper aceitam " +"os parâmetros B<-a>, B<-i>, B<-p>, e B<-s>. Estes parâmetros são " +"cumulativos. Se nenhum for usado, os programas debhelper por predefinição " +"actuam em todos os pacotes listados no ficheiro de controle, com as " +"excepções em baixo." #. type: textblock -#: debhelper.pod:546 +#: debhelper.pod:555 msgid "" -"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." -"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " -"directory." +"First, any package whose B<Architecture> field in B<debian/control> does not " +"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " +"section 5.6.8>)." msgstr "" -"B<dh_installwm> irá instalar uma ligação escrava de manual para F<x-window-" -"manager.1.gz>, se vir o manual em F<usr/share/man/man1> no directório de " -"compilação do pacote." +"Primeiro, qualquer pacote cujo campo B<Architecture> em B<debian/control> " +"não corresponda à arquitectura B<DEB_HOST_ARCH> será excluÃdo (L<Debian " +"Policy, secção 5.6.8>)." #. type: textblock -#: debhelper.pod:552 +#: debhelper.pod:559 msgid "" -"B<dh_builddeb> did not previously delete everything matching " -"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " -"B<CVS:.svn:.git>. Now it does." +"Also, some additional packages may be excluded based on the contents of the " +"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " +"binary package stanzas in B<debian/control>, according to the draft policy " +"at L<https://wiki.debian.org/BuildProfileSpec>." msgstr "" -"O B<dh_builddeb> anteriormente não apagava nada que correspondesse a " -"B<DH_ALWAYS_EXCLUDE>, se estivesse definida uma lista de coisas a excluir, " -"como B<CVS:.svn:.git>. Mas agora fá-lo." +"Também, alguns pacotes adicionais podem ser excluÃdos com base no conteúdo " +"da variável de ambiente B<DEB_BUILD_PROFILES> e nos campos B<Build-Profiles> " +"nas estrofes de pacotes binários em B<debian/control>, de acordo com a " +"polÃtica proposta em L<https://wiki.debian.org/BuildProfileSpec>." + +#. type: =head3 +#: debhelper.pod:564 +msgid "Interaction between package selections and Build-Profiles" +msgstr "Interacção entre selecções de pacotes e Build-Profiles" #. type: textblock -#: debhelper.pod:558 +#: debhelper.pod:566 msgid "" -"B<dh_installman> allows overwriting existing man pages in the package build " -"directory. In previous compatibility levels it silently refuses to do this." +"Build-Profiles affect which packages are included in the package selections " +"mechanisms in debhelper. Generally, the package selections are described " +"from the assumption that all packages are enabled. This section describes " +"how the selections react when a package is disabled due to the active Build-" +"Profiles (or lack of active Build-Profiles)." msgstr "" -"B<dh_installman> permite a sobreposição de manuais existentes no directório " -"de compilação do pacote. Nos nÃveis de compatibilidade anteriores recusava-" -"se em silêncio a fazer isto." +"Build-Profiles afectam quais pacotes são incluÃdos nos mecanismos de " +"selecção de pacotes do debhelper. Geralmente, as selecções de pacotes são " +"descritas a partir do pressuposto que todos os pacotes estão activados. Esta " +"secção descreve como as selecções reagem quando um pacote é desactivado " +"devido a Build-Profiles activos (ou a falta de Build-Profiles activos)." #. type: =item -#: debhelper.pod:565 -msgid "v7" -msgstr "v7" +#: debhelper.pod:574 +msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +msgstr "" +"-a/--arch, -i/--indep OU nenhuma opção de selecção (uma chamada \"dh_X\" " +"crua)" #. type: textblock -#: debhelper.pod:567 -msgid "Changes from v6 are:" -msgstr "As alterações a partir de v6 são:" +#: debhelper.pod:576 +msgid "" +"The package disabled by Build-Profiles is silently excluded from the " +"selection." +msgstr "" +"O pacote desactivado por Build-Profiles é excluÃdo em silêncio da selecção." #. type: textblock -#: debhelper.pod:573 +#: debhelper.pod:579 msgid "" -"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " -"doesn't find them in the current directory (or wherever you tell it look " -"using B<--sourcedir>). This allows B<dh_install> to interoperate with " -"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " -"special parameters." +"Note you will receive a warning if I<all> packages related to these " +"selections are disabled. In that case, it generally does not make sense to " +"do the build in the first place." msgstr "" -"B<dh_install>, irá regressar a procurar por ficheiros em F<debian/tmp> se " -"não os encontrar no directório actual (ou onde você lhe disser para procurar " -"usando B<--sourcedir>). Isto permite ao B<dh_install> inter-operar com o " -"B<dh_auto_install>, o qual instala para F<debian/tmp>, sem precisar de " -"nenhuns parâmetros especiais." +"Note que vai receber um aviso se I<todos> os pacotes relacionados com estas " +"selecções estiverem desactivados. Nesse caso, geralmente não faz nenhum " +"sentido sequer fazer a compilação." + +#. type: =item +#: debhelper.pod:583 +msgid "-N I<package> / --no-package I<package>" +msgstr "-N I<package> / --no-package I<package>" #. type: textblock -#: debhelper.pod:580 -msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." -msgstr "B<dh_clean> irá ler F<debian/clean> e apagar os ficheiros listados lá." +#: debhelper.pod:585 +msgid "The option is accepted and effectively does nothing." +msgstr "A opção é aceite e efectivamente não faz nada." + +#. type: =item +#: debhelper.pod:587 +msgid "-p I<package> / --package I<package>" +msgstr "-p I<package> / --package I<package>" #. type: textblock -#: debhelper.pod:584 -msgid "B<dh_clean> will delete toplevel F<*-stamp> files." -msgstr "B<dh_clean> irá apagar ficheiros F<*-stamp> do nÃvel de topo." +#: debhelper.pod:589 +msgid "The option is accepted, but debhelper will not act on the package." +msgstr "A opção é aceite, mas o debhelper não irá actuar no pacote." #. type: textblock -#: debhelper.pod:588 +#: debhelper.pod:593 msgid "" -"B<dh_installchangelogs> will guess at what file is the upstream changelog if " -"none is specified." +"Note that it does not matter whether a package is enabled or disabled by " +"default." msgstr "" -"B<dh_installchangelogs> irá adivinhar qual ficheiro está no relatório de " -"alterações da origem se nenhum for especificado." - -#. type: =item -#: debhelper.pod:595 -msgid "v8" -msgstr "v8" +"Note que não importa se um pacote está activado ou desactivado por " +"predefinição." -#. type: textblock -#: debhelper.pod:597 -msgid "Changes from v7 are:" -msgstr "As alterações a partir de v7 são:" +#. type: =head2 +#: debhelper.pod:596 +msgid "Automatic generation of Debian install scripts" +msgstr "Geração automática de scripts de instalação Debian" #. type: textblock -#: debhelper.pod:603 +#: debhelper.pod:598 msgid "" -"Commands will fail rather than warning when they are passed unknown options." +"Some debhelper commands will automatically generate parts of Debian " +"maintainer scripts. If you want these automatically generated things " +"included in your existing Debian maintainer scripts, then you need to add " +"B<#DEBHELPER#> to your scripts, in the place the code should be added. " +"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " +"B<dh_installdeb>." msgstr "" -"Os comandos irão falhar em vez de emitirem avisos quando lhes são passadas " -"opções desconhecidas." +"Alguns comandos do debhelper irão gerar automaticamente partes de scripts de " +"maintainer Debian. Se desejar que estas coisas geradas automaticamente sejam " +"incluÃdas nos sues scripts de maintainer Debian existentes, então você " +"precisa adicionar B<#DEBHELPER#> aos seus scripts, no local onde o código " +"deverá ser adicionado. B<#DEBHELPER#> será substituÃdo por qualquer código " +"auto-gerado quando você correr o B<dh_installdeb>." #. type: textblock -#: debhelper.pod:607 +#: debhelper.pod:605 msgid "" -"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " -"generates shlibs files for. So B<-X> can be used to exclude libraries. " -"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " -"processed before will be passed to it, a behavior change that can cause some " -"packages to fail to build." +"If a script does not exist at all and debhelper needs to add something to " +"it, then debhelper will create the complete script." msgstr "" -"B<dh_makeshlibs> irá correr B<dpkg-gensymbols> em todas as bibliotecas " -"partilhadas para as quais gera ficheiros shlibs. Portanto o B<-X> pode ser " -"usado para excluir bibliotecas. Também, as bibliotecas em localizações fora " -"do habitual que o B<dpkg-gensymbols> não tenha processado antes serão " -"passadas para ele, uma alteração no comportamento que pode causar que alguns " -"pacotes falhem a compilar." +"Se não existir nenhum script e o debhelper precisar de adicionar algo a ele, " +"então o debhelper irá criar o script completo." #. type: textblock -#: debhelper.pod:615 +#: debhelper.pod:608 msgid "" -"B<dh> requires the sequence to run be specified as the first parameter, and " -"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo $@>" -"\"." +"All debhelper commands that automatically generate code in this way let it " +"be disabled by the -n parameter (see above)." msgstr "" -"B<dh> requer que a sequência a correr seja especificada como o primeiro " -"parâmetro, e quaisquer switches que venham depois dela. Isto é, use B<dh $@ " -"--foo>\", e não \"B<dh --foo $@>" +"Todos os comandos debhelper que geram código automaticamente deste modo " +"permitem que o seja desactivado pelo parâmetro -n (ver em cima)." #. type: textblock -#: debhelper.pod:620 +#: debhelper.pod:611 msgid "" -"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " -"F<Makefile.PL>." +"Note that the inserted code will be shell code, so you cannot directly use " +"it in a Perl script. If you would like to embed it into a Perl script, here " +"is one way to do that (note that I made sure that $1, $2, etc are set with " +"the set command):" msgstr "" -"B<dh_auto_>I<*> prefere usar o B<Module::Build> do Perl em preferência de " -"F<Makefile.PL>." +"Note que o código inserido será código shell, portanto você não pode usá-lo " +"directamente num script de Perl. Se desejar embebê-lo num script Perl, aqui " +"está um modo de o fazer (note que Eu certifico-me que $1, $2, etc são " +"definidos com o comando \"set\"):" -#. type: =item -#: debhelper.pod:626 -msgid "v9" -msgstr "v9" +#. type: verbatim +#: debhelper.pod:616 +#, no-wrap +msgid "" +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"The debhelper script failed with error code: ${exit_code}\");\n" +" } else {\n" +" die(\"The debhelper script was killed by signal: ${signal}\");\n" +" }\n" +" }\n" +"\n" +msgstr "" +" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" +" #DEBHELPER#\n" +" EOF\n" +" if (system($temp)) {\n" +" my $exit_code = ($? >> 8) & 0xff;\n" +" my $signal = $? & 0x7f;\n" +" if ($exit_code) {\n" +" die(\"The debhelper script failed with error code: ${exit_code}\");\n" +" } else {\n" +" die(\"The debhelper script was killed by signal: ${signal}\");\n" +" }\n" +" }\n" +"\n" -#. type: textblock -#: debhelper.pod:628 -msgid "Changes from v8 are:" -msgstr "As alterações a partir de v8 são:" +#. type: =head2 +#: debhelper.pod:629 +msgid "Automatic generation of miscellaneous dependencies." +msgstr "Geração automática de dependências variadas." #. type: textblock -#: debhelper.pod:634 +#: debhelper.pod:631 msgid "" -"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " -"directories to autoconf in --libdir and --libexecdir." +"Some debhelper commands may make the generated package need to depend on " +"some other packages. For example, if you use L<dh_installdebconf(1)>, your " +"package will generally need to depend on debconf. Or if you use " +"L<dh_installxfonts(1)>, your package will generally need to depend on a " +"particular version of xutils. Keeping track of these miscellaneous " +"dependencies can be annoying since they are dependent on how debhelper does " +"things, so debhelper offers a way to automate it." msgstr "" -"Suporte a multi-arquitectura. Em particular, B<dh_auto_configure> passa " -"directórios de multi-arquitectura ao autoconf em --libdir e --libexecdir." +"Alguns programas debhelper podem fazer com que o pacote gerado precise de " +"depender de alguns outros pacotes. Por exemplo, se você usar o " +"L<dh_installdebconf(1)>, o seu pacote irá geralmente depender do debconf. Ou " +"se você usar L<dh_installxfonts(1)>, o seu pacote irá geralmente depender de " +"uma versão particular do xutils. Acompanhar estas dependências variadas pode " +"ser aborrecido pois elas dependem de como o debhelper faz as coisas, então o " +"debhelper oferece um modo de automatizar isto." #. type: textblock #: debhelper.pod:639 msgid "" -"dh is aware of the usual dependencies between targets in debian/rules. So, " -"\"dh binary\" will run any build, build-arch, build-indep, install, etc " -"targets that exist in the rules file. There's no need to define an explicit " -"binary target with explicit dependencies on the other targets." +"All commands of this type, besides documenting what dependencies may be " +"needed on their man pages, will automatically generate a substvar called " +"B<${misc:Depends}>. If you put that token into your F<debian/control> file, " +"it will be expanded to the dependencies debhelper figures you need." msgstr "" -"O dh tem conhecimento das dependências habituais entre alvos em debian/" -"rules. Por isso, o \"dh binary\" irá correr quaisquer alvos de build, build-" -"arch, build-indep, install, etc que existam no ficheiro de regras. Não há " -"necessidade de definir um alvo binário explÃcito com dependências explÃcitas " -"em outros alvos." +"Todos os comandos deste tipo, além de documentar quais dependências podem " +"ser necessárias nos seus manuais, irão gerar automaticamente um substvar " +"chamado B<${misc:Depends}>. Se você colocar esse token no seu ficheiro " +"F<debian/control>, será expandido à s dependências que o debhelper descobre " +"que você precisa." #. type: textblock -#: debhelper.pod:646 +#: debhelper.pod:644 msgid "" -"B<dh_strip> compresses debugging symbol files to reduce the installed size " -"of -dbg packages." +"This is entirely independent of the standard B<${shlibs:Depends}> generated " +"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " +"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " +"guesses don't match reality." msgstr "" -"B<dh_strip> comprime ficheiros de sÃmbolos de depuração para reduzir o " -"tamanho instalado dos pacotes -dbg." +"Isto é inteiramente independente do standard B<${shlibs:Depends}> gerado " +"pelo L<dh_makeshlibs(1)>, e do B<${perl:Depends}> gerado pelo L<dh_perl(1)>. " +"Você pode escolher usar qualquer um destes, se as escolhas do debhelper não " +"corresponderem à realidade." + +#. type: =head2 +#: debhelper.pod:649 +msgid "Package build directories" +msgstr "Directórios de compilação de pacotes" #. type: textblock #: debhelper.pod:651 msgid "" -"B<dh_auto_configure> does not include the source package name in --" -"libexecdir when using autoconf." +"By default, all debhelper programs assume that the temporary directory used " +"for assembling the tree of files in a package is debian/I<package>." msgstr "" -"B<dh_auto_configure> não inclui o nome do pacote fonte em --libexecdir " -"quando usa autoconf." - -#. type: textblock -#: debhelper.pod:656 -msgid "B<dh> does not default to enabling --with=python-support" -msgstr "B<dh> não tem por predefinição a activação de --with=python-support" +"Por predefinição, todos os programas do debhelper assumem que o directório " +"temporário usado para montar a árvore de ficheiros num pacote é debian/" +"I<pacote>." #. type: textblock -#: debhelper.pod:658 +#: debhelper.pod:654 msgid "" -"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " -"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " -"regardless of compat level)" +"Sometimes, you might want to use some other temporary directory. This is " +"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/" +"tmp>\", will use B<debian/tmp> as the temporary directory. Note that if you " +"use B<-P>, the debhelper programs can only be acting on a single package at " +"a time. So if you have a package that builds many binary packages, you will " +"need to also use the B<-p> flag to specify which binary package the " +"debhelper program will act on." msgstr "" -"(Obsoleto: Pois a ferramenta B<dh_pysupport> foi removida a partir de Debian " -"stretch. Desde o debhelper/10.3, B<dh> já não se activa esta sequência add-" -"on independentemente do nÃvel de compatibilidade)" +"Por vezes, você pode querer usar outro directório temporário. Isto é " +"suportado pela bandeira B<-P>, por exemplo, \"B<dh_installdocs -Pdebian/" +"tmp>\", irá usar B<debian/tmp> como directório temporário. Note que se você " +"usar B<-P>, os programas debhelper só podem actuar num pacote de cada vez. " +"Por isso se tem um pacote que compila muitos pacotes binários, irá também " +"precisar de usar a bandeira B<-p> para especificar em qual pacote binário o " +"programa debhelper irá actuar." + +#. type: =head2 +#: debhelper.pod:662 +msgid "udebs" +msgstr "udebs" +# FIXME : a udeb #. type: textblock #: debhelper.pod:664 msgid "" -"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " -"variables listed by B<dpkg-buildflags>, unless they are already set." +"Debhelper includes support for udebs. To create a udeb with debhelper, add " +"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " +"Debhelper will try to create udebs that comply with debian-installer policy, " +"by making the generated package files end in F<.udeb>, not installing any " +"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " +"and F<config> scripts, etc." msgstr "" -"Todos os programas debhelper B<dh_auto_>I<*> e B<dh> definem variáveis de " -"ambiente listadas por B<dpkg-buildflags>, a menos que elas estejam já " -"definidas." +"Debhelper inclui suporte para udebs. Para criar um udeb com o debhelper, " +"adicione \"B<Package-Type: udeb>\" à estrofe do pacote em F<debian/control>. " +"O Debhelper irá tentar criar udebs em conformidade com a polÃtica do " +"instalador debian, ao finalizar os ficheiros de pacotes gerados com F<." +"udeb>, não instalando nenhuma documentação num udeb, saltando os scripts " +"F<preinst>, F<postrm>, F<prerm>, e F<config>, etc." + +#. type: =head1 +#: debhelper.pod:671 +msgid "ENVIRONMENT" +msgstr "AMBIENTE" #. type: textblock -#: debhelper.pod:670 +#: debhelper.pod:673 msgid "" -"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " -"to perl F<Makefile.PL> and F<Build.PL>" +"This section describes some of the environment variables that influences the " +"behaviour of debhelper or which debhelper interacts with." msgstr "" -"B<dh_auto_configure> passa as B<dpkg-buildflags> CFLAGS, CPPFLAGS, e LDFLAGS " -"para F<Makefile.PL> e F<Build.PL> de perl." +"Esta secção descreve algumas das variáveis de ambiente que influenciam o " +"comportamento do debhelper ou de quem o debhelper interage." #. type: textblock -#: debhelper.pod:675 +#: debhelper.pod:676 msgid "" -"B<dh_strip> puts separated debug symbols in a location based on their build-" -"id." +"It is important to note that these must be actual environment variables in " +"order to affect the behaviour of debhelper (not simply F<Makefile> " +"variables). To specify them properly in F<debian/rules>, be sure to " +"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." msgstr "" -"B<dh_strip> põe sÃmbolos de depuração separados numa localização baseada no " -"seu build-id." +"É importante notar que estas que estas têm de ser mesmo variáveis de " +"ambiente de modo a afectarem o comportamento do debhelper (e não " +"simplesmente variáveis do F<Makefile>). Para as especificar correctamente em " +"F<debian/rules>, assegure-se de lhes fazer \"B<export>\". Por exemplo, " +"\"B<export DH_VERBOSE>\"" + +#. type: =item +#: debhelper.pod:683 +msgid "B<DH_VERBOSE>" +msgstr "B<DH_VERBOSE>" #. type: textblock -#: debhelper.pod:680 +#: debhelper.pod:685 msgid "" -"Executable debhelper config files are run and their output used as the " -"configuration." +"Set to a non-empty value to enable verbose mode. Please see the B<-v> / B<--" +"verbose> option for details." msgstr "" -"Os ficheiros de configuração executáveis do debhelper são corridos e os seus " -"resultados usados como configuração." #. type: =item -#: debhelper.pod:687 -msgid "v10" -msgstr "v10" +#: debhelper.pod:688 +msgid "B<DH_QUIET>" +msgstr "B<DH_QUIET>" #. type: textblock -#: debhelper.pod:689 -msgid "Changes from v9 are:" -msgstr "As alterações a partir de v9 são:" +#: debhelper.pod:690 +#, fuzzy +#| msgid "" +#| "Set to B<1> to enable quiet mode. Debhelper will not output commands " +#| "calling the upstream build system nor will dh print which subcommands are " +#| "called and depending on the upstream build system might make that more " +#| "quiet, too. This makes it easier to spot important messages but makes " +#| "the output quite useless as buildd log. Ignored if DH_VERBOSE is also " +#| "set." +msgid "" +"Set to a non-empty value to enable quiet mode. Debhelper will not output " +"commands calling the upstream build system nor will dh print which " +"subcommands are called and depending on the upstream build system might make " +"that more quiet, too. This makes it easier to spot important messages but " +"makes the output quite useless as buildd log." +msgstr "" +"Definir para B<1> para activar o modo silencioso. O Debhelper não irá " +"escrever os comandos a chamar o sistema de compilação do autor nem o dh irá " +"escrever quais sub-comandos são chamados e dependendo do sistema de " +"compilação do autor, poderá também tornar isso mais silencioso. Isto " +"facilita a identificação de mensagens importantes mas torna os resultados " +"inúteis como relatório do buildd. É ignorado se DH_VERBOSE for também " +"definido." #. type: textblock -#: debhelper.pod:695 -msgid "" -"B<dh_installinit> will no longer install a file named debian/I<package> as " -"an init script." +#: debhelper.pod:696 +msgid "Ignored if DH_VERBOSE is also set or B<-v> / B<--verbose> is passed." msgstr "" -"B<dh_installinit> não irá mais instalar um ficheiro chamado debian/I<pacote> " -"como um script de iniciação (init)." + +#. type: =item +#: debhelper.pod:698 +msgid "B<DH_COMPAT>" +msgstr "B<DH_COMPAT>" #. type: textblock #: debhelper.pod:700 msgid "" -"B<dh_installdocs> will error out if it detects links created with --link-doc " -"between packages of architecture \"all\" and non-\"all\" as it breaks " -"binNMUs." +"Temporarily specifies what compatibility level debhelper should run at, " +"overriding any value specified via Build-Depends on debhelper-compat or via " +"the F<debian/compat> file." msgstr "" -"O B<dh_installdocs> irá dar erro se detectar links criados com --link-doc " -"entre pacotes de arquitectura \"all\" e não-\"all\" porque isso faz quebrar " -"binNMUs." +"Especifica temporariamente em que nÃvel de compatibilidade o debhelper deve " +"correr, sobrepondo qualquer valor especificado via Build-Depend em debhelper-" +"compat ou via ficheiro F<debian/compat>." + +#. type: =item +#: debhelper.pod:704 +msgid "B<DH_NO_ACT>" +msgstr "B<DH_NO_ACT>" #. type: textblock #: debhelper.pod:706 -msgid "" -"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." -"shlibs file. This is now done by B<dh_makeshlibs> instead." -msgstr "" -"O B<dh_installdeb> já não instala um ficheiro debian/I<pacote>.shlibs " -"disponibilizado pelo maintainer. Em vez disso, isto agora é feito pelo " -"B<dh_makeshlibs>." +msgid "Set to B<1> to enable no-act mode." +msgstr "Defina para B<1> para activar o modo no-act." + +#. type: =item +#: debhelper.pod:708 +msgid "B<DH_OPTIONS>" +msgstr "B<DH_OPTIONS>" #. type: textblock -#: debhelper.pod:712 +#: debhelper.pod:710 msgid "" -"B<dh_installwm> refuses to create a broken package if no man page can be " -"found (required to register for the x-window-manager alternative)." +"All debhelper tools will parse command line arguments listed in this " +"variable before any command option (as if they had been prepended to the " +"command line arguments). Unfortunately, some third-party provided tools may " +"not support this variable and will ignore these command line arguments." msgstr "" -"O B<dh_installwm> recusa-se a criar um pacote quebrado se não encontrar " -"nenhuma página de manual (necessário para registo para a alternativa do x-" -"window-manager)." +"Todas as ferramentas debhelper irão processar os argumentos de linha de " +"comandos listados nesta variável antes de qualquer opção de comando (como se " +"eles fossem anexados aos argumentos de linha de comandos). Infelizmente, " +"algumas ferramentas disponibilizadas por terceiros podem não suportar esta " +"variável e irão ignorar estes argumentos de linha de comandos." #. type: textblock -#: debhelper.pod:717 +#: debhelper.pod:715 msgid "" -"Debhelper will default to B<--parallel> for all buildsystems that support " -"parallel building. This can be disabled by using either B<--no-parallel> or " -"passing B<--max-parallel> with a value of 1." +"When using L<dh(1)>, it can be passed options that will be passed on to each " +"debhelper command, which is generally better than using DH_OPTIONS." msgstr "" -"Debhelper irá predefinir para B<--parallel> em todos os sistemas de " -"compilação que suportam compilação paralela. Isto pode ser desactivado " -"usando B<--no-parallel> ou passando B<--max-parallel> com o valor de 1." +"Quando se usa L<dh(1)>, podem-se passar opções que irão ser passadas a cada " +"comando do debhelper, o que é geralmente melhor do que usar DH_OPTIONS." + +#. type: =item +#: debhelper.pod:718 +msgid "B<DH_ALWAYS_EXCLUDE>" +msgstr "B<DH_ALWAYS_EXCLUDE>" #. type: textblock -#: debhelper.pod:723 +#: debhelper.pod:720 msgid "" -"The B<dh> command will not accept any of the deprecated \"manual sequence " -"control\" parameters (B<--before>, B<--after>, etc.). Please use override " -"targets instead." +"If set, this adds the value the variable is set to to the B<-X> options of " +"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " +"B<rm -rf> anything that matches the value in your package build tree." msgstr "" -"O comando B<dh> não irá aceitar nenhum dos parâmetros de \"controle de " -"sequência manua\" descontinuados (B<--before>, B<--after>, etc.). Por favor " -"utilize alvos de sobreposição em vez destes." +"Se definido, isto adiciona o valor que está definido na variável à s opções " +"B<-X> de todos os comandos que suportam a opção B<-X>. Ainda mais, o " +"B<dh_builddeb> irá fazer B<rm -rf> a tudo o que corresponda a esse valor na " +"sua árvore de compilação do pacote." #. type: textblock -#: debhelper.pod:727 +#: debhelper.pod:724 msgid "" -"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " -"any of these since debhelper/12.4." +"This can be useful if you are doing a build from a CVS source tree, in which " +"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " +"sneaking into the package you build. Or, if a package has a source tarball " +"that (unwisely) includes CVS directories, you might want to export " +"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " +"your package is built." msgstr "" -"B<Retroactively applied to earlier compat levels>: B<dh> já não aceita " -"nenhum destes desde o debhelper/12.4." +"Isto pode ser útil se você está a fazer uma compilação a partir de uma " +"árvore fonte CVS, que no caso definindo B<DH_ALWAYS_EXCLUDE=CVS> irá " +"prevenir que quaisquer directórios CVS se esgueirem para o pacote que está a " +"compilar. Ou, se um pacote tem um tarball de fonte que (não " +"inteligentemente) inclui directórios CVS, você pode querer exportar " +"B<DH_ALWAYS_EXCLUDE=CVS> em F<debian/rules>, para o fazer ter efeito onde o " +"seu é compilado." #. type: textblock -#: debhelper.pod:732 +#: debhelper.pod:731 msgid "" -"The B<dh> command will no longer use log files to track which commands have " -"been run. The B<dh> command I<still> keeps track of whether it already ran " -"the \"build\" sequence and skip it if it did." +"Multiple things to exclude can be separated with colons, as in " +"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" msgstr "" -"O comando B<dh> não irá mais usar ficheiros log para seguir quais comandos " -"foram executados. O comando B<dh> I<ainda> mantêm o seguimento se já correu " -"a sequência de \"compilação\" e salta-a se já o fez." +"Várias coisas a excluir podem ser separadas com \"dois pontos\", como em " +"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" + +#. type: =item +#: debhelper.pod:734 +msgid "B<DH_EXTRA_ADDONS>" +msgstr "B<DH_EXTRA_ADDONS>" #. type: textblock #: debhelper.pod:736 -msgid "The main effects of this are:" -msgstr "Os principais efeitos disto são:" +msgid "" +"If set, this adds the specified dh addons to be run in the appropriate " +"places in the sequence of commands. This is equivalent to specifying the " +"addon to run with the --with flag in the debian/rules file. Any --without " +"calls specifying an addon in this environment variable will not be run." +msgstr "" +"Se definido, isto adiciona os addons especificados do dh para serem corridos " +"nos lugares apropriados na sequência de comandos. Isto é equivalente a " +"especificar o addon a correr coma bandeira --with no ficheiro debian/rules " +"file. Qualquer chamada --without que especifique um addon nesta variável de " +"ambiente não será executada." #. type: textblock -#: debhelper.pod:742 +#: debhelper.pod:741 msgid "" -"With this, it is now easier to debug the I<install> or/and I<binary> " -"sequences because they can now trivially be re-run (without having to do a " -"full \"clean and rebuild\" cycle)" +"This is intended to be used by downstreams or specific local configurations " +"that require a debhelper addon to be run during multiple builds without " +"having to patch a large number of rules file. If at all possible, this " +"should be avoided in favor of a --with flag in the rules file." msgstr "" -"Com isto, é agora mais fácil de depurar as sequências I<install> ou/e " -"I<binary> porque agora podem ser trivialmente re-executadas (sem ter que " -"fazer um ciclo de \"limpar e recompilar\" completo." +"Isto destina-se a ser usado por downstreams ou configurações locais " +"especificas que requeiram a execução dum addon do debhelper durante " +"múltiplas compilações sem terem que aplica patch a um grande número de " +"ficheiros de regras. Se de todo possÃvel, isto deve ser evitado em favor de " +"uma bandeira --with no ficheiro rules." + +#. type: =item +#: debhelper.pod:746 +msgid "B<DH_COLORS>, B<DPKG_COLORS>" +msgstr "B<DH_COLORS>, B<DPKG_COLORS>" #. type: textblock #: debhelper.pod:748 msgid "" -"The main caveat is that B<dh_*> now only keeps track of what happened in a " -"single override target. When all the calls to a given B<dh_cmd> command " -"happens in the same override target everything will work as before." +"These variables can be used to control whether debhelper commands should use " +"colors in their textual output. Can be set to \"always\", \"auto\" (the " +"default), or \"never\"." msgstr "" -"O principal embargo é que B<dh_*> agora apenas mantêm acompanhamento do que " -"aconteceu num alvo de sobreposição singular. Quanto todas as chamadas a um " -"dado comando B<dh_cmd> acontecem no mesmo alvo de sobreposição tudo irá " -"funcionar como dantes." +"Estas variáveis podem ser usadas para controlar se os comandos do debhelper " +"devem usar cores nos resultados textuais. Podem ser definidas para " +"\"always\", \"auto\" (a predefinição), ou \"never\"." #. type: textblock -#: debhelper.pod:753 -msgid "Example of where it can go wrong:" -msgstr "Exemplo de onde pode falhar:" - -#. type: verbatim -#: debhelper.pod:755 -#, no-wrap +#: debhelper.pod:752 msgid "" -" override_dh_foo:\n" -" dh_foo -pmy-pkg\n" -"\n" +"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " +"debhelper uses it on the assumption that you want the same color setting for " +"dpkg and debhelper. In the off-hand chance you want different color setting " +"for debhelper, you can use B<DH_COLORS> instead or in addition to " +"B<DPKG_COLORS>." msgstr "" -" override_dh_foo:\n" -" dh_foo -pmy-pkg\n" -"\n" +"Note que B<DPKG_COLOR> também afecta um número de ferramentas relacionadas " +"ao dpkg e o debhelper usa-o na suposição que você quer a mesma definição de " +"cor para o dpkg e debhelper. Na hipótese de você querer definição de cor " +"diferente para o debhelper, pode usar B<DH_COLORS> em vez disso ou em adição " +"a B<DPKG_COLORS>." -#. type: verbatim +#. type: =item #: debhelper.pod:758 -#, no-wrap +msgid "B<NO_COLOR>" +msgstr "B<NO_COLOR>" + +#. type: textblock +#: debhelper.pod:760 msgid "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" +"If no explicit request for color has been given (e.g. B<DH_COLORS> and " +"B<DPKG_COLORS> are both unset), the presence of this environment variable " +"cause the default color setting to be \"never\"." msgstr "" -" override_dh_bar:\n" -" dh_bar\n" -" dh_foo --remaining\n" -"\n" +"Se não for fornecido um pedido especÃfico para cor (ex. B<DH_COLORS> e " +"B<DPKG_COLORS> estão ambos não-definidos), a presença desta variável de " +"ambiente faz com que a definição de cor predefinida seja \"never\"." #. type: textblock -#: debhelper.pod:762 +#: debhelper.pod:764 msgid "" -"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" -"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " -"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." +"The variable is defined according to L<https://no-color.org/>. In this " +"project, the environment variables (such as B<DH_COLORS>) are considered an " +"explicit request for color." msgstr "" -"Neste caso, a chamada a B<dh_foo --remaining> irá I<também> incluir I<my-" -"pkg>, desde que B<dh_foo -pmy-pkg> tenha corrido num alvo de sobreposição " -"separado. Este problema não está imitado a B<--remaining>, mas também inclui " -"B<-a>, B<-i>, etc." +"A variável é definida de acordo com L<https://no-color.org/>. Neste " +"projecto, as variáveis de ambiente (tais como B<DH_COLORS>) são consideradas " +"um requisito explÃcito para cor." -#. type: textblock -#: debhelper.pod:771 +#. type: =item +#: debhelper.pod:768 msgid "" -"The B<dh_installdeb> command now shell-escapes the lines in the " -"F<maintscript> config file. This was the original intent but it did not " -"work properly and packages have begun to rely on the incomplete shell " -"escaping (e.g. quoting file names)." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" msgstr "" -"O comando B<dh_installdeb> agora faz \"escape de shell\" à s linhas no " -"ficheiro de configuração de F<maintscript>. Esta foi a intenção original mas " -"não trabalhava correctamente e os pacotes começaram a confiar no \"escapar " -"de shell\" incompleto (ex. ao mencionar nomes de ficheiros)." +"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " +"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" #. type: textblock -#: debhelper.pod:778 +#: debhelper.pod:770 msgid "" -"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " -"For packages needing the previous behaviour, please use B<--no-restart-after-" -"upgrade>." +"By default (in any non-deprecated compat level), debhelper will " +"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " +"unset. If you need to change the default flags, please use the features " +"from L<dpkg-buildflags(1)> to do this (e.g. " +"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" +"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." msgstr "" -"O comando B<dh_installinit> agora usa por predefinição B<--restart-after-" -"upgrade>. Para pacotes que precisam do comportamento anterior, por favor use " -"B<--no-restart-after-upgrade>." +"Por predefinição (em qualquer nÃvel de compatibilidade não-abandonado). o " +"debhelper irá automaticamente definir estas flags ao usar L<dpkg-" +"buildflags(1)>, quando não estiverem definidas. Se você precisar de " +"modificar as flags predefinidas, por favor use as funcionalidades de L<dpkg-" +"buildflags(1)> para o fazer (ex. B<DEB_BUILD_MAINT_OPTIONS=hardening=all> ou " +"B<DEB_CPPFLAGS_MAINT_APPEND=-DCUSTOM_MACRO=true>) em vez de definir a " +"variável concreta directamente." + +#. type: =item +#: debhelper.pod:777 +msgid "B<HOME>, B<XDG_*>" +msgstr "B<HOME>, B<XDG_*>" #. type: textblock -#: debhelper.pod:784 +#: debhelper.pod:779 msgid "" -"The B<autoreconf> sequence is now enabled by default. Please pass B<--" -"without autoreconf> to B<dh> if this is not desirable for a given package" +"In compat 13 and later, these environment variables are reset before " +"invoking the upstream build system via the B<dh_auto_*> helpers. The " +"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " +"(B<dh_auto_test> only) will be set to a writable directory. All remaining " +"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " +"cleared." msgstr "" -"A sequência B<autoreconf> é agora activada por predefinição. Por favor passe " -"B<--without autoreconf> ao B<dh> se isto não for desejável para um " -"determinado pacote" +"Em compatibilidade 13 e posterior, estas variáveis de ambiente são " +"reiniciadas antes de invocar o sistema de compilação do autor via ajudantes " +"do B<dh_auto_*>. As variáveis B<HOME> (todos os ajudantes B<dh_auto_*>) e " +"B<XDG_RUNTIME_DIR> (apenas B<dh_auto_test>) irão ser definidas para um " +"directório gravável. Todas as restantes variáveis e B<XDG_RUNTIME_DIR> " +"(excepto para durante B<dh_auto_test>) irão ser limpas." #. type: textblock -#: debhelper.pod:790 +#: debhelper.pod:785 msgid "" -"The B<systemd> sequence is now enabled by default. Please pass B<--without " -"systemd> to B<dh> if this is not desirable for a given package." +"The B<HOME> directory will be created as an empty directory but it will be " +"reused between calls to B<dh_auto_*>. Any content will persist until " +"explicitly deleted or B<dh_clean>." msgstr "" -"A sequência B<systemd> é agora activada por predefinição. Por favor passe " -"B<--without systemd> ao B<dh> se isto não for desejável para um determinado " -"pacote." +"O directório B<HOME> será criado como um directório vazio mas ele será " +"reutilizado entre chamadas a B<dh_auto_*>. Qualquer conteúdo irá persistir " +"até ser explicitamente apagado ou B<dh_clean>." + +#. type: =item +#: debhelper.pod:789 +msgid "B<DEB_BUILD_OPTIONS>" +msgstr "B<DEB_BUILD_OPTIONS>" #. type: textblock -#: debhelper.pod:796 +#: debhelper.pod:791 msgid "" -"B<Retroactively removed>: B<dh> no longer creates the package build " -"directory when skipping running debhelper commands. This will not affect " -"packages that only build with debhelper commands, but it may expose bugs in " -"commands not included in debhelper." +"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " +"variable." msgstr "" -"B<Retroactively removed> B<dh> já não cria o directório de compilação do " -"pacote quando salta a execução de comandos debhelper. Isto não vai afectar " -"pacotes que apenas compilam com comandos debhelper, mas pode expor bugs em " -"comandos não incluÃdos no debhelper." +"Por favor veja L</Bandeiras suportadas em DEB_BUILD_OPTIONS> para esta " +"variável de ambiente." #. type: textblock -#: debhelper.pod:801 +#: debhelper.pod:794 msgid "" -"This compatibility feature had a bug since its inception in " -"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " -"there has been no reports of issues caused by this bug in those ~5 years, " -"this item have been removed rather than fixed." +"Please note that this variable should I<not> be altered by package " +"maintainers inside F<debian/rules> to change the behaviour of debhelper. " +"Instead, where the package maintainer need these features, they should look " +"disabling the relevant feature directly (e.g. by overriding the concrete " +"tools)." msgstr "" -"Esta funcionalidade de compatibilidade tinha um bug desde a sua inserção no " -"debhelper/9.20130516 que o fazia falhar ao aplicar em compatibilidade 9 e " -"anteriores. Como não tem havido relatórios de problemas causados por este " -"bug nesses -5 anos, este item foi removido em vez de corrigido." +"Por favor note que esta variável I<não> deve ser alterada por maintainers de " +"pacote dentro de F<debian/rules> para mudar o comportamento do debhelper. Em " +"vez disso, onde o maintainer do pacote precisar destas funcionalidades, eles " +"devem procurar desactivar a funcionalidade relevante directamente (ex. ao " +"sobrepor as ferramentas concretas)." #. type: =item -#: debhelper.pod:808 -msgid "v11" -msgstr "v11" +#: debhelper.pod:799 +msgid "B<DEB_BUILD_MAINT_OPTIONS>" +msgstr "B<DEB_BUILD_MAINT_OPTIONS>" #. type: textblock -#: debhelper.pod:810 -msgid "This mode is discouraged." -msgstr "Este modo está desencorajado." +#: debhelper.pod:801 +msgid "" +"This is a dpkg specific environment variable (see e.g. L<dpkg-" +"buildflags(1)>). The debhelper tool suite silently ignores it." +msgstr "" +"Esta é uma variável de ambiente especifica do dpkg (veja por ex. L<dpkg-" +"buildflags(1)>). A suite de ferramentas do debhelper ignora-a em silêncio." #. type: textblock -#: debhelper.pod:812 +#: debhelper.pod:804 msgid "" -"The compat 11 is discouraged for new packages as it suffers from feature " -"interaction between L<dh_installinit> and L<dh_installsystemd> causing " -"services to not run correctly in some cases. Please consider using " -"compatibility mode 10 or 12 instead. More details about the issue are " -"available in Debian#887904 and L<https://lists.debian.org/debian-" -"release/2019/04/msg01442.html>." +"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " +"which make some people mistakenly assume that debhelper will also react to " +"this variable." msgstr "" -"A compatibilidade 11 é desencorajada para novos pacotes pois sofre de " -"interação de caracterÃsticas entre L<dh_installinit> e L<dh_installsystemd> " -"o que causa com que os serviços não funcionem correctamente em alguns casos. " -"Por favor considere usar modo de compatibilidade 10 ou 12 em vez deste. " -"Mais detalhes sobre este problema estão disponÃveis em Debian#887904 e " -"L<https://lists.debian.org/debian-release/2019/04/msg01442.html>." +"Está documentada aqui porque tem um nome semelhante a B<DEB_BUILD_OPTIONS>, " +"o que faz com que algumas pessoas assumam em erro que o debhelper também vai " +"reagir a esta variável." + +#. type: =head2 +#: debhelper.pod:810 +msgid "Supported flags in DEB_BUILD_OPTIONS" +msgstr "Bandeiras suportadas em DEB_BUILD_OPTIONS" #. type: textblock -#: debhelper.pod:819 -msgid "Changes from v10 are:" -msgstr "As alterações a partir de v10 são:" +#: debhelper.pod:812 +msgid "" +"The debhelper tool suite reacts to the following flags in " +"B<DEB_BUILD_OPTIONS>." +msgstr "" +"A suite de ferramentas debhelper reage à s seguintes bandeiras em " +"B<DEB_BUILD_OPTIONS>." + +#. type: =item +#: debhelper.pod:816 +msgid "B<dherroron=obsolete-compat-levels>" +msgstr "B<dherroron=obsolete-compat-levels>" + +#. type: textblock +#: debhelper.pod:818 +msgid "I<This is a debhelper specific value.>" +msgstr "I<Este é um valor especÃfico do debhelper.>" #. type: textblock -#: debhelper.pod:825 +#: debhelper.pod:820 msgid "" -"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " -"generates maintainer scripts for those files. Please use the new " -"B<dh_installsystemd> helper." +"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " +"debhelper tools will promote deprecation warnings for usage of old soon to " +"be removed compat levels into errors." msgstr "" -"B<dh_installinit> já não instala ficheiros F<service> ou F<tmpfile>, nem " -"gera scripts do maintainer para esses ficheiros, Por favor use o novo " -"ajudante B<dh_installsystemd>" +"Quando B<dherroron> está presente e definida para B<obsolete-compat-levels>, " +"então as ferramentas debhelper irão promover para erros os avisos de " +"descontinuidade de nÃveis de compatibilidade antigos e prestes a serem " +"removidos." #. type: textblock -#: debhelper.pod:831 +#: debhelper.pod:824 msgid "" -"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " -"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " -"sequence for B<dh> has also been removed. If you need to disable the " -"B<dh_installsystemd> helper tool, please use an empty override target." +"This is useful for automated checking for code relying on deprecated compat " +"levels that is scheduled for removal." msgstr "" -"Os ajudantes B<dh_systemd_enable>e B<dh_systemd_start> foram substituÃdos " -"pelo novo ajudante B<dh_installsystemd>. Pela mesma razão, a sequência do " -"B<systemd> para B<dh> foi também removida. Se você precisar de desactivar a " -"ferramenta de ajuda B<dh_installsystemd>, por favor use um alvo de " -"sobreposição vazio." +"Isto é útil para verificação automática de confiança de código em nÃveis de " +"compatibilidade descontinuados que estão agendados para remoção." + +#. type: textblock +#: debhelper.pod:827 +msgid "This option is intended for testing purposes; not production builds." +msgstr "" +"Esta opção destina-se a objectivos de teste; não compilações produtivas." + +#. type: =item +#: debhelper.pod:829 +msgid "B<nostrip>" +msgstr "B<nostrip>" #. type: textblock -#: debhelper.pod:837 +#: debhelper.pod:831 debhelper.pod:854 debhelper.pod:868 msgid "" -"Please note that the B<dh_installsystemd> tool has a slightly different " -"behaviour in some cases (e.g. when using the B<--name> parameter)." +"I<This value will change the content of the debs being built. The .deb " +"packages built when this is set is therefore not bit-for-bit reproducible " +"with a regular build in the general case.>" msgstr "" -"Por favor note que a ferramenta B<dh_installsystemd> tem um comportamento " -"ligeiramente diferente em alguns casos (ex. quando se usa o parâmetro B<--" -"name>)." +"I<Este valor irá mudar o conteúdo dos debs a serem compilados. Os pacotes ." +"deb compilados quando isto está definido são por isto não reproduzÃveis bit-" +"a-bit com uma compilação regular nas generalidade dos casos.>" #. type: textblock -#: debhelper.pod:843 +#: debhelper.pod:835 msgid "" -"B<dh_installdirs> no longer creates debian/I<package> directories unless " -"explicitly requested (or it has to create a subdirectory in it)." +"This value will cause the official debhelper tools will skip actions and " +"helpers that either remove, detach or deduplicate debugging symbols in ELF " +"binaries." msgstr "" -"B<dh_installdirs> já não cria directórios debian/I<pacote> a menos que tal " -"seja explicitamente pedido (ou se tiver de criar um sub-directório nele)." +"Este valor irá fazer com que as ferramentas oficiais debhelper saltem acções " +"e ajudantes que ou removem, desanexam ou duplicam sÃmbolos em binários ELF." #. type: textblock -#: debhelper.pod:847 -msgid "The vast majority of all packages will be unaffected by this change." -msgstr "A grande maioria dos pacotes não serão afectados por esta alteração." +#: debhelper.pod:839 +msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." +msgstr "Este valor afecta L<dh_dwz(1)> e L<dh_strip(1)>." + +#. type: =item +#: debhelper.pod:841 +msgid "B<nocheck>" +msgstr "B<nocheck>" #. type: textblock -#: debhelper.pod:851 +#: debhelper.pod:843 msgid "" -"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" -"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " -"or B<cmake>) are unaffected by this change." +"This value will cause the official debhelper build systems to skip runs of " +"upstream test suites." msgstr "" -"O sistema de compilação B<makefile> agora passa B<INSTALL=\"install --strip-" -"program=true\"> para o L<make(1)>. Sistemas de compilação derivativos (ex. " -"B<configure> ou B<cmake>) não são afectados por esta alteração." +"Este valor irá fazer com que os sistemas de compilação oficiais debhelper " +"saltem execuções de suites de testes do autor original." #. type: textblock -#: debhelper.pod:857 +#: debhelper.pod:846 msgid "" -"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" -"configure>." +"Package maintainers looking to avoid running the upstream tests should " +"B<not> rely on this. Instead, they can add an empty override target to skip " +"B<dh_auto_test>." msgstr "" -"O sistema de compilação B<autoconf> agora passa B<--runstatedir=/run> para " -"F<./configure>." +"Os maintainers de pacotes que procurem evitar correr os testes do autor " +"B<não> devem confiar nisto. Em vez disto, eles podem adicionar um alvo de " +"sobreposição vazio para saltar o B<dh_auto_test>." + +#. type: textblock +#: debhelper.pod:850 +msgid "This value affects L<dh_auto_test(1)>." +msgstr "Este valor afecta L<dh_auto_test(1)>." + +#. type: =item +#: debhelper.pod:852 +msgid "B<nodoc>" +msgstr "B<nodoc>" #. type: textblock -#: debhelper.pod:862 +#: debhelper.pod:858 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " -"L<cmake(1)>." +"This value will cause several debhelper tools to skip installation of " +"documentation such as manpages or upstream provided documentation. " +"Additionally, the tools will also ignore if declared documentation is " +"\"missing\" on the assumption that the documentation has not been built." msgstr "" -"O sistema de compilação B<cmake> agora passa B<-DCMAKE_INSTALL_RUNSTATEDIR=/" -"run> para L<cmake(1)>." +"Este valor irá fazer com que várias ferramentas debhelper saltem a " +"instalação de documentação tal como os manuais ou documentação fornecida " +"pelo autor original. Adicionalmente, as ferramentas irão também ignorar se a " +"documentação declarada está \"em falta\" assumindo que a documentação não " +"foi compilada." #. type: textblock -#: debhelper.pod:867 +#: debhelper.pod:863 msgid "" -"B<dh_installman> will now prefer detecting the language from the path name " -"rather than the extension." +"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " +"working with documentation." msgstr "" -"B<dh_installman> irá agora preferir detectar a linguagem a partir do nome de " -"caminho em vez de a extensão." +"Este valor afecta ferramentas do I<tipo> L<dh_installdocs(1)>, que I<sabem> " +"que estão a trabalhar com documentação." + +#. type: =item +#: debhelper.pod:866 +#, fuzzy +#| msgid "B<nostrip>" +msgid "B<notrimdch>" +msgstr "B<nostrip>" #. type: textblock #: debhelper.pod:872 msgid "" -"B<dh_auto_install> will now only create the destination directory it needs. " -"Previously, it would create the package build directory for all packages. " -"This will not affect packages that only build with debhelper commands, but " -"it may expose bugs in commands not included in debhelper." +"This value will cause L<dh_installchangelogs(1)> to act as if it had been " +"passed the B<--no-trim> option, forcing it to forgo removing older entries " +"from changelogs." msgstr "" -"B<dh_auto_install> irá agora apenas criar o directório de destino que " -"precisa. Anteriormente, iria criar o directório de compilação de pacote para " -"todos os pacotes. Isto não vai afectar pacotes que apenas compilam com " -"comandos debhelper, mas pode expor bugs em comandos não incluÃdos no " -"debhelper." + +#. type: =item +#: debhelper.pod:876 +msgid "B<noautodbgsym>, B<noddebs>" +msgstr "B<noautodbgsym>, B<noddebs>" #. type: textblock -#: debhelper.pod:880 +#: debhelper.pod:878 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now error out if their config has a pattern that does not " -"match anything or reference a path that does not exist." +"I<The official name is noautodbgsym. The noddebs variant is accepted for " +"historical reasons.>" msgstr "" -"Os ajudantes B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, e " -"B<dh_installman> agora dão erro se a sua configuração tiver um padrão que " -"não coincida com nada ou faça referência a um caminho que não exista." +"I<O nome oficial é noautodbgsym. A variante noddebs é aceite por razões " +"históricas.>" #. type: textblock -#: debhelper.pod:884 +#: debhelper.pod:881 msgid "" -"Known exceptions include building with the B<nodoc> profile, where the above " -"tools will silently permit failed matches where the patterns are used to " -"specify documentation." +"This value causes debhelper to skip the generation of automatically " +"generated debug symbol packages." msgstr "" -"Excepções conhecidas incluem compilar com o perfil B<nodoc>, onde as " -"ferramentas de cima irão permitir em silêncio correspondências falhadas onde " -"os padrões são usados para especificar documentação." +"Este valor faz com que o debhelper salte a geração de pacotes de sÃmbolos de " +"depuração gerados automaticamente." + +#. type: textblock +#: debhelper.pod:884 +msgid "This value affects L<dh_strip(1)>." +msgstr "Este valor afecta L<dh_strip(1)>." + +#. type: =item +#: debhelper.pod:886 +msgid "B<parallel=N>" +msgstr "B<parallel=N>" #. type: textblock -#: debhelper.pod:890 +#: debhelper.pod:888 msgid "" -"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " -"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " -"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " -"B<dh_install>." +"This value enables debhelper to use up to B<N> threads or processes (subject " +"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " +"debhelper tools work with parallel tasks and may silently ignore the request." msgstr "" -"Os ajudantes B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, e " -"B<dh_installman> agora aceitam o parâmetro B<--sourcedir> com o mesmo " -"significado que B<dh_install>. Mais ainda, eles agora também retornam (em " -"fall back) a F<debian/tmp> como B<dh_install>." +"Este valor habilita o debhelper a usar até B<N> linhas de processos " +"(sujeitos a parâmetros como B<--no-parallel> e B<--max-parallel=M>). Nem " +"todas as ferramentas debhelper trabalham com tarefas paralelas e podem " +"ignorar o pedido em silêncio." #. type: textblock -#: debhelper.pod:895 +#: debhelper.pod:893 msgid "" -"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " -"incorrectly ignore B<--sourcedir>." +"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " +"will attempt to run the underlying upstream build system with that number of " +"threads." msgstr "" -"Nota de migração: Um bug no debhelper 11 até ao 11.1.5 faz com que " -"B<dh_installinfo> ignore incorrectamente B<--sourcedir>." +"Este valor afecta muitas ferramentas debhelper. Mais notoriamente " +"B<dh_auto_*>, a qual irá tentar correr o sistema de compilação subjacente do " +"autor com esse número de linhas de execução." + +#. type: =item +#: debhelper.pod:897 +msgid "B<terse>" +msgstr "B<terse>" #. type: textblock -#: debhelper.pod:900 +#: debhelper.pod:899 msgid "" -"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)." +"This value will cause the official debhelper build systems to configure " +"upstream builds to be terse (i.e. reduce verbosity in their output). This " +"is subject to the upstream and the debhelper build system supporting such " +"features." msgstr "" -"Os sistemas de compilação B<perl-makemaker> e B<perl-build> já não passam B<-" -"I.> ao perl. Os pacotes que ainda precisam deste comportamento podem emula-" -"lo ao usar a variável de ambiente B<PERL5LIB>. Ex. ao adicionar B<export " -"PERL5LIB=.> no seu ficheiro debian/rules (ou semelhante)." +"Este valor irá fazer com que os sistemas de compilação oficiais debhelper " +"configurem as compilações do autor para serem concisas (isto é, reduzir os " +"detalhes dos seus resultados). Isto está sujeito a que os sistemas de " +"compilação do autor e do debhelper suportem tais funcionalidades." #. type: textblock -#: debhelper.pod:907 +#: debhelper.pod:904 msgid "" -"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " -"any of the B<dh_auto_*> tools. It was added as a temporary work around to " -"avoid a lot of packages failing to build at the same time." +"This value affects most B<dh_auto_*> tools directly. For commands provided " +"by the debhelper package, it also causes the tools to act like the " +"B<DH_QUIET> environment variable was non-empty." msgstr "" -"A variável de ambiente B<PERL_USE_UNSAFE_INC> já não é definida pelo B<dh> " -"ou nenhuma das ferramentas B<dh_auto_*>. Ela foi adicionada como um meio de " -"contorno temporário evitar muitos pacotes a falharem a compilação ao mesmo " -"tempo." + +#. type: textblock +#: debhelper.pod:910 +msgid "Unknown flags are silently ignored." +msgstr "Bandeiras desconhecidas são ignoradas em silêncio." #. type: textblock #: debhelper.pod:912 msgid "" -"Note this item will eventually become obsolete as upstream intends to drop " -"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " -"drops support for it, then this variable will be removed retroactively from " -"existing compat levels as well." +"Note third-party debhelper-like tools or third-party provided build systems " +"may or may not react to the above flags. This tends to depend on " +"implementation details of the tool." msgstr "" -"Note que este item irá eventualmente tornar-se obsoleto pois o auto pretende " -"abandonar o suporte para a variável de ambiente B<PERL_USE_UNSAFE_INC>. " -"Quando o perl abandonar o para ala, então esta variável será também removida " -"retroactivamente dos nÃveis de compatibilidade existentes." +"Note que ferramentas de terceiros estilo-debhelper ou sistemas de compilação " +"fornecidos por terceiros podem não reagir à s bandeiras em cima. Isto tende a " +"depender dos detalhes de implementação da ferramenta." + +#. type: =head1 +#: debhelper.pod:916 debhelper-compat-upgrade-checklist.pod:753 +#: debhelper-obsolete-compat.pod:178 dh:872 dh_auto_build:53 dh_auto_clean:55 +#: dh_auto_configure:58 dh_auto_install:103 dh_auto_test:64 dh_bugfiles:133 +#: dh_builddeb:176 dh_clean:189 dh_compress:243 dh_dwz:163 dh_fixperms:164 +#: dh_gencontrol:208 dh_icons:75 dh_install:377 dh_installcatalogs:128 +#: dh_installchangelogs:365 dh_installcron:80 dh_installdeb:419 +#: dh_installdebconf:233 dh_installdirs:131 dh_installdocs:437 +#: dh_installemacsen:138 dh_installexamples:182 dh_installifupdown:72 +#: dh_installinfo:123 dh_installinit:413 dh_installinitramfs:91 +#: dh_installlogcheck:81 dh_installlogrotate:53 dh_installman:420 +#: dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 +#: dh_installmodules:109 dh_installpam:71 dh_installppp:68 dh_installudev:102 +#: dh_installwm:130 dh_installxfonts:90 dh_link:166 dh_lintian:60 +#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 +#: dh_perl:188 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 +#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:280 dh_systemd_start:280 +msgid "SEE ALSO" +msgstr "VEJA TAMBÉM" + +#. type: =item +#: debhelper.pod:920 +msgid "L<debhelper-compat-upgrade-checklist(7)>" +msgstr "L<debhelper-compat-upgrade-checklist(7)>" #. type: textblock -#: debhelper.pod:919 +#: debhelper.pod:922 msgid "" -"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " -"non-zero exit from analysing a given file." +"List of supported compat levels and an upgrade checklist for each of them." msgstr "" -"O ajudante B<dh_makeshlibs> irá agora terminar em erro se objdump retornar " -"uma saÃda não-zero a partir da análise de um determinado ficheiro." +"Lista de nÃveis de compatibilidade suportados e uma lista de verificação de " +"actualização para cada um deles." -#. type: textblock +#. type: =item #: debhelper.pod:924 -msgid "" -"The B<dh_installdocs> and B<dh_installexamples> tools may now install " -"I<most> of the documentation in a different path to comply with the " -"recommendation from Debian policy §12.3 (since version 3.9.7)." -msgstr "" -"As ferramentas B<dh_installdocs> e B<dh_installexamples> podem agora " -"instalar I<a maioria> da documentação num caminho diferente para cumprir com " -"a recomendação da polÃtica Debian §12.3 (desde versão 3.9.7)." +msgid "F</usr/share/doc/debhelper/examples/>" +msgstr "F</usr/share/doc/debhelper/examples/>" #. type: textblock +#: debhelper.pod:926 +msgid "A set of example F<debian/rules> files that use debhelper." +msgstr "Um conjunto de ficheiros F<debian/rules> exemplo que usam debhelper." + +#. type: =item #: debhelper.pod:928 -msgid "" -"Note that if a given source package only contains a single binary package in " -"F<debian/control> or none of the packages are I<-doc> packages, then this " -"change is not relevant for that source package and you can skip to the next " -"change." -msgstr "" -"Note que um dado pacote fonte apenas contém um único pacote binário em " -"F<debian/control> ou nenhum dos pacotes são pacotes I<-doc>, então esta " -"alteração não é relevante para esse pacote fonte e você pode saltar a " -"próxima alteração." +msgid "L<http://joeyh.name/code/debhelper/>" +msgstr "L<http://joeyh.name/code/debhelper/>" #. type: textblock -#: debhelper.pod:933 -msgid "" -"By default, these tools will now attempt to determine a \"main package for " -"the documentation\" (called a I<doc-main-package> from here on) for every I<-" -"doc> package. If they find such a I<doc-main-package>, they will now " -"install the documentation into the path F<< /usr/share/doc/I<doc-main-" -"package> >> in the given doc package. I.e. the path can change but the " -"documentation is still shipped in the I<-doc> package." -msgstr "" -"Por predefinição, estas ferramentas irão agora tentar determinar um \"pacote " -"principal para a documentação\" (chamado um I<doc-main-package> daqui em " -"diante) para cada pacote I<-doc>. Se encontrarem o tal I<doc-main-package>, " -"irão agora instalar a documentação em F<< /usr/share/doc/I<doc-main-package> " -">> no pacote doc fornecido. Isto é, o caminho pode mudar mas a documentação " -"será na mesma enviada no pacote I<-doc>." +#: debhelper.pod:930 +msgid "Debhelper web site." +msgstr "SÃtio web do debhelper." + +#. type: =head1 +#: debhelper.pod:934 dh:878 dh_auto_build:59 dh_auto_clean:61 +#: dh_auto_configure:64 dh_auto_install:109 dh_auto_test:70 dh_bugfiles:141 +#: dh_builddeb:182 dh_clean:195 dh_compress:249 dh_dwz:169 dh_fixperms:170 +#: dh_gencontrol:214 dh_icons:81 dh_install:383 dh_installcatalogs:134 +#: dh_installchangelogs:371 dh_installcron:86 dh_installdeb:425 +#: dh_installdebconf:239 dh_installdirs:137 dh_installdocs:443 +#: dh_installemacsen:145 dh_installexamples:188 dh_installifupdown:78 +#: dh_installinfo:129 dh_installinitramfs:99 dh_installlogcheck:87 +#: dh_installlogrotate:59 dh_installman:426 dh_installmanpages:204 +#: dh_installmenu:96 dh_installmime:69 dh_installmodules:115 dh_installpam:77 +#: dh_installppp:74 dh_installudev:108 dh_installwm:136 dh_installxfonts:96 +#: dh_link:172 dh_lintian:68 dh_listpackages:40 dh_makeshlibs:462 +#: dh_md5sums:124 dh_movefiles:167 dh_perl:194 dh_prep:76 dh_shlibdeps:210 +#: dh_strip:441 dh_testdir:68 dh_testroot:99 dh_usrlocal:142 +msgid "AUTHOR" +msgstr "AUTOR" + +#. type: textblock +#: debhelper.pod:936 dh:880 dh_auto_build:61 dh_auto_clean:63 +#: dh_auto_configure:66 dh_auto_install:111 dh_auto_test:72 dh_builddeb:184 +#: dh_clean:197 dh_compress:251 dh_fixperms:172 dh_gencontrol:216 +#: dh_install:385 dh_installchangelogs:373 dh_installcron:88 dh_installdeb:427 +#: dh_installdebconf:241 dh_installdirs:139 dh_installdocs:445 +#: dh_installemacsen:147 dh_installexamples:190 dh_installifupdown:80 +#: dh_installinfo:131 dh_installinit:421 dh_installlogrotate:61 +#: dh_installman:428 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 +#: dh_installmodules:117 dh_installpam:79 dh_installppp:76 dh_installudev:110 +#: dh_installwm:138 dh_installxfonts:98 dh_link:174 dh_listpackages:42 +#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 +#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 +msgid "Joey Hess <joeyh@debian.org>" +msgstr "Joey Hess <joeyh@debian.org>" #. type: textblock -#: debhelper.pod:941 +#: debhelper-compat-upgrade-checklist.pod:5 msgid "" -"The B<--doc-main-package> option can be used when the auto-detection is " -"insufficient or to reset the path to its previous value if there is a reason " -"to diverge from Debian policy recommendation." +"debhelper-compat-upgrade-checklist - Upgrade checklist for supported " +"debhelper compat levels" msgstr "" -"A opção B<--doc-main-package> pode ser usada quando a auto-detecção é " -"insuficiente ou para reiniciar o caminho para o seu valor anterior se " -"existir razão para divergir da recomendação da polÃtica Debian." +"debhelper-compat-upgrade-checklist - Actualiza a lista de verificação para " +"nÃveis de compatibilidade do debhelper suportados." #. type: textblock -#: debhelper.pod:945 +#: debhelper-compat-upgrade-checklist.pod:9 msgid "" -"Some documentation will not be affected by this change. These exceptions " -"include the copyright file, changelog files, README.Debian, etc. These " -"files will still be installed in the path F<< /usr/share/doc/I<package> >>." +"This document is an upgrade checklist of all the supported debhelper compat " +"levels. It also lists all the support debhelper compat levels." msgstr "" -"Alguma documentação não será afectada por esta alteração. Estas excepções " -"incluem o ficheiro copyright, ficheiros changelog, README.Debian, etc. Estes " -"ficheiros serão na mesma instalados no caminho F<< /usr/share/doc/I<pacote> " -">>." +"Este documento é uma lista de verificação de actualização para todos os " +"nÃveis de compatibilidade do debhelper suportados. Também lista todos os " +"nÃveis de compatibilidade de debhelper suportados." #. type: textblock -#: debhelper.pod:952 +#: debhelper-compat-upgrade-checklist.pod:12 msgid "" -"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " -"to determine which files to process. Instead, they open the file and look " -"for an ELF header to determine if a given file is an shared object or an ELF " -"executable." +"Information about how to declare the compat level is in L<debhelper(7)/" +"COMPATIBILITY LEVELS>." msgstr "" -"As ferramentas B<dh_strip> e B<dh_shlibdeps> já não usam mais padrões de " -"nomes de ficheiros para determinar quais ficheiros processar. Em vez disso, " -"elas abrem o ficheiro e procuram um cabeçalho ELF para determinar se um dado " -"ficheiro é um objecto partilhado ou um executável ELF." +"Informação sobre como declarar os nÃveis de compatibilidade está em " +"L<debhelper(7)/NÃVEIS DE COMPATIBILIDADE>." #. type: textblock -#: debhelper.pod:957 -msgid "This change may cause the tools to process more files than previously." +#: debhelper-compat-upgrade-checklist.pod:14 +msgid "" +"If you are upgrading from a (now) obsolete compat level, then please refer " +"to L<debhelper-obsolete-compat(7)>." msgstr "" -"Esta alteração fazer com que as ferramentas processem mais ficheiros que " -"anteriormente." +"Se você está a actualizar a partir de um nÃvel de compatibilidade (agora) " +"obsoleto, então por favor consulte L<debhelper-obsolete-compat(7)>." -#. type: =item -#: debhelper.pod:961 -msgid "v12" -msgstr "v12" +#. type: =head2 +#: debhelper-compat-upgrade-checklist.pod:19 +msgid "Upgrade checklist for supported compatibility levels" +msgstr "" +"Actualizar lista de verificação para os nÃveis de compatibilidade suportados." #. type: textblock -#: debhelper.pod:963 -msgid "Changes from v11 are:" -msgstr "As alterações a partir de v11 são:" +#: debhelper-compat-upgrade-checklist.pod:21 +msgid "These are the available compatibility levels:" +msgstr "Estes são os nÃveis de compatibilidade disponÃveis:" -#. type: textblock -#: debhelper.pod:969 -msgid "" -"The B<dh_makeshlibs> tool now generates shlibs files with versioned " -"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " -"is now the default." -msgstr "" -"A ferramenta B<dh_makeshlibs> agora gera ficheiros shlibs com dependência de " -"versão por predefinição. Isto significa que B<-VUpstream-Version> (a.k.a. B<-" -"V>) é agora a predefinição." +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:25 +msgid "v15" +msgstr "v15" #. type: textblock -#: debhelper.pod:973 +#: debhelper-compat-upgrade-checklist.pod:27 +#: debhelper-compat-upgrade-checklist.pod:51 strings-kept-translations.pod:9 msgid "" -"If an unversioned dependency in the shlibs file is wanted, this can be " -"obtained by passing B<-VNone> instead. However, please see " -"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." +"This compatibility level is still open for development; use with caution." msgstr "" -"Se é pedida uma dependência sem versão no ficheiros shlibs, isto pode ser " -"conseguido ao passar B<-VNone> em substituição. No entanto, por favor veja " -"L<dh_makeshlibs(1)> para a problemática das dependências sem versão." +"Este nÃvel de compatibilidade ainda está aberto em desenvolvimento; use com " +"cuidado." #. type: textblock -#: debhelper.pod:979 -msgid "" -"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " -"instead." -msgstr "" -"A opção B<-s> (B<--same-arch>) foi removida. Por favor use B<-a> (B<--arch>) " -"em vez desta." +#: debhelper-compat-upgrade-checklist.pod:29 +msgid "Changes from v14 are:" +msgstr "As alterações a partir de v14 são:" + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:33 +#: debhelper-compat-upgrade-checklist.pod:57 +#: debhelper-compat-upgrade-checklist.pod:63 +#: debhelper-compat-upgrade-checklist.pod:68 +#: debhelper-compat-upgrade-checklist.pod:74 +#: debhelper-compat-upgrade-checklist.pod:90 +#: debhelper-compat-upgrade-checklist.pod:95 +#: debhelper-compat-upgrade-checklist.pod:103 +#: debhelper-compat-upgrade-checklist.pod:120 +#: debhelper-compat-upgrade-checklist.pod:128 +#: debhelper-compat-upgrade-checklist.pod:136 +#: debhelper-compat-upgrade-checklist.pod:145 +#: debhelper-compat-upgrade-checklist.pod:151 +#: debhelper-compat-upgrade-checklist.pod:161 +#: debhelper-compat-upgrade-checklist.pod:169 +#: debhelper-compat-upgrade-checklist.pod:175 +#: debhelper-compat-upgrade-checklist.pod:189 +#: debhelper-compat-upgrade-checklist.pod:200 +#: debhelper-compat-upgrade-checklist.pod:214 +#: debhelper-compat-upgrade-checklist.pod:225 +#: debhelper-compat-upgrade-checklist.pod:241 +#: debhelper-compat-upgrade-checklist.pod:251 +#: debhelper-compat-upgrade-checklist.pod:255 +#: debhelper-compat-upgrade-checklist.pod:260 +#: debhelper-compat-upgrade-checklist.pod:265 +#: debhelper-compat-upgrade-checklist.pod:272 +#: debhelper-compat-upgrade-checklist.pod:278 +#: debhelper-compat-upgrade-checklist.pod:286 +#: debhelper-compat-upgrade-checklist.pod:292 +#: debhelper-compat-upgrade-checklist.pod:296 +#: debhelper-compat-upgrade-checklist.pod:301 +#: debhelper-compat-upgrade-checklist.pod:306 +#: debhelper-compat-upgrade-checklist.pod:315 +#: debhelper-compat-upgrade-checklist.pod:331 +#: debhelper-compat-upgrade-checklist.pod:340 +#: debhelper-compat-upgrade-checklist.pod:356 +#: debhelper-compat-upgrade-checklist.pod:364 +#: debhelper-compat-upgrade-checklist.pod:369 +#: debhelper-compat-upgrade-checklist.pod:391 +#: debhelper-compat-upgrade-checklist.pod:397 +#: debhelper-compat-upgrade-checklist.pod:409 +#: debhelper-compat-upgrade-checklist.pod:417 +#: debhelper-compat-upgrade-checklist.pod:423 +#: debhelper-compat-upgrade-checklist.pod:428 +#: debhelper-compat-upgrade-checklist.pod:433 +#: debhelper-compat-upgrade-checklist.pod:438 +#: debhelper-compat-upgrade-checklist.pod:446 +#: debhelper-compat-upgrade-checklist.pod:456 +#: debhelper-compat-upgrade-checklist.pod:466 +#: debhelper-compat-upgrade-checklist.pod:473 +#: debhelper-compat-upgrade-checklist.pod:485 +#: debhelper-compat-upgrade-checklist.pod:490 +#: debhelper-compat-upgrade-checklist.pod:518 +#: debhelper-compat-upgrade-checklist.pod:535 +#: debhelper-compat-upgrade-checklist.pod:540 +#: debhelper-compat-upgrade-checklist.pod:546 +#: debhelper-compat-upgrade-checklist.pod:552 +#: debhelper-compat-upgrade-checklist.pod:557 +#: debhelper-compat-upgrade-checklist.pod:563 +#: debhelper-compat-upgrade-checklist.pod:572 +#: debhelper-compat-upgrade-checklist.pod:582 +#: debhelper-compat-upgrade-checklist.pod:588 +#: debhelper-compat-upgrade-checklist.pod:611 +#: debhelper-compat-upgrade-checklist.pod:618 +#: debhelper-compat-upgrade-checklist.pod:624 +#: debhelper-compat-upgrade-checklist.pod:630 +#: debhelper-compat-upgrade-checklist.pod:636 +#: debhelper-compat-upgrade-checklist.pod:656 +#: debhelper-compat-upgrade-checklist.pod:661 +#: debhelper-compat-upgrade-checklist.pod:668 +#: debhelper-compat-upgrade-checklist.pod:673 +#: debhelper-compat-upgrade-checklist.pod:678 +#: debhelper-compat-upgrade-checklist.pod:686 +#: debhelper-compat-upgrade-checklist.pod:692 +#: debhelper-compat-upgrade-checklist.pod:697 +#: debhelper-compat-upgrade-checklist.pod:702 +#: debhelper-compat-upgrade-checklist.pod:717 +#: debhelper-compat-upgrade-checklist.pod:721 +#: debhelper-compat-upgrade-checklist.pod:729 +#: debhelper-compat-upgrade-checklist.pod:734 debhelper-obsolete-compat.pod:29 +#: debhelper-obsolete-compat.pod:36 debhelper-obsolete-compat.pod:40 +#: debhelper-obsolete-compat.pod:44 debhelper-obsolete-compat.pod:57 +#: debhelper-obsolete-compat.pod:62 debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:74 debhelper-obsolete-compat.pod:89 +#: debhelper-obsolete-compat.pod:93 debhelper-obsolete-compat.pod:98 +#: debhelper-obsolete-compat.pod:102 debhelper-obsolete-compat.pod:114 +#: debhelper-obsolete-compat.pod:119 debhelper-obsolete-compat.pod:124 +#: debhelper-obsolete-compat.pod:129 debhelper-obsolete-compat.pod:143 +#: debhelper-obsolete-compat.pod:148 debhelper-obsolete-compat.pod:152 +#: dh_testroot:36 dh_testroot:41 dh_testroot:46 +msgid "-" +msgstr "-" #. type: textblock -#: debhelper.pod:983 +#: debhelper-compat-upgrade-checklist.pod:35 msgid "" -"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." +"The B<dh_auto_install> tool no longer defaults to B<< --destdir=debian/" +"I<package> >> for source packages only producing a single binary. If this " +"behaviour is wanted, the package should explicitly activate the B<single-" +"binary> dh addon (e.g., by adding B<dh-sequence-single-binary> to B<Build-" +"Depends>) or pass B<--destdir> to B<dh_auto_install>." msgstr "" -"Invocar B<dh_clean -k> agora causa um erro em vez de um aviso de " -"descontinuação." +"A ferramenta B<dh_auto_install> já não usa por predefinição B<< --" +"destdir=debian/I<package> >> para pacotes fonte que apenas produzem um único " +"binário. Se este comportamento é desejado, o pacote deve activar " +"explicitamente o addon do dh B<single-binary> (ex. ao adicionar B<dh-" +"sequence-single-binary> a B<Build-Depends>) ou passar B<--destdir> a " +"B<dh_auto_install>." #. type: textblock -#: debhelper.pod:988 +#: debhelper-compat-upgrade-checklist.pod:41 +#: debhelper-compat-upgrade-checklist.pod:84 msgid "" -"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " -"removed. Please use the new name B<--no-stop-on-upgrade>" +"The rationale for this change to avoid \"surprises\" when adding a second " +"binary package later. Previously, debhelper would silently change behaviour " +"often resulting in empty binary packages being uploaded to the archive by " +"mistake. With the new behaviour, the B<single-binary> addon will detect the " +"mismatch and warn the maintainer of what is about to happen." msgstr "" -"A opção B<--no-restart-on-upgrade> em B<dh_installinit> foi removida. Por " -"favor use o novo nome B<--no-stop-on-upgrade>" +"A razão para esta alteração é evitar \"surpresas\" ao adicionar um segundo " +"pacote binário mais tarde. Anteriormente, o debhelper iria em silêncio " +"alterar o comportamento muitas vezes resultado em pacotes binários vazios a " +"serem enviados para o arquivo por engano. Com o novo comportamento, o addon " +"B<single-binary> irá detectar a discrepância e avisar o maintainer do que " +"está prestes a acontecer." + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:49 +msgid "v14" +msgstr "v14" #. type: textblock -#: debhelper.pod:993 -msgid "" -"There was a bug in the B<doit> (and similar) functions from L<Debian::" -"Debhelper::Dh_Lib> that made them spawn a shell in one particular " -"circumstance. This bug is now removed and will cause helpers that rely on " -"the bug to fail with a \"command not found\"-error." -msgstr "" -"Existia um bug nas funções B<doit> (e similares) a partir de L<Debian::" -"Debhelper::Dh_Lib> que fazia aparece uma linha de comandos numa " -"circunstância particular. Este bug foi agora removido e irá fazer com que os " -"ajudantes que contavam com esse bug falhem com um erro de \"comando não " -"encontrado\"." +#: debhelper-compat-upgrade-checklist.pod:53 +msgid "Changes from v13 are:" +msgstr "As alterações a partir de v13 são:" #. type: textblock -#: debhelper.pod:1000 +#: debhelper-compat-upgrade-checklist.pod:59 msgid "" -"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " -"removed. Please use B<dh_missing> and its corresponding options, which can " -"also see the files installed by other helpers." +"The B<cmake> buildsystem now passes B<-DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to " +"L<cmake(1)> to avoid some reproducibility issues." msgstr "" -"O B<--list-missing> e B<--fail-missing> em B<dh_install> foram removidos. " -"Por favor use B<dh_missing> e as suas opções correspondentes, o qual pode " -"também ver os ficheiros instalados por outros ajudantes." +"O sistema de compilação B<cmake> agora passa B<-" +"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> a L<cmake(1)> para evitar alguns problemas " +"de reprodutibilidade." #. type: textblock -#: debhelper.pod:1006 +#: debhelper-compat-upgrade-checklist.pod:65 msgid "" -"The B<dh_installinit> helper no longer installs configuration for the " -"upstart init system. Instead, it will abort the build if it finds an old " -"upstart configuration file. The error is there to remind the package " -"maintainer to ensure the proper removal of the conffiles shipped in previous " -"versions of the package (if any)." +"The tool B<dh_installsysusers> is now included in the default sequence. This " +"helper tool will process systemd sysusers files." msgstr "" -"O ajudante B<dh_installinit> já não instala configuração para o sistema de " -"init upstart. Em vez disso, irá abortar a compilação se encontrar um " -"ficheiro de configuração upstart antigo. O erro está lá para lembrar ao " -"maintainer do pacote para assegurar a remoção apropriada dos ficheiros de " -"configuração empacotados em versões anteriores do pacote (caso existam)." +"A ferramenta B<dh_installsysusers> está agora incluÃda na sequência " +"predefinida. Esta ferramenta de ajuda irá processar ficheiros sysusers do " +"systemd." #. type: textblock -#: debhelper.pod:1014 +#: debhelper-compat-upgrade-checklist.pod:70 msgid "" -"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" -"maintscript-helper(1)> commands and will error out if the commands appear to " -"be invalid." +"Use of the B<dh_gconf> command in override and hook targets now causes an " +"error. The B<dh_gconf> command has been a no-op for years and was removed " +"in debhelper 13.4." msgstr "" -"A ferramenta B<dh_installdeb> irá fazer validação básica de alguns comandos " -"L<dpkg-maintscript-helper(1)> e irá terminar em erro se os comandos " -"parecerem ser inválidos." +"Usar o comando B<dh_gconf> em alvos de sobreposição e hook agora causa um " +"erro. O comando B<dh_gconf> foi um não-operativo durante anos e foi removido " +"no debhelper 13.4." #. type: textblock -#: debhelper.pod:1020 -msgid "The B<dh_missing> tool will now default to B<--list-missing>." +#: debhelper-compat-upgrade-checklist.pod:76 +msgid "" +"The B<dh> sequencer will warn if the B<single-binary> addon is implicitly " +"activated to warn maintainers of the pending compat 15 change in " +"B<dh_auto_install>." msgstr "" -"A ferramenta B<dh_missing> irá agora usar por predefinição B<--list-missing>." +"O sequenciador B<dh> irá avisar se o addon B<single-binary> for activado " +"implicitamente para avisar os maintainers da pendente alteração na " +"compatibilidade 15 em B<dh_auto_install>." #. type: textblock -#: debhelper.pod:1024 +#: debhelper-compat-upgrade-checklist.pod:79 msgid "" -"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" -"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." +"Maintainers are urged to either explicitly activate the B<single-binary> " +"addon to preserve the existing behaviour (e.g., by adding B<dh-sequence-" +"single-binary> to Build-Depends), or explicitly passing B<--destdir> to " +"B<dh_auto_install> if used and then passing B<--without single-binary> to " +"B<dh> (the latter to silence the warning)." msgstr "" -"A ferramenta B<dh_makeshlibs> irá agora apenas passar bibliotecas para " -"L<dpkg-gensymbols(1)> se o binário ELF tiver um SONAME (contendo \".so\")." +"Maintainers são incentivados a ou activar explicitamente o addon B<single-" +"binary> para preservar o comportamento existente (ex. ao adicionar <dh-" +"sequence-single-binary> a Build-Depends), ou passar explicitamente B<--" +"destdir> a B<dh_auto_install> se usado e depois passar B<--without single-" +"binary> a B<dh> (a última para silenciar o aviso)." #. type: textblock -#: debhelper.pod:1029 +#: debhelper-compat-upgrade-checklist.pod:92 msgid "" -"The B<dh_compress> tool no longer compresses examples (i.e. anything " -"installed in F<</usr/share/doc/I<package>/examples>>.)" +"The B<dh_installalternatives> tool will now be run after B<dh_link> rather " +"than after B<dh_installinitramfs> in the default B<dh> sequence." msgstr "" -"A ferramenta B<dh_compress> não mais comprime exemplos (isto é, nada " -"instalado em F<</usr/share/doc/I<pacote>/examples>>.)" +"A ferramenta B<dh_installalternatives> irá agora correr após B<dh_link> em " +"vez de após B<dh_installinitramfs> na sequência predefinida do B<dh>." #. type: textblock -#: debhelper.pod:1034 +#: debhelper-compat-upgrade-checklist.pod:97 msgid "" -"The standard sequence in B<dh> now includes B<dh_dwz> and " -"B<dh_installinitramfs> by default. This makes the B<dwz> and " -"B<installinitramfs> sequences obsolete and they will now fail with an " -"error. If you want to skip these commands, then please insert an empty " -"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" +"The B<dh_installpam> tool will now install PAM configuration files under " +"F<< /usr/lib/pam.d/I<package> >> instead of F<< /etc/pam.d/I<package> >>." msgstr "" -"A sequência standard em B<dh> agora inclui B<dh_dwz> e " -"B<dh_installinitramfs> por predefinição. Isto tornas as sequências B<dwz> e " -"B<installinitramfs> obsoletas e elas agora irão falhar com um erro. Se " -"desejar saltar estes comandos, por favor insira um alvo de sobreposição " -"vazio para eles em F<debian/rules> (ex. I<override_dh_dwz:>)" +"A ferramenta B<dh_installpam> irá agora instalar ficheiros de configuração " +"do PAM sob F<< /usr/lib/pam.d/I<package> >> em vez de F<< /etc/pam.d/" +"I<package> >>." #. type: textblock -#: debhelper.pod:1043 +#: debhelper-compat-upgrade-checklist.pod:100 msgid "" -"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" -"libexecdir> variable and thus relies on the build system default - which " -"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." +"Please consider using the \"rm_conffile\" feature from L<dh_installdeb(1)> " +"to ensure the proper removal of previous PAM files." msgstr "" -"Os sistemas de compilação B<meson> e B<autoconf> não mais definem " -"explicitamente a variável B<--libexecdir> e assim apoia-se na predefinição " -"do sistema de compilação - O qual deve ser B</usr/libexec> (por FHS 3.0, " -"adoptado em Debian Policy 4.1.5)." +"Por favor considere usar a funcionalidade \"rm_conffile\" de " +"L<dh_installdeb(1)> para assegurar a remoção apropriada dos ficheiros PAM " +"anteriores." #. type: textblock -#: debhelper.pod:1048 +#: debhelper-compat-upgrade-checklist.pod:105 +#, fuzzy +#| msgid "" +#| "The B<meson+ninja> build system now uses B<meson install> instead of " +#| "B<ninja install> in the L<dh_auto_install(1)> call. Any override of " +#| "B<dh_auto_install> that passes extra parameters to the upstream build " +#| "system should be reviewed." msgid "" -"If a particular upstream package does not use the correct default, the " -"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " -"via the following example:" +"The B<meson+ninja> and B<cmake> build systems now use B<meson install> and " +"B<cmake --install>, respectively, instead of B<ninja install> and B<make " +"install> in the L<dh_auto_install(1)> call. Any override of " +"B<dh_auto_install> that passes extra parameters to the upstream build system " +"should be reviewed." msgstr "" -"Se um determinado pacote original do autor não usar a predefinição correcta, " -"o parâmetro pode muitas vezes ser passado manualmente via " -"L<dh_auto_configure(1)>. Por exemplo via seguinte exemplo:" +"O sistema de compilação B<meson+ninja> agora usa B<meson install> em vez de " +"B<ninja install> na chamada a L<dh_auto_install(1)>. Qualquer sobreposição " +"de B<dh_auto_install> que passe parâmetros extra ao sistema de compilação do " +"autor deve ser revista." -#. type: verbatim -#: debhelper.pod:1052 -#, no-wrap -msgid "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" -msgstr "" -" override_dh_auto_configure:\n" -" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" -"\n" +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:112 +msgid "v13" +msgstr "v13" #. type: textblock -#: debhelper.pod:1055 -msgid "Note the B<--> before the B<--libexecdir> parameter." -msgstr "Note o B<--> antes do parâmetro B<--libexecdir>." +#: debhelper-compat-upgrade-checklist.pod:114 +msgid "This is the recommended mode of operation." +msgstr "Este é o modo de operação recomendado." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:116 +msgid "Changes from v12 are:" +msgstr "As alterações a partir de v12 são:" #. type: textblock -#: debhelper.pod:1059 +#: debhelper-compat-upgrade-checklist.pod:122 msgid "" -"The B<dh_installdeb> tool no longer installs the maintainer provided " -"F<conffiles> file. The file has mostly been obsolete since compatibility " -"level 3, where B<dh_installdeb> began to automatically compute the resulting " -"F<conffiles> control file." +"The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " +"test> when running the test suite. Any override of B<dh_auto_test> that " +"passes extra parameters to upstream test runner should be reviewed as " +"B<meson test> is not command line compatible with B<ninja test>." msgstr "" -"A ferramenta B<dh_installdeb> não mais instala o ficheiro F<conffiles> " -"fornecido pelo maintainer. O ficheiro torneou-se maioritariamente obsoleto " -"desde o nÃvel de compatibilidade 3, onde B<dh_installdeb> começo a computar " -"automaticamente o ficheiro de controle F<conffiles> resultante." +"O sistema de compilação B<meson+ninja> agora usa B<meson test> em vez de " +"B<ninja test> quando corre a suite de testes. Qualquer sobreposição de " +"B<dh_auto_test> que passe parâmetros extra ao testador original do autor " +"deve ser revista, pois o B<meson test> não é compatÃvel em linha de comandos " +"com o B<ninja test>." #. type: textblock -#: debhelper.pod:1066 -msgid "" -"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " -"handling systemd services that have a sysvinit alternative. Both tools must " -"now be used in such a case to ensure the service is properly started under " -"both sysvinit and systemd." -msgstr "" -"A ferramenta B<dh_installsystemd> não mais se apoia em B<dh_installinit> " -"para lidar com os serviços do systemd que têm uma alternativa de sysvinit. " -"ambas ferramentas devem agora ser usadas em tais casos para assegurar que o " -"serviço é arrancado correctamente sob ambos sysvinit e systemd." - -#. type: textblock -#: debhelper.pod:1071 -msgid "" -"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" -"start>) then you will probably need one for B<dh_installsystemd> as well now." -msgstr "" -"Se tiver uma sobreposição para B<dh_installinit> (ex. para chamá-lo com B<--" -"no-start>) então irá provavelmente precisar agora também de um para " -"B<dh_installsystemd>." - -#. type: textblock -#: debhelper.pod:1075 -msgid "" -"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " -"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists B<" -"${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to compat " -"12." -msgstr "" -"Esta alteração faz B<dh_installinit> injectar um I<misc:Pre-Depends> para " -"B<< init-system-helpers (>= 1.54~) >>. Por favor assegure que o pacote " -"lista B<${misc:Pre-Depends}> no seu campo B<Pre-Depends> antes de actualizar " -"para a compatibilidade 12." - -#. type: textblock -#: debhelper.pod:1082 -msgid "" -"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " -"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " -"packages and not only during the building process. Please set " -"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " -"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." -msgstr "" -"Esta ferramenta de terceiros B<dh_golang> (do pacote B<dh-golang>) agora por " -"predefinição honra a variável B<DH_GOLANG_EXCLUDES> para instalação fonte em " -"pacotes -dev e não apenas durante o processo de compilação. Por favor defina " -"B<DH_GOLANG_EXCLUDES_ALL> para falso para reverter para o comportamento " -"anterior. Veja B<Debian::Debhelper::Buildsystem::golang(3pm)> para detalhes " -"e exemplos" - -#. type: textblock -#: debhelper.pod:1090 -msgid "" -"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " -"default." -msgstr "" -"B<dh_installsystemduser> é agora incluÃdo na sequência standard do B<dh> por " -"predefinição." - -#. type: textblock -#: debhelper.pod:1095 -msgid "" -"The B<python-distutils> buildsystem is now removed. Please use the third-" -"party build system B<pybuild> instead." -msgstr "" -"O sistema de compilação B<python-distutils> foi agora removido. Por favor " -"use o sistema de compilação de terceiros B<pybuild> em substituição." - -#. type: =item -#: debhelper.pod:1100 -msgid "v13" -msgstr "v13" - -#. type: textblock -#: debhelper.pod:1102 -msgid "This is the recommended mode of operation." -msgstr "Este é o modo de operação recomendado." - -#. type: textblock -#: debhelper.pod:1104 -msgid "Changes from v12 are:" -msgstr "As alterações a partir de v12 são:" - -#. type: textblock -#: debhelper.pod:1110 -msgid "" -"The B<meson+ninja> build system now uses B<meson test> instead of B<ninja " -"test> when running the test suite. Any override of B<dh_auto_test> that " -"passes extra parameters to upstream test runner should be reviewed as " -"B<meson test> is not command line compatible with B<ninja test>." -msgstr "" -"O sistema de compilação B<meson+ninja> agora usa B<meson test> em vez de " -"B<ninja test> quando corre a suite de testes. Qualquer sobreposição de " -"B<dh_auto_test> que passe parâmetros extra ao testador original do autor " -"deve ser revista, pois o B<meson test> não é compatÃvel em linha de comandos " -"com o B<ninja test>." - -#. type: textblock -#: debhelper.pod:1118 +#: debhelper-compat-upgrade-checklist.pod:130 msgid "" "All debhelper like tools based on the official debhelper library (including " "B<dh> and the official B<dh_*> tools) no longer accepts abbreviated command " @@ -2484,7 +2783,7 @@ msgstr "" "linha de comandos." #. type: textblock -#: debhelper.pod:1126 +#: debhelper-compat-upgrade-checklist.pod:138 msgid "" "The ELF related debhelper tools (B<dh_dwz>, B<dh_strip>, B<dh_makeshlibs>, " "B<dh_shlibdeps>) are now only run for arch dependent packages by default (i." @@ -2500,7 +2799,7 @@ msgstr "" "Depends explÃcito em B<dh-sequence-elf-tools>." #. type: textblock -#: debhelper.pod:1135 +#: debhelper-compat-upgrade-checklist.pod:147 msgid "" "The third-party B<gradle> build system (from B<gradle-debian-helper> " "package) now runs the upstream-provided test suite automatically. To " @@ -2511,7 +2810,7 @@ msgstr "" "automaticamente. Para suprimir tal comportamento, sobreponha B<dh_auto_test>." #. type: textblock -#: debhelper.pod:1141 +#: debhelper-compat-upgrade-checklist.pod:153 msgid "" "The B<dh_installman> tool now aborts if it sees conflicting definitions of a " "manpage. This typically happens if the upstream build system is installing " @@ -2528,7 +2827,7 @@ msgstr "" ">> (assumindo que ambas as versões são idênticas)." #. type: textblock -#: debhelper.pod:1151 +#: debhelper-compat-upgrade-checklist.pod:163 msgid "" "The B<dh_auto_*> helpers now reset the environment variables B<HOME> and " "common B<XDG_*> variable. Please see description of the environment " @@ -2539,12 +2838,12 @@ msgstr "" "de ambiente em L</ENVIRONMENT> para como lidar com isto." #. type: textblock -#: debhelper.pod:1155 +#: debhelper-compat-upgrade-checklist.pod:167 msgid "I<This feature changed between debhelper 13 and debhelper 13.2.>" msgstr "I<Esta funcionalidade mudou entre debhelper 13 e debhelper 13.2.>" #. type: textblock -#: debhelper.pod:1159 +#: debhelper-compat-upgrade-checklist.pod:171 msgid "" "The B<dh> command will now error if an override or hook target for an " "obsolete command are present in F<debian/rules> (e.g. " @@ -2555,7 +2854,7 @@ msgstr "" "B<override_dh_systemd_enable:>)." #. type: textblock -#: debhelper.pod:1165 +#: debhelper-compat-upgrade-checklist.pod:177 msgid "" "The B<dh_missing> command will now default to B<--fail-missing>. This can " "be reverted to a non-fatal warning by explicitly passing B<--list-missing> " @@ -2566,7 +2865,7 @@ msgstr "" "list-missing> como era na compatibilidade 12." #. type: textblock -#: debhelper.pod:1169 +#: debhelper-compat-upgrade-checklist.pod:181 msgid "" "If you do not want the warning either, please omit the call to " "B<dh_missing>. If you use the B<dh> command sequencer, then you can do this " @@ -2579,7 +2878,7 @@ msgstr "" "rules> do pacote relevante. Como exemplo:" #. type: verbatim -#: debhelper.pod:1174 +#: debhelper-compat-upgrade-checklist.pod:186 #, no-wrap msgid "" " # Disable dh_missing\n" @@ -2591,7 +2890,7 @@ msgstr "" "\n" #. type: textblock -#: debhelper.pod:1179 +#: debhelper-compat-upgrade-checklist.pod:191 msgid "" "The B<dh> command sequencer now runs B<dh_installtmpfiles> in the default " "sequence. The B<dh_installtmpfiles> takes over handling of tmpfiles.d " @@ -2604,7 +2903,7 @@ msgstr "" "B<dh_installsystemd> está agora desactivada." #. type: textblock -#: debhelper.pod:1184 +#: debhelper-compat-upgrade-checklist.pod:196 msgid "" "Note that B<dh_installtmpfiles> responds to F<< debian/I<package>.tmpfiles " ">> where B<dh_installsystemd> used a name without the trailing \"s\"." @@ -2613,7 +2912,7 @@ msgstr "" "onde B<dh_installsystemd> usou um nome sem o \"s\" final." #. type: textblock -#: debhelper.pod:1190 +#: debhelper-compat-upgrade-checklist.pod:202 msgid "" "Many B<dh_*> tools now support limited variable expansion via the B<${foo}> " "syntax. In many cases, this can be used to reference paths that contain " @@ -2630,7 +2929,7 @@ msgstr "" "renomear, etc... o pacote irá continuar a precisar de L<dh-exec(1)>." #. type: textblock -#: debhelper.pod:1197 +#: debhelper-compat-upgrade-checklist.pod:209 msgid "" "Please see L</Substitutions in debhelper config files> for syntax and " "available substitution variables. To B<dh_*> tool writers, substitution " @@ -2643,7 +2942,7 @@ msgstr "" "funções B<filearray> e B<filedoublearray>." #. type: textblock -#: debhelper.pod:1204 +#: debhelper-compat-upgrade-checklist.pod:216 msgid "" "The B<dh> command sequencer will now skip all hook and override targets for " "B<dh_auto_test>, B<dh_dwz> and B<dh_strip> when B<DEB_BUILD_OPTIONS> lists " @@ -2654,7 +2953,7 @@ msgstr "" "B<DEB_BUILD_OPTIONS> listar as opções B<nocheck> / B<nostrip> relevantes." #. type: textblock -#: debhelper.pod:1208 +#: debhelper-compat-upgrade-checklist.pod:220 msgid "" "Any package relying on these targets to always be run should instead move " "relevant logic out of those targets. E.g. non-test related packaging code " @@ -2668,7 +2967,7 @@ msgstr "" "B<execute_after_dh_auto_build> ou B<execute_before_dh_auto_install>." #. type: textblock -#: debhelper.pod:1215 +#: debhelper-compat-upgrade-checklist.pod:227 msgid "" "The B<cmake> buildsystem now passes B<-" "DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=ON> to L<cmake(1)> to speed up automatic " @@ -2681,7 +2980,7 @@ msgstr "" "comportamento anterior, sobreponha a flag:" #. type: verbatim -#: debhelper.pod:1219 +#: debhelper-compat-upgrade-checklist.pod:231 #, no-wrap msgid "" " dh_auto_configure -- -DCMAKE_SKIP_INSTALL_ALL_DEPENDENCY=OFF ...\n" @@ -2691,1080 +2990,1066 @@ msgstr "" "\n" #. type: =item -#: debhelper.pod:1223 -msgid "v14" -msgstr "v14" +#: debhelper-compat-upgrade-checklist.pod:235 +msgid "v12" +msgstr "v12" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:237 +msgid "Changes from v11 are:" +msgstr "As alterações a partir de v11 são:" #. type: textblock -#: debhelper.pod:1225 strings-kept-translations.pod:9 +#: debhelper-compat-upgrade-checklist.pod:243 msgid "" -"This compatibility level is still open for development; use with caution." +"The B<dh_makeshlibs> tool now generates shlibs files with versioned " +"dependency by default. This means that B<-VUpstream-Version> (a.k.a. B<-V>) " +"is now the default." msgstr "" -"Este nÃvel de compatibilidade ainda está aberto em desenvolvimento; use com " -"cuidado." +"A ferramenta B<dh_makeshlibs> agora gera ficheiros shlibs com dependência de " +"versão por predefinição. Isto significa que B<-VUpstream-Version> (a.k.a. B<-" +"V>) é agora a predefinição." #. type: textblock -#: debhelper.pod:1227 -msgid "Changes from v13 are:" -msgstr "As alterações a partir de v13 são:" +#: debhelper-compat-upgrade-checklist.pod:247 +msgid "" +"If an unversioned dependency in the shlibs file is wanted, this can be " +"obtained by passing B<-VNone> instead. However, please see " +"L<dh_makeshlibs(1)> for the caveat of unversioned dependencies." +msgstr "" +"Se é pedida uma dependência sem versão no ficheiros shlibs, isto pode ser " +"conseguido ao passar B<-VNone> em substituição. No entanto, por favor veja " +"L<dh_makeshlibs(1)> para a problemática das dependências sem versão." #. type: textblock -#: debhelper.pod:1233 +#: debhelper-compat-upgrade-checklist.pod:253 msgid "" -"The B<cmake> buildsystem now passes B<-DCMAKE_SKIP_RPATH=ON> and B<-" -"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> to L<cmake(1)> to avoid some " -"reproducibility issues." +"The B<-s> (B<--same-arch>) option is removed. Please use B<-a> (B<--arch>) " +"instead." msgstr "" -"O sistema de compilação B<cmake> agora passa B<-DCMAKE_SKIP_RPATH=ON> e B<-" -"DCMAKE_BUILD_RPATH_USE_ORIGIN=ON> a L<cmake(1)> para evitar alguns problemas " -"de reprodutibilidade." +"A opção B<-s> (B<--same-arch>) foi removida. Por favor use B<-a> (B<--arch>) " +"em vez desta." #. type: textblock -#: debhelper.pod:1237 +#: debhelper-compat-upgrade-checklist.pod:257 msgid "" -"This can cause issues with running binaries directly from the build " -"directories as they might now require a manually set B<LD_LIBRARY_PATH>. If " -"you need to override this change, we recommend that you try to pass the B<-" -"DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the problem " -"(leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). This should " -"undo the need for B<LD_LIBRARY_PATH> and avoid the reproducibility issues on " -"Linux, where B<$ORIGIN> is supported by the runtime linkers." +"Invoking B<dh_clean -k> now causes an error instead of a deprecation warning." msgstr "" -"Isto pode causar problemas com o correr binários directamente dos " -"directórios de compilação pois eles podem não requerer uma " -"B<LD_LIBRARY_PATH> definida manualmente. Se você precisa de sobrepor esta " -"alteração, nós recomendamos que tente passar a opção B<-" -"DCMAKE_SKIP_RPATH=OFF> primeiro para ver se isso corrige o problema " -"(deixando B<CMAKE_BUILD_RPATH_USE_ORIGIN> na sua nova predefinição). Isto " -"deve desfazer a necessidade de B<LD_LIBRARY_PATH> e evitar os problemas de " -"reprodutibilidade em Linux, onde B<$ORIGIN> é suportado pelos vinculadores " -"de tempo-de-execução." +"Invocar B<dh_clean -k> agora causa um erro em vez de um aviso de " +"descontinuação." #. type: textblock -#: debhelper.pod:1247 -msgid "The tool B<dh_installsysusers> is now included in the default sequence." +#: debhelper-compat-upgrade-checklist.pod:262 +msgid "" +"The B<--no-restart-on-upgrade> option in B<dh_installinit> has been " +"removed. Please use the new name B<--no-stop-on-upgrade>" msgstr "" -"A ferramenta B<dh_installsysusers> está agora incluÃda na sequência " -"predefinida." - -#. type: =head1 -#: debhelper.pod:1253 dh_auto_test:48 dh_dwz:69 dh_installcatalogs:67 -#: dh_installdocs:202 dh_installemacsen:75 dh_installexamples:92 -#: dh_installinit:205 dh_installinitramfs:60 dh_installman:131 -#: dh_installmodules:57 dh_installudev:50 dh_installwm:66 dh_installxfonts:40 -#: dh_movefiles:67 dh_strip:119 dh_usrlocal:60 dh_systemd_enable:104 -#: dh_systemd_start:68 -msgid "NOTES" -msgstr "NOTAS" - -#. type: =head2 -#: debhelper.pod:1255 -msgid "Multiple binary package support" -msgstr "Suporte a pacotes de múltiplos binários" +"A opção B<--no-restart-on-upgrade> em B<dh_installinit> foi removida. Por " +"favor use o novo nome B<--no-stop-on-upgrade>" #. type: textblock -#: debhelper.pod:1257 +#: debhelper-compat-upgrade-checklist.pod:267 msgid "" -"If your source package generates more than one binary package, debhelper " -"programs will default to acting on all binary packages when run. If your " -"source package happens to generate one architecture dependent package, and " -"another architecture independent package, this is not the correct behavior, " -"because you need to generate the architecture dependent packages in the " -"binary-arch F<debian/rules> target, and the architecture independent " -"packages in the binary-indep F<debian/rules> target." +"There was a bug in the B<doit> (and similar) functions from L<Debian::" +"Debhelper::Dh_Lib> that made them spawn a shell in one particular " +"circumstance. This bug is now removed and will cause helpers that rely on " +"the bug to fail with a \"command not found\"-error." msgstr "" -"Se o seu pacote fonte gerar mais do que um pacote binário, os programas do " -"debhelper, por predefinição, irão actuar em todos os pacotes binários quando " -"correm. No caso do seu pacote fonte gerar um pacote dependente de " -"arquitectura, e outro pacote independente da arquitectura, este não é o " -"comportamento correcto, porque você precisa de gerar os pacotes dependentes " -"de arquitectura no alvo F<debian/rules> binary-arch, e os pacotes " -"independentes de arquitectura no alvo F<debian/rules> binary-indep." +"Existia um bug nas funções B<doit> (e similares) a partir de L<Debian::" +"Debhelper::Dh_Lib> que fazia aparece uma linha de comandos numa " +"circunstância particular. Este bug foi agora removido e irá fazer com que os " +"ajudantes que contavam com esse bug falhem com um erro de \"comando não " +"encontrado\"." #. type: textblock -#: debhelper.pod:1265 +#: debhelper-compat-upgrade-checklist.pod:274 msgid "" -"To facilitate this, as well as give you more control over which packages are " -"acted on by debhelper programs, all debhelper programs accept the B<-a>, B<-" -"i>, B<-p>, and B<-s> parameters. These parameters are cumulative. If none " -"are given, debhelper programs default to acting on all packages listed in " -"the control file, with the exceptions below." +"The B<--list-missing> and B<--fail-missing> in B<dh_install> has been " +"removed. Please use B<dh_missing> and its corresponding options, which can " +"also see the files installed by other helpers." msgstr "" -"Para facilitar isto, e também para lhe dar mais controle sobre em quais " -"pacotes os programas debhelper actuam, todos os programas debhelper aceitam " -"os parâmetros B<-a>, B<-i>, B<-p>, e B<-s>. Estes parâmetros são " -"cumulativos. Se nenhum for usado, os programas debhelper por predefinição " -"actuam em todos os pacotes listados no ficheiro de controle, com as " -"excepções em baixo." +"O B<--list-missing> e B<--fail-missing> em B<dh_install> foram removidos. " +"Por favor use B<dh_missing> e as suas opções correspondentes, o qual pode " +"também ver os ficheiros instalados por outros ajudantes." #. type: textblock -#: debhelper.pod:1271 +#: debhelper-compat-upgrade-checklist.pod:280 msgid "" -"First, any package whose B<Architecture> field in B<debian/control> does not " -"match the B<DEB_HOST_ARCH> architecture will be excluded (L<Debian Policy, " -"section 5.6.8>)." +"The B<dh_installinit> helper no longer installs configuration for the " +"upstart init system. Instead, it will abort the build if it finds an old " +"upstart configuration file. The error is there to remind the package " +"maintainer to ensure the proper removal of the conffiles shipped in previous " +"versions of the package (if any)." msgstr "" -"Primeiro, qualquer pacote cujo campo B<Architecture> em B<debian/control> " -"não corresponda à arquitectura B<DEB_HOST_ARCH> será excluÃdo (L<Debian " -"Policy, secção 5.6.8>)." +"O ajudante B<dh_installinit> já não instala configuração para o sistema de " +"init upstart. Em vez disso, irá abortar a compilação se encontrar um " +"ficheiro de configuração upstart antigo. O erro está lá para lembrar ao " +"maintainer do pacote para assegurar a remoção apropriada dos ficheiros de " +"configuração empacotados em versões anteriores do pacote (caso existam)." #. type: textblock -#: debhelper.pod:1275 +#: debhelper-compat-upgrade-checklist.pod:288 msgid "" -"Also, some additional packages may be excluded based on the contents of the " -"B<DEB_BUILD_PROFILES> environment variable and B<Build-Profiles> fields in " -"binary package stanzas in B<debian/control>, according to the draft policy " -"at L<https://wiki.debian.org/BuildProfileSpec>." +"The B<dh_installdeb> tool will do basic validation of some L<dpkg-" +"maintscript-helper(1)> commands and will error out if the commands appear to " +"be invalid." msgstr "" -"Também, alguns pacotes adicionais podem ser excluÃdos com base no conteúdo " -"da variável de ambiente B<DEB_BUILD_PROFILES> e nos campos B<Build-Profiles> " -"nas estrofes de pacotes binários em B<debian/control>, de acordo com a " -"polÃtica proposta em L<https://wiki.debian.org/BuildProfileSpec>." +"A ferramenta B<dh_installdeb> irá fazer validação básica de alguns comandos " +"L<dpkg-maintscript-helper(1)> e irá terminar em erro se os comandos " +"parecerem ser inválidos." -#. type: =head3 -#: debhelper.pod:1280 -msgid "Interaction between package selections and Build-Profiles" -msgstr "Interacção entre selecções de pacotes e Build-Profiles" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:294 +msgid "The B<dh_missing> tool will now default to B<--list-missing>." +msgstr "" +"A ferramenta B<dh_missing> irá agora usar por predefinição B<--list-missing>." #. type: textblock -#: debhelper.pod:1282 +#: debhelper-compat-upgrade-checklist.pod:298 msgid "" -"Build-Profiles affect which packages are included in the package selections " -"mechanisms in debhelper. Generally, the package selections are described " -"from the assumption that all packages are enabled. This section describes " -"how the selections react when a package is disabled due to the active Build-" -"Profiles (or lack of active Build-Profiles)." +"The B<dh_makeshlibs> tool will now only pass libraries to L<dpkg-" +"gensymbols(1)> if the ELF binary has a SONAME (containing \".so\")." msgstr "" -"Build-Profiles afectam quais pacotes são incluÃdos nos mecanismos de " -"selecção de pacotes do debhelper. Geralmente, as selecções de pacotes são " -"descritas a partir do pressuposto que todos os pacotes estão activados. Esta " -"secção descreve como as selecções reagem quando um pacote é desactivado " -"devido a Build-Profiles activos (ou a falta de Build-Profiles activos)." +"A ferramenta B<dh_makeshlibs> irá agora apenas passar bibliotecas para " +"L<dpkg-gensymbols(1)> se o binário ELF tiver um SONAME (contendo \".so\")." -#. type: =item -#: debhelper.pod:1290 -msgid "-a/--arch, -i/--indep OR no selection options (a raw \"dh_X\" call)" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:303 +msgid "" +"The B<dh_compress> tool no longer compresses examples (i.e. anything " +"installed in F<</usr/share/doc/I<package>/examples>>.)" msgstr "" -"-a/--arch, -i/--indep OU nenhuma opção de selecção (uma chamada \"dh_X\" " -"crua)" +"A ferramenta B<dh_compress> não mais comprime exemplos (isto é, nada " +"instalado em F<</usr/share/doc/I<pacote>/examples>>.)" #. type: textblock -#: debhelper.pod:1292 +#: debhelper-compat-upgrade-checklist.pod:308 msgid "" -"The package disabled by Build-Profiles is silently excluded from the " -"selection." +"The standard sequence in B<dh> now includes B<dh_dwz> and " +"B<dh_installinitramfs> by default. This makes the B<dwz> and " +"B<installinitramfs> sequences obsolete and they will now fail with an " +"error. If you want to skip these commands, then please insert an empty " +"override target for them in F<debian/rules> (e.g. I<override_dh_dwz:>)" msgstr "" -"O pacote desactivado por Build-Profiles é excluÃdo em silêncio da selecção." +"A sequência standard em B<dh> agora inclui B<dh_dwz> e " +"B<dh_installinitramfs> por predefinição. Isto tornas as sequências B<dwz> e " +"B<installinitramfs> obsoletas e elas agora irão falhar com um erro. Se " +"desejar saltar estes comandos, por favor insira um alvo de sobreposição " +"vazio para eles em F<debian/rules> (ex. I<override_dh_dwz:>)" #. type: textblock -#: debhelper.pod:1295 +#: debhelper-compat-upgrade-checklist.pod:317 msgid "" -"Note you will receive a warning if I<all> packages related to these " -"selections are disabled. In that case, it generally does not make sense to " -"do the build in the first place." +"The build systems B<meson> and B<autoconf> no longer explicitly set the B<--" +"libexecdir> variable and thus relies on the build system default - which " +"should be B</usr/libexec> (per FHS 3.0, adopted in Debian Policy 4.1.5)." msgstr "" -"Note que vai receber um aviso se I<todos> os pacotes relacionados com estas " -"selecções estiverem desactivados. Nesse caso, geralmente não faz nenhum " -"sentido sequer fazer a compilação." +"Os sistemas de compilação B<meson> e B<autoconf> não mais definem " +"explicitamente a variável B<--libexecdir> e assim apoia-se na predefinição " +"do sistema de compilação - O qual deve ser B</usr/libexec> (por FHS 3.0, " +"adoptado em Debian Policy 4.1.5)." -#. type: =item -#: debhelper.pod:1299 -msgid "-N I<package> / --no-package I<package>" -msgstr "-N I<package> / --no-package I<package>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:322 +msgid "" +"If a particular upstream package does not use the correct default, the " +"parameter can often be passed manually via L<dh_auto_configure(1)>. E.g. " +"via the following example:" +msgstr "" +"Se um determinado pacote original do autor não usar a predefinição correcta, " +"o parâmetro pode muitas vezes ser passado manualmente via " +"L<dh_auto_configure(1)>. Por exemplo via seguinte exemplo:" + +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:326 +#, no-wrap +msgid "" +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" +"\n" +msgstr "" +" override_dh_auto_configure:\n" +" \tdh_auto_configure -- --libexecdir=/usr/libexec\n" +"\n" #. type: textblock -#: debhelper.pod:1301 -msgid "The option is accepted and effectively does nothing." -msgstr "A opção é aceite e efectivamente não faz nada." +#: debhelper-compat-upgrade-checklist.pod:329 +msgid "Note the B<--> before the B<--libexecdir> parameter." +msgstr "Note o B<--> antes do parâmetro B<--libexecdir>." -#. type: =item -#: debhelper.pod:1303 -msgid "-p I<package> / --package I<package>" -msgstr "-p I<package> / --package I<package>" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:333 +msgid "B<Retroactively removed in debhelper/13.5>:" +msgstr "B<Retroativamente removido em debhelper/13.5>:" #. type: textblock -#: debhelper.pod:1305 -msgid "The option is accepted, but debhelper will not act on the package." -msgstr "A opção é aceite, mas o debhelper não irá actuar no pacote." +#: debhelper-compat-upgrade-checklist.pod:335 +msgid "" +"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+." +msgstr "" +"A ferramenta B<dh_installdeb> não iria mais instalar o ficheiro F<conffiles> " +"fornecido pelo responsável pois isso foi considerado desnecessário. No " +"entanto, o B<remove-on-upgrade> do dpkg/1.20 tornou o ficheiro relevante de " +"novo e B<dh_installdeb> agora instala-o nos nÃveis de compatibilidade 12+." #. type: textblock -#: debhelper.pod:1309 +#: debhelper-compat-upgrade-checklist.pod:342 msgid "" -"Note that it does not matter whether a package is enabled or disabled by " +"The B<dh_installsystemd> tool no longer relies on B<dh_installinit> for " +"handling systemd services that have a sysvinit alternative. Both tools must " +"now be used in such a case to ensure the service is properly started under " +"both sysvinit and systemd." +msgstr "" +"A ferramenta B<dh_installsystemd> não mais se apoia em B<dh_installinit> " +"para lidar com os serviços do systemd que têm uma alternativa de sysvinit. " +"ambas ferramentas devem agora ser usadas em tais casos para assegurar que o " +"serviço é arrancado correctamente sob ambos sysvinit e systemd." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:347 +msgid "" +"If you have an override for B<dh_installinit> (e.g. to call it with B<--no-" +"start>) then you will probably need one for B<dh_installsystemd> as well now." +msgstr "" +"Se tiver uma sobreposição para B<dh_installinit> (ex. para chamá-lo com B<--" +"no-start>) então irá provavelmente precisar agora também de um para " +"B<dh_installsystemd>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:351 +msgid "" +"This change makes B<dh_installinit> inject a I<misc:Pre-Depends> for B<< " +"init-system-helpers (>= 1.54~) >>. Please ensure that the package lists " +"B<${misc:Pre-Depends}> in its B<Pre-Depends> field before upgrading to " +"compat 12." +msgstr "" +"Esta alteração faz B<dh_installinit> injectar um I<misc:Pre-Depends> para " +"B<< init-system-helpers (>= 1.54~) >>. Por favor assegure que o pacote " +"lista B<${misc:Pre-Depends}> no seu campo B<Pre-Depends> antes de actualizar " +"para a compatibilidade 12." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:358 +msgid "" +"The third-party B<dh_golang> tool (from B<dh-golang> package) now defaults " +"on honoring B<DH_GOLANG_EXCLUDES> variable for source installation in -dev " +"packages and not only during the building process. Please set " +"B<DH_GOLANG_EXCLUDES_ALL> to false to revert to the previous behaviour. See " +"B<Debian::Debhelper::Buildsystem::golang(3pm)> for details and examples." +msgstr "" +"Esta ferramenta de terceiros B<dh_golang> (do pacote B<dh-golang>) agora por " +"predefinição honra a variável B<DH_GOLANG_EXCLUDES> para instalação fonte em " +"pacotes -dev e não apenas durante o processo de compilação. Por favor defina " +"B<DH_GOLANG_EXCLUDES_ALL> para falso para reverter para o comportamento " +"anterior. Veja B<Debian::Debhelper::Buildsystem::golang(3pm)> para detalhes " +"e exemplos" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:366 +msgid "" +"B<dh_installsystemduser> is now included in the B<dh> standard sequence by " "default." msgstr "" -"Note que não importa se um pacote está activado ou desactivado por " +"B<dh_installsystemduser> é agora incluÃdo na sequência standard do B<dh> por " "predefinição." -#. type: =head2 -#: debhelper.pod:1312 -msgid "Automatic generation of Debian install scripts" -msgstr "Geração automática de scripts de instalação Debian" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:371 +msgid "" +"The B<python-distutils> buildsystem is now removed. Please use the third-" +"party build system B<pybuild> instead." +msgstr "" +"O sistema de compilação B<python-distutils> foi agora removido. Por favor " +"use o sistema de compilação de terceiros B<pybuild> em substituição." + +#. type: =item +#: debhelper-compat-upgrade-checklist.pod:376 +msgid "v11" +msgstr "v11" #. type: textblock -#: debhelper.pod:1314 +#: debhelper-compat-upgrade-checklist.pod:378 +msgid "This mode is discouraged." +msgstr "Este modo está desencorajado." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:380 msgid "" -"Some debhelper commands will automatically generate parts of Debian " -"maintainer scripts. If you want these automatically generated things " -"included in your existing Debian maintainer scripts, then you need to add " -"B<#DEBHELPER#> to your scripts, in the place the code should be added. " -"B<#DEBHELPER#> will be replaced by any auto-generated code when you run " -"B<dh_installdeb>." +"The compat 11 is discouraged for new packages as it suffers from feature " +"interaction between L<dh_installinit> and L<dh_installsystemd> causing " +"services to not run correctly in some cases. Please consider using " +"compatibility mode 10 or 12 instead. More details about the issue are " +"available in Debian#887904 and L<https://lists.debian.org/debian-" +"release/2019/04/msg01442.html>." msgstr "" -"Alguns comandos do debhelper irão gerar automaticamente partes de scripts de " -"maintainer Debian. Se desejar que estas coisas geradas automaticamente sejam " -"incluÃdas nos sues scripts de maintainer Debian existentes, então você " -"precisa adicionar B<#DEBHELPER#> aos seus scripts, no local onde o código " -"deverá ser adicionado. B<#DEBHELPER#> será substituÃdo por qualquer código " -"auto-gerado quando você correr o B<dh_installdeb>." +"A compatibilidade 11 é desencorajada para novos pacotes pois sofre de " +"interação de caracterÃsticas entre L<dh_installinit> e L<dh_installsystemd> " +"o que causa com que os serviços não funcionem correctamente em alguns casos. " +"Por favor considere usar modo de compatibilidade 10 ou 12 em vez deste. " +"Mais detalhes sobre este problema estão disponÃveis em Debian#887904 e " +"L<https://lists.debian.org/debian-release/2019/04/msg01442.html>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:387 +msgid "Changes from v10 are:" +msgstr "As alterações a partir de v10 são:" #. type: textblock -#: debhelper.pod:1321 +#: debhelper-compat-upgrade-checklist.pod:393 msgid "" -"If a script does not exist at all and debhelper needs to add something to " -"it, then debhelper will create the complete script." +"B<dh_installinit> no longer installs F<service> or F<tmpfile> files, nor " +"generates maintainer scripts for those files. Please use the new " +"B<dh_installsystemd> helper." msgstr "" -"Se não existir nenhum script e o debhelper precisar de adicionar algo a ele, " -"então o debhelper irá criar o script completo." +"B<dh_installinit> já não instala ficheiros F<service> ou F<tmpfile>, nem " +"gera scripts do maintainer para esses ficheiros, Por favor use o novo " +"ajudante B<dh_installsystemd>" #. type: textblock -#: debhelper.pod:1324 +#: debhelper-compat-upgrade-checklist.pod:399 msgid "" -"All debhelper commands that automatically generate code in this way let it " -"be disabled by the -n parameter (see above)." +"The B<dh_systemd_enable> and B<dh_systemd_start> helpers have been replaced " +"by the new B<dh_installsystemd> helper. For the same reason, the B<systemd> " +"sequence for B<dh> has also been removed. If you need to disable the " +"B<dh_installsystemd> helper tool, please use an empty override target." msgstr "" -"Todos os comandos debhelper que geram código automaticamente deste modo " -"permitem que o seja desactivado pelo parâmetro -n (ver em cima)." +"Os ajudantes B<dh_systemd_enable>e B<dh_systemd_start> foram substituÃdos " +"pelo novo ajudante B<dh_installsystemd>. Pela mesma razão, a sequência do " +"B<systemd> para B<dh> foi também removida. Se você precisar de desactivar a " +"ferramenta de ajuda B<dh_installsystemd>, por favor use um alvo de " +"sobreposição vazio." #. type: textblock -#: debhelper.pod:1327 +#: debhelper-compat-upgrade-checklist.pod:405 msgid "" -"Note that the inserted code will be shell code, so you cannot directly use " -"it in a Perl script. If you would like to embed it into a Perl script, here " -"is one way to do that (note that I made sure that $1, $2, etc are set with " -"the set command):" +"Please note that the B<dh_installsystemd> tool has a slightly different " +"behaviour in some cases (e.g. when using the B<--name> parameter)." msgstr "" -"Note que o código inserido será código shell, portanto você não pode usá-lo " -"directamente num script de Perl. Se desejar embebê-lo num script Perl, aqui " -"está um modo de o fazer (note que Eu certifico-me que $1, $2, etc são " -"definidos com o comando \"set\"):" +"Por favor note que a ferramenta B<dh_installsystemd> tem um comportamento " +"ligeiramente diferente em alguns casos (ex. quando se usa o parâmetro B<--" +"name>)." -#. type: verbatim -#: debhelper.pod:1332 -#, no-wrap +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:411 msgid "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"The debhelper script failed with error code: ${exit_code}\");\n" -" } else {\n" -" die(\"The debhelper script was killed by signal: ${signal}\");\n" -" }\n" -" }\n" -"\n" +"B<dh_installdirs> no longer creates debian/I<package> directories unless " +"explicitly requested (or it has to create a subdirectory in it)." msgstr "" -" my $temp=\"set -e\\nset -- @ARGV\\n\" . << 'EOF';\n" -" #DEBHELPER#\n" -" EOF\n" -" if (system($temp)) {\n" -" my $exit_code = ($? >> 8) & 0xff;\n" -" my $signal = $? & 0x7f;\n" -" if ($exit_code) {\n" -" die(\"The debhelper script failed with error code: ${exit_code}\");\n" -" } else {\n" -" die(\"The debhelper script was killed by signal: ${signal}\");\n" -" }\n" -" }\n" -"\n" +"B<dh_installdirs> já não cria directórios debian/I<pacote> a menos que tal " +"seja explicitamente pedido (ou se tiver de criar um sub-directório nele)." -#. type: =head2 -#: debhelper.pod:1345 -msgid "Automatic generation of miscellaneous dependencies." -msgstr "Geração automática de dependências variadas." +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:415 +msgid "The vast majority of all packages will be unaffected by this change." +msgstr "A grande maioria dos pacotes não serão afectados por esta alteração." #. type: textblock -#: debhelper.pod:1347 +#: debhelper-compat-upgrade-checklist.pod:419 msgid "" -"Some debhelper commands may make the generated package need to depend on " -"some other packages. For example, if you use L<dh_installdebconf(1)>, your " -"package will generally need to depend on debconf. Or if you use " -"L<dh_installxfonts(1)>, your package will generally need to depend on a " -"particular version of xutils. Keeping track of these miscellaneous " -"dependencies can be annoying since they are dependent on how debhelper does " -"things, so debhelper offers a way to automate it." +"The B<makefile> buildsystem now passes B<INSTALL=\"install --strip-" +"program=true\"> to L<make(1)>. Derivative buildsystems (e.g. B<configure> " +"or B<cmake>) are unaffected by this change." msgstr "" -"Alguns programas debhelper podem fazer com que o pacote gerado precise de " -"depender de alguns outros pacotes. Por exemplo, se você usar o " -"L<dh_installdebconf(1)>, o seu pacote irá geralmente depender do debconf. Ou " -"se você usar L<dh_installxfonts(1)>, o seu pacote irá geralmente depender de " -"uma versão particular do xutils. Acompanhar estas dependências variadas pode " -"ser aborrecido pois elas dependem de como o debhelper faz as coisas, então o " -"debhelper oferece um modo de automatizar isto." +"O sistema de compilação B<makefile> agora passa B<INSTALL=\"install --strip-" +"program=true\"> para o L<make(1)>. Sistemas de compilação derivativos (ex. " +"B<configure> ou B<cmake>) não são afectados por esta alteração." #. type: textblock -#: debhelper.pod:1355 +#: debhelper-compat-upgrade-checklist.pod:425 msgid "" -"All commands of this type, besides documenting what dependencies may be " -"needed on their man pages, will automatically generate a substvar called B<" -"${misc:Depends}>. If you put that token into your F<debian/control> file, it " -"will be expanded to the dependencies debhelper figures you need." +"The B<autoconf> buildsystem now passes B<--runstatedir=/run> to F<./" +"configure>." msgstr "" -"Todos os comandos deste tipo, além de documentar quais dependências podem " -"ser necessárias nos seus manuais, irão gerar automaticamente um substvar " -"chamado B<${misc:Depends}>. Se você colocar esse token no seu ficheiro " -"F<debian/control>, será expandido à s dependências que o debhelper descobre " -"que você precisa." +"O sistema de compilação B<autoconf> agora passa B<--runstatedir=/run> para " +"F<./configure>." #. type: textblock -#: debhelper.pod:1360 +#: debhelper-compat-upgrade-checklist.pod:430 msgid "" -"This is entirely independent of the standard B<${shlibs:Depends}> generated " -"by L<dh_makeshlibs(1)>, and the B<${perl:Depends}> generated by " -"L<dh_perl(1)>. You can choose not to use any of these, if debhelper's " -"guesses don't match reality." +"The B<cmake> buildsystem now passes B<-DCMAKE_INSTALL_RUNSTATEDIR=/run> to " +"L<cmake(1)>." msgstr "" -"Isto é inteiramente independente do standard B<${shlibs:Depends}> gerado " -"pelo L<dh_makeshlibs(1)>, e do B<${perl:Depends}> gerado pelo L<dh_perl(1)>. " -"Você pode escolher usar qualquer um destes, se as escolhas do debhelper não " -"corresponderem à realidade." +"O sistema de compilação B<cmake> agora passa B<-DCMAKE_INSTALL_RUNSTATEDIR=/" +"run> para L<cmake(1)>." -#. type: =head2 -#: debhelper.pod:1365 -msgid "Package build directories" -msgstr "Directórios de compilação de pacotes" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:435 +msgid "" +"B<dh_installman> will now prefer detecting the language from the path name " +"rather than the extension." +msgstr "" +"B<dh_installman> irá agora preferir detectar a linguagem a partir do nome de " +"caminho em vez de a extensão." #. type: textblock -#: debhelper.pod:1367 +#: debhelper-compat-upgrade-checklist.pod:440 msgid "" -"By default, all debhelper programs assume that the temporary directory used " -"for assembling the tree of files in a package is debian/I<package>." +"B<dh_auto_install> will now only create the destination directory it needs. " +"Previously, it would create the package build directory for all packages. " +"This will not affect packages that only build with debhelper commands, but " +"it may expose bugs in commands not included in debhelper." msgstr "" -"Por predefinição, todos os programas do debhelper assumem que o directório " -"temporário usado para montar a árvore de ficheiros num pacote é debian/" -"I<pacote>." +"B<dh_auto_install> irá agora apenas criar o directório de destino que " +"precisa. Anteriormente, iria criar o directório de compilação de pacote para " +"todos os pacotes. Isto não vai afectar pacotes que apenas compilam com " +"comandos debhelper, mas pode expor bugs em comandos não incluÃdos no " +"debhelper." #. type: textblock -#: debhelper.pod:1370 +#: debhelper-compat-upgrade-checklist.pod:448 msgid "" -"Sometimes, you might want to use some other temporary directory. This is " -"supported by the B<-P> flag. For example, \"B<dh_installdocs -Pdebian/tmp>" -"\", will use B<debian/tmp> as the temporary directory. Note that if you use " -"B<-P>, the debhelper programs can only be acting on a single package at a " -"time. So if you have a package that builds many binary packages, you will " -"need to also use the B<-p> flag to specify which binary package the " -"debhelper program will act on." +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now error out if their config has a pattern that does not " +"match anything or reference a path that does not exist." msgstr "" -"Por vezes, você pode querer usar outro directório temporário. Isto é " -"suportado pela bandeira B<-P>, por exemplo, \"B<dh_installdocs -Pdebian/tmp>" -"\", irá usar B<debian/tmp> como directório temporário. Note que se você usar " -"B<-P>, os programas debhelper só podem actuar num pacote de cada vez. Por " -"isso se tem um pacote que compila muitos pacotes binários, irá também " -"precisar de usar a bandeira B<-p> para especificar em qual pacote binário o " -"programa debhelper irá actuar." +"Os ajudantes B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, e " +"B<dh_installman> agora dão erro se a sua configuração tiver um padrão que " +"não coincida com nada ou faça referência a um caminho que não exista." -#. type: =head2 -#: debhelper.pod:1378 -msgid "udebs" -msgstr "udebs" +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:452 +msgid "" +"Known exceptions include building with the B<nodoc> profile, where the above " +"tools will silently permit failed matches where the patterns are used to " +"specify documentation." +msgstr "" +"Excepções conhecidas incluem compilar com o perfil B<nodoc>, onde as " +"ferramentas de cima irão permitir em silêncio correspondências falhadas onde " +"os padrões são usados para especificar documentação." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:458 +msgid "" +"The helpers B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, and " +"B<dh_installman> now accept the parameter B<--sourcedir> with same meaning " +"as B<dh_install>. Furthermore, they now also fall back to F<debian/tmp> like " +"B<dh_install>." +msgstr "" +"Os ajudantes B<dh_installdocs>, B<dh_installexamples>, B<dh_installinfo>, e " +"B<dh_installman> agora aceitam o parâmetro B<--sourcedir> com o mesmo " +"significado que B<dh_install>. Mais ainda, eles agora também retornam (em " +"fall back) a F<debian/tmp> como B<dh_install>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:463 +msgid "" +"Migration note: A bug in debhelper 11 up to 11.1.5 made B<dh_installinfo> " +"incorrectly ignore B<--sourcedir>." +msgstr "" +"Nota de migração: Um bug no debhelper 11 até ao 11.1.5 faz com que " +"B<dh_installinfo> ignore incorrectamente B<--sourcedir>." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:468 +msgid "" +"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)." +msgstr "" +"Os sistemas de compilação B<perl-makemaker> e B<perl-build> já não passam B<-" +"I.> ao perl. Os pacotes que ainda precisam deste comportamento podem emula-" +"lo ao usar a variável de ambiente B<PERL5LIB>. Ex. ao adicionar B<export " +"PERL5LIB=.> no seu ficheiro debian/rules (ou semelhante)." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:475 +msgid "" +"The B<PERL_USE_UNSAFE_INC> environment variable is no longer set by B<dh> or " +"any of the B<dh_auto_*> tools. It was added as a temporary work around to " +"avoid a lot of packages failing to build at the same time." +msgstr "" +"A variável de ambiente B<PERL_USE_UNSAFE_INC> já não é definida pelo B<dh> " +"ou nenhuma das ferramentas B<dh_auto_*>. Ela foi adicionada como um meio de " +"contorno temporário evitar muitos pacotes a falharem a compilação ao mesmo " +"tempo." -# FIXME : a udeb #. type: textblock -#: debhelper.pod:1380 +#: debhelper-compat-upgrade-checklist.pod:480 msgid "" -"Debhelper includes support for udebs. To create a udeb with debhelper, add " -"\"B<Package-Type: udeb>\" to the package's stanza in F<debian/control>. " -"Debhelper will try to create udebs that comply with debian-installer policy, " -"by making the generated package files end in F<.udeb>, not installing any " -"documentation into a udeb, skipping over F<preinst>, F<postrm>, F<prerm>, " -"and F<config> scripts, etc." +"Note this item will eventually become obsolete as upstream intends to drop " +"support for the B<PERL_USE_UNSAFE_INC> environment variable. When perl " +"drops support for it, then this variable will be removed retroactively from " +"existing compat levels as well." msgstr "" -"Debhelper inclui suporte para udebs. Para criar um udeb com o debhelper, " -"adicione \"B<Package-Type: udeb>\" à estrofe do pacote em F<debian/control>. " -"O Debhelper irá tentar criar udebs em conformidade com a polÃtica do " -"instalador debian, ao finalizar os ficheiros de pacotes gerados com F<." -"udeb>, não instalando nenhuma documentação num udeb, saltando os scripts " -"F<preinst>, F<postrm>, F<prerm>, e F<config>, etc." - -#. type: =head1 -#: debhelper.pod:1387 -msgid "ENVIRONMENT" -msgstr "AMBIENTE" +"Note que este item irá eventualmente tornar-se obsoleto pois o auto pretende " +"abandonar o suporte para a variável de ambiente B<PERL_USE_UNSAFE_INC>. " +"Quando o perl abandonar o para ala, então esta variável será também removida " +"retroactivamente dos nÃveis de compatibilidade existentes." #. type: textblock -#: debhelper.pod:1389 +#: debhelper-compat-upgrade-checklist.pod:487 msgid "" -"This section describes some of the environment variables that influences the " -"behaviour of debhelper or which debhelper interacts with." +"The B<dh_makeshlibs> helper will now exit with an error if objdump returns a " +"non-zero exit from analysing a given file." msgstr "" -"Esta secção descreve algumas das variáveis de ambiente que influenciam o " -"comportamento do debhelper ou de quem o debhelper interage." +"O ajudante B<dh_makeshlibs> irá agora terminar em erro se objdump retornar " +"uma saÃda não-zero a partir da análise de um determinado ficheiro." #. type: textblock -#: debhelper.pod:1392 +#: debhelper-compat-upgrade-checklist.pod:492 msgid "" -"It is important to note that these must be actual environment variables in " -"order to affect the behaviour of debhelper (not simply F<Makefile> " -"variables). To specify them properly in F<debian/rules>, be sure to " -"\"B<export>\" them. For example, \"B<export DH_VERBOSE>\"." +"The B<dh_installdocs> and B<dh_installexamples> tools may now install " +"I<most> of the documentation in a different path to comply with the " +"recommendation from Debian policy §12.3 (since version 3.9.7)." msgstr "" -"É importante notar que estas que estas têm de ser mesmo variáveis de " -"ambiente de modo a afectarem o comportamento do debhelper (e não " -"simplesmente variáveis do F<Makefile>). Para as especificar correctamente em " -"F<debian/rules>, assegure-se de lhes fazer \"B<export>\". Por exemplo, " -"\"B<export DH_VERBOSE>\"" - -#. type: =item -#: debhelper.pod:1399 -msgid "B<DH_VERBOSE>" -msgstr "B<DH_VERBOSE>" +"As ferramentas B<dh_installdocs> e B<dh_installexamples> podem agora " +"instalar I<a maioria> da documentação num caminho diferente para cumprir com " +"a recomendação da polÃtica Debian §12.3 (desde versão 3.9.7)." #. type: textblock -#: debhelper.pod:1401 +#: debhelper-compat-upgrade-checklist.pod:496 msgid "" -"Set to B<1> to enable verbose mode. Debhelper will output every command it " -"runs. Also enables verbose build logs for some build systems like autoconf." +"Note that if a given source package only contains a single binary package in " +"F<debian/control> or none of the packages are I<-doc> packages, then this " +"change is not relevant for that source package and you can skip to the next " +"change." msgstr "" -"Defina para B<1> para activar o modo detalhado. O debhelper irá mostrar os " -"resultados de cada comando que corre. Também activa relatórios de compilação " -"detalhados para alguns sistemas de compilação como o autoconf." - -#. type: =item -#: debhelper.pod:1404 -msgid "B<DH_QUIET>" -msgstr "B<DH_QUIET>" +"Note que um dado pacote fonte apenas contém um único pacote binário em " +"F<debian/control> ou nenhum dos pacotes são pacotes I<-doc>, então esta " +"alteração não é relevante para esse pacote fonte e você pode saltar a " +"próxima alteração." #. type: textblock -#: debhelper.pod:1406 +#: debhelper-compat-upgrade-checklist.pod:501 msgid "" -"Set to B<1> to enable quiet mode. Debhelper will not output commands calling " -"the upstream build system nor will dh print which subcommands are called and " -"depending on the upstream build system might make that more quiet, too. " -"This makes it easier to spot important messages but makes the output quite " -"useless as buildd log. Ignored if DH_VERBOSE is also set." +"By default, these tools will now attempt to determine a \"main package for " +"the documentation\" (called a I<doc-main-package> from here on) for every I<-" +"doc> package. If they find such a I<doc-main-package>, they will now " +"install the documentation into the path F<< /usr/share/doc/I<doc-main-" +"package> >> in the given doc package. I.e. the path can change but the " +"documentation is still shipped in the I<-doc> package." msgstr "" -"Definir para B<1> para activar o modo silencioso. O Debhelper não irá " -"escrever os comandos a chamar o sistema de compilação do autor nem o dh irá " -"escrever quais sub-comandos são chamados e dependendo do sistema de " -"compilação do autor, poderá também tornar isso mais silencioso. Isto " -"facilita a identificação de mensagens importantes mas torna os resultados " -"inúteis como relatório do buildd. É ignorado se DH_VERBOSE for também " -"definido." - -#. type: =item -#: debhelper.pod:1413 -msgid "B<DH_COMPAT>" -msgstr "B<DH_COMPAT>" +"Por predefinição, estas ferramentas irão agora tentar determinar um \"pacote " +"principal para a documentação\" (chamado um I<doc-main-package> daqui em " +"diante) para cada pacote I<-doc>. Se encontrarem o tal I<doc-main-package>, " +"irão agora instalar a documentação em F<< /usr/share/doc/I<doc-main-package> " +">> no pacote doc fornecido. Isto é, o caminho pode mudar mas a documentação " +"será na mesma enviada no pacote I<-doc>." #. type: textblock -#: debhelper.pod:1415 +#: debhelper-compat-upgrade-checklist.pod:509 msgid "" -"Temporarily specifies what compatibility level debhelper should run at, " -"overriding any value specified via Build-Depends on debhelper-compat or via " -"the F<debian/compat> file." +"The B<--doc-main-package> option can be used when the auto-detection is " +"insufficient or to reset the path to its previous value if there is a reason " +"to diverge from Debian policy recommendation." msgstr "" -"Especifica temporariamente em que nÃvel de compatibilidade o debhelper deve " -"correr, sobrepondo qualquer valor especificado via Build-Depend em debhelper-" -"compat ou via ficheiro F<debian/compat>." - -#. type: =item -#: debhelper.pod:1419 -msgid "B<DH_NO_ACT>" -msgstr "B<DH_NO_ACT>" +"A opção B<--doc-main-package> pode ser usada quando a auto-detecção é " +"insuficiente ou para reiniciar o caminho para o seu valor anterior se " +"existir razão para divergir da recomendação da polÃtica Debian." #. type: textblock -#: debhelper.pod:1421 -msgid "Set to B<1> to enable no-act mode." -msgstr "Defina para B<1> para activar o modo no-act." - -#. type: =item -#: debhelper.pod:1423 -msgid "B<DH_OPTIONS>" -msgstr "B<DH_OPTIONS>" +#: debhelper-compat-upgrade-checklist.pod:513 +msgid "" +"Some documentation will not be affected by this change. These exceptions " +"include the copyright file, changelog files, README.Debian, etc. These " +"files will still be installed in the path F<< /usr/share/doc/I<package> >>." +msgstr "" +"Alguma documentação não será afectada por esta alteração. Estas excepções " +"incluem o ficheiro copyright, ficheiros changelog, README.Debian, etc. Estes " +"ficheiros serão na mesma instalados no caminho F<< /usr/share/doc/I<pacote> " +">>." #. type: textblock -#: debhelper.pod:1425 +#: debhelper-compat-upgrade-checklist.pod:520 msgid "" -"All debhelper tools will parse command line arguments listed in this " -"variable before any command option (as if they had been prepended to the " -"command line arguments). Unfortunately, some third-party provided tools may " -"not support this variable and will ignore these command line arguments." +"The B<dh_strip> and B<dh_shlibdeps> tools no longer uses filename patterns " +"to determine which files to process. Instead, they open the file and look " +"for an ELF header to determine if a given file is an shared object or an ELF " +"executable." msgstr "" -"Todas as ferramentas debhelper irão processar os argumentos de linha de " -"comandos listados nesta variável antes de qualquer opção de comando (como se " -"eles fossem anexados aos argumentos de linha de comandos). Infelizmente, " -"algumas ferramentas disponibilizadas por terceiros podem não suportar esta " -"variável e irão ignorar estes argumentos de linha de comandos." +"As ferramentas B<dh_strip> e B<dh_shlibdeps> já não usam mais padrões de " +"nomes de ficheiros para determinar quais ficheiros processar. Em vez disso, " +"elas abrem o ficheiro e procuram um cabeçalho ELF para determinar se um dado " +"ficheiro é um objecto partilhado ou um executável ELF." #. type: textblock -#: debhelper.pod:1430 -msgid "" -"When using L<dh(1)>, it can be passed options that will be passed on to each " -"debhelper command, which is generally better than using DH_OPTIONS." +#: debhelper-compat-upgrade-checklist.pod:525 +msgid "This change may cause the tools to process more files than previously." msgstr "" -"Quando se usa L<dh(1)>, podem-se passar opções que irão ser passadas a cada " -"comando do debhelper, o que é geralmente melhor do que usar DH_OPTIONS." +"Esta alteração fazer com que as ferramentas processem mais ficheiros que " +"anteriormente." #. type: =item -#: debhelper.pod:1433 -msgid "B<DH_ALWAYS_EXCLUDE>" -msgstr "B<DH_ALWAYS_EXCLUDE>" +#: debhelper-compat-upgrade-checklist.pod:529 +msgid "v10" +msgstr "v10" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:531 +msgid "Changes from v9 are:" +msgstr "As alterações a partir de v9 são:" #. type: textblock -#: debhelper.pod:1435 +#: debhelper-compat-upgrade-checklist.pod:537 msgid "" -"If set, this adds the value the variable is set to to the B<-X> options of " -"all commands that support the B<-X> option. Moreover, B<dh_builddeb> will " -"B<rm -rf> anything that matches the value in your package build tree." +"B<dh_installinit> will no longer install a file named debian/I<package> as " +"an init script." msgstr "" -"Se definido, isto adiciona o valor que está definido na variável à s opções " -"B<-X> de todos os comandos que suportam a opção B<-X>. Ainda mais, o " -"B<dh_builddeb> irá fazer B<rm -rf> a tudo o que corresponda a esse valor na " -"sua árvore de compilação do pacote." +"B<dh_installinit> não irá mais instalar um ficheiro chamado debian/I<pacote> " +"como um script de iniciação (init)." #. type: textblock -#: debhelper.pod:1439 +#: debhelper-compat-upgrade-checklist.pod:542 msgid "" -"This can be useful if you are doing a build from a CVS source tree, in which " -"case setting B<DH_ALWAYS_EXCLUDE=CVS> will prevent any CVS directories from " -"sneaking into the package you build. Or, if a package has a source tarball " -"that (unwisely) includes CVS directories, you might want to export " -"B<DH_ALWAYS_EXCLUDE=CVS> in F<debian/rules>, to make it take effect wherever " -"your package is built." +"B<dh_installdocs> will error out if it detects links created with --link-doc " +"between packages of architecture \"all\" and non-\"all\" as it breaks " +"binNMUs." msgstr "" -"Isto pode ser útil se você está a fazer uma compilação a partir de uma " -"árvore fonte CVS, que no caso definindo B<DH_ALWAYS_EXCLUDE=CVS> irá " -"prevenir que quaisquer directórios CVS se esgueirem para o pacote que está a " -"compilar. Ou, se um pacote tem um tarball de fonte que (não " -"inteligentemente) inclui directórios CVS, você pode querer exportar " -"B<DH_ALWAYS_EXCLUDE=CVS> em F<debian/rules>, para o fazer ter efeito onde o " -"seu é compilado." +"O B<dh_installdocs> irá dar erro se detectar links criados com --link-doc " +"entre pacotes de arquitectura \"all\" e não-\"all\" porque isso faz quebrar " +"binNMUs." #. type: textblock -#: debhelper.pod:1446 +#: debhelper-compat-upgrade-checklist.pod:548 msgid "" -"Multiple things to exclude can be separated with colons, as in " -"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" +"B<dh_installdeb> no longer installs a maintainer-provided debian/I<package>." +"shlibs file. This is now done by B<dh_makeshlibs> instead." msgstr "" -"Várias coisas a excluir podem ser separadas com \"dois pontos\", como em " -"B<DH_ALWAYS_EXCLUDE=CVS:.svn>" - -#. type: =item -#: debhelper.pod:1449 -msgid "B<DH_EXTRA_ADDONS>" -msgstr "B<DH_EXTRA_ADDONS>" +"O B<dh_installdeb> já não instala um ficheiro debian/I<pacote>.shlibs " +"disponibilizado pelo maintainer. Em vez disso, isto agora é feito pelo " +"B<dh_makeshlibs>." #. type: textblock -#: debhelper.pod:1451 +#: debhelper-compat-upgrade-checklist.pod:554 msgid "" -"If set, this adds the specified dh addons to be run in the appropriate " -"places in the sequence of commands. This is equivalent to specifying the " -"addon to run with the --with flag in the debian/rules file. Any --without " -"calls specifying an addon in this environment variable will not be run." +"B<dh_installwm> refuses to create a broken package if no man page can be " +"found (required to register for the x-window-manager alternative)." msgstr "" -"Se definido, isto adiciona os addons especificados do dh para serem corridos " -"nos lugares apropriados na sequência de comandos. Isto é equivalente a " -"especificar o addon a correr coma bandeira --with no ficheiro debian/rules " -"file. Qualquer chamada --without que especifique um addon nesta variável de " -"ambiente não será executada." +"O B<dh_installwm> recusa-se a criar um pacote quebrado se não encontrar " +"nenhuma página de manual (necessário para registo para a alternativa do x-" +"window-manager)." #. type: textblock -#: debhelper.pod:1456 +#: debhelper-compat-upgrade-checklist.pod:559 msgid "" -"This is intended to be used by downstreams or specific local configurations " -"that require a debhelper addon to be run during multiple builds without " -"having to patch a large number of rules file. If at all possible, this " -"should be avoided in favor of a --with flag in the rules file." +"Debhelper will default to B<--parallel> for all buildsystems that support " +"parallel building. This can be disabled by using either B<--no-parallel> or " +"passing B<--max-parallel> with a value of 1." msgstr "" -"Isto destina-se a ser usado por downstreams ou configurações locais " -"especificas que requeiram a execução dum addon do debhelper durante " -"múltiplas compilações sem terem que aplica patch a um grande número de " -"ficheiros de regras. Se de todo possÃvel, isto deve ser evitado em favor de " -"uma bandeira --with no ficheiro rules." - -#. type: =item -#: debhelper.pod:1461 -msgid "B<DH_COLORS>, B<DPKG_COLORS>" -msgstr "B<DH_COLORS>, B<DPKG_COLORS>" +"Debhelper irá predefinir para B<--parallel> em todos os sistemas de " +"compilação que suportam compilação paralela. Isto pode ser desactivado " +"usando B<--no-parallel> ou passando B<--max-parallel> com o valor de 1." #. type: textblock -#: debhelper.pod:1463 +#: debhelper-compat-upgrade-checklist.pod:565 msgid "" -"These variables can be used to control whether debhelper commands should use " -"colors in their textual output. Can be set to \"always\", \"auto\" (the " -"default), or \"never\"." +"The B<dh> command will not accept any of the deprecated \"manual sequence " +"control\" parameters (B<--before>, B<--after>, etc.). Please use override " +"targets instead." msgstr "" -"Estas variáveis podem ser usadas para controlar se os comandos do debhelper " -"devem usar cores nos resultados textuais. Podem ser definidas para \"always" -"\", \"auto\" (a predefinição), ou \"never\"." +"O comando B<dh> não irá aceitar nenhum dos parâmetros de \"controle de " +"sequência manua\" descontinuados (B<--before>, B<--after>, etc.). Por favor " +"utilize alvos de sobreposição em vez destes." #. type: textblock -#: debhelper.pod:1467 +#: debhelper-compat-upgrade-checklist.pod:569 msgid "" -"Note that B<DPKG_COLOR> also affects a number of dpkg related tools and " -"debhelper uses it on the assumption that you want the same color setting for " -"dpkg and debhelper. In the off-hand chance you want different color setting " -"for debhelper, you can use B<DH_COLORS> instead or in addition to " -"B<DPKG_COLORS>." +"B<Retroactively applied to earlier compat levels>: B<dh> no longer accepts " +"any of these since debhelper/12.4." msgstr "" -"Note que B<DPKG_COLOR> também afecta um número de ferramentas relacionadas " -"ao dpkg e o debhelper usa-o na suposição que você quer a mesma definição de " -"cor para o dpkg e debhelper. Na hipótese de você querer definição de cor " -"diferente para o debhelper, pode usar B<DH_COLORS> em vez disso ou em adição " -"a B<DPKG_COLORS>." - -#. type: =item -#: debhelper.pod:1473 -msgid "B<NO_COLOR>" -msgstr "B<NO_COLOR>" +"B<Retroactively applied to earlier compat levels>: B<dh> já não aceita " +"nenhum destes desde o debhelper/12.4." #. type: textblock -#: debhelper.pod:1475 +#: debhelper-compat-upgrade-checklist.pod:574 msgid "" -"If no explicit request for color has been given (e.g. B<DH_COLORS> and " -"B<DPKG_COLORS> are both unset), the presence of this environment variable " -"cause the default color setting to be \"never\"." +"The B<dh> command will no longer use log files to track which commands have " +"been run. The B<dh> command I<still> keeps track of whether it already ran " +"the \"build\" sequence and skip it if it did." msgstr "" -"Se não for fornecido um pedido especÃfico para cor (ex. B<DH_COLORS> e " -"B<DPKG_COLORS> estão ambos não-definidos), a presença desta variável de " -"ambiente faz com que a definição de cor predefinida seja \"never\"." +"O comando B<dh> não irá mais usar ficheiros log para seguir quais comandos " +"foram executados. O comando B<dh> I<ainda> mantêm o seguimento se já correu " +"a sequência de \"compilação\" e salta-a se já o fez." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:578 +msgid "The main effects of this are:" +msgstr "Os principais efeitos disto são:" #. type: textblock -#: debhelper.pod:1479 +#: debhelper-compat-upgrade-checklist.pod:584 msgid "" -"The variable is defined according to L<https://no-color.org/>. In this " -"project, the environment variables (such as B<DH_COLORS>) are considered an " -"explicit request for color." +"With this, it is now easier to debug the I<install> or/and I<binary> " +"sequences because they can now trivially be re-run (without having to do a " +"full \"clean and rebuild\" cycle)" msgstr "" -"A variável é definida de acordo com L<https://no-color.org/>. Neste " -"projecto, as variáveis de ambiente (tais como B<DH_COLORS>) são consideradas " -"um requisito explÃcito para cor." +"Com isto, é agora mais fácil de depurar as sequências I<install> ou/e " +"I<binary> porque agora podem ser trivialmente re-executadas (sem ter que " +"fazer um ciclo de \"limpar e recompilar\" completo." -#. type: =item -#: debhelper.pod:1483 +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:590 msgid "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +"The main caveat is that B<dh_*> now only keeps track of what happened in a " +"single override target. When all the calls to a given B<dh_cmd> command " +"happens in the same override target everything will work as before." msgstr "" -"B<CFLAGS>, B<CPPFLAGS>, B<CXXFLAGS>, B<OBJCFLAGS>, B<OBJCXXFLAGS>, " -"B<GCJFLAGS>, B<FFLAGS>, B<FCFLAGS>, B<LDFLAGS>" +"O principal embargo é que B<dh_*> agora apenas mantêm acompanhamento do que " +"aconteceu num alvo de sobreposição singular. Quanto todas as chamadas a um " +"dado comando B<dh_cmd> acontecem no mesmo alvo de sobreposição tudo irá " +"funcionar como dantes." #. type: textblock -#: debhelper.pod:1485 +#: debhelper-compat-upgrade-checklist.pod:595 +msgid "Example of where it can go wrong:" +msgstr "Exemplo de onde pode falhar:" + +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:597 +#, no-wrap msgid "" -"By default (in any non-deprecated compat level), debhelper will " -"automatically set these flags by using L<dpkg-buildflags(1)>, when they are " -"unset. If you need to change the default flags, please use the features " -"from L<dpkg-buildflags(1)> to do this (e.g. " -"B<DEB_BUILD_MAINT_OPTIONS=hardening=all> or B<DEB_CPPFLAGS_MAINT_APPEND=-" -"DCUSTOM_MACRO=true>) rather than setting the concrete variable directly." +" override_dh_foo:\n" +" dh_foo -pmy-pkg\n" +"\n" msgstr "" -"Por predefinição (em qualquer nÃvel de compatibilidade não-abandonado). o " -"debhelper irá automaticamente definir estas flags ao usar L<dpkg-" -"buildflags(1)>, quando não estiverem definidas. Se você precisar de " -"modificar as flags predefinidas, por favor use as funcionalidades de L<dpkg-" -"buildflags(1)> para o fazer (ex. B<DEB_BUILD_MAINT_OPTIONS=hardening=all> ou " -"B<DEB_CPPFLAGS_MAINT_APPEND=-DCUSTOM_MACRO=true>) em vez de definir a " -"variável concreta directamente." +" override_dh_foo:\n" +" dh_foo -pmy-pkg\n" +"\n" -#. type: =item -#: debhelper.pod:1492 -msgid "B<HOME>, B<XDG_*>" -msgstr "B<HOME>, B<XDG_*>" +#. type: verbatim +#: debhelper-compat-upgrade-checklist.pod:600 +#, no-wrap +msgid "" +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" +msgstr "" +" override_dh_bar:\n" +" dh_bar\n" +" dh_foo --remaining\n" +"\n" #. type: textblock -#: debhelper.pod:1494 +#: debhelper-compat-upgrade-checklist.pod:604 msgid "" -"In compat 13 and later, these environment variables are reset before " -"invoking the upstream build system via the B<dh_auto_*> helpers. The " -"variables B<HOME> (all B<dh_auto_*> helpers) and B<XDG_RUNTIME_DIR> " -"(B<dh_auto_test> only) will be set to a writable directory. All remaining " -"variables and B<XDG_RUNTIME_DIR> (except for during B<dh_auto_test>) will be " -"cleared." +"In this case, the call to B<dh_foo --remaining> will I<also> include I<my-" +"pkg>, since B<dh_foo -pmy-pkg> was run in a separate override target. This " +"issue is not limited to B<--remaining>, but also includes B<-a>, B<-i>, etc." msgstr "" -"Em compatibilidade 13 e posterior, estas variáveis de ambiente são " -"reiniciadas antes de invocar o sistema de compilação do autor via ajudantes " -"do B<dh_auto_*>. As variáveis B<HOME> (todos os ajudantes B<dh_auto_*>) e " -"B<XDG_RUNTIME_DIR> (apenas B<dh_auto_test>) irão ser definidas para um " -"directório gravável. Todas as restantes variáveis e B<XDG_RUNTIME_DIR> " -"(excepto para durante B<dh_auto_test>) irão ser limpas." +"Neste caso, a chamada a B<dh_foo --remaining> irá I<também> incluir I<my-" +"pkg>, desde que B<dh_foo -pmy-pkg> tenha corrido num alvo de sobreposição " +"separado. Este problema não está imitado a B<--remaining>, mas também inclui " +"B<-a>, B<-i>, etc." #. type: textblock -#: debhelper.pod:1500 +#: debhelper-compat-upgrade-checklist.pod:613 msgid "" -"The B<HOME> directory will be created as an empty directory but it will be " -"reused between calls to B<dh_auto_*>. Any content will persist until " -"explicitly deleted or B<dh_clean>." +"The B<dh_installdeb> command now shell-escapes the lines in the " +"F<maintscript> config file. This was the original intent but it did not " +"work properly and packages have begun to rely on the incomplete shell " +"escaping (e.g. quoting file names)." msgstr "" -"O directório B<HOME> será criado como um directório vazio mas ele será " -"reutilizado entre chamadas a B<dh_auto_*>. Qualquer conteúdo irá persistir " -"até ser explicitamente apagado ou B<dh_clean>." - -#. type: =item -#: debhelper.pod:1504 -msgid "B<DEB_BUILD_OPTIONS>" -msgstr "B<DEB_BUILD_OPTIONS>" +"O comando B<dh_installdeb> agora faz \"escape de shell\" à s linhas no " +"ficheiro de configuração de F<maintscript>. Esta foi a intenção original mas " +"não trabalhava correctamente e os pacotes começaram a confiar no \"escapar " +"de shell\" incompleto (ex. ao mencionar nomes de ficheiros)." #. type: textblock -#: debhelper.pod:1506 +#: debhelper-compat-upgrade-checklist.pod:620 msgid "" -"Please see L</Supported flags in DEB_BUILD_OPTIONS> for this environment " -"variable." +"The B<dh_installinit> command now defaults to B<--restart-after-upgrade>. " +"For packages needing the previous behaviour, please use B<--no-restart-after-" +"upgrade>." msgstr "" -"Por favor veja L</Bandeiras suportadas em DEB_BUILD_OPTIONS> para esta " -"variável de ambiente." +"O comando B<dh_installinit> agora usa por predefinição B<--restart-after-" +"upgrade>. Para pacotes que precisam do comportamento anterior, por favor use " +"B<--no-restart-after-upgrade>." #. type: textblock -#: debhelper.pod:1509 +#: debhelper-compat-upgrade-checklist.pod:626 msgid "" -"Please note that this variable should I<not> be altered by package " -"maintainers inside F<debian/rules> to change the behaviour of debhelper. " -"Instead, where the package maintainer need these features, they should look " -"disabling the relevant feature directly (e.g. by overriding the concrete " -"tools)." +"The B<autoreconf> sequence is now enabled by default. Please pass B<--" +"without autoreconf> to B<dh> if this is not desirable for a given package" msgstr "" -"Por favor note que esta variável I<não> deve ser alterada por maintainers de " -"pacote dentro de F<debian/rules> para mudar o comportamento do debhelper. Em " -"vez disso, onde o maintainer do pacote precisar destas funcionalidades, eles " -"devem procurar desactivar a funcionalidade relevante directamente (ex. ao " -"sobrepor as ferramentas concretas)." - -#. type: =item -#: debhelper.pod:1514 -msgid "B<DEB_MAINT_BUILD_OPTIONS>" -msgstr "B<DEB_MAINT_BUILD_OPTIONS>" +"A sequência B<autoreconf> é agora activada por predefinição. Por favor passe " +"B<--without autoreconf> ao B<dh> se isto não for desejável para um " +"determinado pacote" #. type: textblock -#: debhelper.pod:1516 +#: debhelper-compat-upgrade-checklist.pod:632 msgid "" -"This is a dpkg specific environment variable (see e.g. L<dpkg-" -"buildflags(1)>). The debhelper tool suite silently ignores it." +"The B<systemd> sequence is now enabled by default. Please pass B<--without " +"systemd> to B<dh> if this is not desirable for a given package." msgstr "" -"Esta é uma variável de ambiente especifica do dpkg (veja por ex. L<dpkg-" -"buildflags(1)>). A suite de ferramentas do debhelper ignora-a em silêncio." +"A sequência B<systemd> é agora activada por predefinição. Por favor passe " +"B<--without systemd> ao B<dh> se isto não for desejável para um determinado " +"pacote." #. type: textblock -#: debhelper.pod:1519 +#: debhelper-compat-upgrade-checklist.pod:638 msgid "" -"It is documented here because it has a similar name to B<DEB_BUILD_OPTIONS>, " -"which make some people mistakenly assume that debhelper will also react to " -"this variable." +"B<Retroactively removed>: B<dh> no longer creates the package build " +"directory when skipping running debhelper commands. This will not affect " +"packages that only build with debhelper commands, but it may expose bugs in " +"commands not included in debhelper." msgstr "" -"Está documentada aqui porque tem um nome semelhante a B<DEB_BUILD_OPTIONS>, " -"o que faz com que algumas pessoas assumam em erro que o debhelper também vai " -"reagir a esta variável." - -#. type: =head2 -#: debhelper.pod:1525 -msgid "Supported flags in DEB_BUILD_OPTIONS" -msgstr "Bandeiras suportadas em DEB_BUILD_OPTIONS" +"B<Retroactively removed> B<dh> já não cria o directório de compilação do " +"pacote quando salta a execução de comandos debhelper. Isto não vai afectar " +"pacotes que apenas compilam com comandos debhelper, mas pode expor bugs em " +"comandos não incluÃdos no debhelper." #. type: textblock -#: debhelper.pod:1527 +#: debhelper-compat-upgrade-checklist.pod:643 msgid "" -"The debhelper tool suite reacts to the following flags in " -"B<DEB_BUILD_OPTIONS>." +"This compatibility feature had a bug since its inception in " +"debhelper/9.20130516 that made it fail to apply in compat 9 and earlier. As " +"there has been no reports of issues caused by this bug in those ~5 years, " +"this item have been removed rather than fixed." msgstr "" -"A suite de ferramentas debhelper reage à s seguintes bandeiras em " -"B<DEB_BUILD_OPTIONS>." +"Esta funcionalidade de compatibilidade tinha um bug desde a sua inserção no " +"debhelper/9.20130516 que o fazia falhar ao aplicar em compatibilidade 9 e " +"anteriores. Como não tem havido relatórios de problemas causados por este " +"bug nesses -5 anos, este item foi removido em vez de corrigido." #. type: =item -#: debhelper.pod:1531 -msgid "B<dherroron=obsolete-compat-levels>" -msgstr "B<dherroron=obsolete-compat-levels>" +#: debhelper-compat-upgrade-checklist.pod:650 +msgid "v9" +msgstr "v9" #. type: textblock -#: debhelper.pod:1533 -msgid "I<This is a debhelper specific value.>" -msgstr "I<Este é um valor especÃfico do debhelper.>" +#: debhelper-compat-upgrade-checklist.pod:652 +msgid "Changes from v8 are:" +msgstr "As alterações a partir de v8 são:" #. type: textblock -#: debhelper.pod:1535 +#: debhelper-compat-upgrade-checklist.pod:658 msgid "" -"When B<dherroron> is present and set to B<obsolete-compat-levels>, then " -"debhelper tools will promote deprecation warnings for usage of old soon to " -"be removed compat levels into errors." +"Multiarch support. In particular, B<dh_auto_configure> passes multiarch " +"directories to autoconf in --libdir and --libexecdir." msgstr "" -"Quando B<dherroron> está presente e definida para B<obsolete-compat-levels>, " -"então as ferramentas debhelper irão promover para erros os avisos de " -"descontinuidade de nÃveis de compatibilidade antigos e prestes a serem " -"removidos." +"Suporte a multi-arquitectura. Em particular, B<dh_auto_configure> passa " +"directórios de multi-arquitectura ao autoconf em --libdir e --libexecdir." #. type: textblock -#: debhelper.pod:1539 +#: debhelper-compat-upgrade-checklist.pod:663 msgid "" -"This is useful for automated checking for code relying on deprecated compat " -"levels that is scheduled for removal." +"dh is aware of the usual dependencies between targets in debian/rules. So, " +"\"dh binary\" will run any build, build-arch, build-indep, install, etc " +"targets that exist in the rules file. There's no need to define an explicit " +"binary target with explicit dependencies on the other targets." msgstr "" -"Isto é útil para verificação automática de confiança de código em nÃveis de " -"compatibilidade descontinuados que estão agendados para remoção." +"O dh tem conhecimento das dependências habituais entre alvos em debian/" +"rules. Por isso, o \"dh binary\" irá correr quaisquer alvos de build, build-" +"arch, build-indep, install, etc que existam no ficheiro de regras. Não há " +"necessidade de definir um alvo binário explÃcito com dependências explÃcitas " +"em outros alvos." #. type: textblock -#: debhelper.pod:1542 -msgid "This option is intended for testing purposes; not production builds." +#: debhelper-compat-upgrade-checklist.pod:670 +msgid "" +"B<dh_strip> compresses debugging symbol files to reduce the installed size " +"of -dbg packages." msgstr "" -"Esta opção destina-se a objectivos de teste; não compilações produtivas." - -#. type: =item -#: debhelper.pod:1544 -msgid "B<nostrip>" -msgstr "B<nostrip>" +"B<dh_strip> comprime ficheiros de sÃmbolos de depuração para reduzir o " +"tamanho instalado dos pacotes -dbg." #. type: textblock -#: debhelper.pod:1546 debhelper.pod:1569 +#: debhelper-compat-upgrade-checklist.pod:675 msgid "" -"I<This value will change the content of the debs being built. The .deb " -"packages built when this is set is therefore not bit-for-bit reproducible " -"with a regular build in the general case.>" +"B<dh_auto_configure> does not include the source package name in --" +"libexecdir when using autoconf." msgstr "" -"I<Este valor irá mudar o conteúdo dos debs a serem compilados. Os pacotes ." -"deb compilados quando isto está definido são por isto não reproduzÃveis bit-" -"a-bit com uma compilação regular nas generalidade dos casos.>" +"B<dh_auto_configure> não inclui o nome do pacote fonte em --libexecdir " +"quando usa autoconf." + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:680 +msgid "B<dh> does not default to enabling --with=python-support" +msgstr "B<dh> não tem por predefinição a activação de --with=python-support" #. type: textblock -#: debhelper.pod:1550 +#: debhelper-compat-upgrade-checklist.pod:682 msgid "" -"This value will cause the official debhelper tools will skip actions and " -"helpers that either remove, detach or deduplicate debugging symbols in ELF " -"binaries." +"(Obsolete: As the B<dh_pysupport> tool was removed from Debian stretch. " +"Since debhelper/10.3, B<dh> no longer enables this sequence add-on " +"regardless of compat level)" msgstr "" -"Este valor irá fazer com que as ferramentas oficiais debhelper saltem acções " -"e ajudantes que ou removem, desanexam ou duplicam sÃmbolos em binários ELF." +"(Obsoleto: Pois a ferramenta B<dh_pysupport> foi removida a partir de Debian " +"stretch. Desde o debhelper/10.3, B<dh> já não se activa esta sequência add-" +"on independentemente do nÃvel de compatibilidade)" + +#. type: textblock +#: debhelper-compat-upgrade-checklist.pod:688 +msgid "" +"All of the B<dh_auto_>I<*> debhelper programs and B<dh> set environment " +"variables listed by B<dpkg-buildflags>, unless they are already set." +msgstr "" +"Todos os programas debhelper B<dh_auto_>I<*> e B<dh> definem variáveis de " +"ambiente listadas por B<dpkg-buildflags>, a menos que elas estejam já " +"definidas." #. type: textblock -#: debhelper.pod:1554 -msgid "This value affects L<dh_dwz(1)> and L<dh_strip(1)>." -msgstr "Este valor afecta L<dh_dwz(1)> e L<dh_strip(1)>." - -#. type: =item -#: debhelper.pod:1556 -msgid "B<nocheck>" -msgstr "B<nocheck>" +#: debhelper-compat-upgrade-checklist.pod:694 +msgid "" +"B<dh_auto_configure> passes B<dpkg-buildflags> CFLAGS, CPPFLAGS, and LDFLAGS " +"to perl F<Makefile.PL> and F<Build.PL>" +msgstr "" +"B<dh_auto_configure> passa as B<dpkg-buildflags> CFLAGS, CPPFLAGS, e LDFLAGS " +"para F<Makefile.PL> e F<Build.PL> de perl." #. type: textblock -#: debhelper.pod:1558 +#: debhelper-compat-upgrade-checklist.pod:699 msgid "" -"This value will cause the official debhelper build systems to skip runs of " -"upstream test suites." +"B<dh_strip> puts separated debug symbols in a location based on their build-" +"id." msgstr "" -"Este valor irá fazer com que os sistemas de compilação oficiais debhelper " -"saltem execuções de suites de testes do autor original." +"B<dh_strip> põe sÃmbolos de depuração separados numa localização baseada no " +"seu build-id." #. type: textblock -#: debhelper.pod:1561 +#: debhelper-compat-upgrade-checklist.pod:704 msgid "" -"Package maintainers looking to avoid running the upstream tests should " -"B<not> rely on this. Instead, they can add an empty override target to skip " -"B<dh_auto_test>." +"Executable debhelper config files are run and their output used as the " +"configuration." msgstr "" -"Os maintainers de pacotes que procurem evitar correr os testes do autor " -"B<não> devem confiar nisto. Em vez disto, eles podem adicionar um alvo de " -"sobreposição vazio para saltar o B<dh_auto_test>." +"Os ficheiros de configuração executáveis do debhelper são corridos e os seus " +"resultados usados como configuração." #. type: textblock -#: debhelper.pod:1565 -msgid "This value affects L<dh_auto_test(1)>." -msgstr "Este valor afecta L<dh_auto_test(1)>." +#: debhelper-compat-upgrade-checklist.pod:709 +#: debhelper-compat-upgrade-checklist.pod:740 +#: debhelper-compat-upgrade-checklist.pod:744 debhelper-obsolete-compat.pod:81 +#: debhelper-obsolete-compat.pod:135 debhelper-obsolete-compat.pod:158 +#: debhelper-obsolete-compat.pod:165 debhelper-obsolete-compat.pod:174 +msgid "This mode is deprecated." +msgstr "Este modo está descontinuado." #. type: =item -#: debhelper.pod:1567 -msgid "B<nodoc>" -msgstr "B<nodoc>" +#: debhelper-compat-upgrade-checklist.pod:711 +msgid "v8" +msgstr "v8" #. type: textblock -#: debhelper.pod:1573 -msgid "" -"This value will cause several debhelper tools to skip installation of " -"documentation such as manpages or upstream provided documentation. " -"Additionally, the tools will also ignore if declared documentation is " -"\"missing\" on the assumption that the documentation has not been built." -msgstr "" -"Este valor irá fazer com que várias ferramentas debhelper saltem a " -"instalação de documentação tal como os manuais ou documentação fornecida " -"pelo autor original. Adicionalmente, as ferramentas irão também ignorar se a " -"documentação declarada está \"em falta\" assumindo que a documentação não " -"foi compilada." +#: debhelper-compat-upgrade-checklist.pod:713 +msgid "Changes from v7 are:" +msgstr "As alterações a partir de v7 são:" #. type: textblock -#: debhelper.pod:1578 +#: debhelper-compat-upgrade-checklist.pod:719 msgid "" -"This value effects tools I<like> L<dh_installdocs(1)>, which I<knows> it is " -"working with documentation." +"Commands will fail rather than warning when they are passed unknown options." msgstr "" -"Este valor afecta ferramentas do I<tipo> L<dh_installdocs(1)>, que I<sabem> " -"que estão a trabalhar com documentação." - -#. type: =item -#: debhelper.pod:1581 -msgid "B<noautodbgsym>, B<noddebs>" -msgstr "B<noautodbgsym>, B<noddebs>" +"Os comandos irão falhar em vez de emitirem avisos quando lhes são passadas " +"opções desconhecidas." #. type: textblock -#: debhelper.pod:1583 +#: debhelper-compat-upgrade-checklist.pod:723 msgid "" -"I<The official name is autodbgsym. The noddebs variant is accepted for " -"historical reasons.>" +"B<dh_makeshlibs> will run B<dpkg-gensymbols> on all shared libraries that it " +"generates shlibs files for. So B<-X> can be used to exclude libraries. " +"Also, libraries in unusual locations that B<dpkg-gensymbols> would not have " +"processed before will be passed to it, a behavior change that can cause some " +"packages to fail to build." msgstr "" -"I<O nome oficial é autodbgsym. A variante noddebs é aceite por razões " -"históricas.>" +"B<dh_makeshlibs> irá correr B<dpkg-gensymbols> em todas as bibliotecas " +"partilhadas para as quais gera ficheiros shlibs. Portanto o B<-X> pode ser " +"usado para excluir bibliotecas. Também, as bibliotecas em localizações fora " +"do habitual que o B<dpkg-gensymbols> não tenha processado antes serão " +"passadas para ele, uma alteração no comportamento que pode causar que alguns " +"pacotes falhem a compilar." #. type: textblock -#: debhelper.pod:1586 +#: debhelper-compat-upgrade-checklist.pod:731 msgid "" -"This value causes debhelper to skip the generation of automatically " -"generated debug symbol packages." +"B<dh> requires the sequence to run be specified as the first parameter, and " +"any switches come after it. Ie, use \"B<dh $@ --foo>\", not \"B<dh --foo " +"$@>\"." msgstr "" -"Este valor faz com que o debhelper salte a geração de pacotes de sÃmbolos de " -"depuração gerados automaticamente." +"B<dh> requer que a sequência a correr seja especificada como o primeiro " +"parâmetro, e quaisquer switches que venham depois dela. Isto é, use B<dh $@ " +"--foo>\", e não \"B<dh --foo $@>" #. type: textblock -#: debhelper.pod:1589 -msgid "This value affects L<dh_strip(1)>." -msgstr "Este valor afecta L<dh_strip(1)>." +#: debhelper-compat-upgrade-checklist.pod:736 +msgid "" +"B<dh_auto_>I<*> prefer to use Perl's B<Module::Build> in preference to " +"F<Makefile.PL>." +msgstr "" +"B<dh_auto_>I<*> prefere usar o B<Module::Build> do Perl em preferência de " +"F<Makefile.PL>." #. type: =item -#: debhelper.pod:1591 -msgid "B<parallel=N>" -msgstr "B<parallel=N>" +#: debhelper-compat-upgrade-checklist.pod:742 debhelper-obsolete-compat.pod:21 +msgid "v7" +msgstr "v7" #. type: textblock -#: debhelper.pod:1593 -msgid "" -"This value enables debhelper to use up to B<N> threads or processes (subject " -"to parameters like B<--no-parallel> and B<--max-parallel=M>). Not all " -"debhelper tools work with parallel tasks and may silently ignore the request." -msgstr "" -"Este valor habilita o debhelper a usar até B<N> linhas de processos " -"(sujeitos a parâmetros como B<--no-parallel> e B<--max-parallel=M>). Nem " -"todas as ferramentas debhelper trabalham com tarefas paralelas e podem " -"ignorar o pedido em silêncio." +#: debhelper-compat-upgrade-checklist.pod:746 debhelper-obsolete-compat.pod:23 +msgid "This is the lowest supported compatibility level." +msgstr "Este é o nÃvel de compatibilidade mais baixo suportado." #. type: textblock -#: debhelper.pod:1598 +#: debhelper-compat-upgrade-checklist.pod:748 msgid "" -"This value affects many debhelper tools. Most notably B<dh_auto_*>, which " -"will attempt to run the underlying upstream build system with that number of " -"threads." +"If you are upgrading from an earlier compatibility level, please review " +"L<debhelper-obsolete-compat(7)>." msgstr "" -"Este valor afecta muitas ferramentas debhelper. Mais notoriamente " -"B<dh_auto_*>, a qual irá tentar correr o sistema de compilação subjacente do " -"autor com esse número de linhas de execução." +"Se você está a actualizar a partir de um nÃvel de compatibilidade anterior, " +"por favor reveja L<debhelper-obsolete-compat(7)>." #. type: =item -#: debhelper.pod:1602 -msgid "B<terse>" -msgstr "B<terse>" +#: debhelper-compat-upgrade-checklist.pod:757 +msgid "L<debhelper-obsolete-compat(7)>" +msgstr "L<debhelper-obsolete-compat(7)>" #. type: textblock -#: debhelper.pod:1604 +#: debhelper-compat-upgrade-checklist.pod:759 msgid "" -"This value will cause the official debhelper build systems to configure " -"upstream builds to be terse (i.e. reduce verbosity in their output). This " -"is subject to the upstream and the debhelper build system supporting such " -"features." +"Upgrading from a (now) obsolete compatibility level? This document covers " +"the upgrade checklist up to the earliest supported level." msgstr "" -"Este valor irá fazer com que os sistemas de compilação oficiais debhelper " -"configurem as compilações do autor para serem concisas (isto é, reduzir os " -"detalhes dos seus resultados). Isto está sujeito a que os sistemas de " -"compilação do autor e do debhelper suportem tais funcionalidades." - -#. type: textblock -#: debhelper.pod:1609 -msgid "This value affects most B<dh_auto_*> tools." -msgstr "Este valor afecta a maioria das ferramentas B<dh_auto_*>." +"A actualizar a partir de um nÃvel de compatibilidade (agora) obsoleto? Este " +"documento a lista de verificação de actualização até ao nÃvel suportado mais " +"recente." #. type: textblock -#: debhelper.pod:1613 -msgid "Unknown flags are silently ignored." -msgstr "Bandeiras desconhecidas são ignoradas em silêncio." +#: debhelper-compat-upgrade-checklist.pod:762 debhelper-obsolete-compat.pod:180 +#: dh:874 dh_auto_build:55 dh_auto_clean:57 dh_auto_configure:60 +#: dh_auto_install:105 dh_auto_test:66 dh_builddeb:178 dh_clean:191 +#: dh_compress:245 dh_dwz:165 dh_fixperms:166 dh_gencontrol:210 dh_install:379 +#: dh_installcatalogs:130 dh_installchangelogs:367 dh_installcron:82 +#: dh_installdeb:421 dh_installdebconf:235 dh_installdirs:133 +#: dh_installdocs:439 dh_installexamples:184 dh_installifupdown:74 +#: dh_installinfo:125 dh_installlogcheck:83 dh_installlogrotate:55 +#: dh_installman:422 dh_installmanpages:200 dh_installmime:65 +#: dh_installmodules:111 dh_installpam:73 dh_installppp:70 dh_installudev:104 +#: dh_installwm:132 dh_installxfonts:92 dh_link:168 dh_listpackages:36 +#: dh_makeshlibs:458 dh_md5sums:120 dh_movefiles:163 dh_perl:190 dh_prep:72 +#: dh_strip:437 dh_testdir:64 dh_testroot:95 dh_usrlocal:138 +#: dh_systemd_start:282 +msgid "L<debhelper(7)>" +msgstr "L<debhelper(7)>" #. type: textblock -#: debhelper.pod:1615 +#: debhelper-compat-upgrade-checklist.pod:764 msgid "" -"Note third-party debhelper-like tools or third-party provided build systems " -"may or may not react to the above flags. This tends to depend on " -"implementation details of the tool." +"General information about the debhelper framework. This document also covers " +"how to declare your chosen debhelper compat level." msgstr "" -"Note que ferramentas de terceiros estilo-debhelper ou sistemas de compilação " -"fornecidos por terceiros podem não reagir à s bandeiras em cima. Isto tende a " -"depender dos detalhes de implementação da ferramenta." +"Informação geral acerca da estrutura do debhelper. Este documento também " +"cobre como declarar o seu nÃvel de compatibilidade debhelper escolhido." #. type: =head1 -#: debhelper.pod:1619 debhelper-obsolete-compat.pod:118 dh:733 dh_auto_build:53 -#: dh_auto_clean:55 dh_auto_configure:58 dh_auto_install:97 dh_auto_test:64 -#: dh_bugfiles:133 dh_builddeb:182 dh_clean:189 dh_compress:242 dh_dwz:161 -#: dh_fixperms:164 dh_gconf:105 dh_gencontrol:208 dh_icons:75 dh_install:377 -#: dh_installcatalogs:128 dh_installchangelogs:300 dh_installcron:78 -#: dh_installdeb:412 dh_installdebconf:128 dh_installdirs:131 -#: dh_installdocs:454 dh_installemacsen:138 dh_installexamples:178 -#: dh_installifupdown:72 dh_installinfo:123 dh_installinit:430 -#: dh_installinitramfs:91 dh_installlogcheck:81 dh_installlogrotate:53 -#: dh_installman:417 dh_installmanpages:198 dh_installmenu:88 dh_installmime:63 -#: dh_installmodules:109 dh_installpam:62 dh_installppp:68 dh_installudev:102 -#: dh_installwm:132 dh_installxfonts:90 dh_link:166 dh_lintian:60 -#: dh_listpackages:34 dh_makeshlibs:456 dh_md5sums:118 dh_movefiles:161 -#: dh_perl:174 dh_prep:70 dh_shlibdeps:204 dh_strip:435 dh_testdir:62 -#: dh_testroot:93 dh_usrlocal:136 dh_systemd_enable:281 dh_systemd_start:280 -msgid "SEE ALSO" -msgstr "VEJA TAMBÉM" - -#. type: =item -#: debhelper.pod:1623 -msgid "F</usr/share/doc/debhelper/examples/>" -msgstr "F</usr/share/doc/debhelper/examples/>" - -#. type: textblock -#: debhelper.pod:1625 -msgid "A set of example F<debian/rules> files that use debhelper." -msgstr "Um conjunto de ficheiros F<debian/rules> exemplo que usam debhelper." - -#. type: =item -#: debhelper.pod:1627 -msgid "L<http://joeyh.name/code/debhelper/>" -msgstr "L<http://joeyh.name/code/debhelper/>" +#: debhelper-compat-upgrade-checklist.pod:769 debhelper-obsolete-compat.pod:182 +#: dh_installinit:419 dh_systemd_enable:284 dh_systemd_start:284 +msgid "AUTHORS" +msgstr "AUTORES" #. type: textblock -#: debhelper.pod:1629 -msgid "Debhelper web site." -msgstr "SÃtio web do debhelper." - -#. type: =head1 -#: debhelper.pod:1633 dh:739 dh_auto_build:59 dh_auto_clean:61 -#: dh_auto_configure:64 dh_auto_install:103 dh_auto_test:70 dh_bugfiles:141 -#: dh_builddeb:188 dh_clean:195 dh_compress:248 dh_dwz:167 dh_fixperms:170 -#: dh_gconf:111 dh_gencontrol:214 dh_icons:81 dh_install:383 -#: dh_installcatalogs:134 dh_installchangelogs:306 dh_installcron:84 -#: dh_installdeb:418 dh_installdebconf:134 dh_installdirs:137 -#: dh_installdocs:460 dh_installemacsen:145 dh_installexamples:184 -#: dh_installifupdown:78 dh_installinfo:129 dh_installinitramfs:99 -#: dh_installlogcheck:87 dh_installlogrotate:59 dh_installman:423 -#: dh_installmanpages:204 dh_installmenu:96 dh_installmime:69 -#: dh_installmodules:115 dh_installpam:68 dh_installppp:74 dh_installudev:108 -#: dh_installwm:138 dh_installxfonts:96 dh_link:172 dh_lintian:68 -#: dh_listpackages:40 dh_makeshlibs:462 dh_md5sums:124 dh_movefiles:167 -#: dh_perl:180 dh_prep:76 dh_shlibdeps:210 dh_strip:441 dh_testdir:68 -#: dh_testroot:99 dh_usrlocal:142 -msgid "AUTHOR" -msgstr "AUTOR" +#: debhelper-compat-upgrade-checklist.pod:771 debhelper-obsolete-compat.pod:184 +#: dh_dwz:171 dh_installinitramfs:101 +msgid "Niels Thykier <niels@thykier.net>" +msgstr "Niels Thykier <niels@thykier.net>" #. type: textblock -#: debhelper.pod:1635 dh:741 dh_auto_build:61 dh_auto_clean:63 -#: dh_auto_configure:66 dh_auto_install:105 dh_auto_test:72 dh_builddeb:190 -#: dh_clean:197 dh_compress:250 dh_fixperms:172 dh_gencontrol:216 -#: dh_install:385 dh_installchangelogs:308 dh_installcron:86 dh_installdeb:420 -#: dh_installdebconf:136 dh_installdirs:139 dh_installdocs:462 -#: dh_installemacsen:147 dh_installexamples:186 dh_installifupdown:80 -#: dh_installinfo:131 dh_installinit:438 dh_installlogrotate:61 -#: dh_installman:425 dh_installmanpages:206 dh_installmenu:98 dh_installmime:71 -#: dh_installmodules:117 dh_installpam:70 dh_installppp:76 dh_installudev:110 -#: dh_installwm:140 dh_installxfonts:98 dh_link:174 dh_listpackages:42 -#: dh_makeshlibs:464 dh_md5sums:126 dh_movefiles:169 dh_prep:78 -#: dh_shlibdeps:212 dh_strip:443 dh_testdir:70 dh_testroot:101 -msgid "Joey Hess <joeyh@debian.org>" -msgstr "Joey Hess <joeyh@debian.org>" +#: debhelper-compat-upgrade-checklist.pod:773 debhelper-obsolete-compat.pod:186 +msgid "Joey Hess" +msgstr "Joey Hess" #. type: textblock #: debhelper-obsolete-compat.pod:3 @@ -3806,89 +4091,144 @@ msgstr "" "O seguinte é a lista dos nÃveis de compatibilidade agora obsoletos e as suas " "alterações." -#. type: =item -#: debhelper-obsolete-compat.pod:21 -msgid "v1" -msgstr "v1" +#. type: textblock +#: debhelper-obsolete-compat.pod:25 +msgid "Changes from v6 are:" +msgstr "As alterações a partir de v6 são:" #. type: textblock -#: debhelper-obsolete-compat.pod:23 +#: debhelper-obsolete-compat.pod:31 msgid "" -"This is the original debhelper compatibility level, and so it is the default " -"one. In this mode, debhelper will use F<debian/tmp> as the package tree " -"directory for the first binary package listed in the control file, while " -"using debian/I<package> for all other packages listed in the F<control> file." +"B<dh_install>, will fall back to looking for files in F<debian/tmp> if it " +"doesn't find them in the current directory (or wherever you tell it look " +"using B<--sourcedir>). This allows B<dh_install> to interoperate with " +"B<dh_auto_install>, which installs to F<debian/tmp>, without needing any " +"special parameters." msgstr "" -"Este é o nÃvel de compatibilidade original do debhelper, e por isso é o " -"predefinido. Neste modo, o debhelper irá usar F<debian/tmp> como o " -"directório da árvore do pacote para o primeiro pacote binário listado no " -"ficheiro de controle, enquanto usa debian/I<pacote> para todos os outros " -"pacotes listados no ficheiro F<control>." +"B<dh_install>, irá regressar a procurar por ficheiros em F<debian/tmp> se " +"não os encontrar no directório actual (ou onde você lhe disser para procurar " +"usando B<--sourcedir>). Isto permite ao B<dh_install> inter-operar com o " +"B<dh_auto_install>, o qual instala para F<debian/tmp>, sem precisar de " +"nenhuns parâmetros especiais." + +#. type: textblock +#: debhelper-obsolete-compat.pod:38 +msgid "B<dh_clean> will read F<debian/clean> and delete files listed there." +msgstr "B<dh_clean> irá ler F<debian/clean> e apagar os ficheiros listados lá." + +#. type: textblock +#: debhelper-obsolete-compat.pod:42 +msgid "B<dh_clean> will delete toplevel F<*-stamp> files." +msgstr "B<dh_clean> irá apagar ficheiros F<*-stamp> do nÃvel de topo." + +#. type: textblock +#: debhelper-obsolete-compat.pod:46 +msgid "" +"B<dh_installchangelogs> will guess at what file is the upstream changelog if " +"none is specified." +msgstr "" +"B<dh_installchangelogs> irá adivinhar qual ficheiro está no relatório de " +"alterações da origem se nenhum for especificado." #. type: =item -#: debhelper-obsolete-compat.pod:30 -msgid "v2" -msgstr "v2" +#: debhelper-obsolete-compat.pod:51 +msgid "v6" +msgstr "v6" + +#. type: textblock +#: debhelper-obsolete-compat.pod:53 +msgid "Changes from v5 are:" +msgstr "As alterações a partir de v5 são:" #. type: textblock -#: debhelper-obsolete-compat.pod:32 +#: debhelper-obsolete-compat.pod:59 msgid "" -"In this mode, debhelper will consistently use debian/I<package> as the " -"package tree directory for every package that is built." +"Commands that generate maintainer script fragments will order the fragments " +"in reverse order for the F<prerm> and F<postrm> scripts." msgstr "" -"Neste modo, o debhelper irá consistentemente usar debian/I<pacote> como o " -"directório da árvore do pacote para cada pacote que é compilado." +"Os comandos que geram fragmentos de script de maintainer irão ordenar os " +"fragmentos em ordem reversa para os scripts F<prerm> e F<postrm>." + +#. type: textblock +#: debhelper-obsolete-compat.pod:64 +msgid "" +"B<dh_installwm> will install a slave manpage link for F<x-window-manager.1." +"gz>, if it sees the man page in F<usr/share/man/man1> in the package build " +"directory." +msgstr "" +"B<dh_installwm> irá instalar uma ligação escrava de manual para F<x-window-" +"manager.1.gz>, se vir o manual em F<usr/share/man/man1> no directório de " +"compilação do pacote." + +#. type: textblock +#: debhelper-obsolete-compat.pod:70 +msgid "" +"B<dh_builddeb> did not previously delete everything matching " +"B<DH_ALWAYS_EXCLUDE>, if it was set to a list of things to exclude, such as " +"B<CVS:.svn:.git>. Now it does." +msgstr "" +"O B<dh_builddeb> anteriormente não apagava nada que correspondesse a " +"B<DH_ALWAYS_EXCLUDE>, se estivesse definida uma lista de coisas a excluir, " +"como B<CVS:.svn:.git>. Mas agora fá-lo." + +#. type: textblock +#: debhelper-obsolete-compat.pod:76 +msgid "" +"B<dh_installman> allows overwriting existing man pages in the package build " +"directory. In previous compatibility levels it silently refuses to do this." +msgstr "" +"B<dh_installman> permite a sobreposição de manuais existentes no directório " +"de compilação do pacote. Nos nÃveis de compatibilidade anteriores recusava-" +"se em silêncio a fazer isto." #. type: =item -#: debhelper-obsolete-compat.pod:37 -msgid "v3" -msgstr "v3" +#: debhelper-obsolete-compat.pod:83 +msgid "v5" +msgstr "v5" #. type: textblock -#: debhelper-obsolete-compat.pod:39 -msgid "This mode works like v2, with the following additions:" -msgstr "Este modo funciona como v2, com as seguintes adições:" +#: debhelper-obsolete-compat.pod:85 +msgid "Changes from v4 are:" +msgstr "As alterações a partir de v4 são:" #. type: textblock -#: debhelper-obsolete-compat.pod:45 -msgid "" -"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " -"To turn this off and use those characters raw, just prefix with a backslash." -msgstr "" -"Os ficheiros de configuração do debhelper suportam englobamentos via B<*> e " -"B<?>, onde apropriado. Para desligar isto e usar esses caracteres a cru, " -"basta antecedê-los com uma barra invertida (backslash \"\")." +#: debhelper-obsolete-compat.pod:91 +msgid "Comments are ignored in debhelper config files." +msgstr "Comentários são ignorados nos ficheiros de configuração do debhelper." +# http://de.wikipedia.org/wiki/Debugsymbol #. type: textblock -#: debhelper-obsolete-compat.pod:50 +#: debhelper-obsolete-compat.pod:95 msgid "" -"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " -"B<ldconfig>." +"B<dh_strip --dbg-package> now specifies the name of a package to put " +"debugging symbols in, not the packages to take the symbols from." msgstr "" -"B<dh_makeshlibs> faz com que os scripts F<postinst> e F<postrm> chamem " -"B<ldconfig>." +"Agora B<dh_strip --dbg-package> especifica o nome de um pacote onde colocar " +"sÃmbolos de depuração, e não os pacotes de onde tirar os sÃmbolos." #. type: textblock -#: debhelper-obsolete-compat.pod:54 -msgid "" -"Every file in F<etc/> is automatically flagged as a conffile by " -"B<dh_installdeb>." +#: debhelper-obsolete-compat.pod:100 +msgid "B<dh_installdocs> skips installing empty files." +msgstr "B<dh_installdocs> evita a instalação de ficheiros vazios." + +#. type: textblock +#: debhelper-obsolete-compat.pod:104 +msgid "B<dh_install> errors out if wildcards expand to nothing." msgstr "" -"Qualquer ficheiro em F<etc/> é marcado automaticamente como um conffile " -"(ficheiro de configuração) pelo B<dh_installdeb>." +"B<dh_install> resulta em erro se as \"wildcards\" expandirem para nada." #. type: =item -#: debhelper-obsolete-compat.pod:60 +#: debhelper-obsolete-compat.pod:108 msgid "v4" msgstr "v4" #. type: textblock -#: debhelper-obsolete-compat.pod:62 +#: debhelper-obsolete-compat.pod:110 msgid "Changes from v3 are:" msgstr "As alterações a partir de v3 são:" #. type: textblock -#: debhelper-obsolete-compat.pod:68 +#: debhelper-obsolete-compat.pod:116 msgid "" "B<dh_makeshlibs -V> will not include the Debian part of the version number " "in the generated dependency line in the shlibs file." @@ -3897,7 +4237,7 @@ msgstr "" "linha de dependência gerada no ficheiro shlibs." #. type: textblock -#: debhelper-obsolete-compat.pod:73 +#: debhelper-obsolete-compat.pod:121 msgid "" "You are encouraged to put the new B<${misc:Depends}> into F<debian/control> " "to supplement the B<${shlibs:Depends}> field." @@ -3906,7 +4246,7 @@ msgstr "" "para suplementar o campo B<${shlibs:Depends}>." #. type: textblock -#: debhelper-obsolete-compat.pod:78 +#: debhelper-obsolete-compat.pod:126 msgid "" "B<dh_fixperms> will make all files in F<bin/> directories and in F<etc/init." "d> executable." @@ -3915,75 +4255,82 @@ msgstr "" "F<bin/> e em F<etc/init.d>." #. type: textblock -#: debhelper-obsolete-compat.pod:83 +#: debhelper-obsolete-compat.pod:131 msgid "B<dh_link> will correct existing links to conform with policy." msgstr "" "B<dh_link> irá corrigir os links existentes para ficarem em conformidade com " "a polÃtica." -#. type: textblock -#: debhelper-obsolete-compat.pod:93 -msgid "Changes from v4 are:" -msgstr "As alterações a partir de v4 são:" +#. type: =item +#: debhelper-obsolete-compat.pod:137 +msgid "v3" +msgstr "v3" #. type: textblock -#: debhelper-obsolete-compat.pod:99 -msgid "Comments are ignored in debhelper config files." -msgstr "Comentários são ignorados nos ficheiros de configuração do debhelper." +#: debhelper-obsolete-compat.pod:139 +msgid "This mode works like v2, with the following additions:" +msgstr "Este modo funciona como v2, com as seguintes adições:" -# http://de.wikipedia.org/wiki/Debugsymbol #. type: textblock -#: debhelper-obsolete-compat.pod:103 +#: debhelper-obsolete-compat.pod:145 msgid "" -"B<dh_strip --dbg-package> now specifies the name of a package to put " -"debugging symbols in, not the packages to take the symbols from." +"Debhelper config files support globbing via B<*> and B<?>, when appropriate. " +"To turn this off and use those characters raw, just prefix with a backslash." msgstr "" -"Agora B<dh_strip --dbg-package> especifica o nome de um pacote onde colocar " -"sÃmbolos de depuração, e não os pacotes de onde tirar os sÃmbolos." - -#. type: textblock -#: debhelper-obsolete-compat.pod:108 -msgid "B<dh_installdocs> skips installing empty files." -msgstr "B<dh_installdocs> evita a instalação de ficheiros vazios." +"Os ficheiros de configuração do debhelper suportam englobamentos via B<*> e " +"B<?>, onde apropriado. Para desligar isto e usar esses caracteres a cru, " +"basta antecedê-los com uma barra invertida (backslash \"\")." #. type: textblock -#: debhelper-obsolete-compat.pod:112 -msgid "B<dh_install> errors out if wildcards expand to nothing." +#: debhelper-obsolete-compat.pod:150 +msgid "" +"B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call " +"B<ldconfig>." msgstr "" -"B<dh_install> resulta em erro se as \"wildcards\" expandirem para nada." +"B<dh_makeshlibs> faz com que os scripts F<postinst> e F<postrm> chamem " +"B<ldconfig>." #. type: textblock -#: debhelper-obsolete-compat.pod:120 dh:735 dh_auto_build:55 dh_auto_clean:57 -#: dh_auto_configure:60 dh_auto_install:99 dh_auto_test:66 dh_builddeb:184 -#: dh_clean:191 dh_compress:244 dh_dwz:163 dh_fixperms:166 dh_gconf:107 -#: dh_gencontrol:210 dh_install:379 dh_installcatalogs:130 -#: dh_installchangelogs:302 dh_installcron:80 dh_installdeb:414 -#: dh_installdebconf:130 dh_installdirs:133 dh_installdocs:456 -#: dh_installexamples:180 dh_installifupdown:74 dh_installinfo:125 -#: dh_installlogcheck:83 dh_installlogrotate:55 dh_installman:419 -#: dh_installmanpages:200 dh_installmime:65 dh_installmodules:111 -#: dh_installpam:64 dh_installppp:70 dh_installudev:104 dh_installwm:134 -#: dh_installxfonts:92 dh_link:168 dh_listpackages:36 dh_makeshlibs:458 -#: dh_md5sums:120 dh_movefiles:163 dh_perl:176 dh_prep:72 dh_strip:437 -#: dh_testdir:64 dh_testroot:95 dh_usrlocal:138 dh_systemd_start:282 -msgid "L<debhelper(7)>" -msgstr "L<debhelper(7)>" +#: debhelper-obsolete-compat.pod:154 +msgid "" +"Every file in F<etc/> is automatically flagged as a conffile by " +"B<dh_installdeb>." +msgstr "" +"Qualquer ficheiro em F<etc/> é marcado automaticamente como um conffile " +"(ficheiro de configuração) pelo B<dh_installdeb>." -#. type: =head1 -#: debhelper-obsolete-compat.pod:122 dh_installinit:436 dh_systemd_enable:285 -#: dh_systemd_start:284 -msgid "AUTHORS" -msgstr "AUTORES" +#. type: =item +#: debhelper-obsolete-compat.pod:160 +msgid "v2" +msgstr "v2" #. type: textblock -#: debhelper-obsolete-compat.pod:124 dh_dwz:169 dh_installinitramfs:101 -msgid "Niels Thykier <niels@thykier.net>" -msgstr "Niels Thykier <niels@thykier.net>" +#: debhelper-obsolete-compat.pod:162 +msgid "" +"In this mode, debhelper will consistently use debian/I<package> as the " +"package tree directory for every package that is built." +msgstr "" +"Neste modo, o debhelper irá consistentemente usar debian/I<pacote> como o " +"directório da árvore do pacote para cada pacote que é compilado." + +#. type: =item +#: debhelper-obsolete-compat.pod:167 +msgid "v1" +msgstr "v1" #. type: textblock -#: debhelper-obsolete-compat.pod:126 -msgid "Joey Hess" -msgstr "Joey Hess" +#: debhelper-obsolete-compat.pod:169 +msgid "" +"This is the original debhelper compatibility level, and so it is the default " +"one. In this mode, debhelper will use F<debian/tmp> as the package tree " +"directory for the first binary package listed in the control file, while " +"using debian/I<package> for all other packages listed in the F<control> file." +msgstr "" +"Este é o nÃvel de compatibilidade original do debhelper, e por isso é o " +"predefinido. Neste modo, o debhelper irá usar F<debian/tmp> como o " +"directório da árvore do pacote para o primeiro pacote binário listado no " +"ficheiro de controle, enquanto usa debian/I<pacote> para todos os outros " +"pacotes listados no ficheiro F<control>." #. type: textblock #: dh:5 @@ -4102,12 +4449,12 @@ msgid "" "The override and hook targets can also be defined to run only when building " "architecture dependent or architecture independent packages. Use targets " "with names like B<override_>I<dh_command>B<-arch> and " -"B<execute_after>I<dh_command>B<-indep>." +"B<execute_after_>I<dh_command>B<-indep>." msgstr "" "Os alvos de sobreposição e hook também podem ser definidos para correr " "apenas quando se compila pacotes dependentes ou independentes da " "arquitectura. Use alvos com nomes como B<override_>I<dh_command>B<-arch> e " -"B<execute_after>I<dh_command>B<-indep>." +"B<execute_after_>I<dh_command>B<-indep>." #. type: textblock #: dh:70 @@ -4125,10 +4472,16 @@ msgstr "Alvos completamente vazios" #. type: textblock #: dh:75 +#, fuzzy +#| msgid "" +#| "As a special optimization, B<dh> will skip a target if it is completely " +#| "empty. This is mostly useful for override targets, where the command " +#| "will simply be skipped without the overhead of invoking a dummy target." msgid "" "As a special optimization, B<dh> will skip a target if it is completely " -"empty. This is mostly useful for override targets, where the command will " -"simply be skipped without the overhead of invoking a dummy target." +"empty and does not depend on any other target. This is mostly useful for " +"override targets, where the command will simply be skipped without the " +"overhead of invoking a dummy target." msgstr "" "Como uma optimização especial, B<dh> irá saltar um alvo se este estiver " "completamente vazio. Isto é muito útil para alvos de sobreposição, onde o " @@ -4136,12 +4489,12 @@ msgstr "" "fantoche." #. type: textblock -#: dh:79 +#: dh:80 msgid "Note that the target has to be completely empty for this to work:" msgstr "Note que o alvo tem de estar completamente vazio para isto funcionar:" #. type: verbatim -#: dh:81 +#: dh:82 #, no-wrap msgid "" " # Skip dh_bar - the good and optimized way\n" @@ -4155,7 +4508,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:86 +#: dh:87 #, no-wrap msgid "" " # Skip dh_foo - the slow way\n" @@ -4171,21 +4524,92 @@ msgstr "" "\n" #. type: =head2 -#: dh:91 +#: dh:92 msgid "Verifying targets are picked up by dh" msgstr "Verificando se os alvos são apanhados pelo dh" #. type: textblock -#: dh:93 +#: dh:94 +msgid "" +"As of debhelper 13.10, you can use L<dh_assistant(1)> to see which override " +"and hook targets will be seen by B<dh>. Here is an example run of " +"L<dh_assistant(1)> along with its output:" +msgstr "" + +#. type: verbatim +#: dh:98 +#, no-wrap +msgid "" +" $ dh_assistant detect-hook-targets\n" +" {\n" +" \"commands-not-in-path\": [\n" +" \"dh_foo\"\n" +" ],\n" +" \"hook-targets\": [\n" +" {\n" +" \"command\": \"dh_strip_nondeterminism\",\n" +" \"is-empty\": true,\n" +" \"package-section-param\": null,\n" +" \"target-name\": \"override_dh_strip_nondeterminism\"\n" +" },\n" +" {\n" +" \"command\": \"dh_foo\",\n" +" \"is-empty\": false,\n" +" \"package-section-param\": \"-a\",\n" +" \"target-name\": \"override_dh_foo-arch\"\n" +" }\n" +" ]\n" +" }\n" +"\n" +msgstr "" + +#. type: textblock +#: dh:119 +msgid "" +"The B<commands-not-in-path> is useful for spotting mistakes in the hook " +"target names. A non-empty value implies one of more hook targets are " +"related to a command that is either not installed or no command with that " +"name exists at all. It is generally worth double checking these." +msgstr "" + +#. type: textblock +#: dh:124 +msgid "" +"Additionally, the B<is-empty> attribute for each hook target can be used for " +"seeing whether a hook target triggers the L</Completely empty targets> " +"optimization." +msgstr "" + +#. type: textblock +#: dh:127 +msgid "" +"If you are interested in the other attributes, please read the " +"L<dh_assistant(1)> for the details." +msgstr "" + +#. type: =head3 +#: dh:130 +#, fuzzy +#| msgid "Verifying targets are picked up by dh" +msgid "" +"Verifying targets are picked up by dh (when debhelper is older than 13.10)" +msgstr "Verificando se os alvos são apanhados pelo dh" + +#. type: textblock +#: dh:134 +#, fuzzy +#| msgid "" +#| "If you want to confirm that B<dh> has seen an override or a hook target, " +#| "you can use the following command as an example:" msgid "" -"If you want to confirm that B<dh> has seen an override or a hook target, you " +"On older versions of debhelper, you have to use B<dh> with B<--no-act>. You " "can use the following command as an example:" msgstr "" "Se você desejar confirmar que o B<dh> viu um alvo de sobreposição ou hook, " "pode usar o seguinte comando como um exemplo:" #. type: verbatim -#: dh:96 +#: dh:137 #, no-wrap msgid "" " $ dh binary --no-act | grep dh_install | head -n5\n" @@ -4205,7 +4629,7 @@ msgstr "" "\n" #. type: textblock -#: dh:103 +#: dh:144 msgid "" "The B<debian/rules execute_after_dh_install> in the output, which signals " "that B<dh> registered a B<execute_after_dh_install> target and would run it " @@ -4216,7 +4640,7 @@ msgstr "" "directamente após L<dh_install(1)>." #. type: textblock -#: dh:107 +#: dh:148 msgid "" "Note that L</Completely empty targets> will be omitted in the listing " "above. This makes it a bit harder to spot as you are looking for the " @@ -4228,12 +4652,12 @@ msgstr "" "mesmo." #. type: =head2 -#: dh:111 +#: dh:152 msgid "Caveats with hook targets and makefile conditionals" msgstr "Ressalvas com alvos hook e condicionais makefile" #. type: textblock -#: dh:113 +#: dh:154 msgid "" "If you choose to wrap a hook target in makefile conditionals, please be " "aware that B<dh> computes all the hook targets a head of time and caches the " @@ -4248,7 +4672,7 @@ msgstr "" "que a resposta não mudou." #. type: textblock -#: dh:119 +#: dh:160 msgid "" "The parsing and caching I<often> happens before B<dh> knows whether it will " "build arch:any (-a) or/and arch:all (-i) packages, which can produce " @@ -4261,7 +4685,7 @@ msgstr "" "condicional." #. type: textblock -#: dh:124 +#: dh:165 msgid "" "Most of the problems can be avoided by making the hook target unconditional " "and then have the \"body\" be partially or completely conditional. As an " @@ -4272,7 +4696,7 @@ msgstr "" "condicional. Com exemplo:" #. type: verbatim -#: dh:128 +#: dh:169 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. The hook target\n" @@ -4306,7 +4730,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:142 +#: dh:183 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -4340,7 +4764,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:157 +#: dh:198 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -4374,7 +4798,7 @@ msgstr "" "\n" #. type: textblock -#: dh:171 +#: dh:212 msgid "" "These recipes are also relevant for conditional dependency targets, which " "are often seen in a variant of the following example:" @@ -4383,7 +4807,7 @@ msgstr "" "os quais são muitas vezes vistos numa variante do seguinte exemplo:" #. type: verbatim -#: dh:174 +#: dh:215 #, no-wrap msgid "" " COND_TASKS =\n" @@ -4401,7 +4825,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:180 +#: dh:221 #, no-wrap msgid "" " maybe-run-this:\n" @@ -4413,7 +4837,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:183 +#: dh:224 #, no-wrap msgid "" " # SIMPLE: It is well-defined what happens. Either the\n" @@ -4439,7 +4863,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:194 +#: dh:235 #, no-wrap msgid "" " # SIMPLE: This is also well-defined. The hook target is always\n" @@ -4467,7 +4891,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:205 +#: dh:246 #, no-wrap msgid "" " # COMPLICATED: This case can be non-trivial and have sharp edges.\n" @@ -4487,7 +4911,7 @@ msgstr "" "\n" #. type: textblock -#: dh:213 +#: dh:254 msgid "" "When in doubt, pick the relevant B<SIMPLE> case in the examples above that " "match your need." @@ -4496,29 +4920,29 @@ msgstr "" "que corresponda à sua necessidade." #. type: =head1 -#: dh:216 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 -#: dh_auto_install:46 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 -#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gconf:42 dh_gencontrol:38 -#: dh_icons:33 dh_install:69 dh_installcatalogs:56 dh_installchangelogs:71 -#: dh_installcron:43 dh_installdeb:100 dh_installdebconf:64 dh_installdirs:45 -#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:44 -#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:78 +#: dh:257 dh_auto_build:32 dh_auto_clean:33 dh_auto_configure:35 +#: dh_auto_install:52 dh_auto_test:34 dh_bugfiles:53 dh_builddeb:34 dh_clean:49 +#: dh_compress:52 dh_dwz:26 dh_fixperms:40 dh_gencontrol:38 dh_icons:33 +#: dh_install:69 dh_installcatalogs:56 dh_installchangelogs:77 +#: dh_installcron:45 dh_installdeb:107 dh_installdebconf:64 dh_installdirs:45 +#: dh_installdocs:100 dh_installemacsen:56 dh_installexamples:48 +#: dh_installifupdown:42 dh_installinfo:41 dh_installinit:77 #: dh_installinitramfs:43 dh_installlogcheck:45 dh_installlogrotate:25 #: dh_installman:86 dh_installmanpages:43 dh_installmenu:44 -#: dh_installmodules:41 dh_installpam:34 dh_installppp:38 dh_installudev:34 +#: dh_installmodules:41 dh_installpam:38 dh_installppp:38 dh_installudev:34 #: dh_installwm:41 dh_link:69 dh_makeshlibs:67 dh_md5sums:31 dh_movefiles:41 -#: dh_perl:34 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 -#: dh_usrlocal:50 dh_systemd_enable:83 dh_systemd_start:33 +#: dh_perl:35 dh_prep:29 dh_shlibdeps:30 dh_strip:38 dh_testdir:26 +#: dh_usrlocal:50 dh_systemd_enable:82 dh_systemd_start:33 msgid "OPTIONS" msgstr "OPÇÕES" #. type: =item -#: dh:220 +#: dh:261 msgid "B<--with> I<addon>[B<,>I<addon> ...]" msgstr "B<--with> I<addon>[B<,>I<addon> ...]" #. type: textblock -#: dh:222 +#: dh:263 msgid "" "Add the debhelper commands specified by the given addon to appropriate " "places in the sequence of commands that is run. This option can be repeated " @@ -4535,7 +4959,7 @@ msgstr "" "documentação acerca da sequência de interface de addons." #. type: textblock -#: dh:229 +#: dh:270 msgid "" "A B<Build-Depends> relation on the package B<dh-sequence->I<addon> implies a " "B<--with> I<addon>. This avoids the need for an explicit B<--with> in " @@ -4554,7 +4978,7 @@ msgstr "" "bootstrapping)." #. type: textblock -#: dh:238 +#: dh:279 msgid "" "Since debhelper 12.5, addons can also be activated in B<indep>-only mode " "(via B<Build-Depends-Indep>) or B<arch>-only mode (via B<Build-Depends-" @@ -4568,7 +4992,7 @@ msgstr "" "compilações cruzadas (cross-builds)." #. type: textblock -#: dh:244 +#: dh:285 msgid "" "Please note that addons activated via B<Build-Depends-Indep> or B<Build-" "Depends-Arch> are subject to additional limitations to ensure the result is " @@ -4586,12 +5010,12 @@ msgstr "" "sequências." #. type: =item -#: dh:252 +#: dh:293 msgid "B<--without> I<addon>" msgstr "B<--without> I<addon>" #. type: textblock -#: dh:254 +#: dh:295 msgid "" "The inverse of B<--with>, disables using the given addon. This option can be " "repeated more than once, or multiple addons to disable can be listed, " @@ -4602,12 +5026,12 @@ msgstr "" "os listar separados por vÃrgulas." #. type: textblock -#: dh:260 +#: dh:301 msgid "List all available addons." msgstr "Lista todos os addons disponÃveis." #. type: textblock -#: dh:262 +#: dh:303 msgid "" "When called only with this option, B<dh> can be called from any directory (i." "e. it does not need access to files from a source package)." @@ -4617,7 +5041,7 @@ msgstr "" "fonte)." #. type: textblock -#: dh:268 +#: dh:309 msgid "" "Prints commands that would run for a given sequence, but does not run them." msgstr "" @@ -4625,7 +5049,7 @@ msgstr "" "corre." #. type: textblock -#: dh:270 +#: dh:311 msgid "" "Note that dh normally skips running commands that it knows will do nothing. " "With --no-act, the full list of commands in a sequence is printed." @@ -4634,7 +5058,7 @@ msgstr "" "Com --no-act, é escrito em sequência a lista completa dos comandos." #. type: textblock -#: dh:275 +#: dh:316 msgid "" "Other options passed to B<dh> are passed on to each command it runs. This " "can be used to set an option like B<-v> or B<-X> or B<-N>, as well as for " @@ -4645,13 +5069,13 @@ msgstr "" "assim como para opções mais especializadas." #. type: =head1 -#: dh:279 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 +#: dh:320 dh_install:332 dh_installdocs:191 dh_installman:117 dh_link:91 #: dh_makeshlibs:185 dh_shlibdeps:78 msgid "EXAMPLES" msgstr "EXEMPLOS" #. type: textblock -#: dh:281 +#: dh:322 msgid "" "To see what commands are included in a sequence, without actually doing " "anything:" @@ -4660,7 +5084,7 @@ msgstr "" "nada:" #. type: verbatim -#: dh:284 +#: dh:325 #, no-wrap msgid "" "\tdh binary-arch --no-act\n" @@ -4670,7 +5094,7 @@ msgstr "" "\n" #. type: textblock -#: dh:286 +#: dh:327 msgid "" "This is a very simple rules file, for packages where the default sequences " "of commands work with no additional options." @@ -4679,7 +5103,7 @@ msgstr "" "de comandos predefinidas funcionam sem opções adicionais." #. type: verbatim -#: dh:289 dh:296 dh:310 dh:323 dh:334 dh:392 dh:403 +#: dh:330 dh:337 dh:351 dh:364 dh:375 dh:433 dh:444 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4693,7 +5117,7 @@ msgstr "" "\n" #. type: textblock -#: dh:293 +#: dh:334 msgid "" "Often you'll want to pass an option to a specific debhelper command. The " "easy way to do with is by adding an override target for that command." @@ -4703,7 +5127,7 @@ msgstr "" "sobreposição a esse comando." #. type: verbatim -#: dh:300 +#: dh:341 #, no-wrap msgid "" "\toverride_dh_strip:\n" @@ -4715,7 +5139,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:303 +#: dh:344 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4727,7 +5151,7 @@ msgstr "" "\n" #. type: textblock -#: dh:306 +#: dh:347 msgid "" "Sometimes the automated L<dh_auto_configure(1)> and L<dh_auto_build(1)> " "can't guess what to do for a strange package. Here's how to avoid running " @@ -4739,7 +5163,7 @@ msgstr "" "comandos." #. type: verbatim -#: dh:314 +#: dh:355 #, no-wrap msgid "" "\toverride_dh_auto_configure:\n" @@ -4751,7 +5175,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:317 +#: dh:358 #, no-wrap msgid "" "\toverride_dh_auto_build:\n" @@ -4763,7 +5187,7 @@ msgstr "" "\n" #. type: textblock -#: dh:320 +#: dh:361 msgid "" "Another common case is wanting to do something manually before or after a " "particular debhelper command is run." @@ -4772,7 +5196,7 @@ msgstr "" "comando debhelper particular ser executado." #. type: verbatim -#: dh:327 +#: dh:368 #, no-wrap msgid "" "\t# Example assumes debhelper/12.8 and compat 10+\n" @@ -4786,7 +5210,7 @@ msgstr "" "\n" #. type: textblock -#: dh:331 +#: dh:372 msgid "" "If you are on an older debhelper or compatibility level, the above example " "would have to be written as." @@ -4795,7 +5219,7 @@ msgstr "" "cima terá que ser escrito assim:" #. type: verbatim -#: dh:338 +#: dh:379 #, no-wrap msgid "" "\t# Older debhelper versions or using compat 9 or lower.\n" @@ -4811,7 +5235,7 @@ msgstr "" "\n" #. type: textblock -#: dh:343 +#: dh:384 msgid "" "Python tools are not run by dh by default, due to the continual change in " "that area. Here is how to use B<dh_python2>." @@ -4820,7 +5244,7 @@ msgstr "" "alterações contÃnuas nessa área. Aqui está como usar o B<dh_python2>." #. type: verbatim -#: dh:346 +#: dh:387 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4834,7 +5258,7 @@ msgstr "" "\n" #. type: textblock -#: dh:350 +#: dh:391 msgid "" "Here is how to force use of Perl's B<Module::Build> build system, which can " "be necessary if debhelper wrongly detects that the package uses MakeMaker." @@ -4844,7 +5268,7 @@ msgstr "" "pacote usa MakeMaker." #. type: verbatim -#: dh:354 +#: dh:395 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4858,7 +5282,7 @@ msgstr "" "\n" #. type: textblock -#: dh:358 +#: dh:399 msgid "" "Here is an example of overriding where the B<dh_auto_>I<*> commands find the " "package's source, for a package where the source is located in a " @@ -4869,7 +5293,7 @@ msgstr "" "localizada num sub-directório." #. type: verbatim -#: dh:362 +#: dh:403 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4883,7 +5307,7 @@ msgstr "" "\n" #. type: textblock -#: dh:366 +#: dh:407 msgid "" "And here is an example of how to tell the B<dh_auto_>I<*> commands to build " "in a subdirectory, which will be removed on B<clean>." @@ -4892,7 +5316,7 @@ msgstr "" "compilarem num sub-directório, o qual será removido em B<clean>." #. type: verbatim -#: dh:369 +#: dh:410 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4906,7 +5330,7 @@ msgstr "" "\n" #. type: textblock -#: dh:373 +#: dh:414 msgid "" "If your package can be built in parallel, please either use compat 10 or " "pass B<--parallel> to dh. Then B<dpkg-buildpackage -j> will work." @@ -4916,7 +5340,7 @@ msgstr "" "-j> irá funcionar." #. type: verbatim -#: dh:376 +#: dh:417 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4930,7 +5354,7 @@ msgstr "" "\n" #. type: textblock -#: dh:380 +#: dh:421 msgid "" "If your package cannot be built reliably while using multiple threads, " "please pass B<--no-parallel> to dh (or the relevant B<dh_auto_>I<*> command):" @@ -4940,7 +5364,7 @@ msgstr "" "B<dh_auto_>I<*> relevante):" #. type: verbatim -#: dh:385 +#: dh:426 #, no-wrap msgid "" "\t#!/usr/bin/make -f\n" @@ -4954,7 +5378,7 @@ msgstr "" "\n" #. type: textblock -#: dh:389 +#: dh:430 msgid "" "Here is a way to prevent B<dh> from running several commands that you don't " "want it to run, by defining empty override targets for each command." @@ -4963,7 +5387,7 @@ msgstr "" "quer que corram, ao definir alvos de sobreposição vazios para cada comando." #. type: verbatim -#: dh:396 +#: dh:437 #, no-wrap msgid "" "\t# Commands not to run:\n" @@ -4975,7 +5399,7 @@ msgstr "" "\n" #. type: textblock -#: dh:399 +#: dh:440 msgid "" "A long build process for a separate documentation package can be separated " "out using architecture independent overrides. These will be skipped when " @@ -4986,7 +5410,7 @@ msgstr "" "Estes serão saltados quando se corre as sequências build-arch e binary-arch." #. type: verbatim -#: dh:407 +#: dh:448 #, no-wrap msgid "" "\toverride_dh_auto_build-indep:\n" @@ -4998,7 +5422,7 @@ msgstr "" "\n" #. type: verbatim -#: dh:410 +#: dh:451 #, no-wrap msgid "" "\t# No tests needed for docs\n" @@ -5010,49 +5434,240 @@ msgstr "" "\n" #. type: verbatim -#: dh:413 +#: dh:454 #, no-wrap msgid "" "\toverride_dh_auto_install-indep:\n" "\t\t$(MAKE) -C docs install\n" "\n" msgstr "" -"\toverride_dh_auto_install-indep:\n" -"\t\t$(MAKE) -C docs install\n" -"\n" +"\toverride_dh_auto_install-indep:\n" +"\t\t$(MAKE) -C docs install\n" +"\n" + +#. type: textblock +#: dh:457 +msgid "" +"Adding to the example above, suppose you need to chmod a file, but only when " +"building the architecture dependent package, as it's not present when " +"building only documentation." +msgstr "" +"Adicionando ao exemplo em cima, suponha que precisa de fazer chmod a um " +"ficheiro, mas apenas quando compila o pacote dependente da arquitectura, " +"pois ele não está presente quando compila apenas a documentação." + +#. type: verbatim +#: dh:461 +#, no-wrap +msgid "" +"\t# Example assumes debhelper/12.8 and compat 10+\n" +"\texecute_after_dh_fixperms-arch:\n" +"\t\tchmod 4755 debian/foo/usr/bin/foo\n" +"\n" +msgstr "" +"\t# Example assumes debhelper/12.8 and compat 10+\n" +"\texecute_after_dh_fixperms-arch:\n" +"\t\tchmod 4755 debian/foo/usr/bin/foo\n" +"\n" + +#. type: =head1 +#: dh:465 +msgid "DEBHELPER PROVIDED DH ADDONS" +msgstr "ADDONS DH FORNECIDOS PELO DEBHELPER" + +#. type: textblock +#: dh:467 +msgid "" +"The primary purpose of B<dh> addons is to provide easy integration with " +"third-party provided features for debhelper. However, debhelper itself also " +"provide a few sequences that can be useful in some cases. These are " +"documented in this list:" +msgstr "" +"O objetivo principal dos addons do B<dh> é fornecer integração fácil com " +"funcionalidades fornecidas por terceiros para o debhelper. No entanto, o " +"próprio debhelper também fornece algumas sequências que podem ser úteis em " +"alguns casos. Estas estão documentadas nesta lista:" + +#. type: =item +#: dh:474 +msgid "build-stamp" +msgstr "build-stamp" + +#. type: textblock +#: dh:476 +msgid "" +"A special addon for controlling whether B<dh> (in compat 10 or later) will " +"create stamp files to tell whether the build target has been run " +"successfully. See L</INTERNALS> for more details." +msgstr "" +"Um addon especial para controlar se B<dh> (em compatibilidade 10 ou " +"posterior) irá criar ficheiros stamp para dizer se o alvo de compilação " +"correu com sucesso. Veja L</INTERNOS> para mais detalhes." + +#. type: textblock +#: dh:480 +msgid "" +"This addon is active by default but can disabled by using B<dh $@ --without " +"build-stamp>" +msgstr "" +"Este addon está activo por predefinição mas pode ser desactivado ao usar " +"B<dh $@ --without build-stamp>" + +#. type: =item +#: dh:483 +msgid "dwz (obsolete)" +msgstr "dwz (obsoleto)" + +#. type: textblock +#: dh:485 +msgid "" +"Adds L<dh_dwz(1)> to the sequence in compat level 11 or below. Obsolete in " +"compat 12 or later." +msgstr "" +"Adiciona L<dh_dwz(1)> à sequência em compatibilidade 11 ou inferior. " +"Obsoleto compatibilidade 12 ou posterior." + +#. type: =item +#: dh:488 +msgid "elf-tools" +msgstr "elf-tools" + +#. type: textblock +#: dh:490 +msgid "" +"This addon adds tools related to ELF files to the sequence such as " +"L<dh_strip(1)> and L<dh_shlibdeps(1)>" +msgstr "" +"Este addon adiciona ferramentas relativas a ficheiros ELF à sequência tal " +"como L<dh_strip(1)> e L<dh_shlibdeps(1)>" + +#. type: textblock +#: dh:493 +msgid "" +"This addon is I<conditionally> active by default for architecture specific " +"packages - that is, it is skipped for arch:all packages. In the special " +"case where you need these tools to work on arch:all packages, you can use " +"B<--with elf-tools> to activate it unconditionally." +msgstr "" +"Este addon está activo I<condicionalmente> por predefinição para pacotes " +"especÃficos de arquitectura - isto é, é saltado para pacotes arch:all. Num " +"caso especial que você precise destas ferramentas a funcionar em pacotes " +"arch:all, você pode usar B<--with elf-tools> para o activar " +"incondicionalmente." + +#. type: =item +#: dh:499 +msgid "installinitramfs (obsolete)" +msgstr "installinitramfs (obsoleto)" + +#. type: textblock +#: dh:501 +msgid "" +"Adds L<dh_installinitramfs(1)> to the sequence in compat level 11 or below. " +"Obsolete in compat 12 or later." +msgstr "" +"Adiciona L<dh_installinitramfs(1)> à sequência em compatibilidade 11 ou " +"inferior. Obsoleto compatibilidade 12 ou posterior." + +#. type: =item +#: dh:504 +msgid "root-sequence (internal)" +msgstr "root-sequence (interno)" + +#. type: textblock +#: dh:506 +msgid "This is reserved for internal usage." +msgstr "Isto está reservado para uso interno." + +#. type: =item +#: dh:508 +msgid "single-binary" +msgstr "single-binary" + +#. type: textblock +#: dh:510 +msgid "" +"A special-purpose addon that makes debhelper run in \"single binary\" mode." +msgstr "" +"Um addon de objetivo-especial que faz o debhelper em modo \"binário único\"." + +#. type: textblock +#: dh:512 +msgid "" +"When active, it will pass B<< --destdir=debian/I<package>/ >> to " +"L<dh_auto_install(1)>. This makes every file \"installed\" by the upstream " +"build system part of the (only) binary package by default without having to " +"use other helpers such as L<dh_install(1)>." +msgstr "" +"Quando activo, irá passar B<< --destdir=debian/I<package>/ >> ao " +"L<dh_auto_install(1)>. Isto faz com que todos os ficheiros \"instalados\" " +"pelo sistema de compilação do autor façam parte do (único) pacote binário " +"por predefinição sem ter que se usar outros ajudantes como o " +"L<dh_install(1)>." + +#. type: textblock +#: dh:517 +msgid "" +"The addon will refuse to activate when the source package lists 2 or more " +"binary packages in F<debian/control> as a precaution." +msgstr "" +"Como precaução o addon irá recusar activar-se quando o pacote fonte listar 2 " +"ou mais pacotes binários em F<debian/control>." + +#. type: textblock +#: dh:520 +msgid "" +"Before compat 15. this behaviour was the default when there was only a " +"single binary package listed in F<debian/control>. In compat 15 and later, " +"this addon must explicitly be activated for this feature to work." +msgstr "" +"Antes da compatibilidade 15, este comportamento era o predefinido quando " +"havia apenas um único pacote binário listado em F<debian/control>. Em " +"compatibilidade 15 e posterior, este addon tem de ser activado " +"explicitamente para que esta funcionalidade funcione." #. type: textblock -#: dh:416 +#: dh:524 msgid "" -"Adding to the example above, suppose you need to chmod a file, but only when " -"building the architecture dependent package, as it's not present when " -"building only documentation." +"The rationale for requiring this as an explicit choice is that if it is " +"implicit then debhelper will silently change behaviour on adding a new " +"binary package. This has caused many RC bugs when maintainers renamed a " +"binary and added transitional packages with the intention of supporting " +"seamless upgrades. The result would often be two empty binary packages that " +"were uploaded to archive with users frustrated as their \"upgrade\" removed " +"their programs." msgstr "" -"Adicionando ao exemplo em cima, suponha que precisa de fazer chmod a um " -"ficheiro, mas apenas quando compila o pacote dependente da arquitectura, " -"pois ele não está presente quando compila apenas a documentação." +"A razão para se requerer isto como uma escolha explÃcita é que se fosse " +"implÃcita então o debhelper iria mudar o comportamento em silêncio ao se " +"adicionar um novo pacote binário. Isto causou muitos bugs RC quando os " +"maintainers renomeavam um binário e adicionavam pacotes de transição com a " +"intenção de suportar actualizações perfeitas. O resultado era muitas vezes " +"dois pacotes binários vazios que eram enviados para o arquivo com os " +"utilizadores frustrados pois a sua \"actualização\" removeu os seus " +"programas." -#. type: verbatim -#: dh:420 -#, no-wrap +#. type: =item +#: dh:532 +msgid "systemd (obsolete)" +msgstr "systemd (obsoleto)" + +#. type: textblock +#: dh:534 msgid "" -"\t# Example assumes debhelper/12.8 and compat 10+\n" -"\texecute_after_dh_fixperms-arch:\n" -"\t\tchmod 4755 debian/foo/usr/bin/foo\n" -"\n" +"Adds L<dh_systemd_enable(1)> and L<dh_systemd_start(1)> to the sequence in " +"compat level 10 or below. Obsolete in compat 11 or later." msgstr "" -"\t# Example assumes debhelper/12.8 and compat 10+\n" -"\texecute_after_dh_fixperms-arch:\n" -"\t\tchmod 4755 debian/foo/usr/bin/foo\n" -"\n" +"Adiciona L<dh_systemd_enable(1)> e L<dh_systemd_start(1)> à sequência em " +"nÃvel de compatibilidade 10 ou inferior. Obsoleto em compatibilidade 11 ou " +"posterior." #. type: =head1 -#: dh:424 +#: dh:539 msgid "INTERNALS" msgstr "INTERNOS" #. type: textblock -#: dh:426 +#: dh:541 msgid "" "If you're curious about B<dh>'s internals, here's how it works under the " "hood." @@ -5061,7 +5676,7 @@ msgstr "" "funciona por baixo da capota." #. type: textblock -#: dh:428 +#: dh:543 msgid "" "In compat 10 (or later), B<dh> creates a stamp file F<debian/debhelper-build-" "stamp> after the build step(s) are complete to avoid re-running them. It is " @@ -5079,7 +5694,7 @@ msgstr "" "(a segunda vez como root ou sob L<fakeroot(1)>)." #. type: textblock -#: dh:436 +#: dh:551 msgid "" "Inside an override target, B<dh_*> commands will create a log file F<debian/" "package.debhelper.log> to keep track of which packages the command(s) have " @@ -5093,7 +5708,7 @@ msgstr "" "completo." #. type: textblock -#: dh:441 +#: dh:556 msgid "" "In compat 9 or earlier, each debhelper command will record when it's " "successfully run in F<debian/package.debhelper.log>. (Which B<dh_clean> " @@ -5106,7 +5721,7 @@ msgstr "" "foram corridos, para quais pacotes, e evita correr esses comandos de novo." #. type: textblock -#: dh:446 +#: dh:561 msgid "" "Each time B<dh> is run (in compat 9 or earlier), it examines the log, and " "finds the last logged command that is in the specified sequence. It then " @@ -5117,7 +5732,7 @@ msgstr "" "sequência especificada. Depois continua com o próximo comando da sequência." #. type: textblock -#: dh:450 +#: dh:565 msgid "" "A sequence can also run dependent targets in debian/rules. For example, the " "\"binary\" sequence runs the \"install\" target." @@ -5126,7 +5741,7 @@ msgstr "" "exemplo, a sequência \"binary\" corre o alvo \"install\"." #. type: textblock -#: dh:453 +#: dh:568 msgid "" "B<dh> uses the B<DH_INTERNAL_OPTIONS> environment variable to pass " "information through to debhelper commands that are run inside override " @@ -5139,7 +5754,7 @@ msgstr "" "ambiente. como o nome sugere, está sujeito a alterações em qualquer altura." #. type: textblock -#: dh:458 +#: dh:573 msgid "" "Commands in the B<build-indep>, B<install-indep> and B<binary-indep> " "sequences are passed the B<-i> option to ensure they only work on " @@ -5154,19 +5769,19 @@ msgstr "" "assegurar que eles apenas trabalham em pacotes dependentes da arquitectura." #. type: textblock -#: dh:737 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 -#: dh_auto_install:101 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:186 -#: dh_clean:193 dh_compress:246 dh_dwz:165 dh_fixperms:168 dh_gconf:109 -#: dh_gencontrol:212 dh_icons:79 dh_install:381 dh_installchangelogs:304 -#: dh_installcron:82 dh_installdeb:416 dh_installdebconf:132 dh_installdirs:135 -#: dh_installdocs:458 dh_installemacsen:143 dh_installexamples:182 -#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:434 -#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:421 +#: dh:876 dh_auto_build:57 dh_auto_clean:59 dh_auto_configure:62 +#: dh_auto_install:107 dh_auto_test:68 dh_bugfiles:139 dh_builddeb:180 +#: dh_clean:193 dh_compress:247 dh_dwz:167 dh_fixperms:168 dh_gencontrol:212 +#: dh_icons:79 dh_install:381 dh_installchangelogs:369 dh_installcron:84 +#: dh_installdeb:423 dh_installdebconf:237 dh_installdirs:135 +#: dh_installdocs:441 dh_installemacsen:143 dh_installexamples:186 +#: dh_installifupdown:76 dh_installinfo:127 dh_installinit:417 +#: dh_installinitramfs:97 dh_installlogrotate:57 dh_installman:424 #: dh_installmanpages:202 dh_installmenu:94 dh_installmime:67 -#: dh_installmodules:113 dh_installpam:66 dh_installppp:72 dh_installudev:106 -#: dh_installwm:136 dh_installxfonts:94 dh_link:170 dh_lintian:64 +#: dh_installmodules:113 dh_installpam:75 dh_installppp:72 dh_installudev:106 +#: dh_installwm:134 dh_installxfonts:94 dh_link:170 dh_lintian:64 #: dh_listpackages:38 dh_makeshlibs:460 dh_md5sums:122 dh_movefiles:165 -#: dh_perl:178 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 +#: dh_perl:192 dh_prep:74 dh_shlibdeps:208 dh_strip:439 dh_testdir:66 #: dh_testroot:97 dh_usrlocal:140 msgid "This program is a part of debhelper." msgstr "Este programa é parte do debhelper." @@ -5213,7 +5828,7 @@ msgstr "" "executar o processo de compilação manualmente." #. type: textblock -#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:48 +#: dh_auto_build:34 dh_auto_clean:35 dh_auto_configure:37 dh_auto_install:54 #: dh_auto_test:36 msgid "" "See L<debhelper(7)/B<BUILD SYSTEM OPTIONS>> for a list of common build " @@ -5223,9 +5838,9 @@ msgstr "" "sistemas de compilação comuns e opções de controle." #. type: =item -#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:59 +#: dh_auto_build:39 dh_auto_clean:40 dh_auto_configure:42 dh_auto_install:65 #: dh_auto_test:41 dh_builddeb:48 dh_dwz:62 dh_gencontrol:42 -#: dh_installdebconf:72 dh_installinit:167 dh_makeshlibs:179 dh_shlibdeps:41 +#: dh_installdebconf:72 dh_installinit:166 dh_makeshlibs:179 dh_shlibdeps:41 msgid "B<--> I<params>" msgstr "B<--> I<params>" @@ -5395,21 +6010,38 @@ msgstr "" #. type: textblock #: dh_auto_install:32 msgid "" -"Unless B<--destdir> option is specified, the files are installed into debian/" -"I<package>/ if there is only one binary package. In the multiple binary " -"package case, the files are instead installed into F<debian/tmp/>, and " -"should be moved from there to the appropriate package build directory using " -"L<dh_install(1)>." +"In compat 15 or later, B<dh_auto_install> will use F<debian/tmp> as the " +"default B<--destdir> and should be moved from there to the appropriate " +"package build directory using L<dh_install(1)> or similar tools. Though if " +"the B<single-binary> addon for L<dh(1)> is activated, then it will pass an " +"explicit B<< --destdir=debian/I<package>/ >> to B<dh_auto_install>." msgstr "" -"A menos que a opção B<--destdir> seja especificada, os ficheiros são " -"instalados e, debian/I<pacote>/ se existir apenas um pacote binário. No caso " -"de pacote de múltiplos binários, em vez disso os ficheiros são instalados em " -"F<debian/tmp/>, e deverão ser movidos daà para o directório apropriado de " -"compilação de pacote usando o L<dh_install(1)>." +"Em compatibilidade 15 ou posterior, B<dh_auto_install> irá usar F<debian/" +"tmp> como B<--destdir> predefinida e deve ser movida de lá para o directório " +"de compilação de pacote apropriado usando L<dh_install(1)> ou ferramentas " +"semelhantes. Contudo, se o addon B<single-binary> para L<dh(1)> estiver " +"activo, então irá passar um B<< --destdir=debian/I<package>/ >> explÃcito " +"para B<dh_auto_install>." #. type: textblock #: dh_auto_install:38 msgid "" +"For earlier compat levels then unless B<--destdir> option is specified, the " +"files are installed into debian/I<package>/ if there is only one binary " +"package. In the multiple binary package case, the files are instead " +"installed into F<debian/tmp/>, and should be moved from there to the " +"appropriate package build directory using L<dh_install(1)> or similar tools." +msgstr "" +"Para nÃveis de compatibilidade anteriores então a menos que a opção B<--" +"destdir> seja especificada, os ficheiros são instalados em debian/I<pacote>/ " +"se existir apenas um pacote binário. No caso de pacote de múltiplos " +"binários, em vez disso os ficheiros são instalados em F<debian/tmp/>, e " +"deverão ser movidos daà para o directório apropriado de compilação de pacote " +"usando o L<dh_install(1)> ou ferramentas semelhantes." + +#. type: textblock +#: dh_auto_install:44 +msgid "" "B<DESTDIR> is used to tell make where to install the files. If the Makefile " "was generated by MakeMaker from a F<Makefile.PL>, it will automatically set " "B<PREFIX=/usr> too, since such Makefiles need that." @@ -5420,7 +6052,7 @@ msgstr "" "disso." #. type: textblock -#: dh_auto_install:42 +#: dh_auto_install:48 msgid "" "This is intended to work for about 90% of packages. If it doesn't work, or " "tries to use the wrong install target, you're encouraged to skip using " @@ -5431,12 +6063,12 @@ msgstr "" "não usar o B<dh_auto_install>, e correr o make install manualmente." #. type: =item -#: dh_auto_install:53 dh_builddeb:38 +#: dh_auto_install:59 dh_builddeb:38 msgid "B<--destdir=>I<directory>" msgstr "B<--destdir=>I<directório>" #. type: textblock -#: dh_auto_install:55 +#: dh_auto_install:61 msgid "" "Install files into the specified I<directory>. If this option is not " "specified, destination directory is determined automatically as described in " @@ -5447,7 +6079,7 @@ msgstr "" "descrito na secção L</B<DESCRIÇÃO>>" #. type: textblock -#: dh_auto_install:61 +#: dh_auto_install:67 msgid "" "Pass I<params> to the program that is run, after the parameters that " "B<dh_auto_install> usually passes." @@ -5544,8 +6176,8 @@ msgstr "" "compilação de pacotes." #. type: =head1 -#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_gconf:26 dh_install:40 -#: dh_installcatalogs:39 dh_installchangelogs:47 dh_installcron:24 +#: dh_bugfiles:25 dh_clean:33 dh_compress:35 dh_install:40 +#: dh_installcatalogs:39 dh_installchangelogs:53 dh_installcron:24 #: dh_installdeb:25 dh_installdebconf:37 dh_installdirs:28 dh_installdocs:40 #: dh_installemacsen:30 dh_installexamples:31 dh_installifupdown:25 #: dh_installinfo:28 dh_installinit:41 dh_installinitramfs:30 @@ -5795,8 +6427,8 @@ msgstr "" "barra final. Qualquer conteúdo nestes directórios será também removido." #. type: textblock -#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:95 -#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:39 dh_installinfo:36 +#: dh_clean:44 dh_install:59 dh_installcatalogs:51 dh_installdeb:102 +#: dh_installdirs:40 dh_installdocs:48 dh_installexamples:43 dh_installinfo:36 #: dh_installman:81 dh_installwm:36 dh_link:64 msgid "" "Supports substitution variables in compat 13 and later as documented in " @@ -5806,7 +6438,7 @@ msgstr "" "documentado em L<debhelper(7)>." #. type: =item -#: dh_clean:53 dh_installchangelogs:75 +#: dh_clean:53 dh_installchangelogs:81 msgid "B<-k>, B<--keep>" msgstr "B<-k>, B<--keep>" @@ -5968,7 +6600,7 @@ msgstr "" "comandos em TODOS os pacotes que actua." #. type: =item -#: dh_compress:68 dh_installdocs:184 dh_installexamples:85 dh_installinfo:60 +#: dh_compress:68 dh_installdocs:184 dh_installexamples:89 dh_installinfo:60 #: dh_installmanpages:47 dh_movefiles:58 dh_testdir:30 msgid "I<file> ..." msgstr "I<ficheiro> ..." @@ -5979,7 +6611,7 @@ msgid "Add these files to the list of files to compress." msgstr "Adiciona estes ficheiros à lista de ficheiros para comprimir." #. type: =head1 -#: dh_compress:74 dh_perl:64 dh_strip:133 dh_usrlocal:66 +#: dh_compress:74 dh_perl:65 dh_strip:133 dh_usrlocal:66 msgid "CONFORMS TO" msgstr "EM CONFORMIDADE COM" @@ -6194,86 +6826,6 @@ msgstr "" "ficheiro, de terem as suas permissões alteradas. Você pode usar esta opção " "várias vezes para construir uma lista de coisas a excluir." -#. type: textblock -#: dh_gconf:5 -msgid "" -"dh_gconf - install GConf defaults files and register schemas (deprecated)" -msgstr "" -"dh_gconf - instala ficheiros de predefinições GConf e regista schemas " -"(descontinuado)" - -#. type: textblock -#: dh_gconf:17 -msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" -msgstr "B<dh_gconf> [S<I<debhelper opções>>] [B<--priority=>I<prioridade>]" - -#. type: textblock -#: dh_gconf:21 -msgid "" -"B<dh_gconf> is a debhelper program that is responsible for installing GConf " -"defaults files and registering GConf schemas." -msgstr "" -"B<dh_gconf> é um programa debhelper que é responsável por instalar ficheiros " -"de predefinições de GConf e registar os esquemas GConf." - -#. type: textblock -#: dh_gconf:24 -msgid "" -"An appropriate dependency on gconf2 will be generated in B<${misc:Depends}>." -msgstr "" -"Uma dependência apropriada em gconf2 será gerada em B<${misc:Depends}>." - -#. type: =item -#: dh_gconf:30 -msgid "debian/I<package>.gconf-defaults" -msgstr "debian/I<pacote>.gconf-defaults" - -#. type: textblock -#: dh_gconf:32 -msgid "" -"Installed into F<usr/share/gconf/defaults/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" -"Instalado em F<usr/share/gconf/defaults/10_pacote> no directório de " -"compilação do pacote, com I<pacote> substituÃdo pelo nome do pacote." - -#. type: =item -#: dh_gconf:35 -msgid "debian/I<package>.gconf-mandatory" -msgstr "debian/I<pacote>.gconf-mandatory" - -#. type: textblock -#: dh_gconf:37 -msgid "" -"Installed into F<usr/share/gconf/mandatory/10_package> in the package build " -"directory, with I<package> replaced by the package name." -msgstr "" -"Instalado em F<usr/share/gconf/mandatory/10_pacote> no directório de " -"compilação do pacote, com I<pacote> substituÃdo pelo nome do pacote." - -#. type: =item -#: dh_gconf:46 -msgid "B<--priority> I<priority>" -msgstr "B<--priority> I<prioridade>" - -#. type: textblock -#: dh_gconf:48 -msgid "" -"Use I<priority> (which should be a 2-digit number) as the defaults priority " -"instead of B<10>. Higher values than ten can be used by derived " -"distributions (B<20>), CDD distributions (B<50>), or site-specific packages " -"(B<90>)." -msgstr "" -"Usa I<prioridade> (que deve ser um número de dois dÃgitos) como a prioridade " -"predefinida em vez de B<10>. Valores mais altos que dez podem ser usados por " -"distribuições derivadas (B<20>), distribuições CDD (B<50>), ou pacotes " -"especÃficos de site (B<90>)." - -#. type: textblock -#: dh_gconf:113 -msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" -msgstr "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" - #. type: textblock #: dh_gencontrol:5 msgid "dh_gencontrol - generate and install control file" @@ -6383,7 +6935,7 @@ msgstr "" #. type: =item #: dh_icons:37 dh_installcatalogs:60 dh_installdebconf:68 dh_installemacsen:60 -#: dh_installinit:82 dh_installinitramfs:47 dh_installmenu:48 +#: dh_installinit:81 dh_installinitramfs:47 dh_installmenu:48 #: dh_installmodules:45 dh_installwm:51 dh_makeshlibs:147 dh_usrlocal:54 msgid "B<-n>, B<--no-scripts>" msgstr "B<-n>, B<--no-scripts>" @@ -6560,7 +7112,7 @@ msgstr "" "a documentação sobre esta opção." #. type: =item -#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:53 +#: dh_install:91 dh_installdirs:62 dh_installdocs:114 dh_installexamples:57 #: dh_installinfo:50 dh_installman:100 dh_movefiles:45 msgid "B<--sourcedir=>I<dir>" msgstr "B<--sourcedir=>I<directório>" @@ -6841,7 +7393,7 @@ msgstr "" "trigger de activação." #. type: textblock -#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:207 +#: dh_installcatalogs:69 dh_installemacsen:77 dh_installinit:206 #: dh_installmodules:59 dh_installudev:52 dh_installwm:68 dh_usrlocal:62 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " @@ -6871,16 +7423,20 @@ msgstr "" "directórios de compilação de pacotes." #. type: textblock -#: dh_installchangelogs:17 +#: dh_installchangelogs:18 +#, fuzzy +#| msgid "" +#| "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " +#| "[I<upstream>]" msgid "" "B<dh_installchangelogs> [S<I<debhelper options>>] [B<-k>] [B<-X>I<item>] " -"[I<upstream>]" +"[B<--no-trim>] [I<upstream>]" msgstr "" "B<dh_installchangelogs> [S<I<debhelper opções>>] [B<-k>] [B<-X>I<item>] " "[I<upstream>]" #. type: textblock -#: dh_installchangelogs:21 +#: dh_installchangelogs:22 msgid "" "B<dh_installchangelogs> is a debhelper program that is responsible for " "installing changelogs into package build directories." @@ -6890,7 +7446,7 @@ msgstr "" "de pacotes." #. type: textblock -#: dh_installchangelogs:24 +#: dh_installchangelogs:25 msgid "" "An upstream F<changelog> file may be specified as an option. If none is " "specified, B<dh_installchangelogs> may look for files with names that seem " @@ -6902,7 +7458,7 @@ msgstr "" "alterações como descrito nos próximos parágrafos." #. type: textblock -#: dh_installchangelogs:28 +#: dh_installchangelogs:29 msgid "" "In non-native packages, B<dh_installchangelogs> will first look for " "changelog files installed by the upstream build system into F<< usr/share/" @@ -6927,7 +7483,7 @@ msgstr "" "opcionalmente com extensões comuns (tais como F<.txt>, F<.md> e F<.rst>)." #. type: textblock -#: dh_installchangelogs:40 +#: dh_installchangelogs:41 msgid "" "If a changelog file is specified and is an F<html> file (determined by file " "extension), it will be installed as F<usr/share/doc/package/changelog.html> " @@ -6944,28 +7500,37 @@ msgstr "" "um curto F<usr/share/doc/package/changelog>, apontando os leitores para o " "ficheiro de relatório em html." +#. type: textblock +#: dh_installchangelogs:48 +msgid "" +"The B<debchange>-style Debian changelogs are trimmed to include only entries " +"more recent than the release date of I<oldstable>. No trimming will be " +"performed if the B<--no-trim> option is passed or if the " +"B<DEB_BUILD_OPTIONS> environment variable contains B<notrimdch>." +msgstr "" + #. type: =item -#: dh_installchangelogs:51 +#: dh_installchangelogs:57 msgid "F<debian/changelog>" msgstr "F<debian/changelog>" #. type: =item -#: dh_installchangelogs:53 +#: dh_installchangelogs:59 msgid "F<debian/NEWS>" msgstr "F<debian/NEWS>" #. type: =item -#: dh_installchangelogs:55 +#: dh_installchangelogs:61 msgid "debian/I<package>.changelog" msgstr "debian/I<pacote>.changelog" #. type: =item -#: dh_installchangelogs:57 +#: dh_installchangelogs:63 msgid "debian/I<package>.NEWS" msgstr "debian/I<pacote>.NEWS" #. type: textblock -#: dh_installchangelogs:59 +#: dh_installchangelogs:65 msgid "" "Automatically installed into usr/share/doc/I<package>/ in the package build " "directory." @@ -6974,7 +7539,7 @@ msgstr "" "compilação do pacote." #. type: textblock -#: dh_installchangelogs:62 +#: dh_installchangelogs:68 msgid "" "Use the package specific name if I<package> needs a different F<NEWS> or " "F<changelog> file." @@ -6983,7 +7548,7 @@ msgstr "" "F<NEWS> ou F<changelog> diferente." #. type: textblock -#: dh_installchangelogs:65 +#: dh_installchangelogs:71 msgid "" "The F<changelog> file is installed with a name of changelog for native " "packages, and F<changelog.Debian> for non-native packages. The F<NEWS> file " @@ -6994,7 +7559,7 @@ msgstr "" "F<NOTICIAS> é sempre instalado com o nome F<NEWS.Debian>." #. type: textblock -#: dh_installchangelogs:77 +#: dh_installchangelogs:83 msgid "" "Keep the original name of the upstream changelog. This will be accomplished " "by installing the upstream changelog as F<changelog>, and making a symlink " @@ -7010,7 +7575,7 @@ msgstr "" "F<changelog>." #. type: textblock -#: dh_installchangelogs:85 +#: dh_installchangelogs:91 msgid "" "Exclude upstream F<changelog> files that contain I<item> anywhere in their " "filename from being installed." @@ -7019,18 +7584,32 @@ msgstr "" "ponto do seu nome de ficheiro, de serem instalados." #. type: textblock -#: dh_installchangelogs:88 +#: dh_installchangelogs:94 msgid "Note that directory name of the changelog is also part of the match." msgstr "" "Note que o nome de directório do changelog é também parte correspondente." #. type: =item -#: dh_installchangelogs:90 +#: dh_installchangelogs:96 +#, fuzzy +#| msgid "B<--no-start>" +msgid "B<--no-trim>" +msgstr "B<--no-start>" + +#. type: textblock +#: dh_installchangelogs:98 +msgid "" +"Install the full changelog, not its trimmed version that includes only " +"recent entries." +msgstr "" + +#. type: =item +#: dh_installchangelogs:101 msgid "I<upstream>" msgstr "I<upstream>" #. type: textblock -#: dh_installchangelogs:92 +#: dh_installchangelogs:103 msgid "Install this file as the upstream changelog." msgstr "" "Instala este ficheiro como o registo de alterações (changelog) da origem." @@ -7071,16 +7650,21 @@ msgstr "debian/I<pacote>.cron.monthly" #. type: =item #: dh_installcron:34 +msgid "debian/I<package>.cron.yearly" +msgstr "debian/I<pacote>.cron.yearly" + +#. type: =item +#: dh_installcron:36 msgid "debian/I<package>.cron.hourly" msgstr "debian/I<pacote>.cron.hourly" #. type: =item -#: dh_installcron:36 +#: dh_installcron:38 msgid "debian/I<package>.cron.d" msgstr "debian/I<pacote>.cron.d" #. type: textblock -#: dh_installcron:38 +#: dh_installcron:40 msgid "" "Installed into the appropriate F<etc/cron.*/> directory in the package build " "directory." @@ -7089,14 +7673,14 @@ msgstr "" "compilação do pacote." #. type: =item -#: dh_installcron:47 dh_installifupdown:46 dh_installinit:175 +#: dh_installcron:49 dh_installifupdown:46 dh_installinit:174 #: dh_installlogcheck:49 dh_installlogrotate:29 dh_installmodules:49 -#: dh_installpam:38 dh_installppp:42 dh_installudev:38 dh_systemd_enable:95 +#: dh_installpam:42 dh_installppp:42 dh_installudev:38 dh_systemd_enable:94 msgid "B<--name=>I<name>" msgstr "B<--name=>I<nome>" #. type: textblock -#: dh_installcron:49 +#: dh_installcron:51 msgid "" "Look for files named F<debian/package.name.cron.*> and install them as F<etc/" "cron.*/name>, instead of using the usual files and installing them as the " @@ -7207,25 +7791,24 @@ msgstr "I<pacote>.conffiles" #. type: textblock #: dh_installdeb:59 msgid "" -"Historically, this file was needed to manually mark files files as " -"conffiles. However, it has become de facto obsolete since debhelper " -"automatically computed which files should be marked as conffiles." +"This file will be installed into the F<DEBIAN> directory. The provided file " +"will be enriched by debhelper to include all the B<conffiles> auto-detected " +"by debhelper (the maintainer should not list there as debhelper assumes it " +"should handle that part)." msgstr "" -"Historicamente, este ficheiro era preciso para marcar manualmente ficheiros " -"como ficheiros de configuração (conffiles). No entanto, tem-se tornado de " -"facto obsoleto desde que o debhelper passou a computar automaticamente quais " -"os ficheiros devem ser marcados como ficheiros de configuração." +"este ficheiro será instalado no directório F<DEBIAN>. O ficheiro fornecido " +"será enriquecido pelo debhelper para incluir todos os B<conffiles> auto-" +"detetados pelo debhelper (o responsável deve estar listado lá pois o " +"debhelper assume que deve lidar com essa parte.)" #. type: textblock -#: dh_installdeb:63 +#: dh_installdeb:64 msgid "" -"In compatibility level up and including 11, this control file will be " -"installed into the F<DEBIAN> directory. In compatibility level 12 and " -"later, the file is silently ignored." +"This file is primarily useful for using \"special\" entries such as the B<< " +"remove-on-upgrade >> feature from dpkg." msgstr "" -"Em nÃvel de compatibilidade até e incluindo 11, este ficheiro de controle " -"será instalado no directório F<DEBIAN>. Em nÃvel de compatibilidade 12 e " -"posterior, o ficheiro é ignorado em silêncio." +"Este ficheiro é principalmente útil para usar entradas \"especiais\" tais " +"como a funcionalidade B<< remove-on-upgrade >> do dpkg." #. type: =item #: dh_installdeb:67 @@ -7302,13 +7885,29 @@ msgstr "" "activada como um aviso desde compatibilidade 10 e como um erro a resolver na " "compatibilidade 12." +#. type: textblock +#: dh_installdeb:95 +msgid "" +"Where possible, B<dh_installdeb> may choose to rewrite some or all of the " +"entries into equivalent features supported in dpkg without relying on " +"maintainer scripts at its sole discretion (examples include rewriting " +"B<rm_conffile> into dpkg's B<remove-on-upgrade>). The minimum requirement " +"for activating this feature is that debhelper runs in compat 10 or later." +msgstr "" +"Onde possÃvel, o B<dh_installdeb> pode escolher rescrever algumas ou todas " +"as entradas em funcionalidades equivalentes suportadas no dpkg sem se apoiar " +"nos scripts do maintainer scripts a seu exclusivo critério (exemplos " +"incluem rescrever B<rm_conffile> em B<remove-on-upgrade> do dpkg). O " +"requerimento mÃnimo para activar esta funcionalidade é que o debhelper " +"corra em compatibilidade 10 ou posterior." + #. type: =item -#: dh_installdeb:104 +#: dh_installdeb:111 dh_installdebconf:76 msgid "B<-D>I<TOKEN=VALUE>, B<--define> I<TOKEN=VALUE>" msgstr "B<-D>I<TOKEN=VALUE>, B<--define> I<TOKEN=VALUE>" #. type: textblock -#: dh_installdeb:106 +#: dh_installdeb:113 dh_installdebconf:78 msgid "" "Define tokens to be replaced inside the maintainer scripts when it is " "generated. Please note that the limitations described in L</Limitations in " @@ -7321,7 +7920,7 @@ msgstr "" "Nomes de tokens inválidos irão despoletar um erro." #. type: textblock -#: dh_installdeb:111 +#: dh_installdeb:118 dh_installdebconf:83 msgid "" "In the simple case, this parameter will cause B<< #I<TOKEN># >> to be " "replaced by I<VALUE>. If I<VALUE> starts with a literal I<@>-sign, then " @@ -7334,7 +7933,7 @@ msgstr "" "a inserir." #. type: textblock -#: dh_installdeb:116 +#: dh_installdeb:123 dh_installdebconf:88 msgid "" "An explicit declared token with this parameter will replace built-in tokens." msgstr "" @@ -7342,12 +7941,12 @@ msgstr "" "embutidos." #. type: textblock -#: dh_installdeb:119 +#: dh_installdeb:126 dh_installdebconf:91 msgid "Test examples to aid with the understanding:" msgstr "Exemplos de testes para ajuda na compreensão:" #. type: verbatim -#: dh_installdeb:121 +#: dh_installdeb:128 #, no-wrap msgid "" "\tcat >> debian/postinst <<EOF\n" @@ -7367,7 +7966,7 @@ msgstr "" "\n" #. type: textblock -#: dh_installdeb:128 +#: dh_installdeb:135 dh_installdebconf:100 msgid "" "In this example, B<#SIMPLE#> will expand to B<direct> and B<#FILEBASED#> " "will expand to B<Complex value>." @@ -7376,7 +7975,7 @@ msgstr "" "expandir para B<Complex value>." #. type: textblock -#: dh_installdeb:131 +#: dh_installdeb:138 msgid "" "It is also possible to set package-specific values for a given token. This " "is useful when B<dh_installdeb> is acting on multiple packages that need " @@ -7389,12 +7988,12 @@ msgstr "" "o nome do token com B<< pkg.I<nome-do-pacote>. >>." #. type: textblock -#: dh_installdeb:136 +#: dh_installdeb:143 dh_installdebconf:108 msgid "This can be used as in the following example:" msgstr "Isto pode ser usado como no exemplo seguinte:" #. type: verbatim -#: dh_installdeb:138 +#: dh_installdeb:145 #, no-wrap msgid "" "\tcat >> debian/foo.postinst <<EOF\n" @@ -7430,7 +8029,7 @@ msgstr "" "\n" #. type: textblock -#: dh_installdeb:153 +#: dh_installdeb:160 msgid "" "In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." "postinst>, to B<unique-bar-value> in F<debian/bar.postinst> and to B<unique-" @@ -7441,7 +8040,7 @@ msgstr "" "B<unique-baz-value> em F<debian/baz.postinst>." #. type: textblock -#: dh_installdeb:157 +#: dh_installdeb:164 msgid "" "Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." "g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.postinst> and it " @@ -7452,12 +8051,12 @@ msgstr "" "postinst> e ele será substituÃdo por B<unique-bar-value>." #. type: =head1 -#: dh_installdeb:163 +#: dh_installdeb:170 dh_installdebconf:135 msgid "SUBSTITUTION IN MAINTAINER SCRIPTS" msgstr "SUBSTITUIÇÃO EM SCRIPTS DE MAINTAINER" #. type: textblock -#: dh_installdeb:165 +#: dh_installdeb:172 msgid "" "The B<dh_installdeb> will automatically replace the following tokens inside " "a provided maintainer script (if not replaced via B<-D>/B<--define>):" @@ -7467,12 +8066,12 @@ msgstr "" "D>/B<--define>):" #. type: =item -#: dh_installdeb:170 +#: dh_installdeb:177 msgid "#DEBHELPER#" msgstr "#DEBHELPER#" #. type: textblock -#: dh_installdeb:172 +#: dh_installdeb:179 msgid "" "This token is by default replaced with generated shell snippets debhelper " "commands. This includes the snippets generated by B<dh_installdeb> from " @@ -7483,12 +8082,12 @@ msgstr "" "partir do ficheiro I<package>.maintscript (se presente)." #. type: =item -#: dh_installdeb:176 +#: dh_installdeb:183 dh_installdebconf:142 msgid "#DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME>#" msgstr "#DEB_HOST_I<NAME>#, #DEB_BUILD_I<NAME>#, #DEB_TARGET_I<NAME>#" #. type: textblock -#: dh_installdeb:178 +#: dh_installdeb:185 dh_installdebconf:144 msgid "" "These tokens are replaced with the respective variable from L<dpkg-" "architecture(1)>. In almost all cases, you will want use the B<< " @@ -7501,7 +8100,7 @@ msgstr "" "correcto quando faz compilação cruzada." #. type: textblock -#: dh_installdeb:183 +#: dh_installdeb:190 dh_installdebconf:149 msgid "" "On a best effort, tokens of this pattern that do not match a variable in " "L<dpkg-architecture(1)> will be left as-is." @@ -7510,12 +8109,12 @@ msgstr "" "variável em L<dpkg-architecture(1)> serão deixá-dos como estão." #. type: =item -#: dh_installdeb:186 +#: dh_installdeb:193 dh_installdebconf:152 msgid "#ENV.I<NAME>#" msgstr "#ENV.I<NAME>#" #. type: textblock -#: dh_installdeb:188 +#: dh_installdeb:195 dh_installdebconf:154 msgid "" "These tokens of this form will be replaced with value of the corresponding " "environment variable. If the environment variable is unset, the token is " @@ -7526,7 +8125,7 @@ msgstr "" "token é substituÃdo pela string vazia." #. type: textblock -#: dh_installdeb:193 +#: dh_installdeb:200 dh_installdebconf:159 msgid "" "Note that there are limits on which names can be used (see L</Limitations in " "token names>)." @@ -7535,12 +8134,12 @@ msgstr "" "nos nomes dos token>)." #. type: =item -#: dh_installdeb:196 +#: dh_installdeb:203 dh_installdebconf:162 msgid "#PACKAGE#" msgstr "#PACKAGE#" #. type: textblock -#: dh_installdeb:198 +#: dh_installdeb:205 dh_installdebconf:164 msgid "" "This token is by default replaced by the package name, which will contain " "the concrete script." @@ -7549,12 +8148,12 @@ msgstr "" "conter o script concreto." #. type: =head2 -#: dh_installdeb:203 +#: dh_installdeb:210 dh_installdebconf:169 msgid "Limitations in token names" msgstr "Limitações nos nomes dos token" #. type: textblock -#: dh_installdeb:205 +#: dh_installdeb:212 dh_installdebconf:171 msgid "" "All tokens intended to be substituted must match the regex: #[A-Za-z0-9_.+]+#" msgstr "" @@ -7562,7 +8161,7 @@ msgstr "" "regex: #[A-Za-z0-9_.+]+#" #. type: textblock -#: dh_installdeb:207 +#: dh_installdeb:214 msgid "" "Tokens that do not match that regex will be silently ignored if found in the " "script template. Invalid token names passed to B<-D> or B<--define> will " @@ -7703,6 +8302,124 @@ msgstr "Não modifique o script F<postrm>." msgid "Pass the params to B<po2debconf>." msgstr "Passa os params para B<po2debconf>." +#. type: verbatim +#: dh_installdebconf:93 +#, no-wrap +msgid "" +"\tcat >> debian/config <<EOF\n" +"\t#SIMPLE#\n" +"\t#FILEBASED#\n" +"\tEOF\n" +"\techo -n \"Complex value\" > some-file\n" +" dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +"\n" +msgstr "" +"\tcat >> debian/config <<EOF\n" +"\t#SIMPLE#\n" +"\t#FILEBASED#\n" +"\tEOF\n" +"\techo -n \"Complex value\" > some-file\n" +" dh_installdeb --define SIMPLE=direct --define FILEBASED=@some-file\n" +"\n" + +#. type: textblock +#: dh_installdebconf:103 +msgid "" +"It is also possible to set package-specific values for a given token. This " +"is useful when B<dh_installdebconf> is acting on multiple packages that need " +"different values for the same token. This is done by prefixing the token " +"name with B<< pkg.I<package-name>. >>." +msgstr "" +"É também possÃvel definir valores especÃficos-de-pacote para um dado token. " +"Isto é útil quando B<dh_installdebconf> está a actuar em múltiplos pacotes " +"que precisam de valores diferentes para o mesmo token. Isto é feito ao " +"prefixar o nome do token com B<< pkg.I<nome-do-pacote>. >>." + +#. type: verbatim +#: dh_installdebconf:110 +#, no-wrap +msgid "" +"\tcat >> debian/foo.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/bar.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/baz.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +" dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \\\n" +" --define pkg.baz.TOKEN=unique-baz-value\n" +"\n" +msgstr "" +"\tcat >> debian/foo.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/bar.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +"\tcat >> debian/baz.config <<EOF\n" +"\t# Script for #PACKAGE#\n" +"\t#TOKEN#\n" +"\tEOF\n" +" dh_installdebconf -pfoo -pbar -pbaz --define TOKEN=default --define pkg.bar.TOKEN=unique-bar-value \\\n" +" --define pkg.baz.TOKEN=unique-baz-value\n" +"\n" + +#. type: textblock +#: dh_installdebconf:125 +#, fuzzy +#| msgid "" +#| "In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." +#| "config>, to B<unique-bar-value> in F<debian/bar.v> and to B<unique-baz-" +#| "value> in F<debian/baz.config>." +msgid "" +"In this example, B<#TOKEN#> will expand to B<default> in F<debian/foo." +"config>, to B<unique-bar-value> in F<debian/bar.config> and to B<unique-baz-" +"value> in F<debian/baz.config>." +msgstr "" +"Neste exemplo, B<#TOKEN#> irá expandir para B<default> em F<debian/foo." +"config>, para B<unique-bar-value> em F<debian/bar.v> e para B<unique-baz-" +"value> em F<debian/baz.config>." + +#. type: textblock +#: dh_installdebconf:129 +msgid "" +"Note that the B<#pkg.*#> tokens will be visible in all scripts acted on. E." +"g. you can refer to B<#pkg.bar.TOKEN#> inside F<debian/foo.config> and it " +"will be replaced by B<unique-bar-value>." +msgstr "" +"Note que os tokens B<#pkg.*#> irão ser visÃveis em todos os scripts que " +"actuem. Ex, você pode referir a B<#pkg.bar.TOKEN#> dentro de F<debian/foo." +"config> e ele será substituÃdo por B<unique-bar-value>." + +#. type: textblock +#: dh_installdebconf:137 +msgid "" +"The B<dh_installdebconf> will automatically replace the following tokens " +"inside a provided maintainer script (if not replaced via B<-D>/B<--define>):" +msgstr "" +"O B<dh_installdebconf> irá substituir automaticamente os seguintes tokens " +"dentro de um script disponibilizado pelo maintainer (se não for substituÃdo " +"via B<-D>/B<--define>):" + +#. type: textblock +#: dh_installdebconf:173 +msgid "" +"Tokens that do not match that regex will be silently ignored if found in the " +"script template. Invalid token names passed to B<-D> or B<--define> will " +"cause B<dh_installdebconf> to reject the command with an error in most cases." +msgstr "" +"Tokens que não correspondam a esse regex serão ignorados em silêncio se " +"encontrados no script modelo. Nomes de token inválidos passados a B<-D> ou " +"B<--define> irão causar que o B<dh_installdebconf> rejeite o comando com um " +"erro na maioria dos casos." + #. type: textblock #: dh_installdirs:5 msgid "dh_installdirs - create subdirectories in package build directories" @@ -8038,7 +8755,7 @@ msgstr "" "seu nome de ficheiro. Note que isto inclui ficheiros baseados em doc." #. type: textblock -#: dh_installdocs:116 dh_installexamples:55 dh_installinfo:52 dh_installman:102 +#: dh_installdocs:116 dh_installexamples:59 dh_installinfo:52 dh_installman:102 msgid "" "Look in the specified directory for files to be installed. This option " "requires compat 11 or later (it is silently ignored in compat 10 or earlier)." @@ -8061,12 +8778,12 @@ msgstr "" "tmp> no nÃvel de compatibilidade 11 e superiores do debhelper." #. type: =item -#: dh_installdocs:124 dh_installexamples:63 +#: dh_installdocs:124 dh_installexamples:67 msgid "B<--doc-main-package=>I<main-package>" msgstr "B<--doc-main-package=>I<main-package>" #. type: textblock -#: dh_installdocs:126 dh_installexamples:65 +#: dh_installdocs:126 dh_installexamples:69 msgid "" "Set the main package for a documentation package. This is used to install " "the documentation of the documentation package in F<< /usr/share/doc/I<main-" @@ -8077,7 +8794,7 @@ msgstr "" ">> como recomendado pelo manual de polÃticas Debian 3.9.7 em §12.3." #. type: textblock -#: dh_installdocs:131 dh_installexamples:70 +#: dh_installdocs:131 dh_installexamples:74 msgid "" "In compat 11 (or later), this option is only useful if debhelper's auto-" "detection of the main package is wrong. The option can also be used to " @@ -8425,7 +9142,16 @@ msgid "Lists example files or directories to be installed." msgstr "Lista ficheiros ou directórios exemplo para serem instalados." #. type: textblock -#: dh_installexamples:50 +#: dh_installexamples:39 +msgid "" +"If upstream provides an F<examples> directory, you will often want to use " +"B<examples/*> rather than B<examples> in this file. The latter would create " +"F<< /usr/share/doc/I<package>/examples/examples >>, which is rarely what you " +"want." +msgstr "" + +#. type: textblock +#: dh_installexamples:54 msgid "" "Install any files specified by command line parameters in ALL packages acted " "on." @@ -8434,7 +9160,7 @@ msgstr "" "comandos em TODOS os pacotes em que actua." #. type: textblock -#: dh_installexamples:58 +#: dh_installexamples:62 msgid "" "Note that this is not the same as the B<--sourcedirectory> option used by " "the B<dh_auto_>I<*> commands. You rarely need to use this option, since " @@ -8447,7 +9173,7 @@ msgstr "" "F<debian/tmp> no nÃvel de compatibilidade 11 e superiores do debhelper." #. type: textblock -#: dh_installexamples:75 +#: dh_installexamples:79 msgid "" "This option cannot be used when B<dh_installexamples> is instructed to act " "on multiple packages. If you need this option, you will generally need to " @@ -8459,7 +9185,7 @@ msgstr "" "actuado." #. type: textblock -#: dh_installexamples:82 +#: dh_installexamples:86 msgid "" "Exclude files that contain I<item> anywhere in their filename from being " "installed." @@ -8468,7 +9194,7 @@ msgstr "" "seu nome de ficheiro." #. type: textblock -#: dh_installexamples:87 +#: dh_installexamples:91 msgid "" "Install these files (or directories) as examples into the first package " "acted on. (Or into all packages if B<-A> is specified.)" @@ -8477,7 +9203,7 @@ msgstr "" "que actua. (Ou em todos os pacotes se for especificado B<-A>)." #. type: textblock -#: dh_installexamples:94 +#: dh_installexamples:98 msgid "" "Note that B<dh_installexamples> will happily copy entire directory " "hierarchies if you ask it to (similar to B<cp -a>). If it is asked to " @@ -8727,11 +9453,12 @@ msgstr "debian/I<pacote>.service" #. type: textblock #: dh_installinit:67 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"in the package build directory. Only used in compat levels 10 and below." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> in the package build directory. Only used in compat levels 10 and " +"below." msgstr "" -"Se isto existir, é instalado em lib/systemd/system/I<pacote>.service no " -"directório de compilação do pacote. Apenas usado nos nÃveis de " +"Se isto existir, é instalado em F<< lib/systemd/system/I<pacote>.service >> " +"no directório de compilação do pacote. Apenas usado nos nÃveis de " "compatibilidade 10 e inferiores." #. type: =item @@ -8743,26 +9470,24 @@ msgstr "debian/I<pacote>.tmpfile" #: dh_installinit:72 msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.) Only used in compat levels 10 and below." +"the package build directory. Only used in compat levels 10 and below." msgstr "" "Se isto existir, é instalado em usr/lib/tmpfiles.d/I<pacote>.conf no " -"directório de compilação do pacote. (Actualmente o mecanismo tmpfiles.d é " -"usado apenas pelo systemd.) Apenas usado nos nÃveis de compatibilidade 10 e " -"inferiores." +"directório de compilação do pacote. Apenas usado nos nÃveis de " +"compatibilidade 10 e inferiores." #. type: textblock -#: dh_installinit:84 +#: dh_installinit:83 msgid "Do not modify F<postinst>/F<postrm>/F<prerm> scripts." msgstr "Não modifique os scripts F<postinst>/F<postrm>/F<prerm>." #. type: =item -#: dh_installinit:86 +#: dh_installinit:85 msgid "B<-o>, B<--only-scripts>" msgstr "B<-o>, B<--only-scripts>" #. type: textblock -#: dh_installinit:88 +#: dh_installinit:87 msgid "" "Only modify F<postinst>/F<postrm>/F<prerm> scripts, do not actually install " "any init script, default files, upstart job or systemd service file. May be " @@ -8776,7 +9501,7 @@ msgstr "" "fácil deixar o B<dh_installinit> encontrá-lo." #. type: textblock -#: dh_installinit:93 +#: dh_installinit:92 msgid "" "B<Caveat>: This will bypass all the regular checks and I<unconditionally> " "modify the scripts. You will almost certainly want to use this with B<-p> " @@ -8788,7 +9513,7 @@ msgstr "" "chamada. Exemplo:" #. type: verbatim -#: dh_installinit:98 +#: dh_installinit:97 #, no-wrap msgid "" " override_dh_installinit:\n" @@ -8802,12 +9527,12 @@ msgstr "" "\n" #. type: =item -#: dh_installinit:102 +#: dh_installinit:101 msgid "B<-R>, B<--restart-after-upgrade>" msgstr "B<-R>, B<--restart-after-upgrade>" #. type: textblock -#: dh_installinit:104 +#: dh_installinit:103 msgid "" "Do not stop the init script until after the package upgrade has been " "completed. This is the default behaviour in compat 10." @@ -8816,7 +9541,7 @@ msgstr "" "completa. Este é o comportamento predefinido no nÃvel compatibilidade 10." #. type: textblock -#: dh_installinit:107 +#: dh_installinit:106 msgid "" "In early compat levels, the default was to stop the script in the F<prerm>, " "and starts it again in the F<postinst>." @@ -8825,7 +9550,7 @@ msgstr "" "em F<prerm>, e depois arrancá-lo de novo no F<postinst>." #. type: textblock -#: dh_installinit:110 dh_systemd_start:45 +#: dh_installinit:109 dh_systemd_start:45 msgid "" "This can be useful for daemons that should not have a possibly long downtime " "during upgrade. But you should make sure that the daemon will not get " @@ -8838,12 +9563,12 @@ msgstr "" "actualizado enquanto ele está a correr antes de usar esta opção." #. type: =item -#: dh_installinit:115 dh_systemd_start:50 +#: dh_installinit:114 dh_systemd_start:50 msgid "B<--no-restart-after-upgrade>" msgstr "B<--no-restart-after-upgrade>" #. type: textblock -#: dh_installinit:117 dh_systemd_start:52 +#: dh_installinit:116 dh_systemd_start:52 msgid "" "Undo a previous B<--restart-after-upgrade> (or the default of compat 10). " "If no other options are given, this will cause the service to be stopped in " @@ -8855,12 +9580,12 @@ msgstr "" "F<postinst>." #. type: =item -#: dh_installinit:122 dh_systemd_start:57 +#: dh_installinit:121 dh_systemd_start:57 msgid "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" msgstr "B<-r>, B<--no-stop-on-upgrade>, B<--no-restart-on-upgrade>" #. type: textblock -#: dh_installinit:124 +#: dh_installinit:123 msgid "" "Do not stop init script on upgrade. This has the side-effect of not " "restarting the service as a part of the upgrade." @@ -8869,7 +9594,7 @@ msgstr "" "reiniciar o serviço como parte da actualização." #. type: textblock -#: dh_installinit:127 +#: dh_installinit:126 msgid "" "If you want to restart the service with minimal downtime, please use B<--" "restart-after-upgrade> (default in compat 10 or later). If you want the " @@ -8883,7 +9608,7 @@ msgstr "" "(repare no \"after-upgrade\")." #. type: textblock -#: dh_installinit:132 +#: dh_installinit:131 msgid "" "Note that the B<--no-restart-on-upgrade> alias is deprecated and will be " "removed in compat 12. This is to avoid confusion with the B<--no-restart-" @@ -8896,12 +9621,12 @@ msgstr "" "introduzida no debhelper 10.2 (incluÃdo em Debian stretch)." #. type: =item -#: dh_installinit:137 dh_systemd_start:61 +#: dh_installinit:136 dh_systemd_start:61 msgid "B<--no-start>" msgstr "B<--no-start>" #. type: textblock -#: dh_installinit:139 +#: dh_installinit:138 msgid "" "Do not start the init script on install or upgrade, or stop it on removal. " "Only call B<update-rc.d>. Useful for rcS scripts." @@ -8910,12 +9635,12 @@ msgstr "" "para durante a remoção. Apenas chama B<update-rc.d>. Útil para scripts rcS." #. type: =item -#: dh_installinit:142 dh_systemd_enable:87 +#: dh_installinit:141 dh_systemd_enable:86 msgid "B<--no-enable>" msgstr "B<--no-enable>" #. type: textblock -#: dh_installinit:144 +#: dh_installinit:143 msgid "" "Disable the init script on purge, but do not enable them on install. This " "implies a versioned dependency on B<< init-system-helpers (E<gt>= 1.51) >> " @@ -8928,7 +9653,7 @@ msgstr "" "E<lt>scriptE<gt> defaults-disabled >>." #. type: textblock -#: dh_installinit:149 +#: dh_installinit:148 msgid "" "B<Note> that this option does not affect whether the services are started. " "Please remember to also use B<--no-start> if the service should not be " @@ -8938,7 +9663,7 @@ msgstr "" "lembre-se de também usar B<--no-start> se o serviço não deverá ser arrancado." #. type: textblock -#: dh_installinit:153 +#: dh_installinit:152 msgid "" "Cannot be combined with B<-u>I<params>, B<--update-rcd-params=>I<params>, or " "B<--> I<params>." @@ -8947,13 +9672,13 @@ msgstr "" "ou B<--> I<params>." #. type: =item -#: dh_installinit:156 +#: dh_installinit:155 msgid "B<-d>, B<--remove-d>" msgstr "B<-d>, B<--remove-d>" # FIXME s#F<etc/default/>.#F<etc/default/>.# #. type: textblock -#: dh_installinit:158 +#: dh_installinit:157 msgid "" "Remove trailing B<d> from the name of the package, and use the result for " "the filename the upstart job file is installed as in F<etc/init/> , and for " @@ -8970,12 +9695,12 @@ msgstr "" "parâmetro B<--init-script> descrito em baixo)." #. type: =item -#: dh_installinit:165 +#: dh_installinit:164 msgid "B<-u>I<params> B<--update-rcd-params=>I<params>" msgstr "B<-u>I<params> B<--update-rcd-params=>I<params>" #. type: textblock -#: dh_installinit:169 +#: dh_installinit:168 msgid "" "Pass I<params> to L<update-rc.d(8)>. If not specified, B<defaults> (or " "B<defaults-disabled> with B<--no-enable>) will be passed to L<update-rc." @@ -8986,12 +9711,12 @@ msgstr "" "d(8)>." #. type: textblock -#: dh_installinit:173 +#: dh_installinit:172 msgid "Cannot be combined with B<--no-enable>." msgstr "Não pode ser combinado com B<--no-enable>." #. type: textblock -#: dh_installinit:177 +#: dh_installinit:176 msgid "" "Install the init script (and default file) as well as upstart job file using " "the filename I<name> instead of the default filename, which is the package " @@ -9009,12 +9734,12 @@ msgstr "" "package.upstart>." #. type: =item -#: dh_installinit:185 +#: dh_installinit:184 msgid "B<--init-script=>I<scriptname>" msgstr "B<--init-script=>I<nome-do-script>" #. type: textblock -#: dh_installinit:187 +#: dh_installinit:186 msgid "" "Use I<scriptname> as the filename the init script is installed as in F<etc/" "init.d/> (and also use it as the filename for the defaults file, if it is " @@ -9031,7 +9756,7 @@ msgstr "" "de iniciação em preferência dos ficheiros que normalmente instala." #. type: textblock -#: dh_installinit:194 +#: dh_installinit:193 msgid "" "This parameter is deprecated, use the B<--name> parameter instead. This " "parameter is incompatible with the use of upstart jobs." @@ -9040,12 +9765,12 @@ msgstr "" "Este parâmetro é incompatÃvel com o uso de tarefas upstart." #. type: =item -#: dh_installinit:197 +#: dh_installinit:196 msgid "B<--error-handler=>I<function>" msgstr "B<--error-handler=>I<função>" #. type: textblock -#: dh_installinit:199 +#: dh_installinit:198 msgid "" "Call the named shell I<function> if running the init script fails. The " "function should be provided in the F<prerm> and F<postinst> scripts, before " @@ -9056,17 +9781,17 @@ msgstr "" "F<postinst>, antes do token B<#DEBHELPER#>." #. type: textblock -#: dh_installinit:432 +#: dh_installinit:415 msgid "L<debhelper(7)>, L<dh_installsystemd(1)>" msgstr "L<debhelper(7)>, L<dh_installsystemd(1)>" #. type: textblock -#: dh_installinit:440 +#: dh_installinit:423 msgid "Steve Langasek <steve.langasek@canonical.com>" msgstr "Steve Langasek <steve.langasek@canonical.com>" #. type: textblock -#: dh_installinit:442 +#: dh_installinit:425 msgid "Michael Stapelberg <stapelberg@debian.org>" msgstr "Michael Stapelberg <stapelberg@debian.org>" @@ -9819,20 +10544,32 @@ msgstr "debian/I<pacote>.pam" #. type: textblock #: dh_installpam:30 -msgid "Installed into etc/pam.d/I<package> in the package build directory." +msgid "Installed into usr/lib/pam.d/I<package> in the package build directory." msgstr "" -"Instalado em etc/pam.d/I<pacote> no directório de compilação do pacote." +"Instalado em usr/lib/pam.d/I<pacote> no directório de compilação do pacote." #. type: textblock -#: dh_installpam:40 +#: dh_installpam:32 msgid "" -"Look for files named debian/I<package>.I<name>.pam and install them as etc/" -"pam.d/I<name>, instead of using the usual files and installing them using " -"the package name." +"Until compatibility level 14 this file was installed under etc/pam.d/" +"I<package>. Please consider using the \"rm_conffile\" feature from " +"L<dh_installdeb(1)> to ensure the proper removal of previous PAM files." +msgstr "" +"Ate ao nÃvel de compatibilidade 14 este ficheiro era instalado sob etc/pam.d/" +"I<pacote>. Por favor considere usar a funcionalidade \"rm_conffile\" do " +"L<dh_installdeb(1)> para assegurar a remoção apropriada dos ficheiros PAM " +"anteriores." + +#. type: textblock +#: dh_installpam:44 +msgid "" +"Look for files named debian/I<package>.I<name>.pam and install them as usr/" +"lib/pam.d/I<name>, instead of using the usual files and installing them " +"using the package name." msgstr "" "Procura ficheiros chamados debian/I<pacote>.I<nome>.pam e instala-os como " -"etc/pam.d/I<nome>, em vez de usar os ficheiros habituais e de os instalar " -"usando o nome do pacote." +"usr/lib/pam.d/I<nome>, em vez de usar os ficheiros habituais e de os " +"instalar usando o nome do pacote." #. type: textblock #: dh_installppp:5 @@ -10069,8 +10806,8 @@ msgid "" "Depends}>.)" msgstr "" "O seu pacote deve depender de B<xfonts-utils> para que os comandos B<update-" -"fonts->I<*> estejam disponÃveis. (Este programa adiciona a dependência a B<" -"${misc:Depends}>.)" +"fonts->I<*> estejam disponÃveis. (Este programa adiciona a dependência a " +"B<${misc:Depends}>.)" #. type: textblock #: dh_installxfonts:35 @@ -10904,11 +11641,11 @@ msgstr "B<-x>, B<--include-conffiles>" #: dh_md5sums:37 msgid "" "Include conffiles in the md5sums list. Note that this information is " -"redundant since it is included elsewhere in Debian packages." +"redundant since it is included in F</var/lib/dpkg/status> in Debian packages." msgstr "" "Inclui ficheiros de configuração na lista de md5sums. Note que esta " -"informação é redundante pois isso está incluÃdo noutro local nos pacotes " -"Debian." +"informação é redundante pois isso está incluÃdo em F</var/lib/dpkg/status> " +"nos pacotes Debian." #. type: textblock #: dh_md5sums:42 @@ -11043,23 +11780,23 @@ msgid "dh_perl - calculates Perl dependencies and cleans up after MakeMaker" msgstr "dh_perl - calcula as dependências de Perl e limpa após MakeMaker" #. type: textblock -#: dh_perl:19 +#: dh_perl:20 msgid "B<dh_perl> [S<I<debhelper options>>] [B<-d>] [S<I<library dirs> ...>]" msgstr "" "B<dh_perl> [S<I<opções do debhelper>>] [B<-d>] [S<I<directórios de " "bibliotecas> ...>]" #. type: textblock -#: dh_perl:23 +#: dh_perl:24 msgid "" -"B<dh_perl> is a debhelper program that is responsible for generating the B<" -"${perl:Depends}> substitutions and adding them to substvars files." +"B<dh_perl> is a debhelper program that is responsible for generating the " +"B<${perl:Depends}> substitutions and adding them to substvars files." msgstr "" "B<dh_perl> é um programa debhelper que é responsável por gerar as " "substituições B<${perl:Depends}> e adicioná-las aos ficheiros substvars." #. type: textblock -#: dh_perl:26 +#: dh_perl:27 msgid "" "The program will look at Perl scripts and modules in your package, and will " "use this information to generate a dependency on B<perl> or B<perlapi>. The " @@ -11072,7 +11809,7 @@ msgstr "" "você colocar o token B<${perl:Depends}>." #. type: textblock -#: dh_perl:31 +#: dh_perl:32 msgid "" "B<dh_perl> also cleans up empty directories that MakeMaker can generate when " "installing Perl modules." @@ -11081,12 +11818,12 @@ msgstr "" "instala módulos Perl." #. type: =item -#: dh_perl:38 +#: dh_perl:39 msgid "B<-d>" msgstr "B<-d>" #. type: textblock -#: dh_perl:40 +#: dh_perl:41 msgid "" "In some specific cases you may want to depend on B<perl-base> rather than " "the full B<perl> package. If so, you can pass the -d option to make " @@ -11099,7 +11836,7 @@ msgstr "" "necessário para alguns pacotes que estão incluÃdos no sistema base." #. type: textblock -#: dh_perl:45 +#: dh_perl:46 msgid "" "Note that this flag may cause no dependency on B<perl-base> to be generated " "at all. B<perl-base> is Essential, so its dependency can be left out, unless " @@ -11111,12 +11848,12 @@ msgstr "" "dependência de determinada versão." #. type: =item -#: dh_perl:49 +#: dh_perl:50 msgid "B<-V>" msgstr "B<-V>" #. type: textblock -#: dh_perl:51 +#: dh_perl:52 msgid "" "By default, scripts and architecture independent modules don't depend on any " "specific version of B<perl>. The B<-V> option causes the current version of " @@ -11128,12 +11865,12 @@ msgstr "" "d>)." #. type: =item -#: dh_perl:55 +#: dh_perl:56 msgid "I<library dirs>" msgstr "I<directórios de bibliotecas>" #. type: textblock -#: dh_perl:57 +#: dh_perl:58 msgid "" "If your package installs Perl modules in non-standard directories, you can " "make B<dh_perl> check those directories by passing their names on the " @@ -11146,17 +11883,17 @@ msgstr "" "F<vendorlib> e F<vendorarch>." #. type: textblock -#: dh_perl:66 +#: dh_perl:67 msgid "Debian policy, version 3.8.3" msgstr "Debian policy, versão 3.8.3" #. type: textblock -#: dh_perl:68 +#: dh_perl:69 msgid "Perl policy, version 1.20" msgstr "Perl policy, versão 1.20" #. type: textblock -#: dh_perl:182 +#: dh_perl:196 msgid "Brendan O'Dea <bod@debian.org>" msgstr "Brendan O'Dea <bod@debian.org>" @@ -11654,8 +12391,8 @@ msgid "" "adding B<noautodbgsym> to the B<DEB_BUILD_OPTIONS> environment variable. " "However, B<dh_strip> will still add debuglinks to ELF binaries when this " "flag is set. This is to ensure that the regular deb package will be " -"identical with and without this flag (assuming it is otherwise \"bit-for-bit" -"\" reproducible)." +"identical with and without this flag (assuming it is otherwise \"bit-for-" +"bit\" reproducible)." msgstr "" "A criação automática de pacotes de sÃmbolos de depuração também pode ser " "prevenida ao adicionar B<noautodbgsym> à variável de ambiente " @@ -11968,101 +12705,108 @@ msgstr "debian/I<package>.service, debian/I<package>@.service" #. type: textblock #: dh_systemd_enable:47 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.service " -"(or lib/systemd/system/I<package>@.service) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"service >> (or F<< lib/systemd/system/I<package>@.service >>) in the package " +"build directory." msgstr "" -"Se isto existir, é instalado em lib/systemd/system/I<package>.service (or " -"lib/systemd/system/I<package>@.service) no directório de compilação do " -"pacote." +"Se isto existir, é instalado em F<< lib/systemd/system/I<package>.service >> " +"(or F<< lib/systemd/system/I<package>@.service >>) no directório de " +"compilação do pacote." #. type: textblock #: dh_systemd_enable:52 msgid "" "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf in " -"the package build directory. (The tmpfiles.d mechanism is currently only " -"used by systemd.)" +"the package build directory." msgstr "" -"Se isto existir, é instalado em usr/lib/tmpfiles.d/I<pacote>.conf no " -"directório de compilação do pacote. (Actualmente o mecanismo tmpfiles.d é " -"usado apenas pelo systemd.)" +"Se isto existir, está instalado em usr/lib/tmpfiles.d/I<pacote>.conf no " +"directório de compilação do pacote." #. type: =item -#: dh_systemd_enable:56 +#: dh_systemd_enable:55 msgid "debian/I<package>.target, debian/I<package>@.target" msgstr "debian/I<package>.target, debian/I<package>@.target" #. type: textblock -#: dh_systemd_enable:58 +#: dh_systemd_enable:57 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.target " -"(or lib/systemd/system/I<package>@.target) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"target >> (or F<< lib/systemd/system/I<package>@.target >>) in the package " +"build directory." msgstr "" -"Se isto existir, é instalado em lib/systemd/system/I<package>.target (ou lib/" -"systemd/system/I<package>@.target) no directório de compilação do pacote." +"Se isto existir, é instalado em F<< lib/systemd/system/I<package>.target >> " +"(ou F<< lib/systemd/system/I<package>@.target >>) no directório de " +"compilação do pacote." #. type: =item -#: dh_systemd_enable:61 +#: dh_systemd_enable:60 msgid "debian/I<package>.socket, debian/I<package>@.socket" msgstr "debian/I<package>.socket, debian/I<package>@.socket" #. type: textblock -#: dh_systemd_enable:63 +#: dh_systemd_enable:62 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.socket " -"(or lib/systemd/system/I<package>@.socket) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>." +"socket >> (or F<< lib/systemd/system/I<package>@.socket >>) in the package " +"build directory." msgstr "" -"Se isto existir, é instalado em lib/systemd/system/I<package>.socket (ou lib/" -"systemd/system/I<package>@.socket) no directório de compilação do pacote." +"Se isto existir, é instalado em F<< lib/systemd/system/I<package>.socket >> " +"(ou F<< lib/systemd/system/I<package>@.socket >>) no directório de " +"compilação do pacote." #. type: =item -#: dh_systemd_enable:66 +#: dh_systemd_enable:65 msgid "debian/I<package>.mount" msgstr "debian/I<package>.mount" #. type: textblock -#: dh_systemd_enable:68 +#: dh_systemd_enable:67 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.mount in " -"the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.mount " +">> in the package build directory." msgstr "" -"Se isto existir, é instalado em lib/systemd/system/I<pacote>.mount no " +"Se isto existir, é instalado em F<< lib/systemd/system/I<pacote>.mount >> no " "directório de compilação do pacote." #. type: =item -#: dh_systemd_enable:71 +#: dh_systemd_enable:70 msgid "debian/I<package>.path, debian/I<package>@.path" msgstr "debian/I<package>.path, debian/I<package>@.path" #. type: textblock -#: dh_systemd_enable:73 +#: dh_systemd_enable:72 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.path (or " -"lib/systemd/system/I<package>@.path) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.path " +">> (or F<< lib/systemd/system/I<package>@.path >>) in the package build " +"directory." msgstr "" -"Se isto existir, é instalado em lib/systemd/system/I<package>.path (ou lib/" -"systemd/system/I<package>@.path) no directório de compilação do pacote." +"Se isto existir, é instalado em F<< lib/systemd/system/I<package>.path >> " +"(ou F<< lib/systemd/system/I<package>@.path >>) no directório de compilação " +"do pacote." #. type: =item -#: dh_systemd_enable:76 +#: dh_systemd_enable:75 msgid "debian/I<package>.timer, debian/I<package>@.timer" msgstr "debian/I<package>.timer, debian/I<package>@.timer" #. type: textblock -#: dh_systemd_enable:78 +#: dh_systemd_enable:77 msgid "" -"If this exists, it is installed into lib/systemd/system/I<package>.timer (or " -"lib/systemd/system/I<package>@.timer) in the package build directory." +"If this exists, it is installed into F<< lib/systemd/system/I<package>.timer " +">> (or F<< lib/systemd/system/I<package>@.timer >>) in the package build " +"directory." msgstr "" -"Se isto existir, é instalado em lib/systemd/system/I<package>.timer (ou lib/" -"systemd/system/I<package>@.timer) no directório de compilação do pacote." +"Se isto existir, é instalado em F<< lib/systemd/system/I<package>.timer >> " +"(ou F<< lib/systemd/system/I<package>@.timer >>) no directório de compilação " +"do pacote." #. type: textblock -#: dh_systemd_enable:89 +#: dh_systemd_enable:88 msgid "Disable the service(s) on purge, but do not enable them on install." msgstr "Desactiva serviço(s) durante a purga, mas não os activa na instalação." #. type: textblock -#: dh_systemd_enable:91 +#: dh_systemd_enable:90 msgid "" "B<Note> that this option does not affect whether the services are started. " "That is controlled by L<dh_systemd_start(1)> (using e.g. its B<--no-start> " @@ -12073,7 +12817,7 @@ msgstr "" "start>)." #. type: textblock -#: dh_systemd_enable:97 +#: dh_systemd_enable:96 msgid "" "Install the service file as I<name.service> instead of the default filename, " "which is the I<package.service>. When this parameter is used, " @@ -12086,7 +12830,7 @@ msgstr "" "pacote.nome.serviço> em vez do habitual F<debian/pacote.serviço>." #. type: textblock -#: dh_systemd_enable:106 dh_systemd_start:70 +#: dh_systemd_enable:105 dh_systemd_start:70 msgid "" "Note that this command is not idempotent. L<dh_prep(1)> should be called " "between invocations of this command (with the same arguments). Otherwise, it " @@ -12099,7 +12843,7 @@ msgstr "" "do maintainer." #. type: textblock -#: dh_systemd_enable:111 +#: dh_systemd_enable:110 msgid "" "Note that B<dh_systemd_enable> should be run before B<dh_installinit>. The " "default sequence in B<dh> does the right thing, this note is only relevant " @@ -12110,12 +12854,12 @@ msgstr "" "quando você está a chamar B<dh_systemd_enable> manualmente." #. type: textblock -#: dh_systemd_enable:283 +#: dh_systemd_enable:282 msgid "L<dh_systemd_start(1)>, L<debhelper(7)>" msgstr "L<dh_systemd_start(1)>, L<debhelper(7)>" #. type: textblock -#: dh_systemd_enable:287 dh_systemd_start:286 +#: dh_systemd_enable:286 dh_systemd_start:286 msgid "pkg-systemd-maintainers@lists.alioth.debian.org" msgstr "pkg-systemd-maintainers@lists.alioth.debian.org" @@ -12181,7 +12925,7 @@ msgid "" "F<prerm>, and start it again in the F<postinst>." msgstr "" "Nos nÃveis de compatibilidade anteriores a predefinição era parar o ficheiro " -"unit no F<prerm>, e arrancá-lo de novo no F<postinst>.t>." +"unit no F<prerm>, e arranca-lo de novo no F<postinst>.t>." #. type: textblock #: dh_systemd_start:59 @@ -12219,6 +12963,147 @@ msgstr "" "Este nÃvel de compatibilidade está aberto para testes beta: podem ocorrer " "alterações." +#~ msgid "" +#~ "Set to B<1> to enable verbose mode. Debhelper will output every command " +#~ "it runs. Also enables verbose build logs for some build systems like " +#~ "autoconf." +#~ msgstr "" +#~ "Defina para B<1> para activar o modo detalhado. O debhelper irá mostrar " +#~ "os resultados de cada comando que corre. Também activa relatórios de " +#~ "compilação detalhados para alguns sistemas de compilação como o autoconf." + +#~ msgid "This value affects most B<dh_auto_*> tools." +#~ msgstr "Este valor afecta a maioria das ferramentas B<dh_auto_*>." + +#~ msgid "" +#~ "This can cause issues with running binaries directly from the build " +#~ "directories as they might now require a manually set B<LD_LIBRARY_PATH>. " +#~ "If you need to override this change, we recommend that you try to pass " +#~ "the B<-DCMAKE_SKIP_RPATH=OFF> option first to see if that fixes the " +#~ "problem (leaving B<CMAKE_BUILD_RPATH_USE_ORIGIN> at its new default). " +#~ "This should undo the need for B<LD_LIBRARY_PATH> and avoid the " +#~ "reproducibility issues on Linux, where B<$ORIGIN> is supported by the " +#~ "runtime linkers." +#~ msgstr "" +#~ "Isto pode causar problemas com o correr binários directamente dos " +#~ "directórios de compilação pois eles podem não requerer uma " +#~ "B<LD_LIBRARY_PATH> definida manualmente. Se você precisa de sobrepor esta " +#~ "alteração, nós recomendamos que tente passar a opção B<-" +#~ "DCMAKE_SKIP_RPATH=OFF> primeiro para ver se isso corrige o problema " +#~ "(deixando B<CMAKE_BUILD_RPATH_USE_ORIGIN> na sua nova predefinição). Isto " +#~ "deve desfazer a necessidade de B<LD_LIBRARY_PATH> e evitar os problemas " +#~ "de reprodutibilidade em Linux, onde B<$ORIGIN> é suportado pelos " +#~ "vinculadores de tempo-de-execução." + +#~ msgid "" +#~ "The tool B<dh_installsysusers> is now included in the default sequence. " +#~ "It will cause units to be automatically started on installation, " +#~ "restarted on upgrade and stopped on removal for every systemd user " +#~ "instance running on the system." +#~ msgstr "" +#~ "A ferramenta B<dh_installsysusers> está agora incluÃda na sequência " +#~ "predefinida. Irá fazer com que unidades sejam arrancadas automaticamente " +#~ "na instalação, reiniciadas na actualização e paradas na remoção para cada " +#~ "instância de utilizador de systemd a correr no sistema." + +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.) Only used in compat levels 10 and below." +#~ msgstr "" +#~ "Se isto existir, é instalado em usr/lib/tmpfiles.d/I<pacote>.conf no " +#~ "directório de compilação do pacote. (Actualmente o mecanismo tmpfiles.d é " +#~ "usado apenas pelo systemd.) Apenas usado nos nÃveis de compatibilidade 10 " +#~ "e inferiores." + +#~ msgid "" +#~ "If this exists, it is installed into usr/lib/tmpfiles.d/I<package>.conf " +#~ "in the package build directory. (The tmpfiles.d mechanism is currently " +#~ "only used by systemd.)" +#~ msgstr "" +#~ "Se isto existir, é instalado em usr/lib/tmpfiles.d/I<pacote>.conf no " +#~ "directório de compilação do pacote. (Actualmente o mecanismo tmpfiles.d é " +#~ "usado apenas pelo systemd.)" + +#~ msgid "" +#~ "Historically, this file was needed to manually mark files files as " +#~ "conffiles. However, it has become de facto obsolete since debhelper " +#~ "automatically computed which files should be marked as conffiles." +#~ msgstr "" +#~ "Historicamente, este ficheiro era preciso para marcar manualmente " +#~ "ficheiros como ficheiros de configuração (conffiles). No entanto, tem-se " +#~ "tornado de facto obsoleto desde que o debhelper passou a computar " +#~ "automaticamente quais os ficheiros devem ser marcados como ficheiros de " +#~ "configuração." + +#~ msgid "" +#~ "In compatibility level up and including 11, this control file will be " +#~ "installed into the F<DEBIAN> directory. In compatibility level 12 and " +#~ "later, the file is silently ignored." +#~ msgstr "" +#~ "Em nÃvel de compatibilidade até e incluindo 11, este ficheiro de controle " +#~ "será instalado no directório F<DEBIAN>. Em nÃvel de compatibilidade 12 e " +#~ "posterior, o ficheiro é ignorado em silêncio." + +#~ msgid "" +#~ "dh_gconf - install GConf defaults files and register schemas (deprecated)" +#~ msgstr "" +#~ "dh_gconf - instala ficheiros de predefinições GConf e regista schemas " +#~ "(descontinuado)" + +#~ msgid "B<dh_gconf> [S<I<debhelper options>>] [B<--priority=>I<priority>]" +#~ msgstr "B<dh_gconf> [S<I<debhelper opções>>] [B<--priority=>I<prioridade>]" + +#~ msgid "" +#~ "B<dh_gconf> is a debhelper program that is responsible for installing " +#~ "GConf defaults files and registering GConf schemas." +#~ msgstr "" +#~ "B<dh_gconf> é um programa debhelper que é responsável por instalar " +#~ "ficheiros de predefinições de GConf e registar os esquemas GConf." + +#~ msgid "" +#~ "An appropriate dependency on gconf2 will be generated in B<${misc:Depends}" +#~ ">." +#~ msgstr "" +#~ "Uma dependência apropriada em gconf2 será gerada em B<${misc:Depends}>." + +#~ msgid "debian/I<package>.gconf-defaults" +#~ msgstr "debian/I<pacote>.gconf-defaults" + +#~ msgid "" +#~ "Installed into F<usr/share/gconf/defaults/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "Instalado em F<usr/share/gconf/defaults/10_pacote> no directório de " +#~ "compilação do pacote, com I<pacote> substituÃdo pelo nome do pacote." + +#~ msgid "debian/I<package>.gconf-mandatory" +#~ msgstr "debian/I<pacote>.gconf-mandatory" + +#~ msgid "" +#~ "Installed into F<usr/share/gconf/mandatory/10_package> in the package " +#~ "build directory, with I<package> replaced by the package name." +#~ msgstr "" +#~ "Instalado em F<usr/share/gconf/mandatory/10_pacote> no directório de " +#~ "compilação do pacote, com I<pacote> substituÃdo pelo nome do pacote." + +#~ msgid "B<--priority> I<priority>" +#~ msgstr "B<--priority> I<prioridade>" + +#~ msgid "" +#~ "Use I<priority> (which should be a 2-digit number) as the defaults " +#~ "priority instead of B<10>. Higher values than ten can be used by derived " +#~ "distributions (B<20>), CDD distributions (B<50>), or site-specific " +#~ "packages (B<90>)." +#~ msgstr "" +#~ "Usa I<prioridade> (que deve ser um número de dois dÃgitos) como a " +#~ "prioridade predefinida em vez de B<10>. Valores mais altos que dez podem " +#~ "ser usados por distribuições derivadas (B<20>), distribuições CDD " +#~ "(B<50>), ou pacotes especÃficos de site (B<90>)." + +#~ msgid "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" +#~ msgstr "Ross Burton <ross@burtonini.com> Josselin Mouette <joss@debian.org>" + #~ msgid "" #~ "B<dh_clean> should be the last debhelper command run in the B<clean> " #~ "target in F<debian/rules>." @@ -12718,8 +13603,8 @@ msgstr "" #~ msgid "" #~ "B<dh> no longer creates a stamp (or log) file to record whether the build " #~ "already ran or not. This means that unless upstream's build system " -#~ "correctly tracks this, the build will be run twice (once for the \"build" -#~ "\" target and once for the \"binary\" target)." +#~ "correctly tracks this, the build will be run twice (once for the " +#~ "\"build\" target and once for the \"binary\" target)." #~ msgstr "" #~ "B<dh> já não cria um ficheiro stamp (ou log) para gravar se a compilação " #~ "já correu ou não. Isto significa que a menos que o sistema de compilação " @@ -12734,10 +13619,6 @@ msgstr "" #~ "buildpackage -nc>) irá ter o comportamento que a maioria das pessoas " #~ "iriam esperar." -#~ msgid "The previous behaviour can restored by using B<--with build-stamp>" -#~ msgstr "" -#~ "O comportamento anterior pode ser restaurado ao usar B<--with build-stamp>" - #~ msgid "" #~ "In compat 11, this file is no longer installed the format has been " #~ "deprecated. Please migrate to a desktop file instead." diff --git a/man/po4a/po4a.cfg b/man/po4a/po4a.cfg index e79720fa401fab73bdc8b4d5f8ee46639c20c45c..ee52d24232d1d896cdc5c3d8f11ed51919862d78 100644 --- a/man/po4a/po4a.cfg +++ b/man/po4a/po4a.cfg @@ -6,6 +6,7 @@ [po4a_alias:pod] pod opt_pt:"-L UTF-8 -A UTF-8" [po4a_alias:pod] pod opt_ja:"-L UTF-8 -A UTF-8" [type: pod] debhelper.pod $lang:man/$lang/debhelper.pod add_fr:man/po4a/add.fr add_es:man/po4a/add1.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt +[type: pod] debhelper-compat-upgrade-checklist.pod $lang:man/$lang/debhelper-compat-upgrade-checklist.pod add_fr:man/po4a/add.fr add_es:man/po4a/add2.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt [type: pod] debhelper-obsolete-compat.pod $lang:man/$lang/debhelper-obsolete-compat.pod add_fr:man/po4a/add.fr add_es:man/po4a/add2.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt [type: pod] dh $lang:man/$lang/dh.pod add_fr:man/po4a/add.fr add_es:man/po4a/add3.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt [type: pod] dh_auto_build $lang:man/$lang/dh_auto_build.pod add_fr:man/po4a/add.fr add_es:man/po4a/add3.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt @@ -19,7 +20,6 @@ [type: pod] dh_compress $lang:man/$lang/dh_compress.pod add_fr:man/po4a/add.fr add_es:man/po4a/add1.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt [type: pod] dh_dwz $lang:man/$lang/dh_dwz.pod add_fr:man/po4a/add.fr add_es:man/po4a/add2.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt [type: pod] dh_fixperms $lang:man/$lang/dh_fixperms.pod add_fr:man/po4a/add.fr add_es:man/po4a/add1.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt -[type: pod] dh_gconf $lang:man/$lang/dh_gconf.pod add_fr:man/po4a/add.fr add_es:man/po4a/add1.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt [type: pod] dh_gencontrol $lang:man/$lang/dh_gencontrol.pod add_fr:man/po4a/add.fr add_es:man/po4a/add1.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt [type: pod] dh_icons $lang:man/$lang/dh_icons.pod add_fr:man/po4a/add.fr add_es:man/po4a/add3.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt [type: pod] dh_install $lang:man/$lang/dh_install.pod add_fr:man/po4a/add.fr add_es:man/po4a/add1.es add_de:man/po4a/add.de add_pt:man/po4a/add.pt diff --git a/t/Test/DH.pm b/t/Test/DH.pm index 7fa30bfd90f8032194a6d8150549a15f587b3282..8d9e71fef46659ef0041a6bf0c6a27a40558b4fd 100644 --- a/t/Test/DH.pm +++ b/t/Test/DH.pm @@ -44,7 +44,7 @@ use Debian::Debhelper::Dh_Lib qw(!dirname); our @EXPORT = qw( each_compat_up_to_and_incl_subtest each_compat_subtest each_compat_from_and_above_subtest run_dh_tool - create_empty_file readlines + create_empty_file readlines copy_file error find_script non_deprecated_compat_levels each_compat_from_x_to_and_incl_y_subtest ); @@ -54,6 +54,13 @@ our ($TEST_DH_COMPAT); my $START_DIR = getcwd(); my $TEST_DIR; + +sub copy_file { + my ($src, $dest, $mode) = @_; + $mode //= 0644; + return Debian::Debhelper::Dh_Lib::_install_file_to_path($mode, $src, $dest); +} + sub run_dh_tool { my (@cmd) = @_; my $compat = $TEST_DH_COMPAT; @@ -100,7 +107,7 @@ sub _prepare_test_root { debian/changelog ); for my $file (@files) { - install_file($file, "${dir}/${file}"); + copy_file($file, "${dir}/${file}"); } if (@::TEST_DH_EXTRA_TEMPLATE_FILES) { my $test_dir = ($TEST_DIR //= dirname($0)); @@ -109,9 +116,9 @@ sub _prepare_test_root { for my $file (@::TEST_DH_EXTRA_TEMPLATE_FILES) { if (index($file, '/') > -1) { my $install_dir = dirname($file); - install_dir($install_dir); + mkdirs($install_dir); } - install_file("${actual_dir}/${file}", "${dir}/${file}"); + copy_file("${actual_dir}/${file}", "${dir}/${file}"); } } } diff --git a/t/dh_install/04-sourcedir.t b/t/dh_install/04-sourcedir.t index c624723e2f554f999f91a2f6906c13044728bc1a..83bd0065107e74ebb1ef15399e2704cb966bc408 100755 --- a/t/dh_install/04-sourcedir.t +++ b/t/dh_install/04-sourcedir.t @@ -9,34 +9,10 @@ use Test::DH; use File::Path qw(remove_tree make_path); use Debian::Debhelper::Dh_Lib qw(!dirname); -plan(tests => 6); +plan(tests => 3); -each_compat_up_to_and_incl_subtest(6, sub { - my ($compat) = @_; - # debian/tmp explicitly specified in filenames in older compat level - make_path('debian/tmp/usr/bin'); - create_empty_file('debian/tmp/usr/bin/foo'); - create_empty_file('debian/tmp/usr/bin/bar'); - ok(run_dh_tool('dh_install', 'debian/tmp/usr/bin/foo')); - ok(-e "debian/debhelper/usr/bin/foo"); - ok(!-e "debian/debhelper/usr/bin/bar"); - remove_tree('debian/debhelper', 'debian/tmp'); -}); - -each_compat_up_to_and_incl_subtest(6, sub { - my ($compat) = @_; - # --sourcedir=debian/tmp in older compat level - make_path('debian/tmp/usr/bin'); - create_empty_file('debian/tmp/usr/bin/foo'); - create_empty_file('debian/tmp/usr/bin/bar'); - ok(run_dh_tool('dh_install', '--sourcedir=debian/tmp', 'usr/bin/foo')); - ok(-e "debian/debhelper/usr/bin/foo"); - ok(! -e "debian/debhelper/usr/bin/bar"); - remove_tree('debian/debhelper', 'debian/tmp'); -}); - -each_compat_from_and_above_subtest(7, sub { +each_compat_subtest { my ($compat) = @_; # redundant --sourcedir=debian/tmp in v7+ make_path('debian/tmp/usr/bin'); @@ -46,9 +22,9 @@ each_compat_from_and_above_subtest(7, sub { ok(-e "debian/debhelper/usr/bin/foo"); ok(! -e "debian/debhelper/usr/bin/bar"); remove_tree('debian/debhelper', 'debian/tmp'); -}); +}; -each_compat_from_and_above_subtest(7, sub { +each_compat_subtest { my ($compat) = @_; # #534565: fallback use of debian/tmp in v7+ make_path('debian/tmp/usr/bin'); @@ -58,20 +34,7 @@ each_compat_from_and_above_subtest(7, sub { ok(-e "debian/debhelper/usr/bin/foo", "#534565 [${compat}]"); ok(-e "debian/debhelper/usr/bin/bar", "#534565 [${compat}]"); remove_tree('debian/debhelper', 'debian/tmp'); -}); - -each_compat_up_to_and_incl_subtest(6, sub { - my ($compat) = @_; - # no fallback to debian/tmp before v7 - make_path('debian/tmp/usr/bin'); - create_empty_file('debian/tmp/usr/bin/foo'); - create_empty_file('debian/tmp/usr/bin/bar'); - ok(!run_dh_tool({ 'quiet' => 1 }, 'dh_install', 'usr')); - ok(!-e "debian/debhelper/usr/bin/foo"); - ok(!-e "debian/debhelper/usr/bin/bar"); - remove_tree('debian/debhelper', 'debian/tmp'); -}); - +}; each_compat_subtest { my ($compat) = @_; diff --git a/t/dh_installchangelogs/debian/control b/t/dh_installchangelogs/debian/control new file mode 100644 index 0000000000000000000000000000000000000000..4f4238ebadc0de99525774b33d723dff6d92ae98 --- /dev/null +++ b/t/dh_installchangelogs/debian/control @@ -0,0 +1,10 @@ +Source: foo +Section: misc +Priority: optional +Maintainer: Test <testing@nowhere> +Standards-Version: 3.9.8 + +Package: foo +Architecture: all +Description: package foo + Package foo diff --git a/t/dh_installchangelogs/dh_installchangelogs.t b/t/dh_installchangelogs/dh_installchangelogs.t new file mode 100755 index 0000000000000000000000000000000000000000..989a552ae60d77c97c93b2d3e7085e83a7b6e56f --- /dev/null +++ b/t/dh_installchangelogs/dh_installchangelogs.t @@ -0,0 +1,252 @@ +#!/usr/bin/perl + +use strict; +use warnings; +use POSIX qw(locale_h); +use Test::More; +use Time::Piece; +use Time::Seconds qw(ONE_MONTH ONE_YEAR); + +use File::Basename qw(dirname); +use lib dirname(dirname(__FILE__)); +use Test::DH; + +use constant TEST_DIR => dirname($0); +our @TEST_DH_EXTRA_TEMPLATE_FILES = (qw( + debian/changelog + debian/control +)); + +# Force Time::Piece to generate dch-compliant timestamps (i.e. in English). +setlocale(LC_ALL, "C.UTF-8"); + +use constant CUTOFF_DATE_STR => "2019-07-06"; # oldstable = Debian 10 Buster +use constant CUTOFF_DATE => Time::Piece->strptime(CUTOFF_DATE_STR, "%Y-%m-%d"); +use constant MIN_NUM_ENTRIES => 4; + +sub install_changelog { + my ($latest_offset_years, $num_years, $is_binnmu) = @_; + $is_binnmu //= 0; + + my $entry_date_first = CUTOFF_DATE->add_years($latest_offset_years); + my $entry_date_stop = $entry_date_first->add_years(-$num_years); + + my $changelog = "${\TEST_DIR}/debian/changelog"; + + open(my $fd, ">", $changelog) or error("open($changelog): $!"); + + if ($is_binnmu) { + my $nmu_date = $entry_date_first->add_months(-1); + my $nmu_entry = entry_text($nmu_date, 1); + print($fd $nmu_entry); + } + + # Add one entry every three months ~= four per year. + my $entry_date = $entry_date_first; + while ($entry_date > $entry_date_stop) { + my $entry = entry_text($entry_date, 0); + print($fd $entry); + + $entry_date = $entry_date->add_months(-3); + } + close($fd); +} + +sub entry_text { + my ($entry_date, $is_binnmu) = @_; + my $entry_date_str = $entry_date->strftime("%a, %d %b %Y %T %z"); + my $ver = $entry_date->year . "." . $entry_date->mon . "-1"; + my $binnmu_text = ""; + + if ($is_binnmu) { + $binnmu_text = " binary-only=yes"; + $ver .= "+b1"; + } + + my $entry = ""; + $entry .= "foo ($ver) unstable; urgency=low$binnmu_text\n\n"; + $entry .= " * New release.\n\n"; + $entry .= " -- Test <testing\@nowhere> $entry_date_str\n\n"; + + return $entry; +} + +sub changelog_lines_pkg { + return changelog_lines("debian/changelog"); +} +sub changelog_lines_installed { + return changelog_lines("debian/foo/usr/share/doc/foo/changelog.Debian"); +} +sub changelog_lines_binnmu { + return changelog_lines("debian/foo/usr/share/doc/foo/changelog.Debian.all"); +} +sub changelog_lines { + my ($changelog) = @_; + open(my $fd, $changelog) or error("open($changelog): $!"); + my @lines = @{readlines($fd)}; + @lines = grep(!/^$/, @lines); + return @lines; +} + +sub dates_in_lines { + my @lines = @_; + my @lines_dates = grep(/^ -- /, @lines); + @lines_dates = map { (my $l = $_) =~ s/^\s*--\s+.*?\s+<[^>]*>\s+[A-Za-z]+, +//; $l } @lines_dates; + @lines_dates = map { Time::Piece->strptime($_, "%d %b %Y %T %z") } @lines_dates; + return @lines_dates; +} + +plan(tests => 8); + +# Test changelog with only recent entries (< oldstable) +my $years_after_cutoff = 2; +my $years_of_changelog = 2; +install_changelog($years_after_cutoff, $years_of_changelog); +each_compat_subtest { + my @lines_orig = changelog_lines_pkg(); + ok(run_dh_tool("dh_installchangelogs")); + my @lines = changelog_lines_installed(); + my @comments = grep(/^#/, @lines); + + is(@lines, @lines_orig); + is(@comments, 0); +}; + +# Test changelog with both recent and old entries +$years_after_cutoff = 1; +$years_of_changelog = 4; +install_changelog($years_after_cutoff, $years_of_changelog); +each_compat_subtest { + my @lines_orig = changelog_lines_pkg(); + ok(run_dh_tool("dh_installchangelogs")); + my @lines = changelog_lines_installed(); + my @entries = dates_in_lines(@lines); + my @entries_old = grep { $_ < CUTOFF_DATE } @entries; + my @comments = grep(/^#/, @lines); + + cmp_ok(@lines, "<", @lines_orig); + cmp_ok(@entries, ">", 1); + is(@entries_old, 0); + cmp_ok(@comments, ">=", 1); +}; + +# Test changelog with only old entries +$years_after_cutoff = -1; +$years_of_changelog = 2; +install_changelog($years_after_cutoff, $years_of_changelog); +each_compat_subtest { + my @lines_orig = changelog_lines_pkg(); + ok(run_dh_tool("dh_installchangelogs")); + my @lines = changelog_lines_installed(); + my @entries = dates_in_lines(@lines); + my @entries_old = grep { $_ < CUTOFF_DATE } @entries; + my @comments = grep(/^#/, @lines); + + cmp_ok(@lines, "<", @lines_orig); + is(@entries, MIN_NUM_ENTRIES); + is(@entries_old, MIN_NUM_ENTRIES); + cmp_ok(@comments, ">=", 1); +}; + +# Test changelog with only recent entries (< oldstable) + binNUM +$years_after_cutoff = 2; +$years_of_changelog = 2; +install_changelog($years_after_cutoff, $years_of_changelog, 1); +each_compat_subtest { + my @lines_orig = changelog_lines_pkg(); + my @entries_orig = dates_in_lines(@lines_orig); + ok(run_dh_tool("dh_installchangelogs")); + my @lines = changelog_lines_installed(); + my @entries = dates_in_lines(@lines); + my @entries_nmu = dates_in_lines(changelog_lines_binnmu()); + my @comments = grep(/^#/, @lines); + + is(@entries, @entries_orig-1); + is($entries[0], $entries_orig[1]); + is(@comments, 0); + + is(@entries_nmu, 1); +}; + +# Test changelog with both recent and old entries + binNMU +$years_after_cutoff = 1; +$years_of_changelog = 4; +install_changelog($years_after_cutoff, $years_of_changelog, 1); +each_compat_subtest { + my @lines_orig = changelog_lines_pkg(); + my @entries_orig = dates_in_lines(@lines_orig); + ok(run_dh_tool("dh_installchangelogs")); + my @lines = changelog_lines_installed(); + my @entries = dates_in_lines(@lines); + my @entries_old = grep { $_ < CUTOFF_DATE } @entries; + my @entries_nmu = dates_in_lines(changelog_lines_binnmu()); + my @comments = grep(/^#/, @lines); + + cmp_ok(@entries, "<", @entries_orig-1); + is($entries[0], $entries_orig[1]); + is(@entries_old, 0); + cmp_ok(@comments, ">=", 1); + + is(@entries_nmu, 1); +}; + +# Test changelog with only old entries + binNMU +$years_after_cutoff = -1; +$years_of_changelog = 2; +install_changelog($years_after_cutoff, $years_of_changelog, 1); +each_compat_subtest { + my @lines_orig = changelog_lines_pkg(); + my @entries_orig = dates_in_lines(@lines_orig); + ok(run_dh_tool("dh_installchangelogs")); + my @lines = changelog_lines_installed(); + my @entries = dates_in_lines(@lines); + my @entries_old = grep { $_ < CUTOFF_DATE } @entries; + my @entries_nmu = dates_in_lines(changelog_lines_binnmu()); + my @comments = grep(/^#/, @lines); + + is(@entries, MIN_NUM_ENTRIES); + is($entries[0], $entries_orig[1]); + is(@entries_old, MIN_NUM_ENTRIES); + cmp_ok(@comments, ">=", 1); + + is(@entries_nmu, 1); +}; + +# Test changelog with both recent and old entries + --no-trim +$years_after_cutoff = 1; +$years_of_changelog = 4; +install_changelog($years_after_cutoff, $years_of_changelog); +each_compat_subtest { + my @lines_orig = changelog_lines_pkg(); + ok(run_dh_tool("dh_installchangelogs", "--no-trim")); + my @lines = changelog_lines_installed(); + my @entries = dates_in_lines(@lines); + my @entries_old = grep { $_ < CUTOFF_DATE } @entries; + my @comments = grep(/^#/, @lines); + + is(@lines, @lines_orig); + cmp_ok(@entries, ">", 1); + cmp_ok(@entries_old, ">", 1); + is(@comments, 0); +}; + +# Test changelog with both recent and old entries + notrimdch +$years_after_cutoff = 1; +$years_of_changelog = 4; +install_changelog($years_after_cutoff, $years_of_changelog); +each_compat_subtest { + my @lines_orig = changelog_lines_pkg(); + $ENV{DEB_BUILD_OPTIONS} = "notrimdch"; + ok(run_dh_tool("dh_installchangelogs")); + my @lines = changelog_lines_installed(); + my @entries = dates_in_lines(@lines); + my @entries_old = grep { $_ < CUTOFF_DATE } @entries; + my @comments = grep(/^#/, @lines); + + is(@lines, @lines_orig); + cmp_ok(@entries, ">", 1); + cmp_ok(@entries_old, ">", 1); + is(@comments, 0); +}; + +unlink("${\TEST_DIR}/debian/changelog"); diff --git a/t/dh_installinit/dh_installinit.t b/t/dh_installinit/dh_installinit.t index d290df21132045868ba5a8d8f2a272f2e06f9c7f..7a7817c371bc9f43f9b8919bfd3b98047ef2267d 100755 --- a/t/dh_installinit/dh_installinit.t +++ b/t/dh_installinit/dh_installinit.t @@ -36,7 +36,7 @@ each_compat_from_and_above_subtest(11, sub { ok(run_dh_tool('dh_clean')); make_path(qw(debian/foo/lib/systemd/system/ debian/bar debian/baz)); - install_file('debian/foo.service', 'debian/foo/lib/systemd/system/foo.service'); + copy_file('debian/foo.service', 'debian/foo/lib/systemd/system/foo.service'); ok(run_dh_tool('dh_installinit')); ok(!find_script('foo', 'postinst')); ok(run_dh_tool('dh_clean')); diff --git a/t/dh_installman/01-basics.t b/t/dh_installman/01-basics.t index 6e90cc944b6a69d15adffec519293a7e0fe9440b..141059a5ae6a52b98401bddf8c7d9306c47660b2 100755 --- a/t/dh_installman/01-basics.t +++ b/t/dh_installman/01-basics.t @@ -29,6 +29,9 @@ if (has_man_db_tool('man') || has_man_db_tool('man-recode')) { our @TEST_DH_EXTRA_TEMPLATE_FILES = (qw( manpage-uncompressed.pod manpage-compressed.pod + manpage-perl.pod + libmanpage.so.1.2.3.pod + libmanpage.so.9.2.3 )); each_compat_subtest { @@ -36,16 +39,26 @@ each_compat_subtest { if (! -d 'generated-manpages') { # Static data that can be reused. Generate only in the first test make_path('generated-manpages'); - for my $basename (qw(manpage-uncompressed manpage-compressed)) { + for my $basename (qw(manpage-uncompressed manpage-compressed manpage-perl libmanpage.so.1.2.3)) { doit('pod2man', '--utf8', '-c', 'Debhelper', '-r', '1.0', "${basename}.pod", "generated-manpages/${basename}.1"); } + doit('pod2man', '--utf8', '-c', 'Debhelper', '-r', '1.0', '-s', '3', 'manpage-perl.pod', + 'generated-manpages/manpage-perl.3perl'); doit('gzip', '-9n', 'generated-manpages/manpage-compressed.1'); } ok(run_dh_tool('dh_installman', 'generated-manpages/manpage-uncompressed.1', - 'generated-manpages/manpage-compressed.1.gz')); + 'generated-manpages/manpage-compressed.1.gz', + 'generated-manpages/manpage-perl.3perl', + 'generated-manpages/libmanpage.so.1.2.3.1', + 'libmanpage.so.9.2.3')); + ok(-e 'debian/debhelper/usr/share/man/man1/manpage-uncompressed.1'); ok(-e 'debian/debhelper/usr/share/man/man1/manpage-compressed.1'); + ok(-e 'debian/debhelper/usr/share/man/man3/manpage-perl.3'); + ok(-e 'debian/debhelper/usr/share/man/man1/libmanpage.so.1.2.3.1'); + ok(! -e 'debian/debhelper/usr/share/man/man9/libmanpage.so.9.2.9.2.3'); + ok(-l 'debian/debhelper/usr/share/man/man3/libmanpage.so.9.2.3'); remove_tree('debian/debhelper', 'debian/tmp', 'debian/.debhelper'); }; @@ -54,18 +67,28 @@ each_compat_subtest { if (! -d 'generated-manpages') { # Static data that can be reused. Generate only in the first test make_path('generated-manpages'); - for my $basename (qw(manpage-uncompressed manpage-compressed)) { + for my $basename (qw(manpage-uncompressed manpage-compressed libmanpage.so.1.2.3)) { doit('pod2man', '--utf8', '-c', 'Debhelper', '-r', '1.0', "${basename}.pod", "generated-manpages/${basename}.1"); } + doit('pod2man', '--utf8', '-c', 'Debhelper', '-r', '1.0', '-s', '3', 'manpage-perl.pod', + 'generated-manpages/manpage-perl.3perl'); doit('gzip', '-9n', 'generated-manpages/manpage-compressed.1'); } - install_dir('debian/debhelper/usr/share/man/man1'); - install_file('generated-manpages/manpage-uncompressed.1', 'debian/debhelper/usr/share/man/man1/manpage-uncompressed.1'); - install_file('generated-manpages/manpage-compressed.1.gz', 'debian/debhelper/usr/share/man/man1/manpage-compressed.1.gz'); + mkdirs('debian/debhelper/usr/share/man/man1'); + mkdirs('debian/debhelper/usr/share/man/man3'); + copy_file('generated-manpages/manpage-uncompressed.1', 'debian/debhelper/usr/share/man/man1/manpage-uncompressed.1'); + copy_file('generated-manpages/manpage-compressed.1.gz', 'debian/debhelper/usr/share/man/man1/manpage-compressed.1.gz'); + copy_file('generated-manpages/manpage-perl.3perl', 'debian/debhelper/usr/share/man/man3/manpage-perl.3perl'); + copy_file('generated-manpages/libmanpage.so.1.2.3.1', 'debian/debhelper/usr/share/man/man1/libmanpage.so.1.2.3.1'); + copy_file('libmanpage.so.9.2.3', 'debian/debhelper/usr/share/man/man3/libmanpage.so.9.2.3'); ok(run_dh_tool('dh_installman')); ok(-e 'debian/debhelper/usr/share/man/man1/manpage-uncompressed.1'); ok(-e 'debian/debhelper/usr/share/man/man1/manpage-compressed.1'); + ok(-e 'debian/debhelper/usr/share/man/man3/manpage-perl.3perl'); + ok(-e 'debian/debhelper/usr/share/man/man1/libmanpage.so.1.2.3.1'); + ok(! -e 'debian/debhelper/usr/share/man/man9/libmanpage.so.9.2.9.2.3'); + ok(-l 'debian/debhelper/usr/share/man/man3/libmanpage.so.9.2.3'); remove_tree('debian/debhelper', 'debian/tmp', 'debian/.debhelper'); }; diff --git a/t/dh_installman/libmanpage.so.1.2.3.pod b/t/dh_installman/libmanpage.so.1.2.3.pod new file mode 100644 index 0000000000000000000000000000000000000000..0b68dec57c2f8252e6f01e1005959776b7b51b84 --- /dev/null +++ b/t/dh_installman/libmanpage.so.1.2.3.pod @@ -0,0 +1,17 @@ +=head1 NAME + +libmanpage.so.1.2.3 - Something very exciting + +=head1 SYNOPSIS + +This tool does not exist but would be awesome. + +=head1 SEE ALSO + +L<debhelper(7)> + +=head1 AUTHORS + +Niels Thykier <niels@thykier.net> + +=cut diff --git a/t/dh_installman/libmanpage.so.9.2.3 b/t/dh_installman/libmanpage.so.9.2.3 new file mode 100644 index 0000000000000000000000000000000000000000..07658f3c24bf5e7eb742e89a62ff4e42a5eeb4eb --- /dev/null +++ b/t/dh_installman/libmanpage.so.9.2.3 @@ -0,0 +1 @@ +.so man1/manpage-uncompressed.1 diff --git a/t/dh_installman/manpage-perl.pod b/t/dh_installman/manpage-perl.pod new file mode 100644 index 0000000000000000000000000000000000000000..9b66d9d0a78429af931f7f3d0c645337115babd3 --- /dev/null +++ b/t/dh_installman/manpage-perl.pod @@ -0,0 +1,17 @@ +=head3 NAME + +manpage-uncompressed - Something very exciting + +=head3 SYNOPSIS + +This tool does not exist but would be awesome. + +=head3 SEE ALSO + +L<debhelper(7)> + +=head3 AUTHORS + +Niels Thykier <niels@thykier.net> + +=cut diff --git a/t/dh_installpam/debian/changelog b/t/dh_installpam/debian/changelog new file mode 100644 index 0000000000000000000000000000000000000000..5850f0e246988fba6109343c87d6fa1f7291e543 --- /dev/null +++ b/t/dh_installpam/debian/changelog @@ -0,0 +1,5 @@ +foo (1.0-1) unstable; urgency=low + + * Initial release. (Closes: #XXXXXX) + + -- Test <testing@nowhere> Mon, 11 Jul 2016 18:10:59 +0200 diff --git a/t/dh_installpam/debian/control b/t/dh_installpam/debian/control new file mode 100644 index 0000000000000000000000000000000000000000..c266f51161ad81e1165c53a69e82b1fd6f7cca53 --- /dev/null +++ b/t/dh_installpam/debian/control @@ -0,0 +1,10 @@ +Source: foo +Section: misc +Priority: optional +Maintainer: Test <testing@example.org> +Standards-Version: 3.9.8 + +Package: foo +Architecture: all +Description: package foo + Package foo diff --git a/t/dh_installpam/debian/foo.pam b/t/dh_installpam/debian/foo.pam new file mode 100644 index 0000000000000000000000000000000000000000..fab1c8cf0a2cdbdc80ee7cd9438d1717460fef1f --- /dev/null +++ b/t/dh_installpam/debian/foo.pam @@ -0,0 +1 @@ +@include common-auth diff --git a/t/dh_installpam/dh_installpam.t b/t/dh_installpam/dh_installpam.t new file mode 100755 index 0000000000000000000000000000000000000000..4e76799c1914435a85ecf4f16b9bec90300554aa --- /dev/null +++ b/t/dh_installpam/dh_installpam.t @@ -0,0 +1,38 @@ +#!/usr/bin/perl +use strict; +use warnings; + +use Test::More; +use File::Basename qw(dirname); +use lib dirname(dirname(__FILE__)); +use Test::DH; +use File::Path qw(make_path); +use Debian::Debhelper::Dh_Lib qw(!dirname); + +plan(tests => 2); + +our @TEST_DH_EXTRA_TEMPLATE_FILES = (qw( + debian/changelog + debian/control + debian/foo.pam +)); + +each_compat_up_to_and_incl_subtest(13, sub { + make_path(qw(debian/foo)); + ok(run_dh_tool('dh_installpam')); + + ok(-f 'debian/foo/etc/pam.d/foo'); + ok(! -f 'debian/foo/usr/lib/pam.d/foo'); + + ok(run_dh_tool('dh_clean')); +}); + +each_compat_from_and_above_subtest(14, sub { + make_path(qw(debian/foo)); + ok(run_dh_tool('dh_installpam')); + + ok(! -f 'debian/foo/etc/pam.d/foo'); + ok(-f 'debian/foo/usr/lib/pam.d/foo'); + + ok(run_dh_tool('dh_clean')); +}); diff --git a/t/dh_installsystemd/dh_installsystemd.t b/t/dh_installsystemd/dh_installsystemd.t index 096ac11809228ddfed7df964a23cd28ae222bcd3..bbb4eb0d12086d835e9f6da3dfceea478dbabc37 100755 --- a/t/dh_installsystemd/dh_installsystemd.t +++ b/t/dh_installsystemd/dh_installsystemd.t @@ -14,7 +14,7 @@ sub write_file { my ($path, $content) = @_; my $dir = dirname($path); - install_dir($dir); + mkdirs($dir); open(my $fd, '>>', $path) or error("open($path) failed: $!"); print {$fd} $content . '\n'; @@ -22,10 +22,9 @@ sub write_file { } sub unit_is_enabled { - my ($package, $unit, $num_enables, $num_masks) = @_; + my ($package, $unit, $num_enables) = @_; my @output; my $matches; - $num_masks = $num_masks // $num_enables; my @postinst_snippets = find_script($package, 'postinst'); @output=`cat @postinst_snippets` if @postinst_snippets; # Match exactly one tab; the "dont-enable" script has an "enable" @@ -33,10 +32,6 @@ sub unit_is_enabled { # But we do not want to include that in our count. $matches = grep { m{^\tif deb-systemd-helper .* was-enabled .*'\Q$unit\E\.service'} } @output; ok($matches == $num_enables) or diag("$unit appears to have been enabled $matches times (expected $num_enables)"); - my @postrm_snippets = find_script($package, 'postrm'); - @output=`cat @postrm_snippets` if @postrm_snippets; - $matches = grep { m{deb-systemd-helper mask.*'\Q$unit\E\.service'} } @output; - ok($matches == $num_masks) or diag("$unit appears to have been masked $matches times (expected $num_masks)"); } sub unit_is_started { @@ -111,7 +106,7 @@ each_compat_subtest { ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_installsystemd')); ok(-e 'debian/foo/lib/systemd/system/foo.service'); ok(find_script('foo', 'postinst')); @@ -121,8 +116,36 @@ each_compat_subtest { unit_is_started('foo', 'foo2', 1); ok(run_dh_tool('dh_clean')); + + # lib -> usr/lib (if we ever support that) + make_path('debian/foo/lib/systemd/system/'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + ok(run_dh_tool('dh_installsystemd')); + ok(-e 'debian/foo/lib/systemd/system/foo2.service'); + ok(find_script('foo', 'postinst')); + unit_is_enabled('foo', 'foo', 1); + unit_is_started('foo', 'foo', 1); + unit_is_enabled('foo', 'foo2', 1); + unit_is_started('foo', 'foo2', 1); + ok(run_dh_tool('dh_clean')); + + # lib -> usr/lib with both no-empty (if we ever suport that) + make_path('debian/foo/lib/systemd/system/'); + make_path('debian/foo/lib/systemd/system/'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/bar.service'); + ok(run_dh_tool('dh_installsystemd')); + ok(-e 'debian/foo/lib/systemd/system/bar.service'); + ok(-e 'debian/foo/lib/systemd/system/foo2.service'); + ok(find_script('foo', 'postinst')); + unit_is_enabled('foo', 'foo', 1); + unit_is_started('foo', 'foo', 1); + unit_is_enabled('foo', 'foo2', 1); + unit_is_started('foo', 'foo2', 1); + ok(run_dh_tool('dh_clean')); + make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_installsystemd', '--no-start')); ok(-e 'debian/foo/lib/systemd/system/foo.service'); ok(find_script('foo', 'postinst')); @@ -133,7 +156,7 @@ each_compat_subtest { ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_installsystemd', '-p', 'foo', '--no-start', 'foo.service')); ok(run_dh_tool('dh_installsystemd', '-p', 'foo', 'foo2.service')); ok(-e 'debian/foo/lib/systemd/system/foo.service'); @@ -145,12 +168,12 @@ each_compat_subtest { ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_installsystemd', '-p', 'foo', '--no-enable', 'foo.service')); ok(run_dh_tool('dh_installsystemd', '-p', 'foo', 'foo2.service')); ok(-e 'debian/foo/lib/systemd/system/foo.service'); ok(find_script('foo', 'postinst')); - unit_is_enabled('foo', 'foo', 0, 1); # Disabled units are still masked on removal + unit_is_enabled('foo', 'foo', 0); unit_is_started('foo', 'foo', 1, 1); unit_is_enabled('foo', 'foo2', 1); unit_is_started('foo', 'foo2', 1); @@ -166,7 +189,7 @@ each_compat_subtest { # Quoting #764730 make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo.service', 'debian/foo/lib/systemd/system/foo\x2dfuse.service'); + copy_file('debian/foo.service', 'debian/foo/lib/systemd/system/foo\x2dfuse.service'); ok(run_dh_tool('dh_installsystemd')); unit_is_enabled('foo', 'foo\x2dfuse', 1); unit_is_started('foo', 'foo\x2dfuse', 1); @@ -174,7 +197,7 @@ each_compat_subtest { # --name flag #870768 make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_installsystemd', '--name=foo')); unit_is_enabled('foo', 'foo', 1); unit_is_started('foo', 'foo', 1); @@ -188,7 +211,7 @@ each_compat_subtest { ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo.service', 'debian/foo/lib/systemd/system/target.service'); + copy_file('debian/foo.service', 'debian/foo/lib/systemd/system/target.service'); make_symlink_raw_target('target.service', 'debian/foo/lib/systemd/system/source.service'); ok(run_dh_tool('dh_installsystemd')); unit_is_enabled('foo', 'foo', 1); @@ -201,7 +224,7 @@ each_compat_subtest { each_compat_up_to_and_incl_subtest(11, sub { make_path('debian/foo/lib/systemd/system/'); make_path('debian/foo/etc/init.d/'); - install_file('debian/foo.service', 'debian/foo/lib/systemd/system/target.service'); + copy_file('debian/foo.service', 'debian/foo/lib/systemd/system/target.service'); make_symlink_raw_target('target.service', 'debian/foo/lib/systemd/system/source.service'); write_file('debian/foo/etc/init.d/source', '# something'); ok(run_dh_tool('dh_installsystemd')); @@ -218,7 +241,7 @@ each_compat_up_to_and_incl_subtest(11, sub { each_compat_from_and_above_subtest(12, sub { make_path('debian/foo/lib/systemd/system/'); make_path('debian/foo/etc/init.d/'); - install_file('debian/foo.service', 'debian/foo/lib/systemd/system/target.service'); + copy_file('debian/foo.service', 'debian/foo/lib/systemd/system/target.service'); make_symlink_raw_target('target.service', 'debian/foo/lib/systemd/system/source.service'); write_file('debian/foo/etc/init.d/source', '# something'); ok(run_dh_tool('dh_installsystemd')); diff --git a/t/dh_installsystemd/dh_systemd.t b/t/dh_installsystemd/dh_systemd.t index 64ade196c65e525a2b2ae132c1cbc64c2256485b..c3c94015c344a4cecb2769fa15ddba1f7ace9e35 100755 --- a/t/dh_installsystemd/dh_systemd.t +++ b/t/dh_installsystemd/dh_systemd.t @@ -18,19 +18,15 @@ our @TEST_DH_EXTRA_TEMPLATE_FILES = (qw( plan(tests => 1); sub unit_is_enabled { - my ($package, $unit, $num_enables, $num_masks) = @_; + my ($package, $unit, $num_enables) = @_; my @output; my $matches; - $num_masks = $num_masks // $num_enables; @output=`cat debian/$package.postinst.debhelper`; # Match exactly one tab; the "dont-enable" script has an "enable" # line for re-enabling the service if the admin had it enabled. # But we do not want to include that in our count. $matches = grep { m{^\tif deb-systemd-helper .* was-enabled .*'\Q$unit\E\.service'} } @output; ok($matches == $num_enables) or diag("$unit appears to have been enabled $matches times (expected $num_enables)"); - @output=`cat debian/$package.postrm.debhelper`; - $matches = grep { m{deb-systemd-helper mask.*'\Q$unit\E\.service'} } @output; - ok($matches == $num_masks) or diag("$unit appears to have been masked $matches times (expected $num_masks)"); } sub unit_is_started { my ($package, $unit, $num_starts, $num_stops) = @_; @@ -58,7 +54,7 @@ each_compat_from_x_to_and_incl_y_subtest(10, 10, sub { ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_systemd_enable')); ok(run_dh_tool('dh_systemd_start')); ok(-e "debian/foo/lib/systemd/system/foo.service"); @@ -70,7 +66,7 @@ each_compat_from_x_to_and_incl_y_subtest(10, 10, sub { ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_systemd_enable')); ok(run_dh_tool('dh_systemd_start', '--no-start')); ok(-e "debian/foo/lib/systemd/system/foo.service"); @@ -82,7 +78,7 @@ each_compat_from_x_to_and_incl_y_subtest(10, 10, sub { ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_systemd_enable')); ok(run_dh_tool('dh_systemd_start', '--no-start', 'debian/foo.service')); ok(run_dh_tool('dh_systemd_start', '-p', 'foo', 'foo2.service')); @@ -95,20 +91,20 @@ each_compat_from_x_to_and_incl_y_subtest(10, 10, sub { ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); + copy_file('debian/foo2.service', 'debian/foo/lib/systemd/system/foo2.service'); ok(run_dh_tool('dh_systemd_enable', '--no-enable', 'debian/foo.service')); ok(run_dh_tool('dh_systemd_enable', '-p', 'foo', 'foo2.service')); ok(run_dh_tool('dh_systemd_start')); ok(-e "debian/foo/lib/systemd/system/foo.service"); ok(-e "debian/foo.postinst.debhelper"); - unit_is_enabled('foo', 'foo', 0, 1); # Disabled units are still masked on removal + unit_is_enabled('foo', 'foo', 0); unit_is_started('foo', 'foo', 1, 1); unit_is_enabled('foo', 'foo2', 1); unit_is_started('foo', 'foo2', 1); ok(run_dh_tool('dh_clean')); make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo.service', 'debian/foo/lib/systemd/system/foo.service'); + copy_file('debian/foo.service', 'debian/foo/lib/systemd/system/foo.service'); ok(run_dh_tool('dh_systemd_start', '--no-restart-after-upgrade')); my $matches = grep { m{deb-systemd-invoke start .*foo.service} } `cat debian/foo.postinst.debhelper`; ok($matches == 1); @@ -116,7 +112,7 @@ each_compat_from_x_to_and_incl_y_subtest(10, 10, sub { # Quoting #764730 make_path('debian/foo/lib/systemd/system/'); - install_file('debian/foo.service', 'debian/foo/lib/systemd/system/foo\x2dfuse.service'); + copy_file('debian/foo.service', 'debian/foo/lib/systemd/system/foo\x2dfuse.service'); ok(run_dh_tool('dh_systemd_enable')); ok(run_dh_tool('dh_systemd_start')); unit_is_enabled('foo', 'foo\x2dfuse', 1); diff --git a/t/dh_installsystemduser/dh_installsystemduser.t b/t/dh_installsystemduser/dh_installsystemduser.t old mode 100644 new mode 100755 index 894eeb7a2474dcd6d585b9d422af93fec08f9002..51717280659b60263a7e2dafea73bb37fdf483ac --- a/t/dh_installsystemduser/dh_installsystemduser.t +++ b/t/dh_installsystemduser/dh_installsystemduser.t @@ -36,27 +36,50 @@ sub _unit_check_user_enabled { my $matches; my @postinst = read_script($package, 'postinst'); - # Match exactly one tab character. The "dont-enable" script has + # Match exactly two tab character. The "dont-enable" script has # an "enable" line for re-enabling the service if the admin had it # enabled, but we do not want to include that in our count. - $matches = grep { m{^\tif deb-systemd-helper( --\w+)* --user was-enabled.*'\Q$unit'} } @postinst; + $matches = grep { m{^\t\tif deb-systemd-helper( --\w+)* --user was-enabled.*'\Q$unit'} } @postinst; is($matches, $enabled, "$unit $verb enabled"); +} + +sub _unit_check_user_started { + my ($package, $unit, $started) = @_; + my $verb = $started ? "is" : "isnt"; + my $matches; + + my @postinst = read_script($package, 'postinst'); + # Match exactly two tab character. The "dont-enable" script has + # an "enable" line for re-enabling the service if the admin had it + # enabled, but we do not want to include that in our count. + $matches = grep { m{deb-systemd-invoke --user restart.*'\Q$unit'} } @postinst; + is($matches, $started, "$unit $verb started"); - my @postrm = read_script($package, 'postrm'); - $matches = grep { m{deb-systemd-helper( --\w+)* --user mask.*'\Q$unit'} } @postrm; - is($matches, $enabled, "$unit $verb masked"); + my @prerm = read_script($package, 'prerm'); + $matches = grep { m{deb-systemd-invoke --user stop.*'\Q$unit'} } @prerm; + is($matches, $started, "$unit $verb stopped"); } sub is_enabled { _unit_check_user_enabled(@_, 1); } sub isnt_enabled { _unit_check_user_enabled(@_, 0); } +sub is_started { _unit_check_user_started(@_, 1); } +sub isnt_started { _unit_check_user_started(@_, 0); } each_compat_subtest { + my ($compat) = @_; make_path('debian/foo/usr/lib/systemd/user/'); - install_file('debian/foo.user.service', 'debian/foo/usr/lib/systemd/user/bar.service'); + copy_file('debian/foo.user.service', 'debian/foo/usr/lib/systemd/user/bar.service'); ok(run_dh_tool('dh_installsystemduser')); ok(-e 'debian/foo/usr/lib/systemd/user/foo.service'); is_enabled('foo', 'foo.service'); is_enabled('foo', 'bar.service'); + if ($compat > 13) { + is_started('foo', 'foo.service'); + is_started('foo', 'bar.service'); + } else { + isnt_started('foo', 'foo.service'); + isnt_started('foo', 'bar.service'); + } ok(run_dh_tool('dh_clean')); ok(run_dh_tool('dh_installsystemduser')); @@ -64,6 +87,13 @@ each_compat_subtest { ok(! -e 'debian/foo/usr/lib/systemd/user/baz.service'); is_enabled('foo', 'foo.service'); isnt_enabled('foo', 'baz.service'); + if ($compat > 13) { + is_started('foo', 'foo.service'); + isnt_started('foo', 'baz.service'); + } else { + isnt_started('foo', 'bar.service'); + isnt_started('foo', 'baz.service'); + } ok(run_dh_tool('dh_clean')); ok(run_dh_tool('dh_installsystemduser', '--name', 'baz')); @@ -71,5 +101,12 @@ each_compat_subtest { ok(-e 'debian/foo/usr/lib/systemd/user/baz.service'); isnt_enabled('foo', 'foo.service'); is_enabled('foo', 'baz.service'); + if ($compat > 13) { + isnt_started('foo', 'foo.service'); + is_started('foo', 'baz.service'); + } else { + isnt_started('foo', 'foo.service'); + isnt_started('foo', 'baz.service'); + } ok(run_dh_tool('dh_clean')); }; diff --git a/t/dh_link/03-894229.t b/t/dh_link/03-894229.t index 10542f418cb0365aa082db42d0d63bf2be446896..d42a39282228a290438a1513cd1e0338ca995774 100755 --- a/t/dh_link/03-894229.t +++ b/t/dh_link/03-894229.t @@ -40,7 +40,7 @@ each_compat_subtest { remove_tree('debian/debhelper/a/b/c'); - install_dir('debian/debhelper/a/b/c'); + mkdirs('debian/debhelper/a/b/c'); test_invalid('../../wow', 'a'); # This is a can be made valid but at the moment we do not support diff --git a/t/dh_usrlocal/01-basic.t b/t/dh_usrlocal/01-basic.t index 2cd3f842bbe76013835d762deaaffeb23f9928e2..9b05516159f1474287d4a7584b04e31ef81da673 100755 --- a/t/dh_usrlocal/01-basic.t +++ b/t/dh_usrlocal/01-basic.t @@ -43,7 +43,7 @@ sub perform_test { rm_files(@scripts); remove_tree('debian/debhelper'); - install_dir(map { "debian/debhelper/$_" } @{$install_dirs}); + mkdirs(map { "debian/debhelper/$_" } @{$install_dirs}); ok(run_dh_tool('dh_usrlocal'));