summaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
authorRaphaël Hertzog <hertzog@debian.org>2010-05-17 16:46:08 +0200
committerRaphaël Hertzog <hertzog@debian.org>2010-05-17 18:38:38 +0200
commitaa26f83c4b1a0f85d65dc0b6a5f642c3e609c42c (patch)
treea192448f41be15778c2717708e43d2763a59184e /man
parent85a55d82432b8e035a7175f33b6e8c27366b9983 (diff)
downloaddpkg-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.am4
-rw-r--r--man/dpkg-maintscript-helper.1 (renamed from man/maintscript-helper.1)23
-rw-r--r--man/po/po4a.cfg10
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