From aa4760c6ec4b54f961eded45520d21c16be584f0 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Cezary=20Skrzy=C5=84ski?=
 <cezary.skrzynski@ng-analytics.com>
Date: Mon, 11 Nov 2024 16:25:20 +0100
Subject: [PATCH] #371: docs: use doxygen v1.8.16

---
 ci/deps/doxygen.sh                         | 18 +++++++++
 ci/docker/ubuntu-20.04-gnu-docs.dockerfile | 47 +++++++++++-----------
 2 files changed, 42 insertions(+), 23 deletions(-)
 create mode 100755 ci/deps/doxygen.sh

diff --git a/ci/deps/doxygen.sh b/ci/deps/doxygen.sh
new file mode 100755
index 00000000..eff7a54f
--- /dev/null
+++ b/ci/deps/doxygen.sh
@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+set -exo pipefail
+
+if test $# -ne 1
+then
+    echo "usage: ./$0 <doxygen-version>"
+    exit 1
+fi
+
+doxygen_version=$1
+doxygen_tar_name=doxygen-"${doxygen_version}".linux.bin.tar.gz
+
+echo "${doxygen_tar_name}"
+
+wget https://sourceforge.net/projects/doxygen/files/rel-"${doxygen_version}"/"${doxygen_tar_name}"
+
+tar xzf "${doxygen_tar_name}" --one-top-level=doxygen --strip-components=1
diff --git a/ci/docker/ubuntu-20.04-gnu-docs.dockerfile b/ci/docker/ubuntu-20.04-gnu-docs.dockerfile
index 76dc885d..8ea2af0c 100644
--- a/ci/docker/ubuntu-20.04-gnu-docs.dockerfile
+++ b/ci/docker/ubuntu-20.04-gnu-docs.dockerfile
@@ -1,6 +1,6 @@
 
 ARG arch=amd64
-FROM ${arch}/ubuntu:20.04 as base
+FROM ${arch}/ubuntu:20.04 AS base
 
 ARG proxy=""
 ARG compiler=gcc-8
@@ -13,33 +13,33 @@ ENV DEBIAN_FRONTEND=noninteractive
 
 RUN apt-get update -y -q && \
     apt-get install -y -q --no-install-recommends \
-    ca-certificates \
-    curl \
-    cmake \
-    git \
-    mpich \
-    libmpich-dev \
-    wget \
-    ${compiler} \
-    zlib1g \
-    zlib1g-dev \
-    ninja-build \
-    doxygen \
-    unzip \
-    python3 \
-    python3-jinja2 \
-    python3-pygments \
-    texlive-font-utils \
-    ghostscript \
-    ccache && \
+        ${compiler} \
+        ca-certificates \
+        ccache \
+        curl \
+        ghostscript \
+        git \
+        libmpich-dev \
+        mpich \
+        ninja-build \
+        python3 \
+        python3-jinja2 \
+        python3-pygments \
+        texlive-font-utils \
+        unzip \
+        wget \
+        zlib1g \
+        zlib1g-dev &&\
     apt-get clean && \
     rm -rf /var/lib/apt/lists/*
 
 COPY ./ci/deps/cmake.sh cmake.sh
 RUN ./cmake.sh 3.23.4 ${arch}
-
 ENV PATH=/cmake/bin/:$PATH
-ENV LESSCHARSET=utf-8
+
+COPY ./ci/deps/doxygen.sh doxygen.sh
+RUN ./doxygen.sh 1.8.16
+ENV PATH=/doxygen/bin/:$PATH
 
 COPY ./ci/deps/gtest.sh gtest.sh
 RUN ./gtest.sh 1.8.1 /pkgs
@@ -57,9 +57,10 @@ ENV MPI_EXTRA_FLAGS="" \
     CMAKE_PREFIX_PATH="/lib/x86_64-linux-gnu/" \
     CC=mpicc \
     CXX=mpicxx \
+    LESSCHARSET=utf-8 \
     PATH=/usr/lib/ccache/:$PATH
 
-FROM base as build
+FROM base AS build
 COPY . /checkpoint
 
 ARG token