A flag you can set and process on your own. All the library does with it is set it to false when it handles an event, otherwise you can do whatever you want with it.

In my irc client, I use this to add a * to the tab to indicate new messages.