<table><tr><td style="">kossebau updated the summary for this revision. <a href="https://phabricator.kde.org/transactions/detail/PHID-XACT-DREV-ejykzeuw7t7eeku/" rel="noreferrer">(Show Details)</a>
</td><a style="text-decoration: none; padding: 4px 8px; margin: 0 8px 8px; float: right; color: #464C5C; font-weight: bold; border-radius: 3px; background-color: #F7F7F9; background-image: linear-gradient(to bottom,#fff,#f1f0f1); display: inline-block; border: 1px solid rgba(71,87,120,.2);" href="https://phabricator.kde.org/D2854" rel="noreferrer">View Revision</a></tr></table><br /><div><strong>EDIT DETAILS</strong><div><div style="white-space: pre-wrap; color: #74777D;"><div style="padding: 8px 0;">...</div>like Qt's own QCH files are to doc.qt.io<span style="padding: 0 2px; color: #3e6d35; background: rgba(151, 234, 151, .6);">,</span><br />
<br />
While QCH files from an abstract POV could be seen similar to code libraries, being components with<div style="padding: 8px 0;">...</div>Qt-extending libraries into the same folder where Qt's own QCH<span style="padding: 0 2px; color: #3e6d35; background: rgba(151, 234, 151, .6);"><br />
files are, so Qt Assistant & other QCH viewer pick up them automatically<br />
to add them to the default help file collection.<br />
The QCHDIR variant would provide a neutral, but central installation location.<br />
Neutral, as it never "pollutes" the Qt system dirs with files possibly unrelated to<br />
Qt-based development (e.g. when simply using qthelp tools for documentation),<br />
and central, to help with finding available QCH files for manually adding/loading<br />
them into a viewer, given there is no official way currently to register the availability of</span><br />
<span style="padding: 0 2px; color: #802b2b; background: rgba(251, 175, 175, .7);">files are, so Qt Assistant & other </span>QCH <span style="padding: 0 2px; color: #802b2b; background: rgba(251, 175, 175, .7);">viewer pick up them automatically</span><span style="padding: 0 2px; color: #3e6d35; background: rgba(151, 234, 151, .6);">files on installing</span>.<div style="padding: 8px 0;">...</div>* released current doxygen versions broken and miss to include some files with generated QCH (https://bugzilla.gnome.org/show_bug.cgi?id=773693), fixed only in doxygen development version<span style="padding: 0 2px; color: #3e6d35; background: rgba(151, 234, 151, .6);">, patched already in [[ https://build.opensuse.org/package/view_file/openSUSE:Factory/doxygen/doxygen-fix-QCH-files.patch?expand=1 | openSUSE Tumbleweed]]</span><br />
* Qt Assistant often only built with QTextBrowser, while doxygen uses lots of HTML5 (incl. hardcoded JavaScript) (https://bugzilla.gnome.org/show_bug.cgi?id=773715), needs e.g. distributions to use QtWebKit to work<span style="padding: 0 2px; color: #3e6d35; background: rgba(151, 234, 151, .6);"> ([[https://bugzilla.suse.com/show_bug.cgi?id=1011355 | bug filed with openSUSE]])</span><br />
* inter-QCH links do not work in KDevelop currently (see https://bugs.kde.org/show_bug.cgi?id=372747)<div style="padding: 8px 0;">...</div></div></div></div><br /><div><strong>REPOSITORY</strong><div><div>R240 Extra CMake Modules</div></div></div><br /><div><strong>REVISION DETAIL</strong><div><a href="https://phabricator.kde.org/D2854" rel="noreferrer">https://phabricator.kde.org/D2854</a></div></div><br /><div><strong>EMAIL PREFERENCES</strong><div><a href="https://phabricator.kde.org/settings/panel/emailpreferences/" rel="noreferrer">https://phabricator.kde.org/settings/panel/emailpreferences/</a></div></div><br /><div><strong>To: </strong>kossebau, staniek, Frameworks<br /><strong>Cc: </strong>shumski, kfunk, staniek, winterz, ochurlaud, KDevelop<br /></div>