Merge branch 'develop' into 'mrdocs-warn-errors'

# Conflicts:
#   .gitlab-ci-correaa.yml

Author: correaa

.clang-tidy

@@ -18,6 +18,7 @@ Checks: >
   -fuchsia-*,
   -hicpp-no-array-decay,
   -llvm-prefer-static-over-anonymous-namespace,
+  -llvm-use-ranges,
   -llvmlibc-*,
   -modernize-use-nodiscard,
   -readability-magic-numbers,
@@ -59,6 +60,7 @@ CheckOptions:
 #  -fuchsia-overloaded-operator: This library deliberately overloads math/comparison operators (==, <, +, &).
 #  -hicpp-no-array-decay: Required compatibility for Boost Lightweight Test framework.
 #  -llvm-prefer-static-over-anonymous-namespace: Contradicts alternative internal namespace layout rules.
+#  -llvm-use-ranges: Asks to use things like llvm::filld1D
 #  -llvmlibc-*: Suppresses noise; target rules are strictly for internal LLVM implementation developers.
 #  -modernize-use-nodiscard: Avoids flooding the API surface with noisy [[nodiscard]] attributes everywhere.
 #  -readability-magic-numbers: Suppressed because test suites heavily utilize magic numbers.

.github/workflows/pages.yml

@@ -34,8 +34,11 @@ jobs:
 
       - name: Install MrDocs
         run: |
-          wget --no-verbose https://github.com/cppalliance/mrdocs/releases/download/v0.8.0/MrDocs-0.8.0-Linux.tar.gz
-          tar xzf MrDocs-0.8.0-Linux.tar.gz
+          wget --no-verbose https://github.com/cppalliance/mrdocs/releases/download/develop-release/MrDocs-develop-Linux.tar.gz  # https://github.com/cppalliance/mrdocs/releases/download/v0.8.0/MrDocs-0.8.0-Linux.tar.gz
+          tar zxf MrDocs-develop-Linux.tar.gz
+          # wget --no-verbose https://github.com/cppalliance/mrdocs/releases/download/v0.8.0/MrDocs-0.8.0-Linux.tar.gz
+          # tar xzf MrDocs-0.8.0-Linux.tar.gz
+          ls -all
           echo "$PWD/MrDocs-0.8.0-Linux/bin" >> $GITHUB_PATH
 
       - name: Generate compile_commands.json for MrDocs

.gitignore

@@ -42,3 +42,6 @@ cmake-build-debug
 
 # Clion
 .idea
+
+multi-documentation.pdf
+multi-documentation.html

.gitlab-ci-correaa.yml

@@ -16,52 +16,38 @@ variables:
   GIT_DEPTH: "0"  # Tells git to fetch all the branches of the project, required by the analysis task
   CMAKE_GENERATOR: "Unix Makefiles"
 
-g++:  # debian-stable: default is gcc 14.2.0 as of Dec 2025
+g++:  # debian-stable: gcc 14.2.0 as of Jun 2026
   stage: build
   interruptible: false
-  # tags:
-  #   - non-shared
-  #   - docker
   script:
     - apt-get -qq update
-    - apt-get -qq install --no-install-recommends -y --quiet ca-certificates python3 ninja-build cmake gcc g++ git make libboost-timer-dev libboost-serialization-dev libblas-dev liblapack-dev libfftw3-dev pkg-config
-    - g++ --version
-    - mkdir build && cd build
-    - cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_COMPILE_WARNING_AS_ERROR=ON -DCMAKE_CXX_FLAGS="-D_GLIBCXX_ASSERTIONS -D_GLIBCXX_DEBUG=1 -D_FORTIFY_SOURCE=3 -ftrivial-auto-var-init=zero -fPIE  -pie  -Wl,-z,relro,-z,now -fstack-protector-strong -fstack-clash-protection"
-    - cmake --build . || cmake --build . --verbose
-    - ctest --parallel 2 || ctest --verbose --rerun-failed --output-on-failure
+    - apt-get -qq install --no-install-recommends -y --quiet g++ ninja-build make cmake libboost-dev libboost-serialization-dev
+        # pkg-config libboost-serialization-dev libblas-dev liblapack-dev libfftw3-dev
+    - cmake . -B build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_COMPILE_WARNING_AS_ERROR=ON -DCMAKE_CXX_FLAGS="-D_GLIBCXX_ASSERTIONS -D_GLIBCXX_DEBUG=1 -ftrivial-auto-var-init=zero -fPIE  -pie  -Wl,-z,relro,-z,now -fstack-protector-strong -fstack-clash-protection"
+    - cmake --build build
+    - ctest --test-dir build --parallel 2 --output-on-failure
 
-clang++:
+clang++:  # debian-stable -> clang 19.1.7 as of June 2026
   stage: build
-  # tags:
-  #   - non-shared
-  #   - docker
   interruptible: false
   script:
     - apt-get -qq update
-    - apt-get -qq install --no-install-recommends -y --quiet ca-certificates clang ninja-build cmake git python3 make libboost-timer-dev libboost-serialization-dev libblas-dev libfftw3-dev liblapack-dev pkg-config
-    - mkdir build && cd build
-    - clang++ --version
-    - CXX=clang++ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CXX_FLAGS="-D_GLIBCXX_ASSERTIONS -D_GLIBCXX_DEBUG=1"
-    - cmake --build . || cmake --build . --parallel 1 --verbose
-    - ctest --parallel 2 || ctest --verbose --rerun-failed --output-on-failure
+    - apt-get -qq install --no-install-recommends -y --quiet clang ninja-build make cmake libboost-dev libboost-serialization-dev
+        # pkg-config libboost-serialization-dev libblas-dev liblapack-dev libfftw3-dev
+    - CXX=clang++ cmake . -B build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_COMPILE_WARNING_AS_ERROR=ON -DCMAKE_CXX_FLAGS="-D_GLIBCXX_ASSERTIONS -D_GLIBCXX_DEBUG=1"
+    - cmake --build build
+    - ctest --test-dir build --parallel 2 --output-on-failure
 
-clang++-latest libc++ format:
+clang++-latest libc++ format:  # debian-latest -> 19.1.7 as of June 2026
   stage: build
   image: debian:latest
-  # tags:
-  #   - non-shared
-  #   - docker
   interruptible: true
   script:
     - apt-get -qq update
-    - apt-get -qq install --no-install-recommends -y --quiet ca-certificates git clang clang-format ninja-build cmake make libboost-timer-dev libboost-serialization-dev libblas-dev libc++-dev libc++abi-dev libfftw3-dev liblapack-dev pkg-config tar wget
-    - mkdir build && cd build
-    - clang++ --version
-    - CXX=clang++ cmake .. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_CXX_FLAGS="-stdlib=libc++ -DBOOST_NO_CXX98_FUNCTION_BASE -D_LIBCPP_ENABLE_CXX17_REMOVED_AUTO_PTR -D_LIBCPP_HARDENING_MODE=_LIBCPP_HARDENING_MODE_DEBUG"
-    - cmake --build . || cmake --build . --parallel 1 --verbose
-    - ctest -j 2 --output-on-failure
-    - cd ..
+    - apt-get -qq install --no-install-recommends -y --quiet ca-certificates git clang clang-format ninja-build cmake make libboost-serialization-dev libblas-dev libc++-dev libc++abi-dev libfftw3-dev liblapack-dev pkg-config tar wget
+    - CXX=clang++ cmake . -B build -DCMAKE_BUILD_TYPE=Debug -DCMAKE_COMPILE_WARNING_AS_ERROR=ON -DCMAKE_CXX_FLAGS="-stdlib=libc++ -DBOOST_NO_CXX98_FUNCTION_BASE -D_LIBCPP_ENABLE_CXX17_REMOVED_AUTO_PTR -D_LIBCPP_HARDENING_MODE=_LIBCPP_HARDENING_MODE_DEBUG"
+    - cmake --build build || cmake --build . --parallel 1 --verbose
+    - ctest --test-dir build --parallel 2 --output-on-failure
     - clang-format --version
     - clang-format --dry-run -Werror test/*.cpp include/**/*.hpp || echo "errors in formatting"
   needs: ["clang++"]

.gitlab-ci.yml

@@ -96,7 +96,7 @@ A CMake build system is provided to compile and run basic tests.
 ctest -C ./build
 ```
 
-Once installed, other CMake projects (targets) can depend on Multi by adding a simple `add_subdirectory(my_multi_path)` or by `find_package`:
+Once installed, other CMake projects (targets) can depend on Multi by adding `add_subdirectory(my_multi_path)` or by `find_package`:
 ```cmake
 find_package(multi)  # see https://gitlab.com/correaa/boost-multi
 ```

README.md

@@ -7,5 +7,4 @@ asciidoc:
     stem: latexmath
 nav:
   - modules/ROOT/nav.adoc
-  - modules/reference/nav.adoc
 start_page: intro.adoc