QtCreator IDE with inline ROOT help

[ferdymercury]

As suggested by @couet, I am preparing a blog post on how to use QtCreator's IDE for building ROOT, or ROOT-depending CMake projects, with in-built help support using the "F1" button.

This is still a draft.

Here a list of "documentation" issues (that I found while working on this):

• (Main stopper) Wrong QHP index structure doxygen/doxygen#9094
• Problem with endcond within C preprocessor macro doxygen/doxygen#9056
• copydoc exclude one (or several) parameters doxygen/doxygen#9040
• Qhelpgenerator debug mode doxygen/doxygen#9135
• QHP index contains duplicated file entries doxygen/doxygen#9138
• doxygen confused with C++ visibility attribute doxygen/doxygen#9142
• warning file-line format in Possible candidates doxygen/doxygen#9143
• problem with matching function when using default arguments doxygen/doxygen#9144
• No uniquely matching class member, but no candidates are printed. doxygen/doxygen#9148
• Doxygen crash with NUM_PROC_THREADS>1 doxygen/doxygen#9155
• Codebase static analysis shows some potential leaks and nullptr access doxygen/doxygen#9157
• missing preposition doxygen/doxygen#9173
• doxygen -x_noenv option to not expand environment variables doxygen/doxygen#9187
• File-Line is omitted when suggesting possible candidates depending on noMatchCount doxygen/doxygen#9276
• https://bugreports.qt.io/projects/QTCREATORBUG/issues/QTCREATORBUG-26862
• https://bugreports.qt.io/browse/QTCREATORBUG-26892
• https://bugreports.qt.io/browse/QTBUG-101070
• [docu] qhelpgenerator on doxygen root#8781
• [core] Solve Streamer function warning in Doxygen and partly expose ClassDef documentation root#9629
• [roofit] fix doxygen warnings v2 root#9657
• [core/misc] fix some more doxygen warnings root#9655
• [proof] fix doxygen warnings root#9654
• [TMVA] fix some inconsistencies and warnings found by doxygen root#9651
• [inc] avoid doxygen warnings root#9943
• Prevents doxygen from parsing non-C++-standard keywords [skip-ci] root#9946
• Automated documentation test for new PR root#9953
• [doxy] add some more folders to include path root#9955
• [docu] Migrate doxygen Makefile to CMake root#9966
• [doxy] Check non-NULL result of fopen, to prevent crash root#9983
• [skip-ci] [doxy] speedup dot generation in docu root#10000
• [doxy] precompile libs script root#10004
• [cling-docu] raw help root#10056
• ROOT tag file contains hard coded paths root#10059
• guard to only run graphstruct tutorial if gviz ON, and more root#10060
• [MetaSema/TApplication] outdated .help message root#10065
• [doxy] qch and tag as compressed files root#10066
• [doxy] upgrade to Mathjax3 root#10067

[couet]

I'll wait your green light to merge it.

[eguiraud]

@ferdymercury thanks a lot! @couet please also wait for a review on the content by a ROOT dev to merge this!

[ferdymercury]

Also I do not know if the images are intended to be seen in details, but as its is now it is impossible to read the tex on them

Thanks! If you click on them, do they get bigger ?

If not, I could try to change to something like https://stackoverflow.com/a/31561231/7471760

[couet]

Thanks! If you click on them, do they get bigger ?

no, they are static

[ferdymercury]

thanks. I commited a fix.

[couet]

You start your blog post with:

# Coding in ROOT with the horsepower of an F1

You should remove it, as it duplicates the text title. Then the following paragraph
will be used as abstract on the web site home page.
Example: https://github.com/root-project/web/blob/main/blog/_posts/2014-05-31-rainbow-color-map.md

[ferdymercury]

Thanks for the hint. Removed. The paragraph just below fits already well as an abstract / introduction.

[couet]

@ferdymercury: Do you think it can be merged soon ? I see the qch file here: https://root.cern/reference/ is there.

[ferdymercury]

@ferdymercury: Do you think it can be merged soon ? I see the qch file here: https://root.cern/reference/ is there.

Thanks! That's great.

Yes, I think so, from my side it's ready, though we should wait for Axel's opinion.

It would also be convenient to wait first for these issues to be addressed:

Thanks and have a nice weekend!

[couet]

I do not this these issues are connected to this ?
this one is a blog post about QtCreator.we can merge if @Axel-Naumann is ok.