update manpage last-modified from git via pre-export hook

Never updating this information is wrong, updating it automatically
isn't super correct either, but it seems conventional to have it and
updating it more often than needed seems better than updating it never.

Git-Dch: Ignore

14 files changed, 23 insertions, 15 deletions

diff --git a/doc/apt-cache.8.xml b/doc/apt-cache.8.xml
index a76eb1000..71bbca60d 100644
--- a/doc/apt-cache.8.xml
+++ b/doc/apt-cache.8.xml
@@ -14,7 +14,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2015-10-27T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/doc/apt-cdrom.8.xml b/doc/apt-cdrom.8.xml
index 23b26adaf..8f883c1a3 100644
--- a/doc/apt-cdrom.8.xml
+++ b/doc/apt-cdrom.8.xml
@@ -13,7 +13,7 @@
    &apt-author.team;
    &apt-email;
    &apt-product;
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2013-11-30T00:00:00Z</date>
  </refentryinfo>
 
  <refmeta>
diff --git a/doc/apt-config.8.xml b/doc/apt-config.8.xml
index f35f2488c..cf2e87c62 100644
--- a/doc/apt-config.8.xml
+++ b/doc/apt-config.8.xml
@@ -14,7 +14,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2013-11-30T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/doc/apt-extracttemplates.1.xml b/doc/apt-extracttemplates.1.xml
index 4a1f7213a..cb1332de0 100644
--- a/doc/apt-extracttemplates.1.xml
+++ b/doc/apt-extracttemplates.1.xml
@@ -14,7 +14,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2014-03-27T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/doc/apt-ftparchive.1.xml b/doc/apt-ftparchive.1.xml
index edebb0808..d1e512242 100644
--- a/doc/apt-ftparchive.1.xml
+++ b/doc/apt-ftparchive.1.xml
@@ -14,7 +14,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2015-10-28T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml
index 785b4e9a8..60fa46f97 100644
--- a/doc/apt-get.8.xml
+++ b/doc/apt-get.8.xml
@@ -14,7 +14,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2015-08-14T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/doc/apt-key.8.xml b/doc/apt-key.8.xml
index 41628aff6..b5319efa3 100644
--- a/doc/apt-key.8.xml
+++ b/doc/apt-key.8.xml
@@ -13,7 +13,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2015-10-15T00:00:00Z</date>
  </refentryinfo>
 
  <refmeta>
diff --git a/doc/apt-secure.8.xml b/doc/apt-secure.8.xml
index 029931205..1cf6539c6 100644
--- a/doc/apt-secure.8.xml
+++ b/doc/apt-secure.8.xml
@@ -13,7 +13,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2015-10-14T00:00:00Z</date>
+   <date>2015-10-15T00:00:00Z</date>
  </refentryinfo>
 
  <refmeta>
diff --git a/doc/apt-sortpkgs.1.xml b/doc/apt-sortpkgs.1.xml
index c1f327fe8..b7f199306 100644
--- a/doc/apt-sortpkgs.1.xml
+++ b/doc/apt-sortpkgs.1.xml
@@ -14,7 +14,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2013-11-30T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/doc/apt.8.xml b/doc/apt.8.xml
index 4135ef842..0529a90fb 100644
--- a/doc/apt.8.xml
+++ b/doc/apt.8.xml
@@ -13,7 +13,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2013-11-25T00:00:00Z</date>
+   <date>2015-10-20T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index 2bb814257..e6cbc8bc4 100644
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -19,7 +19,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2015-10-16T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml
index 79132e007..513a0c135 100644
--- a/doc/apt_preferences.5.xml
+++ b/doc/apt_preferences.5.xml
@@ -13,7 +13,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2012-06-09T00:00:00Z</date>
+   <date>2015-08-15T00:00:00Z</date>
  </refentryinfo>
 
  <refmeta>
diff --git a/doc/sources.list.5.xml b/doc/sources.list.5.xml
index 8cebc536c..3b674c35f 100644
--- a/doc/sources.list.5.xml
+++ b/doc/sources.list.5.xml
@@ -14,7 +14,7 @@
    &apt-email;
    &apt-product;
    <!-- The last update date -->
-   <date>2014-01-18T00:00:00Z</date>
+   <date>2015-09-14T00:00:00Z</date>
  </refentryinfo>
  
  <refmeta>
diff --git a/prepare-release b/prepare-release
index 8b625e04c..8605719b1 100755
--- a/prepare-release
+++ b/prepare-release
@@ -56,6 +56,14 @@ if [ "$1" = 'pre-export' ]; then
 	sed -i -e "s/^PACKAGE_VERSION=\".*\"$/PACKAGE_VERSION=\"${VERSION}\"/" configure.ac
 	sed -i -e "s/^<!ENTITY apt-product-version \".*\">$/<!ENTITY apt-product-version \"${VERSION}\">/" doc/apt-verbatim.ent
 
+	# update the last-modification field of manpages based on git changes
+	grep --files-with-matches '<date>' doc/*.xml | while read file; do \
+		LASTMOD="$(date -d "@$(git log --format='%at' --max-count=1 --invert-grep --fixed-strings --grep 'review
+typo
+Git-Dch: Ignore' "$file")" '+%Y-%m-%dT00:00:00Z')"
+		sed -i -e "s#^\([ ]\+\)<date>.*</date>\$#\1<date>$LASTMOD</date>#" "$file"
+	done
+
 	if [ "$(date +%Y-%m-%d)" != "$(grep --max-count=1 '^"POT-Creation-Date: .*\n"$' po/apt-all.pot | cut -d' ' -f 2)" -o \
 	     "$(date +%Y-%m-%d)" != "$(grep --max-count=1 '^"POT-Creation-Date: .*\n"$' doc/po/apt-doc.pot | cut -d' ' -f 2)" ]; then
 		echo >&2 'POT files are not up-to-date. Execute »make update-po« for you…'
@@ -63,7 +71,7 @@ if [ "$1" = 'pre-export' ]; then
 	fi
 elif [ "$1" = 'post-build' ]; then
 	if [ "$DISTRIBUTION" != "UNRELEASED" ]; then
-		echo >&2 "REMEMBER: Tag this release with »git tag ${VERSION}« if you are satisfied"
+		echo >&2 "REMEMBER: Tag this release with »git tag -s ${VERSION}« if you are satisfied"
 	else
 		echo >&2 'REMEMBER: Change to a valid distribution before release'
 	fi
@@ -160,7 +168,7 @@ else
 	echo >&1 "Usage:\t$0 pre-export
 \t$0 post-build
 
-If you use »git buildpackage« you can leave these alone as they will
+If you use »gbp buildpackage« you can leave these alone as they will
 be run at the right places auto-magically. Otherwise you should use
 »pre-export« to update po and pot files as well as version numbering.
 »post-build« can be used to run some more or less useful checks later on.