Docs: use doxygen formatting for DNA

Differentiate doc-strings from title/section text.
Also use explicit doxygen references to struct members
so it's not ambiguous which member is being referenced.

Note that these changes aren't complete (some files weren't touched).

1 files changed, 11 insertions, 11 deletions

diff --git a/source/blender/makesdna/DNA_volume_types.h b/source/blender/makesdna/DNA_volume_types.h
index 1344f295ea9..df5a122faaf 100644
--- a/source/blender/makesdna/DNA_volume_types.h
+++ b/source/blender/makesdna/DNA_volume_types.h
@@ -30,13 +30,13 @@ struct PackedFile;
 struct VolumeGridVector;
 
 typedef struct Volume_Runtime {
-  /* OpenVDB Grids */
+  /** OpenVDB Grids. */
   struct VolumeGridVector *grids;
 
-  /* Current frame in sequence for evaluated volume */
+  /** Current frame in sequence for evaluated volume. */
   int frame;
 
-  /* Default simplify level for volume grids loaded from files. */
+  /** Default simplify level for volume grids loaded from files. */
   int default_simplify_level;
 } Volume_Runtime;
 
@@ -96,12 +96,12 @@ typedef struct Volume {
   Volume_Runtime runtime;
 } Volume;
 
-/* Volume.flag */
+/** #Volume.flag */
 enum {
   VO_DS_EXPAND = (1 << 0),
 };
 
-/* Volume.sequence_mode */
+/** #Volume.sequence_mode */
 typedef enum VolumeSequenceMode {
   VOLUME_SEQUENCE_CLIP = 0,
   VOLUME_SEQUENCE_EXTEND = 1,
@@ -109,7 +109,7 @@ typedef enum VolumeSequenceMode {
   VOLUME_SEQUENCE_PING_PONG = 3,
 } VolumeSequenceMode;
 
-/* VolumeDisplay.wireframe_type */
+/** #VolumeDisplay.wireframe_type */
 typedef enum VolumeWireframeType {
   VOLUME_WIREFRAME_NONE = 0,
   VOLUME_WIREFRAME_BOUNDS = 1,
@@ -117,32 +117,32 @@ typedef enum VolumeWireframeType {
   VOLUME_WIREFRAME_POINTS = 3,
 } VolumeWireframeType;
 
-/* VolumeDisplay.wireframe_detail */
+/** #VolumeDisplay.wireframe_detail */
 typedef enum VolumeWireframeDetail {
   VOLUME_WIREFRAME_COARSE = 0,
   VOLUME_WIREFRAME_FINE = 1,
 } VolumeWireframeDetail;
 
-/* VolumeRender.space */
+/** #VolumeRender.space */
 typedef enum VolumeRenderSpace {
   VOLUME_SPACE_OBJECT = 0,
   VOLUME_SPACE_WORLD = 1,
 } VolumeRenderSpace;
 
-/* VolumeDisplay.interpolation_method */
+/** #VolumeDisplay.interpolation_method */
 typedef enum VolumeDisplayInterpMethod {
   VOLUME_DISPLAY_INTERP_LINEAR = 0,
   VOLUME_DISPLAY_INTERP_CUBIC = 1,
   VOLUME_DISPLAY_INTERP_CLOSEST = 2,
 } VolumeDisplayInterpMethod;
 
-/* VolumeDisplay.axis_slice_method */
+/** #VolumeDisplay.axis_slice_method */
 typedef enum AxisAlignedSlicingMethod {
   VOLUME_AXIS_SLICE_FULL = 0,
   VOLUME_AXIS_SLICE_SINGLE = 1,
 } AxisAlignedSlicingMethod;
 
-/* VolumeDisplay.slice_axis */
+/** #VolumeDisplay.slice_axis */
 typedef enum SliceAxis {
   VOLUME_SLICE_AXIS_AUTO = 0,
   VOLUME_SLICE_AXIS_X = 1,