git/list[1] front-page[2] threads[3] people[4] search[5] about
 

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

From
Shourya Shukla <shouryashukla.oo@gmail.com>
Date
May 4, 2020, 05:42 UTC
Message-ID
<20200504054223.11125-3-shouryashukla.oo@gmail.com>
In-Reply-To
<20200504054223.11125-1-shouryashukla.oo@gmail.com>

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 <shouryashukla.oo@gmail.com>
---
I fixed the heading of this section and improved it overall though,
as pointed out by Junio, there is a bit confusion as to what URL I
am trying to point to:
https://git-scm.com/docs/partial-clone
This is the URL I want to point to.
 Documentation/gitfaq.txt | 11 +++++++++++
 1 file changed, 11 insertions(+)
diff --git a/Documentation/gitfaq.txt b/Documentation/gitfaq.txt
index 875cfa0acd..5dfbb32089 100644
--- a/Documentation/gitfaq.txt
+++ b/Documentation/gitfaq.txt
@@ -244,6 +244,17 @@ 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'.
 
+[[partial-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 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 (hence this
+	presumes that the user has an always-on network connection to the
+	original repository).  See linkgit:partial-clone[1].
+
 Hooks
 -----
 
-- 
2.26.2
Previous: Shourya ShuklaNext: Elijah Newren
Message 3 of 7 in “gitfaq: files in .gitignore are tracked”
  1. 1/4 gitfaq: files in .gitignore are trackedShourya Shukla, May 4, 2020
  2. 2/4 gitfaq: changing the remote of a repositoryShourya Shukla, May 4, 2020
  3. 3/4 gitfaq: shallow cloning a repositoryShourya Shukla, May 4, 2020
  4. Elijah NewrenMay 4, 2020
  5. 4/4 gitfaq: fetching and pulling a repositoryShourya Shukla, May 4, 2020
  6. Elijah NewrenMay 4, 2020
  7. Junio C HamanoMay 4, 2020

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.