BYPASS_PROVIDER option for find_package() is not documented
The omission was originally raised by @marc.chevrier in !7276 (comment 1204447). The BYPASS_PROVIDER
option is somewhat special. It isn't meant to be used by projects. It only has a very specific use, which is for dependency providers. That is still part of CMake's public API though, so it probably is appropriate to document it. We need to ensure it is very clear that projects must not use this option.
It may also be appropriate to add a check to the find_package()
implementation to halt with an error if it detects the option being used outside of a dependency provider. It may be difficult to make that check rigorous, but we can probably at least start with a simple check for now and tighten it up in subsequent work.