threads / patch / 28446

patchDocumentation/git-update-index: refer to 'ls-files'

Subject: [PATCH] Documentation/git-update-index: refer to 'ls-files'

## tl;dr

3 messages between Sep 20, 2011 and Sep 21, 2011. Diffs are folded; open one to read it.

replies: 2people: 2as markdown or json

Stefan Naewe· Sep 20, 2011, 12:23 UTC · lore

'ls-files' refers to 'update-index' to show how the 'assume unchanged' can be seen. This makes the connection 'bi-directional'.

Signed-off-by: Stefan Naewe <stefan.naewe@gmail.com>
---
 Documentation/git-update-index.txt |    5 ++++-
 1 files changed, 4 insertions(+), 1 deletions(-)

Show changes to Documentation/git-update-index.txt +4 −1

diff --git a/Documentation/git-update-index.txt b/Documentation/git-update-index.txt
index d393129..169941a 100644
--- a/Documentation/git-update-index.txt
+++ b/Documentation/git-update-index.txt
@@ -276,6 +276,8 @@ unchanged".  Note that "assume unchanged" bit is *not* set if
 the index (use `git update-index --really-refresh` if you want
 to mark them as "assume unchanged").
 
+To see which files have the "assume unchanged" bit set, use
+`git ls-files -v` (see linkgit:git-update-index[1]).
 
 Examples
 --------
@@ -363,7 +365,8 @@ ctime for marking files processed) (see linkgit:git-config[1]).
 SEE ALSO
 --------
 linkgit:git-config[1],
-linkgit:git-add[1]
+linkgit:git-add[1],
+linkgit:git-update-index[1]
 
 GIT
 ---

-- 
1.7.7.rc2

Junio C Hamano· Sep 20, 2011, 19:50 UTC · re: Stefan Naewe · lore

Re: [PATCH] Documentation/git-update-index: refer to 'ls-files'

Stefan Naewe <stefan.naewe@gmail.com> writes:

> 'ls-files' refers to 'update-index' to show how the 'assume unchanged'
> can be seen. This makes the connection 'bi-directional'.

Thanks, but for that bi-directional connection, I think the place you inserted the new text is suboptimal. There is a single paragraph with two sentences to teach how to set and how to unset. Adding another to teach how to inspect would flow the resulting logic more naturally.

Stefan Naewe· Sep 21, 2011, 06:21 UTC · re: Junio C Hamano · lore

[PATCH v4] Documentation/git-update-index: refer to 'ls-files'

'ls-files' refers to 'update-index' to show how the 'assume unchanged' bit can be seen. This makes the connection 'bi-directional'.

Signed-off-by: Stefan Naewe <stefan.naewe@gmail.com>
---

 As Junio suggested, move the new sentence a little to the place where
 setting and unsetting are explained.

 Documentation/git-update-index.txt |    7 +++++--
 1 files changed, 5 insertions(+), 2 deletions(-)

Show changes to Documentation/git-update-index.txt +5 −2

diff --git a/Documentation/git-update-index.txt b/Documentation/git-update-index.txt
index d393129..d8af8ae 100644
--- a/Documentation/git-update-index.txt
+++ b/Documentation/git-update-index.txt
@@ -264,7 +264,9 @@ tree files, you have to explicitly tell git about it by dropping
 "assume unchanged" bit, either before or after you modify them.
 
 In order to set "assume unchanged" bit, use `--assume-unchanged`
-option.  To unset, use `--no-assume-unchanged`.
+option.  To unset, use `--no-assume-unchanged`. To see which files
+have the "assume unchanged" bit set, use `git ls-files -v` 
+(see linkgit:git-ls-files[1]).
 
 The command looks at `core.ignorestat` configuration variable.  When
 this is true, paths updated with `git update-index paths...` and
@@ -363,7 +365,8 @@ ctime for marking files processed) (see linkgit:git-config[1]).
 SEE ALSO
 --------
 linkgit:git-config[1],
-linkgit:git-add[1]
+linkgit:git-add[1],
+linkgit:git-ls-files[1]
 
 GIT
 ---

-- 
1.7.7.rc2