Document the event generating methods
describe return values