Logging of clamps, saves and restores

include/helpers.h

  *    x;
  *  }
  * }*/
-#define LIGHT_CLAMP(x, y, z) ((x<y) ? y : ((x>z) ? z : x ));
+#define LIGHT_CLAMP(x, y, z) ((x<y) ? (light_logInfClamp(y)) : ((x>z) ? (light_logSupClamp(z)) : x ))
 
 #define LIGHT_LOG_FMT_BUF_SIZE 1024
 /* Verbosity levels: 
 /* Returns TRUE if file is readable, FALSE otherwise */
 LIGHT_BOOL light_isReadable(char const * filename);
 
+double light_logInfClamp(double x);
+
+double light_logSupClamp(double x);
+
 #endif /* LIGHT_HELPERS_H */

src/helpers.c

   fclose(fileHandle);
   return TRUE;
 }
+
+double light_logInfClamp(double x)
+{
+  LIGHT_NOTE_FMT("specified value is inferior to %g, so adjusting it to this mininum value", x);
+  return x;
+}
+
+double light_logSupClamp(double x)
+{
+  LIGHT_NOTE_FMT("specified value is superior to %g, so adjusting it to this maximum value", x);
+  return x;
+}

src/light.c

     return FALSE;
   }
 
+  LIGHT_NOTE_FMT("setting brightness %lu (raw) to controller", v);
   writeVal = light_writeULong(brightnessPath, v);
 
   if(!writeVal)
     *hasMinCap = FALSE;
     *minCap = 0;
     free(mincapPath);
+    LIGHT_NOTE("cap file doesn't exist or can't read from it, so assuming a minimum brightness of 0");
     return TRUE;
   }
 
     return FALSE;
   }
 
+  LIGHT_NOTE_FMT("setting minimum cap to %lu (raw)", v);
   if(!light_writeULong(mincapPath, v))
   {
     LIGHT_ERR("could not write to minimum cap file");
     return FALSE;
   }
 
+  LIGHT_NOTE_FMT("saving brightness %lu (raw) to save file\n", v);
   if(!light_writeULong(savePath, v))
   {
     LIGHT_ERR("could not write to save/restore file");
     return FALSE;
   }
 
+  LIGHT_NOTE("restoring brightness from saved file");
   if(!light_readULong(restorePath, &v))
   {
     LIGHT_ERR("could not read saved value");