Go to file

Michael Haggerty 02b920f3f7 read_packed_refs(): ensure that references are ordered when read It doesn't actually matter now, because the references are only iterated over to fill the associated `ref_cache`, which itself puts them in the correct order. But we want to get rid of the `ref_cache`, so we want to be able to iterate directly over the `packed-refs` buffer, and then the iteration will need to be ordered correctly. In fact, we already write the `packed-refs` file sorted, but it is possible that other Git clients don't get it right. So let's not assume that a `packed-refs` file is sorted unless it is explicitly declared to be so via a `sorted` trait in its header line. If it is not declared to be sorted, then scan quickly through the file to check. If it is found to be out of order, then sort the records into a new memory-only copy. This checking and sorting is done quickly, without parsing the full file contents. However, it needs a little bit of care to avoid reading past the end of the buffer even if the `packed-refs` file is corrupt. Since we always write the file correctly sorted, include that trait when we write or rewrite a `packed-refs` file. This means that the scan described in the previous paragraph should only have to be done for `packed-refs` files that were written by older versions of the Git command-line client, or by other clients that haven't yet learned to write the `sorted` trait. If `packed-refs` was already sorted, then (if the system allows it) we can use the mmapped file contents directly. But if the system doesn't allow a file that is currently mmapped to be replaced using `rename()`, then it would be bad for us to keep the file mmapped for any longer than necessary. So, on such systems, always make a copy of the file contents, either as part of the sorting process, or afterwards. Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2017-09-25 18:02:45 +09:00
.github	Configure Git contribution guidelines for github.com	2017-06-13 08:41:47 -07:00
Documentation	The fifth batch post 2.14	2017-08-26 23:00:01 -07:00
block-sha1	…
builtin	Merge branch 'mg/killed-merge'	2017-08-26 22:55:10 -07:00
ci	Merge branch 'ls/travis-doc-asciidoctor' into maint	2017-06-05 09:03:10 +09:00
compat	Merge branch 'rs/bswap-ubsan-fix' into maint	2017-08-23 14:33:46 -07:00
contrib	Merge branch 'eb/contacts-reported-by'	2017-08-11 13:27:06 -07:00
ewah	use DIV_ROUND_UP	2017-07-10 14:24:36 -07:00
git-gui	Merge branch 'js/msgfmt-on-windows' of ../git-gui into js/git-gui-msgfmt-on-windows	2017-07-25 13:42:41 -07:00
gitk-git	…
gitweb	Merge branch 'js/gitweb-raw-blob-link-in-history'	2017-08-26 22:55:07 -07:00
mergetools	mergetools/meld: improve compatibiilty with Meld on macOS X	2017-06-18 22:11:29 -07:00
outgoing	pack: move pack name-related functions	2017-08-23 15:12:06 -07:00
perl	Merge branch 'ur/svn-local-zone'	2017-08-22 10:29:07 -07:00
po	l10n: zh_CN: review for git v2.14.0 l10n	2017-08-02 08:02:37 +08:00
ppc	…
refs	read_packed_refs(): ensure that references are ordered when read	2017-09-25 18:02:45 +09:00
sha1collisiondetection@19d97bf5af	sha1dc: optionally use sha1collisiondetection as a submodule	2017-07-03 10:09:34 -07:00
sha1dc	Merge branch 'ab/sha1dc-maint'	2017-07-06 18:14:44 -07:00
t	files_ref_store: use a transaction to update packed refs	2017-09-09 03:18:04 +09:00
templates	Merge branch 'ks/prepare-commit-msg-sample-fix'	2017-08-23 14:13:07 -07:00
vcs-svn	Merge branch 'jn/vcs-svn-cleanup'	2017-08-26 22:55:06 -07:00
xdiff	…
.gitattributes	…
.gitignore	…
.gitmodules	sha1dc: optionally use sha1collisiondetection as a submodule	2017-07-03 10:09:34 -07:00
.mailmap	…
.travis.yml	Merge branch 'ls/travis-doc-asciidoctor' into maint	2017-06-05 09:03:10 +09:00
COPYING	…
GIT-VERSION-GEN	Prepare for 2.14.2	2017-08-23 14:36:03 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	packed_ref_cache: keep the `packed-refs` file mmapped if possible	2017-09-25 18:02:45 +09:00
README.md	…
RelNotes	Prepare for 2.14.2	2017-08-23 14:36:03 -07:00
abspath.c	Spelling fixes	2017-06-27 10:35:49 -07:00
aclocal.m4	…
advice.c	Merge branch 'jk/warn-add-gitlink'	2017-06-24 14:28:41 -07:00
advice.h	add: warn when adding an embedded repository	2017-06-15 09:10:44 -07:00
alias.c	Merge branch 'js/alias-case-sensitivity'	2017-07-20 16:29:59 -07:00
alloc.c	…
apply.c	Merge branch 'tb/apply-with-crlf'	2017-08-26 22:55:05 -07:00
apply.h	apply: remove prefix_length member from apply_state	2017-08-09 10:21:45 -07:00
archive-tar.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
archive-zip.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
archive.c	sha1_name: convert get_sha1* to get_oid*	2017-07-17 13:54:51 -07:00
archive.h	…
argv-array.c	…
argv-array.h	…
attr.c	attr.c: drop hashmap_cmp_fn cast	2017-07-05 13:53:12 -07:00
attr.h	…
base85.c	…
bisect.c	bisect: convert bisect_checkout to struct object_id	2017-07-17 13:54:38 -07:00
bisect.h	…
blame.c	Merge branch 'js/blame-lib'	2017-07-31 13:05:15 -07:00
blame.h	…
blob.c	…
blob.h	…
branch.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
branch.h	…
builtin.h	git.c: provide setup_auto_pager()	2017-08-03 11:08:10 -07:00
bulk-checkin.c	pack: move {,re}prepare_packed_git and approximate_object_count	2017-08-23 15:12:07 -07:00
bulk-checkin.h	…
bundle.c	…
bundle.h	…
cache-tree.c	use MOVE_ARRAY	2017-07-17 14:54:56 -07:00
cache-tree.h	…
cache.h	Merge branch 'jt/packmigrate'	2017-08-26 22:55:09 -07:00
check-builtins.sh	…
check-racy.c	…
check_bindir	…
color.c	color: check color.ui in git_default_config()	2017-07-13 12:42:51 -07:00
color.h	diff.c: add dimming to moved line detection	2017-06-30 13:59:42 -07:00
column.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
column.h	…
combine-diff.c	Merge branch 'bw/ls-files-sans-the-index'	2017-06-24 14:28:40 -07:00
command-list.txt	…
commit-slab.h	*.[ch] refactoring: make use of the FREE_AND_NULL() macro	2017-06-16 12:44:09 -07:00
commit.c	Merge branch 'rs/move-array'	2017-08-11 13:26:57 -07:00
commit.h	Merge branch 'rs/commit-h-single-parent-cleanup'	2017-08-24 10:20:03 -07:00
common-main.c	…
config.c	Merge branch 'jc/cutoff-config'	2017-08-26 22:55:08 -07:00
config.h	Merge branch 'jc/cutoff-config'	2017-08-26 22:55:08 -07:00
config.mak.in	…
config.mak.uname	packed_ref_cache: keep the `packed-refs` file mmapped if possible	2017-09-25 18:02:45 +09:00
configure.ac	Merge branch 'nd/fopen-errors'	2017-06-22 14:15:20 -07:00
connect.c	Git 2.13.5	2017-08-04 12:40:37 -07:00
connect.h	…
connected.c	pack: move {,re}prepare_packed_git and approximate_object_count	2017-08-23 15:12:07 -07:00
connected.h	…
convert.c	Merge branch 'tb/apply-with-crlf'	2017-08-26 22:55:05 -07:00
convert.h	Merge branch 'tb/apply-with-crlf'	2017-08-26 22:55:05 -07:00
copy.c	…
credential-cache--daemon.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
credential-cache.c	Merge branch 'dl/credential-cache-socket-in-xdg-cache' into maint	2017-08-23 14:33:45 -07:00
credential-store.c	…
credential.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
credential.h	…
csum-file.c	…
csum-file.h	…
ctype.c	…
daemon.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
date.c	Merge branch 'ab/strbuf-addftime-tzname-boolify'	2017-07-06 18:14:47 -07:00
decorate.c	…
decorate.h	…
delta.h	…
diff-delta.c	…
diff-lib.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
diff-no-index.c	…
diff.c	Merge branch 'jt/packmigrate'	2017-08-26 22:55:09 -07:00
diff.h	diff: define block by number of alphanumeric chars	2017-08-16 11:44:00 -07:00
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	wildmatch: remove unused wildopts parameter	2017-06-23 18:27:07 -07:00
diffcore-pickaxe.c	…
diffcore-rename.c	progress: simplify "delayed" progress API	2017-08-19 14:01:34 -07:00
diffcore.h	…
dir-iterator.c	…
dir-iterator.h	…
dir.c	Merge branch 'rs/stat-data-unaligned-reads-fix' into maint	2017-08-23 14:33:48 -07:00
dir.h	Merge branch 'pc/dir-count-slashes'	2017-06-22 14:15:21 -07:00
editor.c	…
entry.c	convert: add "status=delayed" to filter process protocol	2017-06-30 13:50:41 -07:00
environment.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
exec_cmd.c	…
exec_cmd.h	…
fast-import.c	pack: move pack name-related functions	2017-08-23 15:12:06 -07:00
fetch-pack.c	pack: move {,re}prepare_packed_git and approximate_object_count	2017-08-23 15:12:07 -07:00
fetch-pack.h	…
fmt-merge-msg.h	…
fsck.c	commit: convert lookup_commit_graft to struct object_id	2017-07-13 12:02:40 -07:00
fsck.h	…
generate-cmdlist.sh	…
gettext.c	…
gettext.h	…
git-add--interactive.perl	Merge branch 'pw/unquote-path-in-git-pm' into maint	2017-07-31 13:51:05 -07:00
git-archimport.perl	…
git-bisect.sh	…
git-compat-util.h	pack: move release_pack_memory()	2017-08-23 15:12:06 -07:00
git-cvsexportcommit.perl	…
git-cvsimport.perl	…
git-cvsserver.perl	…
git-difftool--helper.sh	…
git-filter-branch.sh	filter-branch: add [--] to usage	2017-06-12 09:49:52 -07:00
git-instaweb.sh	…
git-merge-octopus.sh	scripts: use "git foo" not "git-foo"	2017-08-07 12:04:45 -07:00
git-merge-one-file.sh	scripts: use "git foo" not "git-foo"	2017-08-07 12:04:45 -07:00
git-merge-resolve.sh	scripts: use "git foo" not "git-foo"	2017-08-07 12:04:45 -07:00
git-mergetool--lib.sh	…
git-mergetool.sh	…
git-p4.py	git-p4: filter for {'code':'info'} in p4CmdList	2017-07-13 10:52:42 -07:00
git-parse-remote.sh	…
git-quiltimport.sh	…
git-rebase--am.sh	Merge branch 'kw/rebase-progress'	2017-08-23 14:13:07 -07:00
git-rebase--interactive.sh	rebase -i: honor --rerere-autoupdate	2017-08-02 15:16:09 -07:00
git-rebase--merge.sh	…
git-rebase.sh	Merge branch 'kw/rebase-progress'	2017-08-23 14:13:07 -07:00
git-remote-testgit.sh	…
git-request-pull.sh	…
git-send-email.perl	Merge branch 'xz/send-email-batch-size'	2017-07-06 18:14:46 -07:00
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-stash.sh	Merge branch 'kd/stash-with-bash-4.4'	2017-08-23 14:13:08 -07:00
git-submodule.sh	Merge branch 'sb/submodule-parallel-update'	2017-08-23 14:13:14 -07:00
git-svn.perl	…
git-web--browse.sh	…
git.c	Merge branch 'bw/grep-recurse-submodules'	2017-08-22 10:29:01 -07:00
git.rc	…
gpg-interface.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
gpg-interface.h	…
graph.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
graph.h	…
grep.c	Merge branch 'as/grep-quiet-no-match-exit-code-fix'	2017-08-23 14:13:12 -07:00
grep.h	grep: recurse in-process using 'struct repository'	2017-08-02 14:26:46 -07:00
hash.h	sha1dc: optionally use sha1collisiondetection as a submodule	2017-07-03 10:09:34 -07:00
hashmap.c	hashmap.h: compare function has access to a data field	2017-06-30 12:49:28 -07:00
hashmap.h	hashmap: migrate documentation from Documentation/technical into header	2017-06-30 13:11:59 -07:00
help.c	Merge branch 'mb/reword-autocomplete-message' into maint	2017-07-10 13:59:04 -07:00
help.h	…
hex.c	…
http-backend.c	pack: move {,re}prepare_packed_git and approximate_object_count	2017-08-23 15:12:07 -07:00
http-fetch.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
http-push.c	pack: move find_sha1_pack()	2017-08-23 15:12:07 -07:00
http-walker.c	pack: move find_sha1_pack()	2017-08-23 15:12:07 -07:00
http.c	Merge branch 'jt/packmigrate'	2017-08-26 22:55:09 -07:00
http.h	…
ident.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
imap-send.c	Merge branch 'rs/use-div-round-up'	2017-07-12 15:18:23 -07:00
iterator.h	…
khash.h	…
kwset.c	…
kwset.h	…
levenshtein.c	…
levenshtein.h	…
line-log.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
line-log.h	…
line-range.c	…
line-range.h	…
list-objects.c	…
list-objects.h	…
list.h	…
ll-merge.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
ll-merge.h	…
lockfile.c	…
lockfile.h	…
log-tree.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
log-tree.h	…
mailinfo.c	Spelling fixes	2017-06-27 10:35:49 -07:00
mailinfo.h	…
mailmap.c	Convert remaining callers of get_sha1 to get_oid.	2017-07-17 13:54:51 -07:00
mailmap.h	…
match-trees.c	…
merge-blobs.c	…
merge-blobs.h	…
merge-recursive.c	Merge branch 'sb/merge-recursive-code-cleanup'	2017-07-06 18:14:45 -07:00
merge-recursive.h	…
merge.c	…
mergesort.c	…
mergesort.h	…
mru.c	…
mru.h	…
name-hash.c	name-hash.c: drop hashmap_cmp_fn cast	2017-07-05 13:53:12 -07:00
notes-cache.c	…
notes-cache.h	…
notes-merge.c	sha1_file: convert index_path to struct object_id	2017-08-20 21:51:38 -07:00
notes-merge.h	notes-merge: convert notes_merge* to struct object_id	2017-06-05 11:23:58 +09:00
notes-utils.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
notes-utils.h	…
notes.c	tree-walk: convert fill_tree_descriptor() to object_id	2017-08-14 12:38:54 -07:00
notes.h	…
object.c	object: remove "used" field from struct object	2017-07-20 14:54:08 -07:00
object.h	object: remove "used" field from struct object	2017-07-20 14:54:08 -07:00
oidset.c	hashmap.h: compare function has access to a data field	2017-06-30 12:49:28 -07:00
oidset.h	…
pack-bitmap-write.c	…
pack-bitmap.c	pack: move open_pack_index(), parse_pack_index()	2017-08-23 15:12:06 -07:00
pack-bitmap.h	…
pack-check.c	pack: move open_pack_index(), parse_pack_index()	2017-08-23 15:12:06 -07:00
pack-objects.c	…
pack-objects.h	…
pack-revindex.c	…
pack-revindex.h	…
pack-write.c	…
pack.h	…
packfile.c	pack: move for_each_packed_object()	2017-08-23 15:12:07 -07:00
packfile.h	pack: move for_each_packed_object()	2017-08-23 15:12:07 -07:00
pager.c	Merge branch 'ma/parse-maybe-bool'	2017-08-22 10:29:03 -07:00
parse-options-cb.c	…
parse-options.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
parse-options.h	…
patch-delta.c	…
patch-ids.c	patch-ids.c: drop hashmap_cmp_fn cast	2017-07-05 13:53:12 -07:00
patch-ids.h	…
path.c	pack: move {,re}prepare_packed_git and approximate_object_count	2017-08-23 15:12:07 -07:00
path.h	path: add repo_worktree_path and strbuf_repo_worktree_path	2017-06-23 18:24:34 -07:00
pathspec.c	Spelling fixes	2017-06-27 10:35:49 -07:00
pathspec.h	…
pkt-line.c	sub-process: refactor handshake to common function	2017-07-26 13:00:40 -07:00
pkt-line.h	sub-process: refactor handshake to common function	2017-07-26 13:00:40 -07:00
preload-index.c	…
pretty.c	Merge branch 'jk/trailers-parse'	2017-08-26 22:55:04 -07:00
prio-queue.c	*.[ch] refactoring: make use of the FREE_AND_NULL() macro	2017-06-16 12:44:09 -07:00
prio-queue.h	…
progress.c	progress: simplify "delayed" progress API	2017-08-19 14:01:34 -07:00
progress.h	progress: simplify "delayed" progress API	2017-08-19 14:01:34 -07:00
prompt.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
prompt.h	…
quote.c	…
quote.h	…
reachable.c	pack: move for_each_packed_object()	2017-08-23 15:12:07 -07:00
reachable.h	…
read-cache.c	Merge branch 'kw/write-index-reduce-alloc'	2017-08-26 22:55:08 -07:00
ref-filter.c	ref-filter: consult want_color() before emitting colors	2017-07-13 12:42:51 -07:00
ref-filter.h	ref-filter: consult want_color() before emitting colors	2017-07-13 12:42:51 -07:00
reflog-walk.c	use MOVE_ARRAY	2017-07-17 14:54:56 -07:00
reflog-walk.h	reflog-walk: apply --since/--until to reflog dates	2017-07-09 10:00:48 -07:00
refs.c	ref_iterator: keep track of whether the iterator output is ordered	2017-09-14 15:19:07 +09:00
refs.h	Spelling fixes	2017-06-27 10:35:49 -07:00
remote-curl.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
remote-testsvn.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
remote.c	Merge branch 'sb/hashmap-cleanup'	2017-08-11 13:27:01 -07:00
remote.h	remote: convert struct push_cas to struct object_id	2017-07-17 13:54:38 -07:00
replace_object.c	…
repository.c	Merge branch 'bw/grep-recurse-submodules'	2017-08-22 10:29:01 -07:00
repository.h	repo_read_index: don't discard the index	2017-07-18 13:32:25 -07:00
rerere.c	rerere: allow approxidate in gc.rerereResolved/gc.rerereUnresolved	2017-08-22 14:51:02 -07:00
rerere.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	pack: move has_sha1_pack()	2017-08-23 15:12:07 -07:00
revision.h	revision: add rev_input_given flag	2017-08-02 15:45:20 -07:00
run-command.c	Merge branch 'js/run-process-parallel-api-fix' into maint	2017-08-23 14:33:49 -07:00
run-command.h	…
send-pack.c	Spelling fixes	2017-06-27 10:35:49 -07:00
send-pack.h	…
sequencer.c	Merge branch 'pw/sequence-rerere-autoupdate'	2017-08-22 10:29:00 -07:00
sequencer.h	…
server-info.c	pack: move {,re}prepare_packed_git and approximate_object_count	2017-08-23 15:12:07 -07:00
setup.c	grep: recurse in-process using 'struct repository'	2017-08-02 14:26:46 -07:00
sh-i18n--envsubst.c	…
sha1-array.c	coccinelle: make use of the "type" FREE_AND_NULL() rule	2017-06-16 12:44:03 -07:00
sha1-array.h	…
sha1-lookup.c	sha1_file: drop experimental GIT_USE_LOOKUP search	2017-08-09 11:03:35 -07:00
sha1-lookup.h	…
sha1_file.c	Merge branch 'jt/packmigrate'	2017-08-26 22:55:09 -07:00
sha1_name.c	pack: move open_pack_index(), parse_pack_index()	2017-08-23 15:12:06 -07:00
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	commit: convert lookup_commit_graft to struct object_id	2017-07-13 12:02:40 -07:00
shell.c	…
shortlog.h	…
show-index.c	…
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
split-index.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
split-index.h	Revert "split-index: add and use unshare_split_index()"	2017-06-24 12:02:39 -07:00
strbuf.c	Merge branch 'rs/strbuf-getwholeline-fix'	2017-08-22 10:29:15 -07:00
strbuf.h	strbuf: use designated initializers in STRBUF_INIT	2017-07-14 08:32:44 -07:00
streaming.c	pack: move use_pack()	2017-08-23 15:12:06 -07:00
streaming.h	…
string-list.c	use MOVE_ARRAY	2017-07-17 14:54:56 -07:00
string-list.h	…
sub-process.c	Merge branch 'cc/subprocess-handshake-missing-capabilities'	2017-08-24 10:20:02 -07:00
sub-process.h	Merge branch 'jt/subprocess-handshake'	2017-08-11 13:27:05 -07:00
submodule-config.c	Merge branch 'bw/submodule-config-cleanup'	2017-08-26 22:55:08 -07:00
submodule-config.h	Merge branch 'bw/grep-recurse-submodules'	2017-08-22 10:29:01 -07:00
submodule.c	Merge branch 'bw/submodule-config-cleanup'	2017-08-26 22:55:08 -07:00
submodule.h	Merge branch 'bw/submodule-config-cleanup'	2017-08-26 22:55:08 -07:00
symlinks.c	…
tag.c	tag: convert gpg_verify_tag to use struct object_id	2017-07-13 12:02:48 -07:00
tag.h	tag: convert gpg_verify_tag to use struct object_id	2017-07-13 12:02:48 -07:00
tar.h	…
tempfile.c	…
tempfile.h	…
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	…
tmp-objdir.h	…
trace.c	…
trace.h	…
trailer.c	Merge branch 'jk/trailers-parse'	2017-08-26 22:55:04 -07:00
trailer.h	Merge branch 'jk/trailers-parse'	2017-08-26 22:55:04 -07:00
transport-helper.c	sha1_name: convert get_sha1* to get_oid*	2017-07-17 13:54:51 -07:00
transport.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
transport.h	…
tree-diff.c	tree-walk: convert fill_tree_descriptor() to object_id	2017-08-14 12:38:54 -07:00
tree-walk.c	tree-walk: convert fill_tree_descriptor() to object_id	2017-08-14 12:38:54 -07:00
tree-walk.h	tree-walk: convert fill_tree_descriptor() to object_id	2017-08-14 12:38:54 -07:00
tree.c	Merge branch 'ab/free-and-null'	2017-06-24 14:28:41 -07:00
tree.h	tree: convert read_tree to take an index parameter	2017-06-13 11:40:51 -07:00
unicode_width.h	unicode: update the width tables to Unicode 10	2017-07-07 10:33:30 -07:00
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unpack-trees.c	Merge branch 'bw/submodule-config-cleanup'	2017-08-26 22:55:08 -07:00
unpack-trees.h	…
upload-pack.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
url.c	…
url.h	…
urlmatch.c	urlmatch: use hex2chr() in append_normalized_escapes()	2017-07-09 09:43:01 -07:00
urlmatch.h	…
usage.c	die(): stop hiding errors due to overzealous recursion guard	2017-06-21 14:09:13 -07:00
userdiff.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
userdiff.h	…
utf8.c	…
utf8.h	…
varint.c	…
varint.h	…
version.c	…
version.h	…
versioncmp.c	config: don't include config.h by default	2017-06-15 12:56:22 -07:00
walker.c	…
walker.h	…
wildmatch.c	wildmatch: remove unused wildopts parameter	2017-06-23 18:27:07 -07:00
wildmatch.h	wildmatch: remove unused wildopts parameter	2017-06-23 18:27:07 -07:00
worktree.c	path: convert strbuf_git_common_path to take a 'struct repository'	2017-06-23 18:24:34 -07:00
worktree.h	…
wrap-for-bin.sh	…
wrapper.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
write_or_die.c	…
ws.c	…
wt-status.c	Merge branch 'rs/wt-status-cleanup'	2017-07-12 15:18:23 -07:00
wt-status.h	Merge branch 'ks/status-initial-commit'	2017-06-30 13:45:22 -07:00
xdiff-interface.c	Merge branch 'bw/config-h'	2017-06-24 14:28:41 -07:00
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