Commit a8153181 authored by Brad King's avatar Brad King
Browse files

Help: Organize add_library command documentation

Add a section for each library type signature.  Add a table of contents
at the top for the html builder.
parent d8319f0f
add_library
-----------
.. only:: html
.. contents::
Add a library to the project using the specified source files.
Normal Libraries
^^^^^^^^^^^^^^^^
::
add_library(<name> [STATIC | SHARED | MODULE]
......@@ -44,7 +51,8 @@ the syntax ``$<...>``. See the :manual:`cmake-generator-expressions(7)`
manual for available expressions. See the :manual:`cmake-buildsystem(7)`
manual for more on defining buildsystem properties.
--------------------------------------------------------------------------
Imported Libraries
^^^^^^^^^^^^^^^^^^
::
......@@ -65,7 +73,8 @@ variant :prop_tgt:`IMPORTED_LOCATION_<CONFIG>`) which specifies the
location of the main library file on disk. See documentation of the
``IMPORTED_*`` and ``INTERFACE_*`` properties for more information.
--------------------------------------------------------------------------
Object Libraries
^^^^^^^^^^^^^^^^
::
......@@ -93,7 +102,8 @@ systems may not like targets that have only object files, so consider
adding at least one real source file to any target that references
``$<TARGET_OBJECTS:objlib>``.
--------------------------------------------------------------------------
Alias Libraries
^^^^^^^^^^^^^^^
::
......@@ -111,7 +121,8 @@ operand of :command:`set_property`, :command:`set_target_properties`,
:command:`target_link_libraries` etc. An ``ALIAS`` target may not be
installed or exported.
--------------------------------------------------------------------------
Interface Libraries
^^^^^^^^^^^^^^^^^^^
::
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment