C++ Reference in QtCreator help
Hello all,
I just started to learn C++ wiht QT and found that context help in QtCreator is very helpfull
I downloaded C++ Reference from C++ Reference wiki [cppreference.com]
I converted unpacked content from chm to qch file with content and index.
It works fine, but context help in source editor doesn’t work.
Can anybody help me to understand how to make context help working with my compiled qch?
I can upload if you need C++ reference in qch format and qt project qhp files.
15 replies
my cppref.qch [docs.google.com]
I mean, that it doesn’t work in text editor. For example, when you point on keyword (something like “void”) pressing F1 – I want, that on the right side help about “void” apears. It doesn’t works.
So, I can’t find solution to make CONTEXT help possible. I don’t know how to turn it on with my compiled file.
Anyway – thanks for help :)
Yes, I did this. Actualy I mean context help, like in this post [qtcreator.blogspot.com]
Content and index are working fine.
The hover-and-hit-F1 context help works for me with the Qt Creator snapshot from Jun 7 (from revision b4bf0289b1, for Windows). If I hover-F1 over #include <algorithm>, it pulls up the algorithms page. If I hover-F1 over #include <vector>, it pulls up the vector page. If I hover over #include <numeric>, it does not work (probably because there is no numeric keyword in the index). The context help has been somewhat problematic, but it has been getting more reliable over time. I find recent development builds work more often than not.
I tried with Qt Creator 2.0.1 and yes, the context help does not work. I did not debug the Qt Creator, but STL reference (available here: http://developer.qt.nokia.com/wiki/Qt_Creator_Documentation_Gallery) does work in the context mode. This makes me wonder if the context tags were generated correctly when the cppref.qch file was created?
The context help (F1) seems only to work, if the correct #include statement is in the code. I tried “cppref.qch” and also the Linux Man Pages (available here http://developer.qt.nokia.com/wiki/Qt_Creator_Documentation_Gallery) with Qt Creator 2.2.1 and also the latest nightly build of 2.3.
Here an example code to test the context help:
- #include <QtCore/QCoreApplication>
- #include <cmath>
- #include <cstdio>
- #include <cstdlib>
- int main(int argc, char *argv[])
- {
- abs(10.0);
- char name[] = "world";
- FILE *out = fopen( "output.txt", "w" );
- if( out != NULL )
- fprintf( out, "Hello %s\n", name );
- sqrt(12.2);
- rand();
- return a.exec();
- }
For example, for the math functions abs() and sqrt() the context help works only if <cmath> is included and recognized by QtCreator (cmath.h must be in the PATH or in INCLUDEPATH of the *.pro project file). The same behavior for rand() and <cstdlib>. But for printf, fprintf or fopen the context help does not work at all, even with <cstdio>. Also no context help for the keywords.
Normally, a context help system should be independent of the syntax parser, i.e. the include files, as it happens often that one would like to know the correct include file for a specific function.
Same problem for QCoreApplication and its #include statement, as soon as the #include <QtCore/QCoreApplication> statement is commented (//) or removed, “QCoreApplication” change its color and no more context help via F1.
So the problem seems to be general for all qch-help files and not only the C++-reference or Linux Man Pages help files. It is a problem of Qt Creator and not the help files or their context tags.
I have put a bug-report here:
https://bugreports.qt.nokia.com/browse/QTCREATORBUG-5948
To finalize this thread – you can find cpp reference in qch format here CPP-reference [en.cppreference.com]
I took the liberty of adding that link to the Qt Creator documentation gallery [qt-project.org] (below the other link to and C++ reference in QCH format;-)
You must log in to post a reply. Not a member yet? Register here!




