merge develop

Author: TheAssembler1

.github/workflows/ubuntu-cache-profiling.yml

@@ -0,0 +1,31 @@
+name: Ubuntu (profiling)
+
+on:
+  pull_request:
+    branches: [ stable, develop ]
+
+  push:
+    branches: [ stable, develop ]
+
+  workflow_dispatch:
+
+jobs:
+  PDC:
+    runs-on: ubuntu-latest
+    timeout-minutes: 60
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Dependencies
+        run: .github/workflows/dependencies-linux.sh
+
+      - name: Build PDC
+        run: |
+          mkdir build && cd build
+          cmake ../ -DBUILD_MPI_TESTING=ON -DBUILD_SHARED_LIBS=ON -DPDC_SERVER_CACHE=ON -DBUILD_TESTING=ON -DPDC_ENABLE_MPI=ON -DPDC_ENABLE_PROFILING=ON -DCMAKE_C_COMPILER=mpicc -DCMAKE_POLICY_VERSION_MINIMUM=3.5
+          make -j2
+
+      - name: Test PDC
+        working-directory: build
+        run: ctest -L serial --output-on-failure

docs/.gitignore

@@ -0,0 +1,2 @@
+_build
+html

docs/README.md

@@ -0,0 +1,44 @@
+# PDC Documentation
+
+This walks you through setting up a local environment
+for building the PDC project documentation.
+
+---
+
+## Requirements
+
+Ensure the following versions are installed on your system. Other versions
+may also work but have not been tested.
+
+- **Python 3.8.18**
+- **pip 25.0.1**
+- **Doxygen 1.13.2**
+
+You can check the versions with:
+> ```bash
+> python3.8 --version
+> pip --version
+> doxygen --version
+> ```
+
+---
+
+## Setup Instructions
+
+### 1. Clone the repository (if not already)
+```bash
+git clone https://github.com/hpc-io/pdc.git
+cd pdc/docs
+```
+
+### 2. Create Python environment install dependencies
+```bash
+python3.8 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+
+### 3. Build the html
+```bash
+python -m sphinx -T -b html -d _build/doctrees -D language=en source html
+```

docs/readme.md

@@ -2237,7 +2237,7 @@ PERLMOD_MAKEVAR_PREFIX =
 # C-preprocessor directives found in the sources and include files.
 # The default value is: YES.
 
-ENABLE_PREPROCESSING   = NO
+ENABLE_PREPROCESSING   = YES
 
 # If the MACRO_EXPANSION tag is set to YES, doxygen will expand all macro names
 # in the source code. If set to NO, only conditional compilation will be
@@ -2246,7 +2246,7 @@ ENABLE_PREPROCESSING   = NO
 # The default value is: NO.
 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
 
-MACRO_EXPANSION        = NO
+MACRO_EXPANSION        = YES
 
 # If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then
 # the macro expansion is limited to the macros specified with the PREDEFINED and
@@ -2287,7 +2287,9 @@ INCLUDE_FILE_PATTERNS  =
 # recursively expanded use the := operator instead of the = operator.
 # This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
 
-PREDEFINED             =
+PREDEFINED            += ATTRIBUTE(x)=
+PREDEFINED            += __attribute__(x)=
+PREDEFINED            += __attribute__=
 
 # If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then this
 # tag can be used to specify a list of macro names that should be expanded. The