mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

man page for git-annex whereused

Browse source 
And an implementation strategy.

Sponsored-by: Brett Eisenberg on Patreon
This commit is contained in:
Joey Hess 2021-07-14 13:43:45 -04:00
parent 2512ba2f16
commit 980613ec8c
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
3 changed files with 78 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

21
doc/todo/git-annex_whereused.mdwn
View file

@ -19,3 +19,24 @@ considers a key used despite a previous git rev referring to it. Eg:
checking reflog... last used in HEAD@{30}:somefile
--[[Joey]]
> First pass is a keys db lookup to filenames.
>
> The historical pass can be done fairly efficiently by using
> `git log -Skey --exclude=*/git-annex --glob=* --exclude=git-annex --remotes=* --tags=* --pretty='%H' --raw`
> and fall back to `git log -Skey --walk-reflogs --pretty='%gd' --raw` if nothing was found.
>
> That makes git log check all commits reachable from those refs,
> probably as efficiently as possible, and stop after one match.
> It won't allow quite as nice a display as above.
>
> Parse the log output for commit sha and filename. Double-check
> by catting the file's object and making sure it parses as an annex
> link or pointer.
>
> Then use `git describe --contains --all` to get a description of the commit
> sha, which will be something like "master~2" or "origin/master~2",
> and add ":filename" to get the ref to output.
>
> Or, if it was found in the ref log, take the "HEAD@{n}" from log
> output, and add ":filename"