Hi,

I am happy to announce that the MITK/BlueBerry support for QCH (Qt 
Compressed Help) files representing "User Manuals" has been reworked 
substantially. The past system occasionally exhibited a couple of 
issues, ranging from minor annoyances to actual faulty behavior:

- On some platforms, the Qt Assistant executable was not found and/or 
not packaged when issuing a "make package"
- (Un)Registering of QCH files sometimes failed with confusing error 
messages
- Registering of QCH files on start-up of deployed applications 
sometimes failed completely
- Re-registering of changed QCH files (from re-compiled plug-ins) did 
not always work

These issues have been resolved in the MITK Git master. Additionally, 
the following improvements took place:

- Seamless integration of the Qt Help System in the BlueBerry Workbench 
(specialized Views and Editors)
- Removal of the superficial first level in the "Contents Tree" of the 
registered QCH files and alphabetical sorting
- Easy method to request special context help (using the CTK EventAdmin 
service)

After updating your MITK repository you must issue a build in MITK's 
superbuild directory (the CTK version changed). Running a MITK based 
application using the update code base might result in start-up errors. 
In that case, please start your application with the

--BlueBerry.clean

command line argument *once*. This will also delete your custom 
application preferences - you might want to export and afterwards import 
them again.

If you are using the MITK ExtApp, you are all set.

If you use your own executable to bootstrap the BlueBerry Workbench, 
make sure that the new org.blueberry.ui.qt.help plug-in is switched ON.

If you are providing your own BlueBerry WorkbenchAdvisor class (instead 
of using the org.mitk.gui.qt.extapplication plug-in) you might be 
interested in commit [1] and [2] for the relevant changes. Please also 
read the org.blueberry.ui.qt.help documentation [3].

Please also note that the old system (using the external Qt Assistant 
executable) is deprecated.

Thanks,

Sascha

[1] 
https://github.com/MITK/MITK/commit/96309d53e641d0d75fca8d01bde81c1384f5ac3a

[2] 
https://github.com/MITK/MITK/commit/96a61e813ab1046f1e4cc53e39045b7abf75d38e#diff-7

[3] 
http://docs.mitk.org/nightly-qt4/BlueBerry/reference/api/html/group__org__blueberry__ui__qt__help.html
 
(available on 8/2/12)

------------------------------------------------------------------------------
Keep Your Developer Skills Current with LearnDevNow!
The most comprehensive online learning library for Microsoft developers
is just $99.99! Visual Studio, SharePoint, SQL - plus HTML5, CSS3, MVC3,
Metro Style Apps, more. Free future releases when you subscribe now!
http://p.sf.net/sfu/learndevnow-d2d
_______________________________________________
mitk-users mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/mitk-users

Reply via email to