Bug#1110873: dpkg: DPKG_ROOT documentation unexpectedly mentions instdir

Hi!

On Mon, 2025-08-11 at 22:10:34 +0200, Ferenc Wágner wrote:
> Package: dpkg
> Version: 1.21.22
> Severity: minor

> "man dpkg" says:
> 
>   DPKG_ROOT
>       [...] When installing packages into a different instdir, dpkg
>       normally invokes maintainer scripts using chroot(2) and leaves
>       this variable empty, but if --force-script-chrootless is specified
>       then the chroot(2) call is skipped and instdir is non-empty.
> 
> The above would make more sense to me if the "instdir" reference in the
> last line was "DPKG_ROOT", so I suspect a typo here.  Please fix the
> documentation or my confusion.

This would be the directory that is being set when using --instdir,
which --root ends up setting as well as --admindir.

Perhaps if that read closer to `--instdir` that would have been more
clear?

Thanks,
Guillem