From 5d30c23c35aafba3a9bc772b4e66dd70b1ed84de Mon Sep 17 00:00:00 2001 From: Campbell Barton Date: Wed, 20 May 2015 12:54:45 +1000 Subject: doxygen: corrections/updates Also add depsgraph & physics --- doc/doxygen/doxygen.intern.h | 12 ------- doc/doxygen/doxygen.source.h | 40 +++++++++++++--------- .../CollisionDispatch/btCollisionWorld.h | 2 +- intern/ghost/intern/GHOST_SystemX11.h | 8 ----- intern/iksolver/extern/IK_solver.h | 10 +++--- intern/memutil/MEM_CacheLimiter.h | 13 ++++--- intern/memutil/MEM_RefCountPtr.h | 17 +++++---- intern/memutil/MEM_SmartPtr.h | 16 +++++---- source/blender/avi/AVI_avi.h | 7 ++-- source/blender/blenkernel/BKE_mesh.h | 2 +- source/blender/blenkernel/intern/dynamicpaint.c | 15 ++++---- source/blender/blenkernel/intern/mesh_evaluate.c | 11 +++--- source/blender/blenkernel/intern/object_deform.c | 4 +-- source/blender/blenlib/intern/BLI_dynstr.c | 8 ++--- source/blender/blenlib/intern/convexhull2d.c | 2 +- source/blender/blenlib/intern/edgehash.c | 8 ++--- source/blender/blenlib/intern/gsqueue.c | 8 ++--- source/blender/blenlib/intern/string_utf8.c | 10 +++--- source/blender/blenlib/intern/timecode.c | 1 - source/blender/blenloader/BLO_readfile.h | 4 +-- source/blender/blenloader/intern/writefile.c | 2 +- source/blender/bmesh/intern/bmesh_core.c | 2 +- source/blender/bmesh/intern/bmesh_mods.c | 2 +- .../blender/bmesh/tools/bmesh_decimate_collapse.c | 8 ++--- source/blender/bmesh/tools/bmesh_edgenet.c | 1 - source/blender/bmesh/tools/bmesh_edgesplit.c | 1 - source/blender/bmesh/tools/bmesh_wireframe.c | 2 +- source/blender/compositor/COM_compositor.h | 2 +- source/blender/depsgraph/DEG_depsgraph.h | 17 +++++---- source/blender/depsgraph/DEG_depsgraph_build.h | 4 +++ source/blender/depsgraph/DEG_depsgraph_debug.h | 4 +++ source/blender/depsgraph/DEG_depsgraph_query.h | 6 +++- source/blender/depsgraph/intern/depsgraph.cc | 6 +++- source/blender/depsgraph/intern/depsgraph.h | 4 +++ source/blender/depsgraph/intern/depsgraph_build.cc | 6 +++- source/blender/depsgraph/intern/depsgraph_build.h | 4 +++ .../depsgraph/intern/depsgraph_build_nodes.cc | 6 ++-- .../depsgraph/intern/depsgraph_build_relations.cc | 4 +++ source/blender/depsgraph/intern/depsgraph_debug.cc | 4 +++ source/blender/depsgraph/intern/depsgraph_debug.h | 4 +++ source/blender/depsgraph/intern/depsgraph_eval.cc | 6 +++- source/blender/depsgraph/intern/depsgraph_intern.h | 4 +++ source/blender/depsgraph/intern/depsgraph_query.cc | 4 +++ source/blender/depsgraph/intern/depsgraph_queue.cc | 6 +++- source/blender/depsgraph/intern/depsgraph_queue.h | 6 +++- source/blender/depsgraph/intern/depsgraph_tag.cc | 6 +++- .../depsgraph/intern/depsgraph_type_defines.cc | 6 +++- source/blender/depsgraph/intern/depsgraph_types.h | 4 +++ source/blender/depsgraph/intern/depsnode.cc | 4 +++ source/blender/depsgraph/intern/depsnode.h | 4 +++ .../blender/depsgraph/intern/depsnode_component.cc | 4 +++ .../blender/depsgraph/intern/depsnode_component.h | 4 +++ source/blender/depsgraph/intern/depsnode_opcodes.h | 6 +++- .../blender/depsgraph/intern/depsnode_operation.cc | 4 +++ .../blender/depsgraph/intern/depsnode_operation.h | 4 +++ .../blender/depsgraph/util/depsgraph_util_cycle.cc | 6 ++++ .../blender/depsgraph/util/depsgraph_util_cycle.h | 6 ++++ .../depsgraph/util/depsgraph_util_function.h | 6 ++++ .../blender/depsgraph/util/depsgraph_util_hash.h | 6 ++++ source/blender/depsgraph/util/depsgraph_util_map.h | 6 ++++ .../depsgraph/util/depsgraph_util_pchanmap.cc | 4 +++ .../depsgraph/util/depsgraph_util_pchanmap.h | 4 +++ source/blender/depsgraph/util/depsgraph_util_set.h | 6 ++++ .../depsgraph/util/depsgraph_util_transitive.cc | 8 ++++- .../depsgraph/util/depsgraph_util_transitive.h | 6 ++++ source/blender/editors/interface/view2d.c | 8 ++--- source/blender/editors/sculpt_paint/sculpt.c | 3 ++ source/blender/imbuf/IMB_imbuf.h | 6 ++-- source/blender/physics/BPH_mass_spring.h | 4 +++ source/blender/physics/intern/eigen_utils.h | 2 +- source/gameengine/Expressions/PyObjectPlus.cpp | 6 ++-- 71 files changed, 307 insertions(+), 139 deletions(-) diff --git a/doc/doxygen/doxygen.intern.h b/doc/doxygen/doxygen.intern.h index ae8f6ca88e4..2c8ecae0ead 100644 --- a/doc/doxygen/doxygen.intern.h +++ b/doc/doxygen/doxygen.intern.h @@ -10,26 +10,14 @@ * \ingroup intern */ -/** \defgroup boolop boolop - * \ingroup intern - */ - /** \defgroup ctr container * \ingroup intern */ -/** \defgroup decimation decimation - * \ingroup intern - */ - /** \defgroup elbeem elbeem * \ingroup intern */ -/** \defgroup bsp bsp - * \ingroup intern - */ - /** \defgroup iksolver iksolver * \ingroup intern */ diff --git a/doc/doxygen/doxygen.source.h b/doc/doxygen/doxygen.source.h index f27a5a87807..42516b9af6b 100644 --- a/doc/doxygen/doxygen.source.h +++ b/doc/doxygen/doxygen.source.h @@ -93,36 +93,44 @@ /* ================================ */ -/** \defgroup blender blender */ +/** \defgroup blender Blender */ -/** \defgroup blf blenfont +/** \defgroup blf BlenFont * \ingroup blender */ -/** \defgroup bke blenkernel +/** \defgroup bke BlenKernel * \ingroup blender */ -/** \defgroup bli blenlib +/** \defgroup bli BlenLib * \ingroup blender */ -/** \defgroup nodes nodes +/** \defgroup depsgraph Dependency Graph * \ingroup blender */ -/** \defgroup cmpnodes cmpnodes +/** \defgroup bph Physics + * \ingroup blender + */ + +/** \defgroup nodes Nodes + * \ingroup blender + */ + +/** \defgroup cmpnodes Nodes (Compositor) * \ingroup nodes */ -/** \defgroup shdnodes shdnodes +/** \defgroup shdnodes Nodes (Shader) * \ingroup nodes */ -/** \defgroup texnodes texnodes +/** \defgroup texnodes Nodes (Texture) * \ingroup nodes */ -/** \defgroup modifiers modifiers +/** \defgroup modifiers Object Modifiers * \ingroup blender */ @@ -132,29 +140,29 @@ * \ingroup blender */ -/** \defgroup ikplugin ikplugin +/** \defgroup ikplugin IK Plugin * \ingroup blender */ -/** \defgroup DNA sDNA +/** \defgroup DNA Struct DNA (File Format) * \ingroup blender data */ -/** \defgroup RNA RNA +/** \defgroup RNA RNA (Data API) * \ingroup blender data */ -/** \defgroup blenloader .blend read and write functions +/** \defgroup blenloader Blend file IO * \ingroup blender data * \todo check if \ref blo and \ref blenloader groups can be * merged in docs. */ -/** \defgroup quicktime quicktime +/** \defgroup quicktime QuickTime * \ingroup blender /** \defgroup gui GUI */ -/** \defgroup wm windowmanager +/** \defgroup wm Window Manager * \ingroup blender gui */ @@ -324,7 +332,7 @@ * \ingroup externformats */ -/** \defgroup imbuf IMage Buffer +/** \defgroup imbuf Image Buffer (ImBuf) * \ingroup blender */ diff --git a/extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h b/extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h index b3fffdecd98..0ac5563d06e 100644 --- a/extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h +++ b/extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h @@ -15,7 +15,7 @@ subject to the following restrictions: /** - * @mainpage Bullet Documentation + * @page Bullet Documentation * * @section intro_sec Introduction * Bullet is a Collision Detection and Rigid Body Dynamics Library. The Library is Open Source and free for commercial use, under the ZLib license ( http://opensource.org/licenses/zlib-license.php ). diff --git a/intern/ghost/intern/GHOST_SystemX11.h b/intern/ghost/intern/GHOST_SystemX11.h index a5c1329c4c0..6c0784dfbed 100644 --- a/intern/ghost/intern/GHOST_SystemX11.h +++ b/intern/ghost/intern/GHOST_SystemX11.h @@ -156,10 +156,6 @@ public: const GHOST_TEmbedderWindowID parentWindow = 0 ); - /** - * \section Interface Inherited from GHOST_ISystem - */ - /** * Retrieves events from the system and stores them in the queue. * \param waitForEvent Flag to wait for an event (or return immediately). @@ -170,9 +166,6 @@ public: bool waitForEvent ); - /** - * \section Interface Inherited from GHOST_System - */ GHOST_TSuccess getCursorPosition( GHOST_TInt32& x, @@ -206,7 +199,6 @@ public: ) const; /** - * \section Interface Dirty * Flag a window as dirty. This will * generate a GHOST window update event on a call to processEvents() */ diff --git a/intern/iksolver/extern/IK_solver.h b/intern/iksolver/extern/IK_solver.h index 4de9f143e77..55223806d5c 100644 --- a/intern/iksolver/extern/IK_solver.h +++ b/intern/iksolver/extern/IK_solver.h @@ -35,10 +35,10 @@ * Copyright (C) 2001 NaN Technologies B.V. * - * @author Laurence, Brecht - * @mainpage IK - Blender inverse kinematics module. + * \author Laurence, Brecht + * \page IK - Blender inverse kinematics module. * - * @section about About the IK module + * \section about About the IK module * * This module allows you to create segments and form them into * tree. You can then define a goal points that the end of a given @@ -47,7 +47,7 @@ * to get the as near as possible to the goal. This solver uses an * inverse jacobian method to find a solution. * - * @section issues Known issues with this IK solver. + * \section issues Known issues with this IK solver. * * - There is currently no support for joint constraints in the * solver. This is within the realms of possibility - please ask @@ -60,7 +60,7 @@ * Other algorithms exist which are more suitable for real-time * applications, please ask if this functionality is required. * - * @section dependencies Dependencies + * \section dependencies Dependencies * * This module only depends on Moto. */ diff --git a/intern/memutil/MEM_CacheLimiter.h b/intern/memutil/MEM_CacheLimiter.h index 3e8ae7e5a4d..d5a44375885 100644 --- a/intern/memutil/MEM_CacheLimiter.h +++ b/intern/memutil/MEM_CacheLimiter.h @@ -29,20 +29,22 @@ #define __MEM_CACHELIMITER_H__ /** - * @section MEM_CacheLimiter + * \section MEM_CacheLimiter * This class defines a generic memory cache management system * to limit memory usage to a fixed global maximum. * - * Please use the C-API in MEM_CacheLimiterC-Api.h for code written in C. + * \note Please use the C-API in MEM_CacheLimiterC-Api.h for code written in C. * * Usage example: * + * \code{.cpp} * class BigFatImage { * public: * ~BigFatImage() { tell_everyone_we_are_gone(this); } * }; * - * void doit() { + * void doit() + * { * MEM_Cache BigFatImages; * * MEM_Cache_Handle* h = BigFatImages.insert(new BigFatImage); @@ -50,11 +52,12 @@ * BigFatImages.enforce_limits(); * h->ref(); * - * work with image... + * // work with image... * * h->unref(); * - * leave image in cache. + * // leave image in cache. + * \endcode */ #include diff --git a/intern/memutil/MEM_RefCountPtr.h b/intern/memutil/MEM_RefCountPtr.h index da10e689fbf..ea865eadd47 100644 --- a/intern/memutil/MEM_RefCountPtr.h +++ b/intern/memutil/MEM_RefCountPtr.h @@ -30,9 +30,9 @@ */ /** - * @file MEM_RefCountPtr.h + * \file MEM_RefCountPtr.h * Declaration of MEM_RefCounted and MEM_RefCountable classes. - * @author Laurence + * \author Laurence */ #ifndef __MEM_REFCOUNTPTR_H__ @@ -41,7 +41,7 @@ #include // for NULL ! /** - * @section MEM_RefCountable + * \section MEM_RefCountable * This is a base class for reference countable objects. * If you want an object to be shared using a reference * counted system derrivce from this class. All subclasses @@ -50,9 +50,9 @@ * defining a static New() method that returns a ref counted * ptr to a new()ly allocated instance. * - * @section Example subclass - * + * \section Example subclass * + * \code{.cpp} * class MySharedObject : public MEM_RefCountable { * * private : @@ -68,6 +68,7 @@ * * // other member functions * }; + * \endcode * * Alternitively you may first wish to define a fully functional * class and then define a reference counting wrapper for this class. @@ -75,6 +76,8 @@ * counting. * * E.g. + * + * \code{.cpp} * class UsefullClass { * private : * ... @@ -108,7 +111,7 @@ * // mechanism to handle object lifetime. * ~RcUsefullClass(); * }; - * + * \endcode * */ @@ -168,7 +171,7 @@ public : }; /** - * @section MEM_RefCountPtr + * \section MEM_RefCountPtr */ template diff --git a/intern/memutil/MEM_SmartPtr.h b/intern/memutil/MEM_SmartPtr.h index dd19aae9db9..e0d7b81290f 100644 --- a/intern/memutil/MEM_SmartPtr.h +++ b/intern/memutil/MEM_SmartPtr.h @@ -43,7 +43,7 @@ /** - * @section MEM_SmartPtr + * \section MEM_SmartPtr * This class defines a smart pointer similar to that defined in * the Standard Template Library but without the painful get() * semantics to access the internal c style pointer. @@ -58,8 +58,9 @@ * should not be shared. This is not reliably enforceable in C++ * but this class attempts to make the 1-1 relationship clear. * - * @section Example usage + * \section Example usage * + * \code{.cpp} * class foo { * ...constructors accessors etc. * int x[1000]; @@ -86,18 +87,21 @@ * private : * MEM_SmartPtr m_foo; * } + * \endcode * * You may also safely construct vectors of MEM_SmartPtrs and * have the vector own stuff you put into it. * * e.g. + * \code{.cpp} * { - * std::vector > foo_vector; - * foo_vector.push_back( new foo()); - * foo_vector.push_back( new foo()); + * std::vector > foo_vector; + * foo_vector.push_back( new foo()); + * foo_vector.push_back( new foo()); * - * foo_vector[0]->bla(); + * foo_vector[0]->bla(); * } // foo_vector out of scope => heap memory freed for both foos + * \endcode * * @warning this class should only be used for objects created * on the heap via the new function. It will not behave correctly diff --git a/source/blender/avi/AVI_avi.h b/source/blender/avi/AVI_avi.h index 44ffaad1f48..5e9fe378c38 100644 --- a/source/blender/avi/AVI_avi.h +++ b/source/blender/avi/AVI_avi.h @@ -28,18 +28,17 @@ /** \file AVI_avi.h * \ingroup avi - * \section aviabout AVI module external interface * - * \subsection about About the AVI module + * \section avi_about About the AVI module * * This is external code. It provides avi file import/export and * conversions. It has been adapted to make use of Blender memory * management functions, and because of this it needs module * blenlib. You need to provide this lib when linking with libavi.a . * - * \subsection issues Known issues with AVI + * \subsection avi_issues Known issues with AVI * - * - avi uses mallocN, freeN from blenlib. + * - avi uses #MEM_mallocN, #MEM_freeN from blenlib. * - Not all functions that are used externally are properly * prototyped. * diff --git a/source/blender/blenkernel/BKE_mesh.h b/source/blender/blenkernel/BKE_mesh.h index 570c99b7bd9..287152baf0a 100644 --- a/source/blender/blenkernel/BKE_mesh.h +++ b/source/blender/blenkernel/BKE_mesh.h @@ -276,7 +276,7 @@ int BKE_mesh_recalc_tessellation( struct CustomData *fdata, struct CustomData *ldata, struct CustomData *pdata, struct MVert *mvert, int totface, int totloop, int totpoly, - const bool do_face_normals); + const bool do_face_nor_copy); int BKE_mesh_mpoly_to_mface( struct CustomData *fdata, struct CustomData *ldata, struct CustomData *pdata, int totface, int totloop, int totpoly); diff --git a/source/blender/blenkernel/intern/dynamicpaint.c b/source/blender/blenkernel/intern/dynamicpaint.c index 5c9e516aee9..8dac578ac0a 100644 --- a/source/blender/blenkernel/intern/dynamicpaint.c +++ b/source/blender/blenkernel/intern/dynamicpaint.c @@ -2964,15 +2964,16 @@ static void mesh_faces_nearest_point_dp(void *userdata, int index, const float c /** * Mix color values to canvas point. * - * \param surface canvas surface - * \param index surface point index - * \param paintFlags paint object flags - * \param paintColor,Alpha,Wetness to be mixed paint values - * \param timescale value used to adjust time dependent + * \param surface: Canvas surface + * \param index: Surface point index + * \param paintFlags: paint object flags + * \param paintColor,paintAlpha,paintWetness: To be mixed paint values + * \param timescale: Value used to adjust time dependent * operations when using substeps */ -static void dynamicPaint_mixPaintColors(DynamicPaintSurface *surface, int index, int paintFlags, - const float paintColor[3], float *paintAlpha, float *paintWetness, float *timescale) +static void dynamicPaint_mixPaintColors( + DynamicPaintSurface *surface, int index, int paintFlags, + const float paintColor[3], float *paintAlpha, float *paintWetness, float *timescale) { PaintPoint *pPoint = &((PaintPoint *)surface->data->type_data)[index]; diff --git a/source/blender/blenkernel/intern/mesh_evaluate.c b/source/blender/blenkernel/intern/mesh_evaluate.c index bbc175fefcd..302d85e8128 100644 --- a/source/blender/blenkernel/intern/mesh_evaluate.c +++ b/source/blender/blenkernel/intern/mesh_evaluate.c @@ -2253,12 +2253,15 @@ void BKE_mesh_loops_to_tessdata(CustomData *fdata, CustomData *ldata, CustomData /** * Recreate tessellation. * - * \param do_face_nor_copy controls whether the normals from the poly are copied to the tessellated faces. + * \param do_face_nor_copy: Controls whether the normals from the poly are copied to the tessellated faces. * * \return number of tessellation faces. */ -int BKE_mesh_recalc_tessellation(CustomData *fdata, CustomData *ldata, CustomData *pdata, - MVert *mvert, int totface, int totloop, int totpoly, const bool do_face_nor_cpy) +int BKE_mesh_recalc_tessellation( + CustomData *fdata, CustomData *ldata, CustomData *pdata, + MVert *mvert, + int totface, int totloop, int totpoly, + const bool do_face_nor_copy) { /* use this to avoid locking pthread for _every_ polygon * and calling the fill function */ @@ -2468,7 +2471,7 @@ int BKE_mesh_recalc_tessellation(CustomData *fdata, CustomData *ldata, CustomDat CustomData_add_layer(fdata, CD_ORIGINDEX, CD_ASSIGN, mface_to_poly_map, totface); CustomData_from_bmeshpoly(fdata, pdata, ldata, totface); - if (do_face_nor_cpy) { + if (do_face_nor_copy) { /* If polys have a normals layer, copying that to faces can help * avoid the need to recalculate normals later */ if (CustomData_has_layer(pdata, CD_NORMAL)) { diff --git a/source/blender/blenkernel/intern/object_deform.c b/source/blender/blenkernel/intern/object_deform.c index e46929dde4a..f6e939a103e 100644 --- a/source/blender/blenkernel/intern/object_deform.c +++ b/source/blender/blenkernel/intern/object_deform.c @@ -163,7 +163,7 @@ MDeformVert *BKE_object_defgroup_data_create(ID *id) /** * Remove all verts (or only selected ones) from given vgroup. Work in Object and Edit modes. * - * \param allverts If true, remove all vertices, else only selected ones. + * \param use_selection: Only operate on selection. * \return True if any vertex was removed, false otherwise. */ bool BKE_object_defgroup_clear(Object *ob, bDeformGroup *dg, const bool use_selection) @@ -241,7 +241,7 @@ bool BKE_object_defgroup_clear(Object *ob, bDeformGroup *dg, const bool use_sele /** * Remove all verts (or only selected ones) from all vgroups. Work in Object and Edit modes. * - * \param allverts If true, remove all vertices, else only selected ones. + * \param use_selection: Only operate on selection. * \return True if any vertex was removed, false otherwise. */ bool BKE_object_defgroup_clear_all(Object *ob, const bool use_selection) diff --git a/source/blender/blenlib/intern/BLI_dynstr.c b/source/blender/blenlib/intern/BLI_dynstr.c index 8617132e988..80cbce7e256 100644 --- a/source/blender/blenlib/intern/BLI_dynstr.c +++ b/source/blender/blenlib/intern/BLI_dynstr.c @@ -258,11 +258,11 @@ int BLI_dynstr_get_len(DynStr *ds) /** * Get a DynStr's contents as a c-string. - * The str argument must be allocated to be at - * least the size of BLI_dynstr_get_len(ds) + 1. + * he \a rets argument must be allocated to be at + * least the size of ``BLI_dynstr_get_len(ds) + 1``. * - * \param ds The DynStr of interest. - * \param str The string to fill. + * \param ds: The DynStr of interest. + * \param rets: The string to fill. */ void BLI_dynstr_get_cstring_ex(DynStr *__restrict ds, char *__restrict rets) { diff --git a/source/blender/blenlib/intern/convexhull2d.c b/source/blender/blenlib/intern/convexhull2d.c index f77beac1982..740f3cce4a4 100644 --- a/source/blender/blenlib/intern/convexhull2d.c +++ b/source/blender/blenlib/intern/convexhull2d.c @@ -239,7 +239,7 @@ int BLI_convexhull_2d(const float (*points)[2], const int n, int r_points[]) * * Intended to be used with #BLI_convexhull_2d * - * \param points Ordered hull points + * \param points_hull Ordered hull points * (result of #BLI_convexhull_2d mapped to a contiguous array). * * \note we could return the index of the best edge too if its needed. diff --git a/source/blender/blenlib/intern/edgehash.c b/source/blender/blenlib/intern/edgehash.c index edf70a1f188..cde4a8bf59d 100644 --- a/source/blender/blenlib/intern/edgehash.c +++ b/source/blender/blenlib/intern/edgehash.c @@ -454,9 +454,9 @@ void *BLI_edgehash_lookup_default(EdgeHash *eh, unsigned int v0, unsigned int v1 } /** - * Remove \a key from \a eh, or return false if the key wasn't found. + * Remove \a key (v0, v1) from \a eh, or return false if the key wasn't found. * - * \param key The key to remove. + * \param v0, v1: The key to remove. * \param valfreefp Optional callback to free the value. * \return true if \a key was removed from \a eh. */ @@ -480,9 +480,9 @@ bool BLI_edgehash_remove(EdgeHash *eh, unsigned int v0, unsigned int v1, EdgeHas /* same as above but return the value, * no free value argument since it will be returned */ /** - * Remove \a key from \a eh, returning the value or NULL if the key wasn't found. + * Remove \a key (v0, v1) from \a eh, returning the value or NULL if the key wasn't found. * - * \param key The key to remove. + * \param v0, v1: The key to remove. * \return the value of \a key int \a eh or NULL. */ void *BLI_edgehash_popkey(EdgeHash *eh, unsigned int v0, unsigned int v1) diff --git a/source/blender/blenlib/intern/gsqueue.c b/source/blender/blenlib/intern/gsqueue.c index 94d18ce3c77..f1aff76b358 100644 --- a/source/blender/blenlib/intern/gsqueue.c +++ b/source/blender/blenlib/intern/gsqueue.c @@ -96,8 +96,8 @@ int BLI_gsqueue_size(GSQueue *gq) * Access the item at the head of the queue * without removing it. * - * \param item_r A pointer to an appropriately - * sized structure (the size passed to BLI_gsqueue_new) + * \param r_item: A pointer to an appropriately + * sized structure (the size passed to #BLI_gsqueue_new) */ void BLI_gsqueue_peek(GSQueue *gq, void *r_item) { @@ -108,8 +108,8 @@ void BLI_gsqueue_peek(GSQueue *gq, void *r_item) * Access the item at the head of the queue * and remove it. * - * \param item_r A pointer to an appropriately - * sized structure (the size passed to BLI_gsqueue_new). + * \param r_item: A pointer to an appropriately + * sized structure (the size passed to #BLI_gsqueue_new). * Can be NULL if desired. */ void BLI_gsqueue_pop(GSQueue *gq, void *r_item) diff --git a/source/blender/blenlib/intern/string_utf8.c b/source/blender/blenlib/intern/string_utf8.c index 67ff532cb6f..22f44a38c7a 100644 --- a/source/blender/blenlib/intern/string_utf8.c +++ b/source/blender/blenlib/intern/string_utf8.c @@ -329,8 +329,8 @@ size_t BLI_strnlen_utf8_ex(const char *strc, const size_t maxlen, size_t *r_len_ } /** - * \param start the string to measure the length. - * \param maxlen the string length (in bytes) + * \param strc: the string to measure the length. + * \param maxlen: the string length (in bytes) * \return the unicode length (not in bytes!) */ size_t BLI_strnlen_utf8(const char *strc, const size_t maxlen) @@ -599,14 +599,14 @@ unsigned int BLI_str_utf8_as_unicode_step(const char *__restrict p, size_t *__re /* was g_unichar_to_utf8 */ /** * BLI_str_utf8_from_unicode: - * @c a Unicode character code - * \param outbuf output buffer, must have at least 6 bytes of space. + * \param c: a Unicode character code + * \param outbuf: output buffer, must have at least 6 bytes of space. * If %NULL, the length will be computed and returned * and nothing will be written to outbuf. * * Converts a single character to UTF-8. * - * Return value: number of bytes written + * \return number of bytes written **/ size_t BLI_str_utf8_from_unicode(unsigned int c, char *outbuf) { diff --git a/source/blender/blenlib/intern/timecode.c b/source/blender/blenlib/intern/timecode.c index 7b98d7830ee..39ffbcd7ebe 100644 --- a/source/blender/blenlib/intern/timecode.c +++ b/source/blender/blenlib/intern/timecode.c @@ -196,7 +196,6 @@ size_t BLI_timecode_string_from_time( * \param power special setting for #View2D grid drawing, * used to specify how detailed we need to be * \param time_seconds time total time in seconds - * \param seconds time in seconds. * \return length of \a str * * \note in some cases this is used to print non-seconds values. diff --git a/source/blender/blenloader/BLO_readfile.h b/source/blender/blenloader/BLO_readfile.h index 52a6597c79f..6fdcf7065c3 100644 --- a/source/blender/blenloader/BLO_readfile.h +++ b/source/blender/blenloader/BLO_readfile.h @@ -119,8 +119,8 @@ BLO_blendfiledata_free(BlendFileData *bfd); /** * Open a blendhandle from a file path. * - * \param file The file path to open. - * \param reports Report errors in opening the file (can be NULL). + * \param filepath: The file path to open. + * \param reports: Report errors in opening the file (can be NULL). * \return A handle on success, or NULL on failure. */ BlendHandle *BLO_blendhandle_from_file( diff --git a/source/blender/blenloader/intern/writefile.c b/source/blender/blenloader/intern/writefile.c index 285c50a4049..43f9fcce76d 100644 --- a/source/blender/blenloader/intern/writefile.c +++ b/source/blender/blenloader/intern/writefile.c @@ -407,7 +407,7 @@ static void mywrite(WriteData *wd, const void *adr, int len) /** * BeGiN initializer for mywrite - * \param file File descriptor + * \param ww: File write wrapper. * \param compare Previous memory file (can be NULL). * \param current The current memory file (can be NULL). * \warning Talks to other functions with global parameters diff --git a/source/blender/bmesh/intern/bmesh_core.c b/source/blender/bmesh/intern/bmesh_core.c index ee2ade51108..211b1a23f9c 100644 --- a/source/blender/bmesh/intern/bmesh_core.c +++ b/source/blender/bmesh/intern/bmesh_core.c @@ -2193,7 +2193,7 @@ void bmesh_vert_separate( * * Any edges which failed to split off in #bmesh_vert_separate will be merged back into the original edge. * - * \param edges_seperate + * \param edges_separate * A list-of-lists, each list is from a single original edge (the first edge is the original), * Check for duplicates (not just with the first) but between all. * This is O(n2) but radial edges are very rarely >2 and almost never >~10. diff --git a/source/blender/bmesh/intern/bmesh_mods.c b/source/blender/bmesh/intern/bmesh_mods.c index 5891876c22c..13c43fabdb0 100644 --- a/source/blender/bmesh/intern/bmesh_mods.c +++ b/source/blender/bmesh/intern/bmesh_mods.c @@ -270,7 +270,7 @@ BMFace *BM_faces_join_pair(BMesh *bm, BMFace *f_a, BMFace *f_b, BMEdge *e, const * the split edge to be created (must be differ and not can't be adjacent in the face). * \param r_l pointer which will receive the BMLoop for the split edge in the new face * \param example Edge used for attributes of splitting edge, if non-NULL - * \param nodouble Use an existing edge if found + * \param no_double: Use an existing edge if found * * \return Pointer to the newly created face representing one side of the split * if the split is successful (and the original original face will be the diff --git a/source/blender/bmesh/tools/bmesh_decimate_collapse.c b/source/blender/bmesh/tools/bmesh_decimate_collapse.c index 47c41c44d81..fde60397167 100644 --- a/source/blender/bmesh/tools/bmesh_decimate_collapse.c +++ b/source/blender/bmesh/tools/bmesh_decimate_collapse.c @@ -444,7 +444,7 @@ static void bm_decim_triangulate_end(BMesh *bm) #ifdef USE_CUSTOMDATA /** - * \param v is the target to merge into. + * \param l: defines the vert to collapse into. */ static void bm_edge_collapse_loop_customdata( BMesh *bm, BMLoop *l, BMVert *v_clear, BMVert *v_other, @@ -457,8 +457,6 @@ static void bm_edge_collapse_loop_customdata( const bool is_manifold = BM_edge_is_manifold(l->e); int side; - /* l defines the vert to collapse into */ - /* first find the loop of 'v_other' thats attached to the face of 'l' */ if (l->v == v_clear) { l_clear = l; @@ -700,8 +698,8 @@ static bool bm_edge_collapse_is_degenerate_topology(BMEdge *e_first) * * Important - dont add vert/edge/face data on collapsing! * - * \param e_clear_other let caller know what edges we remove besides \a e_clear - * \param customdata_flag merge factor, scales from 0 - 1 ('v_clear' -> 'v_other') + * \param r_e_clear_other: Let caller know what edges we remove besides \a e_clear + * \param customdata_flag: Merge factor, scales from 0 - 1 ('v_clear' -> 'v_other') */ static bool bm_edge_collapse( BMesh *bm, BMEdge *e_clear, BMVert *v_clear, int r_e_clear_other[2], diff --git a/source/blender/bmesh/tools/bmesh_edgenet.c b/source/blender/bmesh/tools/bmesh_edgenet.c index e93ffe6b141..2767f87be4a 100644 --- a/source/blender/bmesh/tools/bmesh_edgenet.c +++ b/source/blender/bmesh/tools/bmesh_edgenet.c @@ -448,7 +448,6 @@ static LinkNode *bm_edgenet_path_calc_best( * * \param bm The mesh to operate on. * \param use_edge_tag Only fill tagged edges. - * \param face_oflag if nonzero, apply all new faces with this bmo flag. */ void BM_mesh_edgenet( BMesh *bm, diff --git a/source/blender/bmesh/tools/bmesh_edgesplit.c b/source/blender/bmesh/tools/bmesh_edgesplit.c index 74b1660080b..a59a5c43c82 100644 --- a/source/blender/bmesh/tools/bmesh_edgesplit.c +++ b/source/blender/bmesh/tools/bmesh_edgesplit.c @@ -37,7 +37,6 @@ /** * \param use_verts Use flagged verts instead of edges. - * \param use_non_manifold Split non-manifold edges (a little slower, must check for doubles). * \param tag_only Only split tagged edges. * \param copy_select Copy selection history. */ diff --git a/source/blender/bmesh/tools/bmesh_wireframe.c b/source/blender/bmesh/tools/bmesh_wireframe.c index 87e571a49aa..e79ef52797b 100644 --- a/source/blender/bmesh/tools/bmesh_wireframe.c +++ b/source/blender/bmesh/tools/bmesh_wireframe.c @@ -160,7 +160,7 @@ static bool bm_loop_is_radial_boundary(BMLoop *l_first) } /** - * \param def_nr -1 for no vertex groups. + * \param defgrp_index: Vertex group index, -1 for no vertex groups. * * \note All edge tags must be cleared. * \note Behavior matches MOD_solidify.c diff --git a/source/blender/compositor/COM_compositor.h b/source/blender/compositor/COM_compositor.h index 8b0a617f889..a5d7704a708 100644 --- a/source/blender/compositor/COM_compositor.h +++ b/source/blender/compositor/COM_compositor.h @@ -38,7 +38,7 @@ extern "C" { * @defgroup Node All nodes of the compositor * @defgroup Operation All operations of the compositor * - * @mainpage Introduction of the Blender Compositor + * @page Introduction of the Blender Compositor * * @section bcomp Blender compositor * This project redesigns the internals of Blender's compositor. The project has been executed in 2011 by At Mind. diff --git a/source/blender/depsgraph/DEG_depsgraph.h b/source/blender/depsgraph/DEG_depsgraph.h index 9fc50476e47..b91f99ecd20 100644 --- a/source/blender/depsgraph/DEG_depsgraph.h +++ b/source/blender/depsgraph/DEG_depsgraph.h @@ -22,14 +22,15 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** - * - * Public API for Depsgraph */ -#ifndef __DEG_DEPSGRAPH_H__ -#define __DEG_DEPSGRAPH_H__ - -/* Dependency Graph +/** \file blender/depsgraph/DEG_depsgraph.h + * \ingroup depsgraph + * + * Public API for Depsgraph + * + * Dependency Graph + * ================ * * The dependency graph tracks relations between various pieces of data in * a Blender file, but mainly just those which make up scene data. It is used @@ -39,6 +40,7 @@ * * * Evaluation Engine + * ================= * * The evaluation takes the operation-nodes the Depsgraph has tagged for updating, * and schedules them up for being evaluated/executed such that the all dependency @@ -50,6 +52,9 @@ * - These are used in all depsgraph code and by all callers of Depsgraph API... */ +#ifndef __DEG_DEPSGRAPH_H__ +#define __DEG_DEPSGRAPH_H__ + /* Dependency Graph */ typedef struct Depsgraph Depsgraph; diff --git a/source/blender/depsgraph/DEG_depsgraph_build.h b/source/blender/depsgraph/DEG_depsgraph_build.h index 08b83ac2ea1..f680c47247a 100644 --- a/source/blender/depsgraph/DEG_depsgraph_build.h +++ b/source/blender/depsgraph/DEG_depsgraph_build.h @@ -22,6 +22,10 @@ * Contributor(s): Lukas Toenne * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/DEG_depsgraph_build.h + * \ingroup depsgraph * * Public API for Depsgraph */ diff --git a/source/blender/depsgraph/DEG_depsgraph_debug.h b/source/blender/depsgraph/DEG_depsgraph_debug.h index 60e9a021854..374fad63c34 100644 --- a/source/blender/depsgraph/DEG_depsgraph_debug.h +++ b/source/blender/depsgraph/DEG_depsgraph_debug.h @@ -22,6 +22,10 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/DEG_depsgraph_debug.h + * \ingroup depsgraph * * Public API for Querying and Filtering Depsgraph */ diff --git a/source/blender/depsgraph/DEG_depsgraph_query.h b/source/blender/depsgraph/DEG_depsgraph_query.h index 000497cfac9..60d673d4c5b 100644 --- a/source/blender/depsgraph/DEG_depsgraph_query.h +++ b/source/blender/depsgraph/DEG_depsgraph_query.h @@ -22,8 +22,12 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/DEG_depsgraph_query.h + * \ingroup depsgraph * - * Public API for Querying and Filtering Depsgraph + * Public API for Querying and Filtering Depsgraph. */ #ifndef __DEG_DEPSGRAPH_QUERY_H__ diff --git a/source/blender/depsgraph/intern/depsgraph.cc b/source/blender/depsgraph/intern/depsgraph.cc index c519f1d498e..e9b2a06cf7b 100644 --- a/source/blender/depsgraph/intern/depsgraph.cc +++ b/source/blender/depsgraph/intern/depsgraph.cc @@ -22,8 +22,12 @@ * Contributor(s): Sergey Sharybin * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph.cc + * \ingroup depsgraph * - * Core routines for how the Depsgraph works + * Core routines for how the Depsgraph works. */ #include diff --git a/source/blender/depsgraph/intern/depsgraph.h b/source/blender/depsgraph/intern/depsgraph.h index c693f4aa3b0..9533fbd10d5 100644 --- a/source/blender/depsgraph/intern/depsgraph.h +++ b/source/blender/depsgraph/intern/depsgraph.h @@ -22,6 +22,10 @@ * Contributor(s): Sergey Sharybin * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph.h + * \ingroup depsgraph * * Datatypes for internal use in the Depsgraph * diff --git a/source/blender/depsgraph/intern/depsgraph_build.cc b/source/blender/depsgraph/intern/depsgraph_build.cc index 15b8cc0fb3a..7a2ee2c416a 100644 --- a/source/blender/depsgraph/intern/depsgraph_build.cc +++ b/source/blender/depsgraph/intern/depsgraph_build.cc @@ -22,8 +22,12 @@ * Contributor(s): Based on original depsgraph.c code - Blender Foundation (2005-2013) * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_build.cc + * \ingroup depsgraph * - * Methods for constructing depsgraph + * Methods for constructing depsgraph. */ #include diff --git a/source/blender/depsgraph/intern/depsgraph_build.h b/source/blender/depsgraph/intern/depsgraph_build.h index 84c09b81508..93fa9e4b0d8 100644 --- a/source/blender/depsgraph/intern/depsgraph_build.h +++ b/source/blender/depsgraph/intern/depsgraph_build.h @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/intern/depsgraph_build.h + * \ingroup depsgraph + */ + #ifndef __DEPSGRAPH_BUILD_H__ #define __DEPSGRAPH_BUILD_H__ diff --git a/source/blender/depsgraph/intern/depsgraph_build_nodes.cc b/source/blender/depsgraph/intern/depsgraph_build_nodes.cc index 02538d92480..c9d2ed35e17 100644 --- a/source/blender/depsgraph/intern/depsgraph_build_nodes.cc +++ b/source/blender/depsgraph/intern/depsgraph_build_nodes.cc @@ -22,11 +22,14 @@ * Contributor(s): Based on original depsgraph.c code - Blender Foundation (2005-2013) * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_build_nodes.cc + * \ingroup depsgraph * * Methods for constructing depsgraph's nodes */ - #include #include #include @@ -525,7 +528,6 @@ void DepsgraphNodeBuilder::build_pose_constraints(Object *ob, bPoseChannel *pcha /** * Build graph nodes for AnimData block - * \param scene_node: Scene that ID-block this lives on belongs to * \param id: ID-Block which hosts the AnimData */ void DepsgraphNodeBuilder::build_animdata(ID *id) diff --git a/source/blender/depsgraph/intern/depsgraph_build_relations.cc b/source/blender/depsgraph/intern/depsgraph_build_relations.cc index b9248318814..fdaee42f316 100644 --- a/source/blender/depsgraph/intern/depsgraph_build_relations.cc +++ b/source/blender/depsgraph/intern/depsgraph_build_relations.cc @@ -22,6 +22,10 @@ * Contributor(s): Based on original depsgraph.c code - Blender Foundation (2005-2013) * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_build_relations.cc + * \ingroup depsgraph * * Methods for constructing depsgraph */ diff --git a/source/blender/depsgraph/intern/depsgraph_debug.cc b/source/blender/depsgraph/intern/depsgraph_debug.cc index 7c044980d7f..59351495df0 100644 --- a/source/blender/depsgraph/intern/depsgraph_debug.cc +++ b/source/blender/depsgraph/intern/depsgraph_debug.cc @@ -22,6 +22,10 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_debug.cc + * \ingroup depsgraph * * Implementation of tools for debugging the depsgraph */ diff --git a/source/blender/depsgraph/intern/depsgraph_debug.h b/source/blender/depsgraph/intern/depsgraph_debug.h index aed36f6add6..64b97855f57 100644 --- a/source/blender/depsgraph/intern/depsgraph_debug.h +++ b/source/blender/depsgraph/intern/depsgraph_debug.h @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/intern/depsgraph_debug.h + * \ingroup depsgraph + */ + #ifndef __DEPSGRAPH_DEBUG_H__ #define __DEPSGRAPH_DEBUG_H__ diff --git a/source/blender/depsgraph/intern/depsgraph_eval.cc b/source/blender/depsgraph/intern/depsgraph_eval.cc index 11fd02376a3..74fa003821a 100644 --- a/source/blender/depsgraph/intern/depsgraph_eval.cc +++ b/source/blender/depsgraph/intern/depsgraph_eval.cc @@ -22,8 +22,12 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_eval.cc + * \ingroup depsgraph * - * Evaluation engine entrypoints for Depsgraph Engine + * Evaluation engine entrypoints for Depsgraph Engine. */ #include "MEM_guardedalloc.h" diff --git a/source/blender/depsgraph/intern/depsgraph_intern.h b/source/blender/depsgraph/intern/depsgraph_intern.h index 70d452bf221..7fdc2454564 100644 --- a/source/blender/depsgraph/intern/depsgraph_intern.h +++ b/source/blender/depsgraph/intern/depsgraph_intern.h @@ -22,6 +22,10 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_intern.h + * \ingroup depsgraph * * API's for internal use in the Depsgraph * - Also, defines for "Node Type Info" diff --git a/source/blender/depsgraph/intern/depsgraph_query.cc b/source/blender/depsgraph/intern/depsgraph_query.cc index aa6f5ef3ea1..73193747b93 100644 --- a/source/blender/depsgraph/intern/depsgraph_query.cc +++ b/source/blender/depsgraph/intern/depsgraph_query.cc @@ -22,6 +22,10 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_query.cc + * \ingroup depsgraph * * Implementation of Querying and Filtering API's */ diff --git a/source/blender/depsgraph/intern/depsgraph_queue.cc b/source/blender/depsgraph/intern/depsgraph_queue.cc index 45290c50706..da60d73bc46 100644 --- a/source/blender/depsgraph/intern/depsgraph_queue.cc +++ b/source/blender/depsgraph/intern/depsgraph_queue.cc @@ -22,8 +22,12 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_queue.cc + * \ingroup depsgraph * - * Implementation of special queue type for use in Depsgraph traversals + * Implementation of special queue type for use in Depsgraph traversals. */ #include diff --git a/source/blender/depsgraph/intern/depsgraph_queue.h b/source/blender/depsgraph/intern/depsgraph_queue.h index bd294d4655e..b85d46bd173 100644 --- a/source/blender/depsgraph/intern/depsgraph_queue.h +++ b/source/blender/depsgraph/intern/depsgraph_queue.h @@ -22,8 +22,12 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_queue.h + * \ingroup depsgraph * - * Defines for special queue type for use in Depsgraph traversals + * Defines for special queue type for use in Depsgraph traversals. */ #ifndef __DEPSGRAPH_QUEUE_H__ diff --git a/source/blender/depsgraph/intern/depsgraph_tag.cc b/source/blender/depsgraph/intern/depsgraph_tag.cc index 8549fce6aed..65109ff94dd 100644 --- a/source/blender/depsgraph/intern/depsgraph_tag.cc +++ b/source/blender/depsgraph/intern/depsgraph_tag.cc @@ -22,8 +22,12 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_tag.cc + * \ingroup depsgraph * - * Core routines for how the Depsgraph works + * Core routines for how the Depsgraph works. */ #include diff --git a/source/blender/depsgraph/intern/depsgraph_type_defines.cc b/source/blender/depsgraph/intern/depsgraph_type_defines.cc index 67c632d4125..5a3048a4aa3 100644 --- a/source/blender/depsgraph/intern/depsgraph_type_defines.cc +++ b/source/blender/depsgraph/intern/depsgraph_type_defines.cc @@ -22,8 +22,12 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_type_defines.cc + * \ingroup depsgraph * - * Defines and code for core node types + * Defines and code for core node types. */ extern "C" { diff --git a/source/blender/depsgraph/intern/depsgraph_types.h b/source/blender/depsgraph/intern/depsgraph_types.h index 713fec8965d..3616fe85496 100644 --- a/source/blender/depsgraph/intern/depsgraph_types.h +++ b/source/blender/depsgraph/intern/depsgraph_types.h @@ -22,6 +22,10 @@ * Contributor(s): None Yet * * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/intern/depsgraph_types.h + * \ingroup depsgraph * * Datatypes for internal use in the Depsgraph * diff --git a/source/blender/depsgraph/intern/depsnode.cc b/source/blender/depsgraph/intern/depsnode.cc index 866e9115648..e108e561f4e 100644 --- a/source/blender/depsgraph/intern/depsnode.cc +++ b/source/blender/depsgraph/intern/depsnode.cc @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/intern/depsnode.cc + * \ingroup depsgraph + */ + #include #include diff --git a/source/blender/depsgraph/intern/depsnode.h b/source/blender/depsgraph/intern/depsnode.h index 4f3dc3b7303..53826ae8e71 100644 --- a/source/blender/depsgraph/intern/depsnode.h +++ b/source/blender/depsgraph/intern/depsnode.h @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/intern/depsnode.h + * \ingroup depsgraph + */ + #ifndef __DEPSNODE_H__ #define __DEPSNODE_H__ diff --git a/source/blender/depsgraph/intern/depsnode_component.cc b/source/blender/depsgraph/intern/depsnode_component.cc index 969b0891e15..1d939c6580d 100644 --- a/source/blender/depsgraph/intern/depsnode_component.cc +++ b/source/blender/depsgraph/intern/depsnode_component.cc @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/intern/depsnode_component.cc + * \ingroup depsgraph + */ + #include #include diff --git a/source/blender/depsgraph/intern/depsnode_component.h b/source/blender/depsgraph/intern/depsnode_component.h index 06a18b60abb..e3550bb2371 100644 --- a/source/blender/depsgraph/intern/depsnode_component.h +++ b/source/blender/depsgraph/intern/depsnode_component.h @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/intern/depsnode_component.h + * \ingroup depsgraph + */ + #ifndef __DEPSNODE_COMPONENT_H__ #define __DEPSNODE_COMPONENT_H__ diff --git a/source/blender/depsgraph/intern/depsnode_opcodes.h b/source/blender/depsgraph/intern/depsnode_opcodes.h index 48db2b79e66..b81822c0ac5 100644 --- a/source/blender/depsgraph/intern/depsnode_opcodes.h +++ b/source/blender/depsgraph/intern/depsnode_opcodes.h @@ -24,7 +24,11 @@ * ***** END GPL LICENSE BLOCK ***** */ -/* == OpCodes for OperationDepsNodes == +/** \file blender/depsgraph/intern/depsnode_opcodes.h + * \ingroup depsgraph + * + * \par OpCodes for OperationDepsNodes + * * This file defines all the "operation codes" (opcodes) used to identify * common operation node types. The intention of these defines is to have * a fast and reliable way of identifying the relevant nodes within a component diff --git a/source/blender/depsgraph/intern/depsnode_operation.cc b/source/blender/depsgraph/intern/depsnode_operation.cc index de8755f7ae9..6aeb163356b 100644 --- a/source/blender/depsgraph/intern/depsnode_operation.cc +++ b/source/blender/depsgraph/intern/depsnode_operation.cc @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/intern/depsnode_operation.cc + * \ingroup depsgraph + */ + #include "MEM_guardedalloc.h" extern "C" { diff --git a/source/blender/depsgraph/intern/depsnode_operation.h b/source/blender/depsgraph/intern/depsnode_operation.h index 2b70ff0a8dc..1119e10805d 100644 --- a/source/blender/depsgraph/intern/depsnode_operation.h +++ b/source/blender/depsgraph/intern/depsnode_operation.h @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/intern/depsnode_operation.h + * \ingroup depsgraph + */ + #ifndef __DEPSNODE_OPERATION_H__ #define __DEPSNODE_OPERATION_H__ diff --git a/source/blender/depsgraph/util/depsgraph_util_cycle.cc b/source/blender/depsgraph/util/depsgraph_util_cycle.cc index 5a171d190cd..5eae8c087ad 100644 --- a/source/blender/depsgraph/util/depsgraph_util_cycle.cc +++ b/source/blender/depsgraph/util/depsgraph_util_cycle.cc @@ -19,6 +19,12 @@ * All rights reserved. * * Contributor(s): Sergey Sharybin + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/util/depsgraph_util_cycle.cc + * \ingroup depsgraph */ #include diff --git a/source/blender/depsgraph/util/depsgraph_util_cycle.h b/source/blender/depsgraph/util/depsgraph_util_cycle.h index f827d85c16a..fac38b61057 100644 --- a/source/blender/depsgraph/util/depsgraph_util_cycle.h +++ b/source/blender/depsgraph/util/depsgraph_util_cycle.h @@ -19,6 +19,12 @@ * All rights reserved. * * Contributor(s): Sergey Sharybin + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/util/depsgraph_util_cycle.h + * \ingroup depsgraph */ #ifndef __DEPSGRAPH_UTIL_CYCLE_H__ diff --git a/source/blender/depsgraph/util/depsgraph_util_function.h b/source/blender/depsgraph/util/depsgraph_util_function.h index 976a9d6cc2b..74bf5de8ab6 100644 --- a/source/blender/depsgraph/util/depsgraph_util_function.h +++ b/source/blender/depsgraph/util/depsgraph_util_function.h @@ -20,6 +20,12 @@ * * Original Author: Lukas Toenne * Contributor(s): + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/util/depsgraph_util_function.h + * \ingroup depsgraph */ #ifndef __DEPSGRAPH_UTIL_FUNCTION_H__ diff --git a/source/blender/depsgraph/util/depsgraph_util_hash.h b/source/blender/depsgraph/util/depsgraph_util_hash.h index 0f5a85b3526..bc75627a026 100644 --- a/source/blender/depsgraph/util/depsgraph_util_hash.h +++ b/source/blender/depsgraph/util/depsgraph_util_hash.h @@ -20,6 +20,12 @@ * * Original Author: Brecht van Lommel * Contributor(s): Lukas Toenne + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/util/depsgraph_util_hash.h + * \ingroup depsgraph */ #ifndef __DEPSGRAPH_UTIL_HASH_H__ diff --git a/source/blender/depsgraph/util/depsgraph_util_map.h b/source/blender/depsgraph/util/depsgraph_util_map.h index 2951641431b..0eae1d79e34 100644 --- a/source/blender/depsgraph/util/depsgraph_util_map.h +++ b/source/blender/depsgraph/util/depsgraph_util_map.h @@ -20,6 +20,12 @@ * * Original Author: Brecht van Lommel * Contributor(s): Lukas Toenne + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/util/depsgraph_util_map.h + * \ingroup depsgraph */ #ifndef __DEPSGRAPH_UTIL_MAP_H__ diff --git a/source/blender/depsgraph/util/depsgraph_util_pchanmap.cc b/source/blender/depsgraph/util/depsgraph_util_pchanmap.cc index 36bd72108ed..80b37ec622d 100644 --- a/source/blender/depsgraph/util/depsgraph_util_pchanmap.cc +++ b/source/blender/depsgraph/util/depsgraph_util_pchanmap.cc @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/util/depsgraph_util_pchanmap.cc + * \ingroup depsgraph + */ + #include "depsgraph_util_pchanmap.h" #include diff --git a/source/blender/depsgraph/util/depsgraph_util_pchanmap.h b/source/blender/depsgraph/util/depsgraph_util_pchanmap.h index 82ec8654bc5..b7f4c495933 100644 --- a/source/blender/depsgraph/util/depsgraph_util_pchanmap.h +++ b/source/blender/depsgraph/util/depsgraph_util_pchanmap.h @@ -24,6 +24,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/depsgraph/util/depsgraph_util_pchanmap.h + * \ingroup depsgraph + */ + #ifndef __DEPSGRAPH_UTIL_PCHANMAP_H__ #define __DEPSGRAPH_UTIL_PCHANMAP_H__ diff --git a/source/blender/depsgraph/util/depsgraph_util_set.h b/source/blender/depsgraph/util/depsgraph_util_set.h index 09fa5313920..008ec6b74ca 100644 --- a/source/blender/depsgraph/util/depsgraph_util_set.h +++ b/source/blender/depsgraph/util/depsgraph_util_set.h @@ -20,6 +20,12 @@ * * Original Author: Brecht van Lommel * Contributor(s): Lukas Toenne + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/util/depsgraph_util_set.h + * \ingroup depsgraph */ #ifndef __DEPSGRAPH_UTIL_SET_H__ diff --git a/source/blender/depsgraph/util/depsgraph_util_transitive.cc b/source/blender/depsgraph/util/depsgraph_util_transitive.cc index 9411d013c44..98192a9540f 100644 --- a/source/blender/depsgraph/util/depsgraph_util_transitive.cc +++ b/source/blender/depsgraph/util/depsgraph_util_transitive.cc @@ -18,8 +18,14 @@ * The Original Code is Copyright (C) 2015 Blender Foundation. * All rights reserved. * - * Contributor(s): Lukas Toenne + * Contributor(s): Lukas Toenne, * Sergey Sharybin, + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/util/depsgraph_util_transitive.cc + * \ingroup depsgraph */ extern "C" { diff --git a/source/blender/depsgraph/util/depsgraph_util_transitive.h b/source/blender/depsgraph/util/depsgraph_util_transitive.h index 8995c18eca0..a80a1d783d7 100644 --- a/source/blender/depsgraph/util/depsgraph_util_transitive.h +++ b/source/blender/depsgraph/util/depsgraph_util_transitive.h @@ -20,6 +20,12 @@ * * Contributor(s): Lukas Toenne * Sergey Sharybin, + * + * ***** END GPL LICENSE BLOCK ***** + */ + +/** \file blender/depsgraph/util/depsgraph_util_transitive.h + * \ingroup depsgraph */ #ifndef __DEPSGRAPH_UTIL_TRANSITIVE_H__ diff --git a/source/blender/editors/interface/view2d.c b/source/blender/editors/interface/view2d.c index 09b97b43ea1..5f7eca5f5b0 100644 --- a/source/blender/editors/interface/view2d.c +++ b/source/blender/editors/interface/view2d.c @@ -1987,7 +1987,7 @@ void UI_view2d_listview_view_to_cell( * * \param columnwidth, rowheight: Size of each 'cell' * \param startx, starty: Coordinates that the list starts from, which should be (0,0) for most views - * \param column, row_min, max: The starting and ending column/row indices + * \param column_min, column_max, row_min, row_max: The starting and ending column/row indices */ void UI_view2d_listview_visible_cells( View2D *v2d, float columnwidth, float rowheight, float startx, float starty, @@ -2021,7 +2021,7 @@ float UI_view2d_region_to_view_y(struct View2D *v2d, float y) * Convert from screen/region space to 2d-View space * * \param x, y: coordinates to convert - * \param viewx, viewy: resultant coordinates + * \param r_view_x, r_view_y: resultant coordinates */ void UI_view2d_region_to_view(View2D *v2d, float x, float y, float *r_view_x, float *r_view_y) { @@ -2054,7 +2054,7 @@ float UI_view2d_view_to_region_y(View2D *v2d, float y) * \note Coordinates are clamped to lie within bounds of region * * \param x, y: Coordinates to convert. - * \param regionx, regiony: Resultant coordinates. + * \param r_region_x, r_region_y: Resultant coordinates. */ bool UI_view2d_view_to_region_clip(View2D *v2d, float x, float y, int *r_region_x, int *r_region_y) { @@ -2083,7 +2083,7 @@ bool UI_view2d_view_to_region_clip(View2D *v2d, float x, float y, int *r_region_ * \note Coordinates are NOT clamped to lie within bounds of region. * * \param x, y: Coordinates to convert. - * \param regionx, regiony: Resultant coordinates. + * \param r_region_x, r_region_y: Resultant coordinates. */ void UI_view2d_view_to_region(View2D *v2d, float x, float y, int *r_region_x, int *r_region_y) { diff --git a/source/blender/editors/sculpt_paint/sculpt.c b/source/blender/editors/sculpt_paint/sculpt.c index 8bdbe23ead8..19777e0093c 100644 --- a/source/blender/editors/sculpt_paint/sculpt.c +++ b/source/blender/editors/sculpt_paint/sculpt.c @@ -373,6 +373,9 @@ static void sculpt_project_v3_cache_init( spvc->len_sq_inv_neg = (spvc->is_valid) ? -1.0f / spvc->len_sq : 0.0f; } +/** + * Calculate the projection. + */ static void sculpt_project_v3( const SculptProjectVector *spvc, const float vec[3], float r_vec[3]) diff --git a/source/blender/imbuf/IMB_imbuf.h b/source/blender/imbuf/IMB_imbuf.h index 7c7f2db09d2..4a2d05bdf61 100644 --- a/source/blender/imbuf/IMB_imbuf.h +++ b/source/blender/imbuf/IMB_imbuf.h @@ -38,21 +38,21 @@ * \page IMB Imbuf module external interface * * - * \section about About the IMB module + * \section imb_about About the IMB module * * External interface of the IMage Buffer module. This module offers * import/export of several graphical file formats. It offers the * ImBuf type as a common structure to refer to different graphical * file formats, and to enable a uniform way of handling them. * - * \section issues Known issues with IMB + * \section imb_issues Known issues with IMB * * - imbuf is written in C. * - Endianness issues are dealt with internally. * - File I/O must be done externally. The module uses FILE*'s to * direct input/output. * - * \section dependencies Dependencies + * \section imb_dependencies Dependencies * * IMB needs: * - \ref DNA module diff --git a/source/blender/physics/BPH_mass_spring.h b/source/blender/physics/BPH_mass_spring.h index c189dea28a4..1a10b9398a2 100644 --- a/source/blender/physics/BPH_mass_spring.h +++ b/source/blender/physics/BPH_mass_spring.h @@ -25,6 +25,10 @@ * ***** END GPL LICENSE BLOCK ***** */ +/** \file blender/physics/intern/BPH_mass_spring.h + * \ingroup bph + */ + #ifndef __BPH_MASS_SPRING_H__ #define __BPH_MASS_SPRING_H__ diff --git a/source/blender/physics/intern/eigen_utils.h b/source/blender/physics/intern/eigen_utils.h index cd3bd5ee45d..e4a4f306aeb 100644 --- a/source/blender/physics/intern/eigen_utils.h +++ b/source/blender/physics/intern/eigen_utils.h @@ -28,7 +28,7 @@ #ifndef __EIGEN_UTILS_H__ #define __EIGEN_UTILS_H__ -/** \file eigen_utils.h +/** \file blender/physics/intern/eigen_utils.h * \ingroup bph */ diff --git a/source/gameengine/Expressions/PyObjectPlus.cpp b/source/gameengine/Expressions/PyObjectPlus.cpp index d475152f83e..31a17bd0cbf 100644 --- a/source/gameengine/Expressions/PyObjectPlus.cpp +++ b/source/gameengine/Expressions/PyObjectPlus.cpp @@ -158,7 +158,8 @@ PyObject *PyObjectPlus::py_base_new(PyTypeObject *type, PyObject *args, PyObject PyObjectPlus_Proxy *base = (PyObjectPlus_Proxy *)PyTuple_GET_ITEM(args, 0); - /* the 'base' PyObject may be subclassed (multiple times even) + /** + * the 'base' PyObject may be subclassed (multiple times even) * we need to find the first C++ defined class to check 'type' * is a subclass of the base arguments type. * @@ -167,12 +168,13 @@ PyObject *PyObjectPlus::py_base_new(PyTypeObject *type, PyObject *args, PyObject * eg. * * # CustomOb is called 'type' in this C code + * \code{.py} * class CustomOb(GameTypes.KX_GameObject): * pass * * # this calls py_base_new(...), the type of 'CustomOb' is checked to be a subclass of the 'cont.owner' type * ob = CustomOb(cont.owner) - * + * \endcode * */ base_type= Py_TYPE(base); while (base_type && !BGE_PROXY_CHECK_TYPE(base_type)) -- cgit v1.2.3