Document reverse-resolving diversions when defaulting DEB_CHECK_FILES_SOURCE.

diff --git a/config-package.mk b/config-package.mk
index 61bd54d150e640ef93a8e51865bb2040c997635e..9cd7802a8afb7d254c2ac068cb95ea5868eac986 100644 (file)
--- a/config-package.mk
+++ b/config-package.mk
@@ -68,7 +68,11 @@
 # (potentially long) configuration file that will work on several
 # Debian versions.  We recommend using DEB_TRANSFORM_FILES in
 # conjunction with pbuilder, sbuild, or another tool for building
-# Debian packages in a clean environment.
+# Debian packages in a clean environment. (That said, if /path/file is
+# diverted on the running system, DEB_CHECK_FILES_SOURCE does
+# reverse-resolve the diversion and default to the original version of
+# the file, to allow you to rebuild a package using DEB_TRANSFORM_FILES
+# that is currently installed, in most cases.)
 #
 # DEB_REMOVE_FILES_package += /path/file
 #