mirror of
https://github.com/Kitware/CMake.git
synced 2026-03-13 12:59:55 -05:00
Modules: Update documentation formatting
This commit is contained in:
Bartosz Kosiorek
@@ -7,7 +7,7 @@ BundleUtilities
|
||||
|
||||
Functions to help assemble a standalone bundle application.
|
||||
|
||||
A collection of CMake utility functions useful for dealing with .app
|
||||
A collection of CMake utility functions useful for dealing with ``.app``
|
||||
bundles on the Mac and bundle-like directories on any OS.
|
||||
|
||||
The following functions are provided by this module:
|
||||
@@ -33,7 +33,7 @@ The following functions are provided by this module:
|
||||
verify_bundle_symlinks
|
||||
|
||||
Requires CMake 2.6 or greater because it uses function, break and
|
||||
PARENT_SCOPE. Also depends on GetPrerequisites.cmake.
|
||||
``PARENT_SCOPE``. Also depends on ``GetPrerequisites.cmake``.
|
||||
|
||||
DO NOT USE THESE FUNCTIONS AT CONFIGURE TIME (from ``CMakeLists.txt``)!
|
||||
Instead, invoke them from an :command:`install(CODE)` or
|
||||
@@ -43,55 +43,57 @@ Instead, invoke them from an :command:`install(CODE)` or
|
||||
|
||||
fixup_bundle(<app> <libs> <dirs>)
|
||||
|
||||
Fix up a bundle in-place and make it standalone, such that it can be
|
||||
Fix up ``<app>`` bundle in-place and make it standalone, such that it can be
|
||||
drag-n-drop copied to another machine and run on that machine as long
|
||||
as all of the system libraries are compatible.
|
||||
|
||||
If you pass plugins to fixup_bundle as the libs parameter, you should
|
||||
install them or copy them into the bundle before calling fixup_bundle.
|
||||
The "libs" parameter is a list of libraries that must be fixed up, but
|
||||
that cannot be determined by otool output analysis. (i.e., plugins)
|
||||
If you pass plugins to ``fixup_bundle`` as the libs parameter, you should
|
||||
install them or copy them into the bundle before calling ``fixup_bundle``.
|
||||
The ``<libs>`` parameter is a list of libraries that must be fixed up, but
|
||||
that cannot be determined by ``otool`` output analysis (i.e. ``plugins``).
|
||||
|
||||
Gather all the keys for all the executables and libraries in a bundle,
|
||||
and then, for each key, copy each prerequisite into the bundle. Then
|
||||
fix each one up according to its own list of prerequisites.
|
||||
|
||||
Then clear all the keys and call verify_app on the final bundle to
|
||||
Then clear all the keys and call ``verify_app`` on the final bundle to
|
||||
ensure that it is truly standalone.
|
||||
|
||||
As an optional parameter (IGNORE_ITEM) a list of file names can be passed,
|
||||
which are then ignored (e.g. IGNORE_ITEM "vcredist_x86.exe;vcredist_x64.exe")
|
||||
As an optional parameter (``IGNORE_ITEM``) a list of file names can be passed,
|
||||
which are then ignored
|
||||
(e.g. ``IGNORE_ITEM "vcredist_x86.exe;vcredist_x64.exe"``).
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
copy_and_fixup_bundle(<src> <dst> <libs> <dirs>)
|
||||
|
||||
Makes a copy of the bundle <src> at location <dst> and then fixes up
|
||||
the new copied bundle in-place at <dst>...
|
||||
Makes a copy of the bundle ``<src>`` at location ``<dst>`` and then fixes up
|
||||
the new copied bundle in-place at ``<dst>``.
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
verify_app(<app>)
|
||||
|
||||
Verifies that an application <app> appears valid based on running
|
||||
analysis tools on it. Calls "message(FATAL_ERROR" if the application
|
||||
Verifies that an application ``<app>`` appears valid based on running
|
||||
analysis tools on it. Calls :command:`message(FATAL_ERROR)` if the application
|
||||
is not verified.
|
||||
|
||||
As an optional parameter (IGNORE_ITEM) a list of file names can be passed,
|
||||
which are then ignored (e.g. IGNORE_ITEM "vcredist_x86.exe;vcredist_x64.exe")
|
||||
As an optional parameter (``IGNORE_ITEM``) a list of file names can be passed,
|
||||
which are then ignored
|
||||
(e.g. ``IGNORE_ITEM "vcredist_x86.exe;vcredist_x64.exe"``)
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
get_bundle_main_executable(<bundle> <result_var>)
|
||||
|
||||
The result will be the full path name of the bundle's main executable
|
||||
file or an "error:" prefixed string if it could not be determined.
|
||||
file or an ``error:`` prefixed string if it could not be determined.
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
get_dotapp_dir(<exe> <dotapp_dir_var>)
|
||||
|
||||
Returns the nearest parent dir whose name ends with ".app" given the
|
||||
Returns the nearest parent dir whose name ends with ``.app`` given the
|
||||
full path to an executable. If there is no such parent dir, then
|
||||
simply return the dir containing the executable.
|
||||
|
||||
@@ -101,26 +103,26 @@ The returned directory may or may not exist.
|
||||
|
||||
get_bundle_and_executable(<app> <bundle_var> <executable_var> <valid_var>)
|
||||
|
||||
Takes either a ".app" directory name or the name of an executable
|
||||
nested inside a ".app" directory and returns the path to the ".app"
|
||||
directory in <bundle_var> and the path to its main executable in
|
||||
<executable_var>
|
||||
Takes either a ``.app`` directory name or the name of an executable
|
||||
nested inside a ``.app`` directory and returns the path to the ``.app``
|
||||
directory in ``<bundle_var>`` and the path to its main executable in
|
||||
``<executable_var>``.
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
get_bundle_all_executables(<bundle> <exes_var>)
|
||||
|
||||
Scans the given bundle recursively for all executable files and
|
||||
accumulates them into a variable.
|
||||
Scans ``<bundle>`` bundle recursively for all ``<exes_var>`` executable
|
||||
files and accumulates them into a variable.
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
get_item_key(<item> <key_var>)
|
||||
|
||||
Given a file (item) name, generate a key that should be unique
|
||||
Given ``<item>`` file name, generate ``<key_var>`` key that should be unique
|
||||
considering the set of libraries that need copying or fixing up to
|
||||
make a bundle standalone. This is essentially the file name including
|
||||
extension with "." replaced by "_"
|
||||
extension with ``.`` replaced by ``_``
|
||||
|
||||
This key is used as a prefix for CMake variables so that we can
|
||||
associate a set of variables with a given item based on its key.
|
||||
@@ -129,10 +131,10 @@ associate a set of variables with a given item based on its key.
|
||||
|
||||
clear_bundle_keys(<keys_var>)
|
||||
|
||||
Loop over the list of keys, clearing all the variables associated with
|
||||
each key. After the loop, clear the list of keys itself.
|
||||
Loop over the ``<keys_var>`` list of keys, clearing all the variables
|
||||
associated with each key. After the loop, clear the list of keys itself.
|
||||
|
||||
Caller of get_bundle_keys should call clear_bundle_keys when done with
|
||||
Caller of ``get_bundle_keys`` should call ``clear_bundle_keys`` when done with
|
||||
list of keys.
|
||||
|
||||
.. code-block:: cmake
|
||||
@@ -140,86 +142,88 @@ list of keys.
|
||||
set_bundle_key_values(<keys_var> <context> <item> <exepath> <dirs>
|
||||
<copyflag> [<rpaths>])
|
||||
|
||||
Add a key to the list (if necessary) for the given item. If added,
|
||||
also set all the variables associated with that key.
|
||||
Add ``<keys_var>`` key to the list (if necessary) for the given item.
|
||||
If added, also set all the variables associated with that key.
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
get_bundle_keys(<app> <libs> <dirs> <keys_var>)
|
||||
|
||||
Loop over all the executable and library files within the bundle (and
|
||||
given as extra <libs>) and accumulate a list of keys representing
|
||||
Loop over all the executable and library files within ``<app>`` bundle (and
|
||||
given as extra ``<libs>``) and accumulate a list of keys representing
|
||||
them. Set values associated with each key such that we can loop over
|
||||
all of them and copy prerequisite libs into the bundle and then do
|
||||
appropriate install_name_tool fixups.
|
||||
appropriate ``install_name_tool`` fixups.
|
||||
|
||||
As an optional parameter (IGNORE_ITEM) a list of file names can be passed,
|
||||
which are then ignored (e.g. IGNORE_ITEM "vcredist_x86.exe;vcredist_x64.exe")
|
||||
As an optional parameter (``IGNORE_ITEM``) a list of file names can be passed,
|
||||
which are then ignored
|
||||
(e.g. ``IGNORE_ITEM "vcredist_x86.exe;vcredist_x64.exe"``)
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
copy_resolved_item_into_bundle(<resolved_item> <resolved_embedded_item>)
|
||||
|
||||
Copy a resolved item into the bundle if necessary. Copy is not
|
||||
necessary if the resolved_item is "the same as" the
|
||||
resolved_embedded_item.
|
||||
Copy a resolved item into the bundle if necessary.
|
||||
Copy is not necessary, if the ``<resolved_item>`` is "the same as" the
|
||||
``<resolved_embedded_item>``.
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
copy_resolved_framework_into_bundle(<resolved_item> <resolved_embedded_item>)
|
||||
|
||||
Copy a resolved framework into the bundle if necessary. Copy is not
|
||||
necessary if the resolved_item is "the same as" the
|
||||
resolved_embedded_item.
|
||||
Copy a resolved framework into the bundle if necessary.
|
||||
Copy is not necessary, if the ``<resolved_item>`` is "the same as" the
|
||||
``<resolved_embedded_item>``.
|
||||
|
||||
By default, BU_COPY_FULL_FRAMEWORK_CONTENTS is not set. If you want
|
||||
By default, ``BU_COPY_FULL_FRAMEWORK_CONTENTS`` is not set. If you want
|
||||
full frameworks embedded in your bundles, set
|
||||
BU_COPY_FULL_FRAMEWORK_CONTENTS to ON before calling fixup_bundle. By
|
||||
default, COPY_RESOLVED_FRAMEWORK_INTO_BUNDLE copies the framework
|
||||
dylib itself plus the framework Resources directory.
|
||||
``BU_COPY_FULL_FRAMEWORK_CONTENTS`` to ``ON`` before calling fixup_bundle. By
|
||||
default, ``COPY_RESOLVED_FRAMEWORK_INTO_BUNDLE`` copies the framework
|
||||
dylib itself plus the framework ``Resources`` directory.
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
fixup_bundle_item(<resolved_embedded_item> <exepath> <dirs>)
|
||||
|
||||
Get the direct/non-system prerequisites of the resolved embedded item.
|
||||
Get the direct/non-system prerequisites of the ``<resolved_embedded_item>``.
|
||||
For each prerequisite, change the way it is referenced to the value of
|
||||
the _EMBEDDED_ITEM keyed variable for that prerequisite. (Most likely
|
||||
changing to an "@executable_path" style reference.)
|
||||
the ``_EMBEDDED_ITEM`` keyed variable for that prerequisite. (Most likely
|
||||
changing to an ``@executable_path`` style reference.)
|
||||
|
||||
This function requires that the resolved_embedded_item be "inside" the
|
||||
bundle already. In other words, if you pass plugins to fixup_bundle
|
||||
This function requires that the ``<resolved_embedded_item>`` be ``inside``
|
||||
the bundle already. In other words, if you pass plugins to ``fixup_bundle``
|
||||
as the libs parameter, you should install them or copy them into the
|
||||
bundle before calling fixup_bundle. The "libs" parameter is a list of
|
||||
bundle before calling ``fixup_bundle``. The ``libs`` parameter is a list of
|
||||
libraries that must be fixed up, but that cannot be determined by
|
||||
otool output analysis. (i.e., plugins)
|
||||
otool output analysis. (i.e., ``plugins``)
|
||||
|
||||
Also, change the id of the item being fixed up to its own
|
||||
_EMBEDDED_ITEM value.
|
||||
``_EMBEDDED_ITEM`` value.
|
||||
|
||||
Accumulate changes in a local variable and make *one* call to
|
||||
install_name_tool at the end of the function with all the changes at
|
||||
``install_name_tool`` at the end of the function with all the changes at
|
||||
once.
|
||||
|
||||
If the BU_CHMOD_BUNDLE_ITEMS variable is set then bundle items will be
|
||||
marked writable before install_name_tool tries to change them.
|
||||
If the ``BU_CHMOD_BUNDLE_ITEMS`` variable is set then bundle items will be
|
||||
marked writable before ``install_name_tool`` tries to change them.
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
verify_bundle_prerequisites(<bundle> <result_var> <info_var>)
|
||||
|
||||
Verifies that the sum of all prerequisites of all files inside the
|
||||
bundle are contained within the bundle or are "system" libraries,
|
||||
bundle are contained within the bundle or are ``system`` libraries,
|
||||
presumed to exist everywhere.
|
||||
|
||||
As an optional parameter (IGNORE_ITEM) a list of file names can be passed,
|
||||
which are then ignored (e.g. IGNORE_ITEM "vcredist_x86.exe;vcredist_x64.exe")
|
||||
As an optional parameter (``IGNORE_ITEM``) a list of file names can be passed,
|
||||
which are then ignored
|
||||
(e.g. ``IGNORE_ITEM "vcredist_x86.exe;vcredist_x64.exe"``)
|
||||
|
||||
.. code-block:: cmake
|
||||
|
||||
verify_bundle_symlinks(<bundle> <result_var> <info_var>)
|
||||
|
||||
Verifies that any symlinks found in the bundle point to other files
|
||||
Verifies that any symlinks found in the ``<bundle>`` bundle point to other files
|
||||
that are already also in the bundle... Anything that points to an
|
||||
external file causes this function to fail the verification.
|
||||
#]=======================================================================]
|
||||
|
||||
@@ -202,23 +202,24 @@ External Project Definition
|
||||
:command:`file(DOWNLOAD)`)
|
||||
|
||||
``NETRC <level>``
|
||||
Specify whether the .netrc file is to be used for operation. If this
|
||||
option is not specified, the value of the ``CMAKE_NETRC`` variable
|
||||
will be used instead (see :command:`file(DOWNLOAD)`)
|
||||
Specify whether the ``.netrc`` file is to be used for operation.
|
||||
If this option is not specified, the value of the ``CMAKE_NETRC``
|
||||
variable will be used instead (see :command:`file(DOWNLOAD)`)
|
||||
Valid levels are:
|
||||
|
||||
``IGNORED``
|
||||
The .netrc file is ignored.
|
||||
The ``.netrc`` file is ignored.
|
||||
This is the default.
|
||||
``OPTIONAL``
|
||||
The .netrc file is optional, and information in the URL is preferred.
|
||||
The file will be scanned to find which ever information is not specified
|
||||
in the URL.
|
||||
The ``.netrc`` file is optional, and information in the URL
|
||||
is preferred. The file will be scanned to find which ever
|
||||
information is not specified in the URL.
|
||||
``REQUIRED``
|
||||
The .netrc file is required, and information in the URL is ignored.
|
||||
The ``.netrc`` file is required, and information in the URL
|
||||
is ignored.
|
||||
|
||||
``NETRC_FILE <file>``
|
||||
Specify an alternative .netrc file to the one in your home directory
|
||||
Specify an alternative ``.netrc`` file to the one in your home directory
|
||||
if the ``NETRC`` level is ``OPTIONAL`` or ``REQUIRED``. If this option
|
||||
is not specified, the value of the ``CMAKE_NETRC_FILE`` variable will
|
||||
be used instead (see :command:`file(DOWNLOAD)`)
|
||||
|
||||
@@ -19,7 +19,7 @@ The module defines the following variables:
|
||||
true if the program was found
|
||||
|
||||
The minimum required version of ``bison`` can be specified using the
|
||||
standard CMake syntax, e.g. ``find_package(BISON 2.1.3)``.
|
||||
standard CMake syntax, e.g. :command:`find_package(BISON 2.1.3)`.
|
||||
|
||||
If ``bison`` is found, the module defines the macro::
|
||||
|
||||
@@ -55,7 +55,7 @@ The options are:
|
||||
The macro defines the following variables:
|
||||
|
||||
``BISON_<Name>_DEFINED``
|
||||
true is the macro ran successfully
|
||||
``True`` is the macro ran successfully
|
||||
|
||||
``BISON_<Name>_INPUT``
|
||||
The input source file, an alias for <YaccInput>
|
||||
|
||||
@@ -5,12 +5,12 @@
|
||||
FindBLAS
|
||||
--------
|
||||
|
||||
Find BLAS library
|
||||
Find Basic Linear Algebra Subprograms (BLAS) library
|
||||
|
||||
This module finds an installed fortran library that implements the
|
||||
This module finds an installed Fortran library that implements the
|
||||
BLAS linear-algebra interface (see http://www.netlib.org/blas/). The
|
||||
list of libraries searched for is taken from the autoconf macro file,
|
||||
acx_blas.m4 (distributed at
|
||||
list of libraries searched for is taken from the ``autoconf`` macro file,
|
||||
``acx_blas.m4`` (distributed at
|
||||
http://ac-archive.sourceforge.net/ac-archive/acx_blas.html).
|
||||
|
||||
Input Variables
|
||||
@@ -52,7 +52,7 @@ The following variables may be set to influence this module's behavior:
|
||||
if ``ON`` tries to find the BLAS95 interfaces
|
||||
|
||||
``BLA_PREFER_PKGCONFIG``
|
||||
if set pkg-config will be used to search for a BLAS library first
|
||||
if set ``pkg-config`` will be used to search for a BLAS library first
|
||||
and if one is found that is preferred
|
||||
|
||||
Result Variables
|
||||
@@ -63,7 +63,7 @@ This module defines the following variables:
|
||||
``BLAS_FOUND``
|
||||
library implementing the BLAS interface is found
|
||||
``BLAS_LINKER_FLAGS``
|
||||
uncached list of required linker flags (excluding -l and -L).
|
||||
uncached list of required linker flags (excluding ``-l`` and ``-L``).
|
||||
``BLAS_LIBRARIES``
|
||||
uncached list of libraries (using full path name) to link against
|
||||
to use BLAS (may be empty if compiler implicitly links BLAS)
|
||||
@@ -75,7 +75,7 @@ This module defines the following variables:
|
||||
|
||||
.. note::
|
||||
|
||||
C or CXX must be enabled to use Intel MKL
|
||||
C or CXX must be enabled to use Intel Math Kernel Library (MKL)
|
||||
|
||||
For example, to use Intel MKL libraries and/or Intel compiler:
|
||||
|
||||
|
||||
@@ -85,33 +85,33 @@ The following :prop_tgt:`IMPORTED` targets are also defined::
|
||||
Boost::dynamic_linking - interface target to enable dynamic linking
|
||||
linking with MSVC (adds BOOST_ALL_DYN_LINK)
|
||||
|
||||
Implicit dependencies such as Boost::filesystem requiring
|
||||
Boost::system will be automatically detected and satisfied, even
|
||||
if system is not specified when using find_package and if
|
||||
Boost::system is not added to target_link_libraries. If using
|
||||
Boost::thread, then Threads::Threads will also be added automatically.
|
||||
Implicit dependencies such as ``Boost::filesystem`` requiring
|
||||
``Boost::system`` will be automatically detected and satisfied, even
|
||||
if system is not specified when using :command:`find_package` and if
|
||||
``Boost::system`` is not added to :command:`target_link_libraries`. If using
|
||||
``Boost::thread``, then ``Threads::Threads`` will also be added automatically.
|
||||
|
||||
It is important to note that the imported targets behave differently
|
||||
than variables created by this module: multiple calls to
|
||||
find_package(Boost) in the same directory or sub-directories with
|
||||
:command:`find_package(Boost)` in the same directory or sub-directories with
|
||||
different options (e.g. static or shared) will not override the
|
||||
values of the targets created by the first call.
|
||||
|
||||
Users may set these hints or results as cache entries. Projects
|
||||
Users may set these hints or results as ``CACHE`` entries. Projects
|
||||
should not read these entries directly but instead use the above
|
||||
result variables. Note that some hint names start in upper-case
|
||||
"BOOST". One may specify these as environment variables if they are
|
||||
not specified as CMake variables or cache entries.
|
||||
|
||||
This module first searches for the Boost header files using the above
|
||||
hint variables (excluding BOOST_LIBRARYDIR) and saves the result in
|
||||
Boost_INCLUDE_DIR. Then it searches for requested component libraries
|
||||
using the above hints (excluding BOOST_INCLUDEDIR and
|
||||
Boost_ADDITIONAL_VERSIONS), "lib" directories near Boost_INCLUDE_DIR,
|
||||
This module first searches for the ``Boost`` header files using the above
|
||||
hint variables (excluding ``BOOST_LIBRARYDIR``) and saves the result in
|
||||
``Boost_INCLUDE_DIR``. Then it searches for requested component libraries
|
||||
using the above hints (excluding ``BOOST_INCLUDEDIR`` and
|
||||
``Boost_ADDITIONAL_VERSIONS``), "lib" directories near ``Boost_INCLUDE_DIR``,
|
||||
and the library name configuration settings below. It saves the
|
||||
library directories in Boost_LIBRARY_DIR_DEBUG and
|
||||
Boost_LIBRARY_DIR_RELEASE and individual library
|
||||
locations in Boost_<C>_LIBRARY_DEBUG and Boost_<C>_LIBRARY_RELEASE.
|
||||
library directories in ``Boost_LIBRARY_DIR_DEBUG`` and
|
||||
``Boost_LIBRARY_DIR_RELEASE`` and individual library
|
||||
locations in ``Boost_<C>_LIBRARY_DEBUG`` and ``Boost_<C>_LIBRARY_RELEASE``.
|
||||
When one changes settings used by previous searches in the same build
|
||||
tree (excluding environment variables) this module discards previous
|
||||
search results affected by the changes and searches again.
|
||||
@@ -179,9 +179,9 @@ Other variables one may set to control this module are::
|
||||
On Visual Studio and Borland compilers Boost headers request automatic
|
||||
linking to corresponding libraries. This requires matching libraries
|
||||
to be linked explicitly or available in the link library search path.
|
||||
In this case setting Boost_USE_STATIC_LIBS to OFF may not achieve
|
||||
In this case setting ``Boost_USE_STATIC_LIBS`` to ``OFF`` may not achieve
|
||||
dynamic linking. Boost automatic linking typically requests static
|
||||
libraries with a few exceptions (such as Boost.Python). Use::
|
||||
libraries with a few exceptions (such as ``Boost.Python``). Use::
|
||||
|
||||
add_definitions(${Boost_LIB_DIAGNOSTIC_DEFINITIONS})
|
||||
|
||||
@@ -230,12 +230,12 @@ Boost CMake
|
||||
If Boost was built using the boost-cmake project it provides a package
|
||||
configuration file for use with find_package's Config mode. This
|
||||
module looks for the package configuration file called
|
||||
BoostConfig.cmake or boost-config.cmake and stores the result in cache
|
||||
entry "Boost_DIR". If found, the package configuration file is loaded
|
||||
``BoostConfig.cmake`` or ``boost-config.cmake`` and stores the result in
|
||||
``CACHE`` entry "Boost_DIR". If found, the package configuration file is loaded
|
||||
and this module returns with no further action. See documentation of
|
||||
the Boost CMake package configuration for details on what it provides.
|
||||
|
||||
Set Boost_NO_BOOST_CMAKE to ON to disable the search for boost-cmake.
|
||||
Set ``Boost_NO_BOOST_CMAKE`` to ``ON``, to disable the search for boost-cmake.
|
||||
#]=======================================================================]
|
||||
|
||||
# Save project's policies
|
||||
|
||||
@@ -7,8 +7,8 @@ FindCups
|
||||
|
||||
Find the CUPS printing system.
|
||||
|
||||
Set CUPS_REQUIRE_IPP_DELETE_ATTRIBUTE to TRUE if you need a version which
|
||||
features this function (i.e. at least 1.1.19)
|
||||
Set ``CUPS_REQUIRE_IPP_DELETE_ATTRIBUTE`` to ``TRUE`` if you need a version which
|
||||
features this function (i.e. at least ``1.1.19``)
|
||||
|
||||
Imported targets
|
||||
^^^^^^^^^^^^^^^^
|
||||
|
||||
@@ -13,7 +13,7 @@ The module defines the following variables:
|
||||
|
||||
::
|
||||
|
||||
FLEX_FOUND - true is flex executable is found
|
||||
FLEX_FOUND - True is flex executable is found
|
||||
FLEX_EXECUTABLE - the path to the flex executable
|
||||
FLEX_VERSION - the version of flex
|
||||
FLEX_LIBRARIES - The flex libraries
|
||||
@@ -35,10 +35,10 @@ If flex is found on the system, the module provides the macro:
|
||||
[DEFINES_FILE <string>]
|
||||
)
|
||||
|
||||
which creates a custom command to generate the <FlexOutput> file from
|
||||
the <FlexInput> file. If COMPILE_FLAGS option is specified, the next
|
||||
which creates a custom command to generate the ``FlexOutput`` file from
|
||||
the ``FlexInput`` file. If ``COMPILE_FLAGS`` option is specified, the next
|
||||
parameter is added to the flex command line. If flex is configured to
|
||||
output a header file, the DEFINES_FILE option may be used to specify its
|
||||
output a header file, the ``DEFINES_FILE`` option may be used to specify its
|
||||
name. Name is an alias used to get details of this custom command.
|
||||
Indeed the macro defines the following variables:
|
||||
|
||||
@@ -61,8 +61,8 @@ defines a macro:
|
||||
ADD_FLEX_BISON_DEPENDENCY(FlexTarget BisonTarget)
|
||||
|
||||
which adds the required dependency between a scanner and a parser
|
||||
where <FlexTarget> and <BisonTarget> are the first parameters of
|
||||
respectively FLEX_TARGET and BISON_TARGET macros.
|
||||
where ``FlexTarget`` and ``BisonTarget`` are the first parameters of
|
||||
respectively ``FLEX_TARGET`` and ``BISON_TARGET`` macros.
|
||||
|
||||
::
|
||||
|
||||
|
||||
@@ -19,11 +19,11 @@ This module finds an installed SWIG. It sets the following variables:
|
||||
|
||||
|
||||
The minimum required version of SWIG can be specified using the
|
||||
standard syntax, e.g. find_package(SWIG 1.1)
|
||||
standard syntax, e.g. :command:`find_package(SWIG 1.1)`
|
||||
|
||||
All information is collected from the SWIG_EXECUTABLE so the version
|
||||
All information is collected from the ``SWIG_EXECUTABLE``, so the version
|
||||
to be found can be changed from the command line by means of setting
|
||||
SWIG_EXECUTABLE
|
||||
``SWIG_EXECUTABLE``
|
||||
#]=======================================================================]
|
||||
|
||||
find_program(SWIG_EXECUTABLE NAMES swig3.0 swig2.0 swig)
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
FindTIFF
|
||||
--------
|
||||
|
||||
Find the TIFF library (libtiff).
|
||||
Find the TIFF library (``libtiff``).
|
||||
|
||||
Imported targets
|
||||
^^^^^^^^^^^^^^^^
|
||||
|
||||
@@ -7,8 +7,9 @@ FindUnixCommands
|
||||
|
||||
Find Unix commands, including the ones from Cygwin
|
||||
|
||||
This module looks for the Unix commands bash, cp, gzip, mv, rm, and tar
|
||||
and stores the result in the variables BASH, CP, GZIP, MV, RM, and TAR.
|
||||
This module looks for the Unix commands ``bash``, ``cp``, ``gzip``,
|
||||
``mv``, ``rm``, and ``tar`` and stores the result in the variables
|
||||
``BASH``, ``CP``, ``GZIP``, ``MV``, ``RM``, and ``TAR``.
|
||||
#]=======================================================================]
|
||||
|
||||
include(${CMAKE_CURRENT_LIST_DIR}/FindCygwin.cmake)
|
||||
|
||||
@@ -7,7 +7,7 @@ GenerateExportHeader
|
||||
|
||||
Function for generation of export macros for libraries
|
||||
|
||||
This module provides the function GENERATE_EXPORT_HEADER().
|
||||
This module provides the function ``GENERATE_EXPORT_HEADER()``.
|
||||
|
||||
The ``GENERATE_EXPORT_HEADER`` function can be used to generate a file
|
||||
suitable for preprocessor inclusion which contains EXPORT macros to be
|
||||
|
||||
@@ -7,8 +7,8 @@ UseQt4
|
||||
|
||||
Use Module for QT4
|
||||
|
||||
Sets up C and C++ to use Qt 4. It is assumed that FindQt.cmake has
|
||||
already been loaded. See FindQt.cmake for information on how to load
|
||||
Sets up C and C++ to use Qt 4. It is assumed that :module:`FindQt` has
|
||||
already been loaded. See :module:`FindQt` for information on how to load
|
||||
Qt 4 into your CMake project.
|
||||
#]=======================================================================]
|
||||
|
||||
@@ -105,4 +105,3 @@ foreach(module QT3SUPPORT QTOPENGL QTASSISTANT QTDESIGNER QTMOTIF QTNSPLUGIN
|
||||
endif ()
|
||||
|
||||
endforeach()
|
||||
|
||||
|
||||
@@ -5,7 +5,7 @@
|
||||
WriteCompilerDetectionHeader
|
||||
----------------------------
|
||||
|
||||
This module provides the function write_compiler_detection_header().
|
||||
This module provides the function ``write_compiler_detection_header()``.
|
||||
|
||||
This function can be used to generate a file suitable for preprocessor
|
||||
inclusion which contains macros to be used in source code::
|
||||
|
||||
Reference in New Issue
Block a user