give handler parameter in animate*( the use it was supposed to have
JSDoc updated with return descriptions