`cmake --find-package` should mention that it's not well-supported in `cmake --help`
From downstream: https://github.com/RobotLocomotion/drake/issues/13797
Basically, I wasted my time trying to get this to work because I didn't see this documentation: https://cmake.org/cmake/help/latest/manual/cmake.1.html#run-the-find-package-tool
I think it would waste fewer people's time if this were hoisted to the --help
string.
Instead of something like this:
$ cmake --version
cmake version 3.18.0-rc4
$ cmake --help | grep '\--find-package'
--find-package = Run in pkg-config like mode.
It should read like this:
--find-package = (UNSUPPORTED) Run in pkg-config like mode. Please avoid using this.