Go to file

Michael Haggerty df30875987 ref-cache: use a callback function to fill the cache It is a leveling violation for `ref_cache` to know about `files_ref_store` or that it should call `read_loose_refs()` to lazily fill cache directories. So instead, have its constructor take as an argument a callback function that it should use for lazy-filling, and change `files_ref_store` to supply a pointer to function `read_loose_refs` (renamed to `loose_fill_ref_dir`) when creating the ref cache for its loose refs. This means that we can generify the type of the back-pointer in `struct ref_cache` from `files_ref_store` to `ref_store`. Signed-off-by: Michael Haggerty <mhagger@alum.mit.edu> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2017-04-16 21:32:46 -07:00
Documentation	Fifth batch for 2.13	2017-03-17 13:51:58 -07:00
block-sha1	…
builtin	refs: delete pack_refs() in favor of refs_pack_refs()	2017-04-14 03:53:25 -07:00
ci	Travis: also test on 32-bit Linux	2017-03-06 11:19:09 -08:00
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	…
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	ref-cache: use a callback function to fill the cache	2017-04-16 21:32:46 -07:00
t	refs.h: add a note about sorting order of for_each_ref_*	2017-04-14 03:53:25 -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: also test on 32-bit Linux	2017-03-06 11:19:09 -08:00
COPYING	…
GIT-VERSION-GEN	Preparing for 2.12.1	2017-03-16 14:01:20 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	refs: split `ref_cache` code into separate files	2017-04-16 21:32:45 -07:00
README.md	README: create HTTP/HTTPS links from URLs in Markdown	2017-03-01 14:45:45 -08:00
RelNotes	Preparing for 2.12.1	2017-03-16 14:01:20 -07: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.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	pathspec: allow querying for attributes	2017-03-13 15:28:54 -07:00
attr.h	pathspec: allow querying for attributes	2017-03-13 15:28:54 -07:00
base85.c	…
bisect.c	Merge branch 'mm/two-more-xstrfmt' into maint	2017-03-16 13:56:43 -07: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 'js/early-config'	2017-03-17 13:50:28 -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	…
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 'js/early-config'	2017-03-17 13:50:28 -07:00
config.mak.in	…
config.mak.uname	Merge branch 'jh/mingw-openssl-sha1' into maint	2017-03-16 13:56:41 -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.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	Merge branch 'bw/attr-pathspec'	2017-03-17 13:50:26 -07: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	Merge branch 'mm/fetch-show-error-message-on-unadvertised-object'	2017-03-14 15:23:18 -07:00
fetch-pack.h	fetch-pack: move code to report unmatched refs to a function	2017-03-02 11:12:53 -08:00
fmt-merge-msg.h	…
fsck.c	…
fsck.h	…
generate-cmdlist.sh	…
gettext.c	…
gettext.h	…
git-add--interactive.perl	Merge branch 'jk/add-i-use-pathspecs'	2017-03-17 13:50:26 -07: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	filter-branch: fix --prune-empty on parentless commits	2017-03-03 12:43:37 -08:00
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	…
graph.c	Merge branch 'rs/swap'	2017-02-15 12:54:19 -08:00
graph.h	…
grep.c	…
grep.h	…
hash.h	hash.h: move SHA-1 implementation selection into a header file	2017-03-15 11:00:09 -07:00
hashmap.c	…
hashmap.h	…
help.c	…
help.h	…
hex.c	hex: introduce parse_oid_hex	2017-02-20 01:11:26 -08:00
http-backend.c	…
http-fetch.c	…
http-push.c	…
http-walker.c	Merge branch 'jk/http-walker-buffer-underflow-fix'	2017-03-17 13:50:26 -07:00
http.c	Merge branch 'jt/http-base-url-update-upon-redirect' into maint	2017-03-16 13:56:42 -07: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' into maint	2017-03-16 13:56:42 -07:00
line-log.h	…
line-range.c	…
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	…
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-revindex.c	…
pack-revindex.h	…
pack-write.c	…
pack.h	…
pager.c	setup: make read_early_config() reusable	2017-03-14 14:24:16 -07:00
parse-options-cb.c	…
parse-options.c	…
parse-options.h	…
patch-delta.c	…
patch-ids.c	…
patch-ids.h	…
path.c	path.c: move some code out of strbuf_git_path_submodule()	2017-03-27 10:23:40 -07:00
pathspec.c	pathspec: allow escaped query values	2017-03-13 15:28:56 -07:00
pathspec.h	pathspec: allow querying for attributes	2017-03-13 15:28:54 -07:00
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	…
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	Convert object iteration callbacks to struct object_id	2017-02-22 10:12:15 -08:00
reachable.h	…
read-cache.c	Merge branch 'cc/split-index-config'	2017-03-17 13:50:23 -07:00
ref-filter.c	Merge branch 'jk/ref-filter-flags-cleanup'	2017-03-17 13:50:25 -07:00
ref-filter.h	ref-filter: move ref_cbdata definition into ref-filter.c	2017-03-10 11:51:30 -08:00
reflog-walk.c	refs: convert each_reflog_ent_fn to struct object_id	2017-02-22 10:12:15 -08:00
reflog-walk.h	…
refs.c	refs_verify_refname_available(): implement once for all backends	2017-04-16 21:32:45 -07:00
refs.h	refs_verify_refname_available(): implement once for all backends	2017-04-16 21:32:45 -07: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	Merge branch 'mm/fetch-show-error-message-on-unadvertised-object'	2017-03-14 15:23:18 -07:00
replace_object.c	…
rerere.c	…
rerere.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	Merge branch 'bc/object-id'	2017-03-17 13:50:25 -07: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: report signal death of pack-objects	2017-03-07 14:58:36 -08:00
send-pack.h	…
sequencer.c	…
sequencer.h	…
server-info.c	…
setup.c	Merge branch 'js/early-config'	2017-03-17 13:50:28 -07:00
sh-i18n--envsubst.c	…
sha1-array.c	…
sha1-array.h	…
sha1-lookup.c	…
sha1-lookup.h	…
sha1_file.c	Merge branch 'bc/object-id'	2017-03-17 13:50:25 -07:00
sha1_name.c	Merge branch 'bc/object-id'	2017-03-17 13:50:25 -07:00
shallow.c	…
shell.c	…
shortlog.h	…
show-index.c	…
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
split-index.c	split-index: add {add,remove}_split_index() functions	2017-03-01 13:24:21 -08:00
split-index.h	split-index: add {add,remove}_split_index() functions	2017-03-01 13:24:21 -08:00
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.h	…
submodule-config.c	Merge branch 'bw/push-submodule-only'	2017-01-31 13:14:56 -08:00
submodule-config.h	…
submodule.c	path.c: move some code out of strbuf_git_path_submodule()	2017-03-27 10:23:40 -07:00
submodule.h	path.c: move some code out of strbuf_git_path_submodule()	2017-03-27 10:23:40 -07:00
symlinks.c	…
tag.c	…
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 'bc/object-id'	2017-03-17 13:50:25 -07: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 'mg/status-porcelain-no-i18n'	2017-03-17 13:50:27 -07: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