GitLab

ref. issue 19858

Fixes: #19276

Adding some basic docs to indicate how to build ParaView from the
current source checkout using spack.

When building ParaView binaries on system with Fortran compiler present
and ADIOS enabled, ParaView failed to find ADIOS correctly. The issue
was that though superbuild had disabled Fortran (hence MPI was built
without Fortran) ADIOS tried to find MPI's Fortran components and hence
failed.

In general, since we have an option in superbuild to enable/disable
fortran support, it seems reasonable to have the option affect how
ParaView enables/disables its Fortran components.

We now have 5 editions: CORE, RENDERING, CATALYST, CATALYST_RENDERING,
and CANONICAL.

To support this we have reworked module groups and conditions. We now
have only two groups PARAVIEW_CORE and PARAVIEW_CANONICAL. Two flags:
PARAVIEW_ENABLE_RENDERING and PARAVIEW_ENABLE_NONESSENTIAL can be used
by modules to exclude themselves from these groups by default. Now we
can support the 5 editions as follows:

CORE:
   enable PARAVIEW_CORE group

RENDERING:
   enable PARAVIEW_CORE group
   PARAVIEW_ENABLE_RENDERING=ON

CATALYST:
   enable PARAVIEW_CANONICAL group

CATALYST_RENDERING
   enable PARAVIEW_CANONICAL group
   PARAVIEW_ENABLE_RENDERING=ON

CANONICAL:
   enable PARAVIEW_CANONICAL group
   PARAVIEW_ENABLE_RENDERING=ON
   PARAVIEW_ENABLE_NONESSENTIAL=ON

When PARAVIEW_ENABLE_NONESSENTIAL is FALSE, we ensure that hdf5, netcdf,
cgns modules are rejected thus ensuring we don't build these painful
dependencies for Catalyst editions.

Catalyst is now always enabled.

This avoids having to rebuild ParaView to use ssend which is primarily
for debugging purposes anyways.

Fixes: #18992

See build documentation for details.

Fixes: #18955

Moves commented bits around so they don't cause weird gaps in the
rendering.

Now covers the new module system and more extensively documents the
available CMake options.

Remove item about developers reporting problems on mac and linux.

Add note on not being ready for Qt 5.10.

Some are user-facing and some aren't user-facing. Found via `codespell -q 3 -D ~/Documents/diff-experiment/dictionary.txt --skip="./ThirdParty,./Qt" -I ../paraview-whitelist.txt`
whitelist contents were
```
ans
behaviour
cas
dum
initialise
initialisation
lod
nd
ot
pres
wont
```