doxygen: add newline after \file

While \file doesn't need an argument, it can't have another doxy
command after it.

50 files changed, 172 insertions, 122 deletions

diff --git a/source/blender/freestyle/intern/stroke/AdvancedFunctions0D.cpp b/source/blender/freestyle/intern/stroke/AdvancedFunctions0D.cpp
index b62bbbf810e..0047940a5b7 100644
--- a/source/blender/freestyle/intern/stroke/AdvancedFunctions0D.cpp
+++ b/source/blender/freestyle/intern/stroke/AdvancedFunctions0D.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Functions taking 0D input
+/** \file
+ * \ingroup freestyle
+ * \brief Functions taking 0D input
  */
 
 #include "AdvancedFunctions0D.h"
diff --git a/source/blender/freestyle/intern/stroke/AdvancedFunctions0D.h b/source/blender/freestyle/intern/stroke/AdvancedFunctions0D.h
index 010f7edb4ce..5889f3c4ed3 100644
--- a/source/blender/freestyle/intern/stroke/AdvancedFunctions0D.h
+++ b/source/blender/freestyle/intern/stroke/AdvancedFunctions0D.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_ADVANCED_FUNCTIONS_0D_H__
 #define __FREESTYLE_ADVANCED_FUNCTIONS_0D_H__
 
-/** \file \ingroup freestyle
- *  \brief Functions taking 0D input
+/** \file
+ * \ingroup freestyle
+ * \brief Functions taking 0D input
  */
 
 #include "../image/GaussianFilter.h"
diff --git a/source/blender/freestyle/intern/stroke/AdvancedFunctions1D.cpp b/source/blender/freestyle/intern/stroke/AdvancedFunctions1D.cpp
index c1cd588fe3c..6d006dd395d 100644
--- a/source/blender/freestyle/intern/stroke/AdvancedFunctions1D.cpp
+++ b/source/blender/freestyle/intern/stroke/AdvancedFunctions1D.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Functions taking 1D input
+/** \file
+ * \ingroup freestyle
+ * \brief Functions taking 1D input
  */
 
 #include "AdvancedFunctions1D.h"
diff --git a/source/blender/freestyle/intern/stroke/AdvancedFunctions1D.h b/source/blender/freestyle/intern/stroke/AdvancedFunctions1D.h
index 67b3a00d6dd..6f5b2f34640 100644
--- a/source/blender/freestyle/intern/stroke/AdvancedFunctions1D.h
+++ b/source/blender/freestyle/intern/stroke/AdvancedFunctions1D.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_ADVANCED_FUNCTIONS_1D_H__
 #define __FREESTYLE_ADVANCED_FUNCTIONS_1D_H__
 
-/** \file \ingroup freestyle
- *  \brief Functions taking 1D input
+/** \file
+ * \ingroup freestyle
+ * \brief Functions taking 1D input
  */
 
 #include "AdvancedFunctions0D.h"
diff --git a/source/blender/freestyle/intern/stroke/AdvancedPredicates1D.h b/source/blender/freestyle/intern/stroke/AdvancedPredicates1D.h
index d3abe87de39..e3bfae8289a 100644
--- a/source/blender/freestyle/intern/stroke/AdvancedPredicates1D.h
+++ b/source/blender/freestyle/intern/stroke/AdvancedPredicates1D.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_ADVANCED_PREDICATES_1D_H__
 #define __FREESTYLE_ADVANCED_PREDICATES_1D_H__
 
-/** \file \ingroup freestyle
- *  \brief Class gathering stroke creation algorithms
+/** \file
+ * \ingroup freestyle
+ * \brief Class gathering stroke creation algorithms
  */
 
 #include <string>
diff --git a/source/blender/freestyle/intern/stroke/AdvancedStrokeShaders.cpp b/source/blender/freestyle/intern/stroke/AdvancedStrokeShaders.cpp
index 0625ffcdca9..247fde9a9c0 100644
--- a/source/blender/freestyle/intern/stroke/AdvancedStrokeShaders.cpp
+++ b/source/blender/freestyle/intern/stroke/AdvancedStrokeShaders.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Fredo's stroke shaders
+/** \file
+ * \ingroup freestyle
+ * \brief Fredo's stroke shaders
  */
 
 #include "AdvancedStrokeShaders.h"
diff --git a/source/blender/freestyle/intern/stroke/AdvancedStrokeShaders.h b/source/blender/freestyle/intern/stroke/AdvancedStrokeShaders.h
index 1de10ccc641..0e14e4f3631 100644
--- a/source/blender/freestyle/intern/stroke/AdvancedStrokeShaders.h
+++ b/source/blender/freestyle/intern/stroke/AdvancedStrokeShaders.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_ADVANCED_STROKE_SHADERS_H__
 #define __FREESTYLE_ADVANCED_STROKE_SHADERS_H__
 
-/** \file \ingroup freestyle
- *  \brief Fredo's stroke shaders
+/** \file
+ * \ingroup freestyle
+ * \brief Fredo's stroke shaders
  */
 
 #include "BasicStrokeShaders.h"
@@ -61,7 +62,7 @@ protected:
 /*! [ Geometry Shader ].
  *  Spatial Noise stroke shader.
  *  Moves the vertices to make the stroke more noisy.
- *  \see \htmlonly <a href=noise/noise.html>noise/noise.html</a> \endhtmlonly
+ * \see \htmlonly <a href=noise/noise.html>noise/noise.html</a> \endhtmlonly
  */
 class SpatialNoiseShader : public StrokeShader
 {
@@ -99,7 +100,7 @@ protected:
  *  (Moves the vertices to make the stroke smoother).
  *  Uses curvature flow to converge towards a curve of constant curvature. The diffusion method we use is anisotropic
  *  to prevent the diffusion accross corners.
- *  \see \htmlonly <a href=/smoothing/smoothing.html>smoothing/smoothing.html</a> \endhtmlonly
+ * \see \htmlonly <a href=/smoothing/smoothing.html>smoothing/smoothing.html</a> \endhtmlonly
  */
 class SmoothingShader : public StrokeShader
 {
diff --git a/source/blender/freestyle/intern/stroke/BasicStrokeShaders.cpp b/source/blender/freestyle/intern/stroke/BasicStrokeShaders.cpp
index a9c6778cabd..0a925949617 100644
--- a/source/blender/freestyle/intern/stroke/BasicStrokeShaders.cpp
+++ b/source/blender/freestyle/intern/stroke/BasicStrokeShaders.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class gathering basic stroke shaders
+/** \file
+ * \ingroup freestyle
+ * \brief Class gathering basic stroke shaders
  */
 
 #include <fstream>
diff --git a/source/blender/freestyle/intern/stroke/BasicStrokeShaders.h b/source/blender/freestyle/intern/stroke/BasicStrokeShaders.h
index 18e7faf8837..55f393c03df 100644
--- a/source/blender/freestyle/intern/stroke/BasicStrokeShaders.h
+++ b/source/blender/freestyle/intern/stroke/BasicStrokeShaders.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_BASIC_STROKE_SHADERS_H__
 #define __FREESTYLE_BASIC_STROKE_SHADERS_H__
 
-/** \file \ingroup freestyle
- *  \brief Class gathering basic stroke shaders
+/** \file
+ * \ingroup freestyle
+ * \brief Class gathering basic stroke shaders
  */
 
 #include <fstream>
@@ -421,7 +422,7 @@ public:
 
 /*! [ Geometry Shader. ]
  *  Resamples the stroke.
- *  \see Stroke::Resample(float).
+ * \see Stroke::Resample(float).
  */
 class SamplingShader: public StrokeShader
 {
@@ -472,7 +473,7 @@ public:
 /*! [ Geometry Shader ].
  *  Transforms the stroke backbone geometry so that it corresponds to a Bezier Curve approximation of the
  *  original backbone geometry.
- *  \see \htmlonly <a href=bezier/bezier.html>bezier/bezier.html</a> \endhtmlonly
+ * \see \htmlonly <a href=bezier/bezier.html>bezier/bezier.html</a> \endhtmlonly
  */
 class BezierCurveShader : public StrokeShader
 {
diff --git a/source/blender/freestyle/intern/stroke/Canvas.cpp b/source/blender/freestyle/intern/stroke/Canvas.cpp
index cae17244b7e..ea5b8334d20 100644
--- a/source/blender/freestyle/intern/stroke/Canvas.cpp
+++ b/source/blender/freestyle/intern/stroke/Canvas.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class to define a canvas designed to draw style modules
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define a canvas designed to draw style modules
  */
 
 #include <sstream>
diff --git a/source/blender/freestyle/intern/stroke/Canvas.h b/source/blender/freestyle/intern/stroke/Canvas.h
index 6955af05869..9431b37395c 100644
--- a/source/blender/freestyle/intern/stroke/Canvas.h
+++ b/source/blender/freestyle/intern/stroke/Canvas.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_CANVAS_H__
 #define __FREESTYLE_CANVAS_H__
 
-/** \file \ingroup freestyle
- *  \brief Class to define a canvas designed to draw style modules
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define a canvas designed to draw style modules
  */
 
 #include <cstring>
diff --git a/source/blender/freestyle/intern/stroke/Chain.cpp b/source/blender/freestyle/intern/stroke/Chain.cpp
index 8581df1c555..53e5c24352c 100644
--- a/source/blender/freestyle/intern/stroke/Chain.cpp
+++ b/source/blender/freestyle/intern/stroke/Chain.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class to define a chain of viewedges.
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define a chain of viewedges.
  */
 
 #include "Chain.h"
diff --git a/source/blender/freestyle/intern/stroke/Chain.h b/source/blender/freestyle/intern/stroke/Chain.h
index 15d4fdde2fe..21421c7298f 100644
--- a/source/blender/freestyle/intern/stroke/Chain.h
+++ b/source/blender/freestyle/intern/stroke/Chain.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_CHAIN_H__
 #define __FREESTYLE_CHAIN_H__
 
-/** \file \ingroup freestyle
- *  \brief Class to define a chain of viewedges.
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define a chain of viewedges.
  */
 
 #include "Curve.h"
diff --git a/source/blender/freestyle/intern/stroke/ChainingIterators.cpp b/source/blender/freestyle/intern/stroke/ChainingIterators.cpp
index 73090d32b88..08bdeb61713 100644
--- a/source/blender/freestyle/intern/stroke/ChainingIterators.cpp
+++ b/source/blender/freestyle/intern/stroke/ChainingIterators.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Chaining iterators
+/** \file
+ * \ingroup freestyle
+ * \brief Chaining iterators
  */
 
 #include "../python/Director.h"
diff --git a/source/blender/freestyle/intern/stroke/ChainingIterators.h b/source/blender/freestyle/intern/stroke/ChainingIterators.h
index 94343b15026..ee9730edf2b 100644
--- a/source/blender/freestyle/intern/stroke/ChainingIterators.h
+++ b/source/blender/freestyle/intern/stroke/ChainingIterators.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_CHAINING_ITERATORS_H__
 #define __FREESTYLE_CHAINING_ITERATORS_H__
 
-/** \file \ingroup freestyle
- *  \brief Chaining iterators
+/** \file
+ * \ingroup freestyle
+ * \brief Chaining iterators
  */
 
 #include <iostream>
diff --git a/source/blender/freestyle/intern/stroke/ContextFunctions.cpp b/source/blender/freestyle/intern/stroke/ContextFunctions.cpp
index 13bfa57384a..f390b4edfb6 100644
--- a/source/blender/freestyle/intern/stroke/ContextFunctions.cpp
+++ b/source/blender/freestyle/intern/stroke/ContextFunctions.cpp
@@ -14,9 +14,10 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Functions related to context queries
- *  \brief Interface to access the context related information.
+/** \file
+ * \ingroup freestyle
+ * \brief Functions related to context queries
+ * \brief Interface to access the context related information.
  */
 
 #include "ContextFunctions.h"
diff --git a/source/blender/freestyle/intern/stroke/ContextFunctions.h b/source/blender/freestyle/intern/stroke/ContextFunctions.h
index 9e3c2f24995..190217c52f7 100644
--- a/source/blender/freestyle/intern/stroke/ContextFunctions.h
+++ b/source/blender/freestyle/intern/stroke/ContextFunctions.h
@@ -17,9 +17,10 @@
 #ifndef __FREESTYLE_CONTEXT_FUNCTIONS_H__
 #define __FREESTYLE_CONTEXT_FUNCTIONS_H__
 
-/** \file \ingroup freestyle
- *  \brief Functions related to context queries
- *  \brief Interface to access the context related information.
+/** \file
+ * \ingroup freestyle
+ * \brief Functions related to context queries
+ * \brief Interface to access the context related information.
  */
 
 #include "Canvas.h"
@@ -58,40 +59,40 @@ void LoadMapCF(const char *iFileName, const char *iMapName, unsigned iNbLevels =
 
 // ReadMapPixel
 /*! Reads a pixel in a user-defined map
- *  \return the floating value stored for that pixel
- *  \param iMapName:
+ * \return the floating value stored for that pixel
+ * \param iMapName:
  *    The name of the map
- *  \param level:
+ * \param level:
  *    The level of the pyramid in which we wish to read the pixel
- *  \param x:
+ * \param x:
  *    The x-coordinate of the pixel we wish to read. The origin is in the lower-left corner.
- *  \param y:
+ * \param y:
  *    The y-coordinate of the pixel we wish to read. The origin is in the lower-left corner.
  */
 float ReadMapPixelCF(const char *iMapName, int level, unsigned x, unsigned y);
 
 // ReadCompleteViewMapPixel
 /*! Reads a pixel in the complete view map
- *  \return the floating value stored for that pixel
- *  \param level:
+ * \return the floating value stored for that pixel
+ * \param level:
  *    The level of the pyramid in which we wish to read the pixel
- *  \param x:
+ * \param x:
  *    The x-coordinate of the pixel we wish to read. The origin is in the lower-left corner.
- *  \param y:
+ * \param y:
  *    The y-coordinate of the pixel we wish to read. The origin is in the lower-left corner.
  */
 float ReadCompleteViewMapPixelCF(int level, unsigned x, unsigned y);
 
 // ReadOrientedViewMapPixel
 /*! Reads a pixel in one of the oriented view map images
- *  \return the floating value stored for that pixel
- *  \param iOrientation:
+ * \return the floating value stored for that pixel
+ * \param iOrientation:
  *    The number telling which orientation we want to check
- *  \param level:
+ * \param level:
  *    The level of the pyramid in which we wish to read the pixel
- *  \param x:
+ * \param x:
  *    The x-coordinate of the pixel we wish to read. The origin is in the lower-left corner.
- *  \param y:
+ * \param y:
  *    The y-coordinate of the pixel we wish to read. The origin is in the lower-left corner.
  */
 float ReadDirectionalViewMapPixelCF(int iOrientation, int level, unsigned x, unsigned y);
diff --git a/source/blender/freestyle/intern/stroke/Curve.cpp b/source/blender/freestyle/intern/stroke/Curve.cpp
index ff5c79544ea..f4439e1398c 100644
--- a/source/blender/freestyle/intern/stroke/Curve.cpp
+++ b/source/blender/freestyle/intern/stroke/Curve.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class to define a container for curves
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define a container for curves
  */
 
 #include <stdio.h>  /* printf */
diff --git a/source/blender/freestyle/intern/stroke/Curve.h b/source/blender/freestyle/intern/stroke/Curve.h
index 5dbbd68af7b..40c20fb777c 100644
--- a/source/blender/freestyle/intern/stroke/Curve.h
+++ b/source/blender/freestyle/intern/stroke/Curve.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_CURVE_H__
 #define __FREESTYLE_CURVE_H__
 
-/** \file \ingroup freestyle
- *  \brief Class to define a container for curves
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define a container for curves
  */
 
 #include <deque>
diff --git a/source/blender/freestyle/intern/stroke/CurveAdvancedIterators.h b/source/blender/freestyle/intern/stroke/CurveAdvancedIterators.h
index 2efe6c601c5..0a56e674936 100644
--- a/source/blender/freestyle/intern/stroke/CurveAdvancedIterators.h
+++ b/source/blender/freestyle/intern/stroke/CurveAdvancedIterators.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_CURVE_ADVANCED_ITERATORS_H__
 #define __FREESTYLE_CURVE_ADVANCED_ITERATORS_H__
 
-/** \file \ingroup freestyle
- *  \brief Iterators used to iterate over the elements of the Curve. Can't be used in python
+/** \file
+ * \ingroup freestyle
+ * \brief Iterators used to iterate over the elements of the Curve. Can't be used in python
  */
 
 #include "Stroke.h"
diff --git a/source/blender/freestyle/intern/stroke/CurveIterators.h b/source/blender/freestyle/intern/stroke/CurveIterators.h
index 6c5fed7cf7a..7b13abf9c0f 100644
--- a/source/blender/freestyle/intern/stroke/CurveIterators.h
+++ b/source/blender/freestyle/intern/stroke/CurveIterators.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_CURVE_ITERATORS_H__
 #define __FREESTYLE_CURVE_ITERATORS_H__
 
-/** \file \ingroup freestyle
- *  \brief Iterators used to iterate over the elements of the Curve
+/** \file
+ * \ingroup freestyle
+ * \brief Iterators used to iterate over the elements of the Curve
  */
 
 #include "Curve.h"
diff --git a/source/blender/freestyle/intern/stroke/Modifiers.h b/source/blender/freestyle/intern/stroke/Modifiers.h
index e91cb1ae885..95b63362bac 100644
--- a/source/blender/freestyle/intern/stroke/Modifiers.h
+++ b/source/blender/freestyle/intern/stroke/Modifiers.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_MODIFIERS_H__
 #define __FREESTYLE_MODIFIERS_H__
 
-/** \file \ingroup freestyle
- *  \brief modifiers...
+/** \file
+ * \ingroup freestyle
+ * \brief modifiers...
  */
 
 #include "TimeStamp.h"
diff --git a/source/blender/freestyle/intern/stroke/Module.h b/source/blender/freestyle/intern/stroke/Module.h
index cb636e371f1..ca0954df561 100644
--- a/source/blender/freestyle/intern/stroke/Module.h
+++ b/source/blender/freestyle/intern/stroke/Module.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_MODULE_H__
 #define __FREESTYLE_MODULE_H__
 
-/** \file \ingroup freestyle
- *  \brief Set the type of the module
+/** \file
+ * \ingroup freestyle
+ * \brief Set the type of the module
  */
 
 #include "Canvas.h"
diff --git a/source/blender/freestyle/intern/stroke/Operators.cpp b/source/blender/freestyle/intern/stroke/Operators.cpp
index 2c87ee44337..e9f6ff02f77 100644
--- a/source/blender/freestyle/intern/stroke/Operators.cpp
+++ b/source/blender/freestyle/intern/stroke/Operators.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class gathering stroke creation algorithms
+/** \file
+ * \ingroup freestyle
+ * \brief Class gathering stroke creation algorithms
  */
 
 #include <algorithm>
diff --git a/source/blender/freestyle/intern/stroke/Operators.h b/source/blender/freestyle/intern/stroke/Operators.h
index e6da3912d85..6c3d9413038 100644
--- a/source/blender/freestyle/intern/stroke/Operators.h
+++ b/source/blender/freestyle/intern/stroke/Operators.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_OPERATORS_H__
 #define __FREESTYLE_OPERATORS_H__
 
-/** \file \ingroup freestyle
- *  \brief Class gathering stroke creation algorithms
+/** \file
+ * \ingroup freestyle
+ * \brief Class gathering stroke creation algorithms
  */
 
 #include <iostream>
diff --git a/source/blender/freestyle/intern/stroke/PSStrokeRenderer.cpp b/source/blender/freestyle/intern/stroke/PSStrokeRenderer.cpp
index c988e309f41..3cdf7904998 100644
--- a/source/blender/freestyle/intern/stroke/PSStrokeRenderer.cpp
+++ b/source/blender/freestyle/intern/stroke/PSStrokeRenderer.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class to define the Postscript rendering of a stroke
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define the Postscript rendering of a stroke
  */
 
 #include "Canvas.h"
diff --git a/source/blender/freestyle/intern/stroke/PSStrokeRenderer.h b/source/blender/freestyle/intern/stroke/PSStrokeRenderer.h
index 62edad4b5e2..e24188be2f9 100644
--- a/source/blender/freestyle/intern/stroke/PSStrokeRenderer.h
+++ b/source/blender/freestyle/intern/stroke/PSStrokeRenderer.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_PS_STROKE_RENDERER_H__
 #define __FREESTYLE_PS_STROKE_RENDERER_H__
 
-/** \file \ingroup freestyle
- *  \brief Class to define the Postscript rendering of a stroke
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define the Postscript rendering of a stroke
  */
 
 #include <fstream>
diff --git a/source/blender/freestyle/intern/stroke/Predicates0D.cpp b/source/blender/freestyle/intern/stroke/Predicates0D.cpp
index bdd645df8ae..e0263abd387 100644
--- a/source/blender/freestyle/intern/stroke/Predicates0D.cpp
+++ b/source/blender/freestyle/intern/stroke/Predicates0D.cpp
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
+/** \file
+ * \ingroup freestyle
  */
 
 #include "Predicates0D.h"
diff --git a/source/blender/freestyle/intern/stroke/Predicates0D.h b/source/blender/freestyle/intern/stroke/Predicates0D.h
index 6349c0407c7..4309c942218 100644
--- a/source/blender/freestyle/intern/stroke/Predicates0D.h
+++ b/source/blender/freestyle/intern/stroke/Predicates0D.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_PREDICATES_0D_H__
 #define __FREESTYLE_PREDICATES_0D_H__
 
-/** \file \ingroup freestyle
- *  \brief Class gathering stroke creation algorithms
+/** \file
+ * \ingroup freestyle
+ * \brief Class gathering stroke creation algorithms
  */
 
 #include "../view_map/Functions0D.h"
diff --git a/source/blender/freestyle/intern/stroke/Predicates1D.cpp b/source/blender/freestyle/intern/stroke/Predicates1D.cpp
index cb63ea54f2d..b00443bf404 100644
--- a/source/blender/freestyle/intern/stroke/Predicates1D.cpp
+++ b/source/blender/freestyle/intern/stroke/Predicates1D.cpp
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
+/** \file
+ * \ingroup freestyle
  */
 
 #include "Predicates1D.h"
diff --git a/source/blender/freestyle/intern/stroke/Predicates1D.h b/source/blender/freestyle/intern/stroke/Predicates1D.h
index 4a914073a22..0501e33bcf0 100644
--- a/source/blender/freestyle/intern/stroke/Predicates1D.h
+++ b/source/blender/freestyle/intern/stroke/Predicates1D.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_PREDICATES_1D_H__
 #define __FREESTYLE_PREDICATES_1D_H__
 
-/** \file \ingroup freestyle
- *  \brief Class gathering stroke creation algorithms
+/** \file
+ * \ingroup freestyle
+ * \brief Class gathering stroke creation algorithms
  */
 
 #include <string>
diff --git a/source/blender/freestyle/intern/stroke/QInformationMap.h b/source/blender/freestyle/intern/stroke/QInformationMap.h
index 820202b4a93..7cb93321233 100644
--- a/source/blender/freestyle/intern/stroke/QInformationMap.h
+++ b/source/blender/freestyle/intern/stroke/QInformationMap.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_Q_INFORMATION_MAP_H__
 #define __FREESTYLE_Q_INFORMATION_MAP_H__
 
-/** \file \ingroup freestyle
- *  \brief Class defining an information map using a QImage
+/** \file
+ * \ingroup freestyle
+ * \brief Class defining an information map using a QImage
  */
 
 #include <qimage.h>
diff --git a/source/blender/freestyle/intern/stroke/Stroke.cpp b/source/blender/freestyle/intern/stroke/Stroke.cpp
index 80d8850d960..1cd363a15a5 100644
--- a/source/blender/freestyle/intern/stroke/Stroke.cpp
+++ b/source/blender/freestyle/intern/stroke/Stroke.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Classes to define a stroke
+/** \file
+ * \ingroup freestyle
+ * \brief Classes to define a stroke
  */
 
 #include "Stroke.h"
diff --git a/source/blender/freestyle/intern/stroke/Stroke.h b/source/blender/freestyle/intern/stroke/Stroke.h
index e6f64256ab1..bc335b2252e 100644
--- a/source/blender/freestyle/intern/stroke/Stroke.h
+++ b/source/blender/freestyle/intern/stroke/Stroke.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_H__
 #define __FREESTYLE_STROKE_H__
 
-/** \file \ingroup freestyle
- *  \brief Classes to define a stroke
+/** \file
+ * \ingroup freestyle
+ * \brief Classes to define a stroke
  */
 
 #include <map>
diff --git a/source/blender/freestyle/intern/stroke/StrokeAdvancedIterators.h b/source/blender/freestyle/intern/stroke/StrokeAdvancedIterators.h
index 6a4c04afc07..8362c293558 100644
--- a/source/blender/freestyle/intern/stroke/StrokeAdvancedIterators.h
+++ b/source/blender/freestyle/intern/stroke/StrokeAdvancedIterators.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_ADVANCED_ITERATORS_H__
 #define __FREESTYLE_STROKE_ADVANCED_ITERATORS_H__
 
-/** \file \ingroup freestyle
- *  \brief Iterators used to iterate over the elements of the Stroke. Can't be used in python
+/** \file
+ * \ingroup freestyle
+ * \brief Iterators used to iterate over the elements of the Stroke. Can't be used in python
  */
 
 #include "Stroke.h"
diff --git a/source/blender/freestyle/intern/stroke/StrokeIO.cpp b/source/blender/freestyle/intern/stroke/StrokeIO.cpp
index cdbc2056264..9b428a81d1e 100644
--- a/source/blender/freestyle/intern/stroke/StrokeIO.cpp
+++ b/source/blender/freestyle/intern/stroke/StrokeIO.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Functions to manage I/O for the stroke
+/** \file
+ * \ingroup freestyle
+ * \brief Functions to manage I/O for the stroke
  */
 
 #include "StrokeAdvancedIterators.h"
diff --git a/source/blender/freestyle/intern/stroke/StrokeIO.h b/source/blender/freestyle/intern/stroke/StrokeIO.h
index 8c83408b01d..7ce5091e9fe 100644
--- a/source/blender/freestyle/intern/stroke/StrokeIO.h
+++ b/source/blender/freestyle/intern/stroke/StrokeIO.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_IO_H__
 #define __FREESTYLE_STROKE_IO_H__
 
-/** \file \ingroup freestyle
- *  \brief Functions to manage I/O for the stroke
+/** \file
+ * \ingroup freestyle
+ * \brief Functions to manage I/O for the stroke
  */
 
 #include <iostream>
diff --git a/source/blender/freestyle/intern/stroke/StrokeIterators.h b/source/blender/freestyle/intern/stroke/StrokeIterators.h
index 2210adf6bfd..d64fbdfd83c 100644
--- a/source/blender/freestyle/intern/stroke/StrokeIterators.h
+++ b/source/blender/freestyle/intern/stroke/StrokeIterators.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_ITERATORS_H__
 #define __FREESTYLE_STROKE_ITERATORS_H__
 
-/** \file \ingroup freestyle
- *  \brief Iterators used to iterate over the elements of the Stroke
+/** \file
+ * \ingroup freestyle
+ * \brief Iterators used to iterate over the elements of the Stroke
  */
 
 #include "Stroke.h"
@@ -41,8 +42,8 @@ namespace StrokeInternal {
  *  should use a StrokeVertexIterator.
  *  The castToInterface0DIterator() method is useful to get an Interface0DIterator from a StrokeVertexIterator in
  *  order to call any functions of the type UnaryFunction0D.
- *  \attention In the scripting language, you must call \code it2 = StrokeVertexIterator(it1) \endcode instead of
- *  \code it2 = it1 \endcode where \a it1 and \a it2 are 2 StrokeVertexIterator.
+ * \attention In the scripting language, you must call \code it2 = StrokeVertexIterator(it1) \endcode instead of
+ * \code it2 = it1 \endcode where \a it1 and \a it2 are 2 StrokeVertexIterator.
  *  Otherwise, incrementing \a it1 will also increment \a it2.
  */
 class StrokeVertexIterator : public Interface0DIteratorNested
diff --git a/source/blender/freestyle/intern/stroke/StrokeLayer.cpp b/source/blender/freestyle/intern/stroke/StrokeLayer.cpp
index a6d1afdb8ac..3976c56ffe2 100644
--- a/source/blender/freestyle/intern/stroke/StrokeLayer.cpp
+++ b/source/blender/freestyle/intern/stroke/StrokeLayer.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class to define a layer of strokes.
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define a layer of strokes.
  */
 
 #include "Canvas.h"
diff --git a/source/blender/freestyle/intern/stroke/StrokeLayer.h b/source/blender/freestyle/intern/stroke/StrokeLayer.h
index 48de9331d2f..1eef44e6c91 100644
--- a/source/blender/freestyle/intern/stroke/StrokeLayer.h
+++ b/source/blender/freestyle/intern/stroke/StrokeLayer.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_LAYER_H__
 #define __FREESTYLE_STROKE_LAYER_H__
 
-/** \file \ingroup freestyle
- *  \brief Class to define a layer of strokes.
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define a layer of strokes.
  */
 
 #include <deque>
diff --git a/source/blender/freestyle/intern/stroke/StrokeRenderer.cpp b/source/blender/freestyle/intern/stroke/StrokeRenderer.cpp
index 0bdc4f29a3a..303b6c67984 100644
--- a/source/blender/freestyle/intern/stroke/StrokeRenderer.cpp
+++ b/source/blender/freestyle/intern/stroke/StrokeRenderer.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Classes to render a stroke with OpenGL
+/** \file
+ * \ingroup freestyle
+ * \brief Classes to render a stroke with OpenGL
  */
 
 #include "StrokeRenderer.h"
diff --git a/source/blender/freestyle/intern/stroke/StrokeRenderer.h b/source/blender/freestyle/intern/stroke/StrokeRenderer.h
index 4193f1ee889..35e206a73c0 100644
--- a/source/blender/freestyle/intern/stroke/StrokeRenderer.h
+++ b/source/blender/freestyle/intern/stroke/StrokeRenderer.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_RENDERER_H__
 #define __FREESTYLE_STROKE_RENDERER_H__
 
-/** \file \ingroup freestyle
- *  \brief Classes to render a stroke with OpenGL
+/** \file
+ * \ingroup freestyle
+ * \brief Classes to render a stroke with OpenGL
  */
 
 #include <map>
diff --git a/source/blender/freestyle/intern/stroke/StrokeRep.cpp b/source/blender/freestyle/intern/stroke/StrokeRep.cpp
index 59f9c799609..7298c3d9355 100644
--- a/source/blender/freestyle/intern/stroke/StrokeRep.cpp
+++ b/source/blender/freestyle/intern/stroke/StrokeRep.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class to define the representation of a stroke (for display purpose)
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define the representation of a stroke (for display purpose)
  */
 
 #include "Stroke.h"
diff --git a/source/blender/freestyle/intern/stroke/StrokeRep.h b/source/blender/freestyle/intern/stroke/StrokeRep.h
index ddbe52403c0..b282aca690c 100644
--- a/source/blender/freestyle/intern/stroke/StrokeRep.h
+++ b/source/blender/freestyle/intern/stroke/StrokeRep.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_REP_H__
 #define __FREESTYLE_STROKE_REP_H__
 
-/** \file \ingroup freestyle
- *  \brief Class to define the representation of a stroke (for display purpose)
+/** \file
+ * \ingroup freestyle
+ * \brief Class to define the representation of a stroke (for display purpose)
  */
 
 #include "Stroke.h"
diff --git a/source/blender/freestyle/intern/stroke/StrokeShader.cpp b/source/blender/freestyle/intern/stroke/StrokeShader.cpp
index 82030ff46b0..31a212a29f4 100644
--- a/source/blender/freestyle/intern/stroke/StrokeShader.cpp
+++ b/source/blender/freestyle/intern/stroke/StrokeShader.cpp
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
+/** \file
+ * \ingroup freestyle
  */
 
 #include "StrokeShader.h"
diff --git a/source/blender/freestyle/intern/stroke/StrokeShader.h b/source/blender/freestyle/intern/stroke/StrokeShader.h
index fc01b475fe4..8b4837746e0 100644
--- a/source/blender/freestyle/intern/stroke/StrokeShader.h
+++ b/source/blender/freestyle/intern/stroke/StrokeShader.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_SHADERS_H__
 #define __FREESTYLE_STROKE_SHADERS_H__
 
-/** \file \ingroup freestyle
- *  \brief Class defining StrokeShader
+/** \file
+ * \ingroup freestyle
+ * \brief Class defining StrokeShader
  */
 
 #include <iostream>
@@ -46,15 +47,15 @@ class Stroke;
  *  The basic way to achieve this operation consists in iterating over the StrokeVertices of the Stroke
  *  and to modify each one's StrokeAttribute.
  *  Here is a python code example of such an iteration:
- *  \code
+ * \code
  *  it = ioStroke.strokeVerticesBegin()
  *  while not it.isEnd():
  *      att = it.getObject().attribute()
  *      ## perform here any attribute modification
  *      it.increment()
- *  \endcode
+ * \endcode
  *  Here is a C++ code example of such an iteration:
- *  \code
+ * \code
  *  for (StrokeInternal::StrokeVertexIterator v = ioStroke.strokeVerticesBegin(), vend = ioStroke.strokeVerticesEnd();
  *      v != vend;
  *      ++v)
@@ -62,7 +63,7 @@ class Stroke;
  *  	StrokeAttribute& att = v->attribute();
  *  	// perform any attribute modification here...
  *  }
- *  \endcode
+ * \endcode
  */
 class StrokeShader
 {
diff --git a/source/blender/freestyle/intern/stroke/StrokeTesselator.cpp b/source/blender/freestyle/intern/stroke/StrokeTesselator.cpp
index 468cd9853eb..bebab7f1bf3 100644
--- a/source/blender/freestyle/intern/stroke/StrokeTesselator.cpp
+++ b/source/blender/freestyle/intern/stroke/StrokeTesselator.cpp
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
- *  \brief Class to build a Node Tree designed to be displayed from a set of strokes structure.
+/** \file
+ * \ingroup freestyle
+ * \brief Class to build a Node Tree designed to be displayed from a set of strokes structure.
  */
 
 #include "StrokeAdvancedIterators.h"
diff --git a/source/blender/freestyle/intern/stroke/StrokeTesselator.h b/source/blender/freestyle/intern/stroke/StrokeTesselator.h
index 1c61676e168..228935f2ab5 100644
--- a/source/blender/freestyle/intern/stroke/StrokeTesselator.h
+++ b/source/blender/freestyle/intern/stroke/StrokeTesselator.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STROKE_TESSELATOR_H__
 #define __FREESTYLE_STROKE_TESSELATOR_H__
 
-/** \file \ingroup freestyle
- *  \brief Class to build a Node Tree designed to be displayed from a set of strokes structure.
+/** \file
+ * \ingroup freestyle
+ * \brief Class to build a Node Tree designed to be displayed from a set of strokes structure.
  */
 
 #include "Stroke.h"
diff --git a/source/blender/freestyle/intern/stroke/StyleModule.h b/source/blender/freestyle/intern/stroke/StyleModule.h
index c1c248d8eec..fe902299f9f 100644
--- a/source/blender/freestyle/intern/stroke/StyleModule.h
+++ b/source/blender/freestyle/intern/stroke/StyleModule.h
@@ -17,8 +17,9 @@
 #ifndef __FREESTYLE_STYLE_MODULE_H__
 #define __FREESTYLE_STYLE_MODULE_H__
 
-/** \file \ingroup freestyle
- *  \brief Class representing a style module
+/** \file
+ * \ingroup freestyle
+ * \brief Class representing a style module
  */
 
 #include <iostream>
diff --git a/source/blender/freestyle/intern/stroke/TextStrokeRenderer.h b/source/blender/freestyle/intern/stroke/TextStrokeRenderer.h
index a6dbd3df294..957ad9c49db 100644
--- a/source/blender/freestyle/intern/stroke/TextStrokeRenderer.h
+++ b/source/blender/freestyle/intern/stroke/TextStrokeRenderer.h
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup freestyle
+/** \file
+ * \ingroup freestyle
  */
 
 //