diff options
author | Raphaël Hertzog <hertzog@debian.org> | 2010-05-17 16:46:08 +0200 |
---|---|---|
committer | Raphaël Hertzog <hertzog@debian.org> | 2010-05-17 18:38:38 +0200 |
commit | aa26f83c4b1a0f85d65dc0b6a5f642c3e609c42c (patch) | |
tree | a192448f41be15778c2717708e43d2763a59184e /man | |
parent | 85a55d82432b8e035a7175f33b6e8c27366b9983 (diff) | |
download | dpkg-aa26f83c4b1a0f85d65dc0b6a5f642c3e609c42c.tar.gz |
Rename /usr/lib/dpkg/maintscript-helper in /usr/bin/dpkg-maintscript-helper
It is a public interface even if working around known limitations.
Diffstat (limited to 'man')
-rw-r--r-- | man/Makefile.am | 4 | ||||
-rw-r--r-- | man/dpkg-maintscript-helper.1 (renamed from man/maintscript-helper.1) | 23 | ||||
-rw-r--r-- | man/po/po4a.cfg | 10 |
3 files changed, 17 insertions, 20 deletions
diff --git a/man/Makefile.am b/man/Makefile.am index da654d7e9..494c0ed5a 100644 --- a/man/Makefile.am +++ b/man/Makefile.am @@ -106,6 +106,7 @@ dist_man_MANS = \ dpkg-genchanges.1 \ dpkg-gencontrol.1 \ dpkg-gensymbols.1 \ + dpkg-maintscript-helper.1 \ dpkg-mergechangelogs.1 \ dpkg-name.1 \ dpkg-parsechangelog.1 \ @@ -119,8 +120,7 @@ dist_man_MANS = \ dpkg-trigger.1 \ dpkg-vendor.1 \ dpkg.1 \ - dpkg.cfg.5 \ - maintscript-helper.1 + dpkg.cfg.5 if WITH_DSELECT dist_man_MANS += \ diff --git a/man/maintscript-helper.1 b/man/dpkg-maintscript-helper.1 index 0804e3068..c65db2a97 100644 --- a/man/maintscript-helper.1 +++ b/man/dpkg-maintscript-helper.1 @@ -1,9 +1,9 @@ -.TH maintscript\-helper 1 "2010-04-16" "Debian Project" "dpkg suite" +.TH dpkg\-maintscript\-helper 1 "2010-04-16" "Debian Project" "dpkg suite" .SH NAME -maintscript\-helper \- works around known dpkg limitations in maintainer scripts +dpkg\-maintscript\-helper \- works around known dpkg limitations in maintainer scripts . .SH SYNOPSIS -.B $DPKG_LIBDIR/maintscript\-helper +.B dpkg\-maintscript\-helper .IR command " [" parameters "...] \-\- " maint-script-parameters . .SH COMMANDS AND PARAMETERS @@ -37,8 +37,9 @@ dpkg\-maintained conffile to a file maintained by the package's maintainer scripts, usually with a tool like debconf or ucf. .P This means that if a package is intended to rename or remove a conffile, -it must explicitly do so and \fBmaintscript\-helper\fP can be used to implement -graceful deletion and moving of conffiles within maintainer scripts. +it must explicitly do so and \fBdpkg\-maintscript\-helper\fP can be used +to implement graceful deletion and moving of conffiles within maintainer +scripts. . .SS REMOVING A CONFFILE .P @@ -50,10 +51,8 @@ conffile should not disappear. All of this is implemented by putting the following shell snippet in the \fBpreinst\fP, \fBpostinst\fP and \fBpostrm\fP maintainer scripts: .P - if [ \-x $DPKG_LIBDIR/maintscript\-helper ]; then - $DPKG_LIBDIR/maintscript\-helper rm_conffile \\ - \fIconffile\fP \fIlastversion\fP \fIpackage\fP \-\- "$@" - fi + dpkg\-maintscript\-helper rm_conffile \\ + \fIconffile\fP \fIlastversion\fP \fIpackage\fP \-\- "$@" .P \fIconffile\fP is the filename of the conffile to remove. \fIlastversion\fP is the last version of the package that contained the @@ -82,10 +81,8 @@ Graceful renaming can be implemented by putting the following shell snippet in the \fBpreinst\fP, \fBpostinst\fP and \fBpostrm\fP maintainer scripts: .P - if [ \-x $DPKG_LIBDIR/maintscript\-helper ]; then - $DPKG_LIBDIR/maintscript\-helper mv_conffile \\ - \fIoldconffile\fP \fInewconffile\fP \fIlastversion\fP \fIpackage\fP \-\- "$@" - fi + dpkg\-maintscript\-helper mv_conffile \\ + \fIoldconffile\fP \fInewconffile\fP \fIlastversion\fP \fIpackage\fP \-\- "$@" .P \fIoldconffile\fP and \fInewconffile\fP are the old and new name of the conffile to rename. \fIlastversion\fP is the last version of the package diff --git a/man/po/po4a.cfg b/man/po/po4a.cfg index 3c0abd74e..398b337ff 100644 --- a/man/po/po4a.cfg +++ b/man/po/po4a.cfg @@ -128,6 +128,11 @@ add_$lang:po/$lang.add +[type:man] dpkg-maintscript-helper.1 \ + $lang:$(builddir)/$lang/dpkg-maintscript-helper.1 \ + add_$lang:po/$lang.add + + [type:man] dpkg-mergechangelogs.1 \ $lang:$(builddir)/$lang/dpkg-mergechangelogs.1 \ add_$lang:po/$lang.add @@ -198,11 +203,6 @@ add_$lang:po/$lang.add -[type:man] maintscript-helper.1 \ - $lang:$(builddir)/$lang/maintscript-helper.1 \ - add_$lang:po/$lang.add - - [type:man] start-stop-daemon.8 \ $lang:$(builddir)/$lang/start-stop-daemon.8 \ add_$lang:po/$lang.add |