diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 21:06:40 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-27 21:06:40 +0000 |
commit | d827c6cf1631209f5042a9d1d8a7ecc24223c8a0 (patch) | |
tree | 91a431d301efd0e524bdfb0c46e97d591a9d7b03 /debhelper-obsolete-compat.pod | |
parent | Initial commit. (diff) | |
download | debhelper-317edf61ca7b4a9acdf8a38e4b634bad6c07ddf6.tar.xz debhelper-317edf61ca7b4a9acdf8a38e4b634bad6c07ddf6.zip |
Adding upstream version 13.11.4.upstream/13.11.4upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to '')
-rw-r--r-- | debhelper-obsolete-compat.pod | 188 |
1 files changed, 188 insertions, 0 deletions
diff --git a/debhelper-obsolete-compat.pod b/debhelper-obsolete-compat.pod new file mode 100644 index 0000000..965c894 --- /dev/null +++ b/debhelper-obsolete-compat.pod @@ -0,0 +1,188 @@ +=head1 NAME + +debhelper-obsolete-compat - List of no longer supported compat levels + +=head1 SYNOPSIS + +This document contains the upgrade guidelines from all compat levels +which are no longer supported. Accordingly it is mostly for +historical purposes and to assist people upgrading from a +non-supported compat level to a supported level. + +For upgrades from supported compat levels, please see L<debhelper(7)>. + +=head1 UPGRADE LIST FOR COMPAT LEVELS + +The following is the list of now obsolete compat levels and their +changes. + +=over 4 + +=item v7 + +This is the lowest supported compatibility level. + +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 + +=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 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: + +=over 8 + +=item - + +B<dh_makeshlibs -V> will not include the Debian part of the version number in +the generated dependency line in the shlibs file. + +=item - + +You are encouraged to put the new B<${misc:Depends}> into F<debian/control> to +supplement the B<${shlibs:Depends}> field. + +=item - + +B<dh_fixperms> will make all files in F<bin/> directories and in F<etc/init.d> +executable. + +=item - + +B<dh_link> will correct existing links to conform with policy. + +=back + +This mode is deprecated. + +=item v3 + +This mode works like v2, with the following additions: + +=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. + +=item - + +B<dh_makeshlibs> makes the F<postinst> and F<postrm> scripts call B<ldconfig>. + +=item - + +Every file in F<etc/> is automatically flagged as a conffile by B<dh_installdeb>. + +=back + +This mode is deprecated. + +=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 + +=head1 SEE ALSO + +L<debhelper(7)> + +=head1 AUTHORS + +Niels Thykier <niels@thykier.net> + +Joey Hess + +=cut |