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

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

From
Junio C Hamano <gitster@pobox.com>
Date
Feb 11, 2014, 00:20 UTC
Message-ID
<xmqqmwhyqz3s.fsf@gitster.dls.corp.google.com>
In-Reply-To
<1391892097-16169-3-git-send-email-alash3@bloomberg.net>
"Albert L. Lash, IV" <albert.lash@gmail.com> writes:
Show 32 quoted lines
> 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.

Makes sense, and it is kind of embarrassing (I have to suspect that this was originally the description of "--hardlinks" option).

[PATCH {1,2}/4] looked trivially correct, too.
Thanks.
Previous: Albert L. Lash, IVNext: Albert L. Lash, IV
Message 4 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.