updated readme, sorted includes, added comments

play_raw_audio.c

@@ -8,6 +8,7 @@
 #include <string.h>
 #include <unistd.h>
 
+// prototypes for static functions
 static int play_square_wave(float frequency, float duration);
 
 int play_manual_alarm() {
@@ -26,6 +27,8 @@ int play_manual_alarm() {
 	return 0;
 }
 
+// UNUSED
+// Playing a raw audio file has the downside of depending on a file.
 int play_raw_audio(char file_name[]) {
 	int pa_error = 0;
 	char content[1024] = "";