Browse Source

Merge v1.7.5-rc2 into jn/format-patch-doc

This is to sync with the recent updates in Documentation/SubmittingPatches
and Documentation/format-patch.txt
maint
Junio C Hamano 14 years ago
parent
commit
ed44fd045a
  1. 3
      .gitignore
  2. 138
      Documentation/RelNotes/1.7.5.txt
  3. 3
      Documentation/SubmittingPatches
  4. 18
      Documentation/config.txt
  5. 25
      Documentation/fetch-options.txt
  6. 8
      Documentation/git-add.txt
  7. 9
      Documentation/git-am.txt
  8. 4
      Documentation/git-annotate.txt
  9. 10
      Documentation/git-apply.txt
  10. 8
      Documentation/git-archimport.txt
  11. 8
      Documentation/git-archive.txt
  12. 8
      Documentation/git-bisect.txt
  13. 4
      Documentation/git-blame.txt
  14. 8
      Documentation/git-branch.txt
  15. 4
      Documentation/git-bundle.txt
  16. 8
      Documentation/git-cat-file.txt
  17. 9
      Documentation/git-check-attr.txt
  18. 12
      Documentation/git-checkout-index.txt
  19. 166
      Documentation/git-checkout.txt
  20. 57
      Documentation/git-cherry-pick.txt
  21. 8
      Documentation/git-cherry.txt
  22. 8
      Documentation/git-citool.txt
  23. 6
      Documentation/git-clean.txt
  24. 21
      Documentation/git-clone.txt
  25. 9
      Documentation/git-commit-tree.txt
  26. 13
      Documentation/git-commit.txt
  27. 9
      Documentation/git-config.txt
  28. 9
      Documentation/git-count-objects.txt
  29. 8
      Documentation/git-cvsexportcommit.txt
  30. 9
      Documentation/git-cvsimport.txt
  31. 16
      Documentation/git-cvsserver.txt
  32. 11
      Documentation/git-daemon.txt
  33. 11
      Documentation/git-describe.txt
  34. 9
      Documentation/git-diff-files.txt
  35. 9
      Documentation/git-diff-index.txt
  36. 9
      Documentation/git-diff-tree.txt
  37. 8
      Documentation/git-diff.txt
  38. 13
      Documentation/git-difftool.txt
  39. 9
      Documentation/git-fast-export.txt
  40. 75
      Documentation/git-fast-import.txt
  41. 9
      Documentation/git-fetch-pack.txt
  42. 21
      Documentation/git-fetch.txt
  43. 10
      Documentation/git-filter-branch.txt
  44. 9
      Documentation/git-fmt-merge-msg.txt
  45. 9
      Documentation/git-format-patch.txt
  46. 4
      Documentation/git-fsck-objects.txt
  47. 8
      Documentation/git-fsck.txt
  48. 4
      Documentation/git-gc.txt
  49. 9
      Documentation/git-get-tar-commit-id.txt
  50. 20
      Documentation/git-grep.txt
  51. 8
      Documentation/git-gui.txt
  52. 8
      Documentation/git-hash-object.txt
  53. 11
      Documentation/git-help.txt
  54. 8
      Documentation/git-http-fetch.txt
  55. 9
      Documentation/git-http-push.txt
  56. 8
      Documentation/git-imap-send.txt
  57. 9
      Documentation/git-index-pack.txt
  58. 4
      Documentation/git-init-db.txt
  59. 70
      Documentation/git-init.txt
  60. 8
      Documentation/git-instaweb.txt
  61. 8
      Documentation/git-log.txt
  62. 9
      Documentation/git-lost-found.txt
  63. 9
      Documentation/git-ls-files.txt
  64. 4
      Documentation/git-ls-remote.txt
  65. 12
      Documentation/git-ls-tree.txt
  66. 11
      Documentation/git-mailinfo.txt
  67. 10
      Documentation/git-mailsplit.txt
  68. 8
      Documentation/git-merge-base.txt
  69. 11
      Documentation/git-merge-file.txt
  70. 9
      Documentation/git-merge-index.txt
  71. 9
      Documentation/git-merge-one-file.txt
  72. 8
      Documentation/git-merge-tree.txt
  73. 20
      Documentation/git-merge.txt
  74. 8
      Documentation/git-mergetool--lib.txt
  75. 12
      Documentation/git-mergetool.txt
  76. 9
      Documentation/git-mktag.txt
  77. 8
      Documentation/git-mktree.txt
  78. 11
      Documentation/git-mv.txt
  79. 9
      Documentation/git-name-rev.txt
  80. 11
      Documentation/git-pack-objects.txt
  81. 8
      Documentation/git-pack-redundant.txt
  82. 5
      Documentation/git-pack-refs.txt
  83. 8
      Documentation/git-parse-remote.txt
  84. 8
      Documentation/git-patch-id.txt
  85. 8
      Documentation/git-peek-remote.txt
  86. 8
      Documentation/git-prune-packed.txt
  87. 8
      Documentation/git-prune.txt
  88. 23
      Documentation/git-pull.txt
  89. 10
      Documentation/git-push.txt
  90. 8
      Documentation/git-quiltimport.txt
  91. 9
      Documentation/git-read-tree.txt
  92. 15
      Documentation/git-rebase.txt
  93. 9
      Documentation/git-receive-pack.txt
  94. 8
      Documentation/git-reflog.txt
  95. 8
      Documentation/git-relink.txt
  96. 4
      Documentation/git-remote-helpers.txt
  97. 25
      Documentation/git-remote.txt
  98. 9
      Documentation/git-repack.txt
  99. 11
      Documentation/git-replace.txt
  100. 4
      Documentation/git-repo-config.txt
  101. Some files were not shown because too many files have changed in this diff Show More

3
.gitignore vendored

@ -43,7 +43,6 @@
/git-fast-export /git-fast-export
/git-fast-import /git-fast-import
/git-fetch /git-fetch
/git-fetch--tool
/git-fetch-pack /git-fetch-pack
/git-filter-branch /git-filter-branch
/git-fmt-merge-msg /git-fmt-merge-msg
@ -107,7 +106,6 @@
/git-reflog /git-reflog
/git-relink /git-relink
/git-remote /git-remote
/git-remote-curl
/git-remote-http /git-remote-http
/git-remote-https /git-remote-https
/git-remote-ftp /git-remote-ftp
@ -170,6 +168,7 @@
/test-index-version /test-index-version
/test-line-buffer /test-line-buffer
/test-match-trees /test-match-trees
/test-mktemp
/test-obj-pool /test-obj-pool
/test-parse-options /test-parse-options
/test-path-utils /test-path-utils

138
Documentation/RelNotes/1.7.5.txt

@ -0,0 +1,138 @@
Git v1.7.5 Release Notes (draft)
========================

Updates since v1.7.4
--------------------

* Various MinGW portability fixes.

* Various git-p4 enhancements (in contrib).

* Various vcs-svn, git-svn and gitk enhancements and fixes.

* Various git-gui updates (0.14.0).

* Update to more modern HP-UX port.

* The codebase is getting prepared for i18n/l10n; no translated
strings nor translation mechanism in the code yet, but the strings
are being marked for l10n.

* The bash completion script can now complete symmetric difference
for "git diff" command, e.g. "git diff ...bra<TAB>".

* The default minimum length of abbreviated and unique object names
can now be configured by setting the core.abbrev configuration
variable.

* "git apply -v" reports offset lines when the patch does not apply at
the exact location recorded in the diff output.

* "git config" used to be also known as "git repo-config", but the old
name is now officially deprecated.

* "git checkout --detach <commit>" is a more user friendly synonym for
"git checkout <commit>^0".

* "git checkout" performed on detached HEAD gives a warning and
advice when the commit being left behind will become unreachable from
any branch or tag.

* "git cherry-pick" and "git revert" can be told to use a custom merge
strategy, similar to "git rebase".

* "git cherry-pick" remembers which commit failed to apply when it is
stopped by conflicts, making it unnecessary to use "commit -c $commit"
to conclude it.

* "git cvsimport" bails out immediately when the cvs server cannot be
reached, without spewing unnecessary error messages that complain about
the server response it never got.

* "git fetch" vs "git upload-pack" transfer learned 'no-done'
protocol extension to save one round-trip after the content
negotiation is done. This saves one HTTP RPC, reducing the overall
latency for a trivial fetch.

* "git fetch" can be told to recursively fetch submodules on-demand.

* "git grep -f <filename>" learned to treat "-" as "read from the
standard input stream".

* "git grep --no-index" did not honor pathspecs correctly, returning
paths outside the specified area.

* "git init" learned the --separate-git-dir option to allow the git
directory for a new repository created elsewhere and linked via the
gitdir mechanism. This is primarily to help submodule support later
to switch between a branch of superproject that has the submodule
and another that does not.

* "git log" type commands now understand globbing pathspecs. You
can say "git log -- '*.txt'" for example.

* "git log" family of commands learned --cherry and --cherry-mark
options that can be used to view two diverged branches while omitting
or highlighting equivalent changes that appear on both sides of a
symmetric difference (e.g. "log --cherry A...B").

* A lazy "git merge" that didn't say what to merge used to be an error.
When run on a branch that has an upstream defined, however, the command
now merges from the configured upstream.

* "git mergetool" learned how to drive "beyond compare 3" as well.

* "git rerere forget" without pathspec used to forget all the saved
conflicts that relate to the current merge; it now requires you to
give it pathspecs.

* "git rev-list --objects $revs -- $pathspec" now limits the objects listed
in its output properly with the pathspec, in preparation for narrow
clones.

* "git push" with no parameters gives better advice messages when
"tracking" is used as the push.default semantics or there is no remote
configured yet.

* A possible value to the "push.default" configuration variable,
'tracking', gained a synonym that more naturally describes what it
does, 'upstream'.

* "git rerere" learned a new subcommand "remaining" that is similar to
"status" and lists the paths that had conflicts which are known to
rerere, but excludes the paths that have already been marked as
resolved in the index from its output. "git mergetool" has been
updated to use this facility.

Also contains various documentation updates.


Fixes since v1.7.4
------------------

All of the fixes in the v1.7.4.X maintenance series are included in this
release, unless otherwise noted.

* "git fetch" from a client that is mostly following the remote
needlessly told all of its refs to the server for both sides to
compute the set of objects that need to be transferred efficiently,
instead of stopping when the server heard enough. In a project with
many tags, this turns out to be extremely wasteful, especially over
the smart HTTP transport (sp/maint-{upload,fetch}-pack-stop-early~1).

* "git fetch" run from a repository that uses the same repository as
its alternate object store as the repository it is fetching from
did not tell the server that it already has access to objects
reachable from the refs in their common alternate object store,
causing it to fetch unnecessary objects (jc/maint-fetch-alt).

* "git remote add --mirror" created a configuration that is suitable for
doing both a mirror fetch and a mirror push at the same time, which
made little sense. We now warn and require the command line to specify
either --mirror=fetch or --mirror=push.

---
exec >/var/tmp/1
O=v1.7.5-rc2
echo O=$(git describe 'master')
git shortlog --no-merges ^maint ^$O master

3
Documentation/SubmittingPatches

@ -276,7 +276,7 @@ don't hide your real name.


If you like, you can put extra tags at the end: If you like, you can put extra tags at the end:


1. "Reported-by:" is used to to credit someone who found the bug that 1. "Reported-by:" is used to credit someone who found the bug that
the patch attempts to fix. the patch attempts to fix.
2. "Acked-by:" says that the person who is more familiar with the area 2. "Acked-by:" says that the person who is more familiar with the area
the patch attempts to modify liked the patch. the patch attempts to modify liked the patch.
@ -608,4 +608,3 @@ following commands:
Just make sure to disable line wrapping in the email client (GMail web Just make sure to disable line wrapping in the email client (GMail web
interface will line wrap no matter what, so you need to use a real interface will line wrap no matter what, so you need to use a real
IMAP client). IMAP client).


18
Documentation/config.txt

@ -897,9 +897,13 @@ diff.wordRegex::
characters are *ignorable* whitespace. characters are *ignorable* whitespace.


fetch.recurseSubmodules:: fetch.recurseSubmodules::
A boolean value which changes the behavior for fetch and pull, the This option can be either set to a boolean value or to 'on-demand'.
default is to not recursively fetch populated submodules unless Setting it to a boolean changes the behavior of fetch and pull to
configured otherwise. unconditionally recurse into submodules when set to true or to not
recurse at all when set to false. When set to 'on-demand' (the default
value), fetch and pull will only recurse into a populated submodule
when its superproject retrieves a commit that updates the submodule's
reference.


fetch.unpackLimit:: fetch.unpackLimit::
If the number of objects fetched over the git native If the number of objects fetched over the git native
@ -1098,6 +1102,12 @@ All gitcvs variables except for 'gitcvs.usecrlfattr' and
is one of "ext" and "pserver") to make them apply only for the given is one of "ext" and "pserver") to make them apply only for the given
access method. access method.


grep.lineNumber::
If set to true, enable '-n' option by default.

grep.extendedRegexp::
If set to true, enable '--extended-regexp' option by default.

gui.commitmsgwidth:: gui.commitmsgwidth::
Defines how wide the commit message window is in the Defines how wide the commit message window is in the
linkgit:git-gui[1]. "75" is the default. linkgit:git-gui[1]. "75" is the default.
@ -1817,7 +1827,7 @@ submodule.<name>.update::
linkgit:git-submodule[1] and linkgit:gitmodules[5] for details. linkgit:git-submodule[1] and linkgit:gitmodules[5] for details.


submodule.<name>.fetchRecurseSubmodules:: submodule.<name>.fetchRecurseSubmodules::
This option can be used to enable/disable recursive fetching of this This option can be used to control recursive fetching of this
submodule. It can be overridden by using the --[no-]recurse-submodules submodule. It can be overridden by using the --[no-]recurse-submodules
command line option to "git fetch" and "git pull". command line option to "git fetch" and "git pull".
This setting will override that from in the linkgit:gitmodules[5] This setting will override that from in the linkgit:gitmodules[5]

25
Documentation/fetch-options.txt

@ -65,14 +65,33 @@ ifndef::git-pull[]
specified with the remote.<name>.tagopt setting. See specified with the remote.<name>.tagopt setting. See
linkgit:git-config[1]. linkgit:git-config[1].


--[no-]recurse-submodules:: --recurse-submodules[=yes|on-demand|no]::
This option controls if new commits of all populated submodules should This option controls if and under what conditions new commits of
be fetched too (see linkgit:git-config[1] and linkgit:gitmodules[5]). populated submodules should be fetched too. It can be used as a
boolean option to completely disable recursion when set to 'no' or to
unconditionally recurse into all populated submodules when set to
'yes', which is the default when this option is used without any
value. Use 'on-demand' to only recurse into a populated submodule
when the superproject retrieves a commit that updates the submodule's
reference to a commit that isn't already in the local submodule
clone.

--no-recurse-submodules::
Disable recursive fetching of submodules (this has the same effect as
using the '--recurse-submodules=no' option).


--submodule-prefix=<path>:: --submodule-prefix=<path>::
Prepend <path> to paths printed in informative messages Prepend <path> to paths printed in informative messages
such as "Fetching submodule foo". This option is used such as "Fetching submodule foo". This option is used
internally when recursing over submodules. internally when recursing over submodules.

--recurse-submodules-default=[yes|on-demand]::
This option is used internally to temporarily provide a
non-negative default value for the --recurse-submodules
option. All other methods of configuring fetch's submodule
recursion (such as settings in linkgit:gitmodules[5] and
linkgit:git-config[1]) override this option, as does
specifying --[no-]recurse-submodules directly.
endif::git-pull[] endif::git-pull[]


-u:: -u::

8
Documentation/git-add.txt

@ -378,14 +378,6 @@ linkgit:git-mv[1]
linkgit:git-commit[1] linkgit:git-commit[1]
linkgit:git-update-index[1] linkgit:git-update-index[1]


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-am.txt

@ -189,15 +189,6 @@ SEE ALSO
-------- --------
linkgit:git-apply[1]. linkgit:git-apply[1].



Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Petr Baudis, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

4
Documentation/git-annotate.txt

@ -27,10 +27,6 @@ SEE ALSO
-------- --------
linkgit:git-blame[1] linkgit:git-blame[1]


AUTHOR
------
Written by Ryan Anderson <ryan@michonline.com>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

10
Documentation/git-apply.txt

@ -246,20 +246,10 @@ If `--index` is not specified, then the submodule commits in the patch
are ignored and only the absence or presence of the corresponding are ignored and only the absence or presence of the corresponding
subdirectory is checked and (if possible) updated. subdirectory is checked and (if possible) updated.



SEE ALSO SEE ALSO
-------- --------
linkgit:git-am[1]. linkgit:git-am[1].



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-archimport.txt

@ -107,14 +107,6 @@ OPTIONS
Archive/branch identifier in a format that `tla log` understands. Archive/branch identifier in a format that `tla log` understands.




Author
------
Written by Martin Langhoff <martin@laptop.org>.

Documentation
--------------
Documentation by Junio C Hamano, Martin Langhoff and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-archive.txt

@ -154,14 +154,6 @@ SEE ALSO
-------- --------
linkgit:gitattributes[5] linkgit:gitattributes[5]


Author
------
Written by Franck Bui-Huu and Rene Scharfe.

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-bisect.txt

@ -342,14 +342,6 @@ $ git bisect run sh -c "make || exit 125; ~/check_test_case.sh"
This shows that you can do without a run script if you write the test This shows that you can do without a run script if you write the test
on a single line. on a single line.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
-------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

SEE ALSO SEE ALSO
-------- --------
link:git-bisect-lk2009.html[Fighting regressions with git bisect], link:git-bisect-lk2009.html[Fighting regressions with git bisect],

4
Documentation/git-blame.txt

@ -198,10 +198,6 @@ SEE ALSO
-------- --------
linkgit:git-annotate[1] linkgit:git-annotate[1]


AUTHOR
------
Written by Junio C Hamano <gitster@pobox.com>

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-branch.txt

@ -232,14 +232,6 @@ linkgit:git-remote[1],
link:user-manual.html#what-is-a-branch[``Understanding history: What is link:user-manual.html#what-is-a-branch[``Understanding history: What is
a branch?''] in the Git User's Manual. a branch?''] in the Git User's Manual.


Author
------
Written by Linus Torvalds <torvalds@osdl.org> and Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

4
Documentation/git-bundle.txt

@ -201,10 +201,6 @@ You can also see what references it offers:
$ git ls-remote mybundle $ git ls-remote mybundle
---------------- ----------------


Author
------
Written by Mark Levedahl <mdl123@verizon.net>

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-cat-file.txt

@ -100,14 +100,6 @@ for each object specified on stdin that does not exist in the repository:
<object> SP missing LF <object> SP missing LF
------------ ------------


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-check-attr.txt

@ -86,15 +86,6 @@ SEE ALSO
-------- --------
linkgit:gitattributes[5]. linkgit:gitattributes[5].



Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by James Bowes.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

12
Documentation/git-checkout-index.txt

@ -172,18 +172,6 @@ $ git checkout-index --prefix=.merged- Makefile
This will check out the currently cached copy of `Makefile` This will check out the currently cached copy of `Makefile`
into the file `.merged-Makefile`. into the file `.merged-Makefile`.



Author
------
Written by Linus Torvalds <torvalds@osdl.org>


Documentation
--------------
Documentation by David Greaves,
Junio C Hamano and the git-list <git@vger.kernel.org>.


GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

166
Documentation/git-checkout.txt

@ -9,6 +9,7 @@ SYNOPSIS
-------- --------
[verse] [verse]
'git checkout' [-q] [-f] [-m] [<branch>] 'git checkout' [-q] [-f] [-m] [<branch>]
'git checkout' [-q] [-f] [-m] [--detach] [<commit>]
'git checkout' [-q] [-f] [-m] [[-b|-B|--orphan] <new_branch>] [<start_point>] 'git checkout' [-q] [-f] [-m] [[-b|-B|--orphan] <new_branch>] [<start_point>]
'git checkout' [-f|--ours|--theirs|-m|--conflict=<style>] [<tree-ish>] [--] <paths>... 'git checkout' [-f|--ours|--theirs|-m|--conflict=<style>] [<tree-ish>] [--] <paths>...
'git checkout' --patch [<tree-ish>] [--] [<paths>...] 'git checkout' --patch [<tree-ish>] [--] [<paths>...]
@ -22,9 +23,10 @@ branch.


'git checkout' [<branch>]:: 'git checkout' [<branch>]::
'git checkout' -b|-B <new_branch> [<start point>]:: 'git checkout' -b|-B <new_branch> [<start point>]::
'git checkout' [--detach] [<commit>]::


This form switches branches by updating the index, working This form switches branches by updating the index, working
tree, and HEAD to reflect the specified branch. tree, and HEAD to reflect the specified branch or commit.
+ +
If `-b` is given, a new branch is created as if linkgit:git-branch[1] If `-b` is given, a new branch is created as if linkgit:git-branch[1]
were called and then checked out; in this case you can were called and then checked out; in this case you can
@ -115,6 +117,13 @@ explicitly give a name with '-b' in such a case.
Create the new branch's reflog; see linkgit:git-branch[1] for Create the new branch's reflog; see linkgit:git-branch[1] for
details. details.


--detach::
Rather than checking out a branch to work on it, check out a
commit for inspection and discardable experiments.
This is the default behavior of "git checkout <commit>" when
<commit> is not a branch name. See the "DETACHED HEAD" section
below for details.

--orphan:: --orphan::
Create a new 'orphan' branch, named <new_branch>, started from Create a new 'orphan' branch, named <new_branch>, started from
<start_point> and switch to it. The first commit made on this <start_point> and switch to it. The first commit made on this
@ -204,42 +213,140 @@ leave out at most one of `A` and `B`, in which case it defaults to `HEAD`.






Detached HEAD DETACHED HEAD
------------- -------------
HEAD normally refers to a named branch (e.g. 'master'). Meanwhile, each
branch refers to a specific commit. Let's look at a repo with three
commits, one of them tagged, and with branch 'master' checked out:

------------
HEAD (refers to branch 'master')
|
v
a---b---c branch 'master' (refers to commit 'c')
^
|
tag 'v2.0' (refers to commit 'b')
------------


It is sometimes useful to be able to 'checkout' a commit that is When a commit is created in this state, the branch is updated to refer to
not at the tip of one of your branches. The most obvious the new commit. Specifically, 'git commit' creates a new commit 'd', whose
example is to check out the commit at a tagged official release parent is commit 'c', and then updates branch 'master' to refer to new
point, like this: commit 'd'. HEAD still refers to branch 'master' and so indirectly now refers
to commit 'd':


------------ ------------
$ git checkout v2.6.18 $ edit; git add; git commit

HEAD (refers to branch 'master')
|
v
a---b---c---d branch 'master' (refers to commit 'd')
^
|
tag 'v2.0' (refers to commit 'b')
------------ ------------


Earlier versions of git did not allow this and asked you to It is sometimes useful to be able to checkout a commit that is not at
create a temporary branch using the `-b` option, but starting from the tip of any named branch, or even to create a new commit that is not
version 1.5.0, the above command 'detaches' your HEAD from the referenced by a named branch. Let's look at what happens when we
current branch and directly points at the commit named by the tag checkout commit 'b' (here we show two ways this may be done):
(`v2.6.18` in the example above).


You can use all git commands while in this state. You can use ------------
`git reset --hard $othercommit` to further move around, for $ git checkout v2.0 # or
example. You can make changes and create a new commit on top of $ git checkout master^^
a detached HEAD. You can even create a merge by using `git
merge $othercommit`. HEAD (refers to commit 'b')
|
v
a---b---c---d branch 'master' (refers to commit 'd')
^
|
tag 'v2.0' (refers to commit 'b')
------------


The state you are in while your HEAD is detached is not recorded Notice that regardless of which checkout command we use, HEAD now refers
by any branch (which is natural --- you are not on any branch). directly to commit 'b'. This is known as being in detached HEAD state.
What this means is that you can discard your temporary commits It means simply that HEAD refers to a specific commit, as opposed to
and merges by switching back to an existing branch (e.g. `git referring to a named branch. Let's see what happens when we create a commit:
checkout master`), and a later `git prune` or `git gc` would
garbage-collect them. If you did this by mistake, you can ask
the reflog for HEAD where you were, e.g.


------------ ------------
$ git log -g -2 HEAD $ edit; git add; git commit

HEAD (refers to commit 'e')
|
v
e
/
a---b---c---d branch 'master' (refers to commit 'd')
^
|
tag 'v2.0' (refers to commit 'b')
------------

There is now a new commit 'e', but it is referenced only by HEAD. We can
of course add yet another commit in this state:

------------
$ edit; git add; git commit

HEAD (refers to commit 'f')
|
v
e---f
/
a---b---c---d branch 'master' (refers to commit 'd')
^
|
tag 'v2.0' (refers to commit 'b')
------------

In fact, we can perform all the normal git operations. But, let's look
at what happens when we then checkout master:

------------
$ git checkout master

HEAD (refers to branch 'master')
e---f |
/ v
a---b---c---d branch 'master' (refers to commit 'd')
^
|
tag 'v2.0' (refers to commit 'b')
------------ ------------


It is important to realize that at this point nothing refers to commit
'f'. Eventually commit 'f' (and by extension commit 'e') will be deleted
by the routine git garbage collection process, unless we create a reference
before that happens. If we have not yet moved away from commit 'f',
any of these will create a reference to it:

------------
$ git checkout -b foo <1>
$ git branch foo <2>
$ git tag foo <3>
------------

<1> creates a new branch 'foo', which refers to commit 'f', and then
updates HEAD to refer to branch 'foo'. In other words, we'll no longer
be in detached HEAD state after this command.

<2> similarly creates a new branch 'foo', which refers to commit 'f',
but leaves HEAD detached.

<3> creates a new tag 'foo', which refers to commit 'f',
leaving HEAD detached.

If we have moved away from commit 'f', then we must first recover its object
name (typically by using git reflog), and then we can create a reference to
it. For example, to see the last two commits to which HEAD referred, we
can use either of these commands:

------------
$ git reflog -2 HEAD # or
$ git log -g -2 HEAD
------------


EXAMPLES EXAMPLES
-------- --------
@ -315,15 +422,6 @@ $ edit frotz
$ git add frotz $ git add frotz
------------ ------------



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

57
Documentation/git-cherry-pick.txt

@ -16,6 +16,25 @@ Given one or more existing commits, apply the change each one
introduces, recording a new commit for each. This requires your introduces, recording a new commit for each. This requires your
working tree to be clean (no modifications from the HEAD commit). working tree to be clean (no modifications from the HEAD commit).


When it is not obvious how to apply a change, the following
happens:

1. The current branch and `HEAD` pointer stay at the last commit
successfully made.
2. The `CHERRY_PICK_HEAD` ref is set to point at the commit that
introduced the change that is difficult to apply.
3. Paths in which the change applied cleanly are updated both
in the index file and in your working tree.
4. For conflicting paths, the index file records up to three
versions, as described in the "TRUE MERGE" section of
linkgit:git-merge[1]. The working tree files will include
a description of the conflict bracketed by the usual
conflict markers `<<<<<<<` and `>>>>>>>`.
5. No other modifications are made.

See linkgit:git-merge[1] for some hints on resolving such
conflicts.

OPTIONS OPTIONS
------- -------
<commit>...:: <commit>...::
@ -79,6 +98,16 @@ effect to your index in a row.
cherry-pick'ed commit, then a fast forward to this commit will cherry-pick'ed commit, then a fast forward to this commit will
be performed. be performed.


--strategy=<strategy>::
Use the given merge strategy. Should only be used once.
See the MERGE STRATEGIES section in linkgit:git-merge[1]
for details.

-X<option>::
--strategy-option=<option>::
Pass the merge strategy-specific option through to the
merge strategy. See linkgit:git-merge[1] for details.

EXAMPLES EXAMPLES
-------- --------
git cherry-pick master:: git cherry-pick master::
@ -120,13 +149,27 @@ git rev-list --reverse master \-- README | git cherry-pick -n --stdin::
so the result can be inspected and made into a single new so the result can be inspected and made into a single new
commit if suitable. commit if suitable.


Author The following sequence attempts to backport a patch, bails out because
------ the code the patch applies to has changed too much, and then tries
Written by Junio C Hamano <gitster@pobox.com> again, this time exercising more care about matching up context lines.


Documentation ------------
-------------- $ git cherry-pick topic^ <1>
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>. $ git diff <2>
$ git reset --merge ORIG_HEAD <3>
$ git cherry-pick -Xpatience topic^ <4>
------------
<1> apply the change that would be shown by `git show topic^`.
In this example, the patch does not apply cleanly, so
information about the conflict is written to the index and
working tree and no new commit results.
<2> summarize changes to be reconciled
<3> cancel the cherry-pick. In other words, return to the
pre-cherry-pick state, preserving any local modifications you had in
the working tree.
<4> try to apply the change introduced by `topic^` again,
spending extra time to avoid mistakes based on incorrectly matching
context lines.


SEE ALSO SEE ALSO
-------- --------

8
Documentation/git-cherry.txt

@ -63,14 +63,6 @@ SEE ALSO
-------- --------
linkgit:git-patch-id[1] linkgit:git-patch-id[1]


Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-citool.txt

@ -19,14 +19,6 @@ to the less interactive 'git commit' program.
'git citool' is actually a standard alias for `git gui citool`. 'git citool' is actually a standard alias for `git gui citool`.
See linkgit:git-gui[1] for more details. See linkgit:git-gui[1] for more details.


Author
------
Written by Shawn O. Pearce <spearce@spearce.org>.

Documentation
--------------
Documentation by Shawn O. Pearce <spearce@spearce.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

6
Documentation/git-clean.txt

@ -61,12 +61,6 @@ OPTIONS
Remove only files ignored by git. This may be useful to rebuild Remove only files ignored by git. This may be useful to rebuild
everything from scratch, but keep manually created files. everything from scratch, but keep manually created files.



Author
------
Written by Pavel Roskin <proski@gnu.org>


GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

21
Documentation/git-clone.txt

@ -12,6 +12,7 @@ SYNOPSIS
'git clone' [--template=<template_directory>] 'git clone' [--template=<template_directory>]
[-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [--mirror] [-l] [-s] [--no-hardlinks] [-q] [-n] [--bare] [--mirror]
[-o <name>] [-b <name>] [-u <upload-pack>] [--reference <repository>] [-o <name>] [-b <name>] [-u <upload-pack>] [--reference <repository>]
[--separate-git-dir|-L <git dir>]
[--depth <depth>] [--recursive|--recurse-submodules] [--] <repository> [--depth <depth>] [--recursive|--recurse-submodules] [--] <repository>
[<directory>] [<directory>]


@ -176,6 +177,15 @@ objects from the source repository into a pack in the cloned repository.
repository does not have a worktree/checkout (i.e. if any of repository does not have a worktree/checkout (i.e. if any of
`--no-checkout`/`-n`, `--bare`, or `--mirror` is given) `--no-checkout`/`-n`, `--bare`, or `--mirror` is given)


-L=<git dir>::
--separate-git-dir=<git dir>::
Instead of placing the cloned repository where it is supposed
to be, place the cloned repository at the specified directory,
then make a filesytem-agnostic git symbolic link to there.
The result is git repository can be separated from working
tree.


<repository>:: <repository>::
The (possibly remote) repository to clone from. See the The (possibly remote) repository to clone from. See the
<<URLS,URLS>> section below for more information on specifying <<URLS,URLS>> section below for more information on specifying
@ -236,17 +246,6 @@ $ git clone --bare -l -s /pub/scm/.../torvalds/linux-2.6.git \
/pub/scm/.../me/subsys-2.6.git /pub/scm/.../me/subsys-2.6.git
------------ ------------



Author
------
Written by Linus Torvalds <torvalds@osdl.org>


Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.


GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-commit-tree.txt

@ -93,15 +93,6 @@ SEE ALSO
-------- --------
linkgit:git-write-tree[1] linkgit:git-write-tree[1]



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

13
Documentation/git-commit.txt

@ -84,9 +84,10 @@ OPTIONS
linkgit:git-rebase[1] for details. linkgit:git-rebase[1] for details.


--reset-author:: --reset-author::
When used with -C/-c/--amend options, declare that the When used with -C/-c/--amend options, or when committing after a
authorship of the resulting commit now belongs of the committer. a conflicting cherry-pick, declare that the authorship of the
This also renews the author timestamp. resulting commit now belongs of the committer. This also renews
the author timestamp.


--short:: --short::
When doing a dry-run, give the output in the short-format. See When doing a dry-run, give the output in the short-format. See
@ -396,12 +397,6 @@ linkgit:git-mv[1],
linkgit:git-merge[1], linkgit:git-merge[1],
linkgit:git-commit-tree[1] linkgit:git-commit-tree[1]


Author
------
Written by Linus Torvalds <torvalds@osdl.org> and
Junio C Hamano <gitster@pobox.com>


GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-config.txt

@ -336,15 +336,6 @@ echo "${WS}your whitespace color or blue reverse${RESET}"


include::config.txt[] include::config.txt[]



Author
------
Written by Johannes Schindelin <Johannes.Schindelin@gmx.de>

Documentation
--------------
Documentation by Johannes Schindelin, Petr Baudis and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-count-objects.txt

@ -25,15 +25,6 @@ OPTIONS
and number of objects that can be removed by running and number of objects that can be removed by running
`git prune-packed`. `git prune-packed`.



Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-cvsexportcommit.txt

@ -112,14 +112,6 @@ $ cd ~/project_cvs_checkout
$ git cherry cvshead myhead | sed -n 's/^+ //p' | xargs -l1 git cvsexportcommit -c -p -v $ git cherry cvshead myhead | sed -n 's/^+ //p' | xargs -l1 git cvsexportcommit -c -p -v
------------ ------------


Author
------
Written by Martin Langhoff <martin@laptop.org> and others.

Documentation
--------------
Documentation by Martin Langhoff <martin@laptop.org> and others.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-cvsimport.txt

@ -217,15 +217,6 @@ more stable in practice:
* cvs2git (part of cvs2svn), `http://cvs2svn.tigris.org` * cvs2git (part of cvs2svn), `http://cvs2svn.tigris.org`
* parsecvs, `http://cgit.freedesktop.org/~keithp/parsecvs` * parsecvs, `http://cgit.freedesktop.org/~keithp/parsecvs`


Author
------
Written by Matthias Urlichs <smurf@smurf.noris.de>, with help from
various participants of the git-list <git@vger.kernel.org>.

Documentation
--------------
Documentation by Matthias Urlichs <smurf@smurf.noris.de>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

16
Documentation/git-cvsserver.txt

@ -391,22 +391,6 @@ Dependencies
------------ ------------
'git-cvsserver' depends on DBD::SQLite. 'git-cvsserver' depends on DBD::SQLite.


Copyright and Authors
---------------------

This program is copyright The Open University UK - 2006.

Authors:

- Martyn Smith <martyn@catalyst.net.nz>
- Martin Langhoff <martin@laptop.org>

with ideas and patches from participants of the git-list <git@vger.kernel.org>.

Documentation
--------------
Documentation by Martyn Smith <martyn@catalyst.net.nz>, Martin Langhoff <martin@laptop.org>, and Matthias Urlichs <smurf@smurf.noris.de>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

11
Documentation/git-daemon.txt

@ -279,17 +279,6 @@ that connected to it, if the IP address is available. REMOTE_ADDR will
be available in the environment of hooks called when be available in the environment of hooks called when
services are performed. services are performed.




Author
------
Written by Linus Torvalds <torvalds@osdl.org>, YOSHIFUJI Hideaki
<yoshfuji@linux-ipv6.org> and the git-list <git@vger.kernel.org>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

11
Documentation/git-describe.txt

@ -156,17 +156,6 @@ selected and output. Here fewest commits different is defined as
the number of commits which would be shown by `git log tag..input` the number of commits which would be shown by `git log tag..input`
will be the smallest number of commits possible. will be the smallest number of commits possible.



Author
------
Written by Linus Torvalds <torvalds@osdl.org>, but somewhat
butchered by Junio C Hamano <gitster@pobox.com>. Later significantly
updated by Shawn Pearce <spearce@spearce.org>.

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-diff-files.txt

@ -46,15 +46,6 @@ omit diff output for unmerged entries and just show "Unmerged".


include::diff-format.txt[] include::diff-format.txt[]



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-diff-index.txt

@ -116,15 +116,6 @@ tell which file is in which state, since the "has been updated" ones
show a valid sha1, and the "not in sync with the index" ones will show a valid sha1, and the "not in sync with the index" ones will
always have the special all-zero sha1. always have the special all-zero sha1.



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-diff-tree.txt

@ -162,15 +162,6 @@ in case you care).


include::diff-format.txt[] include::diff-format.txt[]



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-diff.txt

@ -174,14 +174,6 @@ linkgit:gitdiffcore[7],
linkgit:git-format-patch[1], linkgit:git-format-patch[1],
linkgit:git-apply[1] linkgit:git-apply[1]


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

13
Documentation/git-difftool.txt

@ -31,8 +31,8 @@ OPTIONS
--tool=<tool>:: --tool=<tool>::
Use the diff tool specified by <tool>. Use the diff tool specified by <tool>.
Valid merge tools are: Valid merge tools are:
kdiff3, kompare, tkdiff, meld, xxdiff, emerge, vimdiff, gvimdiff, araxis, bc3, diffuse, emerge, ecmerge, gvimdiff, kdiff3,
ecmerge, diffuse, opendiff, p4merge and araxis. kompare, meld, opendiff, p4merge, tkdiff, vimdiff and xxdiff.
+ +
If a diff tool is not specified, 'git difftool' If a diff tool is not specified, 'git difftool'
will use the configuration variable `diff.tool`. If the will use the configuration variable `diff.tool`. If the
@ -109,15 +109,6 @@ linkgit:git-mergetool[1]::
linkgit:git-config[1]:: linkgit:git-config[1]::
Get and set repository or global options Get and set repository or global options



AUTHOR
------
Written by David Aguilar <davvid@gmail.com>.

Documentation
--------------
Documentation by David Aguilar and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-fast-export.txt

@ -135,15 +135,6 @@ Since 'git fast-import' cannot tag trees, you will not be
able to export the linux-2.6.git repository completely, as it contains able to export the linux-2.6.git repository completely, as it contains
a tag referencing a tree instead of a commit. a tag referencing a tree instead of a commit.



Author
------
Written by Johannes E. Schindelin <johannes.schindelin@gmx.de>.

Documentation
--------------
Documentation by Johannes E. Schindelin <johannes.schindelin@gmx.de>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

75
Documentation/git-fast-import.txt

@ -78,6 +78,10 @@ OPTIONS
set of marks. If a mark is defined to different values, set of marks. If a mark is defined to different values,
the last file wins. the last file wins.


--import-marks-if-exists=<file>::
Like --import-marks but instead of erroring out, silently
skips the file if it does not exist.

--relative-marks:: --relative-marks::
After specifying --relative-marks= the paths specified After specifying --relative-marks= the paths specified
with --import-marks= and --export-marks= are relative with --import-marks= and --export-marks= are relative
@ -192,7 +196,8 @@ especially when a higher level language such as Perl, Python or
Ruby is being used. Ruby is being used.


fast-import is very strict about its input. Where we say SP below we mean fast-import is very strict about its input. Where we say SP below we mean
*exactly* one space. Likewise LF means one (and only one) linefeed. *exactly* one space. Likewise LF means one (and only one) linefeed
and HT one (and only one) horizontal tab.
Supplying additional whitespace characters will cause unexpected Supplying additional whitespace characters will cause unexpected
results, such as branch names or file names with leading or trailing results, such as branch names or file names with leading or trailing
spaces in their name, or early termination of fast-import when it encounters spaces in their name, or early termination of fast-import when it encounters
@ -330,6 +335,11 @@ and control the current import process. More detailed discussion
format to the file descriptor set with `--cat-blob-fd` or format to the file descriptor set with `--cat-blob-fd` or
`stdout` if unspecified. `stdout` if unspecified.


`ls`::
Causes fast-import to print a line describing a directory
entry in 'ls-tree' format to the file descriptor set with
`--cat-blob-fd` or `stdout` if unspecified.

`feature`:: `feature`::
Require that fast-import supports the specified feature, or Require that fast-import supports the specified feature, or
abort if it does not. abort if it does not.
@ -915,6 +925,55 @@ This command can be used anywhere in the stream that comments are
accepted. In particular, the `cat-blob` command can be used in the accepted. In particular, the `cat-blob` command can be used in the
middle of a commit but not in the middle of a `data` command. middle of a commit but not in the middle of a `data` command.


`ls`
~~~~
Prints information about the object at a path to a file descriptor
previously arranged with the `--cat-blob-fd` argument. This allows
printing a blob from the active commit (with `cat-blob`) or copying a
blob or tree from a previous commit for use in the current one (with
`filemodify`).

The `ls` command can be used anywhere in the stream that comments are
accepted, including the middle of a commit.

Reading from the active commit::
This form can only be used in the middle of a `commit`.
The path names a directory entry within fast-import's
active commit. The path must be quoted in this case.
+
....
'ls' SP <path> LF
....

Reading from a named tree::
The `<dataref>` can be a mark reference (`:<idnum>`) or the
full 40-byte SHA-1 of a Git tag, commit, or tree object,
preexisting or waiting to be written.
The path is relative to the top level of the tree
named by `<dataref>`.
+
....
'ls' SP <dataref> SP <path> LF
....

See `filemodify` above for a detailed description of `<path>`.

Output uses the same format as `git ls-tree <tree> {litdd} <path>`:

====
<mode> SP ('blob' | 'tree' | 'commit') SP <dataref> HT <path> LF
====

The <dataref> represents the blob, tree, or commit object at <path>
and can be used in later 'cat-blob', 'filemodify', or 'ls' commands.

If there is no file or subtree at that path, 'git fast-import' will
instead report

====
missing SP <path> LF
====

`feature` `feature`
~~~~~~~~~ ~~~~~~~~~
Require that fast-import supports the specified feature, or abort if Require that fast-import supports the specified feature, or abort if
@ -942,8 +1001,10 @@ import-marks::
any "feature import-marks" command in the stream. any "feature import-marks" command in the stream.


cat-blob:: cat-blob::
Ignored. Versions of fast-import not supporting the ls::
"cat-blob" command will exit with a message indicating so. Require that the backend support the 'cat-blob' or 'ls' command.
Versions of fast-import not supporting the specified command
will exit with a message indicating so.
This lets the import error out early with a clear message, This lets the import error out early with a clear message,
rather than wasting time on the early part of an import rather than wasting time on the early part of an import
before the unsupported command is detected. before the unsupported command is detected.
@ -1289,14 +1350,6 @@ operator can use this facility to peek at the objects and refs from an
import in progress, at the cost of some added running time and worse import in progress, at the cost of some added running time and worse
compression. compression.


Author
------
Written by Shawn O. Pearce <spearce@spearce.org>.

Documentation
--------------
Documentation by Shawn O. Pearce <spearce@spearce.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-fetch-pack.txt

@ -90,15 +90,6 @@ OPTIONS
$GIT_DIR (e.g. "HEAD", "refs/heads/master"). When $GIT_DIR (e.g. "HEAD", "refs/heads/master"). When
unspecified, update from all heads the remote side has. unspecified, update from all heads the remote side has.



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

21
Documentation/git-fetch.txt

@ -34,7 +34,7 @@ pointed by remote tags that it does not yet have, then fetch
those missing tags. If the other end has tags that point at those missing tags. If the other end has tags that point at
branches you are not interested in, you will not get them. branches you are not interested in, you will not get them.


'git fetch' can fetch from either a single named repository, or 'git fetch' can fetch from either a single named repository,
or from several repositories at once if <group> is given and or from several repositories at once if <group> is given and
there is a remotes.<group> entry in the configuration file. there is a remotes.<group> entry in the configuration file.
(See linkgit:git-config[1]). (See linkgit:git-config[1]).
@ -76,20 +76,19 @@ The `pu` branch will be updated even if it is does not fast-forward,
because it is prefixed with a plus sign; `tmp` will not be. because it is prefixed with a plus sign; `tmp` will not be.




BUGS
----
Using --recurse-submodules can only fetch new commits in already checked
out submodules right now. When e.g. upstream added a new submodule in the
just fetched commits of the superproject the submodule itself can not be
fetched, making it impossible to check out that submodule later without
having to do a fetch again. This is expected to be fixed in a future git
version.

SEE ALSO SEE ALSO
-------- --------
linkgit:git-pull[1] linkgit:git-pull[1]



Author
------
Written by Linus Torvalds <torvalds@osdl.org> and
Junio C Hamano <gitster@pobox.com>

Documentation
-------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

10
Documentation/git-filter-branch.txt

@ -405,16 +405,6 @@ warned.
(or if your git-gc is not new enough to support arguments to (or if your git-gc is not new enough to support arguments to
`\--prune`, use `git repack -ad; git prune` instead). `\--prune`, use `git repack -ad; git prune` instead).



Author
------
Written by Petr "Pasky" Baudis <pasky@suse.cz>,
and the git list <git@vger.kernel.org>

Documentation
--------------
Documentation by Petr Baudis and the git list.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-fmt-merge-msg.txt

@ -67,15 +67,6 @@ SEE ALSO
-------- --------
linkgit:git-merge[1] linkgit:git-merge[1]



Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Petr Baudis, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-format-patch.txt

@ -336,15 +336,6 @@ SEE ALSO
-------- --------
linkgit:git-am[1], linkgit:git-send-email[1] linkgit:git-am[1], linkgit:git-send-email[1]



Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

4
Documentation/git-fsck-objects.txt

@ -15,3 +15,7 @@ DESCRIPTION


This is a synonym for linkgit:git-fsck[1]. Please refer to the This is a synonym for linkgit:git-fsck[1]. Please refer to the
documentation of that command. documentation of that command.

GIT
---
Part of the linkgit:git[1] suite

8
Documentation/git-fsck.txt

@ -140,14 +140,6 @@ GIT_INDEX_FILE::
GIT_ALTERNATE_OBJECT_DIRECTORIES:: GIT_ALTERNATE_OBJECT_DIRECTORIES::
used to specify additional object database roots (usually unset) used to specify additional object database roots (usually unset)


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

4
Documentation/git-gc.txt

@ -151,10 +151,6 @@ linkgit:git-reflog[1]
linkgit:git-repack[1] linkgit:git-repack[1]
linkgit:git-rerere[1] linkgit:git-rerere[1]


Author
------
Written by Shawn O. Pearce <spearce@spearce.org>

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-get-tar-commit-id.txt

@ -22,15 +22,6 @@ return code of 1. This can happen if <tarfile> had not been created
using 'git archive' or if the first parameter of 'git archive' had been using 'git archive' or if the first parameter of 'git archive' had been
a tree ID instead of a commit ID or tag. a tree ID instead of a commit ID or tag.



Author
------
Written by Rene Scharfe <rene.scharfe@lsrfire.ath.cx>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

20
Documentation/git-grep.txt

@ -31,6 +31,16 @@ Look for specified patterns in the tracked files in the work tree, blobs
registered in the index file, or blobs in given tree objects. registered in the index file, or blobs in given tree objects.




CONFIGURATION
-------------

grep.lineNumber::
If set to true, enable '-n' option by default.

grep.extendedRegexp::
If set to true, enable '--extended-regexp' option by default.


OPTIONS OPTIONS
------- -------
--cached:: --cached::
@ -204,16 +214,6 @@ git grep --all-match -e NODE -e Unexpected::
Looks for a line that has `NODE` or `Unexpected` in Looks for a line that has `NODE` or `Unexpected` in
files that have lines that match both. files that have lines that match both.


Author
------
Originally written by Linus Torvalds <torvalds@osdl.org>, later
revamped by Junio C Hamano.


Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-gui.txt

@ -121,14 +121,6 @@ or


or browsed online at http://repo.or.cz/w/git-gui.git/[]. or browsed online at http://repo.or.cz/w/git-gui.git/[].


Author
------
Written by Shawn O. Pearce <spearce@spearce.org>.

Documentation
--------------
Documentation by Shawn O. Pearce <spearce@spearce.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-hash-object.txt

@ -53,14 +53,6 @@ OPTIONS
conversion. If the file is read from standard input then this conversion. If the file is read from standard input then this
is always implied, unless the --path option is given. is always implied, unless the --path option is given.


Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

11
Documentation/git-help.txt

@ -171,17 +171,6 @@ $ git config --global web.browser firefox
as they are probably more user specific than repository specific. as they are probably more user specific than repository specific.
See linkgit:git-config[1] for more information about this. See linkgit:git-config[1] for more information about this.


Author
------
Written by Junio C Hamano <gitster@pobox.com> and the git-list
<git@vger.kernel.org>.

Documentation
-------------
Initial documentation was part of the linkgit:git[1] man page.
Christian Couder <chriscool@tuxfamily.org> extracted and rewrote it a
little. Maintenance is done by the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-http-fetch.txt

@ -43,14 +43,6 @@ commit-id::
Verify that everything reachable from target is fetched. Used after Verify that everything reachable from target is fetched. Used after
an earlier fetch is interrupted. an earlier fetch is interrupted.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-http-push.txt

@ -91,15 +91,6 @@ With '--force', the fast-forward check is disabled for all refs.
Optionally, a <ref> parameter can be prefixed with a plus '+' sign Optionally, a <ref> parameter can be prefixed with a plus '+' sign
to disable the fast-forward check only on that ref. to disable the fast-forward check only on that ref.



Author
------
Written by Nick Hengeveld <nickh@reactrix.com>

Documentation
--------------
Documentation by Nick Hengeveld

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-imap-send.txt

@ -124,14 +124,6 @@ Thunderbird in particular is known to be problematic. Thunderbird
users may wish to visit this web page for more information: users may wish to visit this web page for more information:
http://kb.mozillazine.org/Plain_text_e-mail_-_Thunderbird#Completely_plain_email http://kb.mozillazine.org/Plain_text_e-mail_-_Thunderbird#Completely_plain_email


Author
------
Derived from isync 1.0.1 by Mike McCormack.

Documentation
--------------
Documentation by Mike McCormack

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-index-pack.txt

@ -85,15 +85,6 @@ new .keep file was successfully created. This is useful to remove a
.keep file used as a lock to prevent the race with 'git repack' .keep file used as a lock to prevent the race with 'git repack'
mentioned above. mentioned above.



Author
------
Written by Sergey Vlasov <vsu@altlinux.ru>

Documentation
-------------
Documentation by Sergey Vlasov

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

4
Documentation/git-init-db.txt

@ -16,3 +16,7 @@ DESCRIPTION


This is a synonym for linkgit:git-init[1]. Please refer to the This is a synonym for linkgit:git-init[1]. Please refer to the
documentation of that command. documentation of that command.

GIT
---
Part of the linkgit:git[1] suite

70
Documentation/git-init.txt

@ -8,9 +8,32 @@ git-init - Create an empty git repository or reinitialize an existing one


SYNOPSIS SYNOPSIS
-------- --------
'git init' [-q | --quiet] [--bare] [--template=<template_directory>] [--shared[=<permissions>]] [directory] 'git init' [-q | --quiet] [--bare] [--template=<template_directory>]
[--separate-git-dir|-L <git dir>]
[--shared[=<permissions>]] [directory]




DESCRIPTION
-----------

This command creates an empty git repository - basically a `.git`
directory with subdirectories for `objects`, `refs/heads`,
`refs/tags`, and template files. An initial `HEAD` file that
references the HEAD of the master branch is also created.

If the `$GIT_DIR` environment variable is set then it specifies a path
to use instead of `./.git` for the base of the repository.

If the object storage directory is specified via the
`$GIT_OBJECT_DIRECTORY` environment variable then the sha1 directories
are created underneath - otherwise the default `$GIT_DIR/objects`
directory is used.

Running 'git init' in an existing repository is safe. It will not
overwrite things that are already there. The primary reason for
rerunning 'git init' is to pick up newly added templates (or to move
the repository to another place if --separate-git-dir is given).

OPTIONS OPTIONS
------- -------


@ -31,6 +54,16 @@ current working directory.
Specify the directory from which templates will be used. (See the "TEMPLATE Specify the directory from which templates will be used. (See the "TEMPLATE
DIRECTORY" section below.) DIRECTORY" section below.)


-L=<git dir>::
--separate-git-dir=<git dir>::

Instead of initializing the repository where it is supposed to be,
place a filesytem-agnostic git symbolic link there, pointing to the
specified git path, and initialize a git repository at the path. The
result is git repository can be separated from working tree. If this
is reinitialization, the repository will be moved to the specified
path.

--shared[=(false|true|umask|group|all|world|everybody|0xxx)]:: --shared[=(false|true|umask|group|all|world|everybody|0xxx)]::


Specify that the git repository is to be shared amongst several users. This Specify that the git repository is to be shared amongst several users. This
@ -74,32 +107,6 @@ line, the command is run inside the directory (possibly after creating it).
-- --




DESCRIPTION
-----------
This command creates an empty git repository - basically a `.git` directory
with subdirectories for `objects`, `refs/heads`, `refs/tags`, and
template files.
An initial `HEAD` file that references the HEAD of the master branch
is also created.

If the `$GIT_DIR` environment variable is set then it specifies a path
to use instead of `./.git` for the base of the repository.

If the object storage directory is specified via the `$GIT_OBJECT_DIRECTORY`
environment variable then the sha1 directories are created underneath -
otherwise the default `$GIT_DIR/objects` directory is used.

Running 'git init' in an existing repository is safe. It will not overwrite
things that are already there. The primary reason for rerunning 'git init'
is to pick up newly added templates.

Note that 'git init' is the same as 'git init-db'. The command
was primarily meant to initialize the object database, but over
time it has become responsible for setting up the other aspects
of the repository, such as installing the default hooks and
setting the configuration variables. The old name is retained
for backward compatibility reasons.

TEMPLATE DIRECTORY TEMPLATE DIRECTORY
------------------ ------------------


@ -134,15 +141,6 @@ $ git add . <2>
<1> prepare /path/to/my/codebase/.git directory <1> prepare /path/to/my/codebase/.git directory
<2> add all existing file to the index <2> add all existing file to the index



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-instaweb.txt

@ -84,14 +84,6 @@ If the configuration variable 'instaweb.browser' is not set,
'web.browser' will be used instead if it is defined. See 'web.browser' will be used instead if it is defined. See
linkgit:git-web{litdd}browse[1] for more information about this. linkgit:git-web{litdd}browse[1] for more information about this.


Author
------
Written by Eric Wong <normalperson@yhbt.net>

Documentation
--------------
Documentation by Eric Wong <normalperson@yhbt.net>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-log.txt

@ -182,14 +182,6 @@ This setting can be disabled by the `--no-standard-notes` option,
overridden by the 'GIT_NOTES_DISPLAY_REF' environment variable, overridden by the 'GIT_NOTES_DISPLAY_REF' environment variable,
and supplemented by the `--show-notes` option. and supplemented by the `--show-notes` option.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-lost-found.txt

@ -67,15 +67,6 @@ $ git rev-parse not-lost-anymore
1ef2b196d909eed523d4f3c9bf54b78cdd6843c6 1ef2b196d909eed523d4f3c9bf54b78cdd6843c6
------------ ------------


Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.


GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-ls-files.txt

@ -209,15 +209,6 @@ SEE ALSO
-------- --------
linkgit:git-read-tree[1], linkgit:gitignore[5] linkgit:git-read-tree[1], linkgit:gitignore[5]



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano, Josh Triplett, and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

4
Documentation/git-ls-remote.txt

@ -67,10 +67,6 @@ EXAMPLES
c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2 c5db5456ae3b0873fc659c19fafdde22313cc441 refs/tags/v0.99.2
7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3 7ceca275d047c90c0c7d5afb13ab97efdf51bd6e refs/tags/v0.99.3


Author
------
Written by Junio C Hamano <gitster@pobox.com>

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

12
Documentation/git-ls-tree.txt

@ -95,18 +95,6 @@ Object size identified by <object> is given in bytes, and right-justified
with minimum width of 7 characters. Object size is given only for blobs with minimum width of 7 characters. Object size is given only for blobs
(file) entries; for other entries `-` character is used in place of size. (file) entries; for other entries `-` character is used in place of size.



Author
------
Written by Petr Baudis <pasky@suse.cz>
Completely rewritten from scratch by Junio C Hamano <gitster@pobox.com>,
another major rewrite by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list
<git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

11
Documentation/git-mailinfo.txt

@ -80,17 +80,6 @@ This can enabled by default with the configuration option mailinfo.scissors.
<patch>:: <patch>::
The patch extracted from e-mail. The patch extracted from e-mail.



Author
------
Written by Linus Torvalds <torvalds@osdl.org> and
Junio C Hamano <gitster@pobox.com>


Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

10
Documentation/git-mailsplit.txt

@ -46,16 +46,6 @@ OPTIONS
--keep-cr:: --keep-cr::
Do not remove `\r` from lines ending with `\r\n`. Do not remove `\r` from lines ending with `\r\n`.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>
and Junio C Hamano <gitster@pobox.com>


Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-merge-base.txt

@ -102,14 +102,6 @@ both '1' and '2' are merge-bases of A and B. Neither one is better than
the other (both are 'best' merge bases). When the `--all` option is not given, the other (both are 'best' merge bases). When the `--all` option is not given,
it is unspecified which best one is output. it is unspecified which best one is output.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

See also See also
-------- --------
linkgit:git-rev-list[1], linkgit:git-rev-list[1],

11
Documentation/git-merge-file.txt

@ -86,17 +86,6 @@ git merge-file -L a -L b -L c tmp/a123 tmp/b234 tmp/c345::
merges tmp/a123 and tmp/c345 with the base tmp/b234, but uses labels merges tmp/a123 and tmp/c345 with the base tmp/b234, but uses labels
`a` and `c` instead of `tmp/a123` and `tmp/c345`. `a` and `c` instead of `tmp/a123` and `tmp/c345`.



Author
------
Written by Johannes Schindelin <johannes.schindelin@gmx.de>


Documentation
--------------
Documentation by Johannes Schindelin and the git-list <git@vger.kernel.org>,
with parts copied from the original documentation of RCS 'merge'.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-merge-index.txt

@ -73,15 +73,6 @@ merge once anything has returned an error (i.e., `cat` returned an error
for the AA file, because it didn't exist in the original, and thus for the AA file, because it didn't exist in the original, and thus
'git merge-index' didn't even try to merge the MM thing). 'git merge-index' didn't even try to merge the MM thing).


Author
------
Written by Linus Torvalds <torvalds@osdl.org>
One-shot merge by Petr Baudis <pasky@ucw.cz>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-merge-one-file.txt

@ -15,15 +15,6 @@ DESCRIPTION
This is the standard helper program to use with 'git merge-index' This is the standard helper program to use with 'git merge-index'
to resolve a merge after the trivial merge done with 'git read-tree -m'. to resolve a merge after the trivial merge done with 'git read-tree -m'.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>,
Junio C Hamano <gitster@pobox.com> and Petr Baudis <pasky@suse.cz>.

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-merge-tree.txt

@ -23,14 +23,6 @@ merge results outside of the index, and stuff the results back into the
index. For this reason, the output from the command omits index. For this reason, the output from the command omits
entries that match the <branch1> tree. entries that match the <branch1> tree.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

20
Documentation/git-merge.txt

@ -11,7 +11,7 @@ SYNOPSIS
[verse] [verse]
'git merge' [-n] [--stat] [--no-commit] [--squash] 'git merge' [-n] [--stat] [--no-commit] [--squash]
[-s <strategy>] [-X <strategy-option>] [-s <strategy>] [-X <strategy-option>]
[--[no-]rerere-autoupdate] [-m <msg>] <commit>... [--[no-]rerere-autoupdate] [-m <msg>] [<commit>...]
'git merge' <msg> HEAD <commit>... 'git merge' <msg> HEAD <commit>...
'git merge' --abort 'git merge' --abort


@ -95,8 +95,13 @@ commit or stash your changes before running 'git merge'.


<commit>...:: <commit>...::
Commits, usually other branch heads, to merge into our branch. Commits, usually other branch heads, to merge into our branch.
You need at least one <commit>. Specifying more than one Specifying more than one commit will create a merge with
<commit> obviously means you are trying an Octopus. more than two parents (affectionately called an Octopus merge).
+
If no commit is given from the command line, and if `merge.defaultToUpstream`
configuration variable is set, merge the remote tracking branches
that the current branch is configured to use as its upstream.
See also the configuration section of this manual page.




PRE-MERGE CHECKS PRE-MERGE CHECKS
@ -312,15 +317,6 @@ linkgit:git-diff[1], linkgit:git-ls-files[1],
linkgit:git-add[1], linkgit:git-rm[1], linkgit:git-add[1], linkgit:git-rm[1],
linkgit:git-mergetool[1] linkgit:git-mergetool[1]


Author
------
Written by Junio C Hamano <gitster@pobox.com>


Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-mergetool--lib.txt

@ -41,14 +41,6 @@ run_merge_tool::
'$MERGED', '$LOCAL', '$REMOTE', and '$BASE' must be defined '$MERGED', '$LOCAL', '$REMOTE', and '$BASE' must be defined
for use by the merge tool. for use by the merge tool.


Author
------
Written by David Aguilar <davvid@gmail.com>

Documentation
--------------
Documentation by David Aguilar and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

12
Documentation/git-mergetool.txt

@ -26,8 +26,8 @@ OPTIONS
--tool=<tool>:: --tool=<tool>::
Use the merge resolution program specified by <tool>. Use the merge resolution program specified by <tool>.
Valid merge tools are: Valid merge tools are:
kdiff3, tkdiff, meld, xxdiff, emerge, vimdiff, gvimdiff, ecmerge, araxis, bc3, diffuse, ecmerge, emerge, gvimdiff, kdiff3,
diffuse, tortoisemerge, opendiff, p4merge and araxis. meld, opendiff, p4merge, tkdiff, tortoisemerge, vimdiff and xxdiff.
+ +
If a merge resolution program is not specified, 'git mergetool' If a merge resolution program is not specified, 'git mergetool'
will use the configuration variable `merge.tool`. If the will use the configuration variable `merge.tool`. If the
@ -82,14 +82,6 @@ Setting the `mergetool.keepBackup` configuration variable to `false`
causes `git mergetool` to automatically remove the backup as files causes `git mergetool` to automatically remove the backup as files
are successfully merged. are successfully merged.


Author
------
Written by Theodore Y Ts'o <tytso@mit.edu>

Documentation
--------------
Documentation by Theodore Y Ts'o.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-mktag.txt

@ -32,15 +32,6 @@ exists, is separated by a blank line from the header. The
message part may contain a signature that git itself doesn't message part may contain a signature that git itself doesn't
care about, but that can be verified with gpg. care about, but that can be verified with gpg.



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-mktree.txt

@ -34,14 +34,6 @@ OPTIONS
optional. Note - if the '-z' option is used, lines are terminated optional. Note - if the '-z' option is used, lines are terminated
with NUL. with NUL.


Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

11
Documentation/git-mv.txt

@ -39,17 +39,6 @@ OPTIONS
--dry-run:: --dry-run::
Do nothing; only show what would happen Do nothing; only show what would happen



Author
------
Written by Linus Torvalds <torvalds@osdl.org>
Rewritten by Ryan Anderson <ryan@michonline.com>
Move functionality added by Josef Weidendorfer <Josef.Weidendorfer@gmx.de>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-name-rev.txt

@ -70,15 +70,6 @@ Another nice thing you can do is:
% git log | git name-rev --stdin % git log | git name-rev --stdin
------------ ------------



Author
------
Written by Johannes Schindelin <Johannes.Schindelin@gmx.de>

Documentation
--------------
Documentation by Johannes Schindelin.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

11
Documentation/git-pack-objects.txt

@ -115,7 +115,7 @@ base-name::


--honor-pack-keep:: --honor-pack-keep::
This flag causes an object already in a local pack that This flag causes an object already in a local pack that
has a .keep file to be ignored, even if it it would have has a .keep file to be ignored, even if it would have
otherwise been packed. otherwise been packed.


--incremental:: --incremental::
@ -224,15 +224,6 @@ So does `git bundle` (see linkgit:git-bundle[1]) when it creates a bundle.
With this option, parents that are hidden by grafts are packed With this option, parents that are hidden by grafts are packed
nevertheless. nevertheless.



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
-------------
Documentation by Junio C Hamano

SEE ALSO SEE ALSO
-------- --------
linkgit:git-rev-list[1] linkgit:git-rev-list[1]

8
Documentation/git-pack-redundant.txt

@ -38,14 +38,6 @@ OPTIONS
--verbose:: --verbose::
Outputs some statistics to stderr. Has a small performance penalty. Outputs some statistics to stderr. Has a small performance penalty.


Author
------
Written by Lukas Sandström <lukass@etek.chalmers.se>

Documentation
--------------
Documentation by Lukas Sandström <lukass@etek.chalmers.se>

SEE ALSO SEE ALSO
-------- --------
linkgit:git-pack-objects[1] linkgit:git-pack-objects[1]

5
Documentation/git-pack-refs.txt

@ -56,11 +56,6 @@ a repository with many branches of historical interests.
The command usually removes loose refs under `$GIT_DIR/refs` The command usually removes loose refs under `$GIT_DIR/refs`
hierarchy after packing them. This option tells it not to. hierarchy after packing them. This option tells it not to.



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-parse-remote.txt

@ -17,14 +17,6 @@ routines to parse files under $GIT_DIR/remotes/ and
$GIT_DIR/branches/ and configuration variables that are related $GIT_DIR/branches/ and configuration variables that are related
to fetching, pulling and pushing. to fetching, pulling and pushing.


Author
------
Written by Junio C Hamano.

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-patch-id.txt

@ -29,14 +29,6 @@ OPTIONS
<patch>:: <patch>::
The diff to create the ID of. The diff to create the ID of.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-peek-remote.txt

@ -37,14 +37,6 @@ OPTIONS
The repository to sync from. The repository to sync from.




Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Junio C Hamano.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-prune-packed.txt

@ -36,14 +36,6 @@ OPTIONS
--quiet:: --quiet::
Squelch the progress indicator. Squelch the progress indicator.


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Ryan Anderson <ryan@michonline.com>

SEE ALSO SEE ALSO
-------- --------
linkgit:git-pack-objects[1] linkgit:git-pack-objects[1]

8
Documentation/git-prune.txt

@ -78,14 +78,6 @@ linkgit:git-fsck[1],
linkgit:git-gc[1], linkgit:git-gc[1],
linkgit:git-reflog[1] linkgit:git-reflog[1]


Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

23
Documentation/git-pull.txt

@ -84,7 +84,7 @@ must be given before the options meant for 'git fetch'.
--verbose:: --verbose::
Pass --verbose to git-fetch and git-merge. Pass --verbose to git-fetch and git-merge.


--[no-]recurse-submodules:: --[no-]recurse-submodules[=yes|on-demand|no]::
This option controls if new commits of all populated submodules should This option controls if new commits of all populated submodules should
be fetched too (see linkgit:git-config[1] and linkgit:gitmodules[5]). be fetched too (see linkgit:git-config[1] and linkgit:gitmodules[5]).
That might be necessary to get the data needed for merging submodule That might be necessary to get the data needed for merging submodule
@ -220,22 +220,19 @@ If you tried a pull which resulted in a complex conflicts and
would want to start over, you can recover with 'git reset'. would want to start over, you can recover with 'git reset'.




BUGS
----
Using --recurse-submodules can only fetch new commits in already checked
out submodules right now. When e.g. upstream added a new submodule in the
just fetched commits of the superproject the submodule itself can not be
fetched, making it impossible to check out that submodule later without
having to do a fetch again. This is expected to be fixed in a future git
version.

SEE ALSO SEE ALSO
-------- --------
linkgit:git-fetch[1], linkgit:git-merge[1], linkgit:git-config[1] linkgit:git-fetch[1], linkgit:git-merge[1], linkgit:git-config[1]



Author
------
Written by Linus Torvalds <torvalds@osdl.org>
and Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Jon Loeliger,
David Greaves,
Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

10
Documentation/git-push.txt

@ -406,16 +406,6 @@ Commits A and B would no longer belong to a branch with a symbolic name,
and so would be unreachable. As such, these commits would be removed by and so would be unreachable. As such, these commits would be removed by
a `git gc` command on the origin repository. a `git gc` command on the origin repository.



Author
------
Written by Junio C Hamano <gitster@pobox.com>, later rewritten in C
by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-quiltimport.txt

@ -49,14 +49,6 @@ The default for the patch directory is patches
or the value of the $QUILT_PATCHES environment or the value of the $QUILT_PATCHES environment
variable. variable.


Author
------
Written by Eric Biederman <ebiederm@lnxi.com>

Documentation
--------------
Documentation by Eric Biederman <ebiederm@lnxi.com>

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-read-tree.txt

@ -421,15 +421,6 @@ SEE ALSO
linkgit:git-write-tree[1]; linkgit:git-ls-files[1]; linkgit:git-write-tree[1]; linkgit:git-ls-files[1];
linkgit:gitignore[5] linkgit:gitignore[5]



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by David Greaves, Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

15
Documentation/git-rebase.txt

@ -66,8 +66,9 @@ would be:
D---E---F---G master D---E---F---G master
------------ ------------


The latter form is just a short-hand of `git checkout topic` *NOTE:* The latter form is just a short-hand of `git checkout topic`
followed by `git rebase master`. followed by `git rebase master`. When rebase exits `topic` will
remain the checked-out branch.


If the upstream branch already contains a change you have made (e.g., If the upstream branch already contains a change you have made (e.g.,
because you mailed a patch which was applied upstream), then that commit because you mailed a patch which was applied upstream), then that commit
@ -658,7 +659,6 @@ The ripple effect of a "hard case" recovery is especially bad:
'everyone' downstream from 'topic' will now have to perform a "hard 'everyone' downstream from 'topic' will now have to perform a "hard
case" recovery too! case" recovery too!



BUGS BUGS
---- ----
The todo list presented by `--preserve-merges --interactive` does not The todo list presented by `--preserve-merges --interactive` does not
@ -681,15 +681,6 @@ by moving the "pick 4" line will result in the following history:
1 --- 2 --- 4 --- 5 1 --- 2 --- 4 --- 5
------------ ------------


Authors
------
Written by Junio C Hamano <gitster@pobox.com> and
Johannes E. Schindelin <johannes.schindelin@gmx.de>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-receive-pack.txt

@ -151,15 +151,6 @@ SEE ALSO
-------- --------
linkgit:git-send-pack[1] linkgit:git-send-pack[1]



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Junio C Hamano.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-reflog.txt

@ -90,14 +90,6 @@ them.
--verbose:: --verbose::
Print extra information on screen. Print extra information on screen.


Author
------
Written by Junio C Hamano <gitster@pobox.com>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

8
Documentation/git-relink.txt

@ -24,14 +24,6 @@ OPTIONS
<dir>:: <dir>::
Directories containing a .git/objects/ subdirectory. Directories containing a .git/objects/ subdirectory.


Author
------
Written by Ryan Anderson <ryan@michonline.com>

Documentation
--------------
Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

4
Documentation/git-remote-helpers.txt

@ -239,10 +239,6 @@ SEE ALSO
-------- --------
linkgit:git-remote[1] linkgit:git-remote[1]


Documentation
-------------
Documentation by Daniel Barkalow and Ilari Liusvaara

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

25
Documentation/git-remote.txt

@ -10,7 +10,7 @@ SYNOPSIS
-------- --------
[verse] [verse]
'git remote' [-v | --verbose] 'git remote' [-v | --verbose]
'git remote add' [-t <branch>] [-m <master>] [-f] [--tags|--no-tags] [--mirror] <name> <url> 'git remote add' [-t <branch>] [-m <master>] [-f] [--tags|--no-tags] [--mirror=<fetch|push>] <name> <url>
'git remote rename' <old> <new> 'git remote rename' <old> <new>
'git remote rm' <name> 'git remote rm' <name>
'git remote set-head' <name> (-a | -d | <branch>) 'git remote set-head' <name> (-a | -d | <branch>)
@ -67,11 +67,14 @@ multiple branches without grabbing all branches.
With `-m <master>` option, `$GIT_DIR/remotes/<name>/HEAD` is set With `-m <master>` option, `$GIT_DIR/remotes/<name>/HEAD` is set
up to point at remote's `<master>` branch. See also the set-head command. up to point at remote's `<master>` branch. See also the set-head command.
+ +
In mirror mode, enabled with `\--mirror`, the refs will not be stored When a fetch mirror is created with `\--mirror=fetch`, the refs will not
in the 'refs/remotes/' namespace, but in 'refs/heads/'. This option be stored in the 'refs/remotes/' namespace, but rather everything in
only makes sense in bare repositories. If a remote uses mirror 'refs/' on the remote will be directly mirrored into 'refs/' in the
mode, furthermore, `git push` will always behave as if `\--mirror` local repository. This option only makes sense in bare repositories,
was passed. because a fetch would overwrite any local commits.
+
When a push mirror is created with `\--mirror=push`, then `git push`
will always behave as if `\--mirror` was passed.


'rename':: 'rename'::


@ -214,16 +217,6 @@ linkgit:git-fetch[1]
linkgit:git-branch[1] linkgit:git-branch[1]
linkgit:git-config[1] linkgit:git-config[1]


Author
------
Written by Junio Hamano


Documentation
--------------
Documentation by J. Bruce Fields and the git-list <git@vger.kernel.org>.


GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

9
Documentation/git-repack.txt

@ -123,15 +123,6 @@ need to set the configuration variable `repack.UseDeltaBaseOffset` to
is unaffected by this option as the conversion is performed on the fly is unaffected by this option as the conversion is performed on the fly
as needed in that case. as needed in that case.



Author
------
Written by Linus Torvalds <torvalds@osdl.org>

Documentation
--------------
Documentation by Ryan Anderson <ryan@michonline.com>

SEE ALSO SEE ALSO
-------- --------
linkgit:git-pack-objects[1] linkgit:git-pack-objects[1]

11
Documentation/git-replace.txt

@ -80,17 +80,6 @@ linkgit:git-tag[1]
linkgit:git-branch[1] linkgit:git-branch[1]
linkgit:git[1] linkgit:git[1]


Author
------
Written by Christian Couder <chriscool@tuxfamily.org> and Junio C
Hamano <gitster@pobox.com>, based on 'git tag' by Kristian Hogsberg
<krh@redhat.com> and Carlos Rica <jasampler@gmail.com>.

Documentation
--------------
Documentation by Christian Couder <chriscool@tuxfamily.org> and the
git-list <git@vger.kernel.org>, based on 'git tag' documentation.

GIT GIT
--- ---
Part of the linkgit:git[1] suite Part of the linkgit:git[1] suite

4
Documentation/git-repo-config.txt

@ -16,3 +16,7 @@ DESCRIPTION


This is a synonym for linkgit:git-config[1]. Please refer to the This is a synonym for linkgit:git-config[1]. Please refer to the
documentation of that command. documentation of that command.

GIT
---
Part of the linkgit:git[1] suite

Some files were not shown because too many files have changed in this diff Show More

Loading…
Cancel
Save