Go to file

Patrick Steinhardt 1b43384f41 ci: verify minimum supported Rust version In the current state of our Rust code base we don't really have any requirements for the minimum supported Rust version yet, as we don't use any features introduced by a recent version of Rust. Consequently, we have decided that we want to aim for a rather old version and edition of Rust, where the hope is that using an old version will make alternatives like gccrs viable earlier for compiling Git. But while we specify the Rust edition, we don't yet specify a Rust version. And even if we did, the Rust version would only be enforced for our own code, but not for any of our dependencies. We don't yet have any dependencies at the current point in time. But let's add some safeguards by specifying the minimum supported Rust version and using cargo-msrv(1) to verify that this version can be satisfied for all of our dependencies. Note that we fix the version of cargo-msrv(1) at v0.18.1. This is the latest release supported by Ubuntu's Rust version. Signed-off-by: Patrick Steinhardt <ps@pks.im> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2025-10-15 08:10:17 -07:00
.github	ci: check formatting of our Rust code	2025-10-15 08:10:17 -07:00
Documentation	Merge branch 'ps/rust-balloon' into ps/ci-rust	2025-10-07 10:55:39 -07:00
bin-wrappers	…
block-sha1	…
builtin	Merge branch 'kh/you-still-use-whatchanged-fix'	2025-10-02 12:26:12 -07:00
ci	ci: verify minimum supported Rust version	2025-10-15 08:10:17 -07:00
compat	…
compiler-tricks	…
contrib	Merge branch 'ps/meson-build-docs'	2025-10-02 12:26:12 -07:00
ewah	…
git-gui	Merge branch 'master' of https://github.com/j6t/git-gui	2025-09-10 14:28:23 -07:00
gitk-git	Merge branch 'master' of https://github.com/j6t/gitk	2025-10-05 13:32:47 -07:00
gitweb	…
mergetools	…
negotiator	…
oss-fuzz	…
perl	…
po	git-gui: sync Makefiles with git.git	2025-09-06 11:59:48 +02:00
refs	Merge branch 'ms/refs-optimize'	2025-10-02 12:26:12 -07:00
reftable	…
sha1	…
sha1collisiondetection@855827c583	…
sha1dc	…
sha256	…
src	rust/varint: add safety comments	2025-10-15 08:10:17 -07:00
subprojects	…
t	Merge branch 'ps/gitlab-ci-windows-improvements' into ps/ci-rust	2025-10-07 10:55:57 -07:00
templates	…
trace2	…
xdiff	…
.cirrus.yml	…
.clang-format	…
.editorconfig	…
.gitattributes	…
.gitignore	Merge branch 'ps/rust-balloon' into ps/ci-rust	2025-10-07 10:55:39 -07:00
.gitlab-ci.yml	ci: check formatting of our Rust code	2025-10-15 08:10:17 -07:00
.gitmodules	…
.mailmap	mailmap: consolidate multiple addresses into one	2025-09-16 17:55:25 -07:00
.tsan-suppressions	…
CODE_OF_CONDUCT.md	…
COPYING	…
Cargo.toml	ci: verify minimum supported Rust version	2025-10-15 08:10:17 -07:00
GIT-BUILD-OPTIONS.in	…
GIT-VERSION-FILE.in	…
GIT-VERSION-GEN	Start 2.52 cycle, the first batch	2025-08-21 13:47:03 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	Merge branch 'ps/rust-balloon' into ps/ci-rust	2025-10-07 10:55:39 -07:00
README.md	gitk: add README with usage, build, and contribution details	2025-08-28 19:51:31 +02:00
RelNotes	Start 2.52 cycle, the first batch	2025-08-21 13:47:03 -07:00
SECURITY.md	…
abspath.c	…
abspath.h	…
aclocal.m4	…
add-interactive.c	add-interactive: retain colorbool values longer	2025-09-16 18:00:25 -07:00
add-interactive.h	add-interactive: retain colorbool values longer	2025-09-16 18:00:25 -07:00
add-patch.c	add-interactive: respect color.diff for diff coloring	2025-09-08 14:00:32 -07:00
advice.c	initial branch: give hints after switching the default name	2025-09-18 11:44:47 -07:00
advice.h	initial branch: give hints after switching the default name	2025-09-18 11:44:47 -07:00
alias.c	…
alias.h	…
alloc.c	alloc: fix dangling pointer in alloc_state cleanup	2025-09-04 15:24:16 -07:00
alloc.h	alloc: fix dangling pointer in alloc_state cleanup	2025-09-04 15:24:16 -07:00
apply.c	…
apply.h	…
archive-tar.c	…
archive-zip.c	…
archive.c	…
archive.h	…
attr.c	…
attr.h	…
banned.h	…
base85.c	…
base85.h	…
bisect.c	revision: add wrapper to setup_revisions() from a strvec	2025-09-22 14:27:03 -07:00
bisect.h	…
blame.c	…
blame.h	…
blob.c	…
blob.h	…
bloom.c	…
bloom.h	…
branch.c	…
branch.h	…
builtin.h	Merge branch 'tc/last-modified'	2025-09-08 14:54:35 -07:00
bundle-uri.c	…
bundle-uri.h	…
bundle.c	…
bundle.h	…
cache-tree.c	odb: add transaction interface	2025-09-16 11:37:06 -07:00
cache-tree.h	…
cbtree.c	…
cbtree.h	…
chdir-notify.c	…
chdir-notify.h	…
check-builtins.sh	…
checkout.c	…
checkout.h	…
chunk-format.c	…
chunk-format.h	…
color.c	color: return bool from want_color()	2025-09-16 18:00:25 -07:00
color.h	color: return bool from want_color()	2025-09-16 18:00:25 -07:00
column.c	…
column.h	…
combine-diff.c	Merge branch 'tc/last-modified-recursive-fix'	2025-09-29 11:40:35 -07:00
command-list.txt	Merge branch 'tc/last-modified'	2025-09-08 14:54:35 -07:00
commit-graph.c	Merge branch 'tc/last-modified'	2025-09-08 14:54:35 -07:00
commit-graph.h	…
commit-reach.c	…
commit-reach.h	…
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	…
commit.h	…
common-exit.c	…
common-init.c	…
common-init.h	…
common-main.c	…
config.c	Merge branch 'pw/3.0-commentchar-auto-deprecation'	2025-09-18 10:07:00 -07:00
config.h	…
config.mak.dev	…
config.mak.in	…
config.mak.uname	…
configure.ac	…
connect.c	…
connect.h	…
connected.c	…
connected.h	…
convert.c	…
convert.h	…
copy.c	…
copy.h	…
credential.c	…
credential.h	…
csum-file.c	…
csum-file.h	…
ctype.c	…
daemon.c	…
date.c	…
date.h	…
decorate.c	…
decorate.h	…
delta-islands.c	…
delta-islands.h	…
delta.h	…
detect-compiler	…
diagnose.c	…
diagnose.h	…
diff-delta.c	…
diff-lib.c	…
diff-merges.c	…
diff-merges.h	…
diff-no-index.c	…
diff.c	Merge branch 'jk/color-variable-fixes'	2025-09-29 11:40:35 -07:00
diff.h	Merge branch 'tc/last-modified-recursive-fix'	2025-09-29 11:40:35 -07:00
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	…
diffcore-rename.c	…
diffcore-rotate.c	…
diffcore.h	…
dir-iterator.c	…
dir-iterator.h	…
dir.c	varint: use explicit width for integers	2025-10-02 09:32:32 -07:00
dir.h	…
editor.c	…
editor.h	…
entry.c	…
entry.h	…
environment.c	Merge branch 'pw/3.0-commentchar-auto-deprecation'	2025-09-18 10:07:00 -07:00
environment.h	config: warn on core.commentString=auto	2025-08-26 08:52:44 -07:00
exec-cmd.c	…
exec-cmd.h	…
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-pack.c	Merge branch 'jk/fetch-check-graph-objects-fix'	2025-08-28 11:28:58 -07:00
fetch-pack.h	…
fmt-merge-msg.c	Merge branch 'ac/deglobal-fmt-merge-log-config'	2025-08-22 13:13:21 -07:00
fmt-merge-msg.h	…
for-each-ref.h	Merge branch 'ja/doc-lint-sections-and-synopsis'	2025-08-25 14:22:02 -07:00
fsck.c	…
fsck.h	…
fsmonitor--daemon.h	…
fsmonitor-ipc.c	…
fsmonitor-ipc.h	…
fsmonitor-ll.h	…
fsmonitor-path-utils.h	…
fsmonitor-settings.c	…
fsmonitor-settings.h	…
fsmonitor.c	…
fsmonitor.h	…
generate-cmdlist.sh	…
generate-configlist.sh	…
generate-hooklist.sh	…
generate-perl.sh	…
generate-python.sh	…
generate-script.sh	…
gettext.c	…
gettext.h	…
git-archimport.perl	…
git-compat-util.h	whatchanged: hint about git-log(1) and aliasing	2025-09-17 13:47:24 -07:00
git-curl-compat.h	curl: add support for curl_global_trace() components	2025-08-27 09:49:43 -07:00
git-cvsexportcommit.perl	…
git-cvsimport.perl	…
git-cvsserver.perl	…
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	…
git-quiltimport.sh	…
git-request-pull.sh	…
git-send-email.perl	Merge branch 'nb/send-email-no-dup-reply-to'	2025-09-29 11:40:33 -07:00
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-submodule.sh	…
git-svn.perl	…
git-web--browse.sh	…
git-zlib.c	…
git-zlib.h	…
git.c	Merge branch 'kh/you-still-use-whatchanged-fix'	2025-10-02 12:26:12 -07:00
git.rc.in	…
gpg-interface.c	gpg-interface: refactor 'enum sign_mode' parsing	2025-09-17 11:18:28 -07:00
gpg-interface.h	gpg-interface: refactor 'enum sign_mode' parsing	2025-09-17 11:18:28 -07:00
graph.c	…
graph.h	…
grep.c	grep: don't treat grep_opt.color as a strict bool	2025-09-16 13:37:05 -07:00
grep.h	color: use git_colorbool enum type to store colorbools	2025-09-16 17:59:53 -07:00
hash-lookup.c	…
hash-lookup.h	…
hash.c	…
hash.h	…
hashmap.c	…
hashmap.h	…
help.c	help: report on whether or not Rust is enabled	2025-10-02 09:32:31 -07:00
help.h	…
hex-ll.c	…
hex-ll.h	…
hex.c	…
hex.h	…
hook.c	…
hook.h	…
http-backend.c	…
http-fetch.c	…
http-push.c	treewide: use setup_revisions_from_strvec() when we have a strvec	2025-09-22 14:27:03 -07:00
http-walker.c	…
http.c	Merge branch 'jk/curl-global-trace-components'	2025-09-18 10:07:02 -07:00
http.h	…
ident.c	…
ident.h	…
imap-send.c	Merge branch 'ag/send-email-imap-sent'	2025-09-18 10:07:00 -07:00
iterator.h	…
json-writer.c	…
json-writer.h	…
khash.h	…
kwset.c	…
kwset.h	…
levenshtein.c	…
levenshtein.h	…
line-log.c	Merge branch 'sg/line-log-boundary-fixes'	2025-09-18 10:07:01 -07:00
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	use repo_get_oid_with_flags()	2025-09-10 14:29:49 -07:00
list-objects-filter.h	…
list-objects.c	…
list-objects.h	…
list.h	…
lockfile.c	…
lockfile.h	…
log-tree.c	Merge branch 'jk/color-variable-fixes'	2025-09-29 11:40:35 -07:00
log-tree.h	color: use git_colorbool enum type to store colorbools	2025-09-16 17:59:53 -07:00
loose.c	…
loose.h	…
ls-refs.c	…
ls-refs.h	…
mailinfo.c	…
mailinfo.h	…
mailmap.c	…
mailmap.h	…
match-trees.c	…
match-trees.h	…
mem-pool.c	…
mem-pool.h	…
merge-blobs.c	…
merge-blobs.h	…
merge-ll.c	…
merge-ll.h	…
merge-ort-wrappers.c	…
merge-ort-wrappers.h	…
merge-ort.c	Merge branch 'en/ort-rename-fixes'	2025-08-21 13:47:02 -07:00
merge-ort.h	…
merge.c	…
merge.h	…
mergesort.h	…
meson.build	Merge branch 'ps/rust-balloon' into ps/ci-rust	2025-10-07 10:55:39 -07:00
meson_options.txt	meson: add infrastructure to build internal Rust library	2025-10-02 09:32:31 -07:00
midx-write.c	Merge branch 'ds/midx-write-fixes'	2025-09-15 08:52:06 -07:00
midx.c	…
midx.h	…
name-hash.c	…
name-hash.h	…
notes-cache.c	…
notes-cache.h	…
notes-merge.c	…
notes-merge.h	…
notes-utils.c	…
notes-utils.h	…
notes.c	…
notes.h	…
object-file-convert.c	…
object-file-convert.h	…
object-file.c	odb: add transaction interface	2025-09-16 11:37:06 -07:00
object-file.h	odb: add transaction interface	2025-09-16 11:37:06 -07:00
object-name.c	Merge branch 'rs/get-oid-with-flags-cleanup'	2025-09-23 11:53:40 -07:00
object-name.h	…
object.c	alloc: fix dangling pointer in alloc_state cleanup	2025-09-04 15:24:16 -07:00
object.h	…
odb.c	Merge branch 'jt/odb-transaction'	2025-10-02 12:26:11 -07:00
odb.h	Merge branch 'jt/odb-transaction'	2025-10-02 12:26:11 -07:00
oid-array.c	…
oid-array.h	…
oidmap.c	…
oidmap.h	…
oidset.c	…
oidset.h	…
oidtree.c	…
oidtree.h	…
pack-bitmap-write.c	…
pack-bitmap.c	…
pack-bitmap.h	…
pack-check.c	…
pack-mtimes.c	…
pack-mtimes.h	…
pack-objects.c	…
pack-objects.h	…
pack-refs.c	builtin/pack-refs: factor out core logic into a shared library	2025-09-19 10:02:55 -07:00
pack-refs.h	builtin/pack-refs: factor out core logic into a shared library	2025-09-19 10:02:55 -07:00
pack-revindex.c	…
pack-revindex.h	…
pack-write.c	…
pack.h	…
packfile.c	…
packfile.h	…
pager.c	…
pager.h	…
parallel-checkout.c	…
parallel-checkout.h	…
parse-options-cb.c	color: use git_colorbool enum type to store colorbools	2025-09-16 17:59:53 -07:00
parse-options.c	Merge branch 'dk/help-all'	2025-08-25 14:22:00 -07:00
parse-options.h	…
parse.c	…
parse.h	…
patch-delta.c	…
patch-ids.c	…
patch-ids.h	…
path-walk.c	path-walk: create initializer for path lists	2025-08-25 09:01:17 -07:00
path-walk.h	…
path.c	…
path.h	…
pathspec.c	…
pathspec.h	…
pkt-line.c	…
pkt-line.h	…
preload-index.c	…
preload-index.h	…
pretty.c	color: use git_colorbool enum type to store colorbools	2025-09-16 17:59:53 -07:00
pretty.h	color: use git_colorbool enum type to store colorbools	2025-09-16 17:59:53 -07:00
prio-queue.c	…
prio-queue.h	…
progress.c	progress: pay attention to (customized) delay time	2025-08-25 15:50:17 -07:00
progress.h	…
promisor-remote.c	promisor-remote: use string_list_split() in mark_remotes_as_accepted()	2025-09-08 10:30:56 -07:00
promisor-remote.h	…
prompt.c	…
prompt.h	…
protocol-caps.c	…
protocol-caps.h	…
protocol.c	…
protocol.h	…
prune-packed.c	…
prune-packed.h	…
pseudo-merge.c	…
pseudo-merge.h	…
quote.c	…
quote.h	…
range-diff.c	range-diff: add configurable memory limit for cost matrix	2025-08-29 09:46:07 -07:00
range-diff.h	range-diff: add configurable memory limit for cost matrix	2025-08-29 09:46:07 -07:00
reachable.c	…
reachable.h	…
read-cache-ll.h	…
read-cache.c	Merge branch 'ps/rust-balloon' into ps/ci-rust	2025-10-07 10:55:39 -07:00
read-cache.h	…
rebase-interactive.c	…
rebase-interactive.h	…
rebase.c	…
rebase.h	…
ref-filter.c	…
ref-filter.h	color: use git_colorbool enum type to store colorbools	2025-09-16 17:59:53 -07:00
reflog-walk.c	…
reflog-walk.h	…
reflog.c	…
reflog.h	…
refs.c	Merge branch 'ms/refs-optimize'	2025-10-02 12:26:12 -07:00
refs.h	Merge branch 'ms/refs-optimize'	2025-10-02 12:26:12 -07:00
refspec.c	…
refspec.h	…
remote-curl.c	…
remote.c	Merge branch 'jk/setup-revisions-freefix'	2025-09-29 11:40:34 -07:00
remote.h	…
replace-object.c	…
replace-object.h	…
repo-settings.c	…
repo-settings.h	…
repository.c	Merge branch 'pw/3.0-commentchar-auto-deprecation'	2025-09-18 10:07:00 -07:00
repository.h	config: warn on core.commentString=auto	2025-08-26 08:52:44 -07:00
rerere.c	…
rerere.h	…
reset.c	…
reset.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	Merge branch 'jk/setup-revisions-freefix'	2025-09-29 11:40:34 -07:00
revision.h	revision: add wrapper to setup_revisions() from a strvec	2025-09-22 14:27:03 -07:00
run-command.c	…
run-command.h	…
sane-ctype.h	…
scalar.c	…
send-pack.c	…
send-pack.h	…
sequencer.c	Merge branch 'jk/setup-revisions-freefix'	2025-09-29 11:40:34 -07:00
sequencer.h	treewide: pass strvecs around for setup_revisions_from_strvec()	2025-09-22 14:27:03 -07:00
serve.c	…
serve.h	…
server-info.c	…
server-info.h	…
setup.c	…
setup.h	…
sh-i18n--envsubst.c	…
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	treewide: pass strvecs around for setup_revisions_from_strvec()	2025-09-22 14:27:03 -07:00
shallow.h	treewide: pass strvecs around for setup_revisions_from_strvec()	2025-09-22 14:27:03 -07:00
shared.mak	Makefile: introduce infrastructure to build internal Rust library	2025-10-02 09:32:31 -07:00
shell.c	…
shortlog.h	…
sideband.c	color: use git_colorbool enum type to store colorbools	2025-09-16 17:59:53 -07:00
sideband.h	…
sigchain.c	…
sigchain.h	…
simple-ipc.h	…
sparse-index.c	…
sparse-index.h	…
split-index.c	…
split-index.h	…
stable-qsort.c	…
statinfo.c	…
statinfo.h	…
strbuf.c	…
strbuf.h	…
streaming.c	…
streaming.h	…
string-list.c	…
string-list.h	…
strmap.c	…
strmap.h	…
strvec.c	…
strvec.h	…
sub-process.c	…
sub-process.h	…
submodule-config.c	…
submodule-config.h	…
submodule.c	treewide: use setup_revisions_from_strvec() when we have a strvec	2025-09-22 14:27:03 -07:00
submodule.h	…
symlinks.c	…
symlinks.h	…
tag.c	…
tag.h	…
tar.h	…
tempfile.c	…
tempfile.h	…
thread-utils.c	…
thread-utils.h	…
tmp-objdir.c	…
tmp-objdir.h	…
trace.c	…
trace.h	…
trace2.c	…
trace2.h	…
trailer.c	…
trailer.h	…
transport-helper.c	…
transport-internal.h	…
transport.c	Merge branch 'jk/color-variable-fixes'	2025-09-29 11:40:35 -07:00
transport.h	…
tree-diff.c	…
tree-walk.c	…
tree-walk.h	…
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	…
unpack-trees.h	…
upload-pack.c	Merge branch 'jk/setup-revisions-freefix'	2025-09-29 11:40:34 -07:00
upload-pack.h	…
url.c	…
url.h	…
urlmatch.c	…
urlmatch.h	…
usage.c	Merge branch 'kh/you-still-use-whatchanged-fix'	2025-10-02 12:26:12 -07:00
userdiff.c	…
userdiff.h	…
utf8.c	…
utf8.h	…
varint.c	varint: use explicit width for integers	2025-10-02 09:32:32 -07:00
varint.h	varint: use explicit width for integers	2025-10-02 09:32:32 -07:00
version-def.h.in	…
version.c	…
version.h	…
versioncmp.c	…
versioncmp.h	…
walker.c	…
walker.h	…
wildmatch.c	…
wildmatch.h	…
worktree.c	…
worktree.h	…
wrapper.c	…
wrapper.h	…
write-or-die.c	…
write-or-die.h	…
ws.c	…
ws.h	…
wt-status.c	Merge branch 'jk/color-variable-fixes'	2025-09-29 11:40:35 -07:00
wt-status.h	color: use git_colorbool enum type to store colorbools	2025-09-16 17:59:53 -07:00
xdiff-interface.c	…
xdiff-interface.h	…

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.adoc to get started, then see Documentation/giteveryday.adoc for a useful minimum set of commands, and Documentation/git-<commandname>.adoc 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.adoc (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 to git+subscribe@vger.kernel.org (see https://subspace.kernel.org/subscribing.html for details). The mailing list archives are available at https://lore.kernel.org/git/, https://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