Test

.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,12 @@
+.hip_fatbin
 ALU
 ALUs
 AmgX
 APU
+APUs
 AQL
+AXPY
+asm
 Asynchrony
 backtrace
 Bitcode
@@ -12,41 +16,74 @@ builtins
 Builtins
 CAS
 clr
+compilable
+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
+framebuffer
 frontends
+fnuz
+FNUZ
+fp
 gedit
 GPGPU
+GROMACS
+GWS
 hardcoded
 HC
+hcBLAS
+HIP-Clang
 HIP's
 hipcc
+hipCtx
 hipexamine
 hipified
+HIPify
+hipModule
+hipModuleLaunchKernel
 hipother
 HIPRTC
-hcBLAS
 icc
+IILE
+iGPU
+inlined
 inplace
-Interoperation
+interop
+interoperation
 interoperate
+interoperation
+Interprocess
+interprocess
 Intrinsics
 intrinsics
 IPC
+IPs
 isa
+iteratively
 Lapack
 latencies
 libc
@@ -59,34 +96,76 @@ ltrace
 makefile
 Malloc
 malloc
+MALU
+MiB
+memset
 multicore
 multigrid
 multithreading
+multitenant
+MALU
+NaN
 NCCL
 NDRange
 nonnegative
+NOP
 Numa
 Nsight
+ocp
+omnitrace
+overindex
+overindexing
 oversubscription
+overutilized
+parallelizable
+pixelated
+pragmas
+preallocated
 preconditioners
+predefining
 prefetched
 preprocessor
+profilers
 PTX
 PyHIP
 queryable
+prefetching
+quad
 representable
 RMW
+rocgdb
 ROCm's
 rocTX
+roundtrip
 RTC
 RTTI
+rvalue
+SAXPY
 scalarizing
 sceneries
+shaders
 SIMT
+sinewave
+SOMA
 SPMV
 structs
 SYCL
 syntaxes
+texel
+texels
+tradeoffs
+templated
+toolkits
+transfering
 typedefs
+unintuitive
+UMM
+unmap
+unmapped
+unmapping
+unregister
+upscaled
+variadic
+vulkan
 WinGDB
-zzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzzz
+zc

README.md

@@ -36,8 +36,8 @@ HIP releases are typically naming convention for each ROCM release to help diffe
 ## More Info
 
 * [Installation](docs/install/install.rst)
-* [HIP FAQ](docs/how-to/faq.md)
-* [HIP Kernel Language](docs/reference/kernel_language.rst)
+* [HIP FAQ](docs/faq.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
@@ -115,7 +115,7 @@ HIP C++ code can be compiled with either,
   functions and thus has very low overhead - developers coding in HIP should expect the same performance as coding in native CUDA.  The code is then
   compiled with nvcc, the standard C++ compiler provided with the CUDA SDK.  Developers can use any tools supported by the CUDA SDK including the CUDA
   profiler and debugger.
-* On the AMD ROCm platform, HIP provides a header and runtime library built on top of HIP-Clang compiler in the repository [Common Language Runtime (CLR)](https://github.com/ROCm/clr).  The HIP runtime implements HIP streams, events, and memory APIs,
+* On the AMD ROCm platform, HIP provides a header and runtime library built on top of HIP-Clang compiler in the repository [Compute Language Runtime (CLR)](https://github.com/ROCm/clr).  The HIP runtime implements HIP streams, events, and memory APIs,
   and is a object library that is linked with the application.  The source code for all headers and the library implementation is available on GitHub.
   HIP developers on ROCm can use AMD's [ROCgdb](https://github.com/ROCm/ROCgdb) for debugging and profiling.
 

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",
+    'how-to/debugging_env.rst'
+]