git-annex-oldkeys(1)

✨ git-annex-oldkeys ✨

okay bestie, so this is the git-annex-oldkeys page from the General Commands Manual — yes, the whole manual-page vibe, but make it cute. let's get into it 💅

🌸 NAME 🌸

git-annex-oldkeys — list keys used for old versions of files

🦋 SYNOPSIS 🦋

git annex oldkeys [path ...]

💖 DESCRIPTION 💖

So basically this command lists the keys used for old versions of whatever files or directories you point it at. that's the whole assignment. 💅

and here's the slay part: the output from this command can be piped into a command like git-annex drop --batch-keys 👑

The keys are listed in order from newest to oldest. so the freshest old version comes first, the ancient relics come last. iconic.

When you're listing old keys for a directory, it will also include keys used by deleted files that were in that directory in past commits. like, yeah, they're gone now, but the receipts remain 💀✨

🎀 OPTIONS 🎀

• --unchecked — By default this command does not list a key that is also used by any file in the currently checked out branch. This option makes it also list such keys.

the default behavior avoids surprises when dropping listed keys (fr fr, you don't wanna drop something that's still in use). This option can be useful when, eg, copying all old versions of a file to a remote. 🌈

• --revision-range=value — Only list old keys used in the specified range of revisions. This works the same as the revision range option of git log. See gitrevisions(7) for documentation about the format of this option.

For example, to list only keys used since the tag v1.0, use:

--revision-range=v1.0..HEAD

Also the git-annex-common-options(1) can be used. 🫶

⭐ SEE ALSO ⭐

• git-annex(1)
• git-annex-unused(1)

👑 AUTHOR 👑

Joey Hess <id@joeyh.name>

and that's the whole page, bestie. the header said it was the git-annex-oldkeys(1) page under General Commands Manual, and the footer was just git-annex-oldkeys(1) all over again — no version number, no date, just the name holding it down at the bottom like the main character it is. periodt. 💅💖✨