ROOT Team Meeting

Europe/Zurich
32/S-C22 (CERN)

32/S-C22

CERN

17
Show room on map
Axel Naumann (CERN)
Description
CERN number: 71400 Extension: 109284483#

Proposal for revamping the tutorials (Danilo)

In the tutorials a lot of knowledge about ROOT and its usage is condensed. They are pretty nice as they are but perhaps there are ways in which we could increase their value:

  • Alphabetically order the folders here https://root.cern/doc/master/group__Tutorials.html
  • Rename all the tutorials - apart from some, Roo* for example, the names say nothing.
  • Modernise all of them (C++11 standards). Some are areally poor in terms of coding style and C++
  • Remove all includes where they are not needed and make them macros
  • Hide the redundant ones as well as the uninformative ones and keep them as tests.
  • Translate more to python

Some observations have been made. To summarise them:

  • Axel: The "redundant/not-so-informative" tutorials could be directly moved to roottest in order not to expose them to the users.
  • Bertrand: Include directives were added everywhere at some point. We should decide once and for all what to do to avoid going back and forth. This was recognised as a fair point. At the time of CINT this was done to check the integrity of the code with Aclic (i.e. with a real compiler). Now with CLING the situation is probably better.
  • Enrico: Removing includes we give up the C++ compliance. This is true. The objection here is that macros still need to be C++ but we can strip away all the complications of the inclusion and linking given that auto{loading, parsing} are there to help.
  • Olivier: Several macros return a TCanvas*. This was there for THtml in order to show plots in the doc. We can now safely get rid of this.
There are minutes attached to this event. Show them.
    • 16:00 16:05
      News 5m
      • Meetings this week
    • 16:05 16:10
      Shift handover 5m
    • 16:10 16:40
      Topics 30m
      • classic builds
      • deprecation
      • code freeze for early January
    • 16:40 16:55
      Round table 15m
    • 16:55 16:59
      A.O.B. 4m