git-annex-renameremote(1)

💖 git-annex-renameremote 💖

okay bestie, so this is a page from the General Commands Manual — it's git-annex-renameremote(1) — and it's about giving your special remote a lil glow-up name change. no cap.

✨ NAME ✨

git-annex-renameremote — changes name of a special remote 🎀

🌸 SYNOPSIS 🌸

git annex renameremote name|uuid|desc newname

🦋 DESCRIPTION 🦋

So the way this works is: it changes the name that's used to enable a special remote. that's the whole vibe. 💅

Normally the current name is what you use to identify the special remote you wanna rename, but you can also use its uuid or its description instead. options, we love to see it. ✨

Here's where it's actually iconic: say an old special remote was using some name, and now you want that name for a brand new special remote. git annex initremote will not let you create a remote with a conflicting name — like, it literally refuses — so you rename the old remote first. periodt.

git annex renameremote phone lost-phone
git annex initremote phone ...

heads up bestie: this only updates the name that git-annex has stored for use by git annex enableremote. it does not update the git config stanza for the special remote to use the new name. but of course you can edit the git config yourself if you wanna rename it there too. 🫶

💅 OPTIONS 💅

• The git-annex-common-options(1) can be used. 🌈

👑 SEE ALSO 👑

• git-annex(1)
• git-annex-initremote(1)
• git-annex-enableremote(1)
• git-annex-configremote(1)

⭐ AUTHOR ⭐

Joey Hess <id@joeyh.name> 🧚

and that's the whole page, fr fr — it's from the git-annex manual, the git-annex-renameremote(1) one, and yeah that footer said the same thing too 💜