tdcompare1

Usage

Overview

tdcompare compares two recordings of a terminal program to determine whether they represent the same output. The comparison can be both at the input/output level, or at the visual level. When comparing at the input/output level, the difference will be reported as line numbers in the OLD and NEW files. For visual comparisons, a textual description of the first difference can be produced, and a picture of the first different terminal state can be written (if termdebug was compiled with Cairo support).

tdcompare is useful to verify that a new recording of the same program produced the same result. To do on-line verification, use tdreplay(1) instead.

Options

tdcompare accepts the following options:

-h, --help

Display a short help message.

-V, --version

Print version and copyright information.

-v, --visual-compare

Check for visual equality, rather than exact input/output behaviour. (Requires a build with ncurses support.)

-D, --describe

Write a description of the first visual difference encountered. Only useful with -v/--visual-compare. (Requires a build with ncurses support.)

-p name, --picture=name

Write a picture of the difference to name. Only useful with -v/--visual-compare. (Requires a build with ncurses and Cairo support.)

-f font, --font=font

Use font to show text in generated pictures. Only useful with -p/--picture or -P/--picture-series. (Requires a build with ncurses and Cairo support.)

-W width, --cell-width=width

Use cells of width pixels wide in generated pictures. Only useful with -p/--picture or -P/--picture-series. (Requires a build with ncurses and Cairo support.)

-H height, --cell-height=height

Use cells of height pixels wide in generated pictures. Only useful with -p/--picture or -P/--picture-series. (Requires a build with ncurses and Cairo support.)

-P name, --picture-series=name

Create a series of pictures, representing the different visual steps in the client interface, using name as the file name template. name is a printf(3) format string, where a single d-type conversion is required. (Requires a build with ncurses and Cairo support.)

-s, --stop-on-difference

Stop when the first visual difference is found. Only valid with -P/--picture-series.

To stop tdcompare from interpreting file names that start with a dash as options, one can specify a double dash (--) after which tdreplay will interpret any following arguments as files to read.