more formatting fixes, commenting, and added static to the ISR helpers
diff --git a/gyro_board/src/usb/analog.h b/gyro_board/src/usb/analog.h
index 267308b..7b2fb58 100644
--- a/gyro_board/src/usb/analog.h
+++ b/gyro_board/src/usb/analog.h
@@ -19,7 +19,7 @@
 	int32_t capture_wrist_rise;
 	int32_t capture_shooter_angle_rise;
 
-	int8_t  top_rise_count;
+	int8_t top_rise_count;
 
 	int8_t top_fall_count;
 
@@ -32,6 +32,8 @@
 
 	int8_t shooter_angle_rise_count;
 } __attribute__((__packed__));
+// Gets called in the USB data output ISR. Assumes that it will not be preempted
+// except by very high priority things.
 void fillSensorPacket(struct DataStruct *packet);
 
 void analog_init(void);
@@ -39,10 +41,12 @@
 
 int digital(int channel);
 
+void encoder_init(void);
+// For debugging only.
 // Returns the current values of the inputs for the given encoder (as the low 2
 // bits).
 int encoder_bits(int channel);
-void encoder_init(void);
+// Returns the current position of the given encoder.
 int32_t encoder_val(int channel);
 
 int dip(int channel);