mirror of
https://github.com/Kitware/CMake.git
synced 2025-10-14 02:08:27 +08:00
1bdb0ee1b8
This deprecates the protobuf_generate_cpp() and protobuf_generate_python() commands because the protobuf_generate() can work for both of these cases and provides more options. Also, upstream Protobuf CMake-based build system has marked these two commands as legacy and requires setting a separate protobuf_MODULE_COMPATIBLE variable to boolean true before calling the find_package(Protobuf). Changes: - Reworded and synced module documentation with other similar find modules. - Imported targets moved to top. - Moved examples to a separate section. - Extended examples with basic usage and some quick hints how to upgrade deprecated commands to protobuf_generate(). - Used lowercase style of commands. - Used "commands" instead of "functions" or "macros". - Documented the DESCRIPTORS argument for protobuf_generate() command and added a note that this option is not available when Protobuf is found in config mode. - Added a note about the Protobuf CMake-based build system and that probuf_generate*() commands might come from the upstream CMake config files. Mentioned also the protobuf_MODULE_COMPATIBLE variable from upstream CMake build system. See #21228. This fixes this issue in favor of #24321 which tracks further progress about Protobuf. - Documented the missing `PROTOBUF_GENERATE_CPP_APPEND_PATH` variable. See #19968. Issue: #24321 Fixes: #21228 Fixes: #19968