to the project, including subdirectories
git add .
add all files under the current directory to the project
*WARNING*: including untracked files.
git rm ...
remove , , etc... from the project
git rm $(git ls-files --deleted)
remove all deleted files from the project
git rm --cached ...
commits absence of , , etc... from the project
Ignoring
---------
Option 1:
Edit $GIT_DIR/info/exclude. See Environment Variables below for explanation on
$GIT_DIR.
Option 2:
Add a file .gitignore to the root of your project. This file will be checked in.
Either way you need to add patterns to exclude to these files.
Staging
-------
git add ...
git stage ...
add changes in , ... to the staging area (to be included in
the next commit
git add -p
git stage --patch
interactively walk through the current changes (hunks) in the working
tree, and decide which changes to add to the staging area.
git add -i
git stage --interactive
interactively add files/changes to the staging area. For a simpler
mode (no menu), try `git add --patch` (above)
Unstaging
---------
git reset HEAD ...
remove the specified files from the next commit
Committing
----------
git commit ... [-m ]
commit , , etc..., optionally using commit message ,
otherwise opening your editor to let you type a commit message
git commit -a
commit all files changed since your last commit
(does not include new (untracked) files)
git commit -v
commit verbosely, i.e. includes the diff of the contents being committed in
the commit message screen
git commit --amend
edit the commit message of the most recent commit
git commit --amend ...
redo previous commit, including changes made to , , etc...
Branching
---------
git branch
list all local branches
git branch -r
list all remote branches
git branch -a
list all local and remote branches
git branch
create a new branch named , referencing the same point in history as
the current branch
git branch
create a new branch named , referencing , which may be
specified any way you like, including using a branch name or a tag name
git push :refs/heads/
create a new remote branch named , referencing on the
remote.
Example: git push origin origin:refs/heads/branch-1
Example: git push origin origin/branch-1:refs/heads/branch-2
git branch --track
create a tracking branch. Will push/pull changes to/from another repository.
Example: git branch --track experimental origin/experimental
git branch -d
delete the branch ; if the branch you are deleting points to a
commit which is not reachable from the current branch, this command
will fail with a warning.
git branch -r -d
delete a remote-tracking branch.
Example: git branch -r -d wycats/master
git branch -D
even if the branch points to a commit not reachable from the current branch,
you may know that that commit is still reachable from some other branch or
tag. In that case it is safe to use this command to force git to delete the
branch.
git checkout
make the current branch , updating the working directory to reflect
the version referenced by
git checkout -b
create a new branch referencing , and check it out.
git push :
removes a branch from a remote repository.
Example: git push origin :old_branch_to_be_deleted
Checkout a file from another branch and add it to this branch. File
will still need to be added to the git branch, but it's present.
Eg. git co remote_at_origin__tick702_antifraud_blocking
..../...nt_elements_for_iframe_blocked_page.rb
Eg. git show remote_tick702 -- path/to/fubar.txt
show the contents of a file that was created on another branch and that
does not exist on the current branch.
git show :
Show the contents of a file at the specific revision. Note: path has to be
absolute within the repo.
Merging
-------
git merge
merge branch into the current branch; this command is idempotent
and can be run as many times as needed to keep the current branch
up-to-date with changes in
git merge --no-commit
merge branch into the current branch, but do not autocommit the
result; allows you to make further tweaks
git merge -s ours
merge branch into the current branch, but drops any changes in
, using the current tree as the new tree
Cherry-Picking
--------------
git cherry-pick [--edit] [-n] [-m parent-number] [-s] [-x]
selectively merge a single commit from another local branch
Example: git cherry-pick 7300a6130d9447e18a931e898b64eefedea19544
Squashing
---------
WARNING: "git rebase" changes history. Be careful. Google it.
git rebase --interactive HEAD~10
(then change all but the first "pick" to "squash")
squash the last 10 commits into one big commit
Conflicts
---------
git mergetool
work through conflicted files by opening them in your mergetool (opendiff,
kdiff3, etc.) and choosing left/right chunks. The merged result is staged for
commit.
For binary files or if mergetool won't do, resolve the conflict(s) manually
and then do:
git add [ ...]
Once all conflicts are resolved and staged, commit the pending merge with:
git commit
Sharing
-------
git fetch
update the remote-tracking branches for (defaults to "origin").
Does not initiate a merge into the current branch (see "git pull" below).
git pull
fetch changes from the server, and merge them into the current branch.
Note: .git/config must have a [branch "some_name"] section for the current
branch, to know which remote-tracking branch to merge into the current
branch. Git 1.5.3 and above adds this automatically.
git push
update the server with your commits across all branches that are *COMMON*
between your local copy and the server. Local branches that were never
pushed to the server in the first place are not shared.
git push origin
update the server with your commits made to since your last push.
This is always *required* for new branches that you wish to share. After
the first explicit push, "git push" by itself is sufficient.
git push origin :refs/heads/
E.g. git push origin twitter-experiment:refs/heads/twitter-experiment
Which, in fact, is the same as git push origin but a little
more obvious what is happening.
Reverting
---------
git revert
reverse commit specified by and commit the result. This does *not* do
the same thing as similarly named commands in other VCS's such as "svn
revert" or "bzr revert", see below
git checkout
re-checkout , overwriting any local changes
git checkout .
re-checkout all files, overwriting any local changes. This is most similar
to "svn revert" if you're used to Subversion commands
Fix mistakes / Undo
-------------------
git reset --hard
abandon everything since your last commit; this command can be DANGEROUS.
If merging has resulted in conflicts and you'd like to just forget about
the merge, this command will do that.
git reset --hard ORIG_HEAD
undo your most recent *successful* merge *and* any changes that occurred
after. Useful for forgetting about the merge you just did. If there are
conflicts (the merge was not successful), use "git reset --hard" (above)
instead.
git reset --soft HEAD^
forgot something in your last commit? That's easy to fix. Undo your last
commit, but keep the changes in the staging area for editing.
git commit --amend
redo previous commit, including changes you've staged in the meantime.
Also used to edit commit message of previous commit.
Plumbing
--------
test = $(git merge-base )
determine if merging sha1-B into sha1-A is achievable as a fast forward;
non-zero exit status is false.
Stashing
--------
git stash
git stash save
save your local modifications to a new stash (so you can for example
"git svn rebase" or "git pull")
git stash apply
restore the changes recorded in the stash on top of the current working tree
state
git stash pop
restore the changes from the most recent stash, and remove it from the stack
of stashed changes
git stash list
list all current stashes
git stash show -p
show the contents of a stash - accepts all diff args
git stash drop []
delete the stash
git stash clear
delete all current stashes
Remotes
-------
git remote add
adds a remote repository to your git config. Can be then fetched locally.
Example:
git remote add coreteam git://github.com/wycats/merb-plugins.git
git fetch coreteam
git push :refs/heads/
delete a branch in a remote repository
git push :refs/heads/
create a branch on a remote repository
Example: git push origin origin:refs/heads/new_feature_name
git push +:
replace a branch with
think twice before do this
Example: git push origin +master:my_branch
git remote prune
prune deleted remote-tracking branches from "git branch -r" listing
git remote add -t master -m master origin git://example.com/git.git/
add a remote and track its master
git remote show
show information about the remote server.
git checkout -b /
Eg git checkout -b myfeature origin/myfeature
Track a remote branch as a local branch.
git pull
git push
For branches that are remotely tracked (via git push) but
that complain about non-fast forward commits when doing a
git push. The pull synchronizes local and remote, and if
all goes well, the result is pushable.
Submodules
----------
add the given repository at the given path. The addition will be part of the
next commit.
git submodule update [--init]
Update the registered submodules (clone missing submodules, and checkout
the commit specified by the super-repo). --init is needed the first time.
git submodule foreach
Executes the given command within each checked out submodule.
Remove submodules
1. Delete the relevant line from the .gitmodules file.
2. Delete the relevant section from .git/config.
3. Run git rm --cached path_to_submodule (no trailing slash).
4. Commit and delete the now untracked submodule files.
Patches
-------
git format-patch HEAD^
Generate the last commit as a patch that can be applied on another
clone (or branch) using 'git am'. Format patch can also generate a
patch for all commits using 'git format-patch HEAD^ HEAD'
All page files will be enumerated with a prefix, e.g. 0001 is the
first patch.
Applies the patch file generated by format-patch.
git diff --no-prefix > patchfile
Generates a patch file that can be applied using patch:
patch -p0 < patchfile
Useful for sharing changes without generating a git commit.
Git Instaweb
------------
git instaweb --httpd=webrick [--start | --stop | --restart]
Environment Variables
---------------------
GIT_AUTHOR_NAME, GIT_COMMITTER_NAME
Your full name to be recorded in any newly created commits. Overrides
user.name in .git/config
GIT_AUTHOR_EMAIL, GIT_COMMITTER_EMAIL
Your email address to be recorded in any newly created commits. Overrides
user.email in .git/config
GIT_DIR
Location of the repository to use (for out of working directory repositories)
GIT_WORKING_TREE
Location of the Working Directory - use with GIT_DIR to specifiy the working
directory root
or to work without being in the working directory at all.