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

Bug#338204: 12.3: define small for compression of documentation



Adam Heath writes ("Bug#338204: 12.3: define small for compression of documentation"):
> Section 12.3 says extra documentation should be compressed if it is
> small.  However, small is not defined.  It would be useful if it
> was;

Nonsese.  This should be interpreted in context.  A document which is
small when it is shipped with mozilla-firefox might well be large when
the same file is shipped as part of base-files.

>  otherwise, there is no real incentive to compress
> documentation, as one person's "too large" is another person's
> small.

Why can't we leave this up to the maintainer's judgement ?

(The comment about `incentive' is baffling.  Why would a maintainer
not have an incentive to improve the package ?)

> Also, the text says compressed with "gzip -9, unless it is small."  Does that
> mean I can compress with gzip -1 if it's small, or bzip, or zip?

It means you should read the document for what it is: a set of
guidelines to help people do the right thing - not a set of laws with
which to beat maintainers who disagree with you.

Ian.



Reply to: