Go to file

Eric Sunshine 73c768dae9 chainlint: annotate original test definition rather than token stream When chainlint detects problems in a test, such as a broken &&-chain, it prints out the test with "?!FOO?!" annotations inserted at each problem location. However, rather than annotating the original test definition, it instead dumps out a parsed token representation of the test. Since it lacks comments, indentations, here-doc bodies, and so forth, this tokenized representation can be difficult for the test author to digest and relate back to the original test definition. However, now that each parsed token carries positional information, the location of a detected problem can be pinpointed precisely in the original test definition. Therefore, take advantage of this information to annotate the test definition itself rather than annotating the parsed token stream, thus making it easier for a test author to relate a problem back to the source. Maintaining the positional meta-information associated with each detected problem requires a slight change in how the problems are managed internally. In particular, shell syntax such as: msg="total: $(cd data; wc -w .txt) words" requires the lexical analyzer to recursively invoke the parser in order to detect problems within the $(...) expression inside the double-quoted string. In this case, the recursive parse context will detect the broken &&-chain between the `cd` and `wc` commands, returning the token stream: cd data ; ?!AMP?! wc -w .txt However, the parent parse context will see everything inside the double-quotes as a single string token: "total: $(cd data ; ?!AMP?! wc -w .txt) words" losing whatever positional information was attached to the ";" token where the problem was detected. One way to preserve the positional information of a detected problem in a recursive parse context within a string would be to attach the positional information to the annotation textually; for instance: "total: $(cd data ; ?!AMP:21:22?! wc -w .txt) words" and then extract the positional information when annotating the original test definition. However, a cleaner and much simpler approach is to maintain the list of detected problems separately rather than embedding the problems as annotations directly in the parsed token stream. Not only does this ensure that positional information within recursive parse contexts is not lost, but it keeps the token stream free from non-token pollution, which may simplify implementation of validations added in the future since they won't have to handle non-token "?!FOO!?" items specially. Finally, the chainlint self-test "expect" files need a few mechanical adjustments now that the original test definitions are emitted rather than the parsed token stream. In particular, the following items missing from the historic parsed-token output are now preserved verbatim: * indentation (and whitespace, in general) * comments * here-doc bodies * here-doc tag quoting (i.e. "\EOF") * line-splices (i.e. "\" at the end of a line) Signed-off-by: Eric Sunshine <sunshine@sunshineco.com> Signed-off-by: Taylor Blau <me@ttaylorr.com>		2022-11-08 15:10:49 -05:00
.github	ci: add address and undefined sanitizer tasks	2022-10-20 09:20:59 -07:00
Documentation	The tenth batch	2022-11-03 20:41:55 -04:00
block-sha1	Makefile + hash.h: remove PPC_SHA1 implementation	2022-08-31 14:37:31 -07:00
builtin	Merge branch 'en/merge-tree-sequence'	2022-10-30 21:04:44 -04:00
ci	Merge branch 'jc/more-sanitizer-at-ci'	2022-10-25 17:11:44 -07:00
compat	Merge branch 'jk/unused-anno-more'	2022-10-27 14:51:52 -07:00
contrib	Merge branch 'pb/subtree-split-and-merge-after-squashing-tag-fix'	2022-10-30 21:04:43 -04:00
ewah	Merge branch 'ep/maint-equals-null-cocci'	2022-05-20 15:26:59 -07:00
git-gui	…
gitk-git	Merge branch 'master' of git://git.ozlabs.org/~paulus/gitk	2022-05-11 08:25:02 -07:00
gitweb	Merge branch 'jr/gitweb-title-shortening'	2022-08-05 15:52:14 -07:00
mergetools	mergetools: vimdiff: simplify tabfirst	2022-08-10 12:39:39 -07:00
negotiator	negotiator/skipping: avoid stack overflow	2022-10-25 17:14:40 -07:00
oss-fuzz	Merge branch 'ac/fuzzers'	2022-10-07 17:19:59 -07:00
perl	Git.pm: trust rev-parse to find bare repositories	2022-10-22 16:39:48 -07:00
po	l10n: zh_TW.po: Git 2.38.0, round 3	2022-10-01 19:10:41 +08:00
refs	refs: unify parse_worktree_ref() and ref_type()	2022-09-19 11:11:11 -07:00
reftable	reftable: use a pointer for pq_entry param	2022-09-15 11:32:37 -07:00
sha1collisiondetection@855827c583	…
sha1dc	…
sha256	sha256: add support for Nettle	2022-07-10 14:43:34 -07:00
t	chainlint: annotate original test definition rather than token stream	2022-11-08 15:10:49 -05:00
templates	fsmonitor: query watchman with right valid json	2022-06-07 10:00:49 -07:00
trace2	trace2: add global counter mechanism	2022-10-24 12:45:26 -07:00
xdiff	xdiff: drop unused mmfile parameters from xdl_do_patience_diff()	2022-08-20 14:14:55 -07:00
.cirrus.yml	ci: update Cirrus-CI image to FreeBSD 12.3	2022-05-25 08:47:11 -07:00
.clang-format	…
.editorconfig	…
.gitattributes	…
.gitignore	Merge branch 'js/cmake-updates'	2022-10-27 14:51:53 -07:00
.gitmodules	…
.mailmap	…
.tsan-suppressions	…
CODE_OF_CONDUCT.md	…
COPYING	…
GIT-VERSION-GEN	Start 2.39 cycle	2022-10-07 17:19:59 -07:00
INSTALL	Makefile + hash.h: remove PPC_SHA1 implementation	2022-08-31 14:37:31 -07:00
LGPL-2.1	…
Makefile	Merge branch 'ds/bundle-uri-3'	2022-10-30 21:04:44 -04:00
README.md	…
RelNotes	Downmerge a handful of topics for 2.38.2	2022-10-25 17:11:39 -07:00
SECURITY.md	…
abspath.c	…
aclocal.m4	…
add-interactive.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
add-interactive.h	…
add-patch.c	add -p: avoid ambiguous signed/unsigned comparison	2022-10-19 11:55:28 -07:00
advice.c	advice.h: add advise_on_moving_dirty_path()	2022-08-10 13:57:50 -07:00
advice.h	advice.h: add advise_on_moving_dirty_path()	2022-08-10 13:57:50 -07:00
alias.c	alias.c: reject too-long cmdline strings in split_cmdline()	2022-10-01 00:23:38 -04:00
alias.h	…
alloc.c	…
alloc.h	…
apply.c	Merge branch 'tb/cap-patch-at-1gb'	2022-10-30 21:04:43 -04:00
apply.h	…
archive-tar.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
archive-zip.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
archive.c	Merge branch 'rs/archive-dedup-printf' into maint-2.38	2022-10-27 15:24:14 -07:00
archive.h	archive: rename archiver data field to filter_command	2022-06-15 13:19:46 -07:00
attr.c	attr: drop DEBUG_ATTR code	2022-10-06 09:59:17 -07:00
attr.h	…
banned.h	…
base85.c	…
bisect.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
bisect.h	bisect: output state before we are ready to compute bisection	2022-05-11 12:35:11 -07:00
blame.c	Merge branch 'rs/mergesort'	2022-08-03 13:36:09 -07:00
blame.h	…
blob.c	…
blob.h	…
bloom.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
bloom.h	…
branch.c	branch: consider refs under 'update-refs'	2022-07-19 12:49:03 -07:00
branch.h	Merge branch 'ds/branch-checked-out' into ds/rebase-update-ref	2022-07-12 08:38:42 -07:00
builtin.h	builtin/diagnose.c: create 'git diagnose' builtin	2022-08-12 13:20:02 -07:00
bulk-checkin.c	t5351: avoid relying on `core.fsyncMethod = batch` to be supported	2022-07-29 09:08:57 -07:00
bulk-checkin.h	…
bundle-uri.c	bundle-uri: suppress stderr from remote-https	2022-10-12 09:13:25 -07:00
bundle-uri.h	bundle-uri: fetch a list of bundles	2022-10-12 09:13:25 -07:00
bundle.c	bundle-uri: quiet failed unbundlings	2022-10-12 09:13:25 -07:00
bundle.h	Merge branch 'ds/bundle-uri-3'	2022-10-30 21:04:44 -04:00
cache-tree.c	verify_one_sparse(): drop unused parameters	2022-08-20 14:14:17 -07:00
cache-tree.h	cache-tree: remove cache_tree_find_path()	2022-06-16 11:59:56 -07:00
cache.h	Merge branch 'ds/decorate-filter-tweak'	2022-08-29 14:55:11 -07:00
cbtree.c	…
cbtree.h	…
chdir-notify.c	…
chdir-notify.h	…
check-builtins.sh	…
checkout.c	…
checkout.h	…
chunk-format.c	chunk-format.h: extract oid_version()	2022-05-26 15:48:26 -07:00
chunk-format.h	chunk-format.h: extract oid_version()	2022-05-26 15:48:26 -07:00
color.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
color.h	…
column.c	…
column.h	…
combine-diff.c	Merge branch 'rs/combine-diff-with-incompatible-options' into maint	2022-07-27 13:00:32 -07:00
command-list.txt	version: fix builtin linking & documentation	2022-09-19 17:28:25 -07:00
commit-graph.c	Merge branch 'ml/commit-graph-expire-dir-leak-fix'	2022-09-21 14:23:14 -07:00
commit-graph.h	Merge branch 'tb/commit-graph-genv2-upgrade-fix'	2022-08-03 13:36:08 -07:00
commit-reach.c	…
commit-reach.h	…
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	Merge branch 'pw/rebase-keep-base-fixes'	2022-10-30 21:04:42 -04:00
commit.h	rebase: be stricter when reading state files containing oids	2022-10-17 11:53:00 -07:00
common-main.c	grep: fix multibyte regex handling under macOS	2022-08-26 11:45:52 -07:00
config.c	Merge branch 'ds/bundle-uri-3'	2022-10-30 21:04:44 -04:00
config.h	bundle-uri: create base key-value pair parsing	2022-10-12 09:13:24 -07:00
config.mak.dev	config.mak.dev: disable suggest braces error on old clang versions	2022-10-10 11:15:31 -07:00
config.mak.in	…
config.mak.uname	mingw: remove unneeded `NO_CURL` directive	2022-07-29 09:48:17 -07:00
configure.ac	Makefile + hash.h: remove PPC_SHA1 implementation	2022-08-31 14:37:31 -07:00
connect.c	Merge branch 'ab/env-array'	2022-06-10 15:04:13 -07:00
connect.h	…
connected.c	run-command API: rename "env_array" to "env"	2022-06-02 14:31:16 -07:00
connected.h	…
convert.c	convert: mark unused parameter in null stream filter	2022-10-17 21:24:04 -07:00
convert.h	checkout: fix two bugs on the final count of updated entries	2022-07-14 10:19:28 -07:00
copy.c	…
credential.c	…
credential.h	…
csum-file.c	…
csum-file.h	…
ctype.c	…
daemon.c	daemon: clarify directory arguments	2022-07-19 12:45:31 -07:00
date.c	date: mark unused parameters in handler functions	2022-10-17 21:24:04 -07:00
date.h	…
decorate.c	…
decorate.h	…
delta-islands.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
delta-islands.h	…
delta.h	…
detect-compiler	detect-compiler: make detection independent of locale	2022-05-09 08:52:26 -07:00
diagnose.c	diagnose.c: refactor to safely use 'd_type'	2022-09-19 10:25:01 -07:00
diagnose.h	builtin/diagnose.c: add '--mode' option	2022-08-12 13:20:02 -07:00
diff-delta.c	…
diff-lib.c	oneway_diff: handle removed sparse directories	2022-08-08 13:21:49 -07:00
diff-merges.c	diff-merges: cleanup set_diff_merges()	2022-09-16 09:21:43 -07:00
diff-merges.h	…
diff-no-index.c	diff-no-index: simplify argv index calculation	2022-09-07 12:36:43 -07:00
diff.c	Merge branch 'jz/patch-id'	2022-10-30 21:04:41 -04:00
diff.h	patch-id: use stable patch-id for rebases	2022-10-24 15:44:19 -07:00
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	diffcore-pickaxe: mark unused parameters in pickaxe functions	2022-10-17 21:24:04 -07:00
diffcore-rename.c	…
diffcore-rotate.c	…
diffcore.h	…
dir-iterator.c	…
dir-iterator.h	…
dir.c	Merge branch 'rs/use-fspathncmp' into maint-2.38	2022-10-27 15:24:13 -07:00
dir.h	match_pathname(): drop unused "flags" parameter	2022-08-19 12:20:56 -07:00
editor.c	run-command API: rename "env_array" to "env"	2022-06-02 14:31:16 -07:00
entry.c	checkout: fix two bugs on the final count of updated entries	2022-07-14 10:19:28 -07:00
entry.h	checkout: fix two bugs on the final count of updated entries	2022-07-14 10:19:28 -07:00
environment.c	Merge branch 'ab/unused-annotation'	2022-09-14 12:56:39 -07:00
environment.h	…
exec-cmd.c	mark unused parameters in trivial compat functions	2022-10-17 21:24:03 -07:00
exec-cmd.h	…
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-pack.c	Merge branch 'ab/unused-annotation'	2022-09-14 12:56:39 -07:00
fetch-pack.h	…
fmt-merge-msg.c	…
fmt-merge-msg.h	…
fsck.c	fsck: actually detect bad file modes in trees	2022-08-10 14:26:27 -07:00
fsck.h	fsck: document msg-id	2022-10-25 15:44:18 -07:00
fsmonitor--daemon.h	fsmonitor: deal with synthetic firmlinks on macOS	2022-10-05 11:05:23 -07:00
fsmonitor-ipc.c	fsmonitor: relocate socket file if .git directory is remote	2022-10-05 11:05:22 -07:00
fsmonitor-ipc.h	fsmonitor: relocate socket file if .git directory is remote	2022-10-05 11:05:22 -07:00
fsmonitor-path-utils.h	fsmonitor: deal with synthetic firmlinks on macOS	2022-10-05 11:05:23 -07:00
fsmonitor-settings.c	fsmonitor: check for compatability before communicating with fsmonitor	2022-10-05 11:05:23 -07:00
fsmonitor-settings.h	fsmonitor: check for compatability before communicating with fsmonitor	2022-10-05 11:05:23 -07:00
fsmonitor.c	fsmonitor: fix leak of warning message	2022-10-10 22:16:56 -07:00
fsmonitor.h	fsmonitor: never set CE_FSMONITOR_VALID on submodules	2022-05-26 15:59:27 -07:00
generate-cmdlist.sh	…
generate-configlist.sh	…
generate-hooklist.sh	…
gettext.c	grep: fix multibyte regex handling under macOS	2022-08-26 11:45:52 -07:00
gettext.h	…
git-add--interactive.perl	…
git-archimport.perl	…
git-bisect.sh	…
git-compat-util.h	Merge branch 'ab/unused-annotation' into maint-2.38	2022-10-27 15:24:12 -07:00
git-curl-compat.h	…
git-cvsexportcommit.perl	…
git-cvsimport.perl	…
git-cvsserver.perl	git-cvsserver: clarify directory list	2022-07-19 12:45:31 -07:00
git-difftool--helper.sh	…
git-filter-branch.sh	…
git-instaweb.sh	git-sh-setup.sh: remove "say" function, change last users	2022-06-28 13:13:18 -07:00
git-merge-octopus.sh	…
git-merge-one-file.sh	…
git-merge-resolve.sh	merge-resolve: abort if index does not match HEAD	2022-07-22 21:45:22 -07:00
git-mergetool--lib.sh	…
git-mergetool.sh	…
git-p4.py	Merge branch 'kk/p4-client-name-encoding-fix' into maint	2022-08-10 21:52:33 -07:00
git-quiltimport.sh	…
git-request-pull.sh	…
git-send-email.perl	…
git-sh-i18n.sh	…
git-sh-setup.sh	git-sh-setup.sh: remove "say" function, change last users	2022-06-28 13:13:18 -07:00
git-submodule.sh	git-submodule.sh: use "$quiet", not "$GIT_QUIET"	2022-06-28 13:13:18 -07:00
git-svn.perl	…
git-web--browse.sh	…
git.c	Merge branch 'ds/cmd-main-reorder'	2022-10-21 11:37:29 -07:00
git.rc	…
gpg-interface.c	Merge branch 'pw/ssh-sign-report-errors' into maint-2.38	2022-10-25 17:11:35 -07:00
gpg-interface.h	gpg-interface: add function for converting trust level to string	2022-07-10 22:10:23 -07:00
graph.c	…
graph.h	…
grep.c	Merge branch 'ab/grep-simplify-extended-expression'	2022-10-21 11:37:28 -07:00
grep.h	Merge branch 'ab/grep-simplify-extended-expression'	2022-10-21 11:37:28 -07:00
hash-lookup.c	…
hash-lookup.h	…
hash.h	Makefile + hash.h: remove PPC_SHA1 implementation	2022-08-31 14:37:31 -07:00
hashmap.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
hashmap.h	…
help.c	Merge branch 'ab/doc-synopsis-and-cmd-usage'	2022-10-28 11:26:54 -07:00
help.h	git docs: add a category for file formats, protocols and interfaces	2022-08-04 14:12:23 -07:00
hex.c	…
hook.c	run-command API: have run_process_parallel() take an "opts" struct	2022-10-12 14:12:41 -07:00
hook.h	…
http-backend.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
http-fetch.c	Merge branch 'ep/maint-equals-null-cocci' for maint-2.35	2022-05-02 10:06:04 -07:00
http-push.c	Merge branch 'ab/plug-leak-in-revisions'	2022-06-07 14:10:56 -07:00
http-walker.c	tree-wide: apply equals-null.cocci	2022-05-02 09:50:37 -07:00
http.c	Merge branch 'll/curl-accept-language'	2022-07-19 16:40:19 -07:00
http.h	remote-curl: send Accept-Language header to server	2022-07-11 12:24:28 -07:00
ident.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
imap-send.c	…
iterator.h	…
json-writer.c	…
json-writer.h	…
khash.h	…
kwset.c	tree-wide: apply equals-null.cocci	2022-05-02 09:50:37 -07:00
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: initialize sub-filter structs	2022-09-22 12:43:04 -07:00
list-objects-filter-options.h	list-objects-filter: convert filter_spec to a strbuf	2022-09-12 08:38:59 -07:00
list-objects-filter.c	…
list-objects-filter.h	…
list-objects.c	…
list-objects.h	…
list.h	…
ll-merge.c	ll-merge: mark unused parameters in callbacks	2022-10-17 21:24:04 -07:00
ll-merge.h	…
lockfile.c	…
lockfile.h	…
log-tree.c	Merge branch 'ab/unused-annotation'	2022-09-14 12:56:39 -07:00
log-tree.h	…
ls-refs.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
ls-refs.h	…
mailinfo.c	mailinfo -b: fix an out of bounds access	2022-10-03 09:05:07 -07:00
mailinfo.h	…
mailmap.c	Merge branch 'ep/maint-equals-null-cocci'	2022-05-20 15:26:59 -07:00
mailmap.h	…
match-trees.c	…
mem-pool.c	…
mem-pool.h	…
merge-blobs.c	…
merge-blobs.h	…
merge-ort-wrappers.c	merge-ort-wrappers: make printed message match the one from recursive	2022-07-22 21:45:22 -07:00
merge-ort-wrappers.h	…
merge-ort.c	Merge branch 'en/ort-dir-rename-and-symlink-fix'	2022-10-30 21:04:43 -04:00
merge-ort.h	merge-ort: optionally produce machine-readable output	2022-06-22 16:10:06 -07:00
merge-recursive.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
merge-recursive.h	…
merge.c	…
mergesort.h	mergesort: remove llist_mergesort()	2022-07-17 15:20:39 -07:00
midx.c	Merge branch 'tb/midx-bitmap-selection-fix'	2022-10-27 14:51:52 -07:00
midx.h	pack-bitmap-write: learn pack.writeBitmapLookupTable and add tests	2022-08-26 10:13:54 -07:00
name-hash.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
notes-cache.c	…
notes-cache.h	…
notes-merge.c	…
notes-merge.h	…
notes-utils.c	…
notes-utils.h	…
notes.c	Merge branch 'ab/unused-annotation'	2022-09-14 12:56:39 -07:00
notes.h	…
object-file.c	Merge branch 'jk/unused-anno-more'	2022-10-27 14:51:52 -07:00
object-name.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
object-store.h	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
object.c	Merge branch 'jk/fsck-on-diet' into maint-2.38	2022-10-25 17:11:33 -07:00
object.h	parse_object(): allow skipping hash check	2022-09-07 12:18:57 -07:00
oid-array.c	…
oid-array.h	…
oidmap.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
oidmap.h	…
oidset.c	…
oidset.h	…
oidtree.c	…
oidtree.h	…
pack-bitmap-write.c	pack-bitmap-write.c: instrument number of reused bitmaps	2022-10-13 13:35:08 -07:00
pack-bitmap.c	Merge branch 'ds/bitmap-lookup-remove-tracing'	2022-09-26 21:46:51 -07:00
pack-bitmap.h	pack-bitmap: prepare to read lookup table extension	2022-08-26 10:13:58 -07:00
pack-check.c	…
pack-mtimes.c	pack-mtimes: avoid closing a bogus file descriptor	2022-06-16 13:22:03 -07:00
pack-mtimes.h	pack-mtimes: support reading .mtimes files	2022-05-26 15:48:26 -07:00
pack-objects.c	pack-mtimes: support writing pack .mtimes files	2022-05-26 15:48:26 -07:00
pack-objects.h	pack-objects.h: remove outdated pahole results	2022-06-28 15:39:03 -07:00
pack-revindex.c	…
pack-revindex.h	docs: move pack format docs to man section 5	2022-08-04 14:12:24 -07:00
pack-write.c	pack-write: drop always-NULL parameter	2022-06-16 11:59:55 -07:00
pack.h	pack-mtimes: support writing pack .mtimes files	2022-05-26 15:48:26 -07:00
packfile.c	Merge branch 'ab/unused-annotation'	2022-09-14 12:56:39 -07:00
packfile.h	…
pager.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
parallel-checkout.c	checkout: fix two bugs on the final count of updated entries	2022-07-14 10:19:28 -07:00
parallel-checkout.h	checkout: fix two bugs on the final count of updated entries	2022-07-14 10:19:28 -07:00
parse-options-cb.c	…
parse-options.c	parse-options: add support for parsing subcommands	2022-08-19 11:13:14 -07:00
parse-options.h	parse-options: add support for parsing subcommands	2022-08-19 11:13:14 -07:00
patch-delta.c	…
patch-ids.c	Merge branch 'jz/patch-id'	2022-10-30 21:04:41 -04:00
patch-ids.h	patch-id: use stable patch-id for rebases	2022-10-24 15:44:19 -07:00
path.c	Merge branch 'ds/bundle-uri'	2022-06-03 14:30:34 -07:00
path.h	…
pathspec.c	pathspec.h: move pathspec_needs_expanded_index() from reset.c to here	2022-08-08 13:23:26 -07:00
pathspec.h	pathspec.h: move pathspec_needs_expanded_index() from reset.c to here	2022-08-08 13:23:26 -07:00
pkt-line.c	t0021: implementation the rot13-filter.pl script in C	2022-08-14 22:57:12 -07:00
pkt-line.h	Merge branch 'mt/rot13-in-c'	2022-08-29 14:55:11 -07:00
preload-index.c	preload-index: fix memleak	2022-08-22 15:08:30 -07:00
pretty.c	Merge branch 'ab/unused-annotation'	2022-09-14 12:56:39 -07:00
pretty.h	…
prio-queue.c	tree-wide: apply equals-null.cocci	2022-05-02 09:50:37 -07:00
prio-queue.h	…
progress.c	…
progress.h	…
promisor-remote.c	promisor-remote: die upon failing fetch	2022-10-05 11:06:53 -07:00
promisor-remote.h	promisor-remote: remove a return value	2022-10-05 11:06:52 -07:00
prompt.c	…
prompt.h	…
protocol-caps.c	…
protocol-caps.h	…
protocol.c	…
protocol.h	…
prune-packed.c	…
prune-packed.h	…
quote.c	…
quote.h	…
range-diff.c	Merge branch 'ab/unused-annotation'	2022-09-14 12:56:39 -07:00
range-diff.h	…
reachable.c	reachable: report precise timestamps from objects in cruft packs	2022-05-26 15:48:26 -07:00
reachable.h	builtin/pack-objects.c: --cruft with expiration	2022-05-26 15:48:26 -07:00
read-cache.c	read-cache: avoid misaligned reads in index v4	2022-09-28 10:32:18 -07:00
rebase-interactive.c	sequencer: rewrite update-refs as user edits todo list	2022-07-19 12:49:04 -07:00
rebase-interactive.h	…
rebase.c	…
rebase.h	…
ref-filter.c	Merge branch 'rj/ref-filter-get-head-description-leakfix' into maint-2.38	2022-10-27 15:24:11 -07:00
ref-filter.h	…
reflog-walk.c	string-list: mark unused callback parameters	2022-10-17 21:24:04 -07:00
reflog-walk.h	…
reflog.c	refs: unify parse_worktree_ref() and ref_type()	2022-09-19 11:11:11 -07:00
reflog.h	…
refs.c	refs: unify parse_worktree_ref() and ref_type()	2022-09-19 11:11:11 -07:00
refs.h	refs: unify parse_worktree_ref() and ref_type()	2022-09-19 11:11:11 -07:00
refspec.c	…
refspec.h	docs: move protocol-related docs to man section 5	2022-08-04 14:12:23 -07:00
remote-curl.c	remote-curl: add 'get' capability	2022-08-10 14:07:37 -07:00
remote.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
remote.h	Merge branch 'rs/mergesort'	2022-08-03 13:36:09 -07:00
replace-object.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
replace-object.h	…
repo-settings.c	Merge branch 'jk/plug-list-object-filter-leaks'	2022-09-14 12:56:40 -07:00
repository.c	…
repository.h	Merge branch 'ab/submodule-helper-prep'	2022-09-13 11:38:23 -07:00
rerere.c	Merge branch 'ep/maint-equals-null-cocci'	2022-05-20 15:26:59 -07:00
rerere.h	…
reset.c	…
reset.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	Merge branch 'rs/diff-caret-bang-with-parents'	2022-10-25 17:11:43 -07:00
revision.h	Merge branch 'jc/format-patch-force-in-body-from'	2022-09-09 12:02:25 -07:00
run-command.c	run-command.c: remove "max_processes", add "const" to signal() handler	2022-10-12 14:12:42 -07:00
run-command.h	run-command API: move *_tr2() users to "run_processes_parallel()"	2022-10-12 14:12:41 -07:00
scalar.c	scalar: make 'unregister' idempotent	2022-09-27 09:32:26 -07:00
send-pack.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
send-pack.h	send-pack.c: add config push.useBitmaps	2022-06-17 14:31:01 -07:00
sequencer.c	Merge branch 'pw/rebase-reflog-fixes'	2022-10-30 21:04:43 -04:00
sequencer.h	sequencer: rewrite update-refs as user edits todo list	2022-07-19 12:49:04 -07:00
serve.c	…
serve.h	…
server-info.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
setup.c	Merge branch 'js/safe-directory-plus' into maint	2022-08-26 11:13:12 -07:00
sh-i18n--envsubst.c	tree-wide: apply equals-null.cocci	2022-05-02 09:50:37 -07:00
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
shallow.h	…
shared.mak	cocci: add a "coccicheck-test" target and test *.cocci rules	2022-07-06 12:24:43 -07:00
shell.c	Sync with 2.32.4	2022-10-06 17:42:02 -04:00
shortlog.h	shortlog: extract `shortlog_finish_setup()`	2022-10-24 14:48:05 -07:00
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
simple-ipc.h	…
sparse-index.c	Merge branch 'ds/sparse-sparse-checkout'	2022-06-03 14:30:35 -07:00
sparse-index.h	Merge branch 'ds/sparse-sparse-checkout'	2022-06-03 14:30:35 -07:00
split-index.c	…
split-index.h	…
stable-qsort.c	…
strbuf.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
strbuf.h	…
streaming.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
streaming.h	…
string-list.c	string-list: mark unused callback parameters	2022-10-17 21:24:04 -07:00
string-list.h	string-list: document iterator behavior on NULL input	2022-09-27 09:32:26 -07:00
strmap.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
strmap.h	…
strvec.c	…
strvec.h	…
sub-process.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
sub-process.h	…
submodule-config.c	run-command API: don't fall back on online_cpus()	2022-10-12 14:12:41 -07:00
submodule-config.h	Merge branch 'pb/submodule-recurse-mode-enum'	2022-05-20 15:26:53 -07:00
submodule.c	Merge branch 'rs/absorb-git-dir-simplify'	2022-10-30 21:04:42 -04:00
submodule.h	submodule API: don't handle SM_..{UNSPECIFIED,COMMAND} in to_string()	2022-09-02 09:16:24 -07:00
symlinks.c	…
tag.c	…
tag.h	…
tar.h	…
tempfile.c	tempfile: update comment describing state transitions	2022-08-30 14:16:51 -07:00
tempfile.h	tempfile: drop active flag	2022-08-30 14:16:49 -07:00
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	tmp-objdir: skip clean up when handling a signal	2022-09-30 21:26:58 -07:00
tmp-objdir.h	…
trace.c	…
trace.h	…
trace2.c	trace2: add global counter mechanism	2022-10-24 12:45:26 -07:00
trace2.h	trace2: add global counter mechanism	2022-10-24 12:45:26 -07:00
trailer.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
trailer.h	…
transport-helper.c	list-objects-filter: add and use initializers	2022-09-12 08:38:59 -07:00
transport-internal.h	…
transport.c	Merge branch 'ds/bundle-uri-3'	2022-10-30 21:04:44 -04:00
transport.h	push: new config option "push.autoSetupRemote" supports "simple" push	2022-04-29 11:20:55 -07:00
tree-diff.c	…
tree-walk.c	tree-walk: add a mechanism for getting non-canonicalized modes	2022-08-10 14:26:25 -07:00
tree-walk.h	tree-walk: add a mechanism for getting non-canonicalized modes	2022-08-10 14:26:25 -07:00
tree.c	…
tree.h	…
unicode-width.h	…
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unix-stream-server.c	…
unix-stream-server.h	…
unpack-trees.c	Merge branch 'vd/sparse-reset-checkout-fixes'	2022-09-09 12:02:26 -07:00
unpack-trees.h	…
upload-pack.c	Merge branch 'jk/list-objects-filter-cleanup'	2022-09-19 14:35:24 -07:00
upload-pack.h	…
url.c	…
url.h	…
urlmatch.c	…
urlmatch.h	…
usage.c	i18n: mark message helpers prefix for translation	2022-06-21 10:06:54 -07:00
userdiff.c	…
userdiff.h	…
utf8.c	…
utf8.h	…
varint.c	…
varint.h	…
version.c	…
version.h	…
versioncmp.c	…
walker.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
walker.h	…
wildmatch.c	tree-wide: apply equals-null.cocci	2022-05-02 09:50:37 -07:00
wildmatch.h	…
worktree.c	refs: unify parse_worktree_ref() and ref_type()	2022-09-19 11:11:11 -07:00
worktree.h	refs: unify parse_worktree_ref() and ref_type()	2022-09-19 11:11:11 -07:00
wrap-for-bin.sh	…
wrapper.c	Merge branch 'jk/pipe-command-nonblock'	2022-08-25 14:42:32 -07:00
write-or-die.c	environ: GIT_FLUSH should be made a usual Boolean	2022-09-15 11:34:51 -07:00
ws.c	…
wt-status.c	git-compat-util.h: use "UNUSED", not "UNUSED(var)"	2022-09-01 10:49:48 -07:00
wt-status.h	…
xdiff-interface.c	Merge branch 'ep/maint-equals-null-cocci' for maint-2.35	2022-05-02 10:06:04 -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-<commandname>.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 and Documentation/CodingGuidelines).

Those wishing to help with error message, usage and informational message string translations (localization l10) should see po/README.md (a po file is a Portable Object file that holds the translations).

To subscribe to the list, send an email with just "subscribe git" in the body to majordomo@vger.kernel.org (not the Git list). The mailing list archives are available at https://lore.kernel.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