From a04413eaece21683c6490d30208659a4335a5cac Mon Sep 17 00:00:00 2001
From: Kevin Day <thekevinday@gmail.com>
Date: Wed, 11 Sep 2019 22:43:36 -0500
Subject: [PATCH] Update: document f_type, switch f_bool fom unsigned short to
 uint8_t

---
 level_0/f_type/c/type.h       | 30 +++++++++++++++++++++++++-----
 level_0/f_type/c/type_array.h |  7 +++++--
 2 files changed, 30 insertions(+), 7 deletions(-)

diff --git a/level_0/f_type/c/type.h b/level_0/f_type/c/type.h
index 0b43942..6576c74 100644
--- a/level_0/f_type/c/type.h
+++ b/level_0/f_type/c/type.h
@@ -34,10 +34,16 @@
 extern "C" {
 #endif
 
+/**
+ * Boolean type.
+ */
 #ifndef _di_f_type_bool_
-  typedef unsigned short f_bool;
+  typedef uint8_t f_bool;
 #endif // _di_f_type_bool_
 
+/**
+ * Status type.
+ */
 #ifndef _di_f_type_status_
   typedef uint16_t f_status;
 
@@ -71,14 +77,19 @@ extern "C" {
   #define f_signed_long_long_size     ((((unsigned long long) -1) / 2) - 1)
 #endif // _di_f_type_sizes_
 
-
-#ifndef _di_f_type_standard_output_
+/**
+ * Standard Input/Output types.
+ *
+ * For most systems, there is no standard warning nor is there a standard debug.
+ * Therefore, these will map to standard output.
+ */
+#ifndef _di_f_type_standard_input_output_
   #define f_standard_debug   stdout
   #define f_standard_error   stderr
   #define f_standard_input   stdin
   #define f_standard_output  stdout
   #define f_standard_warning stdout
-#endif // _di_f_type_standard_output_
+#endif // _di_f_type_standard_input_output_
 
 /**
  * Defines a variable to be used by arrays.
@@ -89,8 +100,17 @@ extern "C" {
   typedef long long f_array_length_long;
 #endif // _di_f_array_length_
 
+/**
+ * GCC-specific features.
+ *
+ * Use these macros for GCC-specific tweaks so that if GCC is not supported then they can be easily disabled.
+ *
+ * f_gcc_attribute_visibility_internal provides a way to make some functions effectively private.
+ *
+ * @todo there is probably some sort of macro that GCC likely defines that can be utilized here to automatically enable/disable this.
+ */
 #ifndef _di_f_gcc_specific_
-#define f_gcc_attribute_visibility_internal __attribute__((visibility("internal")))
+  #define f_gcc_attribute_visibility_internal __attribute__((visibility("internal")))
 #endif // _di_f_gcc_specific_
 
 #ifdef __cplusplus
diff --git a/level_0/f_type/c/type_array.h b/level_0/f_type/c/type_array.h
index a7eaef2..5a7d7f4 100644
--- a/level_0/f_type/c/type_array.h
+++ b/level_0/f_type/c/type_array.h
@@ -19,8 +19,11 @@ extern "C" {
 #endif
 
 /**
- * size: total amount of allocated space.
- * used: total number of allocated spaces used.
+ * An array of array lengths.
+ *
+ * array: An array of array lengths.
+ * size:  Total amount of allocated space.
+ * used:  Total number of allocated spaces used.
  */
 #ifndef _di_f_array_lengths_
   typedef struct {
-- 
1.8.3.1