Help: State in add_library that INTERFACE libraries have no build targets

1 files changed, 9 insertions, 5 deletions

diff --git a/Help/command/add_library.rst b/Help/command/add_library.rst
index 2615db9..ed8447e 100644
--- a/Help/command/add_library.rst
+++ b/Help/command/add_library.rst
@@ -100,11 +100,12 @@ Interface Libraries
 
   add_library(<name> INTERFACE)
 
-Creates an :ref:`Interface Library <Interface Libraries>`.  An ``INTERFACE``
-library target does not directly create build output, though it may
-have properties set on it and it may be installed, exported and
-imported. Typically the ``INTERFACE_*`` properties are populated on
-the interface target using the commands:
+Creates an :ref:`Interface Library <Interface Libraries>`.
+An ``INTERFACE`` library target does not compile sources and does
+not produce a library artifact on disk.  However, it may have
+properties set on it and it may be installed and exported.
+Typically, ``INTERFACE_*`` properties are populated on an interface
+target using the commands:
 
 * :command:`set_property`,
 * :command:`target_link_libraries(INTERFACE)`,
@@ -117,6 +118,9 @@ the interface target using the commands:
 and then it is used as an argument to :command:`target_link_libraries`
 like any other target.
 
+An interface library has no source files itself and is not included
+as a target in the generated buildsystem.
+
 Imported Libraries
 ^^^^^^^^^^^^^^^^^^