| git_checkout {git4r} | R Documentation |
Git Checkout Commit
Description
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().
Usage
git_checkout(commit, onto_new_branch)
Arguments
commit |
Commit object as returned by git_get() or git_history() |
onto_new_branch |
Name of new branch to start from this historic commit |
Details
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()
Value
Invisible NULL
See Also
git_get, git_history, git_diff, git_undo