How to obtain QCH doc files



  • I am attempting to learn PyQt, which comes with Qt Assistant but no offline Qt documentation. I have not been able to figure out how to obtain QCH documentation files for Qt 5 on Windows. I have seen this question asked on this forum before, but the links that were given in the answers seem to be broken now.

    Using 7-Zip, I was able to extract QCH files from Fedora's qt-doc RPM, but they only have docs for the old version (Qt 4). Fedora also has a qt5-qtdoc RPM, but it only contains generic help for the Qt project, not specific help for Qt's libraries. I also tried downloading several source distributions of Qt, but they all seemed to contain only HTML or QTDOC files, not QCH files. I don't want to have to build the documentation myself.

    Does anyone know where I can obtain QCH files for the latest version of Qt? (I want the docs for Qt, Qt Assistant, and Qt Linguist).

    Thank you.

    -- Timothy



  • You can download latest Qt from "here":http://qt-project.org/downloads
    After you will install it the qch files will be in Qt5.2.1/5.2.1/gcc_64/doc or in Qt5.3.0/Docs/Qt-5.3/ depending on Qt version.



  • Thank you for your reply.

    I had seen that mentioned somewhere else, but was hoping to be able to obtain the .QCH files without having to do a Qt installation.
    [Because I'm using PyQt, the other Qt components (including Qt Creator, which is not optional in the Qt installer) are unnecessary for me. So if I'd install Qt just for the documentation, I'd then likely uninstall it.]

    Is there some other way to do it?


  • Moderators

    Hi,

    There are no official standalone QCH packages, but try the "qt52doc" package from this "Ubuntu PPA":https://launchpad.net/~beineri/+archive/opt-qt521/+packages



  • I downloaded the Ubuntu qt52doc package, and it does contain the complete Qt 5 documentation in QCH format. However, it seems to be formatted differently from the official Qt docs. I also found a more official source for the Qt 5 docs by downloading "5.2.0mingw48_essentials.7z" from "the Qt5 folder in the QtSDKRepository":http://download.qt-project.org/online/qtsdkrepository/windows_x86/desktop/qt5/qt.520.win32_mingw48.essentials/, but it too had the docs formatted like Ubuntu.

    The Qt Assistant documentation shows this screenshot of the Preferences dialog (with just one item listed):

    !http://qt-project.org/doc/qt-5/images/assistant-preferences-documentation.png(assistant-preferences-documentation.png)!

    But after installing on my computer the QCH files contained in "5.2.0mingw48_essentials.7z", the Preferences dialog instead lists dozens of items such as "org.qt-project.qmake.520", "org.qt-project.activeqt.520", "org.qt-project.qtandroidextras.520", etc.

    There is no "com.trolltech.qt.520" item on the list. (When I installed the Ubuntu Qt 5 docs, the dialog looked the same, except that the documentation was for version 5.2.1.)

    I would like to have the Qt documentation installed like in the above screenshot. Besides being the way shown in the Qt Assistant docs, the Qt 4 docs I downloaded from Fedora were formatted that way.

    Based on andreyc's suggestion, I was wondering, where does Qt's online installer download the documentation from? I should be able to download it myself from that repository, shouldn't I?

    My real question is, how can I get "com.trolltech.qt.520" installed in Qt Assistant? (I am aware that Qt 5.2.1 is the latest version, but because of some Python/PyQt-related reasons, I can't use it right now.)

    -- Timothy


  • Moderators

    Hi,

    [quote author="rjusa" date="1397772309"]But after installing on my computer the QCH files contained in "5.2.0mingw48_essentials.7z", the Preferences dialog instead lists dozens of items such as "org.qt-project.qmake.520", "org.qt-project.activeqt.520", "org.qt-project.qtandroidextras.520", etc.[/quote]That is the official format. There is 1 .qch file per module.

    [quote]There is no "com.trolltech.qt.520" item on the list.

    ...

    Besides being the way shown in the Qt Assistant docs, the Qt 4 docs I downloaded from Fedora were formatted that way.[/quote]The screenshot is wrong and needs updating, unfortunately. Qt 5 is very different from Qt 4.

    Qt 4 was one monolithic library -- you either get everything or you get nothing. In contrast, Qt 5 is modularized -- you can choose to install only a subset of modules if you wish. You will only get .qch files for the modules that you install.

    Here is a screenshot of my IDE (Qt Creator has an integrated Qt Assistant), which has both Qt 4.8.5 and Qt 5.2.1:
    !http://i.imgur.com/Msnj6F7.png(Help)!

    FYI, Trolltech no longer exists. Trolltech founded Qt, but it was bought by Nokia and then by Digia.

    [quote]I was wondering, where does Qt's online installer download the documentation from? I should be able to download it myself from that repository, shouldn't I?[/quote]The online installer simply downloads the packages from the repository you found (e.g. 5.2.0mingw48_essentials.7z) and auto-extracts them for you.

    [quote]My real question is, how can I get "com.trolltech.qt.520" installed in Qt Assistant?[/quote]You can't.



  • Thank you.

    I was not aware of those changes between the Qt 4 and Qt 5 library and documentation structures.

    Now I understand things better.

    -- Timothy


  • Moderators

    You're welcome :) All the best with learning PyQt!


Log in to reply
 

Looks like your connection to Qt Forum was lost, please wait while we try to reconnect.