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

[PATCH 3/4] docs/git-clone: clarify use of --no-hardlinks option

From
AIAlbert L. Lash, IV <albert.lash@gmail.com>
Date
Feb 8, 2014, 20:41 UTC
Message-ID
<1391892097-16169-3-git-send-email-alash3@bloomberg.net>
In-Reply-To
<1391892097-16169-1-git-send-email-alash3@bloomberg.net>

Current text claims optimization, implying the use of hardlinks, when this option ratchets down the level of efficiency. This change explains the difference made by using this option, namely copying instead of hardlinking, and why it may be useful.

Signed-off-by: Albert L. Lash, IV <alash3@bloomberg.net>
---
 Documentation/git-clone.txt | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)
diff --git a/Documentation/git-clone.txt b/Documentation/git-clone.txt
index bf3dac0..0363d00 100644
--- a/Documentation/git-clone.txt
+++ b/Documentation/git-clone.txt
@@ -55,15 +55,12 @@ repository is specified as a URL, then this flag is ignored (and we
 never use the local optimizations).  Specifying `--no-local` will
 override the default when `/path/to/repo` is given, using the regular
 Git transport instead.
-+
-To force copying instead of hardlinking (which may be desirable if you
-are trying to make a back-up of your repository), but still avoid the
-usual "Git aware" transport mechanism, `--no-hardlinks` can be used.
 
 --no-hardlinks::
-	Optimize the cloning process from a repository on a
-	local filesystem by copying files under `.git/objects`
-	directory.
+	Force the cloning process from a repository on a local
+	filesystem to copy the files under the `.git/objects`
+	directory instead of using hardlinks. This may be desirable
+	if you are trying to make a back-up of your repository.
 
 --shared::
 -s::
-- 
1.8.3.2
Previous: Albert L. Lash, IVNext: Junio C Hamano
Message 3 of 7 in “docs/merge-strategies: remove hyphen from mis-merges”
  1. 1/4 docs/merge-strategies: remove hyphen from mis-mergesAlbert L. Lash, IV, Feb 8, 2014
  2. 2/4 docs/git-remote: capitalize first word of initial blurbAlbert L. Lash, IV, Feb 8, 2014
  3. 3/4 docs/git-clone: clarify use of --no-hardlinks optionAlbert L. Lash, IV, Feb 8, 2014
  4. Junio C HamanoFeb 11, 2014
  5. 4/4 docs/git-blame: explain more clearly the example pickaxe useAlbert L. Lash, IV, Feb 8, 2014
  6. Junio C HamanoFeb 11, 2014
  7. Junio C HamanoFeb 10, 2014

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.