<--- FIXED ---> ./src/sys/tests/linter/testValidEnumDocstrings.c:12:11: error: seealso symbol 'Lorem' not enclosed with '`' [-fdoc-inline-list-seealso-backticks]: 10: Level: advanced 11: > 12: .seealso: Lorem ^^^^^ 13: E*/ 14: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:27:1: error: Invalid indentation (0), all regular (non-empty, non-parameter, non-seealso) text must be indented to 2 columns [-fdoc-indentation]: 25: $ AMET - An amet 26: $ADAPISCING - an adapiscing > 27: Level: advanced ^ 28: */ 29: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:27:1: error: Missing empty line between sections, must have one before this section [-fdoc-section-spacing]: 25: $ AMET - An amet 26: $ADAPISCING - an adapiscing > 27: Level: advanced 28: */ 29: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:37:3: error: Docstring name 'bdSpllingenUm' does not match symbol. Assuming you meant 'BadSpellingEnum' [-fdoc-synopsis-matching-symbol-name]: 35: 36: /*E > 37: bdSpllingenUm - Lorem ipsum dolor ^^^^^^^^^^^^^ 38: 39: Not Collective ./src/sys/tests/linter/testValidEnumDocstrings.c:46:11: error: seealso values must be (1) space away from colon not (25) [-fdoc-inline-list-formatting]: 44: a note 45: > 46: .seealso:  IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:94: error: Found self-referential seealso entry 'BadSpellingEnum'; your documentation may be good but it's not *that* good [-fdoc-inline-list-seealso-self-reference]: 44: a note 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:110: error: Found self-referential seealso entry 'BadSpellingEnum'; your documentation may be good but it's not *that* good [-fdoc-inline-list-seealso-self-reference]: 44: a note 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:35: error: seealso symbol 'IllFormedEnum' not enclosed with '`' [-fdoc-inline-list-seealso-backticks]: 44: a note 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:49: error: seealso symbol 'WellFormedEnum' not enclosed with '`' [-fdoc-inline-list-seealso-backticks]: 44: a note 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:64: error: seealso symbol 'WellFormedEnum' not enclosed with '`' [-fdoc-inline-list-seealso-backticks]: 44: a note 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:79: error: seealso symbol 'WellFormedEnum' not enclosed with '`' [-fdoc-inline-list-seealso-backticks]: 44: a note 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:64: error: Seealso entry 'WellFormedEnum' is duplicate [-fdoc-inline-list-seealso-duplicate]: 44: a note 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:49 Note: first instance found here: 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^ 47: */ ./src/sys/tests/linter/testValidEnumDocstrings.c:46:79: error: Seealso entry 'WellFormedEnum' is duplicate [-fdoc-inline-list-seealso-duplicate]: 44: a note 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^ 47: */ 48: typedef enum { ./src/sys/tests/linter/testValidEnumDocstrings.c:46:49 Note: first instance found here: 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum ^^^^^^^^^^^^^^ 47: */ <--- LEFT ---> ./src/sys/tests/linter/testValidEnumDocstrings.c:21:1: error: Synopsis seems to be missing a description separator; I suspect you may be using ' ' as a separator instead of '-'. Expected 'IllFormedEnum - -' [-fdoc-synopsis-wrong-description-separator]: 19: 20: /*E > 21:  IllFormedEnum - ^^^^^^^^^^^^^^^^^ 22: 23: $ SIT- A sit ./src/sys/tests/linter/testValidEnumDocstrings.c:20:1: error: Required section '.seealso' not found [-fdoc-section-header-missing]: 18: } WellFormedEnum; 19: > 20: /*E > 21: IllFormedEnum - > 22: > 23: $ SIT- A sit > 24: $ CONSECTETUR - A consectetur > 25: $ AMET - An amet > 26: $ADAPISCING - an adapiscing > 27: Level: advanced > 28: */ 29: typedef enum { 30: SIT, ./src/sys/tests/linter/testValidEnumDocstrings.c:36:1: error: Required section 'Level' not found [-fdoc-section-header-missing]: 34: } IllFormedEnum; 35: > 36: /*E > 37: bdSpllingenUm - Lorem ipsum dolor > 38: > 39: Not Collective > 40: > 41: $ FOO - a foo > 42: > 43: Notes: > 44: a note > 45: > 46: .seealso: IllFormedEnum,WellFormedEnum,WellFormedEnum,WellFormedEnum,BadSpellingEnum,BadSpellingEnum > 47: */ 48: typedef enum { 49: FOO