git in a few command

Gregory Hainaut 2014-07-20 05:44:15 -07:00
parent 67597bb6cc
commit 8c9071a41c
1 changed files with 44 additions and 0 deletions

44
Git-survival-guide.md Normal file

@ -0,0 +1,44 @@
There is a lots of guide/docs on internet but there are too big and confusing. You will find here a mini guide to use git with a minimal number of command and parameters. You won't find any details or explication of git internal mechanism here.
## Remote Transfer or how to communicate with the world
* Get a fresh repository: git clone `<remote>`
* Update current repository to latest: git fetch -v
* Update current repository with commit from a fork: git fetch -v `<remote>` `<branch>`
* Send your new commit to the remote: git push
## Commit or how to communicate with your local repository
* staged your change: git add/rm -p `<file>`
* commit your change: git commit
* uncommit previous commit: git reset --soft HEAD~1
* unstage your change: git reset HEAD --
* discard your change **forever**: git checkout -p -- `<file>`
## Stash or how to save your precious work
Stash is very useful. For example, your will use it before/after (push/pop) merge/rebase action
* Push pending update on the stack: git stash
* Get back your update: git stash pop
* view content of your stash: git stash show -p `stash@\{0\}`
## Rebase or how to screw the history
**Never** rebase commits that were pushed remotely. Rebase can be used to improve your current patch set, or to fast-forward-merge after a fetch.
* The rebase command: git rebase -i
* Cancel it : git rebase --abort
* Resolve conflict: git mergetool `<file>`
* Continue rebase: git rebase --continue
## Branch or how to separate your work by feature
Please note that master is actually the default branch
* List branches: git branch -v
* Switch to another branch: git checkout `<branch_name>`
* Creates: git branch `<branch_name>`
* Delete branches: git branch -d `<branch_name>`
* Set the base reference of the branch (for rebase): git branch --set-upstream-to=`<remote>` `<branch_name>`
## Branch use case
Let's say you want to rebase your current branch topic-v1 to topic-v2 with new addition. Note topic-v1 could also be master too.
* Go to current branch: git checkout topic-v1
* Create a new one: git branch topic-v2
* Go into the new branch: git checkout topic-v2
* Set the reference: git branch --set-upstream-to=origin/master topic-v2
* Rebase: git rebase -i
* ...