Sophie

Sophie

distrib > Mageia > 7 > armv7hl > media > core-release > by-pkgid > 737a0d2434bad0661da784e0f3e0ca66 > files > 229

extra-cmake-modules-5.57.0-1.mga7.noarch.rpm


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="X-UA-Compatible" content="IE=Edge" />
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>ecm-find-modules(7) &#8212; Extra CMake Modules 5.57.0 documentation</title>
    <link rel="stylesheet" href="../_static/ecm.css" type="text/css" />
    <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
    
    <script type="text/javascript" id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
    <script type="text/javascript" src="../_static/jquery.js"></script>
    <script type="text/javascript" src="../_static/underscore.js"></script>
    <script type="text/javascript" src="../_static/doctools.js"></script>
    <script type="text/javascript" src="../_static/language_data.js"></script>
    
    <link rel="shortcut icon" href="../_static/kde-favicon.ico"/>
    <link rel="index" title="Index" href="../genindex.html" />
    <link rel="search" title="Search" href="../search.html" />
    <link rel="next" title="FindCanberra" href="../find-module/FindCanberra.html" />
    <link rel="prev" title="ecm-developer(7)" href="ecm-developer.7.html" /> 
  </head><body>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="../genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="../find-module/FindCanberra.html" title="FindCanberra"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="ecm-developer.7.html" title="ecm-developer(7)"
             accesskey="P">previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="../index.html">ECM 5.57 documentation</a> &#187;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <span class="target" id="manual:ecm-find-modules(7)"></span><div class="section" id="ecm-find-modules-7">
<h1><a class="toc-backref" href="#id1">ecm-find-modules(7)</a><a class="headerlink" href="#ecm-find-modules-7" title="Permalink to this headline">¶</a></h1>
<div class="contents topic" id="contents">
<p class="topic-title first">Contents</p>
<ul class="simple">
<li><a class="reference internal" href="#ecm-find-modules-7" id="id1">ecm-find-modules(7)</a><ul>
<li><a class="reference internal" href="#introduction" id="id2">Introduction</a></li>
<li><a class="reference internal" href="#all-find-modules" id="id3">All Find Modules</a></li>
</ul>
</li>
</ul>
</div>
<div class="section" id="introduction">
<h2><a class="toc-backref" href="#id2">Introduction</a><a class="headerlink" href="#introduction" title="Permalink to this headline">¶</a></h2>
<p>Find modules are used by the CMake <code class="docutils literal notranslate"><span class="pre">find_package</span></code> command to search for
packages that do not provide their own CMake package config files. CMake
provides an extensive set of find modules, and Extra CMake Modules (ECM) adds
to that.</p>
<p>To use ECM’s find modules, you need to tell CMake to find the ECM package, and
then add either <code class="docutils literal notranslate"><span class="pre">${ECM_MODULE_PATH}</span></code> or <code class="docutils literal notranslate"><span class="pre">${ECM_FIND_MODULE_DIR}</span></code> to the
<code class="docutils literal notranslate"><span class="pre">CMAKE_MODULE_PATH</span></code> variable:</p>
<div class="highlight-cmake notranslate"><div class="highlight"><pre><span></span><span class="nb">find_package</span><span class="p">(</span><span class="s">ECM</span> <span class="s">REQUIRED</span> <span class="s">NO_MODULE</span><span class="p">)</span>
<span class="nb">set</span><span class="p">(</span><span class="s">CMAKE_MODULE_PATH</span> <span class="o">${</span><span class="nv">ECM_FIND_MODULE_DIR</span><span class="o">}</span><span class="p">)</span>
</pre></div>
</div>
<p>Using <code class="docutils literal notranslate"><span class="pre">${ECM_MODULE_PATH}</span></code> will also make the modules intended for direct use
by CMake scripts available (see <a class="reference internal" href="ecm-modules.7.html#manual:ecm-modules(7)" title="ecm-modules(7)"><code class="xref ecm ecm-manual docutils literal notranslate"><span class="pre">ecm-modules(7)</span></code></a> and
<a class="reference internal" href="ecm-kde-modules.7.html#manual:ecm-kde-modules(7)" title="ecm-kde-modules(7)"><code class="xref ecm ecm-manual docutils literal notranslate"><span class="pre">ecm-kde-modules(7)</span></code></a>).</p>
<p>You can also make local copies of find modules using the
<code class="docutils literal notranslate"><span class="pre">ecm_use_find_modules</span></code> function from <a class="reference internal" href="../module/ECMUseFindModules.html#module:ECMUseFindModules" title="ECMUseFindModules"><code class="xref ecm ecm-module docutils literal notranslate"><span class="pre">ECMUseFindModules</span></code></a>, which is
automatically included when ECM is found:</p>
<div class="highlight-cmake notranslate"><div class="highlight"><pre><span></span><span class="nb">find_package</span><span class="p">(</span><span class="s">ECM</span> <span class="s">REQUIRED</span> <span class="s">NO_MODULE</span><span class="p">)</span>
<span class="nb">ecm_use_find_modules</span><span class="p">(</span>
    <span class="s">DIR</span> <span class="s2">&quot;${CMAKE_BINARY_DIR}/cmake&quot;</span>
    <span class="s">MODULES</span> <span class="s">FindEGL.cmake</span>
<span class="p">)</span>
<span class="nb">set</span><span class="p">(</span><span class="s">CMAKE_MODULE_PATH</span> <span class="s2">&quot;${CMAKE_BINARY_DIR}/cmake&quot;</span><span class="p">)</span>
</pre></div>
</div>
<p>This allows selective use of ECM’s find modules, and the NO_OVERRIDE argument
can be used to ensure that if CMake ships its own version of that find module,
it will be used instead.</p>
</div>
<div class="section" id="all-find-modules">
<h2><a class="toc-backref" href="#id3">All Find Modules</a><a class="headerlink" href="#all-find-modules" title="Permalink to this headline">¶</a></h2>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindCanberra.html">FindCanberra</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindEGL.html">FindEGL</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindFontconfig.html">FindFontconfig</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindGLIB2.html">FindGLIB2</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindGperf.html">FindGperf</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindIcoTool.html">FindIcoTool</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindInotify.html">FindInotify</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindKF5.html">FindKF5</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindLibExiv2.html">FindLibExiv2</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindLibGit2.html">FindLibGit2</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindOpenEXR.html">FindOpenEXR</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindPhoneNumber.html">FindPhoneNumber</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindPng2Ico.html">FindPng2Ico</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindPoppler.html">FindPoppler</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindPulseAudio.html">FindPulseAudio</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindQtWaylandScanner.html">FindQtWaylandScanner</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindSasl2.html">FindSasl2</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindSeccomp.html">FindSeccomp</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindSharedMimeInfo.html">FindSharedMimeInfo</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindUDev.html">FindUDev</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindWayland.html">FindWayland</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindWaylandScanner.html">FindWaylandScanner</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindX11_XCB.html">FindX11_XCB</a></li>
<li class="toctree-l1"><a class="reference internal" href="../find-module/FindXCB.html">FindXCB</a></li>
</ul>
</div>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
  <h3><a href="../index.html">Table of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">ecm-find-modules(7)</a><ul>
<li><a class="reference internal" href="#introduction">Introduction</a></li>
<li><a class="reference internal" href="#all-find-modules">All Find Modules</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="ecm-developer.7.html"
                        title="previous chapter">ecm-developer(7)</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="../find-module/FindCanberra.html"
                        title="next chapter">FindCanberra</a></p>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="../_sources/manual/ecm-find-modules.7.rst.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </div>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <div class="searchformwrapper">
    <form class="search" action="../search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    </div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="../genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="../find-module/FindCanberra.html" title="FindCanberra"
             >next</a> |</li>
        <li class="right" >
          <a href="ecm-developer.7.html" title="ecm-developer(7)"
             >previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="../index.html">ECM 5.57 documentation</a> &#187;</li> 
      </ul>
    </div>
    <div class="footer" role="contentinfo">
        &#169; Copyright KDE Developers.
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.8.4.
    </div>
  </body>
</html>