mirror of
https://github.com/Kitware/CMake.git
synced 2026-05-08 07:10:12 -05:00
Brad King
24 lines
951 B
Plaintext
24 lines
951 B
Plaintext
Handling Archiver Driver Differences
|
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
|
|
.. versionadded:: 4.0
|
|
|
|
To pass options to the archiver tool, each compiler driver has its own syntax.
|
|
The ``ARCHIVER:`` prefix and ``,`` separator can be used to specify, in a portable
|
|
way, options to pass to the archiver tool. ``ARCHIVER:`` is replaced by the
|
|
appropriate driver option and ``,`` by the appropriate driver separator.
|
|
The driver prefix and driver separator are given by the values of the
|
|
:variable:`CMAKE_<LANG>_ARCHIVER_WRAPPER_FLAG` and
|
|
:variable:`CMAKE_<LANG>_ARCHIVER_WRAPPER_FLAG_SEP` variables.
|
|
|
|
The ``ARCHIVER:`` prefix can be specified as part of a ``SHELL:`` prefix
|
|
expression.
|
|
|
|
The ``ARCHIVER:`` prefix supports, as an alternative syntax, specification of
|
|
arguments using the ``SHELL:`` prefix and space as separator.
|
|
|
|
.. note::
|
|
|
|
Specifying the ``SHELL:`` prefix anywhere other than at the beginning of the
|
|
``ARCHIVER:`` prefix is not supported.
|