ANNEX-TO-ANNEX(1p)

📦
version 0.008 · 3 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

💖 ANNEX-TO-ANNEX 💖

okay bestie, so you know that one page in the perl docs, annex-to-annex(1p)? yeah. User contributed perl documentation, we love her. this is that, but make it make sense.

✨ NAME ✨

annex-to-annex — the way that this uses hardlinks to migrate files between git annex repos 🦋

🌸 VERSION 🌸

version 0.008 — yeah she's on 0.008, iconic behavior

👑 SYNOPSIS 👑

annex-to-annex [--commit] source ... destination

that's it. that's the whole vibe. source ... destination, periodt.

🎀 DESCRIPTION 🎀

So here's the tea, bestie: this script moves files and directories from one or more git annexes into a destination git annex. and the slay part? where possible it uses hardlinks instead of copying files. no cap. no wasted disk, no wasted time, just links. 💅

It's lowkey perfect for splitting and consolidating git annexes. Like, for example — and this is a real one — at the end of the semester she uses this script to move files from her work annex (which gets synced to, like, SO many places, everybody wants a piece) into an archival annex (which doesn't, she's mysterious, she stays home). 🧚

So, the deets:

  • Each source should be a file or directory in a git annex.
  • destination should be a subdirectory of a git annex.

that's the whole structure. sources go in, destination catches them. 🫶

💅 OPTIONS 💅

  • --commit — Commit changes in the source and destination annexes. Otherwise, the changes are merely added to the index. so like, without it you're just staging, no committing, no finalizing the moment. choose wisely. ⭐

🌈 SEE ALSO 🌈

the girlies and them, fr fr:

💜 AUTHOR 💜

Sean Whitton <spwhitton@spwhitton.name> — an actual legend, we thank her for her service 🫡

This software is Copyright (c) 2019-2021 by Sean Whitton <spwhitton@spwhitton.name>.

This is free software, licensed under:

The GNU General Public License, Version 3, June 2007
okay so basically: free software, GPLv3, June 2007, respect the license bestie it's the law 💖

and that's the page!! this was ANNEX-TO-ANNEX(1p) from perl v5.40.1, dated 2025-03-04, living in the user contributed perl documentation section. mwah. go hardlink something. ✨🎀💅

📦 where this page comes from