mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

expand docs

Browse source
This commit is contained in:
Joey Hess 2017-06-01 11:56:56 -04:00
parent 650b3fd4c7
commit d5cb853dd0
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
2 changed files with 24 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

2
doc/automatic_conflict_resolution.mdwn
View file

@ -21,3 +21,5 @@ conflict resolution is designed so that if two or more repositories both get
a merge conflict, and resolve it, the resolved repositories will not a merge conflict, and resolve it, the resolved repositories will not
themselves conflict. This is why it doesn't use something nicer, like themselves conflict. This is why it doesn't use something nicer, like
perhaps the name of the remote that the file came from. perhaps the name of the remote that the file came from.
See also: [[git-annex-resolvemerge]]

25
doc/git-annex-resolvemerge.mdwn
View file

@ -12,9 +12,28 @@ Resolves a conflicted merge, by adding both conflicting versions of the
file to the tree, using variants of their filename. This is done file to the tree, using variants of their filename. This is done
automatically when using `git annex sync` or `git annex merge`. automatically when using `git annex sync` or `git annex merge`.
Note that only merge conflicts that involve an annexed file are resolved. Note that only merge conflicts that involve one or more annexed files
Merge conflicts between two files that are not annexed will not be are resolved. Merge conflicts between two files that are not annexed
automatically resolved. will not be automatically resolved.
# EXAMPLE
Suppose Alice commits a change to annexed file `foo`, and Bob commits
a different change to the same file `foo`.
Merging between them will then fail, and git will present the
merge conflict as a file `foo` pointing to one version of the
git-annex symlink, with `git status` indicating that `foo` has an
unresolved conflict.
Running `git annex resolvemerge` in this situation will resolve the merge
conflict, by replacing the file `foo` with files named like
`foo.variant-c696` and `foo.variant-f16a`. One of the files has the content
that Alice committed, and the other has the content that Bob committed.
The user can then examine the two variants of the file, and either merge
the two changes into a single file, or rename one of them back to `foo`
and delete the other.
# SEE ALSO # SEE ALSO