document AbstractPagination::getTotalItemCount()

I found this awesome method in the code, I think it should be documented