re #27319

Update copyright headers in all files

Squashed commit of the following:

* First version of a script to manage copyright statements

re #23468

* Neatened up script, added comments

re #23488

* move script to tools directory

re #23488

* small script changes and a couple of manual file changes

re #23488

* Minor chnage to whitespace detection in regex

re #23488

* Add an excluded directory

re #23488

* remove a repeasted copyright statement in a file

re #23488

* Don't comsume the comment end if it is on the same line

re #23488

* fix error in new copright parsing

re #23488

* remove double copyrifght entry

re #23488

* Improve handling of old copyrights at the start of comments

re #23488

* remove empty comments re #23488

* exclude gsoapgenerated directories

re #23488

* Sort out greedy line matching re #23488

* improve empty comment removal

re #23488

* improve false positives

re #23488

* impressive speedup by limiting regex matching length

re #23488

* remove evil invisible non ascii character

Also upadte the copyright at the same time

re #23488

* resolve multiple copyrights in a single file

re #23488

* resolve an issue with new statement detection

re #23488

* another unprintable unicode character

re #23488

* pep updates and cmake the new copyright fit clang format

re #23488

* update already done new format headers

re #23488

* wrong type of bracket

re #23488

* Update class_maker and friends

re #23488

* Update all copyright statements

re #23488

* clang format re #23488

* flake8 warnings re #23488

* Flake8 warnings re #23488

* Exclude .cmake.in and rb.in files

re #23488

* replace missing line re #23488

* exclude .py.in files as they are flasely recognized as C++

re #23488

* another setp.py.in re #23488

* another .py.in correction re #23488

* Hopefully the last of the .py.in files re #23488

* resolve utf-8 encoding of python files and changed ABINS checksum

re #23488

* updates to unit tests that reference line numbers

re #23488

* remaining unit test files and other fixes

re #23488

Update to clang-format-5 and reformat the codebase 

Adds a method to get the latest version number to AlgorithmFactory. This
is used by the two script building algorithms to determine if a the
algorithm version needs to be included in the history

Adds a method get a single descriptor in the Algorithm factory, this
avoids us having to get all algorithm descriptors. Each time we want a
descriptor every algorithm object is allocated (900+) then discarded for
each workspace

Re #17600

re #8120

Categories were not being hidden when a parent category was hidden. Now,
categories are hidden whenever either the category itself, or one of its
parents is set as hidden.

Refs #9515

It provides easy access to the highest version of an algorithm
currently registered.
Refs #9521

Refs #9059

There were a couple of rather major bugs which it's a wonder hadn't been found until now.

The first was that decodeName() could go out the range of the string and return garbage if there wasn't a bar cahracter in the supplied string. A check has been added which will throw an exception if one isn't found.

The second was that getCategories() didn't work at all as the loop wasn't executing due to the variable "it_end" used in the condition not being initialised correctly. It's now initialised correctly to categoryMap.end().

Refs #3344

It was previously not updating the version map when the algorithm was
removed and then subscribing the same thing again would throw an error.
Refs #7263