NAME
splittree − generate a split mooix object tree
SYNOPSIS
splittree src dest srclink destlink [owner [dontouchsrc]]
DESCRIPTION
splittree creates a tree of mooix objects in dest that overshadows the tree found in src -- each of the objects in src is the parent of an equivalent object in dest (actually, the two trees are interleaved, so an object in dest will have a parent in src, which will have a parent in dest, and so on). This means that the objects in dest can be used, and modified as necessary, while their parents in src stay unchanged. This makes it pretty easy to upgrade the objects in src later, without complicated merge problems.
The next two parameters are the text of a symlink from dest to src , and a symlink back from src to dest.
The optional owner parameter will make the created tree owned by the given user.
The optional dontouchsrc parameter, if set to 1, will make splittree not modify symlinks in the src tree. If this parameter is not present, the symlinks will be modified to make sure they’re absolute links pointing at the dest tree.
This program is fully idempotent, so it can be run at any time to update what’s in dest based on updates to what’s in src. It does not yet handle disappearing objects though.
BUGS
If this sounds confusing, you’re right -- it is.
SEE ALSO
AUTHOR
Joey Hess <joey [AT] mooix.net>