diff options
author | Campbell Barton <ideasman42@gmail.com> | 2019-09-04 20:16:22 +0300 |
---|---|---|
committer | Campbell Barton <ideasman42@gmail.com> | 2019-09-04 20:16:22 +0300 |
commit | 933725ab4643ea9de268ca3be434f2ec0a797aff (patch) | |
tree | 9ca12f3e87f47b7dcca430bdaff7306e0b49a7f0 | |
parent | c7b9ae310b361cdc8a444fe75b8137ec1f586d79 (diff) |
Cleanup: use doxy comments
-rw-r--r-- | source/blender/makesdna/DNA_userdef_types.h | 55 |
1 files changed, 29 insertions, 26 deletions
diff --git a/source/blender/makesdna/DNA_userdef_types.h b/source/blender/makesdna/DNA_userdef_types.h index bee4bec5faf..d19fb000c15 100644 --- a/source/blender/makesdna/DNA_userdef_types.h +++ b/source/blender/makesdna/DNA_userdef_types.h @@ -64,7 +64,7 @@ typedef struct uiFont { char _pad0[2]; } uiFont; -/* this state defines appearance of text */ +/** This state defines appearance of text. */ typedef struct uiFontStyle { /** Saved in file, 0 is default. */ short uifont_id; @@ -430,15 +430,22 @@ typedef enum eWireColor_Flags { TH_WIRECOLOR_TEXTCOLS = (1 << 1), } eWireColor_Flags; -/* A theme */ +/** + * A theme. + * + * \note Currently only a single theme is ever used at once. + * Different theme presets are stored as external files now. + */ typedef struct bTheme { struct bTheme *next, *prev; char name[32]; ThemeUI tui; - /* Individual Spacetypes */ - /* note: ensure UI_THEMESPACE_END is updated when adding */ + /** + * Individual Spacetypes: + * \note Ensure #UI_THEMESPACE_END is updated when adding. + */ ThemeSpace space_properties; ThemeSpace space_view3d; ThemeSpace space_file; @@ -494,7 +501,7 @@ typedef struct bUserMenu { ListBase items; } bUserMenu; -/* May be part of bUserMenu or other list. */ +/** May be part of #bUserMenu or other list. */ typedef struct bUserMenuItem { struct bUserMenuItem *next, *prev; char ui_name[64]; @@ -556,7 +563,7 @@ typedef struct UserDef_Runtime { } UserDef_Runtime; typedef struct UserDef { - /* UserDef has separate do-version handling, and can be read from other files */ + /** UserDef has separate do-version handling, and can be read from other files. */ int versionfile, subversionfile; /** #eUserPref_Flag. */ @@ -640,7 +647,7 @@ typedef struct UserDef { short transopts; short menuthreshold1, menuthreshold2; - /* startup template */ + /** Startup application template. */ char app_template[64]; struct ListBase themes; @@ -835,7 +842,7 @@ typedef enum eUserPref_Section { USER_SECTION_FILE_PATHS = 15, } eUserPref_Section; -/* UserDef.userpref_flag (State of the user preferences UI). */ +/** UserDef.userpref_flag (State of the user preferences UI). */ typedef enum eUserPref_SectionFlag { /* Hide/expand keymap preferences. */ USER_SECTION_INPUT_HIDE_UI_KEYCONFIG = (1 << 0), @@ -1091,26 +1098,23 @@ typedef enum eColorPicker_Types { /** Timecode display styles * #UserDef.timecode_style */ typedef enum eTimecodeStyles { - /* as little info as is necessary to show relevant info - * with '+' to denote the frames - * i.e. HH:MM:SS+FF, MM:SS+FF, SS+FF, or MM:SS + /** + * As little info as is necessary to show relevant info with '+' to denote the frames + * i.e. HH:MM:SS+FF, MM:SS+FF, SS+FF, or MM:SS. */ USER_TIMECODE_MINIMAL = 0, - - /* reduced SMPTE - (HH:)MM:SS:FF */ + /** Reduced SMPTE - (HH:)MM:SS:FF */ USER_TIMECODE_SMPTE_MSF = 1, - - /* full SMPTE - HH:MM:SS:FF */ + /** Full SMPTE - HH:MM:SS:FF */ USER_TIMECODE_SMPTE_FULL = 2, - - /* milliseconds for sub-frames - HH:MM:SS.sss */ + /** Milliseconds for sub-frames - HH:MM:SS.sss. */ USER_TIMECODE_MILLISECONDS = 3, - - /* seconds only */ + /** Seconds only. */ USER_TIMECODE_SECONDS_ONLY = 4, - - /* Private (not exposed as generic choices) options. */ - /* milliseconds for sub-frames , SubRip format- HH:MM:SS,sss */ + /** + * Private (not exposed as generic choices) options. + * milliseconds for sub-frames , SubRip format- HH:MM:SS,sss. + */ USER_TIMECODE_SUBRIP = 100, } eTimecodeStyles; @@ -1120,15 +1124,14 @@ typedef enum eNdof_Flag { NDOF_FLY_HELICOPTER = (1 << 1), NDOF_LOCK_HORIZON = (1 << 2), - /* the following might not need to be saved between sessions, - * but they do need to live somewhere accessible... */ + /* The following might not need to be saved between sessions, + * but they do need to live somewhere accessible. */ NDOF_SHOULD_PAN = (1 << 3), NDOF_SHOULD_ZOOM = (1 << 4), NDOF_SHOULD_ROTATE = (1 << 5), - /* orbit navigation modes */ + /* Orbit navigation modes. */ - /* exposed as Orbit|Explore in the UI */ NDOF_MODE_ORBIT = (1 << 6), /* actually... users probably don't care about what the mode |