Update documentation

_sources/building_the_project_with_dpcpp.rst

@@ -457,11 +457,14 @@ Build FAQ
 
 clangrt builtins lib not found
  Encountered when trying to build oneMKL with some ROCm libraries. There are
- several possible solutions: * If building Open DPC++ from source, add
- ``compiler-rt`` to the external projects compile option:
- ``--llvm-external-projects compiler-rt``. * The *clangrt* from ROCm can be
- used, depending on ROCm version: ``export
- LIBRARY_PATH=/path/to/rocm-$rocm-version$/llvm/lib/clang/$clang-version$/lib/linux/:$LIBRARY_PATH``
+ several possible solutions:
+
+ * If building Open DPC++ from source, add ``compiler-rt`` to the external
+ projects compile option: ``--llvm-external-projects compiler-rt``.
+ * Manually set the variable ``HIP_CXX_COMPILER`` to HIP's toolkit ``clang++``
+ path, for instance ``-DHIP_CXX_COMPILER=/opt/rocm/6.1.0/llvm/bin/clang++``.
+ oneMKL may fail to link if the clang versions of ``icpx`` and ``rocm`` are
+ not compatible.
 
 Could NOT find CBLAS (missing: CBLAS file)
  Encountered when tests are enabled along with the BLAS domain. The tests

building_the_project_with_dpcpp.html

@@ -963,11 +963,15 @@ <h2>Backends<a class="headerlink" href="#backends" title="Link to this heading">
 <span id="build-common-problems-dpcpp"></span><h2>Build FAQ<a class="headerlink" href="#build-faq" title="Link to this heading">#</a></h2>
 <dl class="simple">
 <dt>clangrt builtins lib not found</dt><dd><p>Encountered when trying to build oneMKL with some ROCm libraries. There are
-several possible solutions: * If building Open DPC++ from source, add
-<code class="docutils literal notranslate"><span class="pre">compiler-rt</span></code> to the external projects compile option:
-<code class="docutils literal notranslate"><span class="pre">--llvm-external-projects</span> <span class="pre">compiler-rt</span></code>. * The <em>clangrt</em> from ROCm can be
-used, depending on ROCm version: <code class="docutils literal notranslate"><span class="pre">export</span>
-<span class="pre">LIBRARY_PATH=/path/to/rocm-$rocm-version$/llvm/lib/clang/$clang-version$/lib/linux/:$LIBRARY_PATH</span></code></p>
+several possible solutions:</p>
+<ul class="simple">
+<li><p>If building Open DPC++ from source, add <code class="docutils literal notranslate"><span class="pre">compiler-rt</span></code> to the external
+projects compile option: <code class="docutils literal notranslate"><span class="pre">--llvm-external-projects</span> <span class="pre">compiler-rt</span></code>.</p></li>
+<li><p>Manually set the variable <code class="docutils literal notranslate"><span class="pre">HIP_CXX_COMPILER</span></code> to HIP’s toolkit <code class="docutils literal notranslate"><span class="pre">clang++</span></code>
+path, for instance <code class="docutils literal notranslate"><span class="pre">-DHIP_CXX_COMPILER=/opt/rocm/6.1.0/llvm/bin/clang++</span></code>.
+oneMKL may fail to link if the clang versions of <code class="docutils literal notranslate"><span class="pre">icpx</span></code> and <code class="docutils literal notranslate"><span class="pre">rocm</span></code> are
+not compatible.</p></li>
+</ul>
 </dd>
 <dt>Could NOT find CBLAS (missing: CBLAS file)</dt><dd><p>Encountered when tests are enabled along with the BLAS domain. The tests
 require a reference BLAS implementation, but cannot find one. Either install