This reverts commit 7446cee7.

This reverts commit 3ae1a491.

  - retain failsafe check (constant/blockMeshDict)

previous disabling of the TimeSelection arrays [commit c52b20b1..]
resulted in the mesh caching being disabled :(

Simplified code is enabled/disabled by PV3FOAM_TIMESELECTION define.
Might be removed in the future.

 Added doc/Doxygen/tools/find-debugNames to help but the problem requires
 more attention (Henry/Andy/Mattijs?)
 Caveat:
   - names defined with nested defines will be missed.
   - names defined via typename will be missed.

Cleanup example:

#!/bin/sh
(
cd $WM_PROJECT_DIR
doc/Doxygen/tools/find-debugNames|tee debugs.orig|sed -e 's@ *//.*$@@'>debugs
diff -uw etc/controlDict debugs > debugs.diff
echo "hand-resolve the conflicts - see debugs.diff"
)

 - it also found things like size_t instead of size_type in fileName class

 - allows post-processing functions with an optional dictionary
   (eg, the developer can hard-wire some defaults)

compatibility.

Not by me, Chris/Mattijs?

  - removed legacy foamDiffSourceList, foamPackChanged
  - added foamPackDoxygen for separate distribution of docs
    handles -prefix option
  - misc. cosmetic changes

We can now add the same member function with different lookups
  e.g. 'stl' and 'stlb'

By using leading/trailing underscores around the lookup name,
we get a unique name and avoid possible collision with other classes.

  - match comments to names of scripts
  - remove comments about using C-shell (not true anymore)
  - use 'assert' style syntax in places instead of if/then/fi
  - wcleanMachine supports multiple arguments

  This makes it easier to find the usage on the screen.
  Provide hint about -help if the docs cannot be found.

  renamed genBlockMesh.C -> blockMeshApp.C for the -doc option

  Followed Eugene's suggestions and moved blockMeshDict out of polyMesh/.

  Rationale:
  blockMeshDict is not a polyMesh or part of a polyMesh, thus it doesn't
  really belong in the polyMesh/ dir anyhow. Moving it to constant/ or
  constant/<region>/ improves the overview and eases cleanup of polyMesh/ as
  well. For compatibility, constant/polyMesh/ or constant/<region>/polyMesh/
  will be searched if the new locations fail.

    foamUpdateCaseFileHeader:
      - handle multiple files
      - use fixed version width
      - replace grep/tr/cut -> sed

    foamUpgradeTurbulenceProperties:
      - handle multiple files