Go to file

Nguyễn Thái Ngọc Duy 5a0b97b34c tree-walk: support :(attr) matching This lets us use :(attr) with "git grep <tree-ish>" or "git log". :(attr) requires another round of checking before we can declare that a path is matched. This is done after path matching since we have lots of optimization to take a shortcut when things don't match. Note that if :(attr) is present, we can't return all_entries_interesting / all_entries_not_interesting anymore because we can't be certain about that. Not until match_pathspec_attrs() can tell us "yes all these paths satisfy :(attr)". Second note. Even though we walk a specific tree, we use attributes from _worktree_ (or falling back to the index), not from .gitattributes files on that tree. This by itself is not necessarily wrong, but the user just have to be aware of this. Signed-off-by: Nguyễn Thái Ngọc Duy <pclouds@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2018-11-19 10:50:33 +09:00
.github	…
Documentation	tree-walk: support :(attr) matching	2018-11-19 10:50:33 +09:00
block-sha1	…
builtin	tree-walk.c: make tree_entry_interesting() take an index	2018-11-19 10:50:33 +09:00
ci	Merge branch 'sg/travis-install-dependencies'	2018-11-13 22:37:27 +09:00
compat	Merge branch 'js/mingw-msdn-url'	2018-11-18 18:23:58 +09:00
contrib	Merge branch 'nd/complete-format-patch'	2018-11-13 22:37:28 +09:00
ewah	ewok_rlw.h: add missing 'inline' to function definition	2018-10-29 10:14:19 +09:00
git-gui	…
gitk-git	…
gitweb	…
mergetools	…
negotiator	…
perl	…
po	…
ppc	…
refs	Merge branch 'nd/per-worktree-ref-iteration'	2018-11-13 22:37:26 +09:00
sha1collisiondetection@232357eb2e	…
sha1dc	…
t	tree-walk: support :(attr) matching	2018-11-19 10:50:33 +09:00
templates	…
vcs-svn	…
xdiff	xdiff: provide a separate emit callback for hunks	2018-11-02 20:43:02 +09:00
.clang-format	…
.editorconfig	…
.gitattributes	build: fix broken command-list.h generation with core.autocrlf	2018-11-12 16:39:17 +09:00
.gitignore	Merge branch 'ag/rebase-i-in-c'	2018-11-02 11:04:53 +09:00
.gitmodules	…
.mailmap	Update .mailmap	2018-11-12 12:52:23 +09:00
.travis.yml	travis-ci: install packages in 'ci/install-dependencies.sh'	2018-11-02 11:28:19 +09:00
.tsan-suppressions	…
COPYING	…
GIT-VERSION-GEN	Git 2.20-rc0	2018-11-18 18:24:49 +09:00
INSTALL	…
LGPL-2.1	…
Makefile	Merge branch 'js/fuzz-cxxflags'	2018-11-18 18:23:58 +09:00
README.md	…
RelNotes	…
abspath.c	…
aclocal.m4	…
advice.c	reset: warn when refresh_index() takes more than 2 seconds	2018-10-24 11:57:08 +09:00
advice.h	reset: warn when refresh_index() takes more than 2 seconds	2018-10-24 11:57:08 +09:00
alias.c	…
alias.h	…
alloc.c	…
alloc.h	…
apply.c	Merge branch 'js/apply-recount-allow-noop'	2018-11-18 18:23:56 +09:00
apply.h	…
archive-tar.c	…
archive-zip.c	…
archive.c	tree.c: make read_tree() take 'struct repository '	2018-11-19 10:50:33 +09:00
archive.h	archive: initialize archivers earlier	2018-10-26 10:17:59 +09:00
argv-array.c	…
argv-array.h	…
attr.c	attr.c: remove #ifdef NO_PTHREADS	2018-11-05 13:42:11 +09:00
attr.h	…
banned.h	…
base85.c	…
bisect.c	…
bisect.h	…
blame.c	…
blame.h	…
blob.c	…
blob.h	…
branch.c	…
branch.h	…
builtin.h	Merge branch 'ag/rebase-i-in-c'	2018-11-02 11:04:53 +09:00
bulk-checkin.c	…
bulk-checkin.h	…
bundle.c	Merge branch 'jk/close-duped-fd-before-unlock-for-bundle'	2018-11-18 18:23:59 +09:00
bundle.h	…
cache-tree.c	Merge branch 'jt/cache-tree-allow-missing-object-in-partial-clone'	2018-10-19 13:34:08 +09:00
cache-tree.h	…
cache.h	Merge branch 'bp/refresh-index-using-preload'	2018-11-13 22:37:26 +09:00
chdir-notify.c	…
chdir-notify.h	…
check-builtins.sh	…
check-racy.c	…
check_bindir	…
checkout.c	…
checkout.h	…
color.c	…
color.h	…
column.c	…
column.h	…
combine-diff.c	Merge branch 'jk/xdiff-interface'	2018-11-13 22:37:27 +09:00
command-list.txt	Merge branch 'du/cherry-is-plumbing'	2018-10-26 14:22:14 +09:00
commit-graph.c	Merge branch 'ds/commit-graph-leakfix'	2018-10-19 13:34:07 +09:00
commit-graph.h	…
commit-reach.c	commit-reach: implement get_reachable_subset	2018-11-03 00:12:06 +09:00
commit-reach.h	Merge branch 'ds/add-missing-tags'	2018-11-13 22:37:24 +09:00
commit-slab-decl.h	…
commit-slab-impl.h	commit-slabs: move MAYBE_UNUSED out	2018-10-24 14:52:50 +09:00
commit-slab.h	…
commit.c	Merge branch 'jk/verify-sig-merge-into-void'	2018-11-18 18:23:54 +09:00
commit.h	Merge branch 'jk/verify-sig-merge-into-void'	2018-11-18 18:23:54 +09:00
common-main.c	…
config.c	config: report a bug if git_dir exists without commondir	2018-11-16 11:54:01 +09:00
config.h	…
config.mak.dev	Merge branch 'jk/unused-function'	2018-10-30 15:43:46 +09:00
config.mak.in	…
config.mak.uname	Merge branch 'jk/curl-ldflags'	2018-11-18 18:23:53 +09:00
configure.ac	build: link with curl-defined linker flags	2018-11-05 10:19:25 +09:00
connect.c	…
connect.h	…
connected.c	…
connected.h	…
convert.c	…
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	approxidate: fix NULL dereference in date_time()	2018-11-07 11:04:06 +09:00
decorate.c	…
decorate.h	…
delta-islands.c	…
delta-islands.h	…
delta.h	…
detect-compiler	…
diff-delta.c	…
diff-lib.c	…
diff-no-index.c	…
diff.c	Merge branch 'jk/xdiff-interface'	2018-11-13 22:37:27 +09:00
diff.h	…
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	Merge branch 'jk/xdiff-interface'	2018-11-13 22:37:27 +09:00
diffcore-rename.c	…
diffcore.h	…
dir-iterator.c	…
dir-iterator.h	…
dir.c	dir.c: move, rename and export match_attrs()	2018-11-19 10:50:33 +09:00
dir.h	…
editor.c	…
entry.c	…
environment.c	Merge branch 'js/mingw-perl5lib'	2018-11-13 22:37:20 +09:00
exec-cmd.c	…
exec-cmd.h	…
fast-import.c	…
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-object.c	…
fetch-object.h	fetch-object.h: add missing declaration (hdr-check)	2018-10-29 10:14:17 +09:00
fetch-pack.c	fetch-pack: be more precise in parsing v2 response	2018-11-01 14:30:22 +09:00
fetch-pack.h	…
fmt-merge-msg.h	…
fsck.c	Merge branch 'jc/cocci-preincr'	2018-10-30 15:43:48 +09:00
fsck.h	…
fsmonitor.c	…
fsmonitor.h	…
fuzz-pack-headers.c	…
fuzz-pack-idx.c	…
generate-cmdlist.sh	Update makefile in preparation for Documentation/config/*.txt	2018-10-29 10:16:59 +09:00
gettext.c	…
gettext.h	…
git-add--interactive.perl	…
git-archimport.perl	…
git-bisect.sh	…
git-compat-util.h	config: allow for platform-specific core.* config settings	2018-10-31 12:46:21 +09:00
git-cvsexportcommit.perl	…
git-cvsimport.perl	…
git-cvsserver.perl	…
git-difftool--helper.sh	…
git-filter-branch.sh	…
git-instaweb.sh	…
git-legacy-rebase.sh	Merge branch 'ag/rebase-i-in-c'	2018-11-02 11:04:53 +09:00
git-merge-octopus.sh	…
git-merge-one-file.sh	…
git-merge-resolve.sh	…
git-mergetool--lib.sh	mergetool: accept -g/--[no-]gui as arguments	2018-10-25 14:01:10 +09:00
git-mergetool.sh	mergetool: accept -g/--[no-]gui as arguments	2018-10-25 14:01:10 +09:00
git-p4.py	…
git-parse-remote.sh	…
git-quiltimport.sh	…
git-rebase--am.sh	…
git-rebase--common.sh	…
git-rebase--merge.sh	…
git-rebase--preserve-merges.sh	Merge branch 'ag/rebase-i-in-c'	2018-11-02 11:04:53 +09:00
git-remote-testgit.sh	…
git-request-pull.sh	…
git-send-email.perl	Merge branch 'nd/complete-format-patch'	2018-11-13 22:37:28 +09:00
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-stash.sh	…
git-submodule.sh	Merge branch 'ao/submodule-wo-gitmodules-checked-out'	2018-11-13 22:37:22 +09:00
git-svn.perl	…
git-web--browse.sh	…
git.c	Merge branch 'ag/rebase-i-in-c'	2018-11-02 11:04:53 +09:00
git.rc	…
gpg-interface.c	Merge branch 'mg/gpg-fingerprint'	2018-11-03 00:53:58 +09:00
gpg-interface.h	gpg-interface.c: obtain primary key fingerprint as well	2018-10-23 08:00:43 +09:00
graph.c	Merge branch 'np/log-graph-octopus-fix'	2018-10-26 14:22:11 +09:00
graph.h	…
grep.c	grep: remove #ifdef NO_PTHREADS	2018-11-05 13:42:11 +09:00
grep.h	grep: remove #ifdef NO_PTHREADS	2018-11-05 13:42:11 +09:00
hash.h	…
hashmap.c	…
hashmap.h	…
help.c	…
help.h	…
hex.c	…
http-backend.c	…
http-fetch.c	…
http-push.c	…
http-walker.c	…
http.c	Merge branch 'jc/http-curlver-warnings'	2018-11-03 00:53:59 +09:00
http.h	…
ident.c	…
imap-send.c	…
interdiff.c	…
interdiff.h	…
iterator.h	…
json-writer.c	…
json-writer.h	…
khash.h	khash: silence -Wunused-function for delta-islands	2018-10-24 14:52:50 +09:00
kwset.c	…
kwset.h	…
levenshtein.c	…
levenshtein.h	…
line-log.c	…
line-log.h	…
line-range.c	…
line-range.h	…
linear-assignment.c	…
linear-assignment.h	…
list-objects-filter-options.c	…
list-objects-filter-options.h	…
list-objects-filter.c	…
list-objects-filter.h	Merge branch 'md/filter-trees'	2018-10-30 15:43:39 +09:00
list-objects.c	tree-walk.c: make tree_entry_interesting() take an index	2018-11-19 10:50:33 +09:00
list-objects.h	…
list.h	…
ll-merge.c	…
ll-merge.h	…
lockfile.c	…
lockfile.h	…
log-tree.c	…
log-tree.h	…
ls-refs.c	…
ls-refs.h	…
mailinfo.c	…
mailinfo.h	…
mailmap.c	…
mailmap.h	…
match-trees.c	…
mem-pool.c	…
mem-pool.h	…
merge-blobs.c	…
merge-blobs.h	…
merge-recursive.c	tree.c: make read_tree() take 'struct repository '	2018-11-19 10:50:33 +09:00
merge-recursive.h	…
merge.c	…
mergesort.c	…
mergesort.h	…
midx.c	Merge branch 'jk/unused-parameter-fixes'	2018-11-18 18:23:53 +09:00
midx.h	Merge branch 'ds/test-multi-pack-index'	2018-11-13 22:37:19 +09:00
name-hash.c	Clean up pthread_create() error handling	2018-11-05 13:42:11 +09:00
notes-cache.c	…
notes-cache.h	…
notes-merge.c	…
notes-merge.h	…
notes-utils.c	…
notes-utils.h	…
notes.c	…
notes.h	…
object-store.h	…
object.c	…
object.h	revision.c: generation-based topo-order algorithm	2018-11-02 12:14:22 +09:00
oidmap.c	…
oidmap.h	…
oidset.c	…
oidset.h	…
pack-bitmap-write.c	Merge branch 'bc/hash-transition-part-15'	2018-10-30 15:43:42 +09:00
pack-bitmap.c	…
pack-bitmap.h	…
pack-check.c	…
pack-objects.c	Merge branch 'js/pack-objects-mutex-init-fix'	2018-10-30 15:43:43 +09:00
pack-objects.h	Merge branch 'nd/pthreads'	2018-11-18 18:23:52 +09:00
pack-revindex.c	…
pack-revindex.h	…
pack-write.c	…
pack.h	…
packfile.c	Merge branch 'ds/test-multi-pack-index'	2018-11-13 22:37:19 +09:00
packfile.h	…
pager.c	…
parse-options-cb.c	assert NOARG/NONEG behavior of parse-options callbacks	2018-11-06 12:56:29 +09:00
parse-options.c	…
parse-options.h	assert NOARG/NONEG behavior of parse-options callbacks	2018-11-06 12:56:29 +09:00
patch-delta.c	…
patch-ids.c	…
patch-ids.h	…
path.c	Merge branch 'nd/per-worktree-ref-iteration'	2018-11-13 22:37:26 +09:00
path.h	…
pathspec.c	dir.c: move, rename and export match_attrs()	2018-11-19 10:50:33 +09:00
pathspec.h	dir.c: move, rename and export match_attrs()	2018-11-19 10:50:33 +09:00
pkt-line.c	…
pkt-line.h	…
preload-index.c	Merge branch 'nd/pthreads'	2018-11-18 18:23:52 +09:00
pretty.c	Merge branch 'mg/gpg-fingerprint'	2018-11-03 00:53:58 +09:00
pretty.h	…
prio-queue.c	prio-queue: add 'peek' operation	2018-11-02 12:14:21 +09:00
prio-queue.h	prio-queue: add 'peek' operation	2018-11-02 12:14:21 +09:00
progress.c	…
progress.h	…
prompt.c	…
prompt.h	…
protocol.c	…
protocol.h	…
quote.c	…
quote.h	…
range-diff.c	Merge branch 'ab/range-diff-no-patch'	2018-11-18 18:23:54 +09:00
range-diff.h	…
reachable.c	…
reachable.h	…
read-cache.c	Merge branch 'nd/pthreads'	2018-11-18 18:23:52 +09:00
rebase-interactive.c	…
rebase-interactive.h	…
ref-filter.c	Merge branch 'sg/ref-filter-wo-repository'	2018-11-18 18:23:59 +09:00
ref-filter.h	…
reflog-walk.c	…
reflog-walk.h	…
refs.c	Merge branch 'ra/rev-parse-exclude-glob'	2018-11-18 18:23:56 +09:00
refs.h	Merge branch 'nd/per-worktree-ref-iteration'	2018-11-13 22:37:26 +09:00
refspec.c	…
refspec.h	…
remote-curl.c	…
remote-testsvn.c	…
remote.c	remote: make add_missing_tags() linear	2018-11-03 00:12:06 +09:00
remote.h	…
replace-object.c	…
replace-object.h	…
repository.c	…
repository.h	…
rerere.c	Merge branch 'bc/hash-transition-part-15'	2018-10-30 15:43:42 +09:00
rerere.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	tree-walk.c: make tree_entry_interesting() take an index	2018-11-19 10:50:33 +09:00
revision.h	Merge branch 'ds/reachable-topo-order'	2018-11-18 18:23:52 +09:00
run-command.c	Merge branch 'nd/pthreads'	2018-11-18 18:23:52 +09:00
run-command.h	send-pack.c: move async's #ifdef NO_PTHREADS back to run-command.c	2018-11-05 13:42:11 +09:00
send-pack.c	send-pack.c: move async's #ifdef NO_PTHREADS back to run-command.c	2018-11-05 13:42:11 +09:00
send-pack.h	…
sequencer.c	Merge branch 'js/rebase-r-and-merge-head'	2018-11-18 18:23:56 +09:00
sequencer.h	Merge branch 'pw/am-rebase-read-author-script'	2018-11-13 22:37:23 +09:00
serve.c	…
serve.h	…
server-info.c	…
setup.c	worktree: add per-worktree config files	2018-10-22 13:17:04 +09:00
sh-i18n--envsubst.c	…
sha1-array.c	…
sha1-array.h	…
sha1-file.c	Merge branch 'jk/detect-truncated-zlib-input'	2018-11-13 22:37:17 +09:00
sha1-lookup.c	…
sha1-lookup.h	…
sha1-name.c	…
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	Merge branch 'js/shallow-and-fetch-prune'	2018-11-06 15:50:18 +09:00
shell.c	…
shortlog.h	…
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
split-index.c	…
split-index.h	…
strbuf.c	Merge branch 'pk/rebase-in-c-3-acts'	2018-11-02 11:04:54 +09:00
strbuf.h	Merge branch 'pk/rebase-in-c-3-acts'	2018-11-02 11:04:54 +09:00
streaming.c	read_istream_pack_non_delta(): document input handling	2018-10-31 14:32:30 +09:00
streaming.h	…
string-list.c	…
string-list.h	…
sub-process.c	…
sub-process.h	…
submodule-config.c	Merge branch 'ao/submodule-wo-gitmodules-checked-out'	2018-11-13 22:37:22 +09:00
submodule-config.h	…
submodule.c	Merge branch 'ao/submodule-wo-gitmodules-checked-out'	2018-11-13 22:37:22 +09:00
submodule.h	Merge branch 'ao/submodule-wo-gitmodules-checked-out'	2018-11-13 22:37:22 +09:00
symlinks.c	…
tag.c	…
tag.h	…
tar.h	…
tempfile.c	…
tempfile.h	…
thread-utils.c	thread-utils: macros to unconditionally compile pthreads API	2018-10-29 11:22:48 +09:00
thread-utils.h	thread-utils: macros to unconditionally compile pthreads API	2018-10-29 11:22:48 +09:00
tmp-objdir.c	…
tmp-objdir.h	…
trace.c	…
trace.h	…
trailer.c	…
trailer.h	…
transport-helper.c	…
transport-internal.h	…
transport.c	Merge branch 'nd/submodule-unused-vars'	2018-11-06 15:50:20 +09:00
transport.h	…
tree-diff.c	tree-walk.c: make tree_entry_interesting() take an index	2018-11-19 10:50:33 +09:00
tree-walk.c	tree-walk: support :(attr) matching	2018-11-19 10:50:33 +09:00
tree-walk.h	tree-walk.c: make tree_entry_interesting() take an index	2018-11-19 10:50:33 +09:00
tree.c	tree-walk.c: make tree_entry_interesting() take an index	2018-11-19 10:50:33 +09:00
tree.h	tree.c: make read_tree() take 'struct repository '	2018-11-19 10:50:33 +09:00
unicode-width.h	…
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unpack-trees.c	tree-walk.c: make tree_entry_interesting() take an index	2018-11-19 10:50:33 +09:00
unpack-trees.h	…
upload-pack.c	Merge branch 'jt/upload-pack-v2-fix-shallow'	2018-11-06 15:50:19 +09:00
upload-pack.h	…
url.c	…
url.h	…
urlmatch.c	…
urlmatch.h	…
usage.c	…
userdiff.c	…
userdiff.h	…
utf8.c	…
utf8.h	…
varint.c	…
varint.h	…
version.c	…
version.h	…
versioncmp.c	…
walker.c	…
walker.h	…
wildmatch.c	wildmatch: change behavior of "foo**bar" in WM_PATHNAME mode	2018-10-29 13:19:22 +09:00
wildmatch.h	wildmatch: change behavior of "foo**bar" in WM_PATHNAME mode	2018-10-29 13:19:22 +09:00
worktree.c	Merge branch 'nd/per-worktree-ref-iteration'	2018-11-13 22:37:26 +09:00
worktree.h	Merge branch 'nd/per-worktree-ref-iteration'	2018-11-13 22:37:26 +09:00
wrap-for-bin.sh	…
wrapper.c	…
write-or-die.c	…
ws.c	…
wt-status.c	status: rebase and merge can be in progress at the same time	2018-11-13 12:04:00 +09:00
wt-status.h	…
xdiff-interface.c	Merge branch 'jk/xdiff-interface'	2018-11-13 22:37:27 +09:00
xdiff-interface.h	xdiff-interface: drop parse_hunk_header()	2018-11-05 13:14:35 +09:00
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.

Issues which are security relevant should be disclosed privately to the Git Security mailing list git-security@googlegroups.com.

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