Next: , Previous: mkpatch, Up: Introducing Changesets


A.2.2 dopatch

dopatch is used to apply a changeset to tree:

             % tla dopatch PATCH-SET TREE

If tree is exactly the same as the the "original" tree seen by mkpatch, then the effect is to modify tree so that it is exactly the same as the the "modified" tree seen by mkpatch, with one exception (explained below).

"Exactly the same" means that the directory structure is the same, symbolic link targets are the same, the contents of regular files are the same, and file permissions are the same. Modification times, files with multiple (hard) links, and file ownership are not reliably preserved.

The exception to the "exactly the same" rule is that if the patch requires that files or directories be removed from tree, those files and directories will be saved in a subdirectory of tree with an eye-splitting name matching the pattern:

             ++removed-by-dopatch-PATCH--DATE

where PATCH is the name of the patch-set directory and DATE a timestamp.