GENERATED.rst 1.2 KB

1234567891011121314151617181920212223
  1. GENERATED
  2. ---------
  3. Is this source file generated as part of the build or CMake process.
  4. Tells the internal CMake engine that a source file is generated by an outside
  5. process such as another build step, or the execution of CMake itself. This
  6. information is then used to exempt the file from any existence or validity
  7. checks. Generated files are created by the execution of commands such as
  8. :command:`add_custom_command` and :command:`file(GENERATE)`.
  9. When a generated file created by an :command:`add_custom_command` command
  10. is explicitly listed as a source file for any target in the same
  11. directory scope (which usually means the same ``CMakeLists.txt`` file),
  12. CMake will automatically create a dependency to make sure the file is
  13. generated before building that target.
  14. Generated sources may be hidden in some IDE tools, while in others they might
  15. be shown. For the special case of sources generated by CMake's :prop_tgt:`AUTOMOC`
  16. or :prop_tgt:`AUTORCC` functionality, the :prop_gbl:`AUTOGEN_SOURCE_GROUP`,
  17. :prop_gbl:`AUTOMOC_SOURCE_GROUP` and :prop_gbl:`AUTORCC_SOURCE_GROUP` target
  18. properties may influence where the generated sources are grouped in the project's
  19. file lists.