Re: Some files in /usr/share/doc/foo stay uncompressed, some are compressed

[Justin Pryzby <justinpryzby@users.sourceforge.net>]

On Sun, Feb 12, 2006 at 07:02:08PM +0100, Marc Haber wrote:
> Hi,
> 
> exim4-doc-html includes the exim FAQ, which is a bunch of HTML files
> and some configuration examples as .txt, in
> /usr/share/doc/exim4-doc-html/html. The larger of these .txt files are
> compressed by the build processs, while the smaller of them stay
> uncompressed. This is confusing.
> 
> I am now wondering whether it is acceptable to compress all of the
> .txt files, or to keep all of them uncompressed. Which would be the
> lesser evil?
This is from policy 12.3:

     Any additional documentation that comes with the package may be
     installed at the discretion of the package maintainer.  Text
     documentation should be installed in the directory
     `/usr/share/doc/<package>', where <package> is the name of the
     package, and compressed with `gzip -9' unless it is small.

"unless it is small" is pretty subjective, and it is at your
discretion anyway.

dh_compress says:

  ... files in usr/share/doc that are larger than 4k in size, (except
  the copyright file, .html and .css files,

So it seems that it shouldn't actually be compressing html files; you
should probably just figure out why it is .. DH_VERBOSE is your friend
here. 

Justin