July 13, 2010

pavko pavko
Lab Rat
8 posts

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

July 14, 2010

Vass Vass
Hobby Entomologist
738 posts

Good question, I join to it.

pavko, Please, give me qch-file with C++ reference, I need it.
Thanks.

 Signature 


Vasiliy

July 14, 2010

pavko pavko
Lab Rat
8 posts

my cppref.qch [docs.google.com]

July 14, 2010

lyuts lyuts
Lab Rat
169 posts

I just added your qch file to Qt Creator’s help via Tools->Options->Help->Documentatioin tab, pressed F1, and got cpp reference. Try to check Filters tab, there should be corresponding items checked for cpp reference.

 Signature 

I’m a rebel in the S.D.G.

July 14, 2010

pavko pavko
Lab Rat
8 posts

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 :)

July 14, 2010

lyuts lyuts
Lab Rat
169 posts

Sorry, I just misunderstood the original issue.

 Signature 

I’m a rebel in the S.D.G.

July 15, 2010

Bradley Bradley
Lab Rat
314 posts

Do you have a C++ project open? It appears to me that Qt Creator may not scan the source files for symbols unless a C++ project is open.

Have you restarted Qt Creator? I have also found that sometimes Qt Creator needs to be restarted after the qch is registered with it.

 Signature 

Nokia Certified Qt Specialist.

July 15, 2010

pavko pavko
Lab Rat
8 posts

Yes, I did this. Actualy I mean context help, like in this post [qtcreator.blogspot.com]

Content and index are working fine.

July 15, 2010

Bradley Bradley
Lab Rat
314 posts

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.

 Signature 

Nokia Certified Qt Specialist.

July 15, 2010

Tobias Hunger Tobias Hunger
Mad Scientist
3156 posts

bradley: We try not to break creator, but sometimes something does slip through… having said that: Most of the people working on qt creator do so using creator from the branch they work on, so we do tend to notice most breakages:-)

November 14, 2010

floridaboy floridaboy
Lab Rat
1 posts

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?

January 3, 2011

KiaPlayer KiaPlayer
Lab Rat
1 posts

I tried “cppref.qch” with Qt Creator 2.0.1. Context help works fine for functions (e.g. abs, ceil, atoi), but doesn’t works for keywords (e.g. void, switch, public). But it’s good enough :)

August 29, 2011

dirx dirx
Lab Rat
2 posts

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:

  1. #include <QtCore/QCoreApplication>
  2. #include <cmath>
  3. #include <cstdio>
  4. #include <cstdlib>
  5.  
  6. int main(int argc, char *argv[])
  7. {
  8.     QCoreApplication a(argc, argv);
  9.     abs(10.0);
  10.     char name[] = "world";
  11.     FILE *out = fopen( "output.txt", "w" );
  12.          if( out != NULL )
  13.            fprintf( out, "Hello %s\n", name );
  14.     sqrt(12.2);
  15.     rand();
  16.     return a.exec();
  17. }

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.

August 29, 2011

dirx dirx
Lab Rat
2 posts

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

March 12, 2012

pavko pavko
Lab Rat
8 posts

To finalize this thread – you can find cpp reference in qch format here CPP-reference [en.cppreference.com]

April 5, 2012

Tobias Hunger Tobias Hunger
Mad Scientist
3156 posts

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;-)

 
  ‹‹ QtService & RegisterDeviceNotification      Building QtMobility docs ››

You must log in to post a reply. Not a member yet? Register here!