Update README and comments to reflect changes to Tree::Builder

Updating the README to reflect the changes in https://github.com/libgit2/rugged/commit/9dea9516208fe460293643ad601829e0d91e41c3 plus a small change to a comment for clarity.