Rewind the entire working directory to a previous commit and start a new branch
from there. Use this if you want to backtrack reversibly. If you want to
wind back irreversibly to a previous commit, use git_undo().
git_checkout(commit, onto_new_branch)Commit object as returned by git_get() or git_history()
Name of new branch to start from this historic commit
Invisible NULL
A typical work flow could be to retract three commits on the master branch.
Use git_checkout(commit=git_get(n=3), onto_new_branch='temp'). Then move back
to the master branch with git_branch('master') and merge the old version back
in with git_merge('temp').
The alternative (git_undo() and then select 3rd commit) will delete all record
of the three intermediate commits in the long run.
As with changing branch, it is forbidden to change with changes yet-to-be-committed. This is to prevent irreversible loss if you ever wanted to change back again.
There is currently no option to checkout a specific file, however this can be
done by calling git_diff() and finding the named 'git4r_abc123' in
tempdir()
git_get, git_history, git_diff, git_undo