Re: documentation in .deb packages
Hi,
ext Andrew Zabolotny wrote:
So far my packages
install a few files in /usr/share/doc/${pkg}/ and for some reason
they are not autoremoved.
Did you use apt to install them, or did you use dpkg directly?
I use Application Manager, clicking in browser on a .deb file and then
app manager is launched and installs the .deb.
However, now I understand why the directories under /usr/share/doc
sometimes disappears by magic, it seems docpurge was launched when I
installed something from the repositories :-)
I think docpurge is installed as Apt hook.
Looks like Application Manager also uses dpkg when installing a single
deb file. I tried to put the .deb to my own private repository and
voila - no doc files :)
If you're building a package specifically for Maemo, then by all means
remove the docs from the deb! You'll reduce the download size, and
save some flash memory from wearing out sooner.
I realise this, but most debs contain anyway at least the the changelog.
It's better to split docs to separate package if there are lots of them.
And preferably try to propagate this change to upstream if it's not your
own package.
- Eero
___
maemo-developers mailing list
maemo-developers@maemo.org
https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: documentation in .deb packages
From Tue, 22 Jul 2008 01:40:25 +0300
Marius Gedminas [EMAIL PROTECTED] wrote:
So far my packages
install a few files in /usr/share/doc/${pkg}/ and for some reason
they are not autoremoved.
Did you use apt to install them, or did you use dpkg directly?
I use Application Manager, clicking in browser on a .deb file and then
app manager is launched and installs the .deb.
However, now I understand why the directories under /usr/share/doc
sometimes disappears by magic, it seems docpurge was launched when I
installed something from the repositories :-)
Looks like Application Manager also uses dpkg when installing a single
deb file. I tried to put the .deb to my own private repository and
voila - no doc files :)
If you're building a package specifically for Maemo, then by all means
remove the docs from the deb! You'll reduce the download size, and
save some flash memory from wearing out sooner.
I realise this, but most debs contain anyway at least the the changelog.
Anyway, thanks for explanation :-)
--
Andrew
signature.asc
Description: PGP signature
___
maemo-developers mailing list
maemo-developers@maemo.org
https://lists.maemo.org/mailman/listinfo/maemo-developers
documentation in .deb packages
Hello!
I'm trying to understand the machinery that automatically removes the
documentation file when installing them on tablet. So far my packages
install a few files in /usr/share/doc/${pkg}/ and for some reason they
are not autoremoved.
Some more complex packages also have documentation inside the .deb
file, but at some point it is removed, although I don't get at which
(install-docs in postinst it seems?)
Can somebody explain how this works and what I should put in the .rules
to generate the correct postinst hooks.
For reference, my package builds with the following commands:
dh_installchangelogs
dh_installdocs
dh_install
dh_compress
dh_fixperms
dh_installdeb
dh_gencontrol
dh_md5sums
dh_builddeb
Sure, I can just remove dh_installchangelogs dh_installdocs and there
simply won't be any docs in the .deb. However, it's a matter of
principle :-)
I have a postinst script, but it contains a proper #DEBHELPER# line so
debhelper could insert there whatever he wants... however, #DEBHELPER#
is replaced with a empty line.
--
Andrew
signature.asc
Description: PGP signature
___
maemo-developers mailing list
maemo-developers@maemo.org
https://lists.maemo.org/mailman/listinfo/maemo-developers
Re: documentation in .deb packages
On Tue, Jul 22, 2008 at 02:10:26AM +0400, Andrew Zabolotny wrote:
I'm trying to understand the machinery that automatically removes the
documentation file when installing them on tablet.
apt-cache show docpurge
cat /etc/apt/apt.conf.d/99-docpurge
cat /usr/sbin/docpurge
So far my packages
install a few files in /usr/share/doc/${pkg}/ and for some reason they
are not autoremoved.
Did you use apt to install them, or did you use dpkg directly?
Some more complex packages also have documentation inside the .deb
file, but at some point it is removed, although I don't get at which
(install-docs in postinst it seems?)
Later. After apt-get finishes its work, it calls docpurge. If you
don't use apt-get, docpurge is never called, hence my question about
calling dpkg directly.
Can somebody explain how this works and what I should put in the .rules
to generate the correct postinst hooks.
You don't need to do anything.
Sure, I can just remove dh_installchangelogs dh_installdocs and there
simply won't be any docs in the .deb. However, it's a matter of
principle :-)
If you're building a package specifically for Maemo, then by all means
remove the docs from the deb! You'll reduce the download size, and
save some flash memory from wearing out sooner.
HTH,
Marius Gedminas
--
The last good thing written in C was Franz Schubert's Symphony #9.
-- Erwin Dietrich
signature.asc
Description: Digital signature
___
maemo-developers mailing list
maemo-developers@maemo.org
https://lists.maemo.org/mailman/listinfo/maemo-developers
