adding more generic event documentation, replaces timers, documents watch-fd function