add clarification to doc
fix autoscroll implementation (was working as documented only in the updateIsKey case + !addOnTop), improve the documentation and extend the related tests