Summary:ASTERISK-05022: man pages should not be compressed
Reporter:Tzafrir Cohen (tzafrir)Labels:
Date Opened:2005-09-08 04:32:13Date Closed:2008-06-07 11:04:12
Versions:Frequency of
Description:The package zaptel includes three man pages. They are products of a conversion from sgml.

Compressing them doesn't save any bandwidth, as whenever they are sent, the traffic is compressed (tar.gz) or can be easily compressed (cvs -z) . Furthermore, I believe that compressing them separtely only gives less opportunities for the above two compressions and reduces the over-all compression ratio.

Furthermore, man pages are not always compressed with gzip. On some systems (Mandrake? SuSE?) they are compressed with bzip2. On others, maximal compression   of gzip (gzip -9 is used): There has already been a bug filed on the Asterisk Debian package for not properly compressing man pages.

In other words: leave compression of man pages to the installer, where it belongs, and keep man pages uncompressed.

And if you're really that concerened about disk space, write man pages in plain troff. It beats gzip -9 /bzip2 compression and makes the update cycle of man pages simpler. And can even save a 2 or 3 blocks on the disk. Wow!

If not, please don't cause extra overhead for packagers. Thanks
Comments:By: Michael Jerris (mikej) 2005-09-13 21:21:38

drumkilla.  as discussed:

we need to stop compressing the existing files, and remove the .sgml files completely so that all the man pages are in normal t/nroff format

the build rules in the zaptel makefile for converting the sgml files can go away as well

By: Michael Jerris (mikej) 2005-09-13 22:44:21

tzafrir.  To help this along, could you submit copies of all the man pages in the proper format?

By: Kevin P. Fleming (kpfleming) 2005-09-14 20:12:12

Fixed in CVS HEAD.

By: Digium Subversion (svnbot) 2008-06-07 11:04:12

Repository: dahdi
Revision: 769

U   trunk/Makefile
A   trunk/doc/ztcfg.8
D   trunk/doc/ztcfg.8.gz
D   trunk/doc/ztcfg.sgml
A   trunk/doc/ztmonitor.8
D   trunk/doc/ztmonitor.8.gz
D   trunk/doc/ztmonitor.sgml
A   trunk/doc/zttool.8
D   trunk/doc/zttool.8.gz
D   trunk/doc/zttool.sgml

r769 | kpfleming | 2008-06-07 11:04:10 -0500 (Sat, 07 Jun 2008) | 3 lines

only put uncompressed man pages into source tree (issue ASTERISK-5022)
don't keep SGML sources (troff version is fine)