Sync HIP documentation leftover (#1597)

* Sync HIP documentation leftover

* Update HIP docs environment.yaml and doxyfile

projects/hip/.gitignore

@@ -1,6 +1,8 @@
 .*
 !.gitignore
+!..markdownlint-cli2.yaml
 !.spellcheck.local.yaml
+!.wordlist.txt
 *.o
 *.exe
 *.swp

projects/hip/.readthedocs.yaml

@@ -22,12 +22,3 @@ build:
    apt_packages:
      - "gfortran" # For pre-processing fortran sources
      - "graphviz" # For dot graphs in doxygen
-   jobs:
-     post_checkout:
-       - if [ -d ../clr ]; then rm -rf ../clr; fi
-       - if [ -d ../ROCR-Runtime ]; then rm -rf ../ROCR-Runtime; fi
-       - git clone --depth=1 --single-branch --branch docs/develop https://github.com/ROCm/clr.git ../clr
-       - git clone --depth=1 --single-branch --branch master       https://github.com/ROCm/ROCR-Runtime.git ../ROCR-Runtime
-     post_build:
-       - rm -rf ../clr
-       - rm -rf ../ROCR-Runtime

projects/hip/.wordlist.txt

@@ -1,15 +1,19 @@
 .hip_fatbin
 ALU
 ALUs
+amd
+amdclang
 AmgX
 APU
 APUs
 AQL
 AXPY
 asm
+async
 Asynchronicity
 Asynchrony
 asynchrony
+backproject
 backtrace
 bfloat
 Bitcode
@@ -17,6 +21,7 @@ bitcode
 bitcodes
 blockDim
 blockIdx
+bp
 builtins
 Builtins
 CAS
@@ -32,13 +37,16 @@ cuda
 cuDNN
 cuModule
 dataflow
+DCMAKE
 deallocate
 decompositions
+dedent
 denormal
 Dereferencing
 DFT
 dll
 DirectX
+DOI
 DPP
 dst
 EIGEN
@@ -52,6 +60,9 @@ embeded
 extern
 fatbin
 fatbinary
+FDK
+FeDK
+Feldkamp
 foundationally
 framebuffer
 frontends
@@ -59,6 +70,7 @@ fnuz
 FNUZ
 fp
 gedit
+GiB
 GPGPU
 gridDim
 GROMACS
@@ -82,6 +94,7 @@ IILE
 iGPU
 inlined
 inplace
+interdependencies
 interop
 interoperation
 interoperate
@@ -94,12 +107,15 @@ IPC
 IPs
 isa
 iteratively
+Kress
 Lapack
 latencies
 libc
+libTIFF
 libstdc
 lifecycle
 linearizing
+literalinclude
 LOC
 LUID
 ltrace
@@ -125,11 +141,13 @@ ns
 Nsight
 ocp
 omnitrace
+outDir
 overindex
 overindexing
 oversubscription
 overutilized
 parallelizable
+pftrace
 pipelining
 parallelized
 pixelated
@@ -139,6 +157,7 @@ preconditioners
 predefining
 prefetched
 preprocessor
+proj
 printf
 profilers
 PTX
@@ -149,6 +168,7 @@ quad
 representable
 RMW
 rocgdb
+rocprofv
 rocTX
 roundtrip
 rst
@@ -159,6 +179,8 @@ SAXPY
 scalarizing
 sceneries
 shaders
+ShLo
+Shepp
 SIMT
 sinewave
 sinf
@@ -183,9 +205,11 @@ uncoalesced
 unmap
 unmapped
 unmapping
+unnormalized
 unregister
 upscaled
 variadic
+voxel
 vulkan
 warpSize
 WinGDB

projects/hip/docs/data/tutorial/graph_api/diamond.drawio

@@ -0,0 +1,46 @@
+<mxfile host="Electron" agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/28.1.2 Chrome/138.0.7204.243 Electron/37.4.0 Safari/537.36" version="28.1.2">
+  <diagram name="Page-1" id="HxHaJ6VFq76uSEnsoyY2">
+    <mxGraphModel dx="1042" dy="722" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
+      <root>
+        <mxCell id="0" />
+        <mxCell id="1" parent="0" />
+        <mxCell id="cOoUtWKd1oR_gmB5y_Bd-1" value="&lt;font style=&quot;font-size: 18px;&quot; color=&quot;#ffffff&quot;&gt;&lt;font style=&quot;font-size: 18px;&quot;&gt;A&lt;/font&gt;&lt;br style=&quot;font-size: 18px;&quot;&gt;&lt;/font&gt;" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#c13555;strokeColor=#000000;fontFamily=Segoe UI;fontSize=18;" parent="1" vertex="1">
+          <mxGeometry x="340" y="120" width="120" height="120" as="geometry" />
+        </mxCell>
+        <mxCell id="cOoUtWKd1oR_gmB5y_Bd-2" value="&lt;font style=&quot;font-size: 18px;&quot; color=&quot;#ffffff&quot;&gt;&lt;font style=&quot;font-size: 18px;&quot;&gt;B&lt;/font&gt;&lt;br style=&quot;font-size: 18px;&quot;&gt;&lt;/font&gt;" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#c13555;strokeColor=#000000;fontFamily=Segoe UI;fontSize=18;" parent="1" vertex="1">
+          <mxGeometry x="180" y="320" width="120" height="120" as="geometry" />
+        </mxCell>
+        <mxCell id="cOoUtWKd1oR_gmB5y_Bd-3" value="&lt;font style=&quot;font-size: 18px;&quot; color=&quot;#ffffff&quot;&gt;&lt;font style=&quot;font-size: 18px;&quot;&gt;C&lt;/font&gt;&lt;br style=&quot;font-size: 18px;&quot;&gt;&lt;/font&gt;" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#c13555;strokeColor=#000000;fontFamily=Segoe UI;fontSize=18;" parent="1" vertex="1">
+          <mxGeometry x="500" y="320" width="120" height="120" as="geometry" />
+        </mxCell>
+        <mxCell id="cOoUtWKd1oR_gmB5y_Bd-4" value="&lt;div style=&quot;font-size: 18px;&quot;&gt;&lt;font style=&quot;font-size: 18px;&quot; color=&quot;#ffffff&quot;&gt;&lt;font style=&quot;font-size: 18px;&quot;&gt;D&lt;/font&gt;&lt;/font&gt;&lt;/div&gt;" style="ellipse;whiteSpace=wrap;html=1;aspect=fixed;fillColor=#c13555;strokeColor=#000000;fontFamily=Segoe UI;fontSize=18;" parent="1" vertex="1">
+          <mxGeometry x="340" y="520" width="120" height="120" as="geometry" />
+        </mxCell>
+        <mxCell id="cOoUtWKd1oR_gmB5y_Bd-5" value="" style="endArrow=blockThin;html=1;rounded=0;entryX=0;entryY=0;entryDx=0;entryDy=0;exitX=1;exitY=1;exitDx=0;exitDy=0;strokeWidth=5;endFill=1;fontFamily=Segoe UI;fontSize=18;strokeColor=#000000;" parent="1" source="cOoUtWKd1oR_gmB5y_Bd-1" target="cOoUtWKd1oR_gmB5y_Bd-3" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="490" y="340" as="sourcePoint" />
+            <mxPoint x="560" y="300" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="cOoUtWKd1oR_gmB5y_Bd-6" value="" style="endArrow=blockThin;html=1;rounded=0;entryX=1;entryY=0;entryDx=0;entryDy=0;exitX=0;exitY=1;exitDx=0;exitDy=0;strokeWidth=5;endFill=1;fontFamily=Segoe UI;fontSize=18;strokeColor=#000000;" parent="1" source="cOoUtWKd1oR_gmB5y_Bd-1" target="cOoUtWKd1oR_gmB5y_Bd-2" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="452" y="232" as="sourcePoint" />
+            <mxPoint x="528" y="308" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="cOoUtWKd1oR_gmB5y_Bd-7" value="" style="endArrow=blockThin;html=1;rounded=0;entryX=0;entryY=0;entryDx=0;entryDy=0;exitX=1;exitY=1;exitDx=0;exitDy=0;strokeWidth=5;endFill=1;fontFamily=Segoe UI;fontSize=18;strokeColor=#000000;" parent="1" source="cOoUtWKd1oR_gmB5y_Bd-2" target="cOoUtWKd1oR_gmB5y_Bd-4" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="368" y="272" as="sourcePoint" />
+            <mxPoint x="292" y="348" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="cOoUtWKd1oR_gmB5y_Bd-8" value="" style="endArrow=blockThin;html=1;rounded=0;strokeWidth=5;endFill=1;entryX=1;entryY=0;entryDx=0;entryDy=0;exitX=0;exitY=1;exitDx=0;exitDy=0;fontFamily=Segoe UI;fontSize=18;strokeColor=#000000;" parent="1" source="cOoUtWKd1oR_gmB5y_Bd-3" target="cOoUtWKd1oR_gmB5y_Bd-4" edge="1">
+          <mxGeometry width="50" height="50" relative="1" as="geometry">
+            <mxPoint x="588.5699999999999" y="480" as="sourcePoint" />
+            <mxPoint x="500" y="530" as="targetPoint" />
+          </mxGeometry>
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

projects/hip/docs/doxygen/Doxyfile

@@ -834,7 +834,7 @@ INPUT                  = ../../include/hip \
                          ../../../clr/hipamd/include/hip/amd_detail/amd_hip_gl_interop.h \
                          ../../../clr/hipamd/include/hip/amd_detail/amd_surface_functions.h \
                          ../../../clr/hipamd/include/hip/amd_detail/amd_hip_cooperative_groups.h \
-                         ../../../ROCR-Runtime/src/inc/hsa_ext_amd.h
+                         ../../../rocr-runtime/src/inc/hsa_ext_amd.h
 
 # This tag can be used to specify the character encoding of the source files
 # that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -1230,7 +1230,7 @@ HTML_FOOTER            = ../_doxygen/footer.html
 # obsolete.
 # This tag requires that the tag GENERATE_HTML is set to YES.
 
-HTML_STYLESHEET        = ../_doxygen/stylesheet.css
+HTML_STYLESHEET        = 
 
 # The HTML_EXTRA_STYLESHEET tag can be used to specify additional user-defined
 # cascading style sheets that are included after the standard style sheets

projects/hip/docs/environment.yml

@@ -7,4 +7,4 @@ dependencies:
   - pip
   - doxygen=1.9.8
   - pip:
-    - -r ./sphinx/requirements.txt
+    - -r ./docs/sphinx/requirements.txt