Go to file

Jeff King d70a9eb611 strvec: rename struct fields The "argc" and "argv" names made sense when the struct was argv_array, but now they're just confusing. Let's rename them to "nr" (which we use for counts elsewhere) and "v" (which is rather terse, but reads well when combined with typical variable names like "args.v"). Note that we have to update all of the callers immediately. Playing tricks with the preprocessor is hard here, because we wouldn't want to rewrite unrelated tokens. Signed-off-by: Jeff King <peff@peff.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2020-07-30 19:18:06 -07:00
.github	Merge branch 'es/advertise-contribution-doc'	2020-06-17 21:54:06 -07:00
Documentation	strvec: update documention to avoid argv_array	2020-07-28 15:02:18 -07:00
block-sha1	…
builtin	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
ci	Merge branch 'jk/ci-only-on-selected-branches'	2020-05-29 15:12:19 -07:00
compat	strvec: convert more callers away from argv_array name	2020-07-28 15:02:18 -07:00
contrib	Merge branch 'en/sparse-status' into master	2020-07-21 14:19:10 -07:00
ewah	…
git-gui	Merge https://github.com/prati0100/git-gui into master	2020-07-20 12:04:06 -07:00
gitk-git	…
gitweb	…
mergetools	…
negotiator	…
perl	perl: make SVN code hash independent	2020-06-22 11:21:07 -07:00
po	Merge branch 'master' of github.com:Softcatala/git-po	2020-07-27 00:05:41 +08:00
ppc	…
refs	…
sha1collisiondetection@855827c583	…
sha1dc	…
sha256	…
t	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
templates	…
trace2	…
vcs-svn	…
xdiff	…
.cirrus.yml	…
.clang-format	…
.editorconfig	…
.gitattributes	…
.gitignore	…
.gitmodules	…
.mailmap	…
.travis.yml	…
.tsan-suppressions	…
CODE_OF_CONDUCT.md	…
COPYING	…
GIT-VERSION-GEN	Git 2.28	2020-07-26 18:01:43 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	strvec: rename files from argv-array to strvec	2020-07-28 15:02:17 -07:00
README.md	…
RelNotes	Start the post 2.27 cycle	2020-06-02 13:35:05 -07:00
abspath.c	…
aclocal.m4	…
add-interactive.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
add-interactive.h	…
add-patch.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
advice.c	…
advice.h	…
alias.c	…
alias.h	…
alloc.c	commit: move members graph_pos, generation to a slab	2020-06-17 14:37:30 -07:00
alloc.h	object: drop parsed_object_pool->commit_count	2020-06-17 14:37:14 -07:00
apply.c	…
apply.h	…
archive-tar.c	…
archive-zip.c	…
archive.c	…
archive.h	…
attr.c	…
attr.h	…
banned.h	…
base85.c	…
bisect.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
bisect.h	…
blame.c	commit: move members graph_pos, generation to a slab	2020-06-17 14:37:30 -07:00
blame.h	…
blob.c	object: drop parsed_object_pool->commit_count	2020-06-17 14:37:14 -07:00
blob.h	…
bloom.c	commit-graph: minimize commit_graph_data_slab access	2020-06-17 14:37:52 -07:00
bloom.h	Merge branch 'ds/line-log-on-bloom'	2020-06-08 18:06:26 -07:00
branch.c	Merge branch 'es/get-worktrees-unsort'	2020-07-06 22:09:15 -07:00
branch.h	…
bugreport.c	Merge branch 'rs/retire-strbuf-write-fd'	2020-06-29 14:17:26 -07:00
builtin.h	…
bulk-checkin.c	…
bulk-checkin.h	…
bundle.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
bundle.h	strvec: convert more callers away from argv_array name	2020-07-28 15:02:18 -07:00
cache-tree.c	…
cache-tree.h	…
cache.h	Merge branch 'jn/v0-with-extensions-fix' into master	2020-07-16 17:58:42 -07:00
chdir-notify.c	…
chdir-notify.h	…
check-builtins.sh	…
check_bindir	…
checkout.c	…
checkout.h	…
color.c	…
color.h	…
column.c	strvec: convert more callers away from argv_array name	2020-07-28 15:02:18 -07:00
column.h	…
combine-diff.c	…
command-list.txt	bash-completion: add git-prune into bash completion	2020-06-22 11:29:38 -07:00
commit-graph.c	Merge branch 'sg/commit-graph-progress-fix' into master	2020-07-15 16:29:43 -07:00
commit-graph.h	commit-graph: introduce commit_graph_data_slab	2020-06-17 14:37:23 -07:00
commit-reach.c	Merge branch 'cb/is-descendant-of'	2020-07-06 22:09:16 -07:00
commit-reach.h	commit-reach: avoid is_descendant_of() shim	2020-06-23 16:36:53 -07:00
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
commit.h	commit: move members graph_pos, generation to a slab	2020-06-17 14:37:30 -07:00
common-main.c	…
config.c	…
config.h	…
config.mak.dev	…
config.mak.in	…
config.mak.uname	…
configure.ac	…
connect.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
connect.h	Merge branch 'bc/sha-256-part-2'	2020-07-06 22:09:13 -07:00
connected.c	strvec: fix indentation in renamed calls	2020-07-28 15:02:18 -07:00
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	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
date.c	…
decorate.c	…
decorate.h	…
delta-islands.c	…
delta-islands.h	…
delta.h	…
detect-compiler	…
diff-delta.c	…
diff-lib.c	diff-files --raw: show correct post-image of intent-to-add files	2020-07-01 16:15:43 -07:00
diff-no-index.c	…
diff.c	strvec: rename struct fields	2020-07-30 19:18:06 -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 'en/clean-cleanups'	2020-06-25 12:27:45 -07:00
dir.h	…
editor.c	…
entry.c	Merge branch 'mt/entry-fstat-fallback-fix' into master	2020-07-09 14:00:45 -07:00
environment.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
exec-cmd.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
exec-cmd.h	argv-array: rename to strvec	2020-07-28 15:02:17 -07:00
fast-import.c	strvec: convert more callers away from argv_array name	2020-07-28 15:02:18 -07:00
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-pack.c	strvec: fix indentation in renamed calls	2020-07-28 15:02:18 -07:00
fetch-pack.h	fetch-pack: support more than one pack lockfile	2020-06-10 18:06:34 -07:00
fmt-merge-msg.c	fmt-merge-msg: stop treating `master` specially	2020-06-23 17:22:35 -07:00
fmt-merge-msg.h	…
fsck.c	Merge branch 'rs/fsck-duplicate-names-in-trees'	2020-06-08 18:06:29 -07:00
fsck.h	…
fsmonitor.c	strvec: convert more callers away from argv_array name	2020-07-28 15:02:18 -07:00
fsmonitor.h	…
fuzz-commit-graph.c	fuzz-commit-graph: properly free graph struct	2020-06-08 10:02:29 -07:00
fuzz-pack-headers.c	…
fuzz-pack-idx.c	…
generate-cmdlist.sh	…
generate-configlist.sh	…
gettext.c	…
gettext.h	…
git-add--interactive.perl	checkout -p: handle new files correctly	2020-05-27 14:50:20 -07:00
git-archimport.perl	…
git-bisect.sh	…
git-compat-util.h	Merge branch 'bc/sha-256-part-2'	2020-07-06 22:09:13 -07:00
git-cvsexportcommit.perl	git-cvsexportcommit: port to SHA-256	2020-06-22 11:21:07 -07:00
git-cvsimport.perl	git-cvsimport: port to SHA-256	2020-06-22 11:21:07 -07:00
git-cvsserver.perl	git-cvsserver: port to SHA-256	2020-06-22 11:21:07 -07:00
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 'bk/p4-prepare-p4-only-fix'	2020-06-02 13:35:01 -07:00
git-parse-remote.sh	…
git-quiltimport.sh	…
git-rebase--preserve-merges.sh	…
git-request-pull.sh	…
git-send-email.perl	send-email: restore --in-reply-to superseding behavior	2020-07-01 16:12:21 -07:00
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-submodule.sh	submodule: port subcommand 'set-branch' from shell to C	2020-06-02 10:51:54 -07:00
git-svn.perl	git-svn: set the OID length based on hash algorithm	2020-06-22 11:21:07 -07:00
git-web--browse.sh	…
git.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
git.rc	…
gpg-interface.c	strvec: fix indentation in renamed calls	2020-07-28 15:02:18 -07:00
gpg-interface.h	…
graph.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
graph.h	…
grep.c	…
grep.h	…
hash.h	…
hashmap.c	…
hashmap.h	…
help.c	…
help.h	…
hex.c	…
http-backend.c	strvec: fix indentation in renamed calls	2020-07-28 15:02:18 -07:00
http-fetch.c	http-fetch: support fetching packfiles by URL	2020-06-10 18:06:34 -07:00
http-push.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
http-walker.c	http: refactor finish_http_pack_request()	2020-06-10 18:06:34 -07:00
http.c	strvec: fix indentation in renamed calls	2020-07-28 15:02:18 -07:00
http.h	Merge branch 'jt/cdn-offload'	2020-06-25 12:27:47 -07:00
ident.c	…
imap-send.c	strvec: convert more callers away from argv_array name	2020-07-28 15:02:18 -07:00
interdiff.c	…
interdiff.h	…
iterator.h	…
json-writer.c	…
json-writer.h	…
khash.h	…
kwset.c	…
kwset.h	…
levenshtein.c	…
levenshtein.h	…
line-log.c	strvec: convert more callers away from argv_array name	2020-07-28 15:02:18 -07:00
line-log.h	…
line-range.c	…
line-range.h	…
linear-assignment.c	…
linear-assignment.h	…
list-objects-filter-options.c	strvec: rename files from argv-array to strvec	2020-07-28 15:02:17 -07:00
list-objects-filter-options.h	…
list-objects-filter.c	…
list-objects-filter.h	…
list-objects.c	…
list-objects.h	…
list.h	…
ll-merge.c	…
ll-merge.h	…
lockfile.c	…
lockfile.h	…
log-tree.c	…
log-tree.h	…
ls-refs.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
ls-refs.h	argv-array: rename to strvec	2020-07-28 15:02:17 -07:00
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	…
merge-recursive.h	…
merge.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
mergesort.c	…
mergesort.h	…
midx.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
midx.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-store.h	packfile: compute and use the index CRC offset	2020-05-27 10:07:07 -07:00
object.c	object: drop parsed_object_pool->commit_count	2020-06-17 14:37:14 -07:00
object.h	Merge branch 'tb/fix-persistent-shallow' into master	2020-07-09 14:00:44 -07:00
oid-array.c	…
oid-array.h	…
oidmap.c	…
oidmap.h	…
oidset.c	…
oidset.h	…
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	…
packfile.c	packfile: compute and use the index CRC offset	2020-05-27 10:07:07 -07:00
packfile.h	…
pager.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
parse-options-cb.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
parse-options.c	…
parse-options.h	…
patch-delta.c	…
patch-ids.c	…
patch-ids.h	…
path.c	…
path.h	…
pathspec.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
pathspec.h	…
pkt-line.c	Merge branch 'bc/sha-256-part-2'	2020-07-06 22:09:13 -07:00
pkt-line.h	Merge branch 'bc/sha-256-part-2'	2020-07-06 22:09:13 -07:00
preload-index.c	…
pretty.c	…
pretty.h	…
prio-queue.c	…
prio-queue.h	…
progress.c	…
progress.h	…
promisor-remote.c	…
promisor-remote.h	…
prompt.c	…
prompt.h	…
protocol.c	…
protocol.h	…
prune-packed.c	…
prune-packed.h	…
quote.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
quote.h	quote: rename sq_dequote_to_argv_array to mention strvec	2020-07-28 15:02:18 -07:00
range-diff.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
range-diff.h	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
reachable.c	…
reachable.h	…
read-cache.c	…
rebase-interactive.c	…
rebase-interactive.h	…
rebase.c	…
rebase.h	…
ref-filter.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
ref-filter.h	…
reflog-walk.c	…
reflog-walk.h	…
refs.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
refs.h	argv-array: rename to strvec	2020-07-28 15:02:17 -07:00
refspec.c	strvec: fix indentation in renamed calls	2020-07-28 15:02:18 -07:00
refspec.h	argv-array: rename to strvec	2020-07-28 15:02:17 -07:00
remote-curl.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
remote-testsvn.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
remote.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
remote.h	argv-array: rename to strvec	2020-07-28 15:02:17 -07:00
replace-object.c	…
replace-object.h	…
repo-settings.c	experimental: default to fetch.writeCommitGraph=false	2020-07-08 16:37:43 -07:00
repository.c	…
repository.h	repository: add a helper function to perform repository format upgrade	2020-06-05 10:13:30 -07:00
rerere.c	…
rerere.h	…
reset.c	…
reset.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
revision.h	revision: reallocate TOPO_WALK object flags	2020-06-24 09:09:44 -07:00
run-command.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
run-command.h	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
send-pack.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
send-pack.h	…
sequencer.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
sequencer.h	…
serve.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
serve.h	argv-array: rename to strvec	2020-07-28 15:02:17 -07:00
server-info.c	…
setup.c	Merge branch 'jn/v0-with-extensions-fix' into master	2020-07-16 17:58:42 -07:00
sh-i18n--envsubst.c	…
sha1-file.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
sha1-lookup.c	…
sha1-lookup.h	…
sha1-name.c	…
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	…
shallow.h	…
shell.c	…
shortlog.h	…
sideband.c	…
sideband.h	…
sigchain.c	…
sigchain.h	…
split-index.c	…
split-index.h	…
stable-qsort.c	…
strbuf.c	Merge branch 'rs/retire-strbuf-write-fd'	2020-06-29 14:17:26 -07:00
strbuf.h	Merge branch 'rs/retire-strbuf-write-fd'	2020-06-29 14:17:26 -07:00
streaming.c	…
streaming.h	…
string-list.c	…
string-list.h	…
strvec.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
strvec.h	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
sub-process.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
sub-process.h	…
submodule-config.c	…
submodule-config.h	…
submodule.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
submodule.h	argv-array: rename to strvec	2020-07-28 15:02:17 -07:00
symlinks.c	…
tag.c	object: drop parsed_object_pool->commit_count	2020-06-17 14:37:14 -07:00
tag.h	…
tar.h	…
tempfile.c	…
tempfile.h	…
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
tmp-objdir.h	…
trace.c	…
trace.h	…
trace2.c	…
trace2.h	…
trailer.c	…
trailer.h	…
transport-helper.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
transport-internal.h	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
transport.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
transport.h	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
tree-diff.c	…
tree-walk.c	…
tree-walk.h	…
tree.c	object: drop parsed_object_pool->commit_count	2020-06-17 14:37:14 -07:00
tree.h	…
unicode-width.h	…
unimplemented.sh	…
unix-socket.c	…
unix-socket.h	…
unpack-trees.c	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
unpack-trees.h	strvec: convert remaining callers away from argv_array name	2020-07-28 15:02:18 -07:00
upload-pack.c	strvec: rename struct fields	2020-07-30 19:18:06 -07:00
upload-pack.h	argv-array: rename to strvec	2020-07-28 15:02:17 -07:00
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.h	…
worktree.c	Merge branch 'es/worktree-code-cleanup'	2020-07-06 22:09:19 -07:00
worktree.h	worktree: drop get_worktrees() unused 'flags' argument	2020-06-22 10:31:15 -07:00
wrap-for-bin.sh	…
wrapper.c	wrapper: add function to compare strings with different NUL termination	2020-05-27 10:07:06 -07:00
write-or-die.c	…
ws.c	…
wt-status.c	strvec: fix indentation in renamed calls	2020-07-28 15:02:18 -07:00
wt-status.h	wt-status: show sparse checkout status as well	2020-06-18 14:12:28 -07:00
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-<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). 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://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