Cleanup platform_isa_detection

solidpixel · solidpixel · commit fea1f414f2bb · 2021-05-16T20:17:34.000+01:00
diff --git a/Source/astcenc_image.cpp b/Source/astcenc_image.cpp
@@ -147,7 +147,7 @@ static vfloat4 encode_texel_lns(
 	return select(datav_unorm, datav_lns, lns_mask);
 }
 
-/* See header for documentation */
+/* See header for documentation. */
 void fetch_imageblock(
 	astcenc_profile decode_mode,
 	const astcenc_image& img,
diff --git a/Source/astcenc_platform_isa_detection.cpp b/Source/astcenc_platform_isa_detection.cpp
@@ -28,9 +28,16 @@
 #if (ASTCENC_SSE > 0)    || (ASTCENC_AVX > 0) || \
     (ASTCENC_POPCNT > 0) || (ASTCENC_F16C > 0)
 
+/** Does this CPU support SSE 4.1? Set to -1 if not yet initialized. */
 static int g_cpu_has_sse41 = -1;
+
+/** Does this CPU support AVX2? Set to -1 if not yet initialized. */
 static int g_cpu_has_avx2 = -1;
+
+/** Does this CPU support POPCNT? Set to -1 if not yet initialized. */
 static int g_cpu_has_popcnt = -1;
+
+/** Does this CPU support F16C? Set to -1 if not yet initialized. */
 static int g_cpu_has_f16c = -1;
 
 /* ============================================================================
@@ -39,6 +46,9 @@ static int g_cpu_has_f16c = -1;
 #if !defined(__clang__) && defined(_MSC_VER)
 #include <intrin.h>
 
+/**
+ * @brief Detect platform CPU ISA support and update global trackers.
+ */
 static void detect_cpu_isa()
 {
 	int data[4];
@@ -75,6 +85,9 @@ static void detect_cpu_isa()
 #else
 #include <cpuid.h>
 
+/**
+ * @brief Detect platform CPU ISA support and update global trackers.
+ */
 static void detect_cpu_isa()
 {
 	unsigned int data[4];
@@ -101,7 +114,7 @@ static void detect_cpu_isa()
 }
 #endif
 
-/* Public function, see header file for detailed documentation */
+/* See header for documentation. */
 int cpu_supports_sse41()
 {
 	if (g_cpu_has_sse41 == -1)
@@ -112,7 +125,7 @@ int cpu_supports_sse41()
 	return g_cpu_has_sse41;
 }
 
-/* Public function, see header file for detailed documentation */
+/* See header for documentation. */
 int cpu_supports_popcnt()
 {
 	if (g_cpu_has_popcnt == -1)
@@ -123,7 +136,7 @@ int cpu_supports_popcnt()
 	return g_cpu_has_popcnt;
 }
 
-/* Public function, see header file for detailed documentation */
+/* See header for documentation. */
 int cpu_supports_f16c()
 {
 	if (g_cpu_has_f16c == -1)
@@ -134,7 +147,7 @@ int cpu_supports_f16c()
 	return g_cpu_has_f16c;
 }
 
-/* Public function, see header file for detailed documentation */
+/* See header for documentation. */
 int cpu_supports_avx2()
 {
 	if (g_cpu_has_avx2 == -1)

Original file line number	Diff line number	Diff line change
`@@ -147,7 +147,7 @@ static vfloat4 encode_texel_lns(`
`147`	`147`	`return select(datav_unorm, datav_lns, lns_mask);`
`148`	`148`	`}`
`149`	`149`
`150`		`-/* See header for documentation */`
	`150`	`+/* See header for documentation. */`
`151`	`151`	`void fetch_imageblock(`
`152`	`152`	`astcenc_profile decode_mode,`
`153`	`153`	`const astcenc_image& img,`