[asterisk-bugs] [Asterisk 0005158]: man pages should not be compressed

[noreply at bugs.digium.com]

A NOTE has been added to this issue. 
====================================================================== 
http://bugs.digium.com/view.php?id=5158 
====================================================================== 
Reported By:                tzafrir
Assigned To:                russell
====================================================================== 
Project:                    Asterisk
Issue ID:                   5158
Category:                   Core/General
Reproducibility:            unable to reproduce
Severity:                   trivial
Priority:                   normal
Status:                     closed
Asterisk Version:           I did not set the version :( 
SVN Branch (only for SVN checkouts, not tarball releases): N/A 
SVN Revision (number only!):  
Disclaimer on File?:        N/A 
Request Review:              
Resolution:                 fixed
Fixed in Version:           
====================================================================== 
Date Submitted:             09-08-2005 04:32 CDT
Last Modified:              06-07-2008 11:04 CDT
====================================================================== 
Summary:                    man pages should not be compressed
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
====================================================================== 

---------------------------------------------------------------------- 
 svnbot - 06-07-08 11:04  
---------------------------------------------------------------------- 
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
http://bugs.digium.com/view.php?id=5158)
don't keep SGML sources (troff version is fine)

------------------------------------------------------------------------

http://svn.digium.com/view/dahdi?view=rev&revision=769 

Issue History 
Date Modified   Username       Field                    Change               
====================================================================== 
06-07-08 11:04  svnbot         Checkin                                      
06-07-08 11:04  svnbot         Note Added: 0088066                          
======================================================================