See https://github.com/root-project/root/issues/11937
for why that is currently needed. `flat_namespace` is not a solution.

See https://github.com/root-project/root/issues/11937
for why `-flat_namespace` is bad.

This reverts commit a05d4bed.

"suppress" ignores any unresolved symbol. This requires flat_namespace,
see man ld.

* fix doxygen errors in gui hist and graf

* some more

* missing doxy warnings graf geom

* doxy warnings html io

* fix doxygen warnings in math

* fix warnings in mc and net

Cast arguments to the correct `Long64_t` types. The methods signature are `TExMap::GetValue(Long64_t key)` and `TExMap::Add(Long64_t key, Long64_t value)`

* Fix \file references in doxygen markup

* Fix various "end of ..." warnings from doxygen.

This addresses warnings like:

- end of comment block while expecting command </b>
- end of comment block while expecting command </em>
- end of comment block while expecting command </pre>
- end of comment block while expecting command </s>
- end of comment block while expecting command </sup>
- end of comment block while expecting command </tt>
- end of comment block while expecting command </u>
- end of list marker found without any preceding list items
- found </em> tag without matching <em>
- found </li> tag without matching <li>
- found </pre> tag without matching <pre>
- found </sub> tag while expecting </sup>
- found </sup> tag without matching <sup>
- found </tt> tag without matching <tt>
- found </ul> tag without matching <ul>
- illegal </br> tag found
- reached end of file while inside a 'code' block!
- reached end of file while still inside a (nested) comment.
- unexpected end of comment while inside <a href=...> tag
- unexpected end of comment while inside <ul> block
- unexpected html tag <blockquote> found within <h1> context
- unexpected tag </h2> found
- unexpected tag </h3> found
- unsupported xml/html tag <it> found
- unsupported xml/html tag </it> found

* Adjust parameter names in doxygen markup so they match the code

Addresses warnings:

argument '<name>' of command @param is not found in the argument list
of <function>.

* Add missing underscore

* Make the name of macro match the filename

Fixes:

warning: Failed to call `rs302_JeffreysPriorDemo()` to execute the macro.
Add this function or rename the macro. Falling back to `.L`.

* Remove random control character in documentation file

* Remove /** comments */ from md files

* Fix a shadow warning.

Co-authored-by: Stephan Hageboeck <stephan.hageboeck@cern.ch>

Don't rely on the engine to set the current track after popping from
TMCManagerStack but do it implicitly.

Includes like "strlcpy.h" and "snprintf.h" are provided via Rtypes.h,
but really used only in part of the sources. Before removing them
from Rtypes.h (in dev builds) provide them all in required places

In many places incldues are not required for the dictionary generation, 
therefore target_include_directories can be used 

'wmat' values were not updated when the function is called with nlmat<0, as they
should be to mimic the Geant3 behavior.

Some Pythia8 headers expose an unfortunate "using namespace Pythia8".
This triggers:
In file included from /root/ship-log-keep/sw/slc7_x86-64/ROOT/master_FAIRSHIP-1/include/TMCManager.h:26:
/root/ship-log-keep/sw/slc7_x86-64/ROOT/master_FAIRSHIP-1/include/TMCParticleStatus.h:81:7: error: reference to 'Info' is ambiguous
      Info("Print", "Status of track");
      ^
/root/ship-log-keep/sw/BUILD/b61305e07edfb1f9a906335e2093ac409db3c4cc/ROOT/include/TError.h:58:13: note: candidate found by name lookup is 'Info'
extern void Info(const char *location, const char *msgfmt, ...)
            ^
/root/ship-log-keep/sw/slc7_x86-64/pythia/v8230-ship-1/include/Pythia8/Info.h:30:7: note: candidate found by name lookup is 'Pythia8::Info'
class Info {
      ^

By explicitly requesting "::Info" that ambiguity should be resolved.

(cherry picked from commit bba42194)
(got reverted by commit d90fc155)

- Only rely on presence of TMCManager in multi run (PR#6 in vmc-project/vmc)
- Withdraw unwanted TMCVerbose modifications to avoid changes in the tests outputs
- Recover TGeoManager::fIsOutside for transfer tracks (PR#3 in vmc-project/vmc)

Some Pythia8 headers expose an unfortunate "using namespace Pythia8".
This triggers:
In file included from /root/ship-log-keep/sw/slc7_x86-64/ROOT/master_FAIRSHIP-1/include/TMCManager.h:26:
/root/ship-log-keep/sw/slc7_x86-64/ROOT/master_FAIRSHIP-1/include/TMCParticleStatus.h:81:7: error: reference to 'Info' is ambiguous
      Info("Print", "Status of track");
      ^
/root/ship-log-keep/sw/BUILD/b61305e07edfb1f9a906335e2093ac409db3c4cc/ROOT/include/TError.h:58:13: note: candidate found by name lookup is 'Info'
extern void Info(const char *location, const char *msgfmt, ...)
            ^
/root/ship-log-keep/sw/slc7_x86-64/pythia/v8230-ship-1/include/Pythia8/Info.h:30:7: note: candidate found by name lookup is 'Pythia8::Info'
class Info {
      ^

By explicitly requesting "::Info" that ambiguity should be resolved.

Now that ROOT_GENERATE_DICTIONARY() knows how to pick up includes
and compile definitions from the library targets even when added
later with target_link_libraries() and target_include_directories(),
we can remove extra includes added by hand as a workaround before.

This function is needed for newly introduced sensitive detectors framework
to provide a hook for a central call to fill ROOT trees before resetting data
in sensitive detector's end of event.

The index of the geometry state belonging to a track is now reset
properly when the TMCManagerStack is notified on the restored geometry.

this will allow to maintain a standalone version of VMC in parallel, which can be then tagged more frequently according to the needs of the VMC project

Moved README.md added with Multiple Engines development in README.multiple.md and added a new README.md (Md version of the Drupal VMC main page)

Moved TPDGCode.h (used in 'pythia6' and 'pythia8') from 'vmc' to to 'eg'; this makes all other libraries in 'montecarlo' not dependent on 'vmc'

This is an extension allowing the VMC package to run a simulation
with multiple different engines at a time. Tracks can be transferred
among engines during a simulation run based on conditions specified by
the user.

Important notes on the extensions:
  1) This extension preserves backward-compatibility in the sense that
     user code relying on the former version of VMC is still running
     with the extended version. Was tested with GEANT3_VMC@v2-6 and
     GEANT4_VMC@v3-6-p1.
  2) A shared simulation is only possible when TGeo is used for geometry
     construction and navigation.
  3) A TMCManager singleton object is responsible for handling multiple
     engines and can be obtained on request calling
     TVirtualMCApplication::RequestManager() during construction of the
     user application class.
  4) The introduced TMCParticleStatus objects hold additional
     information to keep track of properties when a track is transferred
     between engines.
  5) When a track is interrupted in one engine to be transferred to
     another, the geometry state is cached in the form of a
     TGeoBranchArray object. It will be used to initialize the navigator
     when this track is picked up for further transport in the next
     engine. This is especially useful/required when a track is
     transferred at a volume boundary in order to be picked up in the
     entered volume and not in the one just left. This is a main reason
     why geometry management is forced to be done via TGeo.

A more comprehensive introduction concerning the usage and
implementation in the user code can be found in the
montecarlo/vmc/README.md

Further note:
  This commit also applies the clang format to the modified and new
  files.

A plain include_directories() was meant to be converted
into target_include_directories() in the previous commit,
but the second part was missing.

- this should address the ROOT-9681 JIRA item

Details:
- Added support for user defined sensitive detectors
  o TVirtualMCSensitiveDetector: the interface class for a user sensitive detector
  o New functions in TVirtualMC:
     void SetSensitiveDetector(const TString &volName, TVirtualMCSensitiveDetector *sd);
     TVirtualMCSensitiveDetector *GetSensitiveDetector(const TString &volName) const;
     void SetExclusiveSDScoring(Bool_t exclusiveSDScoring);
  o New function in TVirtualMCApplication:
     void ConstructSensitiveDetectors();
- Added new TVirtualMC::NIELEdep() function
- Removed default implementation for  TVirtualMC::TrackPosition/Momentum with Float_t arguments