Browse Source

man: Generate the man pages at build time

This makes it possible to filter them and update several variable
strings such as system and package pathnames, the release date and
the dpkg suite version. And will make it possible to use UTF-8 in
the source and convert to the more conservative groff escape
sequences on the output.
Guillem Jover 7 years ago
parent
commit
75439a3267
59 changed files with 404 additions and 195 deletions
  1. 1 0
      configure.ac
  2. 5 0
      debian/changelog
  3. 8 0
      m4/dpkg-build.m4
  4. 5 0
      man/.gitignore
  5. 115 15
      man/Makefile.am
  6. 1 1
      man/deb-changelog.5
  7. 1 1
      man/deb-changes.5
  8. 5 5
      man/deb-conffiles.5
  9. 1 1
      man/deb-control.5
  10. 1 1
      man/deb-extra-override.5
  11. 1 1
      man/deb-old.5
  12. 3 3
      man/deb-origin.5
  13. 1 1
      man/deb-override.5
  14. 1 1
      man/deb-postinst.5
  15. 1 1
      man/deb-postrm.5
  16. 1 1
      man/deb-preinst.5
  17. 1 1
      man/deb-prerm.5
  18. 1 1
      man/deb-shlibs.5
  19. 1 1
      man/deb-split.5
  20. 1 1
      man/deb-src-control.5
  21. 1 1
      man/deb-src-files.5
  22. 1 1
      man/deb-substvars.5
  23. 1 1
      man/deb-symbols.5
  24. 2 1
      man/deb-triggers.5
  25. 1 1
      man/deb-version.5
  26. 1 1
      man/deb.5
  27. 1 1
      man/deb822.5
  28. 7 7
      man/dpkg-architecture.1
  29. 8 8
      man/dpkg-buildflags.1
  30. 3 3
      man/dpkg-buildpackage.1
  31. 2 2
      man/dpkg-checkbuilddeps.1
  32. 1 1
      man/dpkg-deb.1
  33. 1 1
      man/dpkg-distaddfile.1
  34. 3 3
      man/dpkg-divert.1
  35. 1 1
      man/dpkg-genchanges.1
  36. 1 1
      man/dpkg-gencontrol.1
  37. 1 1
      man/dpkg-gensymbols.1
  38. 1 1
      man/dpkg-maintscript-helper.1
  39. 1 1
      man/dpkg-mergechangelogs.1
  40. 1 1
      man/dpkg-name.1
  41. 1 1
      man/dpkg-parsechangelog.1
  42. 4 4
      man/dpkg-query.1
  43. 1 1
      man/dpkg-scanpackages.1
  44. 1 1
      man/dpkg-scansources.1
  45. 11 11
      man/dpkg-shlibdeps.1
  46. 1 1
      man/dpkg-source.1
  47. 3 3
      man/dpkg-split.1
  48. 3 3
      man/dpkg-statoverride.1
  49. 3 2
      man/dpkg-trigger.1
  50. 4 4
      man/dpkg-vendor.1
  51. 3 3
      man/dpkg.cfg.5
  52. 19 19
      man/dpkg.1
  53. 1 1
      man/dsc.5
  54. 3 3
      man/dselect.cfg.5
  55. 4 4
      man/dselect.1
  56. 52 52
      man/po/po4a.cfg
  57. 1 1
      man/start-stop-daemon.8
  58. 7 7
      man/update-alternatives.1
  59. 88 0
      man/utf8toman.sed

+ 1 - 0
configure.ac

@@ -43,6 +43,7 @@ DPKG_BUILD_PROG([dselect])
 DPKG_BUILD_PROG([start-stop-daemon])
 DPKG_BUILD_PROG([update-alternatives])
 
+DPKG_BUILD_RELEASE_DATE
 DPKG_BUILD_DEVEL_DOCS
 
 # Allow alternate directories

+ 5 - 0
debian/changelog

@@ -23,6 +23,11 @@ dpkg (1.18.11) UNRELEASED; urgency=medium
     - Improve user-defined field export marker documentation in
       deb-src-control(5); clarify that X can be followed by zero or more
       (instead of one or more) letters and turn the items into a proper list.
+    - Generate the man pages at build time. This makes it possible to process
+      them and update several variable strings such as system and package
+      pathnames, the release date and the dpkg suite version. And makes it
+      possible to use UTF-8 in the source and convert to the more conservative
+      groff escape sequences on the output.
   * Build system:
     - Add support for profiling perl modules.
     - Clean up compiler and linker automatic flag usage in configure.

+ 8 - 0
m4/dpkg-build.m4

@@ -10,6 +10,14 @@ AC_DEFUN([DPKG_BUILD_SHARED_LIBS], [
   AM_CONDITIONAL([BUILD_SHARED], [test "$enable_shared" = "yes"])
 ])# DPKG_BUILD_SHARED_LIBS
 
+# DPKG_BUILD_RELEASE_DATE()
+# -----------------------
+AC_DEFUN([DPKG_BUILD_RELEASE_DATE], [
+  TIMESTAMP=$(PERL=$PERL $srcdir/run-script scripts/dpkg-parsechangelog.pl -l$srcdir/debian/changelog -STimestamp)
+  PACKAGE_RELEASE_DATE=$(date --date="@$TIMESTAMP" +%Y-%m-%d)
+  AC_SUBST([PACKAGE_RELEASE_DATE])
+])# DPKG_BUILD_RELEASE_DATE
+
 # DPKG_BUILD_PROG(PROG)
 # ---------------
 # Allow disabling compilation and usage of specific programs.

+ 5 - 0
man/.gitignore

@@ -1,3 +1,8 @@
+# Generated man pages
+*.1
+*.5
+*.8
+# Translated man pages
 de
 es
 fr

+ 115 - 15
man/Makefile.am

@@ -1,6 +1,6 @@
 ## Process this file with automake to produce Makefile.in
 
-dist_man_MANS = \
+man_MANS = \
 	deb-changelog.5 \
 	deb-changes.5 \
 	deb-conffiles.5 \
@@ -52,22 +52,77 @@ dist_man_MANS = \
 	$(nil)
 
 if BUILD_DSELECT
-dist_man_MANS += \
+man_MANS += \
 	dselect.1 \
 	dselect.cfg.5
 endif
 
 if BUILD_START_STOP_DAEMON
-dist_man_MANS += \
+man_MANS += \
 	start-stop-daemon.8
 endif
 
 if BUILD_UPDATE_ALTERNATIVES
-dist_man_MANS += \
+man_MANS += \
 	update-alternatives.1
 endif
 
+CLEANFILES = $(man_MANS)
+
 EXTRA_DIST = \
+	deb-changelog.man \
+	deb-changes.man \
+	deb-conffiles.man \
+	deb-control.man \
+	deb-extra-override.man \
+	deb-old.man \
+	deb-origin.man \
+	deb-override.man \
+	deb-postinst.man \
+	deb-postrm.man \
+	deb-preinst.man \
+	deb-prerm.man \
+	deb-shlibs.man \
+	deb-split.man \
+	deb-src-control.man \
+	deb-src-files.man \
+	deb-substvars.man \
+	deb-symbols.man \
+	deb-triggers.man \
+	deb-version.man \
+	deb.man \
+	deb822.man \
+	dpkg-architecture.man \
+	dpkg-buildflags.man \
+	dpkg-buildpackage.man \
+	dpkg-checkbuilddeps.man \
+	dpkg-deb.man \
+	dpkg-distaddfile.man \
+	dpkg-divert.man \
+	dpkg-genchanges.man \
+	dpkg-gencontrol.man \
+	dpkg-gensymbols.man \
+	dpkg-maintscript-helper.man \
+	dpkg-mergechangelogs.man \
+	dpkg-name.man \
+	dpkg-parsechangelog.man \
+	dpkg-query.man \
+	dpkg-scanpackages.man \
+	dpkg-scansources.man \
+	dpkg-shlibdeps.man \
+	dpkg-source.man \
+	dpkg-split.man \
+	dpkg-statoverride.man \
+	dpkg-trigger.man \
+	dpkg-vendor.man \
+	dpkg.man \
+	dpkg.cfg.man \
+	dsc.man \
+	dselect.man \
+	dselect.cfg.man \
+	start-stop-daemon.man \
+	update-alternatives.man \
+	utf8toman.sed \
 	po/ChangeLog.old \
 	po/po4a.cfg \
 	po/dpkg-man.pot
@@ -93,7 +148,25 @@ PO4A_OPTS = --previous --srcdir $(srcdir) --destdir $(builddir) --no-backups \
 all-local: all-local-@USE_PO4A@
 
 all-local-no:
-all-local-yes: man.stamp
+all-local-yes: gen-man
+
+# We use the man-once target to guarantee there is never an empty call in
+# gen-man, that starts recursing infinitely.
+.PHONY: gen-man man-once
+
+gen-man: man.stamp
+	for lang in $(LINGUAS); do \
+	  files=""; \
+	  for man in $(man_MANS); do \
+	    trans="$${man%%.[0-9]}.man"; \
+	    if [ -f $(builddir)/$$lang/$$trans ]; then \
+	      files="$$files $(builddir)/$$lang/$$man"; \
+	    elif [ -f $(srcdir)/$$lang/$$trans ]; then \
+	      files="$$files $(srcdir)/$$lang/$$man"; \
+	    fi; \
+	  done; \
+	  $(MAKE) mandir="$(mandir)/$$lang" man_MANS="" man-once $$files; \
+	done
 
 # FIXME: Use a stamp file until po4a supports them internally.
 man.stamp:
@@ -112,21 +185,48 @@ clean-local-yes:
 update-po:
 	$(PO4A_V) $(PO4A) $(PO4A_OPTS) --force $(srcdir)/po/po4a.cfg
 
+SUFFIXES = .man
+
+MANGEN_V = $(MANGEN_V_@AM_V@)
+MANGEN_V_ = $(MANGEN_V_@AM_DEFAULT_V@)
+MANGEN_V_0 = @echo "  MANGEN $@";
+
+MANGEN = $(MANGEN_V) sed \
+	-f $(srcdir)/utf8toman.sed \
+	-e 's/%PACKAGE%/$(PACKAGE)/g' \
+	-e 's/%VERSION%/$(PACKAGE_VERSION)/g' \
+	-e 's/%RELEASE_DATE%/$(PACKAGE_RELEASE_DATE)/g' \
+	-e 's:%CONFDIR%:$(sysconfdir):g' \
+	-e 's:%LOGDIR%:$(logdir):g' \
+	-e 's:%ADMINDIR%:$(admindir):g' \
+	-e 's:%PKGDOCDIR%:$(docdir):g' \
+	-e 's:%PKGCONFDIR%:$(pkgconfdir):g' \
+	-e 's:%PKGLIBDIR%:$(pkglibdir):g' \
+	-e 's:%PKGDATADIR%:$(pkgdatadir):g'
+	$(nil)
+
+.man.1: Makefile
+	$(MANGEN) $< >$@
+.man.5: Makefile
+	$(MANGEN) $< >$@
+.man.8: Makefile
+	$(MANGEN) $< >$@
+
 install-data-local: install-data-local-@USE_PO4A@
 
 install-data-local-no:
 install-data-local-yes:
 	for lang in $(LINGUAS); do \
 	  files=""; \
-	  for trans in $(dist_man_MANS); do \
+	  for man in $(man_MANS); do \
+	    trans="$${man%%.[0-9]}.man"; \
 	    if [ -f $(builddir)/$$lang/$$trans ]; then \
-	      files="$$files $(builddir)/$$lang/$$trans"; \
+	      files="$$files $(builddir)/$$lang/$$man"; \
 	    elif [ -f $(srcdir)/$$lang/$$trans ]; then \
-	      files="$$files $(srcdir)/$$lang/$$trans"; \
+	      files="$$files $(srcdir)/$$lang/$$man"; \
 	    fi; \
 	  done; \
-	  $(MAKE) install-man mandir="$(mandir)/$$lang" man_MANS="" \
-	          dist_man_MANS="$$files"; \
+	  $(MAKE) install-man mandir="$(mandir)/$$lang" man_MANS="$$files"; \
 	done
 
 uninstall-local: uninstall-local-@USE_PO4A@
@@ -135,15 +235,15 @@ uninstall-local-no:
 uninstall-local-yes:
 	for lang in $(LINGUAS); do \
 	  files=""; \
-	  for trans in $(dist_man_MANS); do \
+	  for man in $(man_MANS); do \
+	    trans="$${man%%.[0-9]}.man"; \
 	    if [ -f $(builddir)/$$lang/$$trans ]; then \
-	      files="$$files $(builddir)/$$lang/$$trans"; \
+	      files="$$files $(builddir)/$$lang/$$man"; \
 	    elif [ -f $(srcdir)/$$lang/$$trans ]; then \
-	      files="$$files $(srcdir)/$$lang/$$trans"; \
+	      files="$$files $(srcdir)/$$lang/$$man"; \
 	    fi; \
 	  done; \
-	  $(MAKE) uninstall-man mandir="$(mandir)/$$lang" man_MANS="" \
-	          dist_man_MANS="$$files"; \
+	  $(MAKE) uninstall-man mandir="$(mandir)/$$lang" man_MANS="$$files"; \
 	done
 
 dist-hook: man.stamp

+ 1 - 1
man/deb-changelog.5

@@ -22,7 +22,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb-changelog 5 "2015-06-01" "Debian Project" "Debian"
+.TH deb-changelog 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb\-changelog \- dpkg source packages' changelog file format
 .

+ 1 - 1
man/deb-changes.5

@@ -17,7 +17,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-changes 5 "2015-06-01" "Debian Project" "Debian"
+.TH deb\-changes 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb\-changes \- Debian changes file format
 .

+ 5 - 5
man/deb-conffiles.5

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-conffiles 5 "2016-07-07" "Debian Project" "dpkg utilities"
+.TH deb\-conffiles 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-conffiles \- package conffiles
 .
@@ -31,10 +31,10 @@ Trailing whitespace will be trimmed, and empty lines will be ignored.
 .
 .SH EXAMPLE
 .nf
-/etc/alternatives/README
-/etc/cron.daily/dpkg
-/etc/dpkg/dpkg.cfg
-/etc/logrotate.d/dpkg
+%CONFDIR%/alternatives/README
+%CONFDIR%/cron.daily/dpkg
+%PKGCONFDIR%/dpkg.cfg
+%CONFDIR%/logrotate.d/dpkg
 .fi
 .
 .SH SEE ALSO

+ 1 - 1
man/deb-control.5

@@ -19,7 +19,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-control 5 "2013-12-20" "Debian Project" "Debian"
+.TH deb\-control 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb\-control \- Debian binary packages' master control file format
 .

+ 1 - 1
man/deb-extra-override.5

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-extra\-override 5 "2009-08-16" "Debian Project" "dpkg utilities"
+.TH deb\-extra\-override 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-extra\-override \- Debian archive extra override file
 .

+ 1 - 1
man/deb-old.5

@@ -17,7 +17,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-old 5 "2011-08-14" "Debian Project" "Debian"
+.TH deb\-old 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb\-old \- old style Debian binary package format
 .

+ 3 - 3
man/deb-origin.5

@@ -16,13 +16,13 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-origin 5 "2011-11-10" "Debian Project" "Debian"
+.TH deb\-origin 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb\-origin \- Vendor-specific information files
 .SH SYNOPSIS
-.BI /etc/dpkg/origins/ filename
+.BI %PKGCONFDIR%/origins/ filename
 .SH DESCRIPTION
-The files in \fB/etc/dpkg/origins\fP can provide information about
+The files in \fB%PKGCONFDIR%/origins\fP can provide information about
 various vendors who are providing Debian packages.
 
 They contain a number of fields, or comments when the line starts with

+ 1 - 1
man/deb-override.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-override 5 "2011-08-14" "Debian Project" "dpkg utilities"
+.TH deb\-override 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-override \- Debian archive override file
 .

+ 1 - 1
man/deb-postinst.5

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-postinst 5 "2016-08-16" "Debian Project" "dpkg utilities"
+.TH deb\-postinst 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-postinst \- package post-installation maintainer script
 .

+ 1 - 1
man/deb-postrm.5

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-postrm 5 "2016-08-16" "Debian Project" "dpkg utilities"
+.TH deb\-postrm 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-postrm \- package post-removal maintainer script
 .

+ 1 - 1
man/deb-preinst.5

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-preinst 5 "2016-08-16" "Debian Project" "dpkg utilities"
+.TH deb\-preinst 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-preinst \- package pre-installation maintainer script
 .

+ 1 - 1
man/deb-prerm.5

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-prerm 5 "2016-08-16" "Debian Project" "dpkg utilities"
+.TH deb\-prerm 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-prerm \- package pre-removal maintainer script
 .

+ 1 - 1
man/deb-shlibs.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-shlibs 5 "2012-02-08" "Debian Project" "dpkg utilities"
+.TH deb\-shlibs 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-shlibs \- Debian shared library information file
 .

+ 1 - 1
man/deb-split.5

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-split 5 "2012-04-09" "Debian Project" "Debian"
+.TH deb\-split 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb\-split \- Debian multi-part binary package format
 .SH SYNOPSIS

+ 1 - 1
man/deb-src-control.5

@@ -17,7 +17,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-src\-control 5 "2013-12-20" "Debian Project" "Debian"
+.TH deb\-src\-control 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb\-src\-control \- Debian source packages' master control file format
 .

+ 1 - 1
man/deb-src-files.5

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-src\-files 5 "2016-08-16" "Debian Project" "dpkg utilities"
+.TH deb\-src\-files 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-src\-files \- Debian distribute files format
 .

+ 1 - 1
man/deb-substvars.5

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-substvars 5 "2015-01-20" "Debian Project" "dpkg utilities"
+.TH deb\-substvars 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-substvars \- Debian source substitution variables
 .

+ 1 - 1
man/deb-symbols.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-symbols 5 "2011-08-14" "Debian Project" "dpkg utilities"
+.TH deb\-symbols 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-symbols \- Debian's extended shared library information file
 .

+ 2 - 1
man/deb-triggers.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-triggers 5 "2014-10-15" "Debian Project" "dpkg utilities"
+.TH deb\-triggers 5 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 deb\-triggers \- package triggers
 .
@@ -90,4 +90,5 @@ those directives.
 .SH SEE ALSO
 .BR dpkg\-trigger (1),
 .BR dpkg (1),
+.\" FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev.
 .BR /usr/share/doc/dpkg\-dev/triggers.txt.gz .

+ 1 - 1
man/deb-version.5

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb\-version 5 "2013-04-02" "Debian Project" "Debian"
+.TH deb\-version 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb\-version \- Debian package version number format
 .

+ 1 - 1
man/deb.5

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb 5 "2014-05-24" "Debian Project" "Debian"
+.TH deb 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb \- Debian binary package format
 .SH SYNOPSIS

+ 1 - 1
man/deb822.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH deb822 5 "2015-06-01" "Debian Project" "Debian"
+.TH deb822 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 deb822 \- Debian RFC822 control data format
 .

+ 7 - 7
man/dpkg-architecture.1

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-architecture 1 "2013-03-28" "Debian Project" "dpkg utilities"
+.TH dpkg\-architecture 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-architecture \- set and determine the architecture for package building
 .
@@ -222,21 +222,21 @@ All these files have to be present for \fBdpkg\-architecture\fP to
 work. Their location can be overridden at runtime with the environment
 variable \fBDPKG_DATADIR\fP.
 .TP
-.I /usr/share/dpkg/cputable
+.I %PKGDATADIR%/cputable
 Table of known CPU names and mapping to their GNU name.
 .TP
-.I /usr/share/dpkg/ostable
+.I %PKGDATADIR%/ostable
 Table of known operating system names and mapping to their GNU name.
 .TP
-.I /usr/share/dpkg/triplettable
+.I %PKGDATADIR%/triplettable
 Mapping between Debian architecture triplets and Debian architecture
 names.
 .TP
-.I /usr/share/dpkg/abitable
+.I %PKGDATADIR%/abitable
 Table of Debian architecture ABI attribute overrides.
 .SS Packaging support
 .TP
-.I /usr/share/dpkg/architecture.mk
+.I %PKGDATADIR%/architecture.mk
 Makefile snippet that properly sets and exports all the variables that
 \fBdpkg\-architecture\fP outputs (since dpkg 1.16.1).
 .
@@ -308,7 +308,7 @@ set all the variables that \fBdpkg\-architecture\fP can provide:
 .PP
 .RS 4
 .nf
-include /usr/share/dpkg/architecture.mk
+include %PKGDATADIR%/architecture.mk
 
 ifeq ($(DEB_HOST_ARCH),alpha)
   [...]

+ 8 - 8
man/dpkg-buildflags.1

@@ -17,7 +17,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-buildflags 1 "2014-09-04" "Debian Project" "dpkg suite"
+.TH dpkg\-buildflags 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg\-buildflags \- returns build flags to use during package build
 .
@@ -32,7 +32,7 @@ build of Debian packages.
 The default flags are defined by the vendor but they can be
 extended/overridden in several ways:
 .IP 1.
-system-wide with \fB/etc/dpkg/buildflags.conf\fP;
+system-wide with \fB%PKGCONFDIR%/buildflags.conf\fP;
 .IP 2.
 for the current user with \fB$XDG_CONFIG_HOME/dpkg/buildflags.conf\fP
 where \fB$XDG_CONFIG_HOME\fP defaults to \fB$HOME/.config\fP;
@@ -464,7 +464,7 @@ See the \fBFEATURE AREAS\fP section for details.
 .B DEB_VENDOR
 This setting defines the current vendor.
 If not set, it will discover the current vendor by reading
-\fB\%/etc/dpkg/origins/default\fP.
+\fB\%%PKGCONFDIR%/origins/default\fP.
 .TP
 .B DEB_BUILD_PATH
 This variable sets the build path (since dpkg 1.18.8) to use in features
@@ -474,7 +474,7 @@ This variable is currently Debian and derivatives-specific.
 .SH FILES
 .SS Configuration files
 .TP
-.B /etc/dpkg/buildflags.conf
+.B %PKGCONFDIR%/buildflags.conf
 System wide configuration file.
 .TP
 .BR $XDG_CONFIG_HOME/dpkg/buildflags.conf " or "
@@ -483,7 +483,7 @@ System wide configuration file.
 User configuration file.
 .SS Packaging support
 .TP
-.B /usr/share/dpkg/buildflags.mk
+.B %PKGDATADIR%/buildflags.mk
 Makefile snippet that will load (and optionally export) all flags
 supported by \fBdpkg-buildflags\fP into variables (since dpkg 1.16.1).
 .
@@ -538,7 +538,7 @@ can be picked up by your build system):
 .RS 4
 .nf
 DPKG_EXPORT_BUILDFLAGS = 1
-include /usr/share/dpkg/buildflags.mk
+include %PKGDATADIR%/buildflags.mk
 .fi
 .RE
 .PP
@@ -547,7 +547,7 @@ the variables (as none are exported by default):
 .PP
 .RS 4
 .nf
-include /usr/share/dpkg/buildflags.mk
+include %PKGDATADIR%/buildflags.mk
 export CPPFLAGS CFLAGS LDFLAGS
 .fi
 .RE
@@ -556,7 +556,7 @@ And you can of course pass the flags to commands manually:
 .PP
 .RS 4
 .nf
-include /usr/share/dpkg/buildflags.mk
+include %PKGDATADIR%/buildflags.mk
 build\-arch:
 \&	$(CC) \-o hello hello.c $(CPPFLAGS) $(CFLAGS) $(LDFLAGS)
 .fi

+ 3 - 3
man/dpkg-buildpackage.1

@@ -19,7 +19,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-buildpackage 1 "2015-07-05" "Debian Project" "dpkg utilities"
+.TH dpkg\-buildpackage 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-buildpackage \- build binary or source packages from sources
 .
@@ -426,7 +426,7 @@ Can be used multiple times.
 .TQ
 .BI "\-\-admindir " dir
 Change the location of the \fBdpkg\fR database (since dpkg 1.14.0).
-The default location is \fI/var/lib/dpkg\fP.
+The default location is \fI%ADMINDIR%\fP.
 .TP
 .BR \-? ", " \-\-help
 Show the usage message and exit.
@@ -486,7 +486,7 @@ latest entry in \fIdebian/changelog\fP, if it is not already defined.
 .
 .SH FILES
 .TP
-.I /etc/dpkg/buildpackage.conf
+.I %PKGCONFDIR%/buildpackage.conf
 System wide configuration file
 .TP
 .IR $XDG_CONFIG_HOME/dpkg/buildpackage.conf " or"

+ 2 - 2
man/dpkg-checkbuilddeps.1

@@ -17,7 +17,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-checkbuilddeps 1 "2015-07-05" "Debian Project" "dpkg utilities"
+.TH dpkg\-checkbuilddeps 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-checkbuilddeps \- check build dependencies and conflicts
 .
@@ -38,7 +38,7 @@ may be specified on the command line.
 .TP
 .BI \-\-admindir= dir
 Change the location of the \fBdpkg\fR database (since dpkg 1.14.0).
-The default location is \fI/var/lib/dpkg\fP.
+The default location is \fI%ADMINDIR%\fP.
 .TP
 .B \-A
 Ignore \fBBuild\-Depends\-Arch\fP and \fBBuild\-Conflicts\-Arch\fP

+ 1 - 1
man/dpkg-deb.1

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-deb 1 "2014-08-20" "Debian Project" "dpkg suite"
+.TH dpkg\-deb 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg\-deb \- Debian package archive (.deb) manipulation tool
 .

+ 1 - 1
man/dpkg-distaddfile.1

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-distaddfile 1 "2012-05-04" "Debian Project" "dpkg utilities"
+.TH dpkg\-distaddfile 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-distaddfile \- add entries to debian/files
 .

+ 3 - 3
man/dpkg-divert.1

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-divert 1 "2011-08-14" "Debian Project" "dpkg utilities"
+.TH dpkg\-divert 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-divert \- override a package's version of a file
 .
@@ -64,7 +64,7 @@ Print the real name for a diverted file.
 .TP
 .BI \-\-admindir " directory"
 Set the \fBdpkg\fP data directory to \fIdirectory\fP (default:
-\fI/var/lib/dpkg\fP).
+\fI%ADMINDIR%\fP).
 .TP
 .BI \-\-divert " divert-to"
 \fIdivert-to\fP is the location where the versions of \fIfile\fP, as
@@ -119,7 +119,7 @@ specified, \fBdpkg\-divert\fP will use it as the package name.
 .
 .SH FILES
 .TP
-.I /var/lib/dpkg/diversions
+.I %ADMINDIR%/diversions
 File which contains the current list of diversions of the system. It is
 located in the \fBdpkg\fP administration directory, along with other files
 important to \fBdpkg\fP, such as \fIstatus\fP or \fIavailable\fP.

+ 1 - 1
man/dpkg-genchanges.1

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-genchanges 1 "2014-09-24" "Debian Project" "dpkg utilities"
+.TH dpkg\-genchanges 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-genchanges \- generate Debian .changes files
 .

+ 1 - 1
man/dpkg-gencontrol.1

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-gencontrol 1 "2013-09-06" "Debian Project" "dpkg utilities"
+.TH dpkg\-gencontrol 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-gencontrol \- generate Debian control files
 .

+ 1 - 1
man/dpkg-gensymbols.1

@@ -17,7 +17,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-gensymbols 1 "2014-12-29" "Debian Project" "dpkg utilities"
+.TH dpkg\-gensymbols 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-gensymbols \- generate symbols files (shared library dependency information)
 .

+ 1 - 1
man/dpkg-maintscript-helper.1

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-maintscript\-helper 1 "2014-09-01" "Debian Project" "dpkg suite"
+.TH dpkg\-maintscript\-helper 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg\-maintscript\-helper \- works around known dpkg limitations in maintainer scripts
 .

+ 1 - 1
man/dpkg-mergechangelogs.1

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-mergechangelogs 1 "2011-08-14" "Debian Project" "dpkg suite"
+.TH dpkg\-mergechangelogs 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg\-mergechangelogs \- 3-way merge of debian/changelog files
 .

+ 1 - 1
man/dpkg-name.1

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-name 1 "2012-04-15" "Debian Project" "dpkg utilities"
+.TH dpkg\-name 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-name \- rename Debian packages to full package names
 .

+ 1 - 1
man/dpkg-parsechangelog.1

@@ -19,7 +19,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-parsechangelog 1 "2013-07-06" "Debian Project" "dpkg utilities"
+.TH dpkg\-parsechangelog 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-parsechangelog \- parse Debian changelog files
 .

+ 4 - 4
man/dpkg-query.1

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-query 1 "2015-01-17" "Debian Project" "dpkg suite"
+.TH dpkg\-query 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg\-query \- a tool to query the dpkg database
 .
@@ -34,7 +34,7 @@ the \fBdpkg\fP database.
 .TP
 .BR \-l ", " \-\-list " [\fIpackage-name-pattern\fP...]"
 List packages matching given pattern. If no \fIpackage-name-pattern\fP
-is given, list all packages in \fI/var/lib/dpkg/status\fP, excluding
+is given, list all packages in \fI%ADMINDIR%/status\fP, excluding
 the ones marked as not-installed (i.e. those which have been previously
 purged). Normal shell wildcard characters are allowed
 in \fIpackage-name-pattern\fP. Please note you will probably have to
@@ -149,7 +149,7 @@ nor will it list alternatives.
 .TP
 .BR \-p ", " \-\-print\-avail " \fIpackage-name\fP..."
 Display details about \fIpackage-name\fP, as found in
-\fI/var/lib/dpkg/available\fP. When multiple \fIpackage-name\fP are
+\fI%ADMINDIR%/available\fP. When multiple \fIpackage-name\fP are
 listed, the requested \fIavailable\fP entries are separated by an empty
 line, with the same order as specified on the argument list.
 
@@ -168,7 +168,7 @@ Show the version and exit.
 .TP
 .BI \-\-admindir= dir
 Change the location of the \fBdpkg\fR database. The default location is
-\fI/var/lib/dpkg\fP.
+\fI%ADMINDIR%\fP.
 .TP
 .B \-\-load\-avail
 Also load the available file when using the \fB\-\-show\fP and \fB\-\-list\fP

+ 1 - 1
man/dpkg-scanpackages.1

@@ -18,7 +18,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-scanpackages 1 "2012-05-07" "Debian Project" "dpkg utilities"
+.TH dpkg\-scanpackages 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-scanpackages \- create Packages index files
 .

+ 1 - 1
man/dpkg-scansources.1

@@ -17,7 +17,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-scansources 1 "2011-08-14" "Debian Project" "dpkg utilities"
+.TH dpkg\-scansources 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-scansources \- create Sources index files
 .

+ 11 - 11
man/dpkg-shlibdeps.1

@@ -19,7 +19,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-shlibdeps 1 "2013-09-06" "Debian Project" "dpkg utilities"
+.TH dpkg\-shlibdeps 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-shlibdeps \- generate shared library substvar dependencies
 .
@@ -57,8 +57,8 @@ file, or the
 file (if the former doesn't exist or if debian/shlibs.local contains
 the relevant dependency). Both files are supposed to be provided
 by the library package and should thus be available as
-/var/lib/dpkg/info/\fIpackage\fR.\fIsymbols\fR
-or /var/lib/dpkg/info/\fIpackage\fR.\fIshlibs\fR. The package name is
+%ADMINDIR%/info/\fIpackage\fR.\fIsymbols\fR
+or %ADMINDIR%/info/\fIpackage\fR.\fIshlibs\fR. The package name is
 identified in two steps: find the library file on the system (looking in
 the same directories that \fBld.so\fR would use), then use
 .BI "dpkg \-S " library-file
@@ -76,15 +76,15 @@ They are generated by
 They are only used if the library is found in a package's build tree. The
 symbols file in that build tree takes precedence over symbols files from
 other binary packages.
-.IP /etc/dpkg/symbols/\fIpackage\fR.symbols.\fIarch\fR
-.IP /etc/dpkg/symbols/\fIpackage\fR.symbols
+.IP %PKGCONFDIR%/symbols/\fIpackage\fR.symbols.\fIarch\fR
+.IP %PKGCONFDIR%/symbols/\fIpackage\fR.symbols
 Per-system overriding shared library dependency information.
 \fIarch\fR is the architecture of the current system (obtained by
 .BR "dpkg\-architecture \-qDEB_HOST_ARCH" ).
 .IP "Output from \(lq\fBdpkg\-query \-\-control\-path\fR \fIpackage\fR symbols\(rq"
 Package-provided shared library dependency information.
 Unless overridden by \fB\-\-admindir\fP, those files are located in
-/var/lib/dpkg.
+%ADMINDIR%.
 .P
 While scanning the symbols used by all binaries,
 .B dpkg\-shlibdeps
@@ -108,7 +108,7 @@ The dependencies for a library are looked up in several places. The first
 file providing information for the library of interest is used:
 .IP debian/shlibs.local
 Package-local overriding shared library dependency information.
-.IP /etc/dpkg/shlibs.override
+.IP %PKGCONFDIR%/shlibs.override
 Per-system overriding shared library dependency information.
 .IP debian/*/DEBIAN/shlibs
 Shared library information generated by the current build process that also invoked
@@ -119,8 +119,8 @@ other binary packages.
 .IP "Output from \(lq\fBdpkg\-query \-\-control\-path\fP \fIpackage\fR shlibs\(rq"
 Package-provided shared library dependency information.
 Unless overridden by \fB\-\-admindir\fP, those files are located in
-/var/lib/dpkg.
-.IP /etc/dpkg/shlibs.default
+%ADMINDIR%.
+.IP %PKGCONFDIR%/shlibs.default
 Per-system default shared library dependency information.
 .P
 The extracted dependencies are then directly used (except if they are
@@ -257,7 +257,7 @@ warnings to be active.
 .TP
 .BI \-\-admindir= dir
 Change the location of the \fBdpkg\fR database (since dpkg 1.14.0).
-The default location is \fI/var/lib/dpkg\fP.
+The default location is \fI%ADMINDIR%\fP.
 .TP
 .BR \-? ", " \-\-help
 Show the usage message and exit.
@@ -351,7 +351,7 @@ find out the dependency, it has tried to map the library to a Debian
 package with the help of
 .BI "dpkg \-S " library-file\fR.
 Then it checked the corresponding shlibs and symbols files in
-/var/lib/dpkg/info/, and in the various package's build trees
+%ADMINDIR%/info/, and in the various package's build trees
 (debian/*/DEBIAN/).
 
 This failure can be caused by a bad or missing shlibs or symbols file

+ 1 - 1
man/dpkg-source.1

@@ -20,7 +20,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-source 1 "2013-12-05" "Debian Project" "dpkg utilities"
+.TH dpkg\-source 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-source \- Debian source package (.dsc) manipulation tool
 .

+ 3 - 3
man/dpkg-split.1

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-split 1 "2011-07-04" "Debian Project" "dpkg utilities"
+.TH dpkg\-split 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 dpkg\-split \- Debian package archive split/join tool
 .
@@ -152,7 +152,7 @@ Show the version and exit.
 .BI \-\-depotdir " directory"
 Specifies an alternative directory for the queue of parts awaiting
 automatic reassembly. The default is
-.BR /var/lib/dpkg .
+.BR %ADMINDIR% .
 .TP
 .BR \-S ", " \-\-partsize " \fIkibibytes\fP"
 Specifies the maximum part size when splitting, in kibibytes (1024
@@ -216,7 +216,7 @@ memory allocations, etc.
 .
 .SH FILES
 .TP
-.I /var/lib/dpkg/parts
+.I %ADMINDIR%/parts
 The default queue directory for part files awaiting automatic
 reassembly.
 

+ 3 - 3
man/dpkg-statoverride.1

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-statoverride 1 "2013-04-01" "Debian project" "dpkg utilities"
+.TH dpkg\-statoverride 1 "%RELEASE_DATE%" "Debian project" "dpkg utilities"
 .SH NAME
 dpkg\-statoverride \- override ownership and mode of files
 .
@@ -70,7 +70,7 @@ Show the version and exit.
 .TP
 .BI \-\-admindir " directory"
 Change the \fIdirectory\fP of the \fBdpkg\fP database where the statoverride
-file is also stored. Defaults to \fI/var/lib/dpkg\fP.
+file is also stored. Defaults to \fI%ADMINDIR%\fP.
 .TP
 .B \-\-force
 Force an action, even if a sanity check would otherwise prohibit it.
@@ -105,7 +105,7 @@ be used as the \fBdpkg\fP data directory.
 .
 .SH FILES
 .TP
-.I /var/lib/dpkg/statoverride
+.I %ADMINDIR%/statoverride
 File which contains the current list of stat overrides of the system. It
 is located in the \fBdpkg\fP administration directory, along with other files
 important to \fBdpkg\fP, such as \fIstatus\fP or \fIavailable\fP.

+ 3 - 2
man/dpkg-trigger.1

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-trigger 1 "2011-08-14" "Debian Project" "dpkg suite"
+.TH dpkg\-trigger 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg\-trigger \- a package trigger utility
 .
@@ -56,7 +56,7 @@ Show the version and exit.
 .TP
 .BI \-\-admindir= dir
 Change the location of the \fBdpkg\fR database. The default location is
-\fI/var/lib/dpkg\fP.
+\fI%ADMINDIR%\fP.
 .TP
 .BR \-\-by\-package=\fIpackage\fR
 Override trigger awaiter (normally set by \fBdpkg\fP through the
@@ -101,4 +101,5 @@ be used as the \fBdpkg\fP data directory.
 .SH SEE ALSO
 .BR dpkg (1),
 .BR deb\-triggers (5),
+.\" FIXME: Unhardcode the pathname, and use dpkg instead of dpkg-dev.
 .BR /usr/share/doc/dpkg\-dev/triggers.txt.gz .

+ 4 - 4
man/dpkg-vendor.1

@@ -15,7 +15,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg\-vendor 1 "2011-11-10" "Debian Project" "dpkg suite"
+.TH dpkg\-vendor 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg\-vendor \- queries information about distribution vendors
 .
@@ -25,7 +25,7 @@ dpkg\-vendor \- queries information about distribution vendors
 .
 .SH DESCRIPTION
 \fBdpkg\-vendor\fP is a tool to query information about vendors listed in
-\fB/etc/dpkg/origins\fP. \fB/etc/dpkg/origins/default\fP contains
+\fB%PKGCONFDIR%/origins\fP. \fB%PKGCONFDIR%/origins/default\fP contains
 information about the current vendor.
 .
 .SH COMMANDS
@@ -54,13 +54,13 @@ Show the version and exit.
 .BI \-\-vendor " vendor"
 Assumes the current vendor is \fIvendor\fP instead of discovering it
 with the \fBDEB_VENDOR\fP environment variable or
-\fB/etc/dpkg/origins/default\fP.
+\fB%PKGCONFDIR%/origins/default\fP.
 .
 .SH ENVIRONMENT
 .TP
 \fBDEB_VENDOR\fP
 This setting defines the current vendor. If not set, it will discover the
-current vendor by reading \fB/etc/dpkg/origins/default\fP.
+current vendor by reading \fB%PKGCONFDIR%/origins/default\fP.
 .
 .SH SEE ALSO
 .BR deb\-origin (5).

+ 3 - 3
man/dpkg.cfg.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg.cfg 5 "2009-09-05" "Debian Project" "dpkg suite"
+.TH dpkg.cfg 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg.cfg \- dpkg configuration file
 .
@@ -28,9 +28,9 @@ here. Quotes surrounding option values are stripped. Comments are
 allowed by starting a line with a hash sign (\(oq\fB#\fR\(cq).
 .
 .SH FILES
-.I /etc/dpkg/dpkg.cfg.d/[0-9a-zA-Z_-]*
+.I %PKGCONFDIR%/dpkg.cfg.d/[0-9a-zA-Z_-]*
 .br
-.I /etc/dpkg/dpkg.cfg
+.I %PKGCONFDIR%/dpkg.cfg
 .br
 .I ~/.dpkg.cfg
 .

+ 19 - 19
man/dpkg.1

@@ -23,7 +23,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dpkg 1 "2014-08-16" "Debian Project" "dpkg suite"
+.TH dpkg 1 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dpkg \- package manager for Debian
 .
@@ -188,7 +188,7 @@ later (conffiles are configuration files that are listed in the
 \fIDEBIAN/conffiles\fP control file).
 If \fB\-a\fP or \fB\-\-pending\fP is given instead of a package name,
 then all packages unpacked, but marked to be removed in file
-\fI/var/lib/dpkg/status\fP, are removed.
+\fI%ADMINDIR%/status\fP, are removed.
 
 Removing of a package consists of the following steps:
 .br
@@ -208,7 +208,7 @@ Purge an installed or already removed package. This removes everything,
 including conffiles.
 If \fB\-a\fP or \fB\-\-pending\fP is given instead of a package name,
 then all packages unpacked or removed, but marked to be purged in file
-\fI/var/lib/dpkg/status\fP, are purged.
+\fI%ADMINDIR%/status\fP, are purged.
 
 Note: some configuration files might be unknown to \fBdpkg\fP because they
 are created and handled separately through the configuration scripts. In
@@ -267,7 +267,7 @@ in the \fIPackages-file\fP. The \fIPackages-file\fP distributed with
 Debian is simply named \(Fo\fIPackages\fP\(Fc. If the \fIPackages-file\fP
 argument is missing or named \(Fo\fB\-\fP\(Fc then it will be read from
 standard input (since dpkg 1.17.7). \fBdpkg\fP keeps its record of
-available packages in \fI/var/lib/dpkg/available\fP.
+available packages in \fI%ADMINDIR%/available\fP.
 
 A simpler one-shot command to retrieve and update the \fIavailable\fR
 file is \fBdselect update\fR. Note that this file is mostly useless
@@ -444,15 +444,15 @@ See \fBdpkg\-query\fP(1) for more information about the following actions.
     Search for a filename from installed packages.
 \fB\-p\fP, \fB\-\-print\-avail\fP \fIpackage-name\fP...
     Display details about \fIpackage-name\fP, as found in
-    \fI/var/lib/dpkg/available\fP. Users of APT-based frontends
+    \fI%ADMINDIR%/available\fP. Users of APT-based frontends
     should use \fBapt\-cache show\fP \fIpackage-name\fP instead.
 .fi
 .
 .SH OPTIONS
 All options can be specified both on the command line and in the \fBdpkg\fP
-configuration file \fI/etc/dpkg/dpkg.cfg\fP or fragment files (with names
+configuration file \fI%PKGCONFDIR%/dpkg.cfg\fP or fragment files (with names
 matching this shell pattern \(aq[0-9a-zA-Z_-]*\(aq) on the configuration
-directory \fI/etc/dpkg/dpkg.cfg.d/\fP. Each line in the configuration
+directory \fI%PKGCONFDIR%/dpkg.cfg.d/\fP. Each line in the configuration
 file is either an option (exactly the same as the command line option but
 without leading hyphens) or a comment (if it starts with a \(oq\fB#\fP\(cq).
 .br
@@ -650,7 +650,7 @@ installed. This is an alias of \fB\-\-refuse\-downgrade\fP.
 .BI \-\-admindir= dir
 Change default administrative directory, which contains many files that
 give information about status of installed or uninstalled packages, etc.
-(Defaults to \(Fo\fI/var/lib/dpkg\fP\(Fc)
+(Defaults to \(Fo\fI%ADMINDIR%\fP\(Fc)
 .TP
 .BI \-\-instdir= dir
 Change default installation directory which refers to the directory where
@@ -661,7 +661,7 @@ means that the scripts see \fBinstdir\fP as a root directory.
 .TP
 .BI \-\-root= dir
 Changing \fBroot\fP changes \fBinstdir\fP to \(Fo\fIdir\fP\(Fc and
-\fBadmindir\fP to \(Fo\fIdir\fP\fB/var/lib/dpkg\fP\(Fc.
+\fBadmindir\fP to \(Fo\fIdir\fP\fB%ADMINDIR%\fP\(Fc.
 .TP
 \fB\-O\fP, \fB\-\-selected\-only\fP
 Only process the packages that are selected for installation. The
@@ -784,7 +784,7 @@ The output format used is the same as in \fB\-\-status\-fd\fP.
 .TP
 \fB\-\-log=\fP\fIfilename\fP
 Log status change updates and actions to \fIfilename\fP, instead of
-the default \fI/var/log/dpkg.log\fP. If this option is given multiple
+the default \fI%LOGDIR%/dpkg.log\fP. If this option is given multiple
 times, the last filename is used. Log messages are of the form:
 .RS
 .TP
@@ -931,23 +931,23 @@ requested (with the \fB\-\-debug\fP option) for the maintainer scripts
 .
 .SH FILES
 .TP
-.I /etc/dpkg/dpkg.cfg.d/[0-9a-zA-Z_-]*
+.I %PKGCONFDIR%/dpkg.cfg.d/[0-9a-zA-Z_-]*
 Configuration fragment files (since dpkg 1.15.4).
 .TP
-.I /etc/dpkg/dpkg.cfg
+.I %PKGCONFDIR%/dpkg.cfg
 Configuration file with default options.
 .TP
-.I /var/log/dpkg.log
-Default log file (see \fI/etc/dpkg/dpkg.cfg\fP(5) and option
+.I %LOGDIR%/dpkg.log
+Default log file (see \fI%PKGCONFDIR%/dpkg.cfg\fP and option
 \fB\-\-log\fP).
 .P
 The other files listed below are in their default directories, see option
 \fB\-\-admindir\fP to see how to change locations of these files.
 .TP
-.I /var/lib/dpkg/available
+.I %ADMINDIR%/available
 List of available packages.
 .TP
-.I /var/lib/dpkg/status
+.I %ADMINDIR%/status
 Statuses of available packages. This file contains information about
 whether a package is marked for removing or not, whether it is
 installed or not, etc. See section \fBINFORMATION ABOUT PACKAGES\fP
@@ -984,14 +984,14 @@ be used instead for that):
 \fB     dpkg \-l \(aq*vi*\(aq\fP
 .br
 
-To see the entries in \fI/var/lib/dpkg/available\fP of two packages:
+To see the entries in \fI%ADMINDIR%/available\fP of two packages:
 .br
 \fB     dpkg \-\-print\-avail elvis vim | less\fP
 .br
 
 To search the listing of packages yourself:
 .br
-\fB     less /var/lib/dpkg/available\fP
+\fB     less %ADMINDIR%/available\fP
 .br
 
 To remove an installed elvis package:
@@ -1059,5 +1059,5 @@ and
 \fBdpkg\-reconfigure\fP(8).
 .
 .SH AUTHORS
-See \fI/usr/share/doc/dpkg/THANKS\fP for the list of people who have
+See \fI%PKGDOCDIR%/THANKS\fP for the list of people who have
 contributed to \fBdpkg\fP.

+ 1 - 1
man/dsc.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dsc 5 "2015-06-01" "Debian Project" "Debian"
+.TH dsc 5 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 dsc \- Debian source packages' control file format
 .

+ 3 - 3
man/dselect.cfg.5

@@ -16,7 +16,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dselect.cfg 5 "2011-07-03" "Debian Project" "dpkg suite"
+.TH dselect.cfg 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
 .SH NAME
 dselect.cfg \- dselect configuration file
 .
@@ -28,9 +28,9 @@ here. Quotes surrounding option values are stripped. Comments are
 allowed by starting a line with a hash sign (\(oq\fB#\fR\(cq).
 .
 .SH FILES
-.I /etc/dpkg/dselect.cfg.d/[0-9a-zA-Z_-]*
+.I %PKGCONFDIR%/dselect.cfg.d/[0-9a-zA-Z_-]*
 .br
-.I /etc/dpkg/dselect.cfg
+.I %PKGCONFDIR%/dselect.cfg
 .br
 .I ~/.dselect.cfg
 .

+ 4 - 4
man/dselect.1

@@ -19,7 +19,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH dselect 1 "2014-08-11" "Debian Project" "Debian"
+.TH dselect 1 "%RELEASE_DATE%" "%VERSION%" "Debian"
 .SH NAME
 dselect \- Debian package management frontend
 .
@@ -56,8 +56,8 @@ of \fBdselect\fP or show additional information about the program.
 .
 .SH OPTIONS
 All options can be specified both on the command line and in the \fBdselect\fP
-configuration file \fI/etc/dpkg/dselect.cfg\fP or the files on the
-configuration directory \fI/etc/dpkg/dselect.cfg.d/\fP. Each line in the
+configuration file \fI%PKGCONFDIR%/dselect.cfg\fP or the files on the
+configuration directory \fI%PKGCONFDIR%/dselect.cfg.d/\fP. Each line in the
 configuration file is either an option (exactly the same as the
 command line option but without leading hyphens) or a comment (if it starts
 with a \(oq\fB#\fR\(cq).
@@ -66,7 +66,7 @@ with a \(oq\fB#\fR\(cq).
 .BI \-\-admindir " directory"
 Changes the directory where the dpkg \(oq\fIstatus\fP\(cq,
 \(oq\fIavailable\fP\(cq and similar files are located.
-This defaults to \fI/var/lib/dpkg\fP
+This defaults to \fI%ADMINDIR%\fP
 and normally there shouldn't be any need to change it.
 .TP
 .BR \-D "\fIfile\fP, " \-\-debug " \fIfile\fP"

+ 52 - 52
man/po/po4a.cfg

@@ -4,158 +4,158 @@
 # Make sure the man pages are generated with the right encoding.
 [po4a_alias:man] man opt:"-L UTF-8 -A UTF-8"
 
-[type:man] deb.5 $lang:$lang/deb.5 \
+[type:man] deb.man $lang:$lang/deb.man \
            add_$lang:po/$lang.add
 
-[type:man] deb822.5 $lang:$lang/deb822.5 \
+[type:man] deb822.man $lang:$lang/deb822.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-changelog.5 $lang:$lang/deb-changelog.5 \
+[type:man] deb-changelog.man $lang:$lang/deb-changelog.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-changes.5 $lang:$lang/deb-changes.5 \
+[type:man] deb-changes.man $lang:$lang/deb-changes.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-control.5 $lang:$lang/deb-control.5 \
+[type:man] deb-control.man $lang:$lang/deb-control.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-conffiles.5 $lang:$lang/deb-conffiles.5 \
+[type:man] deb-conffiles.man $lang:$lang/deb-conffiles.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-src-control.5 $lang:$lang/deb-src-control.5 \
+[type:man] deb-src-control.man $lang:$lang/deb-src-control.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-src-files.5 $lang:$lang/deb-src-files.5 \
+[type:man] deb-src-files.man $lang:$lang/deb-src-files.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-split.5 $lang:$lang/deb-split.5 \
+[type:man] deb-split.man $lang:$lang/deb-split.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-version.5 $lang:$lang/deb-version.5 \
+[type:man] deb-version.man $lang:$lang/deb-version.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-old.5 $lang:$lang/deb-old.5 \
+[type:man] deb-old.man $lang:$lang/deb-old.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-origin.5 $lang:$lang/deb-origin.5 \
+[type:man] deb-origin.man $lang:$lang/deb-origin.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-override.5 $lang:$lang/deb-override.5 \
+[type:man] deb-override.man $lang:$lang/deb-override.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-extra-override.5 $lang:$lang/deb-extra-override.5 \
+[type:man] deb-extra-override.man $lang:$lang/deb-extra-override.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-shlibs.5 $lang:$lang/deb-shlibs.5 \
+[type:man] deb-shlibs.man $lang:$lang/deb-shlibs.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-substvars.5 $lang:$lang/deb-substvars.5 \
+[type:man] deb-substvars.man $lang:$lang/deb-substvars.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-symbols.5 $lang:$lang/deb-symbols.5 \
+[type:man] deb-symbols.man $lang:$lang/deb-symbols.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-postinst.5 $lang:$lang/deb-postinst.5 \
+[type:man] deb-postinst.man $lang:$lang/deb-postinst.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-postrm.5 $lang:$lang/deb-postrm.5 \
+[type:man] deb-postrm.man $lang:$lang/deb-postrm.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-preinst.5 $lang:$lang/deb-preinst.5 \
+[type:man] deb-preinst.man $lang:$lang/deb-preinst.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-prerm.5 $lang:$lang/deb-prerm.5 \
+[type:man] deb-prerm.man $lang:$lang/deb-prerm.man \
            add_$lang:po/$lang.add
 
-[type:man] deb-triggers.5 $lang:$lang/deb-triggers.5 \
+[type:man] deb-triggers.man $lang:$lang/deb-triggers.man \
            add_$lang:po/$lang.add
 
-[type:man] dsc.5 $lang:$lang/dsc.5 \
+[type:man] dsc.man $lang:$lang/dsc.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg.1 $lang:$lang/dpkg.1 \
+[type:man] dpkg.man $lang:$lang/dpkg.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-architecture.1 $lang:$lang/dpkg-architecture.1 \
+[type:man] dpkg-architecture.man $lang:$lang/dpkg-architecture.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg.cfg.5 $lang:$lang/dpkg.cfg.5 \
+[type:man] dpkg.cfg.man $lang:$lang/dpkg.cfg.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-buildflags.1 $lang:$lang/dpkg-buildflags.1 \
+[type:man] dpkg-buildflags.man $lang:$lang/dpkg-buildflags.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-buildpackage.1 $lang:$lang/dpkg-buildpackage.1 \
+[type:man] dpkg-buildpackage.man $lang:$lang/dpkg-buildpackage.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-checkbuilddeps.1 $lang:$lang/dpkg-checkbuilddeps.1 \
+[type:man] dpkg-checkbuilddeps.man $lang:$lang/dpkg-checkbuilddeps.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-distaddfile.1 $lang:$lang/dpkg-distaddfile.1 \
+[type:man] dpkg-distaddfile.man $lang:$lang/dpkg-distaddfile.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-deb.1 $lang:$lang/dpkg-deb.1 \
+[type:man] dpkg-deb.man $lang:$lang/dpkg-deb.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-divert.1 $lang:$lang/dpkg-divert.1 \
+[type:man] dpkg-divert.man $lang:$lang/dpkg-divert.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-genchanges.1 $lang:$lang/dpkg-genchanges.1 \
+[type:man] dpkg-genchanges.man $lang:$lang/dpkg-genchanges.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-gencontrol.1 $lang:$lang/dpkg-gencontrol.1 \
+[type:man] dpkg-gencontrol.man $lang:$lang/dpkg-gencontrol.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-gensymbols.1 $lang:$lang/dpkg-gensymbols.1 \
+[type:man] dpkg-gensymbols.man $lang:$lang/dpkg-gensymbols.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-maintscript-helper.1 $lang:$lang/dpkg-maintscript-helper.1 \
+[type:man] dpkg-maintscript-helper.man $lang:$lang/dpkg-maintscript-helper.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-mergechangelogs.1 $lang:$lang/dpkg-mergechangelogs.1 \
+[type:man] dpkg-mergechangelogs.man $lang:$lang/dpkg-mergechangelogs.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-name.1 $lang:$lang/dpkg-name.1 \
+[type:man] dpkg-name.man $lang:$lang/dpkg-name.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-parsechangelog.1 $lang:$lang/dpkg-parsechangelog.1 \
+[type:man] dpkg-parsechangelog.man $lang:$lang/dpkg-parsechangelog.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-query.1 $lang:$lang/dpkg-query.1 \
+[type:man] dpkg-query.man $lang:$lang/dpkg-query.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-scanpackages.1 $lang:$lang/dpkg-scanpackages.1 \
+[type:man] dpkg-scanpackages.man $lang:$lang/dpkg-scanpackages.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-scansources.1 $lang:$lang/dpkg-scansources.1 \
+[type:man] dpkg-scansources.man $lang:$lang/dpkg-scansources.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-shlibdeps.1 $lang:$lang/dpkg-shlibdeps.1 \
+[type:man] dpkg-shlibdeps.man $lang:$lang/dpkg-shlibdeps.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-source.1 $lang:$lang/dpkg-source.1 \
+[type:man] dpkg-source.man $lang:$lang/dpkg-source.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-split.1 $lang:$lang/dpkg-split.1 \
+[type:man] dpkg-split.man $lang:$lang/dpkg-split.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-statoverride.1 $lang:$lang/dpkg-statoverride.1 \
+[type:man] dpkg-statoverride.man $lang:$lang/dpkg-statoverride.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-trigger.1 $lang:$lang/dpkg-trigger.1 \
+[type:man] dpkg-trigger.man $lang:$lang/dpkg-trigger.man \
            add_$lang:po/$lang.add
 
-[type:man] dpkg-vendor.1 $lang:$lang/dpkg-vendor.1 \
+[type:man] dpkg-vendor.man $lang:$lang/dpkg-vendor.man \
            add_$lang:po/$lang.add
 
-[type:man] dselect.1 $lang:$lang/dselect.1 \
+[type:man] dselect.man $lang:$lang/dselect.man \
            add_$lang:po/$lang.add
 
-[type:man] dselect.cfg.5 $lang:$lang/dselect.cfg.5 \
+[type:man] dselect.cfg.man $lang:$lang/dselect.cfg.man \
            add_$lang:po/$lang.add
 
-[type:man] start-stop-daemon.8 $lang:$lang/start-stop-daemon.8 \
+[type:man] start-stop-daemon.man $lang:$lang/start-stop-daemon.man \
            add_$lang:po/$lang.add
 
-[type:man] update-alternatives.1 $lang:$lang/update-alternatives.1 \
+[type:man] update-alternatives.man $lang:$lang/update-alternatives.man \
            add_$lang:po/$lang.add

+ 1 - 1
man/start-stop-daemon.8

@@ -20,7 +20,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH start\-stop\-daemon 8 "2014-03-26" "Debian Project" "dpkg utilities"
+.TH start\-stop\-daemon 8 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 start\-stop\-daemon \- start and stop system daemon programs
 .

+ 7 - 7
man/update-alternatives.1

@@ -22,7 +22,7 @@
 .\" You should have received a copy of the GNU General Public License
 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
 .
-.TH update\-alternatives 1 "2012-07-31" "Debian Project" "dpkg utilities"
+.TH update\-alternatives 1 "%RELEASE_DATE%" "%VERSION%" "dpkg utilities"
 .SH NAME
 update\-alternatives \- maintain symbolic links determining default commands
 .
@@ -72,7 +72,7 @@ Instead, it is a symbolic link to a name in the
 which in turn is a symbolic link to the actual file referenced.
 This is done so that the system administrator's changes can be confined
 within the
-.I /etc
+.I %CONFDIR%
 directory: the FHS (q.v.) gives reasons why this is a Good Thing.
 .PP
 When each package
@@ -185,12 +185,12 @@ accessible via a generic name using the alternatives system.
 .TP
 alternatives directory
 A directory, by default
-.IR /etc/alternatives ,
+.IR %CONFDIR%/alternatives ,
 containing the symlinks.
 .TP
 administrative directory
 A directory, by default
-.IR /var/lib/dpkg/alternatives ,
+.IR %ADMINDIR%/alternatives ,
 containing
 .BR update\-alternatives '
 state information.
@@ -352,7 +352,7 @@ different from the default.
 .TP
 .BI \-\-log " file"
 Specifies the log file (since version 1.15.0), when this is to be different
-from the default (/var/log/alternatives.log).
+from the default (%LOGDIR%/alternatives.log).
 .TP
 .BI \-\-force
 Allow replacing or dropping any real file that is installed
@@ -386,13 +386,13 @@ be used as the base administrative directory.
 .
 .SH FILES
 .TP
-.I /etc/alternatives/
+.I %CONFDIR%/alternatives/
 The default alternatives directory.
 Can be overridden by the
 .B \-\-altdir
 option.
 .TP
-.I /var/lib/dpkg/alternatives/
+.I %ADMINDIR%/alternatives/
 The default administration directory.
 Can be overridden by the
 .B \-\-admindir

+ 88 - 0
man/utf8toman.sed

@@ -0,0 +1,88 @@
+s/‐/\\(hy/g
+s/–/\\(en/g
+s/—/\\(em/g
+s/•/\\(bu/g
+s/¡/\\(r!/g
+s/¿/\\(r?/g
+s/«/\\(Fo/g
+s/»/\\(Fc/g
+s/‘/\\(oq/g
+s/’/\\(cq/g
+s/‚/\\(bq/g
+s/“/\\(lq/g
+s/”/\\(rq/g
+s/„/\\(Bq/g
+s/‹/\\(fo/g
+s/›/\\(fc/g
+s/À/\\(`A/g
+s/Á/\\('A/g
+s/Â/\\(^A/g
+s/Ã/\\(~A/g
+s/Ä/\\(:A/g
+s/Å/\\(oA/g
+s/Æ/\\(AE/g
+s/Ç/\\(,C/g
+s/È/\\(`E/g
+s/É/\\('E/g
+s/Ê/\\(^E/g
+s/Ë/\\(:E/g
+s/Ì/\\(`I/g
+s/Í/\\('I/g
+s/Î/\\(^I/g
+s/Ï/\\(:I/g
+s/Ñ/\\(~N/g
+s/Ò/\\(`O/g
+s/Ó/\\('O/g
+s/Ô/\\(^O/g
+s/Õ/\\(~O/g
+s/Ö/\\(:O/g
+s/Ø/\\(\/O/g
+s/Ù/\\(`U/g
+s/Ú/\\('U/g
+s/Û/\\(^U/g
+s/Ü/\\(:U/g
+s/Ý/\\('Y/g
+s/ß/\\(ss/g
+s/à/\\(`a/g
+s/á/\\('a/g
+s/â/\\(^a/g
+s/ã/\\(~a/g
+s/ä/\\(:a/g
+s/å/\\(oa/g
+s/æ/\\(ae/g
+s/ç/\\(,c/g
+s/è/\\(`e/g
+s/é/\\('e/g
+s/ê/\\(^e/g
+s/ë/\\(:e/g
+s/ì/\\(`i/g
+s/í/\\('i/g
+s/î/\\(^i/g
+s/ï/\\(:i/g
+s/ñ/\\(~n/g
+s/ò/\\(`o/g
+s/ó/\\('o/g
+s/ô/\\(^o/g
+s/õ/\\(~o/g
+s/ö/\\(:o/g
+s/ø/\\(\/o/g
+s/ù/\\(`u/g
+s/ú/\\('u/g
+s/û/\\(^u/g
+s/ü/\\(:u/g
+s/ý/\\('y/g
+s/ÿ/\\(:y/g
+s/Ć/\\('C/g
+s/ć/\\('c/g
+s/ı/\\(.i/g
+s/IJ/\\(IJ/g
+s/ij/\\(ij/g
+s/Ł/\\(\/L/g
+s/ł/\\(\/l/g
+s/Œ/\\(OE/g
+s/œ/\\(oe/g
+s/Š/\\(vS/g
+s/š/\\(vs/g
+s/Ÿ/\\(:Y/g
+s/Ž/\\(vZ/g
+s/ž/\\(vz/g