Cleanup: document f_status

diff --git a/level_0/f_status/c/status.h b/level_0/f_status/c/status.h
index 54206263b88a009d558faea3aee20a47d220f2c1..4ae60c1ed1a8b36d7cb9ba4f0f695f9dc6e346c1 100644 (file)
--- a/level_0/f_status/c/status.h
+++ b/level_0/f_status/c/status.h
@@ -19,6 +19,9 @@
 extern "C" {
 #endif
 
+/**
+ * Status masks.
+ */
 #ifndef _di_f_status_masks_
   // f_status is required to be exactly 16 bits, the first two high order bits represent error and warning respectively.
   #define f_status_bit_error   0x8000 // 1000 0000 0000 0000
@@ -46,7 +49,11 @@ extern "C" {
   #define f_status_set_fine(status) (status & f_status_mask_fine)
 #endif // _di_f_status_masks_
 
-// use of an enumerator makes more sense here than explicitly defining every error code (or return code).
+/**
+ * All standard/core status codes.
+ *
+ * The code f_last_status_code is intended to be used as the starting point for anything extending this and povided its own status codes.
+ */
 enum {
   #ifndef _di_f_status_booleans_
     f_false = 0,