r1980: * prerm and postrm scripts are now generated in a reverse order than

[debhelper.git] / debhelper.pod

diff --git a/debhelper.pod b/debhelper.pod
index 76ee5eb6b8dcc5759a217dcf76b3496fd8effeb9..123f72675d3434305eec5ccb08557ea41d9d8535 100644 (file)
--- a/debhelper.pod
+++ b/debhelper.pod
@@ -64,7 +64,8 @@ file can be found.
 
 In some rare cases, you may want to have different versions of these files
 for different architectures. If files named debian/package.foo.arch
-exist, where "arch" is the same as the output of "dpkg --print-architecture",
+exist, where "arch" is the same as the output of 
+"dpkg-architecture -qDEB_HOST_ARCH",
 then they will be used in preference to other, more general files.
 
 In many cases, these config files are used to specify various types of
@@ -245,9 +246,16 @@ introduced. You tell debhelper which compatibility level it should use, and
 it modifies its behavior in various ways.
 
 Tell debhelper what compatibility level to use by writing a number to
-debian/compat. For example, to turn on V4 mode:
+debian/compat. For example, to turn on V5 mode:
 
-  % echo 4 > debian/compat
+  % echo 5 > debian/compat
+
+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
+if you are not using the most recent compatibility level, you're advised to
+read below for notes about what is different in earlier compatibility
+levels.
 
 These are the available compatibility levels:
 
@@ -290,10 +298,11 @@ Every file in etc/ is automatically flagged as a conffile by dh_installdeb.
 
 =back
 
+This mode is deprecated.
+
 =item V4
 
-This is the recommended mode of operation. It does everything V3 does,
-plus:
+Changes from V3 are:
 
 =over 8
 
@@ -320,7 +329,8 @@ dh_link will correct existing links to conform with policy.
 
 =item V5
 
-This mode is still under development. Its changes from V4 are:
+This is the recommended mode of operation. It does everything V4 does,
+plus:
 
 =over 8
 
@@ -337,8 +347,34 @@ symbols in, not the packages to take the symbols from.
 
 dh_installdocs skips installing empty files.
 
+=item -
+
+dh_install errors out if wildcards expand to nothing.
+
 =back
 
+=item V6
+
+This mode is still under development. Currently it has these differences
+compared to V5:
+
+=over 8
+
+=item -
+
+dh_installwm will install a slave manpage link for x-window-manager.1.gz.
+
+=item -
+
+dh_builddeb did not previously delete everything matching
+DH_ALWAYS_EXCLUDE, if it was set to a list of things to exclude, such as
+"CVS:.svn". Now it does.
+
+=item -
+
+dh_installman allows overwriting existing man pages in the package build
+directory. In previous compatability levels it silently refuses to do this.
+
 =back
 
 =head2 Doc directory symlinks
@@ -373,9 +409,9 @@ Once your package uses debhelper to build, be sure to add
 debhelper to your Build-Depends line in debian/control. You should
 build-depend on a version of debhelper equal to (or greater than) the
 debhelper compatibility level your package uses. So if your package used
-compatibility level 4:
+compatibility level 5:
 
-  Build-Depends: debhelper (>= 4)
+  Build-Depends: debhelper (>= 5)
 
 =head1 ENVIRONMENT