Mark Olesen authored Oct 19, 2017 and Mark OLESEN committed Oct 19, 2017

- better documentation of the file contents.
- quicker to obtain number of blocks without reading an entire file.

- used in various places to test if the input can be parsed as a
  label/scalar, so warnings tend to flood the output.

- be more explicit when encountering range errors

add support for KaHIP decomposition

See merge request OpenFOAM-plus!154

Feature list methods

See merge request OpenFOAM-plus!152

Bugfix multi level decomp

Closes #620 and #619

See merge request OpenFOAM-plus!153

- previously when more than two levels were used.
  Now calculate the required final target domain segment directly.

- refactor some common metis-like elements into the metisLikeDecomp
  abstract class.

- additional convenience constructors

- use FixedList first/last in Pair first/second

- consistent first/second access for line

- consistent versions in headers

- duplicate functionality to the substr() method and more difficult to
  notice when it is being used.

ENH: adjust infoSwitch to report host subscription (related to #531)

See merge request OpenFOAM-plus!150

- remove unused static variable, use updated hashtable methods

- provide shorter versions: pointIndList, pointUIndList, etc.
  and indirect versions of commonly used types:
     labelIndList, scalarIndList, vectorIndList

- consistency with PointHit and PointIndexHit

- this compact form shows the subscription per host in the unsorted
  mpi order

      nProcs : 18
      Hosts  :
      (
          (node1 6)
          (node2 8)
          (node3 4)
      )

  This provides a succinct overview of which hosts have been
  subscribed or oversubscribed.

- The longer list of "slave.pid" ... remains available on the
  InfoSwitch 'writeHosts'

- the -dir option was added in commit c1c6243c to allow quick
  testing of documentation for a set of classes.
  This was largely replicated in commit 843d83117, but accepting
  multiple directories.

  Apply some of the same ideas here and avoid creation of a tmp file.