Przeglądaj źródła

dpkg-maintscript-helper(1): Add a mention of packaging helpers support

Mention that packaging helper might support dpkg-maintscript-helper
natively, and add an explicit reference to dh_installdeb(1), debhelper
being the most commonly used helper, w/o going into the actual details.

Closes: #759754
Guillem Jover 12 lat temu
rodzic
commit
778367253d
2 zmienionych plików z 13 dodań i 1 usunięć
  1. 3 0
      debian/changelog
  2. 10 1
      man/dpkg-maintscript-helper.1

+ 3 - 0
debian/changelog

@@ -30,6 +30,9 @@ dpkg (1.17.14) UNRELEASED; urgency=low
   * Emit a warning when using the obsolete Dpkg::Deps check_package() function.
   * Add support for versioned Provides to Dpkg::Deps::KnownFacts, missed in
     dpkg 1.17.11.
+  * Man pages:
+    - Add a mention of packaging helpers support in dpkg-maintscript-helper(1).
+      Closes: #759754
 
   [ Raphaël Hertzog ]
   * Explain better in deb-triggers(5) why interest/activate-noawait should be

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

@@ -1,6 +1,7 @@
 .\" dpkg manual page - dpkg-maintscript-helper(1)
 .\"
 .\" Copyright © 2010-2012 Raphaël Hertzog <hertzog@debian.org>
+.\" Copyright © 2011-2014 Guillem Jover <guillem@debian.org>
 .\"
 .\" This is free software; you can redistribute it and/or modify
 .\" it under the terms of the GNU General Public License as published by
@@ -15,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-04-28" "Debian Project" "dpkg suite"
+.TH dpkg\-maintscript\-helper 1 "2014-09-01" "Debian Project" "dpkg suite"
 .SH NAME
 dpkg\-maintscript\-helper \- works around known dpkg limitations in maintainer scripts
 .
@@ -219,6 +220,10 @@ abort\-upgrade/abort\-install, the \fBpostrm\fP renames
 .
 .SH INTEGRATION IN PACKAGES
 .P
+When using a packaging helper, please check if it has native
+\fBdpkg-maintscript-helper\fP integration, which might make your life
+easier. See for example \fBdh_installdeb\fP(1).
+.P
 Given that \fBdpkg\-maintscript\-helper\fP is used in the \fBpreinst\fP,
 using it unconditionally requires a pre-dependency to ensure that the
 required version of \fBdpkg\fP has been unpacked before. The required version
@@ -241,3 +246,7 @@ The command \fBsupports\fP will return 0 on success, 1 otherwise. The
 \fBsupports\fP command will check if the environment variables as set
 by dpkg and required by the script are present, and will consider it a
 failure in case the environment is not sufficient.
+.SH SEE ALSO
+.ad l
+.nh
+.BR dh_installdeb (1).