mirror of
https://github.com/Kitware/CMake.git
synced 2026-01-06 13:51:33 -06: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
10 lines
445 B
ReStructuredText
10 lines
445 B
ReStructuredText
FindProtobuf
|
|
------------
|
|
|
|
* The :module:`FindProtobuf` module's :command:`protobuf_generate(DEPENDENCIES)`
|
|
command argument now accepts multiple values.
|
|
* The :module:`FindProtobuf` module's commands :command:`protobuf_generate_cpp`
|
|
and :command:`protobuf_generate_python` together with their hint variables
|
|
``Protobuf_IMPORT_DIRS`` and ``PROTOBUF_GENERATE_CPP_APPEND_PATH`` are now
|
|
deprecated in favor of :command:`protobuf_generate`.
|