Cleanup: remove redundant doxygen \file argument

Move \ingroup onto same line to be more compact and make it clear the file is in the group.
2019-02-06 15:42:22 +11:00
parent 1085c2cc44
commit eef4077f18
2945 changed files with 2947 additions and 5892 deletions
--- a/source/blender/python/BPY_extern.h
+++ b/source/blender/python/BPY_extern.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file BPY_extern.h
- *  \ingroup python
+/** \file \ingroup python
 */


--- a/source/blender/python/BPY_extern_clog.h
+++ b/source/blender/python/BPY_extern_clog.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file BPY_extern_clog.h
- *  \ingroup python
+/** \file \ingroup python
 *
 * Logging defines.
 */
--- a/source/blender/python/bmesh/bmesh_py_api.c
+++ b/source/blender/python/bmesh/bmesh_py_api.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_api.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 *
 * This file defines the 'bmesh' module.
 */
--- a/source/blender/python/bmesh/bmesh_py_api.h
+++ b/source/blender/python/bmesh/bmesh_py_api.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_api.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_API_H__
--- a/source/blender/python/bmesh/bmesh_py_geometry.c
+++ b/source/blender/python/bmesh/bmesh_py_geometry.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_geometry.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 *
 * This file defines the 'bmesh.geometry' module.
 * Utility functions for operating on 'bmesh.types'
--- a/source/blender/python/bmesh/bmesh_py_geometry.h
+++ b/source/blender/python/bmesh/bmesh_py_geometry.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_geometry.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_GEOMETRY_H__
--- a/source/blender/python/bmesh/bmesh_py_ops.c
+++ b/source/blender/python/bmesh/bmesh_py_ops.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_ops.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 *
 * This file defines the 'bmesh.ops' module.
 * Operators from 'opdefines' are wrapped.
--- a/source/blender/python/bmesh/bmesh_py_ops.h
+++ b/source/blender/python/bmesh/bmesh_py_ops.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_ops.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_OPS_H__
--- a/source/blender/python/bmesh/bmesh_py_ops_call.c
+++ b/source/blender/python/bmesh/bmesh_py_ops_call.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_ops_call.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 *
 * This file provides __call__ aka BPy_BMO_call for
 * the bmesh operator and has been given its own file
--- a/source/blender/python/bmesh/bmesh_py_ops_call.h
+++ b/source/blender/python/bmesh/bmesh_py_ops_call.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_ops_call.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_OPS_CALL_H__
--- a/source/blender/python/bmesh/bmesh_py_types.c
+++ b/source/blender/python/bmesh/bmesh_py_types.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_types.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #include "BLI_math.h"
--- a/source/blender/python/bmesh/bmesh_py_types.h
+++ b/source/blender/python/bmesh/bmesh_py_types.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_types.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_TYPES_H__
--- a/source/blender/python/bmesh/bmesh_py_types_customdata.c
+++ b/source/blender/python/bmesh/bmesh_py_types_customdata.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_types_customdata.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 *
 * This file defines the types for 'BMesh.verts/edges/faces/loops.layers'
 * customdata layer access.
--- a/source/blender/python/bmesh/bmesh_py_types_customdata.h
+++ b/source/blender/python/bmesh/bmesh_py_types_customdata.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_types_customdata.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_TYPES_CUSTOMDATA_H__
--- a/source/blender/python/bmesh/bmesh_py_types_meshdata.c
+++ b/source/blender/python/bmesh/bmesh_py_types_meshdata.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_types_meshdata.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 *
 * This file defines customdata types which can't be accessed as primitive
 * python types such as MDeformVert, MLoopUV, MTexPoly
--- a/source/blender/python/bmesh/bmesh_py_types_meshdata.h
+++ b/source/blender/python/bmesh/bmesh_py_types_meshdata.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_types_meshdata.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_TYPES_MESHDATA_H__
--- a/source/blender/python/bmesh/bmesh_py_types_select.c
+++ b/source/blender/python/bmesh/bmesh_py_types_select.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_types_select.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 *
 * This file defines the types for 'BMesh.select_history'
 * sequence and iterator.
--- a/source/blender/python/bmesh/bmesh_py_types_select.h
+++ b/source/blender/python/bmesh/bmesh_py_types_select.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_types_select.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_TYPES_SELECT_H__
--- a/source/blender/python/bmesh/bmesh_py_utils.c
+++ b/source/blender/python/bmesh/bmesh_py_utils.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_utils.c
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 *
 * This file defines the 'bmesh.utils' module.
 * Utility functions for operating on 'bmesh.types'
--- a/source/blender/python/bmesh/bmesh_py_utils.h
+++ b/source/blender/python/bmesh/bmesh_py_utils.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/bmesh/bmesh_py_utils.h
- *  \ingroup pybmesh
+/** \file \ingroup pybmesh
 */

 #ifndef __BMESH_PY_UTILS_H__
--- a/source/blender/python/generic/bgl.c
+++ b/source/blender/python/generic/bgl.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/bgl.c
- *  \ingroup pygen
+/** \file \ingroup pygen
 *
 * This file is the 'bgl' module which wraps OpenGL functions and constants,
 * allowing script writers to make OpenGL calls in their Python scripts.
--- a/source/blender/python/generic/bgl.h
+++ b/source/blender/python/generic/bgl.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/bgl.h
- *  \ingroup pygen
+/** \file \ingroup pygen
 */

 #ifndef __BGL_H__
--- a/source/blender/python/generic/blf_py_api.c
+++ b/source/blender/python/generic/blf_py_api.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/blf_py_api.c
- *  \ingroup pygen
+/** \file \ingroup pygen
 *
 * This file defines the 'bgl' module, used for drawing text in OpenGL.
 */
--- a/source/blender/python/generic/blf_py_api.h
+++ b/source/blender/python/generic/blf_py_api.h
@@ -17,8 +17,7 @@
 #ifndef __BLF_PY_API_H__
 #define __BLF_PY_API_H__

-/** \file blender/python/generic/blf_py_api.h
- *  \ingroup pygen
+/** \file \ingroup pygen
 */

 PyObject *BPyInit_blf(void);
--- a/source/blender/python/generic/bpy_internal_import.c
+++ b/source/blender/python/generic/bpy_internal_import.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/bpy_internal_import.c
- *  \ingroup pygen
+/** \file \ingroup pygen
 *
 * This file defines replacements for pythons '__import__' and 'imp.reload'
 * functions which can import from blender textblocks.
--- a/source/blender/python/generic/bpy_internal_import.h
+++ b/source/blender/python/generic/bpy_internal_import.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/bpy_internal_import.h
- *  \ingroup pygen
+/** \file \ingroup pygen
 */


--- a/source/blender/python/generic/bpy_threads.c
+++ b/source/blender/python/generic/bpy_threads.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/bpy_threads.c
- *  \ingroup pygen
+/** \file \ingroup pygen
 *
 * This file contains wrapper functions related to global interpreter lock.
 * these functions are slightly different from the original Python API,
--- a/source/blender/python/generic/idprop_py_api.c
+++ b/source/blender/python/generic/idprop_py_api.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/idprop_py_api.c
- *  \ingroup pygen
+/** \file \ingroup pygen
 */

 #include <Python.h>
--- a/source/blender/python/generic/idprop_py_api.h
+++ b/source/blender/python/generic/idprop_py_api.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/idprop_py_api.h
- *  \ingroup pygen
+/** \file \ingroup pygen
 */


--- a/source/blender/python/generic/imbuf_py_api.c
+++ b/source/blender/python/generic/imbuf_py_api.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/imbuf_py_api.c
- *  \ingroup pygen
+/** \file \ingroup pygen
 *
 * This file defines the 'imbuf' image manipulation module.
 */
--- a/source/blender/python/generic/imbuf_py_api.h
+++ b/source/blender/python/generic/imbuf_py_api.h
@@ -17,8 +17,7 @@
 #ifndef __IMBUF_PY_API_H__
 #define __IMBUF_PY_API_H__

-/** \file blender/python/generic/imbuf_py_api.h
- *  \ingroup pygen
+/** \file \ingroup pygen
 */

 PyObject *BPyInit_imbuf(void);
--- a/source/blender/python/generic/py_capi_utils.c
+++ b/source/blender/python/generic/py_capi_utils.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/py_capi_utils.c
- *  \ingroup pygen
+/** \file \ingroup pygen
 *
 * Extend upon CPython's API, filling in some gaps, these functions use PyC_
 * prefix to distinguish them apart from CPython.
--- a/source/blender/python/generic/py_capi_utils.h
+++ b/source/blender/python/generic/py_capi_utils.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/py_capi_utils.h
- *  \ingroup pygen
+/** \file \ingroup pygen
 */

 #ifndef __PY_CAPI_UTILS_H__
--- a/source/blender/python/generic/python_utildefines.h
+++ b/source/blender/python/generic/python_utildefines.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/generic/python_utildefines.h
- *  \ingroup pygen
+/** \file \ingroup pygen
 *  \brief header-only utilities
 *  \note light addition to Python.h, use py_capi_utils.h for larger features.
 */
--- a/source/blender/python/gpu/gpu_py_api.c
+++ b/source/blender/python/gpu/gpu_py_api.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_api.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * Experimental Python API, not considered public yet (called '_gpu'),
 * we may re-expose as public later.
--- a/source/blender/python/gpu/gpu_py_api.h
+++ b/source/blender/python/gpu/gpu_py_api.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_api.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_API_H__
--- a/source/blender/python/gpu/gpu_py_batch.c
+++ b/source/blender/python/gpu/gpu_py_batch.c
@@ -16,8 +16,7 @@
 * Copyright 2015, Blender Foundation.
 */

-/** \file blender/python/gpu/gpu_py_batch.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * This file defines the offscreen functionalities of the 'gpu' module
 * used for off-screen OpenGL rendering.
--- a/source/blender/python/gpu/gpu_py_batch.h
+++ b/source/blender/python/gpu/gpu_py_batch.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_batch.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_BATCH_H__
--- a/source/blender/python/gpu/gpu_py_element.c
+++ b/source/blender/python/gpu/gpu_py_element.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_element.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * - Use ``bpygpu_`` for local API.
 * - Use ``BPyGPU`` for public API.
--- a/source/blender/python/gpu/gpu_py_element.h
+++ b/source/blender/python/gpu/gpu_py_element.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_element.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_ELEMENT_H__
--- a/source/blender/python/gpu/gpu_py_matrix.c
+++ b/source/blender/python/gpu/gpu_py_matrix.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_matrix.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * This file defines the gpu.matrix stack API.
 *
--- a/source/blender/python/gpu/gpu_py_matrix.h
+++ b/source/blender/python/gpu/gpu_py_matrix.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_matrix.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_MATRIX_H__
--- a/source/blender/python/gpu/gpu_py_offscreen.c
+++ b/source/blender/python/gpu/gpu_py_offscreen.c
@@ -16,8 +16,7 @@
 * Copyright 2015, Blender Foundation.
 */

-/** \file blender/python/gpu/gpu_py_offscreen.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * This file defines the offscreen functionalities of the 'gpu' module
 * used for off-screen OpenGL rendering.
--- a/source/blender/python/gpu/gpu_py_offscreen.h
+++ b/source/blender/python/gpu/gpu_py_offscreen.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_offscreen.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_OFFSCREEN_H__
--- a/source/blender/python/gpu/gpu_py_select.c
+++ b/source/blender/python/gpu/gpu_py_select.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_select.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * This file defines the gpu.select API.
 *
--- a/source/blender/python/gpu/gpu_py_select.h
+++ b/source/blender/python/gpu/gpu_py_select.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_select.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_SELECT_H__
--- a/source/blender/python/gpu/gpu_py_shader.c
+++ b/source/blender/python/gpu/gpu_py_shader.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_shader.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * - Use ``bpygpu_`` for local API.
 * - Use ``BPyGPU`` for public API.
--- a/source/blender/python/gpu/gpu_py_shader.h
+++ b/source/blender/python/gpu/gpu_py_shader.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_shader.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_SHADER_H__
--- a/source/blender/python/gpu/gpu_py_types.c
+++ b/source/blender/python/gpu/gpu_py_types.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_types.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * - Use ``bpygpu_`` for local API.
 * - Use ``BPyGPU`` for public API.
--- a/source/blender/python/gpu/gpu_py_types.h
+++ b/source/blender/python/gpu/gpu_py_types.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_types.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_TYPES_H__
--- a/source/blender/python/gpu/gpu_py_vertex_buffer.c
+++ b/source/blender/python/gpu/gpu_py_vertex_buffer.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_vertex_buffer.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * - Use ``bpygpu_`` for local API.
 * - Use ``BPyGPU`` for public API.
--- a/source/blender/python/gpu/gpu_py_vertex_buffer.h
+++ b/source/blender/python/gpu/gpu_py_vertex_buffer.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_vertex_buffer.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_VERTEX_BUFFER_H__
--- a/source/blender/python/gpu/gpu_py_vertex_format.c
+++ b/source/blender/python/gpu/gpu_py_vertex_format.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_vertex_format.c
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 *
 * - Use ``bpygpu_`` for local API.
 * - Use ``BPyGPU`` for public API.
--- a/source/blender/python/gpu/gpu_py_vertex_format.h
+++ b/source/blender/python/gpu/gpu_py_vertex_format.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/gpu/gpu_py_vertex_format.h
- *  \ingroup bpygpu
+/** \file \ingroup bpygpu
 */

 #ifndef __GPU_PY_VERTEX_FORMAT_H__
--- a/source/blender/python/intern/bpy.c
+++ b/source/blender/python/intern/bpy.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file defines the '_bpy' module which is used by python's 'bpy' package
 * to access C defined builtin functions.
--- a/source/blender/python/intern/bpy.h
+++ b/source/blender/python/intern/bpy.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_H__
--- a/source/blender/python/intern/bpy_app.c
+++ b/source/blender/python/intern/bpy_app.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file defines a 'PyStructSequence' accessed via 'bpy.app', mostly
 * exposing static applications variables such as version and buildinfo
--- a/source/blender/python/intern/bpy_app.h
+++ b/source/blender/python/intern/bpy_app.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_H__
--- a/source/blender/python/intern/bpy_app_alembic.c
+++ b/source/blender/python/intern/bpy_app_alembic.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/intern/bpy_app_alembic.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_alembic.h
+++ b/source/blender/python/intern/bpy_app_alembic.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/intern/bpy_app_alembic.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_ALEMBIC_H__
--- a/source/blender/python/intern/bpy_app_build_options.c
+++ b/source/blender/python/intern/bpy_app_build_options.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_build_options.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_build_options.h
+++ b/source/blender/python/intern/bpy_app_build_options.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_build_options.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_BUILD_OPTIONS_H__
--- a/source/blender/python/intern/bpy_app_ffmpeg.c
+++ b/source/blender/python/intern/bpy_app_ffmpeg.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_ffmpeg.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_ffmpeg.h
+++ b/source/blender/python/intern/bpy_app_ffmpeg.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_ffmpeg.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_FFMPEG_H__
--- a/source/blender/python/intern/bpy_app_handlers.c
+++ b/source/blender/python/intern/bpy_app_handlers.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_handlers.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file defines a 'PyStructSequence' accessed via 'bpy.app.handlers',
 * which exposes various lists that the script author can add callback
--- a/source/blender/python/intern/bpy_app_handlers.h
+++ b/source/blender/python/intern/bpy_app_handlers.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_handlers.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_HANDLERS_H__
--- a/source/blender/python/intern/bpy_app_icons.c
+++ b/source/blender/python/intern/bpy_app_icons.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_icons.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * Runtime defined icons.
 */
--- a/source/blender/python/intern/bpy_app_icons.h
+++ b/source/blender/python/intern/bpy_app_icons.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_icons.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_ICONS_H__
--- a/source/blender/python/intern/bpy_app_ocio.c
+++ b/source/blender/python/intern/bpy_app_ocio.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_ocio.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_ocio.h
+++ b/source/blender/python/intern/bpy_app_ocio.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_ocio.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_OCIO_H__
--- a/source/blender/python/intern/bpy_app_oiio.c
+++ b/source/blender/python/intern/bpy_app_oiio.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_oiio.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_oiio.h
+++ b/source/blender/python/intern/bpy_app_oiio.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_oiio.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_OIIO_H__
--- a/source/blender/python/intern/bpy_app_opensubdiv.c
+++ b/source/blender/python/intern/bpy_app_opensubdiv.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_opensubdiv.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_opensubdiv.h
+++ b/source/blender/python/intern/bpy_app_opensubdiv.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_opensubdiv.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_OPENSUBDIV_H__
--- a/source/blender/python/intern/bpy_app_openvdb.c
+++ b/source/blender/python/intern/bpy_app_openvdb.c
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/intern/bpy_app_openvdb.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_openvdb.h
+++ b/source/blender/python/intern/bpy_app_openvdb.h
@@ -17,8 +17,7 @@
 * All rights reserved.
 */

-/** \file blender/python/intern/bpy_app_openvdb.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_OPENVDB_H__
--- a/source/blender/python/intern/bpy_app_sdl.c
+++ b/source/blender/python/intern/bpy_app_sdl.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_sdl.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_sdl.h
+++ b/source/blender/python/intern/bpy_app_sdl.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_sdl.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_SDL_H__
--- a/source/blender/python/intern/bpy_app_timers.c
+++ b/source/blender/python/intern/bpy_app_timers.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_timers.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #include <Python.h>
--- a/source/blender/python/intern/bpy_app_timers.h
+++ b/source/blender/python/intern/bpy_app_timers.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_timers.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_TIMERS_H__
--- a/source/blender/python/intern/bpy_app_translations.c
+++ b/source/blender/python/intern/bpy_app_translations.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_translations.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file defines a singleton py object accessed via 'bpy.app.translations',
 * which exposes various data and functions useful in i18n work.
--- a/source/blender/python/intern/bpy_app_translations.h
+++ b/source/blender/python/intern/bpy_app_translations.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_app_translations.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_APP_TRANSLATIONS_H__
--- a/source/blender/python/intern/bpy_capi_utils.c
+++ b/source/blender/python/intern/bpy_capi_utils.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_capi_utils.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file contains Blender/Python utility functions to help implementing API's.
 * This is not related to a particular module.
--- a/source/blender/python/intern/bpy_capi_utils.h
+++ b/source/blender/python/intern/bpy_capi_utils.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_capi_utils.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_CAPI_UTILS_H__
--- a/source/blender/python/intern/bpy_driver.c
+++ b/source/blender/python/intern/bpy_driver.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_driver.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file defines the 'BPY_driver_exec' to execute python driver expressions,
 * called by the animation system, there are also some utility functions
--- a/source/blender/python/intern/bpy_driver.h
+++ b/source/blender/python/intern/bpy_driver.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_driver.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_DRIVER_H__
--- a/source/blender/python/intern/bpy_gizmo_wrap.c
+++ b/source/blender/python/intern/bpy_gizmo_wrap.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_gizmo_wrap.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file is so Python can define widget-group's that C can call into.
 * The generic callback functions for Python widget-group are defines in
--- a/source/blender/python/intern/bpy_gizmo_wrap.h
+++ b/source/blender/python/intern/bpy_gizmo_wrap.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_gizmo_wrap.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_GIZMO_WRAP_H__
--- a/source/blender/python/intern/bpy_interface.c
+++ b/source/blender/python/intern/bpy_interface.c
@@ -16,8 +16,7 @@
 * Chris Keith, Chris Want, Ken Hughes, Campbell Barton
 */

-/** \file blender/python/intern/bpy_interface.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file deals with embedding the python interpreter within blender,
 * starting and stopping python and exposing blender/python modules so they can
--- a/source/blender/python/intern/bpy_interface_atexit.c
+++ b/source/blender/python/intern/bpy_interface_atexit.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_interface_atexit.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file inserts an exit callback into pythons 'atexit' module.
 * Without this sys.exit() can crash because blender is not properly closing
--- a/source/blender/python/intern/bpy_intern_string.c
+++ b/source/blender/python/intern/bpy_intern_string.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_intern_string.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * Store python versions of strings frequently used for python lookups
 * to avoid converting, creating the hash and freeing every time as
--- a/source/blender/python/intern/bpy_intern_string.h
+++ b/source/blender/python/intern/bpy_intern_string.h
@@ -17,8 +17,7 @@
 #ifndef __BPY_INTERN_STRING_H__
 #define __BPY_INTERN_STRING_H__

-/** \file blender/python/intern/bpy_intern_string.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 void bpy_intern_string_init(void);
--- a/source/blender/python/intern/bpy_library.h
+++ b/source/blender/python/intern/bpy_library.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_library.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_LIBRARY_H__
--- a/source/blender/python/intern/bpy_library_load.c
+++ b/source/blender/python/intern/bpy_library_load.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_library_load.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file exposed blend file library appending/linking to python, typically
 * this would be done via RNA api but in this case a hand written python api
--- a/source/blender/python/intern/bpy_library_write.c
+++ b/source/blender/python/intern/bpy_library_write.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_library_write.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * Python API for writing a set of data-blocks into a file.
 * Useful for writing out asset-libraries, defines: `bpy.data.libraries.write(...)`.
--- a/source/blender/python/intern/bpy_msgbus.c
+++ b/source/blender/python/intern/bpy_msgbus.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_msgbus.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 * This file defines '_bpy_msgbus' module, exposed as 'bpy.msgbus'.
 */

--- a/source/blender/python/intern/bpy_msgbus.h
+++ b/source/blender/python/intern/bpy_msgbus.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_msgbus.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_MSGBUS_H__
--- a/source/blender/python/intern/bpy_operator.c
+++ b/source/blender/python/intern/bpy_operator.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_operator.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file defines '_bpy.ops', an internal python module which gives python
 * the ability to inspect and call both C and Python defined operators.
--- a/source/blender/python/intern/bpy_operator.h
+++ b/source/blender/python/intern/bpy_operator.h
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_operator.h
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 */

 #ifndef __BPY_OPERATOR_H__
--- a/source/blender/python/intern/bpy_operator_wrap.c
+++ b/source/blender/python/intern/bpy_operator_wrap.c
@@ -14,8 +14,7 @@
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 */

-/** \file blender/python/intern/bpy_operator_wrap.c
- *  \ingroup pythonintern
+/** \file \ingroup pythonintern
 *
 * This file is so python can define operators that C can call into.
 * The generic callback functions for python operators are defines in
--- a/Show More
+++ b/Show More