diff options
author | Campbell Barton <ideasman42@gmail.com> | 2015-07-31 15:59:02 +0300 |
---|---|---|
committer | Campbell Barton <ideasman42@gmail.com> | 2015-07-31 16:44:37 +0300 |
commit | 03f00eb91d873cc118a100d6e5b5d7bf801dd451 (patch) | |
tree | ce48560052400014fae1ca335c333caad57daa5d /source | |
parent | 12b7850d4fcd420f23f80c16a85f08d7cd9158f5 (diff) |
Docs: doxy corrections
Diffstat (limited to 'source')
-rw-r--r-- | source/blender/blenlib/BLI_linklist_stack.h | 2 | ||||
-rw-r--r-- | source/blender/blenlib/intern/gsqueue.c | 2 | ||||
-rw-r--r-- | source/blender/bmesh/bmesh.h | 5 | ||||
-rw-r--r-- | source/blender/bmesh/intern/bmesh_polygon.c | 2 | ||||
-rw-r--r-- | source/blender/editors/space_view3d/view3d_camera_control.c | 2 | ||||
-rw-r--r-- | source/blender/editors/transform/transform.c | 2 | ||||
-rw-r--r-- | source/blender/makesdna/intern/dna_genfile.c | 4 | ||||
-rw-r--r-- | source/blender/python/generic/bgl.c | 8 | ||||
-rw-r--r-- | source/blender/render/intern/include/shadbuf.h | 3 |
9 files changed, 13 insertions, 17 deletions
diff --git a/source/blender/blenlib/BLI_linklist_stack.h b/source/blender/blenlib/BLI_linklist_stack.h index a4b8f77bfa6..c5f9be927d3 100644 --- a/source/blender/blenlib/BLI_linklist_stack.h +++ b/source/blender/blenlib/BLI_linklist_stack.h @@ -37,7 +37,7 @@ * \note These macros follow STACK_* macros defined in 'BLI_utildefines.h' * and should be kept (mostly) interchangeable. * - * \note _##var##_type is a dummy var only used for typechecks. + * \note ``_##var##_type`` is a dummy variable only used for typechecks. */ /* -------------------------------------------------------------------- */ diff --git a/source/blender/blenlib/intern/gsqueue.c b/source/blender/blenlib/intern/gsqueue.c index f1aff76b358..25da7701924 100644 --- a/source/blender/blenlib/intern/gsqueue.c +++ b/source/blender/blenlib/intern/gsqueue.c @@ -32,7 +32,7 @@ * (a queue for fixed length generally small) structures. * * \note Only use this if you need (first-in-first-out), - * otherwise #BLI_stack is more efficient (first-in-last-out). + * otherwise #BLI_Stack is more efficient (first-in-last-out). */ #include <string.h> diff --git a/source/blender/bmesh/bmesh.h b/source/blender/bmesh/bmesh.h index 87b1818fa5d..9bb7bc33e29 100644 --- a/source/blender/bmesh/bmesh.h +++ b/source/blender/bmesh/bmesh.h @@ -107,7 +107,8 @@ * \subsection bm_iter_api Iterator API * * Most topological queries in BMesh go through an iterator API (see Queries above). - * These are defined in bmesh_iterators.h. If you can, please use the #BM_ITER macro in bmesh_iterators.h + * These are defined in bmesh_iterators.h. + * If you can, please use the #BM_ITER_MESH, #BM_ITER_ELEM macros in bmesh_iterators.h * * * \subsection bm_walker_api Walker API @@ -161,7 +162,7 @@ * - integer - #BMO_OP_SLOT_INT * - boolean - #BMO_OP_SLOT_BOOL * - float - #BMO_OP_SLOT_FLT - * - pointer - #BMO_OP_SLOT_PNT + * - pointer - #BMO_OP_SLOT_PTR * - matrix - #BMO_OP_SLOT_MAT * - vector - #BMO_OP_SLOT_VEC * - buffer - #BMO_OP_SLOT_ELEMENT_BUF - a list of verts/edges/faces. diff --git a/source/blender/bmesh/intern/bmesh_polygon.c b/source/blender/bmesh/intern/bmesh_polygon.c index 6a75540eacf..b0eddf73960 100644 --- a/source/blender/bmesh/intern/bmesh_polygon.c +++ b/source/blender/bmesh/intern/bmesh_polygon.c @@ -99,7 +99,7 @@ static float bm_face_calc_poly_normal(const BMFace *f, float n[3]) /** * \brief COMPUTE POLY NORMAL (BMFace) * - * Same as #calc_poly_normal and #bm_face_calc_poly_normal + * Same as #bm_face_calc_poly_normal * but takes an array of vertex locations. */ static float bm_face_calc_poly_normal_vertex_cos( diff --git a/source/blender/editors/space_view3d/view3d_camera_control.c b/source/blender/editors/space_view3d/view3d_camera_control.c index 95e918abdcf..f717f1c0a43 100644 --- a/source/blender/editors/space_view3d/view3d_camera_control.c +++ b/source/blender/editors/space_view3d/view3d_camera_control.c @@ -133,7 +133,7 @@ Object *ED_view3d_cameracontrol_object_get(View3DCameraControl *vctrl) /** - * Creates a #View3DControl handle and sets up + * Creates a #View3DCameraControl handle and sets up * the view for first-person style navigation. */ struct View3DCameraControl *ED_view3d_cameracontrol_acquire( diff --git a/source/blender/editors/transform/transform.c b/source/blender/editors/transform/transform.c index cb039ebca8f..adef32dd4ca 100644 --- a/source/blender/editors/transform/transform.c +++ b/source/blender/editors/transform/transform.c @@ -6313,7 +6313,7 @@ static bool createEdgeSlideVerts_double_side(TransInfo *t) } /** - * A simple version of #createEdgeSlideVerts + * A simple version of #createEdgeSlideVerts_double_side * Which assumes the longest unselected. */ static bool createEdgeSlideVerts_single_side(TransInfo *t) diff --git a/source/blender/makesdna/intern/dna_genfile.c b/source/blender/makesdna/intern/dna_genfile.c index 389e22b2a0c..499c430306b 100644 --- a/source/blender/makesdna/intern/dna_genfile.c +++ b/source/blender/makesdna/intern/dna_genfile.c @@ -64,7 +64,7 @@ * * Create a structDNA: only needed when one of the input include (.h) files change. * File Syntax: - * <pre> + * \code{.unparsed} * SDNA (4 bytes) (magic number) * NAME (4 bytes) * <nr> (4 bytes) amount of names (int) @@ -86,7 +86,7 @@ * STRC (4 bytes) * <nr> amount of structs (int) * <typenr><nr_of_elems> <typenr><namenr> <typenr><namenr> ... - *</pre> + * \endcode * * **Remember to read/write integer and short aligned!** * diff --git a/source/blender/python/generic/bgl.c b/source/blender/python/generic/bgl.c index 6dc606f3dca..8682b860fe3 100644 --- a/source/blender/python/generic/bgl.c +++ b/source/blender/python/generic/bgl.c @@ -435,9 +435,7 @@ /* -------------------------------------------------------------------- */ - -/** \name Forward Declarations - * \{ */ +/* Forward Declarations */ static PyObject *Buffer_new(PyTypeObject *type, PyObject *args, PyObject *kwds); static PyObject *Method_ShaderSource(PyObject *self, PyObject *args); @@ -452,8 +450,6 @@ static int Buffer_ass_slice(Buffer *self, int begin, int end, PyObject *seq); static PyObject *Buffer_subscript(Buffer *self, PyObject *item); static int Buffer_ass_subscript(Buffer *self, PyObject *item, PyObject *value); -/** \} */ - /* -------------------------------------------------------------------- */ @@ -756,7 +752,7 @@ static PyObject *Buffer_new(PyTypeObject *UNUSED(type), PyObject *args, PyObject return (PyObject *)buffer; } -/*@ Buffer sequence methods */ +/* Buffer sequence methods */ static int Buffer_len(Buffer *self) { diff --git a/source/blender/render/intern/include/shadbuf.h b/source/blender/render/intern/include/shadbuf.h index ece6902b6b2..ddf5de8d974 100644 --- a/source/blender/render/intern/include/shadbuf.h +++ b/source/blender/render/intern/include/shadbuf.h @@ -56,8 +56,7 @@ void threaded_makeshadowbufs(struct Render *re); float testshadowbuf(struct Render *re, struct ShadBuf *shb, const float rco[3], const float dxco[3], const float dyco[3], float inp, float mat_bias); /** - * Determines the shadow factor for lamp <lar>, between <p1> - * and <p2>. (Which CS?) + * Determines the shadow factor for lamp \a lar, between \a p1 and \a p2. (Which CS?) */ float shadow_halo(LampRen *lar, const float p1[3], const float p2[3]); |