GIT - Httqm's Docs

Developers often create temporary / test files they don't want to commit. .gitignore is very convenient to avoid committing such files by mistake, but might become messy if the team has many members, each with their personal flavor of "test files" not worth committing .

Just use $GIT_DIR/info/exclude as a personal won't-be-committed .gitignore :

$GIT_DIR/info/exclude has the same syntax and rules than .gitignore
.gitignore has a higher precedence level

Replace :

git status

with :

git status --untracked-files=no

(or create the corresponding alias).

Technically, this does not prevent "test files" from being committed : they are just hidden from the output of git status.

When text is moved (i.e. cut + paste) from one place to another, Git reports it as

deleted on the cut side (source)
and added on the paste side (destination)

The --color-moved option (added in Git v2.15) highlights such text with different colors. It works with any command that generates a diff :

This option has :

different modes (which mostly affect how moved code is detected) :
- default : synonym for zebra
- blocks : detects blocks of at least 20 alphanumeric characters
- plain : detects moved lines
- zebra :
  - detects moved stuff like blocks
  - has its own painting rules

default colors :

This line has —not changed— since the previous commit.
This line was —added— since the previous commit.
This line was —removed— since the previous commit.
This line was —cut— since the previous commit.
This line was —pasted— since the previous commit.

But these can be edited as you like (read below).

Usage :

One shot :

git config --local color.diff.oldMoved magenta; git config --local color.diff.newMoved yellow
git diff --color-moved=mode

Permanently :

set the options above globally :
- git config --global color.diff.oldMoved magenta; git config --global color.diff.newMoved yellow
- git config --global diff.colorMoved mode
or, in ~/.gitconfig :
```
[diff]
	
	colorMoved = mode
```
you can also define your own colors to highlight added / removed / moved contents (available colors + attributes) :
```
[color "diff"]
	new = bold green
	old = bold red
	newMoved = dim green
	oldMoved = dim red
```
then, as usual : git diff
If you have an alias for git diff, it is possible one of its options (like --color-words) conflicts with --color-moved and makes some of your --color-moved settings inoperative.

Try it :

currentDir="$PWD"; tmpDir=$(mktemp -d); tmpFile='myFile'; cd "$tmpDir"; git init; echo -e "Let's go buy some apples.\n\tI want some.\nBanana is my favorite fruit.\nWho wants some coconut ?\n" > "$tmpFile"; echo -e '\nBEFORE :'; cat "$tmpFile"; git add "$tmpFile"; git commit -m 'initial version'; echo -e "Let's go buy some apples.\n\tI'll buy 4.\nWho wants some coconut ?\n\tYes, please.\nBanana is my favorite fruit.\n" > "$tmpFile"; echo -e '\nAFTER :'; cat "$tmpFile"; echo -e '\ngit diff --color-moved=no :'; git diff --color-moved=no; echo -e '\ngit diff --color-moved=blocks :'; git config --local color.diff.oldMoved magenta; git config --local color.diff.newMoved yellow; git diff --color-moved=blocks; cd "$currentDir"; [ -d "$tmpDir" ] && rm -rf "$tmpDir"

BEFORE :
Let's go buy some apples.
	I want some.
Banana is my favorite fruit.
Who wants some coconut ?



AFTER :
Let's go buy some apples.
	I'll buy 4.
Who wants some coconut ?
	Yes, please.
Banana is my favorite fruit.


git diff --color-moved=no :
diff --git i/myFile w/myFile
index ff718be..a8bb615 100644
--- i/myFile
+++ w/myFile
@@ -1,5 +1,6 @@
 Let's go buy some apples.
-	I want some.
-Banana is my favorite fruit.
+	I'll buy 4.
 Who wants some coconut ?
+	Yes, please.
+Banana is my favorite fruit.


git diff --color-moved=blocks :
diff --git i/myFile w/myFile
index ff718be..a8bb615 100644
--- i/myFile
+++ w/myFile
@@ -1,5 +1,6 @@
 Let's go buy some apples.
-	I want some.
-Banana is my favorite fruit.
+	I'll buy 4.
 Who wants some coconut ?
+	Yes, please.
+Banana is my favorite fruit.

git diff --cached
OR : git diff --staged, which is an easier to remember synonym

To "unstage" a file means "remove it from the index (aka staging area)". To do so :

git reset HEAD path/to/file

Solution 1 : interactive staging (source) :

Enter Git interactive staging : git add -i (or git add --interactive)
Type p for patch
Type the number of the file you'd like to take a patch from, then (twice : ???)
This will display the hunks of the current file and offer keys :
- y (yes) : stage this hunk
- n (no) : do not stage this hunk
- a (all) : stage this and all the remaining hunks in the file
- d (don't) : do not stage this hunk nor any of the remaining hunks in the file
- ? (help)
When all the desired changes are staged, leave with q
If something went wrong while staging changes, you can unstage some changes
Then commit the staged changes : git commit -m 'What a beautiful commit'

Solution 2 : git add in patch mode : -p / --patch (source 1, 2) :

git add --patch myFile, then for each hunk :

y (yes) : stage this hunk
n (no) : do not stage this hunk
a (all) : stage this and all the remaining hunks in the file
d (don't) : do not stage this hunk nor any of the remaining hunks in the file
s (split) : split the current hunk into smaller hunks
/ : search for a hunk matching the given regex
? (help)
(there are more )

This -p option is a shortcut to the -i above + patch.

It is possible to do the opposite; i.e. interactively select hunks to unstage with git reset -p.

BONUS : How to stage a patch while having contiguous changed lines (source) ?

Let's start by simulating the situation :

Create the Git repo, add some code and commit : myDir=~/testDir; myFile='testFile'; mkdir "$myDir"; cd "$myDir"; git init; echo 'line 1' >> "$myFile"; git add "$myFile"; git commit -m 'Initial version'
Improve the code : echo -e "line 2\nline 3" >> "$myFile"
Our program now looks like : cat "$myFile"
```
line 1
line 2
line 3
```

And Git sees some difference : git diff

diff --git a/testFile b/testFile
index 89b24ec..a92d664 100644
--- a/testFile
+++ b/testFile
@@ -1 +1,3 @@
 line 1
+line 2
+line 3

And the question is : how may I stage line 2 split from line 3 so that I can make 2 separate commits ?

With git add --patch, the split command is useless since the changed lines are contiguous
Still with git add --patch, the regex search function doesn't work so far (returns all lines, whatever pattern I enter)

Now the solution :

Prepare to stage changes in patch mode : git add --patch

diff --git a/testFile b/testFile
index 89b24ec..a92d664 100644
--- a/testFile
+++ b/testFile
@@ -1 +1,3 @@
 line 1
+line 2
+line 3
Stage this hunk [y,n,q,a,d,/,e,?]?

Then type e to edit the hunk. This will open your default text editor

Once in the editor, follow the instructions to specify which lines to stage or not :

# Manual hunk edit mode -- see bottom for a quick guide
@@ -1 +1,3 @@
 line 1
+line 2
#+line 3
# ---
# To remove '-' lines, make them ' ' lines (context).
# To remove '+' lines, delete them.
# Lines starting with # will be removed.
#
# If the patch applies cleanly, the edited hunk will immediately be
# marked for staging. If it does not apply cleanly, you will be given
# an opportunity to edit again. If all lines of the hunk are removed,
# then the edit is aborted and the hunk is left unchanged.

To not stage a ... line	Do :
+	add a leading `#` OR delete this line
-	change the leading `-` into a `[SPACE]`

Save and exit.

If you're using Emacs and this step fails saying things like patch fragment without header and Your edited hunk does not apply, read this.

View staged changes : git diff --staged

diff --git a/testFile b/testFile
index 89b24ec..7bba8c8 100644
--- a/testFile
+++ b/testFile
@@ -1 +1,2 @@
 line 1
+line 2

Commit. Enjoy.

You may have to save a WIP (i.e. changes made after the previous commit are not ready for a new commit yet) before changing branch. To do so :

git stash
git status should return no modified file
create a new branch "newBranch", work hard, commit
come back to the original branch : git checkout previousBranch
restore WIP in previousBranch : git stash apply
OR drop "stashed" content : git stash drop

If you need to unstage changes first :

git reset

Undo all local uncommitted changes :

from the root of the repository onlygit checkout .
from any subdirectory of the repository git reset --hard HEAD
git stash && git stash drop

Undo local uncommitted changes for a specific file :

git checkout someFile

To proceed, you must have a few commits and a distant copy/clone/remote of your repository. To make things even easier, it's a good practice to create a dedicated branch for a fix / new feature.

Create a patch containing changes between the current status and the branch master : git format-patch master --stdout > theNameOfMy.patch
You can inspect the patch with your favorite text editor. Send it to whoever needs it. The following steps take place on the "patch receiver" side
List changes provided by the patch : git apply --stat theNameOfMy.patch
Check/dry-run the patch : git apply --check theNameOfMy.patch
If the previous command output no error, you can now apply the patch : git am --signoff < theNameOfMy.patch

Check the logs : git log will output

commit 7d7a786c1353b5433b7e39a6b50c7ac8d9b5159f
Author: Thomas ANDERSON <thomas.anderson@metacortex.com>	who made the commit
Date:	Fri Jul 18 09:35:36 2014 +0200

	Fixed a glitch in the Matrix

	Signed-off-by: Smith <smith@thematrix>		who applied the patch

GIT - HowTo's about "staging"

How can I instruct Git to ignore some files without altering the .gitignore file ?

Situation :

Solution :

Alternate solution :

How to detect moved (cut + paste) code ?

Usage :

One shot :

Permanently :

Try it :

How to view staged changes ?

How to unstage a file ?

How to stage / unstage a patch ?

Solution 1 : interactive staging (source) :

Solution 2 : git add in patch mode : -p / --patch (source 1, 2) :

BONUS : How to stage a patch while having contiguous changed lines (source) ?

Let's start by simulating the situation :

Now the solution :

How to save a WIP ?

How to discard local uncommitted changes ?

How to create and apply a patch ?