Go to file

Junio C Hamano c809496c97 Merge branch 'jk/interpret-branch-name' "git branch @" created refs/heads/@ as a branch, and in general the code that handled @{-1} and @{upstream} was a bit too loose in disambiguating. * jk/interpret-branch-name: checkout: restrict @-expansions when finding branch strbuf_check_ref_format(): expand only local branches branch: restrict @-expansions when deleting t3204: test git-branch @-expansion corner cases interpret_branch_name: allow callers to restrict expansions strbuf_branchname: add docstring strbuf_branchname: drop return value interpret_branch_name: move docstring to header file interpret_branch_name(): handle auto-namelen for @{-1}		2017-03-14 15:23:18 -07:00
Documentation	Third batch after 2.12	2017-03-12 23:24:14 -07:00
block-sha1	…
builtin	Merge branch 'jk/interpret-branch-name'	2017-03-14 15:23:18 -07:00
ci	…
compat	Merge branch 'js/mingw-isatty'	2017-02-16 14:45:13 -08:00
contrib	Merge branch 'ss/remote-bzr-hg-placeholder-wo-python'	2017-03-12 23:21:34 -07:00
ewah	Merge branch 'jk/ewah-use-right-type-in-sizeof'	2017-03-12 23:21:35 -07:00
git-gui	…
gitk-git	Merge git://ozlabs.org/~paulus/gitk	2017-01-18 10:27:59 -08:00
gitweb	…
mergetools	…
perl	Merge branch 'svn-escape-backslash' of git://bogomips.org/git-svn	2017-02-20 22:01:59 -08:00
po	l10n: zh_CN: for git v2.12.0 l10n round 2	2017-02-25 00:19:14 +08:00
ppc	…
refs	Merge branch 'km/delete-ref-reflog-message'	2017-02-27 13:57:18 -08:00
t	Merge branch 'jk/interpret-branch-name'	2017-03-14 15:23:18 -07:00
templates	…
vcs-svn	…
xdiff	…
.gitattributes	…
.gitignore	rebase--helper: add a builtin helper for interactive rebases	2017-02-09 14:55:26 -08:00
.mailmap	Merge branch 'ps/urlmatch-wildcard'	2017-02-27 13:57:12 -08:00
.travis.yml	travis-ci: fix Perforce install on macOS	2017-01-23 10:55:00 -08:00
COPYING	…
GIT-VERSION-GEN	First batch after 2.12	2017-02-27 14:04:24 -08:00
INSTALL	…
LGPL-2.1	…
Makefile	Merge branch 'rj/remove-unused-mktemp'	2017-03-10 13:24:24 -08:00
README.md	README: create HTTP/HTTPS links from URLs in Markdown	2017-03-01 14:45:45 -08:00
RelNotes	First batch after 2.12	2017-02-27 14:04:24 -08:00
abspath.c	real_pathdup(): fix callsites that wanted it to die on error	2017-03-08 14:38:41 -08:00
aclocal.m4	…
advice.c	…
advice.h	…
alias.c	…
alloc.c	…
apply.c	apply: use SWAP macro	2017-01-30 14:07:52 -08:00
apply.h	…
archive-tar.c	…
archive-zip.c	…
archive.c	attr: convert git_check_attrs() callers to use the new API	2017-02-01 13:46:52 -08:00
archive.h	…
argv-array.c	…
argv-array.h	…
attr.c	attr: reformat git_attr_set_direction() function	2017-02-01 13:46:53 -08:00
attr.h	attr: reformat git_attr_set_direction() function	2017-02-01 13:46:53 -08:00
base85.c	…
bisect.c	Merge branch 'mm/two-more-xstrfmt'	2017-02-27 13:57:17 -08:00
bisect.h	…
blob.c	…
blob.h	…
branch.c	branch: record creation of renamed branch in HEAD's log	2017-02-20 22:04:47 -08:00
branch.h	branch: record creation of renamed branch in HEAD's log	2017-02-20 22:04:47 -08:00
builtin.h	rebase--helper: add a builtin helper for interactive rebases	2017-02-09 14:55:26 -08:00
bulk-checkin.c	…
bulk-checkin.h	…
bundle.c	…
bundle.h	…
cache-tree.c	…
cache-tree.h	…
cache.h	Merge branch 'jk/interpret-branch-name'	2017-03-14 15:23:18 -07:00
check-builtins.sh	…
check-racy.c	…
check_bindir	…
color.c	Merge branch 'nd/log-graph-configurable-colors'	2017-02-02 13:36:58 -08:00
color.h	…
column.c	…
column.h	…
combine-diff.c	…
command-list.txt	relink: retire the command	2017-01-25 14:42:37 -08:00
commit-slab.h	…
commit.c	Merge branch 'rs/commit-parsing-optim'	2017-03-10 13:24:22 -08:00
commit.h	Merge branch 'rs/log-email-subject'	2017-03-10 13:24:24 -08:00
common-main.c	attr: use hashmap for attribute dictionary	2017-02-01 13:46:53 -08:00
config.c	Merge branch 'jk/parse-config-key-cleanup'	2017-03-10 13:24:22 -08:00
config.mak.in	…
config.mak.uname	Merge branch 'jh/mingw-openssl-sha1'	2017-03-12 23:21:33 -07:00
configure.ac	wrapper.c: remove unused gitmkstemps() function	2017-02-28 11:54:21 -08:00
connect.c	connect.c: stop conflating ssh command names and overrides	2017-02-10 13:47:24 -08:00
connect.h	…
connected.c	…
connected.h	…
convert.c	attr: convert git_check_attrs() callers to use the new API	2017-02-01 13:46:52 -08:00
convert.h	…
copy.c	…
credential-cache--daemon.c	…
credential-cache.c	…
credential-store.c	…
credential.c	…
credential.h	…
csum-file.c	…
csum-file.h	…
ctype.c	…
daemon.c	…
date.c	…
decorate.c	…
decorate.h	…
delta.h	…
diff-delta.c	…
diff-lib.c	…
diff-no-index.c	diff: use SWAP macro	2017-01-30 14:23:00 -08:00
diff.c	Merge branch 'jc/diff-populate-filespec-size-only-fix'	2017-03-12 23:21:36 -07:00
diff.h	…
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	…
diffcore-rename.c	…
diffcore.h	…
dir-iterator.c	…
dir-iterator.h	…
dir.c	real_pathdup(): fix callsites that wanted it to die on error	2017-03-08 14:38:41 -08:00
dir.h	…
editor.c	…
entry.c	…
environment.c	real_pathdup(): fix callsites that wanted it to die on error	2017-03-08 14:38:41 -08:00
exec_cmd.c	Merge branch 'js/exec-path-coverity-workaround' into maint	2017-01-31 13:32:10 -08:00
exec_cmd.h	…
fast-import.c	delete_ref: accept a reflog message argument	2017-02-20 22:04:47 -08:00
fetch-pack.c	fetch-pack: cache results of for_each_alternate_ref	2017-02-08 15:39:55 -08:00
fetch-pack.h	…
fmt-merge-msg.h	…
fsck.c	fsck: lazily load types under --connectivity-only	2017-01-26 10:51:09 -08:00
fsck.h	…
generate-cmdlist.sh	…
gettext.c	…
gettext.h	…
git-add--interactive.perl	add--interactive: fix missing file prompt for patch mode with "-i"	2017-03-02 10:10:38 -08:00
git-archimport.perl	…
git-bisect.sh	…
git-compat-util.h	wrapper.c: remove unused gitmkstemps() function	2017-02-28 11:54:21 -08:00
git-cvsexportcommit.perl	…
git-cvsimport.perl	…
git-cvsserver.perl	…
git-difftool--helper.sh	…
git-filter-branch.sh	…
git-instaweb.sh	…
git-merge-octopus.sh	…
git-merge-one-file.sh	…
git-merge-resolve.sh	…
git-mergetool--lib.sh	…
git-mergetool.sh	…
git-p4.py	Merge branch 'ls/p4-path-encoding'	2017-02-16 14:45:12 -08:00
git-parse-remote.sh	…
git-quiltimport.sh	…
git-rebase--am.sh	…
git-rebase--interactive.sh	rebase -i: use the rebase--helper builtin	2017-02-09 14:55:40 -08:00
git-rebase--merge.sh	…
git-rebase.sh	…
git-remote-testgit.sh	…
git-request-pull.sh	…
git-send-email.perl	Merge branch 'jh/send-email-one-cc'	2017-03-10 13:24:23 -08:00
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-stash.sh	stash: allow pathspecs in the no verb form	2017-02-28 14:21:10 -08:00
git-submodule.sh	Merge branch 'sb/submodule-update-initial-runs-custom-script'	2017-02-03 11:25:19 -08:00
git-svn.perl	git svn: fix authentication with 'branch'	2017-03-07 21:29:03 +00:00
git-web--browse.sh	…
git.c	rebase--helper: add a builtin helper for interactive rebases	2017-02-09 14:55:26 -08:00
git.rc	…
gpg-interface.c	…
gpg-interface.h	gpg-interface, tag: add GPG_VERIFY_OMIT_STATUS flag	2017-01-17 16:10:22 -08:00
graph.c	Merge branch 'rs/swap'	2017-02-15 12:54:19 -08:00
graph.h	…
grep.c	…
grep.h	…
hashmap.c	…
hashmap.h	…
help.c	help: improve is_executable() on Windows	2017-01-30 09:04:17 -08:00
help.h	…
hex.c	…
http-backend.c	…
http-fetch.c	…
http-push.c	…
http-walker.c	…
http.c	Merge branch 'jt/http-base-url-update-upon-redirect'	2017-03-10 13:24:23 -08:00
http.h	…
ident.c	ident: do not ignore empty config name/email	2017-02-23 12:58:47 -08:00
imap-send.c	…
iterator.h	…
khash.h	…
kwset.c	…
kwset.h	…
levenshtein.c	…
levenshtein.h	…
line-log.c	Merge branch 'vn/line-log-memcpy-size-fix'	2017-03-12 23:21:35 -07:00
line-log.h	…
line-range.c	use SWAP macro	2017-01-30 14:17:00 -08:00
line-range.h	…
list-objects.c	…
list-objects.h	…
list.h	…
ll-merge.c	attr: convert git_check_attrs() callers to use the new API	2017-02-01 13:46:52 -08:00
ll-merge.h	…
lockfile.c	…
lockfile.h	…
log-tree.c	pretty: use fmt_output_email_subject()	2017-03-01 15:09:17 -08:00
log-tree.h	pretty: use fmt_output_email_subject()	2017-03-01 15:09:17 -08:00
mailinfo.c	…
mailinfo.h	…
mailmap.c	…
mailmap.h	…
match-trees.c	…
merge-blobs.c	…
merge-blobs.h	…
merge-recursive.c	Merge branch 'mm/merge-rename-delete-message'	2017-02-27 13:57:12 -08:00
merge-recursive.h	…
merge.c	…
mergesort.c	…
mergesort.h	…
mru.c	…
mru.h	…
name-hash.c	…
notes-cache.c	…
notes-cache.h	…
notes-merge.c	…
notes-merge.h	…
notes-utils.c	…
notes-utils.h	…
notes.c	…
notes.h	…
object.c	use SWAP macro	2017-01-30 14:17:00 -08:00
object.h	fetch-pack: cache results of for_each_alternate_ref	2017-02-08 15:39:55 -08:00
oidset.c	add oidset API	2017-02-08 15:39:55 -08:00
oidset.h	add oidset API	2017-02-08 15:39:55 -08:00
pack-bitmap-write.c	…
pack-bitmap.c	…
pack-bitmap.h	…
pack-check.c	…
pack-objects.c	…
pack-objects.h	pack-objects: enforce --depth limit in reused deltas	2017-01-27 16:24:44 -08:00
pack-revindex.c	use SWAP macro	2017-01-30 14:17:00 -08:00
pack-revindex.h	…
pack-write.c	…
pack.h	…
pager.c	…
parse-options-cb.c	…
parse-options.c	…
parse-options.h	…
patch-delta.c	…
patch-ids.c	…
patch-ids.h	…
path.c	…
pathspec.c	pathspec: don't error out on all-exclusionary pathspec patterns	2017-02-10 13:19:40 -08:00
pathspec.h	…
pkt-line.c	…
pkt-line.h	…
preload-index.c	preload-index: avoid lstat for skip-worktree items	2017-02-10 14:44:18 -08:00
pretty.c	Merge branch 'rs/log-email-subject'	2017-03-10 13:24:24 -08:00
prio-queue.c	use SWAP macro	2017-01-30 14:17:00 -08:00
prio-queue.h	…
progress.c	stop_progress_msg: convert xsnprintf to xstrfmt	2017-02-16 11:28:02 -08:00
progress.h	…
prompt.c	…
prompt.h	…
quote.c	…
quote.h	…
reachable.c	…
reachable.h	…
read-cache.c	Merge branch 'sb/in-core-index-doc'	2017-01-31 13:14:59 -08:00
ref-filter.c	Merge branch 'kn/ref-filter-branch-list'	2017-02-27 13:57:13 -08:00
ref-filter.h	Merge branch 'kn/ref-filter-branch-list'	2017-02-27 13:57:13 -08:00
reflog-walk.c	…
reflog-walk.h	…
refs.c	Merge branch 'jk/interpret-branch-name'	2017-03-14 15:23:18 -07:00
refs.h	branch: record creation of renamed branch in HEAD's log	2017-02-20 22:04:47 -08:00
remote-curl.c	…
remote-testsvn.c	…
remote.c	Merge branch 'jn/remote-helpers-with-git-dir'	2017-02-27 13:57:16 -08:00
remote.h	remote rename: more carefully determine whether a remote is configured	2017-01-19 14:04:23 -08:00
replace_object.c	…
rerere.c	…
rerere.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	interpret_branch_name: allow callers to restrict expansions	2017-03-02 11:05:04 -08:00
revision.h	…
run-command.c	Merge branch 'js/mingw-hooks-with-exe-suffix'	2017-02-02 13:36:57 -08:00
run-command.h	…
send-pack.c	…
send-pack.h	…
sequencer.c	…
sequencer.h	…
server-info.c	…
setup.c	Merge branch 'js/realpath-pathdup-fix'	2017-03-12 23:21:33 -07:00
sh-i18n--envsubst.c	…
sha1-array.c	…
sha1-array.h	…
sha1-lookup.c	…
sha1-lookup.h	…
sha1_file.c	Merge branch 'rs/sha1-file-plug-fallback-base-leak'	2017-03-10 13:24:23 -08:00
sha1_name.c	strbuf_check_ref_format(): expand only local branches	2017-03-02 11:05:04 -08:00
shallow.c	…
shell.c	…
shortlog.h	…
show-index.c	…
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
split-index.c	…
split-index.h	…
strbuf.c	strbuf: add strbuf_add_real_path()	2017-02-27 11:02:06 -08:00
strbuf.h	Merge branch 'jk/interpret-branch-name'	2017-03-14 15:23:18 -07:00
streaming.c	…
streaming.h	…
string-list.c	string-list: use QSORT_S in string_list_sort()	2017-01-23 11:02:38 -08:00
string-list.h	…
submodule-config.c	Merge branch 'bw/push-submodule-only'	2017-01-31 13:14:56 -08:00
submodule-config.h	Merge branch 'bw/grep-recurse-submodules'	2017-01-18 15:12:11 -08:00
submodule.c	real_pathdup(): fix callsites that wanted it to die on error	2017-03-08 14:38:41 -08:00
submodule.h	Merge branch 'bw/push-submodule-only'	2017-01-31 13:14:56 -08:00
symlinks.c	…
tag.c	gpg-interface, tag: add GPG_VERIFY_OMIT_STATUS flag	2017-01-17 16:10:22 -08:00
tag.h	…
tar.h	…
tempfile.c	tempfile: set errno to a known value before calling ferror()	2017-02-17 14:40:29 -08:00
tempfile.h	…
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	…
tmp-objdir.h	…
trace.c	…
trace.h	…
trailer.c	…
trailer.h	…
transport-helper.c	Merge branch 'jn/remote-helpers-with-git-dir'	2017-02-27 13:57:16 -08:00
transport.c	Merge branch 'km/delete-ref-reflog-message'	2017-02-27 13:57:18 -08:00
transport.h	for_each_alternate_ref: pass name/oid instead of ref struct	2017-02-08 15:39:55 -08:00
tree-diff.c	…
tree-walk.c	…
tree-walk.h	…
tree.c	…
tree.h	…
unicode_width.h	…
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unpack-trees.c	Merge branch 'sb/unpack-trees-super-prefix'	2017-02-03 11:25:18 -08:00
unpack-trees.h	…
upload-pack.c	upload-pack: report "not our ref" to client	2017-02-23 12:14:40 -08:00
url.c	…
url.h	…
urlmatch.c	urlmatch: allow globbing for the URL host part	2017-02-01 13:22:50 -08:00
urlmatch.h	urlmatch: include host in urlmatch ranking	2017-02-01 13:22:46 -08:00
usage.c	Merge branch 'jk/vreport-sanitize'	2017-01-31 13:14:56 -08:00
userdiff.c	attr: convert git_check_attrs() callers to use the new API	2017-02-01 13:46:52 -08:00
userdiff.h	…
utf8.c	…
utf8.h	…
varint.c	…
varint.h	…
version.c	…
version.h	…
versioncmp.c	…
walker.c	…
walker.h	…
wildmatch.c	…
wildmatch.h	…
worktree.c	Merge branch 'js/realpath-pathdup-fix'	2017-03-12 23:21:33 -07:00
worktree.h	…
wrap-for-bin.sh	…
wrapper.c	wrapper.c: remove unused gitmkstemps() function	2017-02-28 11:54:21 -08:00
write_or_die.c	…
ws.c	attr: convert git_check_attrs() callers to use the new API	2017-02-01 13:46:52 -08:00
wt-status.c	Merge branch 'rs/object-id'	2017-02-03 11:25:19 -08:00
wt-status.h	…
xdiff-interface.c	…
xdiff-interface.h	…
zlib.c	…

README.md

Git - fast, scalable, distributed revision control system

Git is a fast, scalable, distributed revision control system with an unusually rich command set that provides both high-level operations and full access to internals.

Git is an Open Source project covered by the GNU General Public License version 2 (some parts of it are under different licenses, compatible with the GPLv2). It was originally written by Linus Torvalds with help of a group of hackers around the net.

Please read the file INSTALL for installation instructions.

Many Git online resources are accessible from https://git-scm.com/ including full documentation and Git related tools.

See Documentation/gittutorial.txt to get started, then see Documentation/giteveryday.txt for a useful minimum set of commands, and Documentation/git-.txt for documentation of each command. If git has been correctly installed, then the tutorial can also be read with man gittutorial or git help tutorial, and the documentation of each command with man git-<commandname> or git help <commandname>.

CVS users may also want to read Documentation/gitcvs-migration.txt (man gitcvs-migration or git help cvs-migration if git is installed).

The user discussion and development of Git take place on the Git mailing list -- everyone is welcome to post bug reports, feature requests, comments and patches to git@vger.kernel.org (read Documentation/SubmittingPatches for instructions on patch submission). To subscribe to the list, send an email with just "subscribe git" in the body to majordomo@vger.kernel.org. The mailing list archives are available at https://public-inbox.org/git/, http://marc.info/?l=git and other archival sites.

The maintainer frequently sends the "What's cooking" reports that list the current status of various development topics to the mailing list. The discussion following them give a good reference for project status, development direction and remaining tasks.

The name "git" was given by Linus Torvalds when he wrote the very first version. He described the tool as "the stupid content tracker" and the name as (depending on your mood):

random three-letter combination that is pronounceable, and not actually used by any common UNIX command. The fact that it is a mispronunciation of "get" may or may not be relevant.
stupid. contemptible and despicable. simple. Take your pick from the dictionary of slang.
"global information tracker": you're in a good mood, and it actually works for you. Angels sing, and a light suddenly fills the room.
"goddamn idiotic truckload of sh*t": when it breaks