From de13d0a80c3cb6a7445245b2999a29fe70e49953 Mon Sep 17 00:00:00 2001
From: Campbell Barton <ideasman42@gmail.com>
Date: Mon, 18 Feb 2019 08:08:12 +1100
Subject: doxygen: add newline after \file

While \file doesn't need an argument, it can't have another doxy
command after it.
---
 source/blender/blenlib/BLI_alloca.h                     | 3 ++-
 source/blender/blenlib/BLI_args.h                       | 5 +++--
 source/blender/blenlib/BLI_array.h                      | 5 +++--
 source/blender/blenlib/BLI_array_store.h                | 5 +++--
 source/blender/blenlib/BLI_array_store_utils.h          | 3 ++-
 source/blender/blenlib/BLI_array_utils.h                | 5 +++--
 source/blender/blenlib/BLI_assert.h                     | 3 ++-
 source/blender/blenlib/BLI_astar.h                      | 5 +++--
 source/blender/blenlib/BLI_bitmap.h                     | 3 ++-
 source/blender/blenlib/BLI_bitmap_draw_2d.h             | 3 ++-
 source/blender/blenlib/BLI_blenlib.h                    | 3 ++-
 source/blender/blenlib/BLI_boxpack_2d.h                 | 3 ++-
 source/blender/blenlib/BLI_buffer.h                     | 3 ++-
 source/blender/blenlib/BLI_callbacks.h                  | 3 ++-
 source/blender/blenlib/BLI_compiler_attrs.h             | 3 ++-
 source/blender/blenlib/BLI_compiler_compat.h            | 3 ++-
 source/blender/blenlib/BLI_compiler_typecheck.h         | 3 ++-
 source/blender/blenlib/BLI_console.h                    | 5 +++--
 source/blender/blenlib/BLI_convexhull_2d.h              | 3 ++-
 source/blender/blenlib/BLI_dial_2d.h                    | 3 ++-
 source/blender/blenlib/BLI_dlrbTree.h                   | 3 ++-
 source/blender/blenlib/BLI_dynlib.h                     | 3 ++-
 source/blender/blenlib/BLI_dynstr.h                     | 7 ++++---
 source/blender/blenlib/BLI_easing.h                     | 3 ++-
 source/blender/blenlib/BLI_edgehash.h                   | 3 ++-
 source/blender/blenlib/BLI_endian_switch.h              | 3 ++-
 source/blender/blenlib/BLI_endian_switch_inline.h       | 3 ++-
 source/blender/blenlib/BLI_expr_pylike_eval.h           | 3 ++-
 source/blender/blenlib/BLI_fileops.h                    | 5 +++--
 source/blender/blenlib/BLI_fileops_types.h              | 5 +++--
 source/blender/blenlib/BLI_fnmatch.h                    | 3 ++-
 source/blender/blenlib/BLI_ghash.h                      | 3 ++-
 source/blender/blenlib/BLI_gsqueue.h                    | 3 ++-
 source/blender/blenlib/BLI_hash.h                       | 3 ++-
 source/blender/blenlib/BLI_hash_md5.h                   | 3 ++-
 source/blender/blenlib/BLI_hash_mm2a.h                  | 3 ++-
 source/blender/blenlib/BLI_hash_mm3.h                   | 3 ++-
 source/blender/blenlib/BLI_heap.h                       | 5 +++--
 source/blender/blenlib/BLI_heap_simple.h                | 5 +++--
 source/blender/blenlib/BLI_iterator.h                   | 3 ++-
 source/blender/blenlib/BLI_jitter_2d.h                  | 3 ++-
 source/blender/blenlib/BLI_kdopbvh.h                    | 3 ++-
 source/blender/blenlib/BLI_kdtree.h                     | 5 +++--
 source/blender/blenlib/BLI_lasso_2d.h                   | 3 ++-
 source/blender/blenlib/BLI_link_utils.h                 | 5 +++--
 source/blender/blenlib/BLI_linklist.h                   | 3 ++-
 source/blender/blenlib/BLI_linklist_lockfree.h          | 3 ++-
 source/blender/blenlib/BLI_linklist_stack.h             | 3 ++-
 source/blender/blenlib/BLI_listbase.h                   | 3 ++-
 source/blender/blenlib/BLI_math.h                       | 3 ++-
 source/blender/blenlib/BLI_math_base.h                  | 3 ++-
 source/blender/blenlib/BLI_math_bits.h                  | 3 ++-
 source/blender/blenlib/BLI_math_color.h                 | 3 ++-
 source/blender/blenlib/BLI_math_color_blend.h           | 3 ++-
 source/blender/blenlib/BLI_math_geom.h                  | 3 ++-
 source/blender/blenlib/BLI_math_inline.h                | 3 ++-
 source/blender/blenlib/BLI_math_interp.h                | 3 ++-
 source/blender/blenlib/BLI_math_matrix.h                | 3 ++-
 source/blender/blenlib/BLI_math_rotation.h              | 3 ++-
 source/blender/blenlib/BLI_math_solvers.h               | 3 ++-
 source/blender/blenlib/BLI_math_statistics.h            | 3 ++-
 source/blender/blenlib/BLI_math_vector.h                | 3 ++-
 source/blender/blenlib/BLI_memarena.h                   | 3 ++-
 source/blender/blenlib/BLI_memiter.h                    | 3 ++-
 source/blender/blenlib/BLI_memory_utils.h               | 5 +++--
 source/blender/blenlib/BLI_mempool.h                    | 3 ++-
 source/blender/blenlib/BLI_noise.h                      | 3 ++-
 source/blender/blenlib/BLI_path_util.h                  | 3 ++-
 source/blender/blenlib/BLI_polyfill_2d.h                | 3 ++-
 source/blender/blenlib/BLI_polyfill_2d_beautify.h       | 3 ++-
 source/blender/blenlib/BLI_quadric.h                    | 3 ++-
 source/blender/blenlib/BLI_rand.h                       | 5 +++--
 source/blender/blenlib/BLI_rect.h                       | 3 ++-
 source/blender/blenlib/BLI_scanfill.h                   | 3 ++-
 source/blender/blenlib/BLI_smallhash.h                  | 3 ++-
 source/blender/blenlib/BLI_sort.h                       | 3 ++-
 source/blender/blenlib/BLI_sort_utils.h                 | 3 ++-
 source/blender/blenlib/BLI_stack.h                      | 3 ++-
 source/blender/blenlib/BLI_strict_flags.h               | 3 ++-
 source/blender/blenlib/BLI_string.h                     | 3 ++-
 source/blender/blenlib/BLI_string_cursor_utf8.h         | 3 ++-
 source/blender/blenlib/BLI_string_utf8.h                | 3 ++-
 source/blender/blenlib/BLI_string_utils.h               | 3 ++-
 source/blender/blenlib/BLI_sys_types.h                  | 3 ++-
 source/blender/blenlib/BLI_system.h                     | 3 ++-
 source/blender/blenlib/BLI_task.h                       | 3 ++-
 source/blender/blenlib/BLI_threads.h                    | 3 ++-
 source/blender/blenlib/BLI_timecode.h                   | 3 ++-
 source/blender/blenlib/BLI_timer.h                      | 3 ++-
 source/blender/blenlib/BLI_utildefines.h                | 3 ++-
 source/blender/blenlib/BLI_utildefines_iter.h           | 3 ++-
 source/blender/blenlib/BLI_utildefines_stack.h          | 3 ++-
 source/blender/blenlib/BLI_utildefines_variadic.h       | 3 ++-
 source/blender/blenlib/BLI_uvproject.h                  | 3 ++-
 source/blender/blenlib/BLI_vfontdata.h                  | 5 +++--
 source/blender/blenlib/BLI_voronoi_2d.h                 | 3 ++-
 source/blender/blenlib/BLI_voxel.h                      | 3 ++-
 source/blender/blenlib/BLI_winstuff.h                   | 5 +++--
 source/blender/blenlib/PIL_time.h                       | 5 +++--
 source/blender/blenlib/PIL_time_utildefines.h           | 5 +++--
 source/blender/blenlib/intern/BLI_args.c                | 5 +++--
 source/blender/blenlib/intern/BLI_array.c               | 5 +++--
 source/blender/blenlib/intern/BLI_dial_2d.c             | 3 ++-
 source/blender/blenlib/intern/BLI_dynstr.c              | 3 ++-
 source/blender/blenlib/intern/BLI_filelist.c            | 3 ++-
 source/blender/blenlib/intern/BLI_ghash.c               | 3 ++-
 source/blender/blenlib/intern/BLI_ghash_utils.c         | 3 ++-
 source/blender/blenlib/intern/BLI_heap.c                | 3 ++-
 source/blender/blenlib/intern/BLI_heap_simple.c         | 3 ++-
 source/blender/blenlib/intern/BLI_kdopbvh.c             | 5 +++--
 source/blender/blenlib/intern/BLI_kdtree.c              | 3 ++-
 source/blender/blenlib/intern/BLI_linklist.c            | 3 ++-
 source/blender/blenlib/intern/BLI_linklist_lockfree.c   | 3 ++-
 source/blender/blenlib/intern/BLI_memarena.c            | 7 ++++---
 source/blender/blenlib/intern/BLI_memiter.c             | 3 ++-
 source/blender/blenlib/intern/BLI_mempool.c             | 3 ++-
 source/blender/blenlib/intern/BLI_timer.c               | 3 ++-
 source/blender/blenlib/intern/DLRB_tree.c               | 3 ++-
 source/blender/blenlib/intern/array_store.c             | 5 +++--
 source/blender/blenlib/intern/array_store_utils.c       | 5 +++--
 source/blender/blenlib/intern/array_utils.c             | 5 +++--
 source/blender/blenlib/intern/astar.c                   | 5 +++--
 source/blender/blenlib/intern/bitmap.c                  | 3 ++-
 source/blender/blenlib/intern/bitmap_draw_2d.c          | 5 +++--
 source/blender/blenlib/intern/boxpack_2d.c              | 3 ++-
 source/blender/blenlib/intern/buffer.c                  | 3 ++-
 source/blender/blenlib/intern/callbacks.c               | 3 ++-
 source/blender/blenlib/intern/convexhull_2d.c           | 3 ++-
 source/blender/blenlib/intern/dynlib.c                  | 3 ++-
 source/blender/blenlib/intern/easing.c                  | 3 ++-
 source/blender/blenlib/intern/edgehash.c                | 3 ++-
 source/blender/blenlib/intern/endian_switch.c           | 3 ++-
 source/blender/blenlib/intern/expr_pylike_eval.c        | 3 ++-
 source/blender/blenlib/intern/fileops.c                 | 3 ++-
 source/blender/blenlib/intern/fnmatch.c                 | 3 ++-
 source/blender/blenlib/intern/freetypefont.c            | 3 ++-
 source/blender/blenlib/intern/gsqueue.c                 | 3 ++-
 source/blender/blenlib/intern/hash_md5.c                | 5 +++--
 source/blender/blenlib/intern/hash_mm2a.c               | 3 ++-
 source/blender/blenlib/intern/hash_mm3.c                | 3 ++-
 source/blender/blenlib/intern/jitter_2d.c               | 5 +++--
 source/blender/blenlib/intern/lasso_2d.c                | 3 ++-
 source/blender/blenlib/intern/list_sort_impl.h          | 3 ++-
 source/blender/blenlib/intern/listbase.c                | 3 ++-
 source/blender/blenlib/intern/math_base.c               | 3 ++-
 source/blender/blenlib/intern/math_base_inline.c        | 3 ++-
 source/blender/blenlib/intern/math_bits_inline.c        | 3 ++-
 source/blender/blenlib/intern/math_color.c              | 3 ++-
 source/blender/blenlib/intern/math_color_blend_inline.c | 3 ++-
 source/blender/blenlib/intern/math_color_inline.c       | 3 ++-
 source/blender/blenlib/intern/math_geom.c               | 3 ++-
 source/blender/blenlib/intern/math_geom_inline.c        | 3 ++-
 source/blender/blenlib/intern/math_interp.c             | 3 ++-
 source/blender/blenlib/intern/math_matrix.c             | 3 ++-
 source/blender/blenlib/intern/math_rotation.c           | 3 ++-
 source/blender/blenlib/intern/math_solvers.c            | 3 ++-
 source/blender/blenlib/intern/math_statistics.c         | 3 ++-
 source/blender/blenlib/intern/math_vector.c             | 5 +++--
 source/blender/blenlib/intern/math_vector_inline.c      | 3 ++-
 source/blender/blenlib/intern/memory_utils.c            | 5 +++--
 source/blender/blenlib/intern/noise.c                   | 3 ++-
 source/blender/blenlib/intern/path_util.c               | 3 ++-
 source/blender/blenlib/intern/polyfill_2d.c             | 3 ++-
 source/blender/blenlib/intern/polyfill_2d_beautify.c    | 3 ++-
 source/blender/blenlib/intern/quadric.c                 | 3 ++-
 source/blender/blenlib/intern/rand.c                    | 3 ++-
 source/blender/blenlib/intern/rct.c                     | 3 ++-
 source/blender/blenlib/intern/scanfill.c                | 3 ++-
 source/blender/blenlib/intern/scanfill_utils.c          | 3 ++-
 source/blender/blenlib/intern/smallhash.c               | 3 ++-
 source/blender/blenlib/intern/sort.c                    | 3 ++-
 source/blender/blenlib/intern/sort_utils.c              | 3 ++-
 source/blender/blenlib/intern/stack.c                   | 3 ++-
 source/blender/blenlib/intern/storage.c                 | 3 ++-
 source/blender/blenlib/intern/string.c                  | 3 ++-
 source/blender/blenlib/intern/string_cursor_utf8.c      | 3 ++-
 source/blender/blenlib/intern/string_utf8.c             | 3 ++-
 source/blender/blenlib/intern/string_utils.c            | 3 ++-
 source/blender/blenlib/intern/system.c                  | 3 ++-
 source/blender/blenlib/intern/task.c                    | 3 ++-
 source/blender/blenlib/intern/threads.c                 | 3 ++-
 source/blender/blenlib/intern/time.c                    | 3 ++-
 source/blender/blenlib/intern/timecode.c                | 3 ++-
 source/blender/blenlib/intern/uvproject.c               | 3 ++-
 source/blender/blenlib/intern/voronoi_2d.c              | 3 ++-
 source/blender/blenlib/intern/voxel.c                   | 3 ++-
 source/blender/blenlib/intern/winstuff.c                | 3 ++-
 source/blender/blenlib/intern/winstuff_dir.c            | 3 ++-
 188 files changed, 410 insertions(+), 222 deletions(-)

(limited to 'source/blender/blenlib')

diff --git a/source/blender/blenlib/BLI_alloca.h b/source/blender/blenlib/BLI_alloca.h
index cd483abe39f..c1630dff5a1 100644
--- a/source/blender/blenlib/BLI_alloca.h
+++ b/source/blender/blenlib/BLI_alloca.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_ALLOCA_H__
 #define __BLI_ALLOCA_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Defines alloca and utility macro BLI_array_alloca
  */
diff --git a/source/blender/blenlib/BLI_args.h b/source/blender/blenlib/BLI_args.h
index fb0e774afd0..e1f54903563 100644
--- a/source/blender/blenlib/BLI_args.h
+++ b/source/blender/blenlib/BLI_args.h
@@ -20,8 +20,9 @@
 #ifndef __BLI_ARGS_H__
 #define __BLI_ARGS_H__
 
-/** \file \ingroup bli
- *  \brief A general argument parsing module.
+/** \file
+ * \ingroup bli
+ * \brief A general argument parsing module.
  */
 
 struct bArgs;
diff --git a/source/blender/blenlib/BLI_array.h b/source/blender/blenlib/BLI_array.h
index c31defef6a2..afc09363319 100644
--- a/source/blender/blenlib/BLI_array.h
+++ b/source/blender/blenlib/BLI_array.h
@@ -20,8 +20,9 @@
 #ifndef __BLI_ARRAY_H__
 #define __BLI_ARRAY_H__
 
-/** \file \ingroup bli
- *  \brief A (mainly) macro array library.
+/** \file
+ * \ingroup bli
+ * \brief A (mainly) macro array library.
  */
 
 /* -------------------------------------------------------------------- */
diff --git a/source/blender/blenlib/BLI_array_store.h b/source/blender/blenlib/BLI_array_store.h
index 230fc9d66ef..5a7d21dd6f6 100644
--- a/source/blender/blenlib/BLI_array_store.h
+++ b/source/blender/blenlib/BLI_array_store.h
@@ -17,8 +17,9 @@
 #ifndef __BLI_ARRAY_STORE_H__
 #define __BLI_ARRAY_STORE_H__
 
-/** \file \ingroup bli
- *  \brief Efficient in-memory storage of multiple similar arrays.
+/** \file
+ * \ingroup bli
+ * \brief Efficient in-memory storage of multiple similar arrays.
  */
 
 typedef struct BArrayState BArrayState;
diff --git a/source/blender/blenlib/BLI_array_store_utils.h b/source/blender/blenlib/BLI_array_store_utils.h
index 159bdcc9441..b5c11f88ed1 100644
--- a/source/blender/blenlib/BLI_array_store_utils.h
+++ b/source/blender/blenlib/BLI_array_store_utils.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_ARRAY_STORE_UTILS_H__
 #define __BLI_ARRAY_STORE_UTILS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 struct BArrayStore;
diff --git a/source/blender/blenlib/BLI_array_utils.h b/source/blender/blenlib/BLI_array_utils.h
index e017924aa31..9ab2c439cc7 100644
--- a/source/blender/blenlib/BLI_array_utils.h
+++ b/source/blender/blenlib/BLI_array_utils.h
@@ -17,8 +17,9 @@
 #ifndef __BLI_ARRAY_UTILS_H__
 #define __BLI_ARRAY_UTILS_H__
 
-/** \file \ingroup bli
- *  \brief Generic array manipulation API.
+/** \file
+ * \ingroup bli
+ * \brief Generic array manipulation API.
  */
 
 #include "BLI_compiler_typecheck.h"
diff --git a/source/blender/blenlib/BLI_assert.h b/source/blender/blenlib/BLI_assert.h
index fd78ab100f3..b6d5242ae57 100644
--- a/source/blender/blenlib/BLI_assert.h
+++ b/source/blender/blenlib/BLI_assert.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_ASSERT_H__
 #define __BLI_ASSERT_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Defines:
  * - #BLI_assert
diff --git a/source/blender/blenlib/BLI_astar.h b/source/blender/blenlib/BLI_astar.h
index a009a2afe5c..94a5b6e5d11 100644
--- a/source/blender/blenlib/BLI_astar.h
+++ b/source/blender/blenlib/BLI_astar.h
@@ -20,8 +20,9 @@
 #ifndef __BLI_ASTAR_H__
 #define __BLI_ASTAR_H__
 
-/** \file \ingroup bli
- *  \brief An implementation of the A* (AStar) algorithm to solve shortest path problem.
+/** \file
+ * \ingroup bli
+ * \brief An implementation of the A* (AStar) algorithm to solve shortest path problem.
  */
 
 #include "BLI_utildefines.h"
diff --git a/source/blender/blenlib/BLI_bitmap.h b/source/blender/blenlib/BLI_bitmap.h
index 20058db8cf9..29742fdf789 100644
--- a/source/blender/blenlib/BLI_bitmap.h
+++ b/source/blender/blenlib/BLI_bitmap.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_BITMAP_H__
 #define __BLI_BITMAP_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 typedef unsigned int BLI_bitmap;
diff --git a/source/blender/blenlib/BLI_bitmap_draw_2d.h b/source/blender/blenlib/BLI_bitmap_draw_2d.h
index d5c5de7ab09..f27ef942a5a 100644
--- a/source/blender/blenlib/BLI_bitmap_draw_2d.h
+++ b/source/blender/blenlib/BLI_bitmap_draw_2d.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_BITMAP_DRAW_2D_H__
 #define __BLI_BITMAP_DRAW_2D_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 void BLI_bitmap_draw_2d_line_v2v2i(
diff --git a/source/blender/blenlib/BLI_blenlib.h b/source/blender/blenlib/BLI_blenlib.h
index 74cb4240307..309314a4241 100644
--- a/source/blender/blenlib/BLI_blenlib.h
+++ b/source/blender/blenlib/BLI_blenlib.h
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * \section aboutbli Blender LIbrary external interface
  *
diff --git a/source/blender/blenlib/BLI_boxpack_2d.h b/source/blender/blenlib/BLI_boxpack_2d.h
index 781cccaf760..dd68e262dcd 100644
--- a/source/blender/blenlib/BLI_boxpack_2d.h
+++ b/source/blender/blenlib/BLI_boxpack_2d.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_BOXPACK_2D_H__
 #define __BLI_BOXPACK_2D_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 /* Box Packer */
diff --git a/source/blender/blenlib/BLI_buffer.h b/source/blender/blenlib/BLI_buffer.h
index 322d01def80..6c3d5cb4350 100644
--- a/source/blender/blenlib/BLI_buffer.h
+++ b/source/blender/blenlib/BLI_buffer.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_BUFFER_H__
 #define __BLI_BUFFER_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 typedef struct {
diff --git a/source/blender/blenlib/BLI_callbacks.h b/source/blender/blenlib/BLI_callbacks.h
index 0ce597ad04d..8fdc52c59bf 100644
--- a/source/blender/blenlib/BLI_callbacks.h
+++ b/source/blender/blenlib/BLI_callbacks.h
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifndef __BLI_CALLBACKS_H__
diff --git a/source/blender/blenlib/BLI_compiler_attrs.h b/source/blender/blenlib/BLI_compiler_attrs.h
index ad5593cd212..98e0eb09813 100644
--- a/source/blender/blenlib/BLI_compiler_attrs.h
+++ b/source/blender/blenlib/BLI_compiler_attrs.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_COMPILER_ATTRS_H__
 #define __BLI_COMPILER_ATTRS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 /* hint to make sure function result is actually used */
diff --git a/source/blender/blenlib/BLI_compiler_compat.h b/source/blender/blenlib/BLI_compiler_compat.h
index d3d563efa80..974f920f4b3 100644
--- a/source/blender/blenlib/BLI_compiler_compat.h
+++ b/source/blender/blenlib/BLI_compiler_compat.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_COMPILER_COMPAT_H__
 #define __BLI_COMPILER_COMPAT_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Use to help with cross platform portability.
  */
diff --git a/source/blender/blenlib/BLI_compiler_typecheck.h b/source/blender/blenlib/BLI_compiler_typecheck.h
index 60b10d0378a..4503848d6ea 100644
--- a/source/blender/blenlib/BLI_compiler_typecheck.h
+++ b/source/blender/blenlib/BLI_compiler_typecheck.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_COMPILER_TYPECHECK_H__
 #define __BLI_COMPILER_TYPECHECK_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Type checking macros (often used to ensure valid use of macro args).
  * These depend on compiler extensions and c11 in some cases.
diff --git a/source/blender/blenlib/BLI_console.h b/source/blender/blenlib/BLI_console.h
index 91f3e675461..0038ff7ae95 100644
--- a/source/blender/blenlib/BLI_console.h
+++ b/source/blender/blenlib/BLI_console.h
@@ -24,8 +24,9 @@
 extern "C" {
 #endif
 
-/** \file \ingroup bli
- *  \brief Set of utility functions and constants to work with consoles.
+/** \file
+ * \ingroup bli
+ * \brief Set of utility functions and constants to work with consoles.
  */
 
 /* Format string where one could BLI_snprintf() R, G and B values
diff --git a/source/blender/blenlib/BLI_convexhull_2d.h b/source/blender/blenlib/BLI_convexhull_2d.h
index 3d27195460c..deda2da662a 100644
--- a/source/blender/blenlib/BLI_convexhull_2d.h
+++ b/source/blender/blenlib/BLI_convexhull_2d.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_CONVEXHULL_2D_H__
 #define __BLI_CONVEXHULL_2D_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 int BLI_convexhull_2d_sorted(const float (*points)[2], const int n, int r_points[]);
diff --git a/source/blender/blenlib/BLI_dial_2d.h b/source/blender/blenlib/BLI_dial_2d.h
index 3762a8209aa..9703399a2e8 100644
--- a/source/blender/blenlib/BLI_dial_2d.h
+++ b/source/blender/blenlib/BLI_dial_2d.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_DIAL_2D_H__
 #define __BLI_DIAL_2D_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * \note dials act similar to old rotation based phones and output an angle.
  *
diff --git a/source/blender/blenlib/BLI_dlrbTree.h b/source/blender/blenlib/BLI_dlrbTree.h
index 3182e1f0541..c310eb0d2dc 100644
--- a/source/blender/blenlib/BLI_dlrbTree.h
+++ b/source/blender/blenlib/BLI_dlrbTree.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_DLRBTREE_H__
 #define __BLI_DLRBTREE_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 /* Double-Linked Red-Black Tree Implementation:
diff --git a/source/blender/blenlib/BLI_dynlib.h b/source/blender/blenlib/BLI_dynlib.h
index 3169958347d..3359a70ef11 100644
--- a/source/blender/blenlib/BLI_dynlib.h
+++ b/source/blender/blenlib/BLI_dynlib.h
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifndef __BLI_DYNLIB_H__
diff --git a/source/blender/blenlib/BLI_dynstr.h b/source/blender/blenlib/BLI_dynstr.h
index a5c95be592a..0b28a2cb65b 100644
--- a/source/blender/blenlib/BLI_dynstr.h
+++ b/source/blender/blenlib/BLI_dynstr.h
@@ -20,9 +20,10 @@
 #ifndef __BLI_DYNSTR_H__
 #define __BLI_DYNSTR_H__
 
-/** \file \ingroup bli
- *  \brief A dynamically sized string ADT.
- *  \section aboutdynstr Dynamic String
+/** \file
+ * \ingroup bli
+ * \brief A dynamically sized string ADT.
+ * \section aboutdynstr Dynamic String
  * This ADT is designed purely for dynamic string creation
  * through appending, not for general usage, the intent is
  * to build up dynamic strings using a DynStr object, then
diff --git a/source/blender/blenlib/BLI_easing.h b/source/blender/blenlib/BLI_easing.h
index 2df15a006c8..250eea723f5 100644
--- a/source/blender/blenlib/BLI_easing.h
+++ b/source/blender/blenlib/BLI_easing.h
@@ -31,7 +31,8 @@
 #ifndef __BLI_EASING_H__
 #define __BLI_EASING_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_edgehash.h b/source/blender/blenlib/BLI_edgehash.h
index 2723e020a60..7016f147616 100644
--- a/source/blender/blenlib/BLI_edgehash.h
+++ b/source/blender/blenlib/BLI_edgehash.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_EDGEHASH_H__
 #define __BLI_EDGEHASH_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_compiler_attrs.h"
diff --git a/source/blender/blenlib/BLI_endian_switch.h b/source/blender/blenlib/BLI_endian_switch.h
index 0aec317c2f9..4f878f73077 100644
--- a/source/blender/blenlib/BLI_endian_switch.h
+++ b/source/blender/blenlib/BLI_endian_switch.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_ENDIAN_SWITCH_H__
 #define __BLI_ENDIAN_SWITCH_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_compiler_attrs.h"
diff --git a/source/blender/blenlib/BLI_endian_switch_inline.h b/source/blender/blenlib/BLI_endian_switch_inline.h
index 68e4cb95033..07468568c5b 100644
--- a/source/blender/blenlib/BLI_endian_switch_inline.h
+++ b/source/blender/blenlib/BLI_endian_switch_inline.h
@@ -22,7 +22,8 @@
 #  error "this file isnt to be directly included"
 #endif
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 /* note: using a temp char to switch endian is a lot slower,
diff --git a/source/blender/blenlib/BLI_expr_pylike_eval.h b/source/blender/blenlib/BLI_expr_pylike_eval.h
index 7218b1798d3..59540d3c623 100644
--- a/source/blender/blenlib/BLI_expr_pylike_eval.h
+++ b/source/blender/blenlib/BLI_expr_pylike_eval.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_EXPR_PYLIKE_EVAL_H__
 #define __BLI_EXPR_PYLIKE_EVAL_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_fileops.h b/source/blender/blenlib/BLI_fileops.h
index 8c62a465aca..10cac63ec33 100644
--- a/source/blender/blenlib/BLI_fileops.h
+++ b/source/blender/blenlib/BLI_fileops.h
@@ -17,8 +17,9 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
- *  \brief File and directory operations.
+/** \file
+ * \ingroup bli
+ * \brief File and directory operations.
  * */
 
 #ifndef __BLI_FILEOPS_H__
diff --git a/source/blender/blenlib/BLI_fileops_types.h b/source/blender/blenlib/BLI_fileops_types.h
index 5c585a89d63..c17592f45fe 100644
--- a/source/blender/blenlib/BLI_fileops_types.h
+++ b/source/blender/blenlib/BLI_fileops_types.h
@@ -20,8 +20,9 @@
 #ifndef __BLI_FILEOPS_TYPES_H__
 #define __BLI_FILEOPS_TYPES_H__
 
-/** \file \ingroup bli
- *  \brief Some types for dealing with directories.
+/** \file
+ * \ingroup bli
+ * \brief Some types for dealing with directories.
  */
 
 #include <sys/stat.h>
diff --git a/source/blender/blenlib/BLI_fnmatch.h b/source/blender/blenlib/BLI_fnmatch.h
index 75eb11339f7..675b9b0882d 100644
--- a/source/blender/blenlib/BLI_fnmatch.h
+++ b/source/blender/blenlib/BLI_fnmatch.h
@@ -22,7 +22,8 @@
 #ifndef __BLI_FNMATCH_H__
 #define __BLI_FNMATCH_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef  __cplusplus
diff --git a/source/blender/blenlib/BLI_ghash.h b/source/blender/blenlib/BLI_ghash.h
index f5fa04c26ab..a3292fbdc5f 100644
--- a/source/blender/blenlib/BLI_ghash.h
+++ b/source/blender/blenlib/BLI_ghash.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_GHASH_H__
 #define __BLI_GHASH_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * GHash is a hash-map implementation (unordered key, value pairs).
  *
diff --git a/source/blender/blenlib/BLI_gsqueue.h b/source/blender/blenlib/BLI_gsqueue.h
index 3b30adf42ab..ee82d1a8f3c 100644
--- a/source/blender/blenlib/BLI_gsqueue.h
+++ b/source/blender/blenlib/BLI_gsqueue.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_GSQUEUE_H__
 #define __BLI_GSQUEUE_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 typedef struct _GSQueue GSQueue;
diff --git a/source/blender/blenlib/BLI_hash.h b/source/blender/blenlib/BLI_hash.h
index cfda118bb05..89ff4d90b55 100644
--- a/source/blender/blenlib/BLI_hash.h
+++ b/source/blender/blenlib/BLI_hash.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_HASH_H__
 #define __BLI_HASH_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_hash_md5.h b/source/blender/blenlib/BLI_hash_md5.h
index ad00b41c16b..afda3edc0e5 100644
--- a/source/blender/blenlib/BLI_hash_md5.h
+++ b/source/blender/blenlib/BLI_hash_md5.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_HASH_MD5_H__
 #define __BLI_HASH_MD5_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 /* Compute MD5 message digest for LEN bytes beginning at BUFFER.  The
diff --git a/source/blender/blenlib/BLI_hash_mm2a.h b/source/blender/blenlib/BLI_hash_mm2a.h
index 5e003e58b4b..4e640f539db 100644
--- a/source/blender/blenlib/BLI_hash_mm2a.h
+++ b/source/blender/blenlib/BLI_hash_mm2a.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_HASH_MM2A_H__
 #define __BLI_HASH_MM2A_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_sys_types.h"
diff --git a/source/blender/blenlib/BLI_hash_mm3.h b/source/blender/blenlib/BLI_hash_mm3.h
index 82123a5a43c..3f81503340c 100644
--- a/source/blender/blenlib/BLI_hash_mm3.h
+++ b/source/blender/blenlib/BLI_hash_mm3.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_HASH_MM3_H__
 #define __BLI_HASH_MM3_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_sys_types.h"
diff --git a/source/blender/blenlib/BLI_heap.h b/source/blender/blenlib/BLI_heap.h
index 45b1f8369ea..b45d548d9a9 100644
--- a/source/blender/blenlib/BLI_heap.h
+++ b/source/blender/blenlib/BLI_heap.h
@@ -17,8 +17,9 @@
 #ifndef __BLI_HEAP_H__
 #define __BLI_HEAP_H__
 
-/** \file \ingroup bli
- *  \brief A min-heap / priority queue ADT
+/** \file
+ * \ingroup bli
+ * \brief A min-heap / priority queue ADT
  */
 
 struct Heap;
diff --git a/source/blender/blenlib/BLI_heap_simple.h b/source/blender/blenlib/BLI_heap_simple.h
index 28aa3fa6d4f..a57688e7ea5 100644
--- a/source/blender/blenlib/BLI_heap_simple.h
+++ b/source/blender/blenlib/BLI_heap_simple.h
@@ -17,8 +17,9 @@
 #ifndef __BLI_HEAP_SIMPLE_H__
 #define __BLI_HEAP_SIMPLE_H__
 
-/** \file \ingroup bli
- *  \brief A min-heap / priority queue ADT
+/** \file
+ * \ingroup bli
+ * \brief A min-heap / priority queue ADT
  */
 
 struct HeapSimple;
diff --git a/source/blender/blenlib/BLI_iterator.h b/source/blender/blenlib/BLI_iterator.h
index 6b5b86741ad..265af6b7e53 100644
--- a/source/blender/blenlib/BLI_iterator.h
+++ b/source/blender/blenlib/BLI_iterator.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_ITERATOR_H__
 #define __BLI_ITERATOR_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 typedef struct BLI_Iterator {
diff --git a/source/blender/blenlib/BLI_jitter_2d.h b/source/blender/blenlib/BLI_jitter_2d.h
index 7d33ee64a27..bc9798c6cda 100644
--- a/source/blender/blenlib/BLI_jitter_2d.h
+++ b/source/blender/blenlib/BLI_jitter_2d.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_JITTER_2D_H__
 #define __BLI_JITTER_2D_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 void BLI_jitter_init(float (*jitarr)[2], int num);
diff --git a/source/blender/blenlib/BLI_kdopbvh.h b/source/blender/blenlib/BLI_kdopbvh.h
index 0add54de3af..0c40ce48529 100644
--- a/source/blender/blenlib/BLI_kdopbvh.h
+++ b/source/blender/blenlib/BLI_kdopbvh.h
@@ -21,7 +21,8 @@
 #ifndef __BLI_KDOPBVH_H__
 #define __BLI_KDOPBVH_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_kdtree.h b/source/blender/blenlib/BLI_kdtree.h
index ff42120164e..864055127fc 100644
--- a/source/blender/blenlib/BLI_kdtree.h
+++ b/source/blender/blenlib/BLI_kdtree.h
@@ -17,8 +17,9 @@
 #ifndef __BLI_KDTREE_H__
 #define __BLI_KDTREE_H__
 
-/** \file \ingroup bli
- *  \brief A kd-tree for nearest neighbor search.
+/** \file
+ * \ingroup bli
+ * \brief A kd-tree for nearest neighbor search.
  */
 
 #include "BLI_compiler_attrs.h"
diff --git a/source/blender/blenlib/BLI_lasso_2d.h b/source/blender/blenlib/BLI_lasso_2d.h
index 0158d40f698..c3b4b52b2e6 100644
--- a/source/blender/blenlib/BLI_lasso_2d.h
+++ b/source/blender/blenlib/BLI_lasso_2d.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_LASSO_2D_H__
 #define __BLI_LASSO_2D_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 struct rcti;
diff --git a/source/blender/blenlib/BLI_link_utils.h b/source/blender/blenlib/BLI_link_utils.h
index e74bde77312..9048b4e4b4a 100644
--- a/source/blender/blenlib/BLI_link_utils.h
+++ b/source/blender/blenlib/BLI_link_utils.h
@@ -17,8 +17,9 @@
 #ifndef __BLI_LINK_UTILS_H__
 #define __BLI_LINK_UTILS_H__
 
-/** \file \ingroup bli
- *  \brief Single link-list utility macros. (header only api).
+/** \file
+ * \ingroup bli
+ * \brief Single link-list utility macros. (header only api).
  *
  * Use this api when the structure defines its own ``next`` pointer
  * and a double linked list such as #ListBase isnt needed.
diff --git a/source/blender/blenlib/BLI_linklist.h b/source/blender/blenlib/BLI_linklist.h
index b8b002e90d5..3272505e204 100644
--- a/source/blender/blenlib/BLI_linklist.h
+++ b/source/blender/blenlib/BLI_linklist.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_LINKLIST_H__
 #define __BLI_LINKLIST_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_compiler_attrs.h"
diff --git a/source/blender/blenlib/BLI_linklist_lockfree.h b/source/blender/blenlib/BLI_linklist_lockfree.h
index 59383d2cdd3..0a191b773b9 100644
--- a/source/blender/blenlib/BLI_linklist_lockfree.h
+++ b/source/blender/blenlib/BLI_linklist_lockfree.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_LINKLIST_LOCKFREE_H__
 #define __BLI_LINKLIST_LOCKFREE_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_linklist_stack.h b/source/blender/blenlib/BLI_linklist_stack.h
index 5b32f82870e..abc799f31ba 100644
--- a/source/blender/blenlib/BLI_linklist_stack.h
+++ b/source/blender/blenlib/BLI_linklist_stack.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_LINKLIST_STACK_H__
 #define __BLI_LINKLIST_STACK_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  * \brief BLI_LINKSTACK_*** wrapper macros for using a \a LinkNode
  *        to store a stack of pointers, using a single linked list
  *        allocated from a mempool.
diff --git a/source/blender/blenlib/BLI_listbase.h b/source/blender/blenlib/BLI_listbase.h
index 614846747fd..85be4405d6c 100644
--- a/source/blender/blenlib/BLI_listbase.h
+++ b/source/blender/blenlib/BLI_listbase.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_LISTBASE_H__
 #define __BLI_LISTBASE_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_compiler_attrs.h"
diff --git a/source/blender/blenlib/BLI_math.h b/source/blender/blenlib/BLI_math.h
index 57709c8bdfc..c19fb7e0e85 100644
--- a/source/blender/blenlib/BLI_math.h
+++ b/source/blender/blenlib/BLI_math.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_H__
 #define __BLI_MATH_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * \section mathabbrev Abbreviations
  *
diff --git a/source/blender/blenlib/BLI_math_base.h b/source/blender/blenlib/BLI_math_base.h
index d79c41c19cd..01ce35a2279 100644
--- a/source/blender/blenlib/BLI_math_base.h
+++ b/source/blender/blenlib/BLI_math_base.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_BASE_H__
 #define __BLI_MATH_BASE_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef _MSC_VER
diff --git a/source/blender/blenlib/BLI_math_bits.h b/source/blender/blenlib/BLI_math_bits.h
index f18024b36e1..69768a7a796 100644
--- a/source/blender/blenlib/BLI_math_bits.h
+++ b/source/blender/blenlib/BLI_math_bits.h
@@ -18,7 +18,8 @@
 #ifndef __BLI_MATH_BITS_H__
 #define __BLI_MATH_BITS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_color.h b/source/blender/blenlib/BLI_math_color.h
index 2a5e3cf3f6a..624f87b88e9 100644
--- a/source/blender/blenlib/BLI_math_color.h
+++ b/source/blender/blenlib/BLI_math_color.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_COLOR_H__
 #define __BLI_MATH_COLOR_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_color_blend.h b/source/blender/blenlib/BLI_math_color_blend.h
index 00daa9a5eda..f1e44f7314d 100644
--- a/source/blender/blenlib/BLI_math_color_blend.h
+++ b/source/blender/blenlib/BLI_math_color_blend.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_COLOR_BLEND_H__
 #define __BLI_MATH_COLOR_BLEND_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_geom.h b/source/blender/blenlib/BLI_math_geom.h
index 54a4a38b15e..4d095ab1900 100644
--- a/source/blender/blenlib/BLI_math_geom.h
+++ b/source/blender/blenlib/BLI_math_geom.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_GEOM_H__
 #define __BLI_MATH_GEOM_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_inline.h b/source/blender/blenlib/BLI_math_inline.h
index 43cd9323d71..3e32a517471 100644
--- a/source/blender/blenlib/BLI_math_inline.h
+++ b/source/blender/blenlib/BLI_math_inline.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_INLINE_H__
 #define __BLI_MATH_INLINE_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_interp.h b/source/blender/blenlib/BLI_math_interp.h
index 4421a4b1597..a32d834f258 100644
--- a/source/blender/blenlib/BLI_math_interp.h
+++ b/source/blender/blenlib/BLI_math_interp.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_MATH_INTERP_H__
 #define __BLI_MATH_INTERP_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 void BLI_bicubic_interpolation_fl(const float *buffer, float *output, int width, int height,
diff --git a/source/blender/blenlib/BLI_math_matrix.h b/source/blender/blenlib/BLI_math_matrix.h
index 3cf6a22b0a8..4e897ace95c 100644
--- a/source/blender/blenlib/BLI_math_matrix.h
+++ b/source/blender/blenlib/BLI_math_matrix.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_MATRIX_H__
 #define __BLI_MATH_MATRIX_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_rotation.h b/source/blender/blenlib/BLI_math_rotation.h
index c2e971b23f4..699deb7d8f9 100644
--- a/source/blender/blenlib/BLI_math_rotation.h
+++ b/source/blender/blenlib/BLI_math_rotation.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_ROTATION_H__
 #define __BLI_MATH_ROTATION_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_solvers.h b/source/blender/blenlib/BLI_math_solvers.h
index beb1245a79a..4e028b34c16 100644
--- a/source/blender/blenlib/BLI_math_solvers.h
+++ b/source/blender/blenlib/BLI_math_solvers.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_MATH_SOLVERS_H__
 #define __BLI_MATH_SOLVERS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_statistics.h b/source/blender/blenlib/BLI_math_statistics.h
index 0b663ac11f9..30bbe1f4175 100644
--- a/source/blender/blenlib/BLI_math_statistics.h
+++ b/source/blender/blenlib/BLI_math_statistics.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_MATH_STATISTICS_H__
 #define __BLI_MATH_STATISTICS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_math_vector.h b/source/blender/blenlib/BLI_math_vector.h
index afa8e07df4c..f3908cf7462 100644
--- a/source/blender/blenlib/BLI_math_vector.h
+++ b/source/blender/blenlib/BLI_math_vector.h
@@ -23,7 +23,8 @@
 #ifndef __BLI_MATH_VECTOR_H__
 #define __BLI_MATH_VECTOR_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_memarena.h b/source/blender/blenlib/BLI_memarena.h
index 8e2bf6615fb..a9a5aa33e86 100644
--- a/source/blender/blenlib/BLI_memarena.h
+++ b/source/blender/blenlib/BLI_memarena.h
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifndef __BLI_MEMARENA_H__
diff --git a/source/blender/blenlib/BLI_memiter.h b/source/blender/blenlib/BLI_memiter.h
index 086a2be04cd..da73eeb1167 100644
--- a/source/blender/blenlib/BLI_memiter.h
+++ b/source/blender/blenlib/BLI_memiter.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_MEMITER_H__
 #define __BLI_MEMITER_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_memory_utils.h b/source/blender/blenlib/BLI_memory_utils.h
index cd72ded6ba4..82c862cc093 100644
--- a/source/blender/blenlib/BLI_memory_utils.h
+++ b/source/blender/blenlib/BLI_memory_utils.h
@@ -17,8 +17,9 @@
 #ifndef __BLI_MEMORY_UTILS_H__
 #define __BLI_MEMORY_UTILS_H__
 
-/** \file \ingroup bli
- *  \brief Generic memory manipulation API.
+/** \file
+ * \ingroup bli
+ * \brief Generic memory manipulation API.
  */
 
 /* it may be defined already */
diff --git a/source/blender/blenlib/BLI_mempool.h b/source/blender/blenlib/BLI_mempool.h
index dede05a64b8..31bd93544b0 100644
--- a/source/blender/blenlib/BLI_mempool.h
+++ b/source/blender/blenlib/BLI_mempool.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_MEMPOOL_H__
 #define __BLI_MEMPOOL_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_noise.h b/source/blender/blenlib/BLI_noise.h
index 81aa95e60c7..d086c2af608 100644
--- a/source/blender/blenlib/BLI_noise.h
+++ b/source/blender/blenlib/BLI_noise.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_NOISE_H__
 #define __BLI_NOISE_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_path_util.h b/source/blender/blenlib/BLI_path_util.h
index d723dbd1f56..ac87fd21a92 100644
--- a/source/blender/blenlib/BLI_path_util.h
+++ b/source/blender/blenlib/BLI_path_util.h
@@ -19,7 +19,8 @@
 #ifndef __BLI_PATH_UTIL_H__
 #define __BLI_PATH_UTIL_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_polyfill_2d.h b/source/blender/blenlib/BLI_polyfill_2d.h
index 8106f2fa383..cf4b280a2fb 100644
--- a/source/blender/blenlib/BLI_polyfill_2d.h
+++ b/source/blender/blenlib/BLI_polyfill_2d.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_POLYFILL_2D_H__
 #define __BLI_POLYFILL_2D_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 struct MemArena;
diff --git a/source/blender/blenlib/BLI_polyfill_2d_beautify.h b/source/blender/blenlib/BLI_polyfill_2d_beautify.h
index dc940e7f16d..bf46431f90b 100644
--- a/source/blender/blenlib/BLI_polyfill_2d_beautify.h
+++ b/source/blender/blenlib/BLI_polyfill_2d_beautify.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_POLYFILL_2D_BEAUTIFY_H__
 #define __BLI_POLYFILL_2D_BEAUTIFY_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 struct Heap;
diff --git a/source/blender/blenlib/BLI_quadric.h b/source/blender/blenlib/BLI_quadric.h
index dbe3a54e940..24fa3c1ca38 100644
--- a/source/blender/blenlib/BLI_quadric.h
+++ b/source/blender/blenlib/BLI_quadric.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_QUADRIC_H__
 #define __BLI_QUADRIC_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 typedef struct Quadric {
diff --git a/source/blender/blenlib/BLI_rand.h b/source/blender/blenlib/BLI_rand.h
index 2481961ff4e..8a1479b4f68 100644
--- a/source/blender/blenlib/BLI_rand.h
+++ b/source/blender/blenlib/BLI_rand.h
@@ -20,8 +20,9 @@
 #ifndef __BLI_RAND_H__
 #define __BLI_RAND_H__
 
-/** \file \ingroup bli
- *  \brief Random number functions.
+/** \file
+ * \ingroup bli
+ * \brief Random number functions.
  */
 
 /* RNG is an abstract random number generator type that avoids using globals.
diff --git a/source/blender/blenlib/BLI_rect.h b/source/blender/blenlib/BLI_rect.h
index 85531203b2e..a8d1df8eeb8 100644
--- a/source/blender/blenlib/BLI_rect.h
+++ b/source/blender/blenlib/BLI_rect.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_RECT_H__
 #define __BLI_RECT_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "DNA_vec_types.h"
diff --git a/source/blender/blenlib/BLI_scanfill.h b/source/blender/blenlib/BLI_scanfill.h
index b83f093a635..ab076dea3b8 100644
--- a/source/blender/blenlib/BLI_scanfill.h
+++ b/source/blender/blenlib/BLI_scanfill.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_SCANFILL_H__
 #define __BLI_SCANFILL_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 struct ScanFillVert;
diff --git a/source/blender/blenlib/BLI_smallhash.h b/source/blender/blenlib/BLI_smallhash.h
index 0bb11f04517..80e58a98b51 100644
--- a/source/blender/blenlib/BLI_smallhash.h
+++ b/source/blender/blenlib/BLI_smallhash.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_SMALLHASH_H__
 #define __BLI_SMALLHASH_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_compiler_attrs.h"
diff --git a/source/blender/blenlib/BLI_sort.h b/source/blender/blenlib/BLI_sort.h
index 906e1f1df3e..1863f7692af 100644
--- a/source/blender/blenlib/BLI_sort.h
+++ b/source/blender/blenlib/BLI_sort.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_SORT_H__
 #define __BLI_SORT_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdlib.h>
diff --git a/source/blender/blenlib/BLI_sort_utils.h b/source/blender/blenlib/BLI_sort_utils.h
index ac1c25b91b9..4ccf8925de2 100644
--- a/source/blender/blenlib/BLI_sort_utils.h
+++ b/source/blender/blenlib/BLI_sort_utils.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_SORT_UTILS_H__
 #define __BLI_SORT_UTILS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 /**
diff --git a/source/blender/blenlib/BLI_stack.h b/source/blender/blenlib/BLI_stack.h
index 41c27e37909..0f4cd7270a5 100644
--- a/source/blender/blenlib/BLI_stack.h
+++ b/source/blender/blenlib/BLI_stack.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_STACK_H__
 #define __BLI_STACK_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_compiler_attrs.h"
diff --git a/source/blender/blenlib/BLI_strict_flags.h b/source/blender/blenlib/BLI_strict_flags.h
index ee53d2d85d3..68ae33b068d 100644
--- a/source/blender/blenlib/BLI_strict_flags.h
+++ b/source/blender/blenlib/BLI_strict_flags.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_STRICT_FLAGS_H__
 #define __BLI_STRICT_FLAGS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  * \brief Strict compiler flags for areas of code we want
  * to ensure don't do conversions without us knowing about it.
  */
diff --git a/source/blender/blenlib/BLI_string.h b/source/blender/blenlib/BLI_string.h
index 3da5a589243..91eefc0f5b1 100644
--- a/source/blender/blenlib/BLI_string.h
+++ b/source/blender/blenlib/BLI_string.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_STRING_H__
 #define __BLI_STRING_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdarg.h>
diff --git a/source/blender/blenlib/BLI_string_cursor_utf8.h b/source/blender/blenlib/BLI_string_cursor_utf8.h
index d45b8b93c08..7e8305ceacc 100644
--- a/source/blender/blenlib/BLI_string_cursor_utf8.h
+++ b/source/blender/blenlib/BLI_string_cursor_utf8.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_STRING_CURSOR_UTF8_H__
 #define __BLI_STRING_CURSOR_UTF8_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 typedef enum eStrCursorJumpType {
diff --git a/source/blender/blenlib/BLI_string_utf8.h b/source/blender/blenlib/BLI_string_utf8.h
index b4b5a95a3d2..e370e7d9f72 100644
--- a/source/blender/blenlib/BLI_string_utf8.h
+++ b/source/blender/blenlib/BLI_string_utf8.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_STRING_UTF8_H__
 #define __BLI_STRING_UTF8_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_string_utils.h b/source/blender/blenlib/BLI_string_utils.h
index 27d7b998110..cb299db97d5 100644
--- a/source/blender/blenlib/BLI_string_utils.h
+++ b/source/blender/blenlib/BLI_string_utils.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_STRING_UTILS_H__
 #define __BLI_STRING_UTILS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdarg.h>
diff --git a/source/blender/blenlib/BLI_sys_types.h b/source/blender/blenlib/BLI_sys_types.h
index d165672ff03..e2ad1949daa 100644
--- a/source/blender/blenlib/BLI_sys_types.h
+++ b/source/blender/blenlib/BLI_sys_types.h
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * A platform-independent definition of [u]intXX_t
  * Plus the accompanying header include for htonl/ntohl
diff --git a/source/blender/blenlib/BLI_system.h b/source/blender/blenlib/BLI_system.h
index 90df93148d8..6823eccf97a 100644
--- a/source/blender/blenlib/BLI_system.h
+++ b/source/blender/blenlib/BLI_system.h
@@ -19,7 +19,8 @@
 
 #include <stdio.h>
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 int BLI_cpu_support_sse2(void);
diff --git a/source/blender/blenlib/BLI_task.h b/source/blender/blenlib/BLI_task.h
index 6fbc19a6b3f..b5fc909d842 100644
--- a/source/blender/blenlib/BLI_task.h
+++ b/source/blender/blenlib/BLI_task.h
@@ -22,7 +22,8 @@
 struct Link;
 struct ListBase;
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_threads.h b/source/blender/blenlib/BLI_threads.h
index c1c139de793..c9c7ee51ea6 100644
--- a/source/blender/blenlib/BLI_threads.h
+++ b/source/blender/blenlib/BLI_threads.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_THREADS_H__
 #define __BLI_THREADS_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 #ifdef __cplusplus
 extern "C" {
diff --git a/source/blender/blenlib/BLI_timecode.h b/source/blender/blenlib/BLI_timecode.h
index a8686a2685d..80f4a2d1927 100644
--- a/source/blender/blenlib/BLI_timecode.h
+++ b/source/blender/blenlib/BLI_timecode.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_TIMECODE_H__
 #define __BLI_TIMECODE_H__
 
-/** \file \ingroup BLI
+/** \file
+ * \ingroup BLI
  */
 
 #include "BLI_compiler_attrs.h"
diff --git a/source/blender/blenlib/BLI_timer.h b/source/blender/blenlib/BLI_timer.h
index 20ff62105b2..15797df7bd6 100644
--- a/source/blender/blenlib/BLI_timer.h
+++ b/source/blender/blenlib/BLI_timer.h
@@ -22,7 +22,8 @@
 
 #include "BLI_sys_types.h"
 
-/** \file \ingroup BLI
+/** \file
+ * \ingroup BLI
  */
 
 /* ret < 0: the timer will be removed.
diff --git a/source/blender/blenlib/BLI_utildefines.h b/source/blender/blenlib/BLI_utildefines.h
index cf8e393ca98..d3b285d0ddf 100644
--- a/source/blender/blenlib/BLI_utildefines.h
+++ b/source/blender/blenlib/BLI_utildefines.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_UTILDEFINES_H__
 #define __BLI_UTILDEFINES_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifdef __cplusplus
diff --git a/source/blender/blenlib/BLI_utildefines_iter.h b/source/blender/blenlib/BLI_utildefines_iter.h
index 26e41b1da36..32310fbdbc8 100644
--- a/source/blender/blenlib/BLI_utildefines_iter.h
+++ b/source/blender/blenlib/BLI_utildefines_iter.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_UTILDEFINES_ITER_H__
 #define __BLI_UTILDEFINES_ITER_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * General looping helpers, use `BLI_FOREACH` prefix.
  */
diff --git a/source/blender/blenlib/BLI_utildefines_stack.h b/source/blender/blenlib/BLI_utildefines_stack.h
index f93e00c7091..d3ae3b35928 100644
--- a/source/blender/blenlib/BLI_utildefines_stack.h
+++ b/source/blender/blenlib/BLI_utildefines_stack.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_UTILDEFINES_STACK_H__
 #define __BLI_UTILDEFINES_STACK_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Macro's for a simple array based stack
  * \note Caller handles alloc & free.
diff --git a/source/blender/blenlib/BLI_utildefines_variadic.h b/source/blender/blenlib/BLI_utildefines_variadic.h
index ab72004716b..3048b814383 100644
--- a/source/blender/blenlib/BLI_utildefines_variadic.h
+++ b/source/blender/blenlib/BLI_utildefines_variadic.h
@@ -17,7 +17,8 @@
 #ifndef __BLI_UTILDEFINES_VARIADIC_H__
 #define __BLI_UTILDEFINES_VARIADIC_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 /* --- internal helpers --- */
diff --git a/source/blender/blenlib/BLI_uvproject.h b/source/blender/blenlib/BLI_uvproject.h
index 35920cfbaf3..1cb29ae7391 100644
--- a/source/blender/blenlib/BLI_uvproject.h
+++ b/source/blender/blenlib/BLI_uvproject.h
@@ -16,7 +16,8 @@
 #ifndef __BLI_UVPROJECT_H__
 #define __BLI_UVPROJECT_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 struct Object;
diff --git a/source/blender/blenlib/BLI_vfontdata.h b/source/blender/blenlib/BLI_vfontdata.h
index 67b952d6f9f..4d4c7c179e7 100644
--- a/source/blender/blenlib/BLI_vfontdata.h
+++ b/source/blender/blenlib/BLI_vfontdata.h
@@ -20,8 +20,9 @@
 #ifndef __BLI_VFONTDATA_H__
 #define __BLI_VFONTDATA_H__
 
-/** \file \ingroup bli
- *  \brief A structure to represent vector fonts,
+/** \file
+ * \ingroup bli
+ * \brief A structure to represent vector fonts,
  *   and to load them from PostScript fonts.
  */
 
diff --git a/source/blender/blenlib/BLI_voronoi_2d.h b/source/blender/blenlib/BLI_voronoi_2d.h
index dab4693967d..93b4961a9ed 100644
--- a/source/blender/blenlib/BLI_voronoi_2d.h
+++ b/source/blender/blenlib/BLI_voronoi_2d.h
@@ -22,7 +22,8 @@
 
 struct ListBase;
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 typedef struct VoronoiSite {
diff --git a/source/blender/blenlib/BLI_voxel.h b/source/blender/blenlib/BLI_voxel.h
index c7e64761e6f..6d38109851d 100644
--- a/source/blender/blenlib/BLI_voxel.h
+++ b/source/blender/blenlib/BLI_voxel.h
@@ -20,7 +20,8 @@
 #ifndef __BLI_VOXEL_H__
 #define __BLI_VOXEL_H__
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 /** find the index number of a voxel, given x/y/z integer coords and resolution vector */
diff --git a/source/blender/blenlib/BLI_winstuff.h b/source/blender/blenlib/BLI_winstuff.h
index 314aaaf4fdc..13ef63bcccb 100644
--- a/source/blender/blenlib/BLI_winstuff.h
+++ b/source/blender/blenlib/BLI_winstuff.h
@@ -20,8 +20,9 @@
 #ifndef __BLI_WINSTUFF_H__
 #define __BLI_WINSTUFF_H__
 
-/** \file \ingroup bli
- *  \brief Compatibility-like things for windows.
+/** \file
+ * \ingroup bli
+ * \brief Compatibility-like things for windows.
  */
 
 #ifndef _WIN32
diff --git a/source/blender/blenlib/PIL_time.h b/source/blender/blenlib/PIL_time.h
index 8c3d00ef1ac..e9843685f72 100644
--- a/source/blender/blenlib/PIL_time.h
+++ b/source/blender/blenlib/PIL_time.h
@@ -17,8 +17,9 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
- *  \brief Platform independent time functions.
+/** \file
+ * \ingroup bli
+ * \brief Platform independent time functions.
  */
 
 #ifndef __PIL_TIME_H__
diff --git a/source/blender/blenlib/PIL_time_utildefines.h b/source/blender/blenlib/PIL_time_utildefines.h
index 56ebb0be119..712ad0e30fc 100644
--- a/source/blender/blenlib/PIL_time_utildefines.h
+++ b/source/blender/blenlib/PIL_time_utildefines.h
@@ -17,8 +17,9 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
- *  \brief Utility defines for timing/benchmarks.
+/** \file
+ * \ingroup bli
+ * \brief Utility defines for timing/benchmarks.
  */
 
 #ifndef __PIL_TIME_UTILDEFINES_H__
diff --git a/source/blender/blenlib/intern/BLI_args.c b/source/blender/blenlib/intern/BLI_args.c
index 06ef40ff34b..dbd609d914a 100644
--- a/source/blender/blenlib/intern/BLI_args.c
+++ b/source/blender/blenlib/intern/BLI_args.c
@@ -17,8 +17,9 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
- *  \brief A general argument parsing module
+/** \file
+ * \ingroup bli
+ * \brief A general argument parsing module
  */
 
 #include <ctype.h> /* for tolower */
diff --git a/source/blender/blenlib/intern/BLI_array.c b/source/blender/blenlib/intern/BLI_array.c
index 5a6bca039d8..6c22b128f5c 100644
--- a/source/blender/blenlib/intern/BLI_array.c
+++ b/source/blender/blenlib/intern/BLI_array.c
@@ -17,8 +17,9 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
- *  \brief A (mainly) macro array library.
+/** \file
+ * \ingroup bli
+ * \brief A (mainly) macro array library.
  *
  * This is an array library, used to manage array (re)allocation.
  *
diff --git a/source/blender/blenlib/intern/BLI_dial_2d.c b/source/blender/blenlib/intern/BLI_dial_2d.c
index 1ca1774cf7b..882d239aa4b 100644
--- a/source/blender/blenlib/intern/BLI_dial_2d.c
+++ b/source/blender/blenlib/intern/BLI_dial_2d.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_dial_2d.h"
diff --git a/source/blender/blenlib/intern/BLI_dynstr.c b/source/blender/blenlib/intern/BLI_dynstr.c
index 9696e3dd40e..98682101c65 100644
--- a/source/blender/blenlib/intern/BLI_dynstr.c
+++ b/source/blender/blenlib/intern/BLI_dynstr.c
@@ -18,7 +18,8 @@
  * Dynamically sized string ADT
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdlib.h>  /* malloc */
diff --git a/source/blender/blenlib/intern/BLI_filelist.c b/source/blender/blenlib/intern/BLI_filelist.c
index bb3fdab1730..8cbba2103d3 100644
--- a/source/blender/blenlib/intern/BLI_filelist.c
+++ b/source/blender/blenlib/intern/BLI_filelist.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <sys/types.h>
diff --git a/source/blender/blenlib/intern/BLI_ghash.c b/source/blender/blenlib/intern/BLI_ghash.c
index adf4a3d5210..298c9ca4d39 100644
--- a/source/blender/blenlib/intern/BLI_ghash.c
+++ b/source/blender/blenlib/intern/BLI_ghash.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * A general (pointer -> pointer) chaining hash table
  * for 'Abstract Data Types' (known as an ADT Hash Table).
diff --git a/source/blender/blenlib/intern/BLI_ghash_utils.c b/source/blender/blenlib/intern/BLI_ghash_utils.c
index 3ba84a90600..5e271c21830 100644
--- a/source/blender/blenlib/intern/BLI_ghash_utils.c
+++ b/source/blender/blenlib/intern/BLI_ghash_utils.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Helper functions and implementations of standard data types for #GHash
  * (not it's implementation).
diff --git a/source/blender/blenlib/intern/BLI_heap.c b/source/blender/blenlib/intern/BLI_heap.c
index 5a443e8d798..0e5cfd02939 100644
--- a/source/blender/blenlib/intern/BLI_heap.c
+++ b/source/blender/blenlib/intern/BLI_heap.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * A min-heap / priority queue ADT.
  */
diff --git a/source/blender/blenlib/intern/BLI_heap_simple.c b/source/blender/blenlib/intern/BLI_heap_simple.c
index 2568a8a86aa..50eb06e5d5d 100644
--- a/source/blender/blenlib/intern/BLI_heap_simple.c
+++ b/source/blender/blenlib/intern/BLI_heap_simple.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * A min-heap / priority queue ADT.
  *
diff --git a/source/blender/blenlib/intern/BLI_kdopbvh.c b/source/blender/blenlib/intern/BLI_kdopbvh.c
index 8f92f00c6d9..7199c4126d4 100644
--- a/source/blender/blenlib/intern/BLI_kdopbvh.c
+++ b/source/blender/blenlib/intern/BLI_kdopbvh.c
@@ -17,8 +17,9 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
- *  \brief BVH-tree implementation.
+/** \file
+ * \ingroup bli
+ * \brief BVH-tree implementation.
  *
  * k-DOP BVH (Discrete Oriented Polytope, Bounding Volume Hierarchy).
  * A k-DOP is represented as k/2 pairs of min , max values for k/2 directions (intervals, "slabs").
diff --git a/source/blender/blenlib/intern/BLI_kdtree.c b/source/blender/blenlib/intern/BLI_kdtree.c
index fe1e4ddfae0..4f12bd0a93f 100644
--- a/source/blender/blenlib/intern/BLI_kdtree.c
+++ b/source/blender/blenlib/intern/BLI_kdtree.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "MEM_guardedalloc.h"
diff --git a/source/blender/blenlib/intern/BLI_linklist.c b/source/blender/blenlib/intern/BLI_linklist.c
index 70e43be1ac6..46499279659 100644
--- a/source/blender/blenlib/intern/BLI_linklist.c
+++ b/source/blender/blenlib/intern/BLI_linklist.c
@@ -18,7 +18,8 @@
  * Support for linked lists.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Routines for working with single linked lists of 'links' - pointers to other data.
  *
diff --git a/source/blender/blenlib/intern/BLI_linklist_lockfree.c b/source/blender/blenlib/intern/BLI_linklist_lockfree.c
index fbeb4c5ab80..d5dca86ae50 100644
--- a/source/blender/blenlib/intern/BLI_linklist_lockfree.c
+++ b/source/blender/blenlib/intern/BLI_linklist_lockfree.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "MEM_guardedalloc.h"
diff --git a/source/blender/blenlib/intern/BLI_memarena.c b/source/blender/blenlib/intern/BLI_memarena.c
index 71260086afa..9e084f78eee 100644
--- a/source/blender/blenlib/intern/BLI_memarena.c
+++ b/source/blender/blenlib/intern/BLI_memarena.c
@@ -18,9 +18,10 @@
  * Efficient memory allocation for lots of similar small chunks.
  */
 
-/** \file \ingroup bli
- *  \brief Memory arena ADT.
- *  \section aboutmemarena Memory Arena
+/** \file
+ * \ingroup bli
+ * \brief Memory arena ADT.
+ * \section aboutmemarena Memory Arena
  *
  * Memory arena's are commonly used when the program
  * needs to quickly allocate lots of little bits of data,
diff --git a/source/blender/blenlib/intern/BLI_memiter.c b/source/blender/blenlib/intern/BLI_memiter.c
index 6d099a24a3c..03eefc9ae5d 100644
--- a/source/blender/blenlib/intern/BLI_memiter.c
+++ b/source/blender/blenlib/intern/BLI_memiter.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Simple, fast memory allocator for allocating many small elements of different sizes
  * in fixed size memory chunks,
diff --git a/source/blender/blenlib/intern/BLI_mempool.c b/source/blender/blenlib/intern/BLI_mempool.c
index 9a66d9d02a8..d6f6ec8362b 100644
--- a/source/blender/blenlib/intern/BLI_mempool.c
+++ b/source/blender/blenlib/intern/BLI_mempool.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Simple, fast memory allocator for allocating many elements of the same size.
  *
diff --git a/source/blender/blenlib/intern/BLI_timer.c b/source/blender/blenlib/intern/BLI_timer.c
index 27263811a45..a09dc7f68ec 100644
--- a/source/blender/blenlib/intern/BLI_timer.c
+++ b/source/blender/blenlib/intern/BLI_timer.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_timer.h"
diff --git a/source/blender/blenlib/intern/DLRB_tree.c b/source/blender/blenlib/intern/DLRB_tree.c
index f938f38c7a5..e74b1016bb1 100644
--- a/source/blender/blenlib/intern/DLRB_tree.c
+++ b/source/blender/blenlib/intern/DLRB_tree.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/array_store.c b/source/blender/blenlib/intern/array_store.c
index bf46f8656ac..477d320835e 100644
--- a/source/blender/blenlib/intern/array_store.c
+++ b/source/blender/blenlib/intern/array_store.c
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
- *  \brief Array storage to minimize duplication.
+/** \file
+ * \ingroup bli
+ * \brief Array storage to minimize duplication.
  *
  * This is done by splitting arrays into chunks and using copy-on-write (COW),
  * to de-duplicate chunks,
diff --git a/source/blender/blenlib/intern/array_store_utils.c b/source/blender/blenlib/intern/array_store_utils.c
index 9906330f7cb..d1b936b76f7 100644
--- a/source/blender/blenlib/intern/array_store_utils.c
+++ b/source/blender/blenlib/intern/array_store_utils.c
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
- *  \brief Helper functions for BLI_array_store API.
+/** \file
+ * \ingroup bli
+ * \brief Helper functions for BLI_array_store API.
  */
 
 #include "MEM_guardedalloc.h"
diff --git a/source/blender/blenlib/intern/array_utils.c b/source/blender/blenlib/intern/array_utils.c
index ab347658042..568f3f9b9ff 100644
--- a/source/blender/blenlib/intern/array_utils.c
+++ b/source/blender/blenlib/intern/array_utils.c
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
- *  \brief Generic array manipulation API.
+/** \file
+ * \ingroup bli
+ * \brief Generic array manipulation API.
  *
  * \warning Some array operations here are inherently inefficient,
  * and only included for the cases where the performance is acceptable.
diff --git a/source/blender/blenlib/intern/astar.c b/source/blender/blenlib/intern/astar.c
index fc777ea0485..13998bad81d 100644
--- a/source/blender/blenlib/intern/astar.c
+++ b/source/blender/blenlib/intern/astar.c
@@ -17,8 +17,9 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
- *  \brief An implementation of the A* (AStar) algorithm to solve shortest path problem.
+/** \file
+ * \ingroup bli
+ * \brief An implementation of the A* (AStar) algorithm to solve shortest path problem.
  *
  * This library implements the simple A* (AStar) algorithm, an optimized version of
  * classical dijkstra shortest path solver. The difference is that each future possible
diff --git a/source/blender/blenlib/intern/bitmap.c b/source/blender/blenlib/intern/bitmap.c
index 1e84939c9f5..8cc359ac7f2 100644
--- a/source/blender/blenlib/intern/bitmap.c
+++ b/source/blender/blenlib/intern/bitmap.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Utility functions for variable size bitmasks.
  */
diff --git a/source/blender/blenlib/intern/bitmap_draw_2d.c b/source/blender/blenlib/intern/bitmap_draw_2d.c
index 4028b1f7db1..aa2e93d06a1 100644
--- a/source/blender/blenlib/intern/bitmap_draw_2d.c
+++ b/source/blender/blenlib/intern/bitmap_draw_2d.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Utility functions for primitive drawing operations.
  */
@@ -164,7 +165,7 @@ static float inv_slope(const int a[2], const int b[2])
 /**
  * <pre>
  * *---*
- *  \ /
+ * \ /
  *   *
  * </pre>
  */
diff --git a/source/blender/blenlib/intern/boxpack_2d.c b/source/blender/blenlib/intern/boxpack_2d.c
index db81d4ba0e4..357fa57b144 100644
--- a/source/blender/blenlib/intern/boxpack_2d.c
+++ b/source/blender/blenlib/intern/boxpack_2d.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdlib.h> /* for qsort */
diff --git a/source/blender/blenlib/intern/buffer.c b/source/blender/blenlib/intern/buffer.c
index 194de387dfd..50401fe6091 100644
--- a/source/blender/blenlib/intern/buffer.c
+++ b/source/blender/blenlib/intern/buffer.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Primitive generic buffer library.
  *
diff --git a/source/blender/blenlib/intern/callbacks.c b/source/blender/blenlib/intern/callbacks.c
index d1d66c99b5a..0f84cd588a9 100644
--- a/source/blender/blenlib/intern/callbacks.c
+++ b/source/blender/blenlib/intern/callbacks.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_utildefines.h"
diff --git a/source/blender/blenlib/intern/convexhull_2d.c b/source/blender/blenlib/intern/convexhull_2d.c
index c4163311a05..a59d44037f1 100644
--- a/source/blender/blenlib/intern/convexhull_2d.c
+++ b/source/blender/blenlib/intern/convexhull_2d.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/dynlib.c b/source/blender/blenlib/intern/dynlib.c
index e6122b99767..b172ae7a518 100644
--- a/source/blender/blenlib/intern/dynlib.c
+++ b/source/blender/blenlib/intern/dynlib.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdio.h>
diff --git a/source/blender/blenlib/intern/easing.c b/source/blender/blenlib/intern/easing.c
index dc54275f5f3..07765276537 100644
--- a/source/blender/blenlib/intern/easing.c
+++ b/source/blender/blenlib/intern/easing.c
@@ -28,7 +28,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_math_base.h"
diff --git a/source/blender/blenlib/intern/edgehash.c b/source/blender/blenlib/intern/edgehash.c
index c255b8b88fa..f3d69bc9795 100644
--- a/source/blender/blenlib/intern/edgehash.c
+++ b/source/blender/blenlib/intern/edgehash.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * An (edge -> pointer) hash table.
  * Using unordered int-pairs as keys.
diff --git a/source/blender/blenlib/intern/endian_switch.c b/source/blender/blenlib/intern/endian_switch.c
index 414f46fa2cf..cc2ffa864f5 100644
--- a/source/blender/blenlib/intern/endian_switch.c
+++ b/source/blender/blenlib/intern/endian_switch.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_sys_types.h"
diff --git a/source/blender/blenlib/intern/expr_pylike_eval.c b/source/blender/blenlib/intern/expr_pylike_eval.c
index 33da29298c3..d0027c63c4b 100644
--- a/source/blender/blenlib/intern/expr_pylike_eval.c
+++ b/source/blender/blenlib/intern/expr_pylike_eval.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Simple evaluator for a subset of Python expressions that can be
  * computed using purely double precision floating point values.
diff --git a/source/blender/blenlib/intern/fileops.c b/source/blender/blenlib/intern/fileops.c
index 31f5ef5e5a2..2339025307e 100644
--- a/source/blender/blenlib/intern/fileops.c
+++ b/source/blender/blenlib/intern/fileops.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/fnmatch.c b/source/blender/blenlib/intern/fnmatch.c
index 70817b2e3dd..9ba2cdbf2e6 100644
--- a/source/blender/blenlib/intern/fnmatch.c
+++ b/source/blender/blenlib/intern/fnmatch.c
@@ -1,4 +1,5 @@
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 /* Copyright (C) 1991, 1992, 1993, 1996, 1997 Free Software Foundation, Inc.
 
diff --git a/source/blender/blenlib/intern/freetypefont.c b/source/blender/blenlib/intern/freetypefont.c
index f1a345588f6..fba3c825a1c 100644
--- a/source/blender/blenlib/intern/freetypefont.c
+++ b/source/blender/blenlib/intern/freetypefont.c
@@ -21,7 +21,8 @@
  * Code that uses exotic character maps is present but commented out.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <ft2build.h>
diff --git a/source/blender/blenlib/intern/gsqueue.c b/source/blender/blenlib/intern/gsqueue.c
index af8f31b6cea..226e6cd34d5 100644
--- a/source/blender/blenlib/intern/gsqueue.c
+++ b/source/blender/blenlib/intern/gsqueue.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * \brief A generic structure queue
  * (a queue for fixed length generally small) structures.
diff --git a/source/blender/blenlib/intern/hash_md5.c b/source/blender/blenlib/intern/hash_md5.c
index ab7e32f5e59..895b558dc82 100644
--- a/source/blender/blenlib/intern/hash_md5.c
+++ b/source/blender/blenlib/intern/hash_md5.c
@@ -17,7 +17,8 @@
  * Written by Ulrich Drepper <drepper@gnu.ai.mit.edu>.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  *  Functions to compute MD5 message digest of files or memory blocks
  *  according to the definition of MD5 in RFC 1321 from April 1992.
@@ -284,7 +285,7 @@ static void *md5_read_ctx(const struct md5_ctx *ctx, void *resbuf)
 
 /** Compute MD5 message digest for bytes read from 'stream'.
  *  The resulting message digest number will be written into the 16 bytes beginning at 'resblock'.
- *  \return Non-zero if an error occurred.
+ * \return Non-zero if an error occurred.
  */
 int BLI_hash_md5_stream(FILE *stream, void *resblock)
 {
diff --git a/source/blender/blenlib/intern/hash_mm2a.c b/source/blender/blenlib/intern/hash_mm2a.c
index 7ea131db6ba..ff604110f2b 100644
--- a/source/blender/blenlib/intern/hash_mm2a.c
+++ b/source/blender/blenlib/intern/hash_mm2a.c
@@ -15,7 +15,8 @@
  * Copyright (C) 2014 Blender Foundation.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  *  Functions to compute Murmur2A hash key.
  *
diff --git a/source/blender/blenlib/intern/hash_mm3.c b/source/blender/blenlib/intern/hash_mm3.c
index 7fdff4348c8..c788a6ae7c8 100644
--- a/source/blender/blenlib/intern/hash_mm3.c
+++ b/source/blender/blenlib/intern/hash_mm3.c
@@ -15,7 +15,8 @@
  * Copyright (C) 2018 Blender Foundation.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  *  Functions to compute Murmur3 hash key.
  *
diff --git a/source/blender/blenlib/intern/jitter_2d.c b/source/blender/blenlib/intern/jitter_2d.c
index e1091673d5a..0a1ee08776e 100644
--- a/source/blender/blenlib/intern/jitter_2d.c
+++ b/source/blender/blenlib/intern/jitter_2d.c
@@ -17,8 +17,9 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
- *  \brief Jitter offset table
+/** \file
+ * \ingroup bli
+ * \brief Jitter offset table
  */
 
 #include <math.h>
diff --git a/source/blender/blenlib/intern/lasso_2d.c b/source/blender/blenlib/intern/lasso_2d.c
index 8264d4cc8a2..37d4d6e1d1f 100644
--- a/source/blender/blenlib/intern/lasso_2d.c
+++ b/source/blender/blenlib/intern/lasso_2d.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "DNA_vec_types.h"
diff --git a/source/blender/blenlib/intern/list_sort_impl.h b/source/blender/blenlib/intern/list_sort_impl.h
index 4b5c451e905..3da4c5ccd41 100644
--- a/source/blender/blenlib/intern/list_sort_impl.h
+++ b/source/blender/blenlib/intern/list_sort_impl.h
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Common implementation of linked-list a non-recursive mergesort.
  *
diff --git a/source/blender/blenlib/intern/listbase.c b/source/blender/blenlib/intern/listbase.c
index a7c6b31ca99..5fd75643d60 100644
--- a/source/blender/blenlib/intern/listbase.c
+++ b/source/blender/blenlib/intern/listbase.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Manipulations on double-linked list (#ListBase structs).
  *
diff --git a/source/blender/blenlib/intern/math_base.c b/source/blender/blenlib/intern/math_base.c
index 1806949457e..c4b01729a6d 100644
--- a/source/blender/blenlib/intern/math_base.c
+++ b/source/blender/blenlib/intern/math_base.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_math.h"
diff --git a/source/blender/blenlib/intern/math_base_inline.c b/source/blender/blenlib/intern/math_base_inline.c
index c302766d35c..1ad0dc6a22f 100644
--- a/source/blender/blenlib/intern/math_base_inline.c
+++ b/source/blender/blenlib/intern/math_base_inline.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifndef __MATH_BASE_INLINE_C__
diff --git a/source/blender/blenlib/intern/math_bits_inline.c b/source/blender/blenlib/intern/math_bits_inline.c
index 5e03d941eff..d86b2924e17 100644
--- a/source/blender/blenlib/intern/math_bits_inline.c
+++ b/source/blender/blenlib/intern/math_bits_inline.c
@@ -15,7 +15,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifndef __MATH_BITS_INLINE_C__
diff --git a/source/blender/blenlib/intern/math_color.c b/source/blender/blenlib/intern/math_color.c
index 7ac1bf67f46..dbc5ee11663 100644
--- a/source/blender/blenlib/intern/math_color.c
+++ b/source/blender/blenlib/intern/math_color.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <assert.h>
diff --git a/source/blender/blenlib/intern/math_color_blend_inline.c b/source/blender/blenlib/intern/math_color_blend_inline.c
index 21df1036905..f3e6ff8b110 100644
--- a/source/blender/blenlib/intern/math_color_blend_inline.c
+++ b/source/blender/blenlib/intern/math_color_blend_inline.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_math_base.h"
diff --git a/source/blender/blenlib/intern/math_color_inline.c b/source/blender/blenlib/intern/math_color_inline.c
index 12985142b13..5396f3a47f6 100644
--- a/source/blender/blenlib/intern/math_color_inline.c
+++ b/source/blender/blenlib/intern/math_color_inline.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/math_geom.c b/source/blender/blenlib/intern/math_geom.c
index 0b861a1b47a..a513aca8e46 100644
--- a/source/blender/blenlib/intern/math_geom.c
+++ b/source/blender/blenlib/intern/math_geom.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "MEM_guardedalloc.h"
diff --git a/source/blender/blenlib/intern/math_geom_inline.c b/source/blender/blenlib/intern/math_geom_inline.c
index 424edc4d466..58262b9a364 100644
--- a/source/blender/blenlib/intern/math_geom_inline.c
+++ b/source/blender/blenlib/intern/math_geom_inline.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifndef __MATH_GEOM_INLINE_C__
diff --git a/source/blender/blenlib/intern/math_interp.c b/source/blender/blenlib/intern/math_interp.c
index c2caa7bb582..5b3f6349703 100644
--- a/source/blender/blenlib/intern/math_interp.c
+++ b/source/blender/blenlib/intern/math_interp.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <math.h>
diff --git a/source/blender/blenlib/intern/math_matrix.c b/source/blender/blenlib/intern/math_matrix.c
index fff3db8a374..747d9a1337a 100644
--- a/source/blender/blenlib/intern/math_matrix.c
+++ b/source/blender/blenlib/intern/math_matrix.c
@@ -19,7 +19,8 @@
  * The Original Code is: some of this file.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/math_rotation.c b/source/blender/blenlib/intern/math_rotation.c
index f235e32b8d2..c8d4ce9690b 100644
--- a/source/blender/blenlib/intern/math_rotation.c
+++ b/source/blender/blenlib/intern/math_rotation.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <assert.h>
diff --git a/source/blender/blenlib/intern/math_solvers.c b/source/blender/blenlib/intern/math_solvers.c
index 8aa307a8247..efaa98fc4e7 100644
--- a/source/blender/blenlib/intern/math_solvers.c
+++ b/source/blender/blenlib/intern/math_solvers.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "MEM_guardedalloc.h"
diff --git a/source/blender/blenlib/intern/math_statistics.c b/source/blender/blenlib/intern/math_statistics.c
index 0dede9ec872..4ad01812474 100644
--- a/source/blender/blenlib/intern/math_statistics.c
+++ b/source/blender/blenlib/intern/math_statistics.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "MEM_guardedalloc.h"
diff --git a/source/blender/blenlib/intern/math_vector.c b/source/blender/blenlib/intern/math_vector.c
index acc20c3f614..bf4cd702ea1 100644
--- a/source/blender/blenlib/intern/math_vector.c
+++ b/source/blender/blenlib/intern/math_vector.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_math.h"
@@ -754,7 +755,7 @@ void bisect_v3_v3v3v3(float out[3], const float v1[3], const float v2[3], const
  * <pre>
  * v
  * +  ^
- *  \ |
+ * \ |
  *   \|
  *    + normal: axis of reflection
  *   /
diff --git a/source/blender/blenlib/intern/math_vector_inline.c b/source/blender/blenlib/intern/math_vector_inline.c
index b6af35c725d..80bdeec5949 100644
--- a/source/blender/blenlib/intern/math_vector_inline.c
+++ b/source/blender/blenlib/intern/math_vector_inline.c
@@ -20,7 +20,8 @@
  *
  * */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #ifndef __MATH_VECTOR_INLINE_C__
diff --git a/source/blender/blenlib/intern/memory_utils.c b/source/blender/blenlib/intern/memory_utils.c
index c31e12044bc..b0cfe709be8 100644
--- a/source/blender/blenlib/intern/memory_utils.c
+++ b/source/blender/blenlib/intern/memory_utils.c
@@ -14,8 +14,9 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
- *  \brief Generic memory manipulation API.
+/** \file
+ * \ingroup bli
+ * \brief Generic memory manipulation API.
  *
  * This is to extend on existing functions
  * such as ``memcpy`` & ``memcmp``.
diff --git a/source/blender/blenlib/intern/noise.c b/source/blender/blenlib/intern/noise.c
index 38c9f8acef4..1db3040e3db 100644
--- a/source/blender/blenlib/intern/noise.c
+++ b/source/blender/blenlib/intern/noise.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <math.h>
diff --git a/source/blender/blenlib/intern/path_util.c b/source/blender/blenlib/intern/path_util.c
index a80b4ea9263..77b137a9d6d 100644
--- a/source/blender/blenlib/intern/path_util.c
+++ b/source/blender/blenlib/intern/path_util.c
@@ -18,7 +18,8 @@
  * various string, file, list operations.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <ctype.h>
diff --git a/source/blender/blenlib/intern/polyfill_2d.c b/source/blender/blenlib/intern/polyfill_2d.c
index d5a379466f8..5867cdee8bc 100644
--- a/source/blender/blenlib/intern/polyfill_2d.c
+++ b/source/blender/blenlib/intern/polyfill_2d.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * An ear clipping algorithm to triangulate single boundary polygons.
  *
diff --git a/source/blender/blenlib/intern/polyfill_2d_beautify.c b/source/blender/blenlib/intern/polyfill_2d_beautify.c
index eb6d3c676d4..17af81af866 100644
--- a/source/blender/blenlib/intern/polyfill_2d_beautify.c
+++ b/source/blender/blenlib/intern/polyfill_2d_beautify.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * This function is to improve the tessellation resulting from polyfill2d,
  * creating optimal topology.
diff --git a/source/blender/blenlib/intern/quadric.c b/source/blender/blenlib/intern/quadric.c
index 1612b741501..8d5998786f4 100644
--- a/source/blender/blenlib/intern/quadric.c
+++ b/source/blender/blenlib/intern/quadric.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * \note This isn't fully complete,
  * possible there are other useful functions to add here.
diff --git a/source/blender/blenlib/intern/rand.c b/source/blender/blenlib/intern/rand.c
index 2a60d31cd7c..262ae67a5f7 100644
--- a/source/blender/blenlib/intern/rand.c
+++ b/source/blender/blenlib/intern/rand.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/rct.c b/source/blender/blenlib/intern/rct.c
index 70b91406d4e..9b26ad24230 100644
--- a/source/blender/blenlib/intern/rct.c
+++ b/source/blender/blenlib/intern/rct.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * A minimalist lib for functions doing stuff with rectangle structs.
  */
diff --git a/source/blender/blenlib/intern/scanfill.c b/source/blender/blenlib/intern/scanfill.c
index fad14499e52..12e1425837e 100644
--- a/source/blender/blenlib/intern/scanfill.c
+++ b/source/blender/blenlib/intern/scanfill.c
@@ -18,7 +18,8 @@
  * (uit traces) maart 95
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Triangulate multiple 2D/3D polygon with support for holes,
  * use for tessellating curves, fonts and geometry.
diff --git a/source/blender/blenlib/intern/scanfill_utils.c b/source/blender/blenlib/intern/scanfill_utils.c
index 5c805df14c9..f0107908787 100644
--- a/source/blender/blenlib/intern/scanfill_utils.c
+++ b/source/blender/blenlib/intern/scanfill_utils.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdio.h>
diff --git a/source/blender/blenlib/intern/smallhash.c b/source/blender/blenlib/intern/smallhash.c
index 9c4f60322e6..142f0a991c8 100644
--- a/source/blender/blenlib/intern/smallhash.c
+++ b/source/blender/blenlib/intern/smallhash.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * A light stack-friendly hash library, it uses stack space for relatively small, fixed size hash tables
  * but falls back to heap memory once the stack limits reached (#SMSTACKSIZE).
diff --git a/source/blender/blenlib/intern/sort.c b/source/blender/blenlib/intern/sort.c
index 6c848d75312..af206975e16 100644
--- a/source/blender/blenlib/intern/sort.c
+++ b/source/blender/blenlib/intern/sort.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdlib.h>
diff --git a/source/blender/blenlib/intern/sort_utils.c b/source/blender/blenlib/intern/sort_utils.c
index 674a0e0d8b2..7166b7753aa 100644
--- a/source/blender/blenlib/intern/sort_utils.c
+++ b/source/blender/blenlib/intern/sort_utils.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Utility functions for sorting common types.
  */
diff --git a/source/blender/blenlib/intern/stack.c b/source/blender/blenlib/intern/stack.c
index 8e0e5d7aee0..4f6f9024fa5 100644
--- a/source/blender/blenlib/intern/stack.c
+++ b/source/blender/blenlib/intern/stack.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <string.h>
diff --git a/source/blender/blenlib/intern/storage.c b/source/blender/blenlib/intern/storage.c
index 663aaee1924..4fb519e7f26 100644
--- a/source/blender/blenlib/intern/storage.c
+++ b/source/blender/blenlib/intern/storage.c
@@ -19,7 +19,8 @@
  * Some really low-level file thingies.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <sys/types.h>
diff --git a/source/blender/blenlib/intern/string.c b/source/blender/blenlib/intern/string.c
index c6deaf5abab..dbec1a3153c 100644
--- a/source/blender/blenlib/intern/string.c
+++ b/source/blender/blenlib/intern/string.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/string_cursor_utf8.c b/source/blender/blenlib/intern/string_cursor_utf8.c
index c0dd115266c..8048ebe7052 100644
--- a/source/blender/blenlib/intern/string_cursor_utf8.c
+++ b/source/blender/blenlib/intern/string_cursor_utf8.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdio.h>
diff --git a/source/blender/blenlib/intern/string_utf8.c b/source/blender/blenlib/intern/string_utf8.c
index 03367a96696..d4b4bba810c 100644
--- a/source/blender/blenlib/intern/string_utf8.c
+++ b/source/blender/blenlib/intern/string_utf8.c
@@ -19,7 +19,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <string.h>
diff --git a/source/blender/blenlib/intern/string_utils.c b/source/blender/blenlib/intern/string_utils.c
index e9d31f5e534..3e13b0d3a31 100644
--- a/source/blender/blenlib/intern/string_utils.c
+++ b/source/blender/blenlib/intern/string_utils.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <ctype.h>
diff --git a/source/blender/blenlib/intern/system.c b/source/blender/blenlib/intern/system.c
index 7cb987c0bbd..2b0dfd045ca 100644
--- a/source/blender/blenlib/intern/system.c
+++ b/source/blender/blenlib/intern/system.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdio.h>
diff --git a/source/blender/blenlib/intern/task.c b/source/blender/blenlib/intern/task.c
index c6488c9e935..84e89bdec91 100644
--- a/source/blender/blenlib/intern/task.c
+++ b/source/blender/blenlib/intern/task.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * A generic task system which can be used for any task based subsystem.
  */
diff --git a/source/blender/blenlib/intern/threads.c b/source/blender/blenlib/intern/threads.c
index 8a9e9f1a1eb..341b97edbf6 100644
--- a/source/blender/blenlib/intern/threads.c
+++ b/source/blender/blenlib/intern/threads.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <stdlib.h>
diff --git a/source/blender/blenlib/intern/time.c b/source/blender/blenlib/intern/time.c
index 548f79b45f2..ee90e74ea52 100644
--- a/source/blender/blenlib/intern/time.c
+++ b/source/blender/blenlib/intern/time.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/timecode.c b/source/blender/blenlib/intern/timecode.c
index 47ebe38a2c4..d87f1037254 100644
--- a/source/blender/blenlib/intern/timecode.c
+++ b/source/blender/blenlib/intern/timecode.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup blendlib
+/** \file
+ * \ingroup blendlib
  *
  * Time-Code string formatting
  */
diff --git a/source/blender/blenlib/intern/uvproject.c b/source/blender/blenlib/intern/uvproject.c
index 3690155555a..5ba295cb997 100644
--- a/source/blender/blenlib/intern/uvproject.c
+++ b/source/blender/blenlib/intern/uvproject.c
@@ -14,7 +14,8 @@
  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include <math.h>
diff --git a/source/blender/blenlib/intern/voronoi_2d.c b/source/blender/blenlib/intern/voronoi_2d.c
index 3dbda959dd6..cf502a33774 100644
--- a/source/blender/blenlib/intern/voronoi_2d.c
+++ b/source/blender/blenlib/intern/voronoi_2d.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Fortune's algorithm implemented using explanation and some code snippets from
  * http://blog.ivank.net/fortunes-algorithm-and-implementation.html
diff --git a/source/blender/blenlib/intern/voxel.c b/source/blender/blenlib/intern/voxel.c
index d926309219f..fbd6fb74ab5 100644
--- a/source/blender/blenlib/intern/voxel.c
+++ b/source/blender/blenlib/intern/voxel.c
@@ -17,7 +17,8 @@
  * All rights reserved.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 #include "BLI_utildefines.h"
diff --git a/source/blender/blenlib/intern/winstuff.c b/source/blender/blenlib/intern/winstuff.c
index e9b276514af..fb16ccb36bd 100644
--- a/source/blender/blenlib/intern/winstuff.c
+++ b/source/blender/blenlib/intern/winstuff.c
@@ -18,7 +18,8 @@
  * Windows-posix compatibility layer, windows-specific functions.
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  */
 
 
diff --git a/source/blender/blenlib/intern/winstuff_dir.c b/source/blender/blenlib/intern/winstuff_dir.c
index fd6322083b7..0b3cf07883d 100644
--- a/source/blender/blenlib/intern/winstuff_dir.c
+++ b/source/blender/blenlib/intern/winstuff_dir.c
@@ -15,7 +15,8 @@
  * Windows-posix compatibility layer for opendir/readdir/closedir
  */
 
-/** \file \ingroup bli
+/** \file
+ * \ingroup bli
  *
  * Posix compatibility functions for windows dealing with DIR
  * (opendir, readdir, closedir)
-- 
cgit v1.2.3