Running Your First Conversion Check

This topic explains how to run your first Check using the deltanova-year.x.y.z.jar command-line tool. Check analyses two versions of a document — typically before and after a format conversion — and reports on what changed.

For a conceptual introduction to Check, see Check Overview.

Running a Conversion Check

Replace year.x.y.z with your release version number.

Basic Check — Generating a Change Report

java -jar deltanova-year.x.y.z.jar check xml source.xml xml converted.xml report.html

This produces an HTML change report (report.html) showing all additions, deletions, and modifications between the source and converted documents.

Viewing Available Check Commands

java -jar deltanova-year.x.y.z.jar describe check
java -jar deltanova-year.x.y.z.jar describe <inputDocType>

Understanding the Change Report

The change report summarises the differences between the two documents:

Additions — content present in the converted file but not in the source
Deletions — content present in the source but removed in the converted file
Modifications — content present in both but changed

Each difference is shown with its location in the document tree, making it straightforward to identify conversion errors.

For full details on interpreting the report see Check Change Report Overview.

Check Overview — conceptual overview of Check
Check Features — full feature list
Check Operations — guide on using the REST API
Check Change Report Overview — reading the output
Check Configuration — configuration reference
Using the Command-Line Tool — complete command-line reference