*** You can now arrange to call a function whenever Emacs is idle for
a certain length of time. To do this, call run-with-idle-timer. A call looks like this:

(run-with-idle-timer SECS REPEAT FUNCTION ARGS...)

SECS says how many seconds of idleness should elapse before the timer runs. It may be an integer or a floating point number. When the timer becomes ripe, the action is to call FUNCTION with arguments ARGS.

Emacs becomes idle whenever it finishes executing a keyboard or mouse command. It remains idle until it receives another keyboard or mouse command.

REPEAT, if non-nil, means this timer should be activated again each time Emacs becomes idle and remains idle for SECS seconds The timer does not repeat if Emacs *remains* idle; it runs at most once after each time Emacs becomes idle.

If REPEAT is nil, the timer runs just once, the first time Emacs is idle for SECS seconds.