dpkg-divert, dpkg-statoverride: Add new --instdir and --root options

This makes it possible to use alternative installation directories.
And will make these commands honor those directories when specified
for dpkg, and passed down to the maintainer script via the DPKG_ROOT
environment variable.

1 files changed, 9 insertions, 7 deletions

diff --git a/man/dpkg.man b/man/dpkg.man
index 588a21746..eff9d6667 100644
--- a/man/dpkg.man
+++ b/man/dpkg.man
@@ -674,20 +674,22 @@ Don't install a package if a newer version of the same package is already
 installed. This is an alias of \fB\-\-refuse\-downgrade\fP.
 .TP
 .BI \-\-admindir= dir
-Change default administrative directory, which contains many files that
-give information about status of installed or uninstalled packages, etc.
-(Defaults to «\fI%ADMINDIR%\fP»)
+Set the administrative directory to \fIdirectory\fP.
+This directory contains many files that give information about status of
+installed or uninstalled packages, etc.
+Defaults to «\fI%ADMINDIR%\fP».
 .TP
 .BI \-\-instdir= dir
-Change default installation directory which refers to the directory where
+Set the installation directory, which refers to the directory where
 packages are to be installed. \fBinstdir\fP is also the directory passed
 to \fBchroot\fP(2) before running package's installation scripts, which
 means that the scripts see \fBinstdir\fP as a root directory.
-(Defaults to «\fI/\fP»)
+Defaults to «\fI/\fP».
 .TP
 .BI \-\-root= dir
-Changing \fBroot\fP changes \fBinstdir\fP to «\fIdir\fP» and
-\fBadmindir\fP to «\fIdir\fP\fB%ADMINDIR%\fP».
+Set the root directory to \fBdirectory\fP, which sets the installation
+directory to «\fIdir\fP» and the administrative
+directory to «\fIdir\fP\fB%ADMINDIR%\fP».
 .TP
 \fB\-O\fP, \fB\-\-selected\-only\fP
 Only process the packages that are selected for installation. The