Thread (12 messages) 12 messages, 2 authors, 2020-05-02
STALE2275d

[PATCH v4 3/4] gitfaq: shallow cloning a repository

From: Shourya Shukla <hidden>
Date: 2020-04-29 09:38:43
Subsystem: documentation, the rest · Maintainers: Jonathan Corbet, Linus Torvalds

Add issue in 'Common issue' section which covers issues with cloning
large repositories. Use partial cloning to selectively clone the
repository.

Signed-off-by: Shourya Shukla <redacted>
---
I wanted to ask why is there no mention of partial cloning in
the 'git-clone' documentation? Is it because it is an experimental
feature?

 Documentation/gitfaq.txt | 10 ++++++++++
 1 file changed, 10 insertions(+)
diff --git a/Documentation/gitfaq.txt b/Documentation/gitfaq.txt
index 7d294306f9..6f32846e3d 100644
--- a/Documentation/gitfaq.txt
+++ b/Documentation/gitfaq.txt
@@ -243,6 +243,16 @@ I want to change the remote of my repository. How do I do that?::
 One can list the remotes of a repository using `git remote -v` command.
 The default name of a remote is 'origin'.
 
+[[shallow-cloning]]
+The repository I am trying to clone is too big. Is there an alternative
+way of cloning it in lesser space?::
+	A good way to save up space when cloning a repository is
+	by using `partial clones`. A partial clone will clone the
+	full history of the repository but will skip out the entities
+	specified by the `--filter` option one uses in `git clone`.
+	Any entity which has not been cloned to save space can be cloned
+	on-demand. See linkgit:partial-clone[1].
+
 Hooks
 -----
 
-- 
2.26.2
Keyboard shortcuts
hback out one level
jnext message in thread
kprevious message in thread
ldrill in
Escclose help / fold thread tree
?toggle this help