[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Bug#52488: maint-guide can't be purged properly due to a .dhelp file



Hi.

In <20000131094458.C4796@paper.kitenet.net>,
 at Date: Mon, 31 Jan 2000 09:44:59 -0500,
  on Subject: Re: Bug#52488: maint-guide can't be purged properly due to a .dhelp file,
   Joey Hess <joeyh@debian.org> writes:

> Marco Budde wrote:
> > Sorry, but you are 100% wrong. .dhelp files are static files.
> > dhelp does not change, create, modify, ... them.

This is described in dhelp_parse(8). And I don't claim objection to this.

> > Some maintainers use doc-base and this is the real problem,
> > because this program creates such .dhelp files during
> > the installation process of a package.
> > To avoid such problems in future: use dhelp directly.

I do not agree to this. using doc-base should not be any problem at all.
"install-docs -r <package>" should be enable to remove .dhelp which is 
generated by "install-docs -i /usr/share/doc-base/<package>".

I check this problem, and found that /usr/share/doc-base/maint-guide has:

Format: HTML
Index: /usr/doc/maint-guide/maint-guide.html/index.en.html
Files: /usr/doc/maint-guide/maint-guide.html/*.html

and this seems to cause the problem.

"install-docs -i /usr/share/doc-base/maint-guide" in postinst of maint-guide,
uses these info to register .dhelp,
so /var/lib/doc-base/info/maint-guide.list has the line:

/usr/doc/maint-guide/maint-guide.html/.dhelp

And, when user does dpkg --remove or --purge,
"install-docs -r maint-guide" in prerm of maint-guide uses this line
to find the file to be removed.

Unfortunately, prerm has the line

if [ \( "$1" = "upgrade" -o "$1" = "remove" \) -a -L /usr/doc/maint-guide ]; then
        rm -f /usr/doc/maint-guide
fi

before calling "install-docs -r".

so "install-docs -r maint-guide" can not open the specified file
(i.e. "/usr/doc/maint-guide/maint-guide.html/.dhelp") and this file
just left unremoved.

I think the required change is write the real location of the file
into /usr/share/doc-base/maint-guide. And this will be the work 
for Josip, as the maintainer of maint-guide.

# sorry if this mail hurt your feelings, joy.
# but fixing the bugs is our motivation to use the BTS, I think.

This can be checked by

apt-get install maint-guide

edit /var/lib/doc-base/info/maint-guide.list to change 

/usr/doc/maint-guide/maint-guide.html/.dhelp

to:

/usr/share/doc/maint-guide/maint-guide.html/.dhelp

then, use "dpkg --remove (or --purge) maint-guide".

Sincerely.

P.S.
packages such like libtiff3g-dev,python-xml,sysadmin-guide seems
to have the same problems. fdutils escapes this problem by
changing the order in prerm.
(first use install-docs -r, then rm the link in /usr/doc)

Maybe the wishlist report for debhelper to change the default
order in prerm in the way fdutils uses (first use install-docs,
then rm the link in /usr/doc) work for other packages.
# i.e. modifying dh_installdocs to change the order the script
# automatically inserted.

-- 
  Taketoshi Sano: <sano@debian.org>,<sano@debian.or.jp>,<kgh12351@nifty.ne.jp>


Reply to: