Merge pull request #2092 from yambati03/generate_docs

Trigger doxygen generation in `cibuildwheel`

.github/scripts/python_wheels/cibw_before_all.sh

@@ -14,17 +14,17 @@ export PYTHON="python${PYTHON_VERSION}"
 
 if [ "$(uname)" == "Linux" ]; then
     # manylinux2014 is based on CentOS 7, so use yum to install dependencies
-    yum install -y wget
+    yum install -y wget doxygen
 
     # Install Boost from source
     wget https://archives.boost.io/release/1.87.0/source/boost_1_87_0.tar.gz --quiet
     tar -xzf boost_1_87_0.tar.gz
     cd boost_1_87_0
     ./bootstrap.sh --prefix=/opt/boost
-    ./b2 install --prefix=/opt/boost --with=all 
+    ./b2 install --prefix=/opt/boost --with=all -d0 
     cd ..
 elif [ "$(uname)" == "Darwin" ]; then
-    brew install wget cmake boost
+    brew install wget cmake boost doxygen
 fi
 
 $(which $PYTHON) -m pip install -r $PROJECT_DIR/python/dev_requirements.txt
@@ -48,11 +48,15 @@ cmake $PROJECT_DIR \
     -DGTSAM_PYTHON_VERSION=$PYTHON_VERSION \
     -DPYTHON_EXECUTABLE:FILEPATH=$(which $PYTHON) \
     -DGTSAM_ALLOW_DEPRECATED_SINCE_V43=OFF \
-    -DCMAKE_INSTALL_PREFIX=$PROJECT_DIR/gtsam_install
+    -DCMAKE_INSTALL_PREFIX=$PROJECT_DIR/gtsam_install \
+    -DGTSAM_GENERATE_DOC_XML=1 \
+    -DGTWRAP_ADD_DOCSTRINGS=ON
 
-cd $PROJECT_DIR/build/python
+# Generate Doxygen XML documentation
+doxygen build/doc/Doxyfile
 
 # Install the Python wrapper module and generate Python stubs
+cd $PROJECT_DIR/build/python
 if [ "$(uname)" == "Linux" ]; then
     make -j $(nproc) install
     make -j $(nproc) python-stubs