doxygen: corrections/updates
authorCampbell Barton <ideasman42@gmail.com>
Wed, 20 May 2015 02:54:45 +0000 (12:54 +1000)
committerCampbell Barton <ideasman42@gmail.com>
Wed, 20 May 2015 04:12:22 +0000 (14:12 +1000)
Also add depsgraph & physics

71 files changed:
doc/doxygen/doxygen.intern.h
doc/doxygen/doxygen.source.h
extern/bullet2/src/BulletCollision/CollisionDispatch/btCollisionWorld.h
intern/ghost/intern/GHOST_SystemX11.h
intern/iksolver/extern/IK_solver.h
intern/memutil/MEM_CacheLimiter.h
intern/memutil/MEM_RefCountPtr.h
intern/memutil/MEM_SmartPtr.h
source/blender/avi/AVI_avi.h
source/blender/blenkernel/BKE_mesh.h
source/blender/blenkernel/intern/dynamicpaint.c
source/blender/blenkernel/intern/mesh_evaluate.c
source/blender/blenkernel/intern/object_deform.c
source/blender/blenlib/intern/BLI_dynstr.c
source/blender/blenlib/intern/convexhull2d.c
source/blender/blenlib/intern/edgehash.c
source/blender/blenlib/intern/gsqueue.c
source/blender/blenlib/intern/string_utf8.c
source/blender/blenlib/intern/timecode.c
source/blender/blenloader/BLO_readfile.h
source/blender/blenloader/intern/writefile.c
source/blender/bmesh/intern/bmesh_core.c
source/blender/bmesh/intern/bmesh_mods.c
source/blender/bmesh/tools/bmesh_decimate_collapse.c
source/blender/bmesh/tools/bmesh_edgenet.c
source/blender/bmesh/tools/bmesh_edgesplit.c
source/blender/bmesh/tools/bmesh_wireframe.c
source/blender/compositor/COM_compositor.h
source/blender/depsgraph/DEG_depsgraph.h
source/blender/depsgraph/DEG_depsgraph_build.h
source/blender/depsgraph/DEG_depsgraph_debug.h
source/blender/depsgraph/DEG_depsgraph_query.h
source/blender/depsgraph/intern/depsgraph.cc
source/blender/depsgraph/intern/depsgraph.h
source/blender/depsgraph/intern/depsgraph_build.cc
source/blender/depsgraph/intern/depsgraph_build.h
source/blender/depsgraph/intern/depsgraph_build_nodes.cc
source/blender/depsgraph/intern/depsgraph_build_relations.cc
source/blender/depsgraph/intern/depsgraph_debug.cc
source/blender/depsgraph/intern/depsgraph_debug.h
source/blender/depsgraph/intern/depsgraph_eval.cc
source/blender/depsgraph/intern/depsgraph_intern.h
source/blender/depsgraph/intern/depsgraph_query.cc
source/blender/depsgraph/intern/depsgraph_queue.cc
source/blender/depsgraph/intern/depsgraph_queue.h
source/blender/depsgraph/intern/depsgraph_tag.cc
source/blender/depsgraph/intern/depsgraph_type_defines.cc
source/blender/depsgraph/intern/depsgraph_types.h
source/blender/depsgraph/intern/depsnode.cc
source/blender/depsgraph/intern/depsnode.h
source/blender/depsgraph/intern/depsnode_component.cc
source/blender/depsgraph/intern/depsnode_component.h
source/blender/depsgraph/intern/depsnode_opcodes.h
source/blender/depsgraph/intern/depsnode_operation.cc
source/blender/depsgraph/intern/depsnode_operation.h
source/blender/depsgraph/util/depsgraph_util_cycle.cc
source/blender/depsgraph/util/depsgraph_util_cycle.h
source/blender/depsgraph/util/depsgraph_util_function.h
source/blender/depsgraph/util/depsgraph_util_hash.h
source/blender/depsgraph/util/depsgraph_util_map.h
source/blender/depsgraph/util/depsgraph_util_pchanmap.cc
source/blender/depsgraph/util/depsgraph_util_pchanmap.h
source/blender/depsgraph/util/depsgraph_util_set.h
source/blender/depsgraph/util/depsgraph_util_transitive.cc
source/blender/depsgraph/util/depsgraph_util_transitive.h
source/blender/editors/interface/view2d.c
source/blender/editors/sculpt_paint/sculpt.c
source/blender/imbuf/IMB_imbuf.h
source/blender/physics/BPH_mass_spring.h
source/blender/physics/intern/eigen_utils.h
source/gameengine/Expressions/PyObjectPlus.cpp

index ae8f6ca88e479fa92bab9aea0444af51acbdc610..2c8ecae0ead5f1904a730dbf38888fb35e3648ba 100644 (file)
  *  \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
  */
index f27a5a878076b1db161237d5bea18596d3bd9d23..42516b9af6bda8719cb6e338c650dc49578163d4 100644 (file)
 
 /* ================================ */
 
-/** \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
  */
 
  *  \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
  */
 
  *  \ingroup externformats
  */
 
-/** \defgroup imbuf IMage Buffer
+/** \defgroup imbuf Image Buffer (ImBuf)
  *  \ingroup blender
  */
 
index b3fffdecd98ef01b636c9d7355c3bfb614a491fe..0ac5563d06e571ec385a2ab5f8ff0e06c16a97c2 100644 (file)
@@ -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 ).
index a5c1329c4c052038886fb6ba6970a79e96c31fed..6c0784dfbedf3e3ae92a095b268942b48e0e4fc9 100644 (file)
@@ -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() 
         */
index 4de9f143e773ec63b11a31914c364dd248015d82..55223806d5c49f701254149bb4035aba2f29c410 100644 (file)
 
  * 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.
  */
index 3e8ae7e5a4d971997302ad3e694dc0cc7aac239f..d5a44375885c9b481ebc8a5a63acaf1ec7ffbbee 100644 (file)
 #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<BigFatImage> BigFatImages;
  *
  *     MEM_Cache_Handle<BigFatImage>* h = BigFatImages.insert(new BigFatImage);
  *     BigFatImages.enforce_limits();
  *     h->ref();
  *
- *     work with image...
+ *     // work with image...
  *
  *     h->unref();
  *
- *     leave image in cache.
+ *     // leave image in cache.
+ * \endcode
  */
 
 #include <list>
index da10e689fbfd831ecae248d19e81571d1aa53617..ea865eadd47ee9bfac6003a383ff8b83e07d5c60 100644 (file)
@@ -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 <stdlib.h> // 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 :
  *  ...
  *  // mechanism to handle object lifetime.
  *  ~RcUsefullClass();
  * };
- *
+ * \endcode
  *
  */
 
@@ -168,7 +171,7 @@ public :
 };
 
 /**
- * @section MEM_RefCountPtr
+ * \section MEM_RefCountPtr
  */
 
 template
index dd19aae9db995cc5a56724226c9038db546d408b..e0d7b81290fb3d259a4d99e9cdfee3b4a11cc41c 100644 (file)
@@ -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];
  *     private :
  *             MEM_SmartPtr<foo> 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<MEM_SmartPtr<foo> > foo_vector;
- * foo_vector.push_back( new foo());
- * foo_vector.push_back( new foo());
+ *     std::vector<MEM_SmartPtr<foo> > 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
index 44ffaad1f48af180131ec97938a055da4ba18ba1..5e9fe378c3817a6c333de0f3746a8a0f54aaf4c2 100644 (file)
 
 /** \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.
  *
index 570c99b7bd9973929f536bcf9963146b21d017c0..287152baf0ae3db424ef0088053288e2211ca9d0 100644 (file)
@@ -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);
index 5c9e516aee936920737d1fa3f3b88d277625bec8..8dac578ac0a113d20800f0e446709ab863ed9b9d 100644 (file)
@@ -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];
 
index bbc175fefcd14dcc47faa682203885773ea24ae7..302d85e81284c698fdd916256dce39c440759b6e 100644 (file)
@@ -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)) {
index e46929dde4ad66dec1113c00888a6eb702bc9974..f6e939a103e455bdf1b9dce39a9645c42dff74a3 100644 (file)
@@ -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)
index 8617132e9880e7c04b8d40ee9d680f1969db11e5..80cbce7e2562b33e76313aab687f7ec5f8473f08 100644 (file)
@@ -258,11 +258,11 @@ int BLI_dynstr_get_len(DynStr *ds)
 
 /**
  * Get a DynStr's contents as a c-string.
- * <i> The str argument must be allocated to be at
- * least the size of BLI_dynstr_get_len(ds) + 1. </i>
+ * 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)
 {
index f77beac1982cc197f9ae3db629b78a6bb806b9a1..740f3cce4a4b6d2dc6da7a26539f6171be863007 100644 (file)
@@ -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.
index edf70a1f188e5d3ad0013ed51909b2c83c9a0120..cde4a8bf59d6e4ddd2965de246d91f5b39fbd67e 100644 (file)
@@ -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)
index 94d18ce3c77732eb3c4bfde76753c7b16da6abcc..f1aff76b358816f470124e2a8ee5740e3c1dcaca 100644 (file)
@@ -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)
index 67ff532cb6f96944996f8ee9fd0d06631daa08a9..22f44a38c7a7175734809eb1117027b445a74eaf 100644 (file)
@@ -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)
 {
index 7b98d7830eeda49dcabec77027e2e478751fbd41..39ffbcd7ebed924e065aa4e212bd2e7af365f0d9 100644 (file)
@@ -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.
index 52a6597c79f0217806091f35a791cf30d4178bcb..6fdcf7065c38ea02a088cacba53c268ee1c9ff8f 100644 (file)
@@ -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(
index 285c50a4049c7d4cd452b48ab014ed81cf486118..43f9fcce76db5a5d04ebcd80d60e5d03fefefef4 100644 (file)
@@ -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
index ee2ade51108c1c58509af16684f3c77335bfa1d4..211b1a23f9c38b4d1a813d0dd4bb66802a17bbb7 100644 (file)
@@ -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.
index 5891876c22c3c8d317238816e9c59bf7c830733f..13c43fabdb01ff238e91b388efafb17bd7eaf29d 100644 (file)
@@ -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
index 47c41c44d81053bdce4e5e1991920e17466864db..fde603971676056cbbc43737e907171b80e2ee1d 100644 (file)
@@ -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],
index e93ffe6b14116bb3a0a194e118d2d67793dc87db..2767f87be4a3a167515d3cddb04d0f377f94a4d3 100644 (file)
@@ -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,
index 74b1660080b171e9693573e3faeaec00f89921eb..a59a5c43c82d5866540336321842e5376ec60b28 100644 (file)
@@ -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.
  */
index 87e571a49aaa251a1d55856133b651fb6302e67c..e79ef52797b220d18ae8eeba12557546d479187f 100644 (file)
@@ -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
index 8b0a617f88912795553a224fa99c0c5383f86bb6..a5d7704a708113185535a08b7abc8e83a461ae1a 100644 (file)
@@ -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.
index 9fc50476e47db9cb789823a82d3b76519c439d0f..b91f99ecd203b6ac980959878a202545b74d911e 100644 (file)
  * 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;
 
index 08b83ac2ea1343c0fced9b4423f0fa17937e06ea..f680c47247a87fd767e21e45488ff0f98d9a155e 100644 (file)
  * Contributor(s): Lukas Toenne
  *
  * ***** END GPL LICENSE BLOCK *****
+ */
+
+/** \file blender/depsgraph/DEG_depsgraph_build.h
+ *  \ingroup depsgraph
  *
  * Public API for Depsgraph
  */
index 60e9a02185479ec6920239e52b719b26875d2969..374fad63c3431bfc2580562998c6a2f373317ef6 100644 (file)
  * Contributor(s): None Yet
  *
  * ***** END GPL LICENSE BLOCK *****
+ */
+
+/** \file blender/depsgraph/DEG_depsgraph_debug.h
+ *  \ingroup depsgraph
  *
  * Public API for Querying and Filtering Depsgraph
  */
index 000497cfac96506df5913b6c3b576f657ffd5f75..60d673d4c5baf0929aaf17bf58bc52a4905a9078 100644 (file)
  * 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__
index c519f1d498e82e90ee941c3b50829463e073d4e7..e9b2a06cf7b1f67737b3275939b9fae2231f0fa6 100644 (file)
  * 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 <string.h>
index c693f4aa3b0bf92ef429a8bcd618be035070c96e..9533fbd10d5c2c48d755aeea68f4f2f030234365 100644 (file)
  * Contributor(s): Sergey Sharybin
  *
  * ***** END GPL LICENSE BLOCK *****
+ */
+
+/** \file blender/depsgraph/intern/depsgraph.h
+ *  \ingroup depsgraph
  *
  * Datatypes for internal use in the Depsgraph
  *
index 15b8cc0fb3a3a89a236b796fef1b3f940c0c2337..7a2ee2c416a494b2dfdea73ebb8bf3d5d2ee2425 100644 (file)
  * 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 <stack>
index 84c09b81508133ed248eebb8a0da80b1630f4871..93fa9e4b0d89f0d4bb813073244a46e6515fbe6c 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/intern/depsgraph_build.h
+ *  \ingroup depsgraph
+ */
+
 #ifndef __DEPSGRAPH_BUILD_H__
 #define __DEPSGRAPH_BUILD_H__
 
index 02538d924802d03e53bfe3034ad355c3ad764a44..c9d2ed35e17ceb4e4d6c402622cf1401f1cb54ad 100644 (file)
  * 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 <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -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)
index b9248318814c4e4012cd60c53b9fc55a2878da9d..fdaee42f3160f8240841cee1340ca3245dac362b 100644 (file)
  * 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
  */
index 7c044980d7f81807983bb6eb1ca8b4d935e6a1b2..59351495df0de5555252c0bed191d162af021c17 100644 (file)
  * Contributor(s): None Yet
  *
  * ***** END GPL LICENSE BLOCK *****
+ */
+
+/** \file blender/depsgraph/intern/depsgraph_debug.cc
+ *  \ingroup depsgraph
  *
  * Implementation of tools for debugging the depsgraph
  */
index aed36f6add6b4fdf9e66a0cad33e59e8479740d1..64b97855f570b7e66dc75b1d1c62ef7ad865893c 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/intern/depsgraph_debug.h
+ *  \ingroup depsgraph
+ */
+
 #ifndef __DEPSGRAPH_DEBUG_H__
 #define __DEPSGRAPH_DEBUG_H__
 
index 11fd02376a32afb6fd7b0659c2b898f9b96f37df..74fa003821aa1a7a2678b7316ec7aa1efbd761e8 100644 (file)
  * 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"
index 70d452bf2217b8158e28c26df746bb7fd3baf86e..7fdc2454564d2da1abdf99d9d4f24357879b7f66 100644 (file)
  * 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"
index aa6f5ef3ea11b8426a784922969152332b931451..73193747b93693811e8802eb2d701a6f92969349 100644 (file)
  * Contributor(s): None Yet
  *
  * ***** END GPL LICENSE BLOCK *****
+ */
+
+/** \file blender/depsgraph/intern/depsgraph_query.cc
+ *  \ingroup depsgraph
  *
  * Implementation of Querying and Filtering API's
  */
index 45290c507067ae241153e5d12c55bb51f87cdb03..da60d73bc460863e121e6e472239fbccd6db31f4 100644 (file)
  * 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 <stdlib.h>
index bd294d4655ed509fe888fe8718b653cfecbc616d..b85d46bd1736f8e79a319119633a25e0ce88a537 100644 (file)
  * 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__
index 8549fce6aed863e58b6eed334ac4221f6357d60d..65109ff94dddf905a9ca4bbdb9f27c6b38355dab 100644 (file)
  * 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 <stdio.h>
index 67c632d4125853e1933e32d87939df86111690f8..5a3048a4aa372dd85be12953a16050fcbed20f79 100644 (file)
  * 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" {
index 713fec8965d43d85bcaeec8def4fca8def44541a..3616fe85496b5b9f68f6119a6c5da65c95c44ef3 100644 (file)
  * Contributor(s): None Yet
  *
  * ***** END GPL LICENSE BLOCK *****
+ */
+
+/** \file blender/depsgraph/intern/depsgraph_types.h
+ *  \ingroup depsgraph
  *
  * Datatypes for internal use in the Depsgraph
  *
index 866e9115648042be0a7b49519fc5d33bc6e4a60a..e108e561f4eb76e20d5a21187507f14155dedb6e 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/intern/depsnode.cc
+ *  \ingroup depsgraph
+ */
+
 #include <stdio.h>
 #include <string.h>
 
index 4f3dc3b730364008f1a04b7bc06cde533ff1cb8b..53826ae8e71ecbd6296221f9c0903c649800a5cb 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/intern/depsnode.h
+ *  \ingroup depsgraph
+ */
+
 #ifndef __DEPSNODE_H__
 #define __DEPSNODE_H__
 
index 969b0891e15093185e46acbad94ba7ea42ee8a9e..1d939c6580d5049b4b8d07a30e397898d840a833 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/intern/depsnode_component.cc
+ *  \ingroup depsgraph
+ */
+
 #include <stdio.h>
 #include <string.h>
 
index 06a18b60abbd972bcde11afa6d98f21fcc77e7e8..e3550bb2371890e329d8db7a66f78e6dd38ebaa3 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/intern/depsnode_component.h
+ *  \ingroup depsgraph
+ */
+
 #ifndef __DEPSNODE_COMPONENT_H__
 #define __DEPSNODE_COMPONENT_H__
 
index 48db2b79e6698bed42513f4c5c6ac67eb947d186..b81822c0ac5ea0bd242af5fbb2ac90483d26015c 100644 (file)
  * ***** 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
index de8755f7ae92dfb4b1524f8551418c96dae4b629..6aeb163356b1d538799fd44fe2ba1724db83039f 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/intern/depsnode_operation.cc
+ *  \ingroup depsgraph
+ */
+
 #include "MEM_guardedalloc.h"
 
 extern "C" {
index 2b70ff0a8dcb120b6db655956d2103f9e0c160f8..1119e10805d96b07114133ff687f0fbf5cc31349 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/intern/depsnode_operation.h
+ *  \ingroup depsgraph
+ */
+
 #ifndef __DEPSNODE_OPERATION_H__
 #define __DEPSNODE_OPERATION_H__
 
index 5a171d190cd814fd16c3ecd029769a664566a55c..5eae8c087adcd409ba3e682a139e4485b9a62a65 100644 (file)
  * All rights reserved.
  *
  * Contributor(s): Sergey Sharybin
+ *
+ * ***** END GPL LICENSE BLOCK *****
+ */
+
+/** \file blender/depsgraph/util/depsgraph_util_cycle.cc
+ *  \ingroup depsgraph
  */
 
 #include <cstdio>
index f827d85c16a3c8d53f6a615313334291cecb32f7..fac38b61057a0fc85c8cf46e9989482132dcb1cf 100644 (file)
  * 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__
index 976a9d6cc2b653ff3bd49ed79979a554cb297667..74bf5de8ab6525ce1f754cca94fa0e0b3ec3ed41 100644 (file)
  *
  * 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__
index 0f5a85b3526353cb2c493fd5830de1ceee3c375b..bc75627a026dd21e3dd7156f81f53dd94d8998a1 100644 (file)
  *
  * 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__
index 2951641431b33ba88f6477639bc6b44f8974db16..0eae1d79e34661068610d9375949a4fd56b0631c 100644 (file)
  *
  * 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__
index 36bd72108edd726ad61b8724ca937212d792db86..80b37ec622dad632aff4e8bd6c710e2d15e0f1d6 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/util/depsgraph_util_pchanmap.cc
+ *  \ingroup depsgraph
+ */
+
 #include "depsgraph_util_pchanmap.h"
 
 #include <stdio.h>
index 82ec8654bc539cb209de42894e9324d2e8d19209..b7f4c4959336b58625392987a7a44b695f6429ea 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/depsgraph/util/depsgraph_util_pchanmap.h
+ *  \ingroup depsgraph
+ */
+
 #ifndef __DEPSGRAPH_UTIL_PCHANMAP_H__
 #define __DEPSGRAPH_UTIL_PCHANMAP_H__
 
index 09fa5313920553b69a592424f5d7cc45aa7d0f7f..008ec6b74ca32b08224fdc28b4340d79a2f8a66d 100644 (file)
  *
  * 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__
index 9411d013c4488f02c1d445426ec52bd1b068f79b..98192a9540fec0b7350ea3c67bb260b16d73bbcc 100644 (file)
  * 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" {
index 8995c18eca0a4c548d8e4bf666166973856b8b48..a80a1d783d7d391d72e9e0ab9adf5d8ede027053 100644 (file)
  *
  * 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__
index 09b97b43ea193b1bef64c4b1a45c322d79f5db5b..5f7eca5f5b01ea30f625defed38cf5f763479dad 100644 (file)
@@ -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)
 {
index 8bdbe23ead8b85d93462d14d3ea5056c64d166b5..19777e0093cc0b3e45bebf825c8a6eb2f324a45d 100644 (file)
@@ -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])
index 7c7f2db09d24f802744fc2f9080ce932f01b7b5b..4a2d05bdf61552ec8f9bfdf35b9522545920d279 100644 (file)
  * \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
index c189dea28a4987c974a10ea833d15afbb506f3a9..1a10b9398a25a73ed6368511078dd9fdad26fb57 100644 (file)
  * ***** END GPL LICENSE BLOCK *****
  */
 
+/** \file blender/physics/intern/BPH_mass_spring.h
+ *  \ingroup bph
+ */
+
 #ifndef __BPH_MASS_SPRING_H__
 #define __BPH_MASS_SPRING_H__
 
index cd3bd5ee45dc9e419b79952a853fe28cb841a24f..e4a4f306aeb95615ce162bbf7ce8aebb580158cd 100644 (file)
@@ -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
  */
 
index d475152f83e3acda52db4cf993ac3abb8d13848d..31a17bd0cbf348b7c1228fe8b2ab71191262fdbf 100644 (file)
@@ -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))