[Freewx-maint] Bug#643287: wx2.8-doc: wx.hhp gzipped

[Olly Betts]

On Tue, Sep 27, 2011 at 09:37:31AM +1000, Kevin Ryde wrote:
> I tried to open the wx manual in a wxHtmlHelpController with the bit of
> wxperl below, but it gave an error dialog
> 
>     Cannot open contents file: 
> 
> (no message after the colon).
> 
> Is the wx.hhp usable by the help system when gzipped?  I got some joy
> from uncompressing it plus wx.hhc.gz and wx.hhk.gz.  Could they be
> provided uncompressed in the package so they can be used?

The downside of providing them uncompressed is they're then 4.2MB
rather than just under 500KB.  That increases the size of the docs
by about 50%, which is quite an overhead given these files probably
aren't used by many users.

> I see the help controller thing might accept a .zip file, dunno if
> that's better than .gz format.

I had a look, but that seems to require putting all the HTML files
into the zip file as well, which makes them much harder to use for
those just wanting the HTML.

Perhaps splitting this stuff into a separate package is the best
answer.

Cheers,
    Olly