Documentation, cleanup and improvements

 * don't need to call digitalRead anymore in the capture ISR.  Just use
the rising/falling edge trigger setting to infer.
 * turn off interrupts during setup()
 * changed some function names for improved clarity