[Jenkins] Ignore some warnings in Docs job.

Applications/DataExplorer/DataView/DiagramView/DiagramPrefsDialog.h

@@ -64,6 +64,7 @@ class DiagramPrefsDialog : public QDialog, private Ui_DiagramPrefs
      * Opens a new dialog and automatically reads data from the specified file. The diagram is not associated
      * with any geometric object.
      * \param filename File containing data for the diagram(s) to be visualised.
+     * \param[out] window Returns the created DetailWindow.
      * \param parent The parent QDialog.
      */
     DiagramPrefsDialog(const QString &filename,

CHANGELOG.md

@@ -8,7 +8,10 @@
 ### Utilities
 ### Infrastructure:
 
-- ctest now works on Windows too by removing time-wrappers
+- ctest now works on Windows too by removing time-wrappers. #1480
+- Moved to public Jenkins instance at jenkins.opengeosys.org. #1505
+- Doxygen warnings parser in Jenkins will mark a build as unstable
+  if there are Doxygen warnings, #1585
 
 ### Fixes:
 

MaterialLib/FractureModels/MohrCoulomb.h

@@ -81,7 +81,7 @@ class MohrCoulomb final : public FractureModelBase<DisplacementDim>
      * @param w           fracture displacement at current time step
      * @param sigma_prev  stress at previous time step
      * @param sigma       stress at current time step
-     * @param C           tangent matrix for stress and fracture displacements
+     * @param Kep         tangent matrix for stress and fracture displacements
      * @param material_state_variables   material state variables
      */
     void computeConstitutiveRelation(

MaterialLib/SolidModels/Ehlers-impl.h

@@ -217,8 +217,8 @@ void calculatePlasticResidual(
         yieldFunction<DisplacementDim>(s, _mp, t, x) / G;
 }
 
-/// Special product of v with itself: v \odot v
-/// v is given in Kelvin mapping.
+/// Special product of \p v with itself: \f$v \odot v\f$.
+/// v is given in \p Kelvin mapping.
 template <int DisplacementDim>
 ProcessLib::KelvinMatrixType<DisplacementDim> s_odot_s(
     ProcessLib::KelvinVectorType<DisplacementDim> const& v)

scripts/jenkins/docs.groovy

@@ -8,7 +8,7 @@ def build = new ogs.build()
 def post = new ogs.post()
 def helper = new ogs.helper()
 
-def image = docker.image('ogs6/gcc-base:latest')
+def image = docker.image('ogs6/gcc-latex:latest')
 image.pull()
 image.inside() {
     stage('Configure (Docs)') {
@@ -25,6 +25,9 @@ stage('Reports (Docs)') {
         keepAll: false, reportDir: 'build/docs', reportFiles: 'index.html',
         reportName: 'Doxygen'])
     step([$class: 'WarningsPublisher', canResolveRelativePaths: false,
+        messagesPattern:
+            '.*ogs_file_.*,' +
+            '.*potential recursive class relation.*',
         parserConfigurations: [[parserName: 'Doxygen', pattern:
         'build/DoxygenWarnings.log']], unstableNewAll: '0'])
 }