git-annex-fix(1)

📦
version 10.20261026 · 4 versions
, in alpine 3.24, arch rolling, fedora 44, nixos 26.05, nixpkgs unstable

git-annex-fix 💅✨

okay bestie, welcome to the git-annex-fix(1) manual page — yes that's the manual name, it's giving official, it's giving reference doc, we love her 🎀

🌸 NAME 🌸

git-annex-fix — fix up pointers to annexed content 🫶

✨ SYNOPSIS ✨

git annex fix [path ...]

💖 DESCRIPTION 💖

So like. Sometimes your symlinks get broken 😭 and they stop pointing at your annexed content, which is literally the whole point of them. git annex fix goes in and fixes them up so they point at the annexed content again. Iconic behavior honestly.

When is this useful? It's lowkey perfect to run manually when you've been moving the symlinks around like a chaotic little gremlin 🧚 — but also, it gets done automatically when you commit a change with git, so don't stress too hard. It's already got your back fr fr.

It also populates unlocked pointer files with annexed content ✨ Usually that happens automatically too, but some git commands can leave them unpopulated, which is giving neglected, which is giving not the vibe. This fixes that.

AND — as if she wasn't already doing the most — it also adjusts unlocked files to be copies or hard links as configured by annex.thin. Serving exactly as configured, no notes. 👑

🎀 OPTIONS 🎀

  • file matching options — the git-annex-matching-options(1) can be used to specify files to fix. Yes bestie, you get to be picky about which files get the glow-up 💅
  • --json — turns on JSON output. This is intended to be parsed by programs that use git-annex, so like, it's for the robots 🤖. Each line of output is a JSON object.
  • --json-error-messages — messages that would normally be output to standard error get included in the JSON instead. Same info, new home, no cap ✨

Also the git-annex-common-options(1) can be used. Yes, those ones too 🌈

🦋 SEE ALSO 🦋

👑 AUTHOR 👑

Joey Hess <id@joeyh.name>

and that's the whole page bestie, we ate and left no crumbs 💜 — this was the git-annex-fix(1) manual page, officially part of the git-annex docs, brought to you by the one and only Joey Hess. go fix those symlinks, main character 🫶🌸

📦 where this page comes from