SWDEV-490062 - Update documentation

Change-Id: Ib5297fdda2e05795b3b20436cc1de962e310b08b

Author: neon60

.github/dependabot.yml

@@ -14,5 +14,6 @@ updates:
       - "documentation"
       - "dependencies"
       - "ci:docs-only"
+    target-branch: "docs/develop"
     reviewers:
       - "samjwu"

.readthedocs.yaml

@@ -6,28 +6,28 @@ version: 2
 sphinx:
    configuration: docs/conf.py
 
-formats: [htmlzip, pdf, epub]
+formats: []
 
 python:
    install:
    - requirements: docs/sphinx/requirements.txt
 
+conda:
+   environment: docs/environment.yml # needed until ubuntu ships doxygen >= 1.9.8
+
 build:
    os: ubuntu-22.04
    tools:
-      python: "3.10"
+      python: "mambaforge-22.9" # needed until ubuntu ships doxygen >= 1.9.8
    apt_packages:
-     - "doxygen"
+     - "gfortran" # For pre-processing fortran sources
      - "graphviz" # For dot graphs in doxygen
    jobs:
      post_checkout:
-       - if [ -d ../llvm-project ]; then rmdir ../llvm-project; fi
-       - if [ -d ../clr ]; then rmdir ../clr; fi
-       - if [ -d ../ROCR-Runtime ]; then rmdir ../ROCR-Runtime; fi
-       - git clone --depth=1 --single-branch --branch rocdoc-195 https://github.com/StreamHPC/llvm-project.git ../llvm-project
-       - git clone --depth=1 --single-branch --branch 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
+       - 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 ../llvm-project
        - rm -rf ../ROCR-Runtime

.wordlist.txt

@@ -1,8 +1,11 @@
+.hip_fatbin
 ALU
 ALUs
 AmgX
 APU
+APUs
 AQL
+AXPY
 Asynchrony
 backtrace
 Bitcode
@@ -12,40 +15,65 @@ builtins
 Builtins
 CAS
 clr
+coroutines
+Ctx
 cuBLASLt
 cuCtx
+CUDA's
 cuDNN
+cuModule
+dataflow
 deallocate
+decompositions
 denormal
+Dereferencing
 dll
 DirectX
 EIGEN
 EIGEN's
 enqueue
 enqueues
+entrypoint
+entrypoints
 enum
+enums
 embeded
 extern
+fatbin
 fatbinary
+foundationally
 frontends
+fnuz
+FNUZ
+fp
 gedit
 GPGPU
+GWS
 hardcoded
 HC
+hcBLAS
+HIP-Clang
 HIP's
 hipcc
+hipCtx
 hipexamine
 hipified
+hipModule
+hipModuleLaunchKernel
 hipother
 HIPRTC
-hcBLAS
 icc
+IILE
+iGPU
 inplace
 Interoperation
 interoperate
+Interprocess
+interprocess
 Intrinsics
 intrinsics
 IPC
+IPs
 isa
 Lapack
 latencies
@@ -59,34 +87,63 @@ ltrace
 makefile
 Malloc
 malloc
+memset
 multicore
 multigrid
 multithreading
+multitenant
+MALU
+NaN
 NCCL
 NDRange
 nonnegative
+NOP
 Numa
 Nsight
+ocp
+overindex
+overindexing
 oversubscription
+pixelated
+pragmas
+preallocated
 preconditioners
+predefining
 prefetched
 preprocessor
 PTX
 PyHIP
 queryable
+prefetching
+quad
 representable
 RMW
 ROCm's
 rocTX
+roundtrip
 RTC
 RTTI
+rvalue
+SAXPY
 scalarizing
 sceneries
+shaders
 SIMT
+SOMA
 SPMV
 structs
 SYCL
 syntaxes
+texel
+texels
+tradeoffs
+templated
+toolkits
 typedefs
+unintuitive
+UMM
+unmap
+upscaled
+variadic
 WinGDB
-zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz
+zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz

README.md

@@ -37,7 +37,7 @@ HIP releases are typically naming convention for each ROCM release to help diffe
 
 * [Installation](docs/install/install.rst)
 * [HIP FAQ](docs/how-to/faq.md)
-* [HIP Kernel Language](docs/reference/kernel_language.rst)
+* [HIP C++ Language Extensions](docs/reference/cpp_language_extensions.rst)
 * [HIP Porting Guide](docs/how-to/hip_porting_guide.md)
 * [HIP Porting Driver Guide](docs/how-to/hip_porting_driver_api.md)
 * [HIP Programming Guide](docs/how-to/programming_manual.md)
@@ -88,7 +88,7 @@ hipMemcpy(C_h, C_d, Nbytes, hipMemcpyDeviceToHost);
 
 The HIP kernel language defines builtins for determining grid and block coordinates, math functions, short vectors,
 atomics, and timer functions.
-It also specifies additional defines and keywords for function types, address spaces, and optimization controls (See the [HIP Kernel Language](docs/reference/kernel_language.rst) for a full description).
+It also specifies additional defines and keywords for function types, address spaces, and optimization controls (See the [HIP C++ Language Extensions](docs/reference/cpp_language_extensions.rst) for a full description).
 Here's an example of defining a simple 'vector_square' kernel.
 
 ```cpp

docs/conf.py

@@ -43,4 +43,12 @@
 cpp_id_attributes = ["__global__", "__device__", "__host__", "__forceinline__", "static"]
 cpp_paren_attributes = ["__declspec"]
 
-suppress_warnings = ["etoc.toctree"]
+suppress_warnings = ["etoc.toctree"]
+
+numfig = False
+
+
+exclude_patterns = [
+    "doxygen/mainpage.md",
+    "understand/glossary.md"
+]