Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-22640

Deployment instructions on Assistant

    XMLWordPrintable

Details

    • Task
    • Resolution: Out of scope
    • P2: Important
    • None
    • None
    • Documentation
    • None
    • Windows XP Home SP3
      AMD Athlon 64 X2 Dual
      2GB RAM

      MinGW AND VS2008

    Description

      The deployment help for Assistant at:

      http://doc.qt.nokia.com/latest/assistant-custom-help-viewer.html

      could be better, on the following three points:

      1) The existing documentation is not entirely clear about whether both the qch and qhc file need to be distributed; and if the qch file need be registered in the qhc file by, e.g. the application installer. (I think the page used to contain a statement that sounds like assistant only needed the qch file, but that seems to not be the case.) I have found that if I create my help project in one folder and copy only the qhc collection file to another folder, the collection is still depending on the original qch file. I find that if I copy both to an application testing folder and register it there, I can copy both to a target machine, and they will run. Presumably, if I create the collection and add the help file to it in the help development folder, and copy both together, that would work also.

      2) A clear statement as to whether assistant is covered under the LGPL license would be helpful, also.

      3) By copying a copy of assistant.exe to another folder on Windows, one can see what DLL files it requires to run, by the errors it produces. This is not the case for the qsqlite4.dll file, which, as it turns out, MUST be placed in an sqldrivers folder in the folder in which assistant runs, not in the same folder (although other locations, depending on the path and QTDIR settings, may suffice. For distribution, it seems most intuitive to place it in an sqldrivers folder.)

      Furthermore, I was unable to find "Using Qt Assistant as a Custom Help Viewer" in my QTSDK distribution's help, which only existed in the Harmattan section; which I uninstalled, as I do not need it yet.

      Attachments

        No reviews matched the request. Check your Options in the drop-down menu of this sections header.

        Activity

          People

            docteam Qt Documentation Team
            codelurker Code Lurker
            Votes:
            0 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes