Add documentation to new functions

Author: TellowKrinkle

cmake/Platform/Other/ArduinoSDKSeeker.cmake

@@ -40,6 +40,14 @@ function(find_arduino_sdk _return_var)
 
 endfunction()
 
+#=============================================================================#
+# Attempts to find the Arduino SDK's bin folder in the host system, searching at known locations.
+# Most installs will have it at SDK/hardware/tools/avr/bin but if nothing is there, it will 
+# attempt to find a folder in PATH containing avr-gcc, hoping that everything else will be there too
+# This is because a bunch of linux distros' package managers install the binaries into /usr/bin
+#       _return_var - Name of variable in parent-scope holding the return value.
+#       Returns - Path to the folder containing Arduino compiler binaries
+#=============================================================================#
 function(find_arduino_sdk_bin _return_var)
 
     if (DEFINED ENV{ARDUINO_SDK_BIN_PATH})
@@ -63,6 +71,14 @@ function(find_arduino_sdk_bin _return_var)
 
 endfunction()
 
+#=============================================================================#
+# Attempts to find the Arduino SDK's root folder in the host system, searching at known locations.
+# Most installs will have it at SDK/hardware/tools/avr/ but if nothing is there, it will 
+# attempt to find a folder containing etc/avrdude.conf, since a bunch of linux distros
+# put this into /etc rather than a subdirectory of the arduino SDK
+#       _return_var - Name of variable in parent-scope holding the return value.
+#       Returns - Path to the directory containing etc/avrdude.conf
+#=============================================================================#
 function(find_arduino_sdk_root _return_var)
 
     if (DEFINED ENV{ARDUINO_SDK_ROOT_PATH})