From 14ba5087a90fa5761a5ce35534ef455b5df19b9e Mon Sep 17 00:00:00 2001
From: Robert Konrad <git2016@robdangero.us>
Date: Thu, 24 Aug 2023 20:15:58 +0200
Subject: [PATCH] Improve the documentation for set_image_texture

---
 Sources/kinc/graphics4/graphics.h    | 6 ++++--
 Sources/kinc/graphics5/commandlist.h | 6 ++++--
 2 files changed, 8 insertions(+), 4 deletions(-)

diff --git a/Sources/kinc/graphics4/graphics.h b/Sources/kinc/graphics4/graphics.h
index ebd444771..5b0a06d10 100644
--- a/Sources/kinc/graphics4/graphics.h
+++ b/Sources/kinc/graphics4/graphics.h
@@ -357,14 +357,16 @@ KINC_FUNC void kinc_g4_set_render_targets(struct kinc_g4_render_target **targets
 KINC_FUNC void kinc_g4_set_render_target_face(struct kinc_g4_render_target *texture, int face);
 
 /// <summary>
-/// Assigns a texture to a texture-unit for sampled access.
+/// Assigns a texture to a texture-unit for sampled access via GLSL's texture.
 /// </summary>
 /// <param name="unit">The unit to assign this texture to</param>
 /// <param name="texture">The texture to assign to the unit</param>
 KINC_FUNC void kinc_g4_set_texture(kinc_g4_texture_unit_t unit, struct kinc_g4_texture *texture);
 
 /// <summary>
-/// Assigns a texture to a texture-unit for direct access.
+/// Assigns a texture to a texture-unit for direct access via GLSL's texelFetch (as
+/// opposed to GLSL's texture). The name of this functions is unfortunately based
+/// on OpenGL's confusing terminology.
 /// </summary>
 /// <param name="unit">The unit to assign this texture to</param>
 /// <param name="texture">The texture to assign to the unit</param>
diff --git a/Sources/kinc/graphics5/commandlist.h b/Sources/kinc/graphics5/commandlist.h
index 010f900ba..6623fc009 100644
--- a/Sources/kinc/graphics5/commandlist.h
+++ b/Sources/kinc/graphics5/commandlist.h
@@ -273,7 +273,7 @@ KINC_FUNC void kinc_g5_command_list_get_render_target_pixels(kinc_g5_command_lis
 KINC_FUNC void kinc_g5_command_list_compute(kinc_g5_command_list_t *list, int x, int y, int z);
 
 /// <summary>
-/// Assigns a texture to a texture-unit for sampled access.
+/// Assigns a texture to a texture-unit for sampled access via GLSL's texture.
 /// </summary>
 /// <param name="list">The list to write the command to</param>
 /// <param name="unit">The unit to assign this texture to</param>
@@ -281,7 +281,9 @@ KINC_FUNC void kinc_g5_command_list_compute(kinc_g5_command_list_t *list, int x,
 KINC_FUNC void kinc_g5_command_list_set_texture(kinc_g5_command_list_t *list, kinc_g5_texture_unit_t unit, kinc_g5_texture_t *texture);
 
 /// <summary>
-/// Assigns a texture to a texture-unit for direct access.
+/// Assigns a texture to a texture-unit for direct access via GLSL's texelFetch (as
+/// opposed to GLSL's texture). The name of this functions is unfortunately based
+/// on OpenGL's confusing terminology.
 /// </summary>
 /// <param name="list">The list to write the command to</param>
 /// <param name="unit">The unit to assign this texture to</param>