Go to file

Johannes Schindelin 675704c74d init: provide useful advice about init.defaultBranch To give ample warning for users wishing to override Git's the fall-back for an unconfigured `init.defaultBranch` (in case we decide to change it in a future Git version), let's introduce some advice that is shown upon `git init` when that value is not set. Note: two test cases in Git's test suite want to verify that the `stderr` output of `git init` is empty. It is now necessary to suppress the advice, we now do that via the `init.defaultBranch` setting. While not strictly necessary, we also set this to `false` in `test_create_repo()`. Signed-off-by: Johannes Schindelin <johannes.schindelin@gmx.de> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2020-12-13 15:53:51 -08:00
.github	Merge branch 'js/ci-github-set-env'	2020-11-11 13:18:39 -08:00
Documentation	init: document `init.defaultBranch` better	2020-12-13 15:53:50 -08:00
block-sha1	…
builtin	get_default_branch_name(): prepare for showing some advice	2020-12-13 15:53:50 -08:00
ci	ci: do not skip tagged revisions in GitHub workflows	2020-10-08 11:58:41 -07:00
compat	compat/bswap.h: don't assume MSVC is little-endian	2020-11-11 11:24:47 -08:00
contrib	Merge branch 'sd/prompt-local-variable'	2020-11-11 13:18:38 -08:00
ewah	…
git-gui	Merge https://github.com/prati0100/git-gui	2020-10-17 13:10:58 -07:00
gitk-git	Merge remote-tracking branch 'paulus/master' into pm/gitk-update	2020-10-03 10:06:27 -07:00
gitweb	…
mergetools	Merge branch 'pd/mergetool-nvimdiff'	2020-11-21 15:14:39 -08:00
negotiator	…
perl	Merge branch 'jk/perl-warning'	2020-11-09 14:06:25 -08:00
po	Merge branch 'master' of github.com:Softcatala/git-po	2020-10-18 09:56:33 +08:00
ppc	…
refs	Merge branch 'hn/refs-trace-backend'	2020-09-22 12:36:28 -07:00
sha1collisiondetection@855827c583	…
sha1dc	…
sha256	…
t	init: provide useful advice about init.defaultBranch	2020-12-13 15:53:51 -08:00
templates	hook: add sample template for push-to-checkout	2020-10-16 08:47:02 -07:00
trace2	…
vcs-svn	…
xdiff	diff: add -I<regex> that ignores matching changes	2020-10-20 12:53:26 -07:00
.cirrus.yml	…
.clang-format	…
.editorconfig	…
.gitattributes	…
.gitignore	Merge branch 'ds/maintenance-part-3'	2020-11-18 13:32:53 -08:00
.gitmodules	…
.mailmap	…
.travis.yml	…
.tsan-suppressions	…
CODE_OF_CONDUCT.md	…
COPYING	…
GIT-VERSION-GEN	Git 2.29.2	2020-10-29 14:24:09 -07:00
INSTALL	…
LGPL-2.1	…
Makefile	Merge branch 'en/strmap'	2020-11-21 15:14:38 -08:00
README.md	…
RelNotes	Git 2.29.2	2020-10-29 14:24:09 -07:00
abspath.c	…
aclocal.m4	…
add-interactive.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
add-interactive.h	…
add-patch.c	Merge branch 'dl/checkout-p-merge-base'	2020-10-27 15:09:51 -07:00
advice.c	push: parse and set flag for "--force-if-includes"	2020-10-03 09:59:19 -07:00
advice.h	push: parse and set flag for "--force-if-includes"	2020-10-03 09:59:19 -07:00
alias.c	…
alias.h	…
alloc.c	…
alloc.h	…
apply.c	apply: when -R, also reverse list of sections	2020-10-20 15:21:41 -07:00
apply.h	…
archive-tar.c	archive: support compression levels beyond 9	2020-11-09 11:25:45 -08:00
archive-zip.c	archive: read short blobs in archive.c::write_archive_entry()	2020-09-19 15:56:05 -07:00
archive.c	archive: support compression levels beyond 9	2020-11-09 11:25:45 -08:00
archive.h	archive: support compression levels beyond 9	2020-11-09 11:25:45 -08:00
attr.c	Use new HASHMAP_INIT macro to simplify hashmap initialization	2020-11-11 12:55:27 -08:00
attr.h	…
banned.h	…
base85.c	…
bisect.c	bisect: clear flags in passed repository	2020-10-31 10:46:34 -07:00
bisect.h	…
blame.c	Merge branch 'en/strmap'	2020-11-21 15:14:38 -08:00
blame.h	blame: simplify 'setup_blame_bloom_data' interface	2020-11-01 15:54:15 -08:00
blob.c	…
blob.h	…
bloom.c	Use new HASHMAP_INIT macro to simplify hashmap initialization	2020-11-11 12:55:27 -08:00
bloom.h	bloom: encode out-of-bounds filters as non-empty	2020-09-17 21:55:50 -07:00
branch.c	…
branch.h	…
builtin.h	Merge branch 'ds/maintenance-part-3'	2020-11-18 13:32:53 -08:00
bulk-checkin.c	…
bulk-checkin.h	…
bundle.c	…
bundle.h	…
cache-tree.c	…
cache-tree.h	…
cache.h	builtin/clone: avoid failure with GIT_DEFAULT_HASH	2020-09-22 09:22:32 -07:00
chdir-notify.c	…
chdir-notify.h	…
check-builtins.sh	…
check_bindir	…
checkout.c	…
checkout.h	…
color.c	…
color.h	…
column.c	…
column.h	…
combine-diff.c	Merge branch 'jk/diff-cc-oidfind-fix'	2020-10-05 14:01:55 -07:00
command-list.txt	for-each-repo: run subcommands on configured repos	2020-09-25 10:59:44 -07:00
commit-graph.c	Merge branch 'ds/commit-graph-merging-fix'	2020-11-02 13:17:39 -08:00
commit-graph.h	Merge branch 'tb/bloom-improvements'	2020-09-29 14:01:20 -07:00
commit-reach.c	commit-reach: fix in_merge_bases_many bug	2020-10-02 10:26:31 -07:00
commit-reach.h	…
commit-slab-decl.h	…
commit-slab-impl.h	…
commit-slab.h	…
commit.c	Documentation: stylistically normalize references to Signed-off-by:	2020-10-20 11:57:40 -07:00
commit.h	drop unused argc parameters	2020-09-30 12:53:47 -07:00
common-main.c	…
config.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
config.h	…
config.mak.dev	Merge branch 'jc/sparse-error-for-developer-build'	2020-11-18 13:32:54 -08:00
config.mak.in	…
config.mak.uname	config.mak.uname: remove unused NEEDS_SSL_WITH_CURL flag	2020-11-11 12:46:08 -08:00
configure.ac	…
connect.c	…
connect.h	…
connected.c	…
connected.h	…
convert.c	convert: drop unused crlf_action from check_global_conv_flags_eol()	2020-09-30 12:53:47 -07:00
convert.h	…
copy.c	…
credential.c	credential: treat CR/LF as line endings in the credential protocol	2020-10-03 10:41:03 -07:00
credential.h	…
csum-file.c	…
csum-file.h	…
ctype.c	…
daemon.c	…
date.c	…
decorate.c	…
decorate.h	…
delta-islands.c	…
delta-islands.h	…
delta.h	…
detect-compiler	…
diff-delta.c	…
diff-lib.c	Merge branch 'nk/diff-files-vs-fsmonitor'	2020-11-09 14:06:25 -08:00
diff-no-index.c	…
diff.c	Merge branch 'en/strmap'	2020-11-21 15:14:38 -08:00
diff.h	Merge branch 'mk/diff-ignore-regex'	2020-11-02 13:17:44 -08:00
diffcore-break.c	…
diffcore-delta.c	…
diffcore-order.c	…
diffcore-pickaxe.c	…
diffcore-rename.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
diffcore.h	…
dir-iterator.c	…
dir-iterator.h	…
dir.c	Merge branch 'en/strmap'	2020-11-21 15:14:38 -08:00
dir.h	…
editor.c	…
entry.c	…
environment.c	…
exec-cmd.c	…
exec-cmd.h	…
fetch-negotiator.c	…
fetch-negotiator.h	…
fetch-pack.c	…
fetch-pack.h	…
fmt-merge-msg.c	fmt-merge-msg: also suppress "into main" by default	2020-10-23 08:57:39 -07:00
fmt-merge-msg.h	…
fsck.c	…
fsck.h	…
fsmonitor.c	…
fsmonitor.h	…
fuzz-commit-graph.c	…
fuzz-pack-headers.c	…
fuzz-pack-idx.c	…
generate-cmdlist.sh	…
generate-configlist.sh	…
gettext.c	…
gettext.h	…
git-add--interactive.perl	Merge branch 'dl/checkout-p-merge-base'	2020-10-27 15:09:51 -07:00
git-archimport.perl	…
git-bisect.sh	Merge branch 'mr/bisect-in-c-3'	2020-11-09 14:06:25 -08:00
git-compat-util.h	Merge branch 'jk/report-fn-typedef'	2020-11-02 13:17:42 -08: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	mergetool: avoid letting `list_tool_variants` break user-defined setups	2020-11-11 13:00:11 -08:00
git-mergetool.sh	…
git-p4.py	Merge branch 'js/p4-default-branch'	2020-11-11 13:18:38 -08:00
git-parse-remote.sh	…
git-quiltimport.sh	…
git-rebase--preserve-merges.sh	…
git-request-pull.sh	…
git-send-email.perl	…
git-sh-i18n.sh	…
git-sh-setup.sh	…
git-submodule.sh	Merge branch 'td/submodule-update-quiet'	2020-10-05 14:01:53 -07:00
git-svn.perl	perl: check for perl warnings while running tests	2020-10-21 23:11:48 -07:00
git-web--browse.sh	…
git.c	Merge branch 'ds/maintenance-part-3'	2020-11-18 13:32:53 -08:00
git.rc	…
gpg-interface.c	…
gpg-interface.h	…
graph.c	…
graph.h	…
grep.c	…
grep.h	…
hash.h	…
hashmap.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
hashmap.h	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
help.c	help: do not expect built-in commands to be hardlinked	2020-10-07 15:25:10 -07:00
help.h	help: do not expect built-in commands to be hardlinked	2020-10-07 15:25:10 -07:00
hex.c	…
http-backend.c	…
http-fetch.c	…
http-push.c	…
http-walker.c	…
http.c	…
http.h	…
ident.c	…
imap-send.c	…
iterator.h	…
json-writer.c	…
json-writer.h	…
khash.h	…
kwset.c	…
kwset.h	…
levenshtein.c	…
levenshtein.h	…
line-log.c	line-log: handle deref_tag() returning NULL	2020-10-12 12:25:14 -07:00
line-log.h	…
line-range.c	…
line-range.h	…
linear-assignment.c	…
linear-assignment.h	…
list-objects-filter-options.c	fetch: do not override partial clone filter	2020-09-28 16:11:59 -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	format-patch: make output filename configurable	2020-11-09 17:44:41 -08:00
log-tree.h	format-patch: make output filename configurable	2020-11-09 17:44:41 -08:00
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-ort-wrappers.c	merge-ort-wrappers: new convience wrappers to mimic the old merge API	2020-10-26 22:36:14 -07:00
merge-ort-wrappers.h	merge-ort-wrappers: new convience wrappers to mimic the old merge API	2020-10-26 22:36:14 -07:00
merge-ort.c	merge-ort: barebones API of new merge strategy with empty implementation	2020-10-26 22:36:10 -07:00
merge-ort.h	merge-ort: barebones API of new merge strategy with empty implementation	2020-10-26 22:36:10 -07:00
merge-recursive.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
merge-recursive.h	…
merge.c	…
mergesort.c	…
mergesort.h	…
midx.c	Merge branch 'ds/maintenance-part-2'	2020-10-27 15:09:47 -07:00
midx.h	…
name-hash.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08: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	Merge branch 'en/strmap'	2020-11-21 15:14:38 -08:00
object.h	object: allow clear_commit_marks_all to handle any repo	2020-10-31 10:46:34 -07:00
oid-array.c	…
oid-array.h	…
oidmap.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
oidmap.h	…
oidset.c	blame: silently ignore invalid ignore file objects	2020-11-10 13:05:06 -08:00
oidset.h	blame: validate and peel the object names on the ignore list	2020-09-24 22:20:58 -07: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-write: use hashwrite_be32() instead of double-buffering array	2020-11-01 15:52:51 -08:00
pack.h	…
packfile.c	Merge branch 'mt/delta-base-cache-races'	2020-10-04 12:49:15 -07:00
packfile.h	…
pager.c	…
parse-options-cb.c	assert PARSE_OPT_NONEG in parse-options callbacks	2020-09-30 12:53:47 -07:00
parse-options.c	…
parse-options.h	…
patch-delta.c	…
patch-ids.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
patch-ids.h	…
path.c	…
path.h	…
pathspec.c	…
pathspec.h	…
pkt-line.c	sideband: diagnose more sideband anomalies	2020-10-29 09:23:29 -07:00
pkt-line.h	…
preload-index.c	…
pretty.c	…
pretty.h	…
prio-queue.c	…
prio-queue.h	…
progress.c	…
progress.h	…
promisor-remote.c	promisor-remote: remove unused variable	2020-09-21 22:32:49 -07:00
promisor-remote.h	promisor-remote: remove unused variable	2020-09-21 22:32:49 -07:00
prompt.c	…
prompt.h	…
protocol.c	protocol: re-enable v2 protocol by default	2020-09-25 11:40:42 -07:00
protocol.h	…
prune-packed.c	…
prune-packed.h	…
quote.c	…
quote.h	…
range-diff.c	Use new HASHMAP_INIT macro to simplify hashmap initialization	2020-11-11 12:55:27 -08:00
range-diff.h	…
reachable.c	…
reachable.h	…
read-cache.c	…
rebase-interactive.c	…
rebase-interactive.h	…
rebase.c	…
rebase.h	…
ref-filter.c	Merge branch 'en/strmap'	2020-11-21 15:14:38 -08:00
ref-filter.h	ref-filter: make internal reachable-filter API more precise	2020-09-18 15:41:55 -07:00
reflog-walk.c	…
reflog-walk.h	…
refs.c	init: provide useful advice about init.defaultBranch	2020-12-13 15:53:51 -08:00
refs.h	get_default_branch_name(): prepare for showing some advice	2020-12-13 15:53:50 -08:00
refspec.c	Merge branch 'sb/clone-origin'	2020-10-27 15:09:50 -07:00
refspec.h	Merge branch 'sb/clone-origin'	2020-10-27 15:09:50 -07:00
remote-curl.c	push: parse and set flag for "--force-if-includes"	2020-10-03 09:59:19 -07:00
remote.c	get_default_branch_name(): prepare for showing some advice	2020-12-13 15:53:50 -08:00
remote.h	Merge branch 'sk/force-if-includes'	2020-10-27 15:09:49 -07:00
replace-object.c	…
replace-object.h	…
repo-settings.c	Merge branch 'ds/maintenance-part-2'	2020-10-27 15:09:47 -07:00
repository.c	…
repository.h	Merge branch 'ds/maintenance-part-2'	2020-10-27 15:09:47 -07:00
rerere.c	…
rerere.h	…
reset.c	…
reset.h	…
resolve-undo.c	…
resolve-undo.h	…
revision.c	Use new HASHMAP_INIT macro to simplify hashmap initialization	2020-11-11 12:55:27 -08:00
revision.h	format-patch: make output filename configurable	2020-11-09 17:44:41 -08:00
run-command.c	maintenance: optionally skip --auto process	2020-09-25 10:59:44 -07:00
run-command.h	…
send-pack.c	Merge branch 'sk/force-if-includes'	2020-10-27 15:09:49 -07:00
send-pack.h	…
sequencer.c	Merge branch 'en/strmap'	2020-11-21 15:14:38 -08:00
sequencer.h	Merge branch 'en/merge-ort-api-null-impl'	2020-11-18 13:32:53 -08:00
serve.c	…
serve.h	…
server-info.c	…
setup.c	…
sh-i18n--envsubst.c	…
sha1-file.c	…
sha1-lookup.c	…
sha1-lookup.h	…
sha1-name.c	…
sha1dc_git.c	…
sha1dc_git.h	…
shallow.c	…
shallow.h	…
shell.c	…
shortlog.h	shortlog: allow multiple groups to be specified	2020-09-27 12:21:05 -07:00
sideband.c	Merge branch 'jk/sideband-more-error-checking'	2020-11-09 14:06:29 -08:00
sideband.h	sideband: diagnose more sideband anomalies	2020-10-29 09:23:29 -07:00
sigchain.c	…
sigchain.h	…
split-index.c	…
split-index.h	…
stable-qsort.c	…
strbuf.c	…
strbuf.h	…
streaming.c	…
streaming.h	…
string-list.c	…
string-list.h	…
strmap.c	strmap: take advantage of FLEXPTR_ALLOC_STR when relevant	2020-11-11 12:55:27 -08:00
strmap.h	strmap: take advantage of FLEXPTR_ALLOC_STR when relevant	2020-11-11 12:55:27 -08:00
strvec.c	…
strvec.h	…
sub-process.c	…
sub-process.h	…
submodule-config.c	hashmap: provide deallocation function names	2020-11-02 12:15:50 -08:00
submodule-config.h	…
submodule.c	Merge branch 'so/combine-diff-simplify'	2020-10-05 14:01:51 -07:00
submodule.h	…
symlinks.c	…
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	Merge branch 'jk/shortlog-group-by-trailer'	2020-10-04 12:49:14 -07:00
trailer.h	trailer: add interface for iterating over commit trailers	2020-09-27 12:21:05 -07:00
transport-helper.c	push: parse and set flag for "--force-if-includes"	2020-10-03 09:59:19 -07:00
transport-internal.h	…
transport.c	push: parse and set flag for "--force-if-includes"	2020-10-03 09:59:19 -07:00
transport.h	push: parse and set flag for "--force-if-includes"	2020-10-03 09:59:19 -07: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	…
unpack-trees.h	…
upload-pack.c	upload-pack: allow stateless client EOF just prior to haves	2020-10-30 21:18:10 -07:00
upload-pack.h	…
url.c	…
url.h	…
urlmatch.c	…
urlmatch.h	…
usage.c	usage: define a type for a reporting function	2020-10-16 08:33:58 -07:00
userdiff.c	Merge branch 've/userdiff-bash'	2020-11-02 13:17:46 -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 'ma/worktree-cleanups'	2020-10-05 14:01:52 -07:00
worktree.h	Merge branch 'ma/worktree-cleanups'	2020-10-05 14:01:52 -07:00
wrap-for-bin.sh	…
wrapper.c	…
write-or-die.c	…
ws.c	…
wt-status.c	Merge branch 'ma/worktree-cleanups'	2020-10-05 14:01:52 -07:00
wt-status.h	wt-status: introduce wt_status_state_free_buffers()	2020-09-27 14:21:47 -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