Fixe actions for doc generation

.github/workflows/build-docs.yml

@@ -2,9 +2,6 @@ name: Build Docs
 
 on:
   workflow_dispatch:
-  push:
-    branches:
-      - main
 
 jobs:
   build:

.github/workflows/deploy-pages.yml

@@ -2,6 +2,9 @@ name: Deploy GitHub Pages
 
 on:
   workflow_dispatch:
+  push:
+    branches:
+      - main
 
 permissions:
   contents: read

data/shaders/PBR_BRDFIntegration.frag

@@ -1,7 +1,7 @@
 /**
  * \file      PBR_BRDFIntegration.frag
- * \brief     GLSL fragment program for generating a BRDF integration map,
-//             which is the second part of the specular integral.
+ * \details   GLSL fragment program for generating a BRDF integration map, 
+ *            which is the second part of the specular integral.
  * \date      April 2018
  * \authors   Carlos Arauz, Marcus Hudritsch, Marino von Wattenwyl
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PBR_BRDFIntegration.vert

@@ -1,7 +1,7 @@
 /**
  * \file      PBR_BRDFIntegration.vert
- * \brief     GLSL vertex program for generating a BRDF integration map, which
-//             is the second part of the specular integral.
+ * \details   GLSL vertex program for generating a BRDF integration map, which 
+ *            is the second part of the specular integral.
  * \date      April 2018
  * \authors   Carlos Arauz, Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PBR_CylinderToCubeMap.frag

@@ -1,9 +1,9 @@
 /**
  * \file      PBR_CylinderToCubeMap.frag
- * \brief     GLSL fragment program which takes fragment's direction to sample
-//             the equirectangular map as if it is a cube map. Based on the
-//             physically based rendering (PBR) tutorial with GLSL by Joey de
-//             Vries on https://learnopengl.com/PBR/IBL/Diffuse-irradiance
+ * \details   GLSL fragment program which takes fragment's direction to sample
+ *            the equirectangular map as if it is a cube map. Based on the
+ *            physically based rendering (PBR) tutorial with GLSL by Joey de
+ *            Vries on https://learnopengl.com/PBR/IBL/Diffuse-irradiance
  * \authors   Carlos Arauz, Marcus Hudritsch
  * \date      April 2018
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PBR_IrradianceConvolution.frag

@@ -1,8 +1,7 @@
 /**
  * \file      PBR_IrradianceConvolution.frag
- * \brief     GLSL fragment program to generate an irradiance map by
-//             convoluting of an environment map.
-//  Author:
+ * \details   GLSL fragment program to generate an irradiance map by
+ *            convoluting of an environment map.
  * \date      April 2018
  * \authors   Carlos Arauz, Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PBR_PrefilterRoughness.frag

@@ -1,8 +1,8 @@
 /**
  * \file      PBR_PrefilterRoughness.frag
- * \brief     GLSL fragment program to generate a prefiltered environment map
-//             using convolution, similar to the irradiance convolution map but
-//             taking a roughness value into account.
+ * \details   GLSL fragment program to generate a prefiltered environment map
+              using convolution, similar to the irradiance convolution map but
+              taking a roughness value into account.
  * \date      April 2018
  * \authors   Carlos Arauz. Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/ParticleTFOLD.frag

@@ -1,8 +1,8 @@
 /**
  * \file      ParticleTF.frag
- * \brief   Simple GLSL fragment program for particle system updating this
-//  shader is never used because of the transform feedback and the 
-//  rasterization off.
+ * \brief     Simple GLSL fragment program for particle system updating this
+ * \details   This shader is never used because of the transform feedback and 
+ *            the rasterization off.
  * \date      December 2021
  * \authors   Affolter Marc
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PerPixBlinnTmNmEarth.frag

@@ -1,6 +1,6 @@
 /**
  * \file      PerPixBlinnTmNmEarth.frag
- * \brief   OGLSL parallax bump mapping
+ * \brief     OGLSL parallax bump mapping
  * \date      July 2014
  * \authors   Markus Knecht, Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PerPixCook.frag

@@ -1,8 +1,8 @@
 /**
  * \file      PerPixCook.frag
- * \brief     GLSL fragment shader for Cook-Torrance physical based rendering.
-//             Based on the physically based rendering (PBR) tutorial with GLSL
-//             from Joey de Vries on https://learnopengl.com/#!PBR/Theory
+ * \details   GLSL fragment shader for Cook-Torrance physical based rendering.
+ *            Based on the physically based rendering (PBR) tutorial with GLSL
+ *            from Joey de Vries on https://learnopengl.com/#!PBR/Theory
  * \date      July 2017
  * \authors   Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PerPixCook.vert

@@ -1,8 +1,8 @@
 /**
  * \file      PerPixCook.vert
- * \brief     GLSL vertex shader for Cook-Torrance physical based rendering.
-//             Based on the physically based rendering (PBR) tutorial with GLSL
-//             from Joey de Vries on https://learnopengl.com/#!PBR/Theory
+ * \details   GLSL vertex shader for Cook-Torrance physical based rendering.
+ *            Based on the physically based rendering (PBR) tutorial with GLSL
+ *            from Joey de Vries on https://learnopengl.com/#!PBR/Theory
  * \date      July 2014
  * \authors   Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PerPixCookTm.frag

@@ -1,8 +1,8 @@
 /**
  * \file      PerPixCookTm.frag
- * \brief     GLSL fragment shader for Cook-Torrance physical based rendering.
-//             Based on the physically based rendering (PBR) tutorial with GLSL
-//             from Joey de Vries on https://learnopengl.com/#!PBR/Theory
+ * \details   GLSL fragment shader for Cook-Torrance physical based rendering.
+ *            Based on the physically based rendering (PBR) tutorial with GLSL
+ *            from Joey de Vries on https://learnopengl.com/#!PBR/Theory
  * \date      July 2017
  * \authors   Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PerPixCookTm.vert

@@ -1,8 +1,8 @@
 /**
  * \file      PerPixCookTm.vert
- * \brief     GLSL vertex shader for Cook-Torrance physical based rendering.
-//             Based on the physically based rendering (PBR) tutorial with GLSL
-//             from Joey de Vries on https://learnopengl.com/#!PBR/Theory
+ * \details   GLSL vertex shader for Cook-Torrance physical based rendering.
+ *            Based on the physically based rendering (PBR) tutorial with GLSL
+ *            from Joey de Vries on https://learnopengl.com/#!PBR/Theory
  * \date      July 2014
  * \authors   Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PerPixTmBackgroundSm.frag

@@ -1,7 +1,7 @@
 /**
  * \file      PerPixTmBackgroundSm.frag
- * \brief     GLSL fragment shader for background texture mapping with
-//             shadow mapping
+ * \details   GLSL fragment shader for background texture mapping with
+ *            shadow mapping
  * \date      November 2020
  * \authors   Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PerPixTmBackgroundSm.vert

@@ -1,7 +1,7 @@
 /**
  * \file      PerPixTmBackground.vert
- * \brief     GLSL vertex shader for background texture mapping with
-//             shadow mapping
+ * \details   GLSL vertex shader for background texture mapping with
+ *            shadow mapping
  * \date      November 2020
  * \authors   Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/PerPixTmBackgroundSmExternal.frag

@@ -1,7 +1,7 @@
 /**
  * \file      PerPixTmBackgroundSm.frag
- * \brief     GLSL fragment shader for background texture mapping with
-//             shadow mapping
+ * \detials   GLSL fragment shader for background texture mapping with
+ *            shadow mapping
  * \date      November 2020
  * \authors   Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/RefractReflectDisp.frag

@@ -1,7 +1,7 @@
 /**
  * \file      RefractReflectDisp.frag
- * \brief     GLSL fragment program for refraction- & reflection mapping with
-//             chromatic dispersion
+ * \details   GLSL fragment program for refraction- & reflection mapping with
+ *            chromatic dispersion
  * \date      July 2014
  * \authors   Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/StereoOculusDistortionMesh.frag

@@ -1,6 +1,6 @@
 /**
  * \file      StereoOculus.frag
- * \brief   Oculus Rift Distortion Shader
+ * \brief     Oculus Rift Distortion Shader
  * \date      November 2013
  * \authors   Marc Wacker, Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0

data/shaders/StereoOculusDistortionMesh.vert

@@ -1,6 +1,6 @@
 /**
  * \file      StereoOculusDistortionMesh.vert
- * \brief   Oculus Rift Distortion Shader
+ * \brief     Oculus Rift Distortion Shader
  * \date      November 2013
  * \authors   Marc Wacker, Marcus Hudritsch
  * \copyright http://opensource.org/licenses/GPL-3.0