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.