FYI the above seems more obvious then what's in the man page:
"It updates the named paths in the working tree from the
index file (i.e. it runs git-checkout-index -f -u)."
But for me saying something like;
"It reverts the paths in the working tree to the most recent version stored in git."
would even be better. It may not be as precise as the current sentence,
but more obvious to this neophyte. Finally, in the EXAMPLES you
might add another example of reverting a "modified the file" as
well as recovering a deleted file.
In any case thanks,
Wink
-