Josh Steadmon f05da2b48b clone, submodule: pass partial clone filters to submodules ... When cloning a repo with a --filter and with --recurse-submodules enabled, the partial clone filter only applies to the top-level repo. This can lead to unexpected bandwidth and disk usage for projects which include large submodules. For example, a user might wish to make a partial clone of Gerrit and would run: `git clone --recurse-submodules --filter=blob:5k https://gerrit.googlesource.com/gerrit`. However, only the superproject would be a partial clone; all the submodules would have all blobs downloaded regardless of their size. With this change, the same filter can also be applied to submodules, meaning the expected bandwidth and disk savings apply consistently. To avoid changing default behavior, add a new clone flag, `--also-filter-submodules`. When this is set along with `--filter` and `--recurse-submodules`, the filter spec is passed along to git-submodule and git-submodule--helper, such that submodule clones also have the filter applied. This applies the same filter to the superproject and all submodules. Users who need to customize the filter per-submodule would need to clone with `--no-recurse-submodules` and then manually initialize each submodule with the proper filter. Applying filters to submodules should be safe thanks to Jonathan Tan's recent work [1, 2, 3] eliminating the use of alternates as a method of accessing submodule objects, so any submodule object access now triggers a lazy fetch from the submodule's promisor remote if the accessed object is missing. This patch is a reworked version of [4], which was created prior to Jonathan Tan's work. [1]: 8721e2e (Merge branch 'jt/partial-clone-submodule-1', 2021-07-16) [2]: 11e5d0a (Merge branch 'jt/grep-wo-submodule-odb-as-alternate', 2021-09-20) [3]: 162a13b (Merge branch 'jt/no-abuse-alternate-odb-for-submodules', 2021-10-25) [4]: https://lore.kernel.org/git/52bf9d45b8e2b72ff32aa773f2415bf7b2b86da2.1563322192.git.steadmon@google.com/ Signed-off-by: Josh Steadmon <steadmon@google.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>		2022-02-09 15:38:36 -08:00
..
RelNotes	Last minute fixes before -rc1	2022-01-12 16:27:08 -08:00
config	clone, submodule: pass partial clone filters to submodules	2022-02-09 15:38:36 -08:00
howto	Document how we do embargoed releases	2021-03-27 15:13:12 -07:00
technical	Merge branch 'en/zdiff3'	2021-12-15 09:39:47 -08:00
.gitattributes	…
.gitignore	doc lint: make "lint-docs" non-.PHONY	2021-10-15 10:29:11 -07:00
CodingGuidelines	CodingGuidelines: document which output goes to stdout vs. stderr	2021-12-04 17:26:41 -08:00
Makefile	Merge branch 'ab/fix-make-lint-docs'	2021-10-29 15:43:13 -07:00
MyFirstContribution.txt	Merge branch 'jc/tutorial-format-patch-base'	2021-11-29 15:41:46 -08:00
MyFirstObjectWalk.txt	docs: add headers in MyFirstObjectWalk	2021-10-29 13:02:51 -07:00
SubmittingPatches	Merge branch 'jc/doc-submitting-patches-choice-of-base'	2022-01-10 11:52:55 -08:00
asciidoc.conf	…
asciidoctor-extensions.rb	…
blame-options.txt	Merge branch 'bs/doc-blame-color-lines'	2021-10-18 15:47:58 -07:00
build-docdep.perl	…
cat-texi.perl	…
cmd-list.perl	…
config.txt	Merge branch 're/color-default-reset'	2021-12-15 09:39:53 -08:00
date-formats.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
diff-format.txt	Documentation/diff-format: state in which cases porcelain status is T	2021-10-04 13:07:18 -07:00
diff-generate-patch.txt	doc: point to diff attribute in patch format docs	2021-04-28 13:34:44 +09:00
diff-options.txt	Merge branch 'jn/log-m-does-not-imply-p'	2021-08-11 12:36:18 -07:00
doc-diff	…
docbook-xsl.css	…
docbook.xsl	…
everyday.txto	…
fetch-options.txt	fetch: document the --negotiate-only option	2021-06-30 14:57:22 -07:00
fix-texi.perl	…
git-add.txt	add: implement the --sparse option	2021-09-28 10:31:02 -07:00
git-am.txt	am: support --allow-empty to record specific empty patches	2021-12-15 17:04:19 -08:00
git-annotate.txt	…
git-apply.txt	git-apply: add --allow-empty flag	2021-12-13 14:30:25 -08:00
git-archimport.txt	doc: split placeholders as individual tokens	2021-10-28 09:57:09 -07:00
git-archive.txt	archive: describe compression level option	2021-10-25 10:08:23 -07:00
git-bisect-lk2009.txt	…
git-bisect.txt	…
git-blame.txt	Merge branch 'bs/doc-blame-color-lines'	2021-10-18 15:47:58 -07:00
git-branch.txt	Merge branch 'js/branch-track-inherit'	2022-01-20 15:25:38 -08:00
git-bugreport.txt	Documentation: fix default directory of git bugreport -o	2021-09-07 14:25:13 -07:00
git-bundle.txt	git-bundle.txt: add missing words and punctuation	2021-10-27 17:06:12 -07:00
git-cat-file.txt	cat-file: disable refs/replace with --batch-all-objects	2021-10-08 15:45:14 -07:00
git-check-attr.txt	…
git-check-ignore.txt	…
git-check-mailmap.txt	…
git-check-ref-format.txt	…
git-checkout-index.txt	…
git-checkout.txt	Merge branch 'js/branch-track-inherit'	2022-01-20 15:25:38 -08:00
git-cherry-pick.txt	doc: express grammar placeholders between angle brackets	2021-11-09 09:39:11 -08:00
git-cherry.txt	…
git-citool.txt	…
git-clean.txt	…
git-clone.txt	clone, submodule: pass partial clone filters to submodules	2022-02-09 15:38:36 -08:00
git-column.txt	column: fix parsing of the '--nl' option	2021-08-26 14:36:27 -07:00
git-commit-graph.txt	…
git-commit-tree.txt	…
git-commit.txt	Document positive variant of commit and merge option "--no-verify"	2021-10-29 11:22:56 -07:00
git-config.txt	doc: express grammar placeholders between angle brackets	2021-11-09 09:39:11 -08:00
git-count-objects.txt	…
git-credential-cache--daemon.txt	…
git-credential-cache.txt	…
git-credential-store.txt	…
git-credential.txt	doc: fix git credential synopsis	2021-10-28 09:57:09 -07:00
git-cvsexportcommit.txt	doc: express grammar placeholders between angle brackets	2021-11-09 09:39:11 -08:00
git-cvsimport.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
git-cvsserver.txt	Documentation: cleanup git-cvsserver	2021-09-16 20:47:48 -07:00
git-daemon.txt	…
git-describe.txt	describe-doc: clarify default length of abbreviation	2021-05-17 15:56:29 +09:00
git-diff-files.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
git-diff-index.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
git-diff-tree.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
git-diff.txt	git-diff: fix missing --merge-base docs	2021-07-12 13:55:29 -07:00
git-difftool.txt	difftool.c: learn a new way start at specified file	2021-02-22 13:35:49 -08:00
git-fast-export.txt	…
git-fast-import.txt	…
git-fetch-pack.txt	…
git-fetch.txt	Documentation: render special characters correctly	2021-07-30 09:08:12 -07:00
git-filter-branch.txt	…
git-fmt-merge-msg.txt	merge: allow to pretend a merge is made into a different branch	2021-12-20 14:55:02 -08:00
git-for-each-ref.txt	ref-filter: --format=%(raw) support --perl	2021-07-26 12:01:25 -07:00
git-for-each-repo.txt	…
git-format-patch.txt	doc: git-format-patch: describe the option --always	2021-12-15 17:04:15 -08:00
git-fsck-objects.txt	…
git-fsck.txt	doc: use three dots for indicating repetition instead of star	2021-11-09 09:39:11 -08:00
git-gc.txt	docs: clarify that refs/notes/ do not keep the attached objects alive	2021-02-10 23:43:55 -08:00
git-get-tar-commit-id.txt	…
git-grep.txt	docs: fix linting issues due to incorrect relative section order	2021-04-10 23:36:34 -07:00
git-gui.txt	doc: express grammar placeholders between angle brackets	2021-11-09 09:39:11 -08:00
git-hash-object.txt	…
git-help.txt	Merge branch 'ja/doc-cleanup'	2021-12-10 14:35:03 -08:00
git-http-backend.txt	docs/http-backend: mention v2 protocol	2021-09-10 15:34:59 -07:00
git-http-fetch.txt	doc: uniformize <URL> placeholders' case	2021-11-09 09:39:11 -08:00
git-http-push.txt	doc: git-http-push: describe the refs as pattern pairs	2021-11-09 09:39:11 -08:00
git-imap-send.txt	…
git-index-pack.txt	index-pack: add --progress-title option	2021-09-07 10:59:23 -07:00
git-init-db.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
git-init.txt	init doc: --shared=0xxx does not give umask but perm bits	2021-11-09 09:39:11 -08:00
git-instaweb.txt	…
git-interpret-trailers.txt	trailer: add new .cmd config option	2021-05-04 12:09:43 +09:00
git-log.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
git-ls-files.txt	ls-files: add --sparse option	2021-12-22 11:42:40 -08:00
git-ls-remote.txt	…
git-ls-tree.txt	…
git-mailinfo.txt	mailinfo: allow stripping quoted CR without warning	2021-05-10 15:06:22 +09:00
git-mailsplit.txt	…
git-maintenance.txt	maintenance: add support for systemd timers on Linux	2021-09-07 10:57:04 -07:00
git-merge-base.txt	…
git-merge-file.txt	update documentation for new zdiff3 conflictStyle	2021-12-01 14:45:59 -08:00
git-merge-index.txt	doc: use three dots for indicating repetition instead of star	2021-11-09 09:39:11 -08:00
git-merge-one-file.txt	…
git-merge-tree.txt	…
git-merge.txt	Merge branch 'jc/merge-detached-head-name'	2022-01-05 14:01:30 -08:00
git-mergetool--lib.txt	mergetool: break setup_tool out into separate initialization function	2021-02-09 14:09:16 -08:00
git-mergetool.txt	doc: describe mergetool configuration in git-mergetool(1)	2021-03-13 15:34:32 -08:00
git-mktag.txt	docs: fix linting issues due to incorrect relative section order	2021-04-10 23:36:34 -07:00
git-mktree.txt	…
git-multi-pack-index.txt	git-multi-pack-index.txt: change "folder" to "directory"	2021-10-25 11:06:56 -07:00
git-mv.txt	…
git-name-rev.txt	…
git-notes.txt	…
git-p4.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
git-pack-objects.txt	doc: express grammar placeholders between angle brackets	2021-11-09 09:39:11 -08:00
git-pack-redundant.txt	doc: express grammar placeholders between angle brackets	2021-11-09 09:39:11 -08:00
git-pack-refs.txt	…
git-patch-id.txt	…
git-prune-packed.txt	…
git-prune.txt	…
git-pull.txt	Merge branch 'js/retire-preserve-merges'	2021-10-18 15:47:56 -07:00
git-push.txt	Merge branch 'ds/gender-neutral-doc'	2021-07-16 17:42:53 -07:00
git-quiltimport.txt	…
git-range-diff.txt	Merge branch 'js/range-diff-one-side-only'	2021-02-17 17:21:41 -08:00
git-read-tree.txt	Documentation: call out commands that nuke untracked files/directories	2021-09-27 13:38:37 -07:00
git-rebase.txt	update documentation for new zdiff3 conflictStyle	2021-12-01 14:45:59 -08:00
git-receive-pack.txt	upload-pack: document and rename --advertise-refs	2021-08-05 08:59:37 -07:00
git-reflog.txt	doc: express grammar placeholders between angle brackets	2021-11-09 09:39:11 -08:00
git-remote-ext.txt	…
git-remote-fd.txt	…
git-remote-helpers.txto	…
git-remote.txt	doc: uniformize <URL> placeholders' case	2021-11-09 09:39:11 -08:00
git-repack.txt	repack: make '--quiet' disable progress	2021-12-20 11:59:17 -08:00
git-replace.txt	…
git-request-pull.txt	doc: uniformize <URL> placeholders' case	2021-11-09 09:39:11 -08:00
git-rerere.txt	…
git-reset.txt	Documentation: call out commands that nuke untracked files/directories	2021-09-27 13:38:37 -07:00
git-restore.txt	update documentation for new zdiff3 conflictStyle	2021-12-01 14:45:59 -08:00
git-rev-list.txt	docs/rev-list: add some examples of --disk-usage	2021-02-17 16:25:29 -08:00
git-rev-parse.txt	…
git-revert.txt	…
git-rm.txt	rm: add --sparse option	2021-09-28 10:31:02 -07:00
git-send-email.txt	send-email docs: add format-patch options	2021-10-28 09:06:15 -07:00
git-send-pack.txt	send-pack: properly use parse_options() API for usage string	2021-09-12 18:57:30 -07:00
git-sh-i18n--envsubst.txt	…
git-sh-i18n.txt	…
git-sh-setup.txt	…
git-shell.txt	…
git-shortlog.txt	doc: use only hyphens as word separators in placeholders	2021-11-09 09:39:11 -08:00
git-show-branch.txt	…
git-show-index.txt	…
git-show-ref.txt	…
git-show.txt	…
git-sparse-checkout.txt	Merge branch 'en/sparse-checkout-set'	2022-01-03 16:24:15 -08:00
git-stage.txt	doc: express grammar placeholders between angle brackets	2021-11-09 09:39:11 -08:00
git-stash.txt	stash: implement '--staged' option for 'push' and 'save'	2021-10-18 13:09:21 -07:00
git-status.txt	status: print stash info with --porcelain=v2 --show-stash	2021-10-21 17:24:30 -07:00
git-stripspace.txt	…
git-submodule.txt	clone, submodule: pass partial clone filters to submodules	2022-02-09 15:38:36 -08:00
git-svn.txt	Merge branch 'ja/doc-cleanup'	2021-12-10 14:35:03 -08:00
git-switch.txt	Merge branch 'js/branch-track-inherit'	2022-01-10 11:52:54 -08:00
git-symbolic-ref.txt	…
git-tag.txt	Documentation: typofix --column description	2021-02-19 19:36:47 -08:00
git-tools.txt	…
git-unpack-file.txt	…
git-unpack-objects.txt	…
git-update-index.txt	…
git-update-ref.txt	…
git-update-server-info.txt	…
git-upload-archive.txt	…
git-upload-pack.txt	Merge branch 'jk/http-server-protocol-versions'	2021-09-23 13:44:47 -07:00
git-var.txt	var: add GIT_DEFAULT_BRANCH variable	2021-11-03 13:25:36 -07:00
git-verify-commit.txt	…
git-verify-pack.txt	…
git-verify-tag.txt	…
git-version.txt	documentation: add documentation for 'git version'	2021-09-14 10:05:40 -07:00
git-web--browse.txt	doc: split placeholders as individual tokens	2021-10-28 09:57:09 -07:00
git-whatchanged.txt	…
git-worktree.txt	git-worktree.txt: add missing `-v` to synopsis for `worktree list`	2021-12-04 23:27:25 -08:00
git-write-tree.txt	…
git.txt	Merge branch 'if/redact-packfile-uri'	2021-12-10 14:35:04 -08:00
gitattributes.txt	docs: document symlink restrictions for dot-files	2021-05-04 11:52:03 +09:00
gitcli.txt	…
gitcore-tutorial.txt	…
gitcredentials.txt	doc: uniformize <URL> placeholders' case	2021-11-09 09:39:11 -08:00
gitcvs-migration.txt	…
gitdiffcore.txt	Merge branch 'en/ort-perf-batch-8'	2021-03-22 14:00:24 -07:00
giteveryday.txt	…
gitfaq.txt	Update docs for change of default merge backend	2021-08-05 15:35:02 -07:00
gitglossary.txt	…
githooks.txt	githooks.txt: clarify documentation on reference-transaction hook	2021-03-01 09:02:01 -08:00
gitignore.txt	gitignore.txt: change "folder" to "directory"	2021-10-25 11:06:56 -07:00
gitk.txt	…
gitmailmap.txt	docs: document symlink restrictions for dot-files	2021-05-04 11:52:03 +09:00
gitmodules.txt	docs: document symlink restrictions for dot-files	2021-05-04 11:52:03 +09:00
gitnamespaces.txt	doc lint: lint and fix missing "GIT" end sections	2021-04-10 23:36:34 -07:00
gitremote-helpers.txt	…
gitrepository-layout.txt	…
gitrevisions.txt	…
gitsubmodules.txt	doc: uniformize <URL> placeholders' case	2021-11-09 09:39:11 -08:00
gittutorial-2.txt	…
gittutorial.txt	Documentation: render special characters correctly	2021-07-30 09:08:12 -07:00
gitweb.conf.txt	gitweb: add "e-mail privacy" feature to redact e-mail addresses	2021-04-08 15:54:26 -07:00
gitweb.txt	gitweb.txt: change "folder" to "directory"	2021-10-25 11:06:57 -07:00
gitworkflows.txt	doc: uniformize <URL> placeholders' case	2021-11-09 09:39:11 -08:00
glossary-content.txt	docs: improve fast-forward in glossary content	2021-05-19 21:11:49 +09:00
howto-index.sh	…
i18n.txt	i18n.txt: camel case and monospace "i18n.commitEncoding"	2021-02-24 15:21:25 -08:00
install-doc-quick.sh	…
install-webdoc.sh	…
line-range-format.txt	…
line-range-options.txt	…
lint-gitlink.perl	doc lint: make "lint-docs" non-.PHONY	2021-10-15 10:29:11 -07:00
lint-man-end-blurb.perl	doc lint: emit errors on STDERR	2021-10-15 10:16:57 -07:00
lint-man-section-order.perl	doc lint: emit errors on STDERR	2021-10-15 10:16:57 -07:00
manpage-base-url.xsl.in	…
manpage-bold-literal.xsl	…
manpage-normal.xsl	…
manpage-quote-apos.xsl	…
manpage.xsl	…
merge-options.txt	Document positive variant of commit and merge option "--no-verify"	2021-10-29 11:22:56 -07:00
merge-strategies.txt	Update docs for change of default merge backend	2021-08-05 15:35:02 -07:00
object-format-disclaimer.txt	…
pretty-formats.txt	Merge branch 'es/pretty-describe-more'	2021-12-15 09:39:48 -08:00
pretty-options.txt	log: document --encoding behavior on iconv() failure	2021-10-29 14:35:59 -07:00
pull-fetch-param.txt	…
ref-reachability-filters.txt	…
rev-list-description.txt	…
rev-list-options.txt	Merge branch 'jk/strbuf-addftime-seconds-since-epoch'	2021-12-10 14:35:07 -08:00
revisions.txt	revisions(7): clarify that most commands take a single revision range	2021-05-18 10:08:03 +09:00
sequencer.txt	…
signoff-option.txt	…
texi.xsl	…
trace2-target-values.txt	…
transfer-data-leaks.txt	…
urls-remotes.txt	doc: uniformize <URL> placeholders' case	2021-11-09 09:39:11 -08:00
urls.txt	…
user-manual.conf	…
user-manual.txt	Update docs for change of default merge backend	2021-08-05 15:35:02 -07:00