add 'included' defines to all sokol headers for better error messages when included are missing

imgui/sokol_gfx_imgui.h

@@ -126,6 +126,10 @@
 #include <stdint.h>
 #include <stdbool.h>
 
+#if !defined(SOKOL_GFX_INCLUDED)
+#error "Please include sokol_gfx.h before sokol_gfx_imgui.h"
+#endif
+
 #if defined(__cplusplus)
 extern "C" {
 #endif
@@ -578,6 +582,13 @@ SOKOL_API_DECL void sg_imgui_draw_capture_window(sg_imgui_t* ctx);
 
 /*=== IMPLEMENTATION =========================================================*/
 #if defined SOKOL_IMPL
+#if !defined(SOKOL_GFX_IMPL_INCLUDED)
+#error "Please include the sokol_gfx.h implementation before the sokol_gfx_imgui.h implementation"
+#endif
+#if !defined(IMGUI_VERSION)
+#error "Please include imgui.h before the sokol_gfx_imgui.h implementation"
+#endif
+
 #include <string.h>
 #include <stdio.h>      /* snprintf */
 

sokol_app.h

@@ -382,6 +382,7 @@
         3. This notice may not be removed or altered from any source
         distribution.
 */
+#define SOKOL_APP_INCLUDED (1)
 #include <stdint.h>
 #include <stdbool.h>
 
@@ -659,6 +660,7 @@ SOKOL_API_DECL int sapp_run(const sapp_desc* desc);
 
 /*-- IMPLEMENTATION ----------------------------------------------------------*/
 #ifdef SOKOL_IMPL
+#define SOKOL_APP_IMPL_INCLUDED (1)
 
 #ifdef _MSC_VER
 #pragma warning(push)

sokol_args.h

@@ -232,6 +232,7 @@
         3. This notice may not be removed or altered from any source
         distribution.
 */
+#define SOKOL_ARGS_INCLUDED (1)
 #include <stdint.h>
 #include <stdbool.h>
 
@@ -281,6 +282,7 @@ SOKOL_API_DECL const char* sargs_value_at(int index);
 
 /*--- IMPLEMENTATION ---------------------------------------------------------*/
 #ifdef SOKOL_IMPL
+#define SOKOL_ARGS_IMPL_INCLUDED (1)
 #include <string.h> /* memset, strcmp */
 
 #if defined(__EMSCRIPTEN__)

sokol_audio.h

@@ -352,6 +352,7 @@
         3. This notice may not be removed or altered from any source
         distribution.
 */
+#define SOKOL_AUDIO_INCLUDED (1)
 #include <stdint.h>
 #include <stdbool.h>
 
@@ -397,6 +398,7 @@ SOKOL_API_DECL int saudio_push(const float* frames, int num_frames);
 
 /*=== IMPLEMENTATION =========================================================*/
 #ifdef SOKOL_IMPL
+#define SOKOL_AUDIO_IMPL_INCLUDED (1)
 #include <string.h> /* memset, memcpy */
 
 #ifndef SOKOL_API_IMPL

sokol_gfx.h

@@ -406,6 +406,7 @@
         3. This notice may not be removed or altered from any source
         distribution.
 */
+#define SOKOL_GFX_INCLUDED (1)
 #include <stdint.h>
 #include <stdbool.h>
 
@@ -1749,6 +1750,8 @@ SOKOL_API_DECL void sg_apply_uniform_block(sg_shader_stage stage, int ub_index,
 
 /*--- IMPLEMENTATION ---------------------------------------------------------*/
 #ifdef SOKOL_IMPL
+#define SOKOL_GFX_IMPL_INCLUDED (1)
+
 #if !(defined(SOKOL_GLCORE33)||defined(SOKOL_GLES2)||defined(SOKOL_GLES3)||defined(SOKOL_D3D11)||defined(SOKOL_METAL)||defined(SOKOL_DUMMY_BACKEND))
 #error "Please select a backend with SOKOL_GLCORE33, SOKOL_GLES2, SOKOL_GLES3, SOKOL_D3D11, SOKOL_METAL or SOKOL_DUMMY_BACKEND"
 #endif

sokol_time.h

@@ -79,6 +79,7 @@
         3. This notice may not be removed or altered from any source
         distribution.
 */
+#define SOKOL_TIME_INCLUDED (1)
 #include <stdint.h>
 
 #ifndef SOKOL_API_DECL
@@ -105,6 +106,7 @@ SOKOL_API_DECL double stm_ns(uint64_t ticks);
 
 /*-- IMPLEMENTATION ----------------------------------------------------------*/
 #ifdef SOKOL_IMPL
+#define SOKOL_TIME_IMPL_INCLUDED (1)
 #include <string.h> /* memset */
 
 #ifndef SOKOL_API_IMPL

util/README.md

@@ -0,0 +1,7 @@
+# Sokol Utility Headers
+
+These are optional utility headers on top of the Sokol headers. Unlike the
+'core headers' they are not standalone, and usually do not contain
+platform specific code.
+
+FIXME: overview of the headers, and general usage instructions.