- comments
- avoid egrep for getting processor count.
- wcleanBuild, wcleanPlatform with shorter form '-curr' instead of '-c'
  to avoid any potential user confusion with '-comp'

- unknown options or missing option values now emit a shorter message
  without the entire usage. This makes it easier to identify the errors
  and is better aligned with the behaviour of GNU system tools.

  ====
     $ simpleFoam -case
     Using: OpenFOAM-plus (see www.OpenFOAM.com)
     Build: plus-01234

     Error: option '-case' requires an argument

     See 'simpleFoam -help' for usage
  ====

- provide for reduced (-help) and full (-help-full) usage information.
  In many cases the reduced usage provided sufficient and easier
  to find the information.

- make -srcDoc an alias for -doc-source

- no warnings about option aliases for future dates.

- POSIX specifies '-c' for counting the number of matching lines,
  so we can just use that instead of 'wc' in wmake

- if called from the top-level project directory ($WM_PROJECT_DIR)
  default to using {applications,src} directories. This avoids
  erroneous linking of etc/codeTemplates and avoids the lengthy
  scanning of the tutorials directory

- also add some comments about the side-effects

A simple 'sleep' is more reliable.

then synchronize the file system to ensure all links are flushed before
compilation starts

Uses the 'wait -n' builtin to avoid the use of non-POSIX 'sleep' commands

The Makefiles are now in the makefiles sub-directory

The "-f | -force" option in wmakeLnInclude is now "-u | -update" for
consistency with the other scripts.

The "Usage" entry in the headers is now consistently formatted in all
scripts.

This reverts commit c5bea524.

This reverts commit 2e1e671d.

- adds more DWIM (do what I mean) intelligence to wmake

ENH: use ~/.OpenFOAM/.wmake instead of ~/.wmakeScheduler for the lock dir

- keeps more of the OpenFOAM bits together

- more consistent script names
- remove '-help' option from internal scripts

- search for 'lnInclude' rather than 'Make' by default
  This gives better general behaviour for rebuilding.

  - send error messages to stderr
  - added -h/-help options where some were missing
  - changed 3-space to 4-space indentation
  - where possible, allow multiple directories from the command-line

  - fixed typo: had skipped '-Make' instead of 'Make' directory

  - remove broken links first
    * helps when file locations have changed

  - filter out trailing 'lnInclude' from the <dir> spec
    * this makes it easier to update existing lnInclude dirs:
         find -name lnInclude -exec wmakeLnInclude -f {} \;

  - reduced output noise when re-creating an identical link