Diff

For GUI

If you want to use Git (or Svn) for managing BlackBox source code and resource files, which are in a binary format (.odc), you need a diff viewer capable of handling this specific file format. As it turned out, BlackBox can be used for that purpose with just a small adaptation.

Here is how to set it up for Git:

1. download and unpack the attached DiffConfig package, which simply contains a special version of a BlackBox 1.6 Config file.

2. Under Git settings configure a diff viewer for the .odc file name extension.

The details depend on which Git client tool you use but there is always a way for setting up a diff viewer for a specific file name extension. Under TortoiseGit, which I use, you select the entry 'Settings' under the Git Popup menu. Then select 'Diff Viewer' and 'Advanced...'.

Then 'Add...' a new diff viewer and adapt the paths as needed:

Extension: .odc.

External Program: "C:\Program Files\BlackBox Component Builder 1.6\BlackBox.exe" /USE "C:\Program Files\DiffConfig" %mine %base

That is it.

Now you can use all the diff commands of your Git client for .odc files.

The Config file simply tiles the window vertically, the left window showing the base version, and the right window showing the new version.

Then it invokes the Text Diff command (F9). You use F9 to step to the next difference.

For Terminal

To use "odcread" in local repository as binary to text converter:

1. Download [[1]], compile and install in folder /usr/local/bin/

2. In local repository make file .git/info/attributes with content *.odc diff=cp

3. In file .git/config add next three strings:

[diff "cp"]

binary = true

textconv = /usr/local/bin/odcread