BlackBox diffutils
--------------------

Clone of diff and diff3 utilites from *nix for BlackBox and its binary Compound Document format.


Commands
--------------------

To use tools within Blackbox just compile DevDiff.

DiffUtils.Compare (guard TextCmds.FocusGuard)

	Compare texts from two windows.
	You can directly replace DevSearch.Compare with it in Dev/Rsrc/Menus.odc.


^Q DiffUtils.CompareThis <oldfile> <newfile> [">" <outfile>]

	Compare two files and produce patch in unified diff format.


^Q DiffUtils.MergeThis <my> <old> <your> [">" <outfile>]

	Read three files and do three-way merge like diff3.


Dedicated tool
--------------------

You can read, create diffs and merge documents from command line using odctool.
To build it, open DiffMain and execute commanders at the end of document.
Call `odctool help` to learn how to use it.


Integration with Git
--------------------

It is possible to integrate three-way merge with git.

1. Open .git/config and add this lines:

	[merge "odctool"]
		name = BlackBox Compound Document merge driver
		driver = /full/path/to/odctool merge -p %P -o %A %A %O %B

2. Open/create .git/info/attributes and add this line:

	*.odc merge=odctool

Now when conflict occurs, it marked like diff3 directly in odc file.
Checked not only text, but also views and formatting.


Current state
--------------------

This is NOT final version of subsustem Diff and odctool. It is NOT well tested, you are warned!
Also, program and user interface are not stable yet, so it can be changed in future.