Update to clang-format-5 and reformat the codebase 

This is probably irrelevant in praxis, but the unit test of
DirectEnergyConversion fails if we do not do this. There is no
instrument that uses RectangularDetector and DirectEnergyConversion.

re #15289

The converted text is stored in separate .rst files in the docs directory.
Refs #9562

MultiplyRange, MoveInstrumentComponent

re #6485

This reverts commit 21f52c67 and fixes it.

This reverts commit ed408067 and fixes
the system tests until further investigation of the failure (and also
why the unittests passed!).

Replaces copy-and-pasted code.

Signed-off-by: Karl Palmen <karl.palmen@stfc.ac.uk>

A detector retrieved before the Move/Rotate can then see the updated
parameters without retrieval.

Note to testers: Use the ResizeRectangularDetector algorithm to change the X/Y
size of a bank.
Try ray-tracing to it (e.g. peak finding or RayTracerTester).
It should look scaled in the instrument view.

Refs #3984 Took the wiki description from every algorithm's wiki page and placed it in a comment in the CPP file (instead of the header file).

Removed functions findByName and findByID from the MoveInstrumentComponent and RotateInstrumentComponent and replace calls of them by appropriate member functions of instrument. re #3709

Continue obsession with const: ExperimentInfo(MatrixWorkspace)::getInstrument now returns a const instrument. Re #1944.

Eradicate IInstrument. Instrument's the one to talk to now (it was the only descendent class anyway). Re #2041.

Refs #2572: Added an initDocs() for all algorithms that sets the summary string to display in the dialog, as well as the wiki summary for possible later auto-wiki-fication of documentation.

Refs #2572: Ran into issue with un-escaped characters that my compiler did not catch. Commented out all optional messages until I can fix it.

Fix for problems with keeping position and rotations parameters in sync with the ParameterMap's cache when they are set in isolation to the ParameterMap. Now, set can only be called by the ParameterMap and all changes to parameters, whether addition/replacement should use the addV3D, addDouble etc members of the ParameterMap. Re #2276

Rename Framework code directory to just that. Also delete Main and VS & Eclipse project file. Re #1881.

Refs #1884: Merging branch into trunk. Several classes in Geometry were removed in order to simplify parametrized components. ParDetector, ParObjComponent, etc. are now handled in the same class.