From: Joey Hess <joeyh@joeyh.name>
Date: Mon, 10 May 2021 23:16:15 +0000 (-0400)
Subject: idea
X-Git-Tag: archive/raspbian/10.20250416-2+rpi1~1^2~91^2~398
X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=8dbbbc7250d7093694a7b1beb7040e445f2be87d;p=git-annex.git

idea
---

diff --git a/doc/todo/git-annex_whereused.mdwn b/doc/todo/git-annex_whereused.mdwn
new file mode 100644
index 0000000000..9b23148722
--- /dev/null
+++ b/doc/todo/git-annex_whereused.mdwn
@@ -0,0 +1,21 @@
+`git annex whereused` would report where in the git repository a
+key is used, as a complement to `git-annex unused`.
+
+Use cases include users not getting confused about why git-annex unused
+says a key is used.
+
+Also, it could scan through history to find where a key *was* used.
+git-annex unused outputs a suggestion to use a rather hairy `git log -S`
+command to do that currently.
+
+If it does both these things, it could explain why git-annex unused
+considers a key used despite a previous git rev referring to it. Eg:
+
+	# git annex whereused SHA1--foo
+	checking index... unused
+	checking branches... unused
+	checking tags... unused
+	checking history... last used in master^40:somefile
+	checking reflog... last used in HEAD@{30}:somefile
+
+--[[Joey]]