Просмотр исходного кода

deb-triggers(5): explain better why {interest,activate}-noawait should be favored

Christoph Biedl asked me in #762031 to integrate more explanations why
the *-noawait directives should be preferred.
Raphaël Hertzog лет назад: 11
Родитель
Сommit
205357f14c
2 измененных файлов с 12 добавлено и 1 удалено
  1. 4 0
      debian/changelog
  2. 8 1
      man/deb-triggers.5

+ 4 - 0
debian/changelog

@@ -1,5 +1,9 @@
 dpkg (1.17.14) UNRELEASED; urgency=low
 dpkg (1.17.14) UNRELEASED; urgency=low
 
 
+  [ Raphaël Hertzog ]
+  * Explain better in deb-triggers(5) why interest/activate-noawait should be
+    favored.
+
   [ Updated manpages translations ]
   [ Updated manpages translations ]
   * German (Helge Kreutzmann).
   * German (Helge Kreutzmann).
 
 

+ 8 - 1
man/deb-triggers.5

@@ -1,7 +1,7 @@
 .\" dpkg manual page - deb-triggers(5)
 .\" dpkg manual page - deb-triggers(5)
 .\"
 .\"
 .\" Copyright © 2008, 2013 Guillem Jover <guillem@debian.org>
 .\" Copyright © 2008, 2013 Guillem Jover <guillem@debian.org>
-.\" Copyright © 2011 Raphaël Hertzog <hertzog@debian.org>
+.\" Copyright © 2011, 2014 Raphaël Hertzog <hertzog@debian.org>
 .\"
 .\"
 .\" This is free software; you can redistribute it and/or modify
 .\" This is free software; you can redistribute it and/or modify
 .\" it under the terms of the GNU General Public License as published by
 .\" it under the terms of the GNU General Public License as published by
@@ -77,6 +77,13 @@ versions of the package will be activated.
 Unknown directives are an error which will prevent installation of the
 Unknown directives are an error which will prevent installation of the
 package.
 package.
 .PP
 .PP
+The "\-noawait" variants should always be favored when possible since
+triggering packages are not put in triggers\-awaited state and can thus
+be immediately configured without requiring the processing of the trigger.
+If the triggering packages are dependencies of other upgraded packages,
+it will avoid an early trigger processing run and make it possible
+to run the trigger only once as one of the last steps of the upgrade.
+.PP
 The "\-noawait" variants are only supported since dpkg 1.16.1, and
 The "\-noawait" variants are only supported since dpkg 1.16.1, and
 will lead to errors if used with an older dpkg. It is thus recommended
 will lead to errors if used with an older dpkg. It is thus recommended
 to add a "Pre\-Depends: dpkg (>= 1.16.1)" to any package that wish to use
 to add a "Pre\-Depends: dpkg (>= 1.16.1)" to any package that wish to use