diff --git a/.gitignore b/.gitignore index 716c340a2..328b399f9 100644 --- a/.gitignore +++ b/.gitignore @@ -42,6 +42,7 @@ git-index-pack git-init-db git-local-fetch git-log +git-lost+found git-ls-files git-ls-remote git-ls-tree @@ -60,6 +61,7 @@ git-mktag git-name-rev git-mv git-octopus +git-pack-redundant git-pack-objects git-parse-remote git-patch-id diff --git a/Documentation/diff-format.txt b/Documentation/diff-format.txt index d1d0d2d3d..b426a14f5 100644 --- a/Documentation/diff-format.txt +++ b/Documentation/diff-format.txt @@ -8,13 +8,13 @@ git-diff-index :: compares the and the files on the filesystem. git-diff-index --cached :: - compares the and the cache. + compares the and the index. git-diff-tree [-r] [...]:: compares the trees named by the two arguments. git-diff-files [...]:: - compares the cache and the files on the filesystem. + compares the index and the files on the filesystem. An output line is formatted this way: @@ -47,7 +47,7 @@ That is, from the left to the right: . an LF or a NUL when '-z' option is used, to terminate the record. is shown as all 0's if a file is new on the filesystem -and it is out of sync with the cache. +and it is out of sync with the index. Example: @@ -104,7 +104,7 @@ where: The file parameters can point at the user's working file (e.g. `new-file` in "git-diff-files"), `/dev/null` (e.g. `old-file` when a new file is added), or a temporary file (e.g. `old-file` in the -cache). 'GIT_EXTERNAL_DIFF' should not worry about unlinking the +index). 'GIT_EXTERNAL_DIFF' should not worry about unlinking the temporary file --- it is removed when 'GIT_EXTERNAL_DIFF' exits. For a path that is unmerged, 'GIT_EXTERNAL_DIFF' is called with 1 diff --git a/Documentation/diff-options.txt b/Documentation/diff-options.txt index 32005b03f..8eef86e47 100644 --- a/Documentation/diff-options.txt +++ b/Documentation/diff-options.txt @@ -50,7 +50,7 @@ , which has one shell glob pattern per line. -R:: - Swap two inputs; that is, show differences from cache or + Swap two inputs; that is, show differences from index or on-disk file to tree contents. For more detailed explanation on these common options, see also diff --git a/Documentation/git-apply.txt b/Documentation/git-apply.txt index eb8f90683..6702a18c7 100644 --- a/Documentation/git-apply.txt +++ b/Documentation/git-apply.txt @@ -8,7 +8,7 @@ git-apply - Apply patch on a git index file and a work tree SYNOPSIS -------- -'git-apply' [--stat] [--numstat] [--summary] [--check] [--index] [--apply] [--index-info] [-z] [...] +'git-apply' [--stat] [--numstat] [--summary] [--check] [--index] [--apply] [--no-add] [--index-info] [-z] [...] DESCRIPTION ----------- @@ -72,6 +72,12 @@ OPTIONS patch. Give this flag after those flags to also apply the patch. +--no-add:: + When applying a patch, ignore additions made by the + patch. This can be used to extract common part between + two files by first running `diff` on them and applying + the result with this option, which would apply the + deletion part but not addition part. Author ------ diff --git a/Documentation/git-checkout-index.txt b/Documentation/git-checkout-index.txt index 589dc9ad1..94b283a6b 100644 --- a/Documentation/git-checkout-index.txt +++ b/Documentation/git-checkout-index.txt @@ -3,7 +3,7 @@ git-checkout-index(1) NAME ---- -git-checkout-index - Copy files from the cache to the working directory +git-checkout-index - Copy files from the index to the working directory SYNOPSIS @@ -13,23 +13,23 @@ SYNOPSIS DESCRIPTION ----------- -Will copy all files listed from the cache to the working directory +Will copy all files listed from the index to the working directory (not overwriting existing files). OPTIONS ------- -u:: update stat information for the checked out entries in - the cache file. + the index file. -q:: - be quiet if files exist or are not in the cache + be quiet if files exist or are not in the index -f:: forces overwrite of existing files -a:: - checks out all files in the cache. Cannot be used + checks out all files in the index. Cannot be used together with explicit filenames. -n:: @@ -57,7 +57,7 @@ supposed to be able to do things like: which will force all existing `*.h` files to be replaced with their cached copies. If an empty command line implied "all", then this would -force-refresh everything in the cache, which was not the point. +force-refresh everything in the index, which was not the point. To update and refresh only the files already checked out: @@ -74,7 +74,7 @@ desired tree into the index, and do a git-checkout-index --prefix=git-export-dir/ -a -and git-checkout-index will "export" the cache into the specified +and git-checkout-index will "export" the index into the specified directory. NOTE The final "/" is important. The exported name is literally just diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt index fefd2985f..83f58ae53 100644 --- a/Documentation/git-clone.txt +++ b/Documentation/git-clone.txt @@ -8,7 +8,7 @@ git-clone - Clones a repository. SYNOPSIS -------- -'git-clone' [-l [-s]] [-q] [-n] [-u ] +'git-clone' [-l [-s]] [-q] [-n] [-u ] [] DESCRIPTION ----------- @@ -68,9 +68,11 @@ OPTIONS be any URL git-fetch supports. :: - The name of a new directory to be cloned into. It is an - error to specify an existing directory. - + The name of a new directory to clone into. The "humanish" + part of the source repository is used if no directory is + explicitly given ("repo" for "/path/to/repo.git" and "foo" + for "host.xz:foo/.git"). Cloning into an existing directory + is not allowed. Author ------ @@ -78,7 +80,7 @@ Written by Linus Torvalds Documentation -------------- -Documentation by Junio C Hamano. +Documentation by Junio C Hamano and the git-list . GIT diff --git a/Documentation/git-cvsimport.txt b/Documentation/git-cvsimport.txt index 4b62256a7..88bd3b0f1 100644 --- a/Documentation/git-cvsimport.txt +++ b/Documentation/git-cvsimport.txt @@ -35,7 +35,7 @@ OPTIONS -i:: Import-only: don't perform a checkout after importing. This option - ensures the working directory and cache remain untouched and will + ensures the working directory and index remain untouched and will not create them if they do not exist. -k:: diff --git a/Documentation/git-diff-files.txt b/Documentation/git-diff-files.txt index e3873888f..3b04bfeec 100644 --- a/Documentation/git-diff-files.txt +++ b/Documentation/git-diff-files.txt @@ -3,7 +3,7 @@ git-diff-files(1) NAME ---- -git-diff-files - Compares files in the working tree and the cache +git-diff-files - Compares files in the working tree and the index SYNOPSIS @@ -12,9 +12,9 @@ SYNOPSIS DESCRIPTION ----------- -Compares the files in the working tree and the cache. When paths +Compares the files in the working tree and the index. When paths are specified, compares only those named paths. Otherwise all -entries in the cache are compared. The output format is the +entries in the index are compared. The output format is the same as "git-diff-index" and "git-diff-tree". OPTIONS diff --git a/Documentation/git-diff-index.txt b/Documentation/git-diff-index.txt index 2fc3eed71..d8fc78fab 100644 --- a/Documentation/git-diff-index.txt +++ b/Documentation/git-diff-index.txt @@ -3,7 +3,7 @@ git-diff-index(1) NAME ---- -git-diff-index - Compares content and mode of blobs between the cache and repository +git-diff-index - Compares content and mode of blobs between the index and repository SYNOPSIS @@ -13,10 +13,10 @@ SYNOPSIS DESCRIPTION ----------- Compares the content and mode of the blobs found via a tree -object with the content of the current cache and, optionally +object with the content of the current index and, optionally ignoring the stat state of the file on disk. When paths are specified, compares only those named paths. Otherwise all -entries in the cache are compared. +entries in the index are compared. OPTIONS ------- @@ -49,11 +49,11 @@ Cached Mode ----------- If '--cached' is specified, it allows you to ask: - show me the differences between HEAD and the current cache + show me the differences between HEAD and the current index contents (the ones I'd write with a "git-write-tree") For example, let's say that you have worked on your working directory, updated -some files in the cache and are ready to commit. You want to see eactly +some files in the index and are ready to commit. You want to see eactly *what* you are going to commit is without having to write a new tree object and compare it that way, and to do that, you just do @@ -92,7 +92,7 @@ which is obviously a very useful question too, since that tells you what you *could* commit. Again, the output matches the "git-diff-tree -r" output to a tee, but with a twist. -The twist is that if some file doesn't match the cache, we don't have +The twist is that if some file doesn't match the index, we don't have a backing store thing for it, and we use the magic "all-zero" sha1 to show that. So let's say that you have edited `kernel/sched.c`, but have not actually done a "git-update-index" on it yet - there is no @@ -110,7 +110,7 @@ NOTE: As with other commands of this type, "git-diff-index" does not actually look at the contents of the file at all. So maybe `kernel/sched.c` hasn't actually changed, and it's just that you touched it. In either case, it's a note that you need to -"git-upate-cache" it to make the cache be in sync. +"git-upate-index" it to make the index be in sync. NOTE: You can have a mixture of files show up as "has been updated" and "is still dirty in the working directory" together. You can always diff --git a/Documentation/git-diff-tree.txt b/Documentation/git-diff-tree.txt index f57c8d0d8..9a2947e27 100644 --- a/Documentation/git-diff-tree.txt +++ b/Documentation/git-diff-tree.txt @@ -8,7 +8,7 @@ git-diff-tree - Compares the content and mode of blobs found via two tree object SYNOPSIS -------- -'git-diff-tree' [--stdin] [-m] [-s] [-v] [--pretty] [-t] [-r] [--root] [] [] [...] +'git-diff-tree' [--stdin] [-m] [-s] [-v] [--no-commit-id] [--pretty] [-t] [-r] [--root] [] [] [...] DESCRIPTION ----------- @@ -74,6 +74,10 @@ separated with a single space are given. commit message. Without "=