https://bugs.kde.org/show_bug.cgi?id=373723

            Bug ID: 373723
           Summary: CHM Support
           Product: frameworks-kapidox
           Version: unspecified
          Platform: unspecified
                OS: All
            Status: UNCONFIRMED
          Severity: wishlist
          Priority: NOR
         Component: general
          Assignee: kdelibs-b...@kde.org
          Reporter: rjvber...@gmail.com
  Target Milestone: ---

There have been recent regressions in Qt's Assistant which make it much less
appealing as a help/documentation browser, and it has always had the habit of
resetting the documentation list on version upgrades. It is also prone to
crashing if its database becomes corrupted, and doesn't support opening a .qch
file from the commandline.

I have been testing an alternative that uses the free kchmviewer (on
SourceForge) and FreePascal's chmcmd (which technically can be distributed on
its own). This works really nicely; there's a rich browsable content table and
index, and doxygen's layout is much better preserved than Qt's Assistant does,
currently. Icing on the cake: the .chm files can be up to about twice smaller.

The only drawback is that doxygen's SEARCHENGINE feature is turned off (which
means that generator.py has to cope with a missing searchdata.xml file), but is
that feature actually used in .qch files?

For now I've "hacked in" the .chm generation; my Python knowledge is a bit too
rusty for kapidox's code to propose a quick, elegant patch that enables
optional .chm generation.

(Evidently it can be an advantage to load a browsable collection of
documentation files, like Qt's Assistant does.)

-- 
You are receiving this mail because:
You are watching all bug changes.

Reply via email to