- handling of dead links (find -L -delete unsupported)

- remove ignore case flag on 's/../../i' used in have_scotch script.
  It is unneeded and not tolerated by Darwin's sed.

- avoid embedded comments in EXE_INC (Make/options files), which do
  not work well with the OSX LLVM cpp.
  It strips out the comments but also removes the continuation char.

STYLE: adjust notes about paraview library locations

- 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.

- use -name test before -type test to avoid calling stat(2) on every file.
- use -delete instead of -exec rm to avoid forking

- also add some comments about the side-effects

Based on patch contributed by Alexey Matveichev
Resolves feature request http://bugs.openfoam.org/view.php?id=2328

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.

- reduces verbosity for dynamicCode

- non-silent wmakeLnInclude output to stderr to avoid polluting logs

This reverts commit c5bea524.

This reverts commit 2e1e671d.

- not required since the addition of the '-f' option

- this seems to be the most sensible solution.
  The changed time stamps on the links doesn't seem to bother make at all.

 - useful for avoiding links on older versions, or for 'hiding' contents

  - 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

specifically on the request of the user by running 'wmake all' or 'Allwmake'
in the directory as appropriate.