Bugreport minimal example

.gitignore

@@ -0,0 +1 @@
+_docs

Doxyfile

@@ -0,0 +1,13 @@
+PROJECT_NAME        = "minimal_example"
+
+OUTPUT_DIRECTORY    = "_docs"
+OUTPUT_LANGUAGE     = English
+WARNINGS            = YES
+EXTRACT_ALL         = YES
+FILE_PATTERNS       = *.h *.cpp *.c
+RECURSIVE           = YES
+
+GENERATE_HTML       = YES
+GENERATE_LATEX      = NO
+GENERATE_MAN        = NO
+QUIET               = NO

minimal.h

@@ -0,0 +1,30 @@
+#pragma once
+
+/**
+ * @brief C API header file for something
+ *
+ * General purpose notes on this API:
+ *
+ * - Blah blah
+ * - Blah? Foobar.
+ **/
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*****************************************************************************/
+/* Return values (aka error codes)                                           */
+/*****************************************************************************/
+
+#define RC_NULLPTR 1 ///< One of the parameters was a null pointer
+#define RC_DOMAIN  2 ///< One of the parameters has the wrong pointer type
+#define RC_ERROR   255 ///< An undefined error occurred
+
+// ...
+
+#ifdef __cplusplus
+}
+#endif

minimal_works.h

@@ -0,0 +1,31 @@
+#pragma once
+
+/**
+ * @brief C API header file for something
+ * @file minimal_works.h
+ *
+ * General purpose notes on this API:
+ *
+ * - Blah blah
+ * - Blah? Foobar.
+ **/
+
+#include <stdint.h>
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+/*****************************************************************************/
+/* Return values (aka error codes)                                           */
+/*****************************************************************************/
+
+#define RC_NULLPTR 1 ///< One of the parameters was a null pointer
+#define RC_DOMAIN  2 ///< One of the parameters has the wrong pointer type
+#define RC_ERROR   255 ///< An undefined error occurred
+
+// ...
+
+#ifdef __cplusplus
+}
+#endif