aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/git-replace.txt
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2012-08-06 13:36:47 -0700
committerJunio C Hamano <gitster@pobox.com>2012-08-06 14:04:16 -0700
commit831e61f80fab2d3f9ba1773e657803dcf8b16432 (patch)
tree6ced3d26ab664b5ab3885eaef205e8e0d229c5bf /Documentation/git-replace.txt
parentd0f1ea6003d97e63110fa7d50bb07f546a909b6e (diff)
downloadgit-831e61f80fab2d3f9ba1773e657803dcf8b16432.tar.gz
Documentation: do not mention .git/refs/* directories
It is an implementation detail that a new tag is created by adding a file in the .git/refs/tags directory. The only thing the user needs to know is that a "git tag" creates a ref in the refs/tags namespace, and without "-f", it does not overwrite an existing tag. Inspired by a report from 乙酸鋰 <ch3cooli@gmail.com>; I think I caught all the existing mention in Documentation/ directory in the tip of 1.7.9.X maintenance track, but we may have added new ones since then. Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-replace.txt')
-rw-r--r--Documentation/git-replace.txt5
1 files changed, 2 insertions, 3 deletions
diff --git a/Documentation/git-replace.txt b/Documentation/git-replace.txt
index 17df525275..51131d0858 100644
--- a/Documentation/git-replace.txt
+++ b/Documentation/git-replace.txt
@@ -14,14 +14,13 @@ SYNOPSIS
DESCRIPTION
-----------
-Adds a 'replace' reference in `.git/refs/replace/`
+Adds a 'replace' reference in `refs/replace/` namespace.
The name of the 'replace' reference is the SHA1 of the object that is
replaced. The content of the 'replace' reference is the SHA1 of the
replacement object.
-Unless `-f` is given, the 'replace' reference must not yet exist in
-`.git/refs/replace/` directory.
+Unless `-f` is given, the 'replace' reference must not yet exist.
Replacement references will be used by default by all git commands
except those doing reachability traversal (prune, pack transfer and