git-annex-merge(1)

πŸ“¦
version 10.20261026 Β· 4 versions
, in alpine 3.24, arch rolling, debian trixie, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

✨ git-annex-merge ✨

okay bestie, welcome to the git-annex-merge(1) page from the git-annex manual πŸ’– this is the one where you pull all the remote drama into your local branch and let git-annex handle the mess. no data uploads, no downloads, just vibes and merges. periodt.


πŸ’… NAME πŸ’…

git-annex-merge β€” merge changes from remotes


πŸŽ€ SYNOPSIS πŸŽ€

git annex merge [branch]

πŸ¦‹ DESCRIPTION πŸ¦‹

so like, when you run this with zero parameters, it does the exact same merging (and merge conflict resolution, yes the messy part 😭) that git-annex pull and git-annex sync do β€” except it does it without uploading or downloading any data. literally just the merge, nothing else. main character behavior only, no extra tasks.

When you do specify a branch to merge, it merges that branch into your current branch, using the same merge conflict resolution as the git-annex pull command. This is especially useful on an adjusted branch, because it applies the same adjustment to the branch before merging it. slay 🫢

And heads up β€” when annex.resolvemerge is set to false, merge conflict resolution will not be done. so you're on your own with the conflicts at that point, ngl πŸ™ˆ


⭐ OPTIONS ⭐

  • --allow-unrelated-histories, --no-allow-unrelated-histories β€” these get passed on to git merge, and they control whether or not you merge histories that do not share a common ancestor. like, do these two branches even know each other?? this flag decides. πŸ‘‘
  • --json β€” Enable JSON output. This is intended to be parsed by programs that use git-annex. Each line of output is a JSON object. machine-readable realness ✨
  • --json-error-messages β€” Messages that would normally be output to standard error are included in the JSON instead. so the sad little error messages get to live inside the JSON too, cute πŸŽ€

Also, the git-annex-common-options(1) can be used. don't forget about her πŸ’œ


🌸 SEE ALSO 🌸

go read the whole friend group, iykyk 🧚


🌈 AUTHOR 🌈

Joey Hess <id@joeyh.name>


fr fr, remember: no data goes anywhere when you merge like this. just branches getting to know each other. be safe, resolve your conflicts, and hydrate πŸ’–

and that's the whole page bestie!! this was git-annex-merge(1) from the git-annex manual, written by Joey Hess, and it's the merge page in all her conflicted glory. ily, go merge something πŸ«ΆπŸ’…βœ¨