Summary:ASTERISK-03673: asterisk.8 should not be compressed
Reporter:Tzafrir Cohen (tzafrir)Labels:
Date Opened:2005-03-11 16:30:42.000-0600Date Closed:2011-06-07 14:11:59
Versions:Frequency of
Description:The man page is currently compressed using gzip. this saves practically nothing, as when it is the tarball it comes compressed and when it's fetched from the CVS people can used cvs -z3.

Furthermore, the fact that it is compressed makes it a binary file that cannot be diffed. If I change the behaviour of asterisk(8) and want to update the man page accordingly, I cann't include the chage to the man page in my patch.

Furthermore, different distributions have different policies regarding man page compressions. Debian, for instance, uses gzip -9. Mandrake uses bzip2. So the compressed man page actually generates headache for packagers.

Compressing a man page at install time is trivial. I'll add a patch if it is really necessary. I just hate messing with copyright assignments for such trivial stuff.

This applies to both CVS HEAD and latest 1.0 release.
Comments:By: Mark Spencer (markster) 2005-03-11 23:48:59.000-0600

The manpage itself wouldn't be diffed, but the sgml that is used to create it using docbook can be diffed (e.g. cvs -Q diff -u -r 1.1 -r 1.2 asterisk.sgml provides the most recent set of changes)

The compressed version saves space on the disk when installed.  Try ls /usr/share/man/man1 and notice that all or most of the man pages installed on your system are already compressed for you.