Merge branch 'develop' into use_func_enter_leave

Author: jeanbez

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