summaryrefslogtreecommitdiffstats
path: root/Help/command
diff options
context:
space:
mode:
authorBrad King <brad.king@kitware.com>2018-03-01 12:54:09 (GMT)
committerKitware Robot <kwrobot@kitware.com>2018-03-01 12:54:20 (GMT)
commit61f92e69c013e55fcf031eab26f930341c41d97f (patch)
treee5083e7845c2c01ae09a67a5d8e72de0adcd394f /Help/command
parente02f4f066011d5b5c493e99f5e21ea0d64cf9aa2 (diff)
parentea0ce73a195e1cc0f672f1e7519c42a240592f15 (diff)
downloadCMake-61f92e69c013e55fcf031eab26f930341c41d97f.zip
CMake-61f92e69c013e55fcf031eab26f930341c41d97f.tar.gz
CMake-61f92e69c013e55fcf031eab26f930341c41d97f.tar.bz2
Merge topic 'object-library-export-as-interface'
ea0ce73a19 install,export: Maybe transform OBJECT libraries to INTERFACE libraries Acked-by: Kitware Robot <kwrobot@kitware.com> Merge-request: !1811
Diffstat (limited to 'Help/command')
-rw-r--r--Help/command/export.rst7
-rw-r--r--Help/command/install.rst5
2 files changed, 12 insertions, 0 deletions
diff --git a/Help/command/export.rst b/Help/command/export.rst
index 53675a7..17fcecb 100644
--- a/Help/command/export.rst
+++ b/Help/command/export.rst
@@ -40,6 +40,13 @@ policy CMP0022 is NEW. If a library target is included in the export
but a target to which it links is not included the behavior is
unspecified.
+.. note::
+
+ :ref:`Object Libraries` under :generator:`Xcode` have special handling if
+ multiple architectures are listed in :variable:`CMAKE_OSX_ARCHITECTURES`.
+ In this case they will be exported as :ref:`Interface Libraries` with
+ no object files available to clients.
+
::
export(PACKAGE <name>)
diff --git a/Help/command/install.rst b/Help/command/install.rst
index 2506f98..1cedc35 100644
--- a/Help/command/install.rst
+++ b/Help/command/install.rst
@@ -183,6 +183,11 @@ export called ``<export-name>``. It must appear before any ``RUNTIME``,
``LIBRARY``, ``ARCHIVE``, or ``OBJECTS`` options. To actually install the
export file itself, call ``install(EXPORT)``, documented below.
+:ref:`Interface Libraries` may be listed among the targets to install.
+They install no artifacts but will be included in an associated ``EXPORT``.
+If :ref:`Object Libraries` are listed but given no destination for their
+object files, they will be exported as :ref:`Interface Libraries`.
+
Installing a target with the :prop_tgt:`EXCLUDE_FROM_ALL` target property
set to ``TRUE`` has undefined behavior.