Skip to content

Commit

Permalink
revert GLOBAL targets docs (conan-io#1551)
Browse files Browse the repository at this point in the history
  • Loading branch information
czoido authored Feb 7, 2020
1 parent 297648d commit b2fa5d4
Show file tree
Hide file tree
Showing 3 changed files with 11 additions and 10 deletions.
7 changes: 4 additions & 3 deletions integrations/build_system/cmake/cmake_generator.rst
Original file line number Diff line number Diff line change
Expand Up @@ -57,9 +57,10 @@ For **modern cmake (>=3.1.2)**, you can use the following approach:
add_executable(timer timer.cpp)
target_link_libraries(timer CONAN_PKG::poco)
Using ``TARGETS`` as argument, ``conan_basic_setup()`` will internally call the macro ``conan_define_targets()``
which defines cmake ``INTERFACE IMPORTED GLOBAL`` targets, one per package. These targets, named ``CONAN_PKG::PackageName``
can be used to link against, instead of using global cmake setup.
Using ``TARGETS`` as argument, ``conan_basic_setup()`` will internally call the macro
``conan_define_targets()`` which defines cmake ``INTERFACE IMPORTED`` targets, one per package. These
targets, named ``CONAN_PKG::PackageName`` can be used to link against, instead of using global cmake
setup.

.. seealso::

Expand Down
6 changes: 3 additions & 3 deletions reference/generators/cmake.rst
Original file line number Diff line number Diff line change
Expand Up @@ -167,13 +167,13 @@ Helper to link all libraries to a specified target.

These targets are:

- A ``CONAN_PKG::<PKG-NAME>`` target per package in the dependency graph. This is an ``IMPORTED INTERFACE GLOBAL`` target. ``IMPORTED`` because it is
- A ``CONAN_PKG::<PKG-NAME>`` target per package in the dependency graph. This is an ``IMPORTED INTERFACE`` target. ``IMPORTED`` because it is
external, a pre-compiled library. ``INTERFACE``, because it doesn't necessarily match a library, it could be a header-only library, or the
package could even contain several libraries. It is also ``GLOBAL`` so that ``ALIAS`` of these targets can be defined in the consumer.
package could even contain several libraries. It contains all the properties (include paths, compile flags, etc.) that are defined in the consumer.
It contains all the properties (include paths, compile flags, etc.) that are defined in the
``package_info()`` method of the recipe.

- Inside each package a ``CONAN_LIB::<PKG-NAME>_<LIB-NAME>`` target will be generated for each library. Its type is ``IMPORTED UNKNOWN GLOBAL`` and its
- Inside each package a ``CONAN_LIB::<PKG-NAME>_<LIB-NAME>`` target will be generated for each library. Its type is ``IMPORTED UNKNOWN`` and its
main purpose is to provide a correct link order. Their only properties are the location and the dependencies.

- A ``CONAN_PKG`` depends on every ``CONAN_LIB`` that belongs to it, and to its direct public dependencies (e.g. other ``CONAN_PKG`` targets
Expand Down
8 changes: 4 additions & 4 deletions reference/generators/cmakemulti.rst
Original file line number Diff line number Diff line change
Expand Up @@ -61,10 +61,10 @@ Helper to link all libraries to a specified target.

These targets are:

- A ``CONAN_PKG::<PKG-NAME>`` target per package in the dependency graph. This is an ``IMPORTED INTERFACE GLOBAL`` target. ``IMPORTED``
because it is external, a pre-compiled library. ``INTERFACE``, because it doesn't necessarily match a library, it could be a header-only
library, or the package could even contain several libraries. It is also ``GLOBAL`` so that ``ALIAS`` of these targets can be defined
in the consumer. It contains all the properties (include paths, compile flags, etc.) that are defined in the ``package_info()`` method
- A ``CONAN_PKG::<PKG-NAME>`` target per package in the dependency graph. This is an ``IMPORTED INTERFACE`` target. ``IMPORTED`` because it is
external, external, a pre-compiled library. ``INTERFACE``, because it doesn't necessarily match a library, it could be a header-only library,
or the package could even contain several libraries. It contains all the properties (include paths, compile flags, etc.) that are defined in
the consumer. It contains all the properties (include paths, compile flags, etc.) that are defined in the ``package_info()`` method
of the recipe.

- Inside each package a ``CONAN_LIB::<PKG-NAME>_<LIB-NAME>`` target will be generated for each library. Its type is ``IMPORTED UNKNOWN`` and its
Expand Down

0 comments on commit b2fa5d4

Please sign in to comment.