| Summary: | ASTERISK-05022: man pages should not be compressed | ||
| Reporter: | Tzafrir Cohen (tzafrir) | Labels: | |
| Date Opened: | 2005-09-08 04:32:13 | Date Closed: | 2008-06-07 11:04:12 |
| Priority: | Trivial | Regression? | No |
| Status: | Closed/Complete | Components: | Core/General |
| Versions: | Frequency of Occurrence | ||
| Related Issues: | |||
| Environment: | Attachments: | ||
| 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) ------------------------------------------------------------------------ http://svn.digium.com/view/dahdi?view=rev&revision=769 | ||