Changeset View
Changeset View
Standalone View
Standalone View
modules/ECMGenerateExportHeader.cmake
| Show First 20 Lines • Show All 132 Lines • ▼ Show 20 Line(s) | |||||
| 133 | # | 133 | # | ||
| 134 | # ``<prefix_name><uppercase_base_name>_NO_DEPRECATED_WARNINGS`` | 134 | # ``<prefix_name><uppercase_base_name>_NO_DEPRECATED_WARNINGS`` | ||
| 135 | # flag to define to disable all deprecation warnings, being a shortcut for | 135 | # flag to define to disable all deprecation warnings, being a shortcut for | ||
| 136 | # setting ``<prefix_name><uppercase_base_name>_DEPRECATED_WARNINGS_SINCE`` | 136 | # setting ``<prefix_name><uppercase_base_name>_DEPRECATED_WARNINGS_SINCE`` | ||
| 137 | # to "0". If both are set, this flag overrules. | 137 | # to "0". If both are set, this flag overrules. | ||
| 138 | # | 138 | # | ||
| 139 | # When the ``GROUP_BASE_NAME`` has been used, the same macros but with the | 139 | # When the ``GROUP_BASE_NAME`` has been used, the same macros but with the | ||
| 140 | # given ``<group_base_name>`` prefix are available to define the defaults of | 140 | # given ``<group_base_name>`` prefix are available to define the defaults of | ||
| 141 | # these macros, if not explicitely set. | 141 | # these macros, if not explicitly set. | ||
| 142 | # | 142 | # | ||
| 143 | # Note: The tricks applied here for hiding deprecated API to the compiler | 143 | # Note: The tricks applied here for hiding deprecated API to the compiler | ||
| 144 | # when building against a library do not work for all deprecated API: | 144 | # when building against a library do not work for all deprecated API: | ||
| 145 | # | 145 | # | ||
| 146 | # * virtual methods need to stay visible to the compiler to build proper | 146 | # * virtual methods need to stay visible to the compiler to build proper | ||
| 147 | # virtual method tables for subclasses | 147 | # virtual method tables for subclasses | ||
| 148 | # * enumerators from enums cannot be simply removed, as this changes | 148 | # * enumerators from enums cannot be simply removed, as this changes | ||
| 149 | # auto values of following enumerators, also can poke holes in enumerator | 149 | # auto values of following enumerators, also can poke holes in enumerator | ||
| ▲ Show 20 Lines • Show All 147 Lines • ▼ Show 20 Line(s) | |||||
| 297 | # will be not available to library consumers. The methods will not have been | 297 | # will be not available to library consumers. The methods will not have been | ||
| 298 | # compiled into the library binary, and the declarations will be hidden to the | 298 | # compiled into the library binary, and the declarations will be hidden to the | ||
| 299 | # compiler, ``FOO_DISABLE_DEPRECATED_BEFORE_AND_AT`` also cannot be used to | 299 | # compiler, ``FOO_DISABLE_DEPRECATED_BEFORE_AND_AT`` also cannot be used to | ||
| 300 | # reactivate them. | 300 | # reactivate them. | ||
| 301 | # | 301 | # | ||
| 302 | # When using the ``NO_DEFINITION_EXPORT_TO_BUILD_INTERFACE`` and the project | 302 | # When using the ``NO_DEFINITION_EXPORT_TO_BUILD_INTERFACE`` and the project | ||
| 303 | # for the "Foo" library includes also tests and examples linking against the | 303 | # for the "Foo" library includes also tests and examples linking against the | ||
| 304 | # library and using deprecated API (like tests covering it), one better | 304 | # library and using deprecated API (like tests covering it), one better | ||
| 305 | # explicitely sets ``FOO_DISABLE_DEPRECATED_BEFORE_AND_AT`` for those targets | 305 | # explicitly sets ``FOO_DISABLE_DEPRECATED_BEFORE_AND_AT`` for those targets | ||
| 306 | # to the version before and at which all deprecated API has been excluded from | 306 | # to the version before and at which all deprecated API has been excluded from | ||
| 307 | # the build. | 307 | # the build. | ||
| 308 | # Even more when building against other libraries from the same group "Bar" and | 308 | # Even more when building against other libraries from the same group "Bar" and | ||
| 309 | # disabling some deprecated API of those libraries using the group macro | 309 | # disabling some deprecated API of those libraries using the group macro | ||
| 310 | # ``BAR_DISABLE_DEPRECATED_BEFORE_AND_AT``, which also works as default for | 310 | # ``BAR_DISABLE_DEPRECATED_BEFORE_AND_AT``, which also works as default for | ||
| 311 | # ``FOO_DISABLE_DEPRECATED_BEFORE_AND_AT``. | 311 | # ``FOO_DISABLE_DEPRECATED_BEFORE_AND_AT``. | ||
| 312 | # | 312 | # | ||
| 313 | # To get the hex number style value the helper macro | 313 | # To get the hex number style value the helper macro | ||
| ▲ Show 20 Lines • Show All 445 Lines • Show Last 20 Lines | |||||