Replace with the contents of 
git_index_read_tree_with_stats() and improve
documentation comments.