Improve install() documentation of argument ordering
We have numerous reports of problems with argument ordering:
- #6813 (closed)
- #14329 (closed)
- #16361 (closed)
- https://cmake.org/pipermail/cmake/2008-April/021147.html
- https://cmake.org/pipermail/cmake/2009-March/027638.html
- https://cmake.org/pipermail/cmake/2011-May/044329.html
- https://cmake.org/pipermail/cmake/2011-November/047605.html
- https://cmake.org/pipermail/cmake/2013-June/055009.html
- https://cmake.org/pipermail/cmake/2013-October/056190.html
- https://cmake.org/pipermail/cmake/2015-June/060817.html
The behavior is all as designed and documented, but this needs to be called out more clearly in the documentation.