1. Invoking DITA Merge
DITA Merge can be run using a command-line interface that is invoked from a terminal window or Windows command line.
x.y.z with the
major.minor.patch version number of your release e.g.
There are two types of command-line interfaces:
Java API-based command-line interface
REST API-based command-line interface
The source code for this interface is available in Bitbucket. This was designed to give you some understanding of the DITA Merge REST API.
The two jars
deltaxml-dita-merge-rest-client-x.y.z.jar are included in the distribution.
These interfaces are implemented to quickly run a merge from the command line. However, they do not provide all the features of the Java or REST API such as rule configuration.
2. Supported Merge Types
|concurrent||N-Way concurrent merge|
|concurrent3||Three way concurrent merge|
|sequential||N-Way sequential merge|
3. Supported Commands
This command is used to see the description of the available parameters for the specified merge type.
Runs a merge for the specified merge type. Each file needs to have a name which is used to identify the version in the generated DeltaV2 result.
The example below will merge three revisions ('anna', 'ben' and 'chris') against the 'ancestor' version with merge type as concurrent. The inputs used in the example below are included in your release in the
samples/data directory. Note: the command has been wrapped to aid readability.
Prints out the current activated license details. NOTE: The REST API-based command-line interface does not support this command.
4. Merge command parameters
Optional command-line parameters can be added to the end of the command-line, these are used to set options for the merge process.
The command-line syntax for parameters is:
The supported parameters are listed on the page Configuration Options.