git-annex-rmurl(1)

✨ git-annex-rmurl — bestie edition ✨

okay so this is a page from the General Commands Manual, and it's all about git-annex-rmurl. let's get into it 💅

🌸 NAME 🌸

git-annex-rmurl — record file is not available at url

🎀 SYNOPSIS 🎀

git annex rmurl [file url ..]

🦋 DESCRIPTION 🦋

So like. You're recording that the file is no longer available at the url. That's the whole vibe. 📝

Here's the tea tho — if you remove the last web url, git-annex will no longer treat the content as being present in the web special remote. gone. not present. periodt.

BUT. important plot twist: if some other special remote claims that url, then unregistering the url will not update presence information for it. why? because the content may still actually be present on that remote. git-annex is not gonna lie to you about that. so it just... doesn't touch it. 🫶

💖 OPTIONS 💖

• --batch — turns on batch mode, where lines get read from stdin. each line should have the file, and then the url to remove from that file, separated by a single space. that's it, that's the format. 🍓
• -z — makes the --batch input be delimited by nulls instead of the usual newlines. for when your filenames are being messy and newline-free. iconic behaviour honestly.
• --json — enables 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 are included in the JSON instead. everything in one place, no stray stderr, very tidy ✨

Also the git-annex-common-options(1) can be used. don't forget about those, they're the shared ones, they apply here too 💜

🌈 SEE ALSO 🌈

• git-annex(1)
• git-annex-addurl(1)

👑 AUTHOR 👑

Joey Hess <id@joeyh.name>

and that's the whole page, bestie 🧚 this was page git-annex-rmurl(1) from the git-annex manual — go off and unregister those urls responsibly 💖🌸💅