Home Explore Help
Register Sign In
Apq
/
CMake
mirror of https://github.com/Kitware/CMake.git
1
0
Fork 0
Files Issues 0 Wiki
Tree: 0a5a883d53
Branches Tags
CMake
/
Help
/
prop_tgt
/
OPTIMIZE_DEPENDENCIES.rst

OPTIMIZE_DEPENDENCIES.rst 2.2 KB
History Raw

12345678910111213141516171819202122232425262728293031323334353637383940414243 
  1. OPTIMIZE_DEPENDENCIES
    2. 

  2. ---------------------
    3. 

  3. 

  4. .. versionadded:: 3.19
    5. 

  5. 

  6. Activates dependency optimization of static and object libraries.
    7. 

  7. 

  8. When this property is set to true, some dependencies for a static or object
    9. 

  9. library may be removed at generation time if they are not necessary to build
    10. 

  10. the library, since static and object libraries don't actually link against
    11. 

  11. anything.
    12. 

  12. 

  13. If a static or object library has dependency optimization enabled, it first
    14. 

  14. discards all dependencies. Then, it looks through all of the direct and
    15. 

  15. indirect dependencies that it initially had, and adds them back if they meet
    16. 

  16. any of the following criteria:
    17. 

  17. 

  18. * The dependency was added to the library by :command:`add_dependencies`.
    19. 

  19. * The dependency was added to the library through a source file in the library
    20. 

  20.   generated by a custom command that uses the dependency.
    21. 

  21. * The dependency has any ``PRE_BUILD``, ``PRE_LINK``, or ``POST_BUILD`` custom
    22. 

  22.   commands associated with it.
    23. 

  23. * The dependency contains any source files that were generated by a custom
    24. 

  24.   command.
    25. 

  25. * The dependency contains any languages which produce side effects that are
    26. 

  26.   relevant to the library. Currently, all languages except C, C++, Objective-C,
    27. 

  27.   Objective-C++, assembly, and CUDA are assumed to produce side effects.
    28. 

  28.   However, side effects from one language are assumed not to be relevant to
    29. 

  29.   another (for example, a Fortran library is assumed to not have any side
    30. 

  30.   effects that are relevant for a Swift library.)
    31. 

  31. 

  32. As an example, assume you have a static Fortran library which depends on a
    33. 

  33. static C library, which in turn depends on a static Fortran library. The
    34. 

  34. top-level Fortran library has optimization enabled, but the middle C library
    35. 

  35. does not. If you build the top Fortran library, the bottom Fortran library will
    36. 

  36. also build, but not the middle C library, since the C library does not have any
    37. 

  37. side effects that are relevant for the Fortran library. However, if you build
    38. 

  38. the middle C library, the bottom Fortran library will also build, even though
    39. 

  39. it does not have any side effects that are relevant to the C library, since the
    40. 

  40. C library does not have optimization enabled.
    41. 

  41. 

  42. This property is initialized by the value of the
    43. 

  43. :variable:`CMAKE_OPTIMIZE_DEPENDENCIES` variable when the target is created.
    44.