I opened this as a reaction to seeing quite some confusion about the API on StackOverflow, but I'm no longer sure if this should be changed.

I think the current API makes actually sense - we could switch to long for consistency but perhaps that would make the differences of the two methods less clear? One being incremental and referring to the current progress increment, the other being about the larger total amount of entries.

The confusion could be avoided by improving the javadoc alone? Open to proposals.