Easier access to Qt Documentation

[drhex]

Here is the itch I had to scratch: When coding in Qt, it takes a lot of scrolling and time to find the right classes on the All Classes page. There is of course the Main Classes page, but you might not agree with the Trolls on which classes are the "main" ones.

With this short program it is easy to make a small & relevant page:

1. The program takes one argument, the name of a directory where you keep source code for some big project.
2. In that directory, all files with extention .cc .h and .cpp will be scanned for Qt classes.
3. On stdout, the program will print a html page formatted just like Main Classes but with your classes instead.
4. So direct the output to a file, say myclasses.html, in <Qt-installation-dir>/doc/html.
5. edit <Qt-installation-dir>/doc/html/index.html Right after the first "middot", insert something like:
   

   <a href="myclasses.html"><font color="#004faf">Foobar's&nbsp;Classes</font></a>&nbsp;&middot;

   <a href="myclasses.html"><font color="#004faf">Foobar's&nbsp;Classes</font></a>&nbsp;&middot;

   To copy to clipboard, switch view to plain text mode 
6. Then, you can browse the docs with Qt Assistant or a web browser, as usual.

(Tested on Linux)

[fullmetalcoder]

Just wondering... Have you tried :

1. The index search of Qt Assistant
2. The search of Qt Assistant
3. The bookmarks features in Qt Assistant

Maybe you did not need to write a program for this... Interesting proof of concept anyway. You may want to extend it by adding an Assistant file that would generate an entry in the index pointing to your custom documentation : http://doc.trolltech.com/4.2/assista...umentation-set

[drhex]

No, I haven't tried those... I normally browse the documentation using a few tabs in Firefox as I always have a web browser running anyway and so can avoid cluttering the desktop with another app.
I like Qt Assistant's font size-buttons though, and clutter is less of a problem when using virtual desktops properly.