Update RST files scan

Author: luszczewskakasia1

.github/workflows/reusable_checks.yml

@@ -21,14 +21,15 @@ jobs:
     - name: Install dependencies
       run: |
         sudo apt-get update
-        sudo apt-get install -y black cmake clang-format-15 cmake-format libhwloc-dev
+        sudo apt-get install -y black cmake clang-format-15 cmake-format libhwloc-dev doxygen
 
     # Latest distros do not allow global pip installation
     - name: Install Python requirements in venv
       run: |
         python3 -m venv .venv
         . .venv/bin/activate
         echo "$PATH" >> $GITHUB_PATH
+        python3 -m pip install -r third_party/requirements.txt
         python3 -m pip install bandit codespell
 
     - name: Configure CMake
@@ -60,6 +61,12 @@ jobs:
     - name: Run codespell
       run: python3 ./.github/scripts/run-codespell.py
 
+    - name: Check spelling in docs
+      run: |
+        cmake -B build
+        cmake --build build --target docs
+        sphinx-build -b spelling ./build/docs_build/config ./build/docs_build/spelling_log -W
+
     # Run Bandit recursively, but omit _deps directory (with 3rd party code) and python's venv
     - name: Run Bandit
       run: python3 -m bandit -r . -x '/_deps/,/.venv/'

docs/config/Doxyfile

@@ -445,7 +445,7 @@ INLINE_SIMPLE_STRUCTS  = NO
 # types are typedef'ed and only the typedef is referenced, never the tag name.
 # The default value is: NO.
 
-TYPEDEF_HIDES_STRUCT   = NO
+TYPEDEF_HIDES_STRUCT   = YES
 
 # The size of the symbol lookup cache can be set using LOOKUP_CACHE_SIZE. This
 # cache is used to resolve symbols given their name and scope. Since this can be

docs/config/conf.py

@@ -30,7 +30,10 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ["breathe"]
+extensions = ["breathe", "sphinxcontrib.spelling"]
+
+spelling_show_suggestions = True
+spelling_word_list_filename = "spelling_exceptions.txt"
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.

docs/config/exclude_words.txt

@@ -0,0 +1,77 @@
+allocator
+allocators
+Allocators
+oneTBB
+stdout
+pid
+customizable
+deallocations
+malloc
+jemalloc
+Jemalloc
+umfPoolRealloc
+umfPoolCalloc
+umfPoolMallocUsableSize
+daxX
+dev
+Memspace
+memspaces
+Mempolicy
+mempolicies
+Memtarget
+memtargets
+umfOsMemoryProviderParamsDestroy
+CXL
+oneAPI
+mem
+Globals
+umfMemoryProviderGetLastNativeError
+deallocating
+umfPoolDestroy
+umfPool
+umf
+hPool
+ptr
+calloc
+realloc
+hProvider
+umfPoolGetTag
+poolable
+unfreed
+tp
+deallocating
+addr
+ipc
+providerIpcData
+providential
+umfMemoryProviderAlloc
+preallocated
+providerIpcData
+umfMemoryProviderOpenIPCHandle
+lowPtr
+highPtr
+pre
+params
+linux
+nodemask
+Nodemask
+maxnode
+deallocation
+Devdax
+numa
+umfMemspaceUserFilter
+memspace
+hMemtarget
+umfMemspaceMemtargetAdd
+memtarget
+mempolicy
+partList
+umfGetIPCHandle
+interprocess
+Tiering
+tiering
+preallocated
+deallocation
+io
+multithreading
+middleware

docs/config/spelling_exceptions.txt

@@ -0,0 +1,78 @@
+addr
+allocatable
+allocator
+allocators
+calloc
+CXL
+copyable
+customizable
+daxX
+de
+deallocation
+deallocating
+deallocations
+Devdax
+dev
+Globals
+hMemtarget
+hPool
+hProvider
+highPtr
+io
+interprocess
+ipc
+jemalloc
+lowPtr
+malloc
+maxnode
+mem
+mempolicies
+mempolicy
+Mempolicy
+memspace
+Memspace
+memspaces
+Memtarget
+memtarget
+memtargets
+middleware
+multithreading
+Nodemask
+nodemask
+numa
+oneAPI
+oneTBB
+os
+params
+partList
+pid
+poolable
+pre
+preallocated
+preallocated
+providerIpcData
+providerIpcData
+providential
+ptr
+realloc
+Scalable
+scalable
+stdout
+Tiering
+tiering
+topologies
+umf
+umfGetIPCHandle
+umfMemoryProviderAlloc
+umfMemoryProviderGetLastNativeError
+umfMemoryProviderOpenIPCHandle
+umfOsMemoryProviderParamsDestroy
+umfPool
+umfPoolCalloc
+umfPoolDestroy
+umfPoolGetTag
+umfPoolMallocUsableSize
+umfPoolRealloc
+umfMemspaceUserFilter
+umfMemspaceMemtargetAdd
+unfreed

third_party/requirements.txt

@@ -7,11 +7,13 @@ black==24.3.0
 packaging==24.2
 # Generating HTML documentation
 pygments==2.18.0
+pyenchant==3.2.2
 sphinxcontrib_applehelp==2.0.0
 sphinxcontrib_devhelp==2.0.0
 sphinxcontrib_htmlhelp==2.1.0
 sphinxcontrib_serializinghtml==2.0.0
 sphinxcontrib_qthelp==2.0.0
 breathe==4.35.0
+sphinxcontrib-spelling==8.0.0
 sphinx==8.1.3
 sphinx_book_theme==1.1.3