dxdiff(1X)dxdiff(1X)NAMEdxdiff - DECwindows visual differences program
SYNOPSISdxdiff [ flags ] [ file1 file2 ]
PARAMETERS
Specifies the two files that are to be opened at startup. If you do
not specify any file names, dxdiff lets you specify files after it has
started up.
FLAGS
Specifies the color of the window's border (color displays only). The
default is black. Specifies the color of the window's background
(color displays only). The default is white. Specifies the display
screen on which dxdiff displays its window. If the display option is
not specified, dxdiff uses the display screen specified by your DISPLAY
environment variable. The display option has the format hostname:num‐
ber. Using two colons (::) instead of one (:) indicates that DECnet is
to be used for transport. The default is :0. For more information,
see X(1X). This option is the same as the -d option. Specifies the
color of the text (color displays only). The default is black. Speci‐
fies the font used as the output font. The default font is
times_bold12. Specifies the width, length, and location of the dxdiff
window. If the geometry option is not specified, dxdiff uses default
values. The geometry option has the format [widthxlength][{+-}x{+-}y].
For more information about the screen coordinate system, see X(1X).
Disables linked vertical scrolling. Enables linked vertical scrolling.
This is the default. Disables linked horizontal scrolling Enables
linked horizontal scrolling. This is the default. Enables the display
of filled polygons to connect areas of different text. This is the
default. Enables the display of lines to connect areas of different
text. Disables the display of line numbers in the difference region.
Enables the display of line numbers in the difference region. This is
the default. Specifies the foreground color for the line numbers in
the difference box. The default is black.
DESCRIPTION
The dxdiff application does a line-by-line comparison of two files and
displays the differences between them. The contents of the two files
are displayed in two text regions on either side of a central differ‐
ence region. The differences between the files are displayed as high‐
lighted text. The differences are connected by lines or filled poly‐
gons across the central difference region. Line numbers are optionally
displayed at each end of the difference lines, to show where the dif‐
ferences occur within the files. Note that the files must be ASCII
text files.
MENUS
The dxdiff window contains the following menus:
File Options Differences Help
File Menu
The dxdiff File menu contains the following menu items: Calls up two
Open... dialog boxes, to allow you to specify the two files that you
want to compare. The dialog boxes are labeled Left File and Right
File. You must select one file from each dialog box. Exits the cur‐
rent dxdiff session. If the session is the original one, all other
dxdiff sessions and windows are closed.
Options Menu
The Options menu contains the following menu items: The default is
linked vertical scrolling. When linked vertical scrolling is on and
you scroll one of the files, the other file is scrolled with it line
for line. When linked vertical scrolling is off, one file can be
scrolled independently of the other one. The default is linked hori‐
zontal scrolling. When linked horizontal scrolling is on and you
scroll one of the files, the other file is scrolled with it. When
linked horizontal scrolling is off, one file can be scrolled indepen‐
dently of the other one. Displays either lines or filled polygons to
connect the differences across the difference box. The default on
startup is for filled polygons to be displayed. Displays line numbers
at each end of the lines that connect the differences. The default is
to display line numbers. If dxdiff cannot find a suitable font size
for displaying the line numbers, this item is disabled.
Differences Menu
The Differences menu contains the following items: Displays the differ‐
ences between the two currently selected files. Opens a new dxdiff
window to display the differences between the two currently selected
files. The existing dxdiff window remains on the screen for reference.
Help Menu
The Help Menu button invokes a help window that provides information on
dxdiff.
X DEFAULTS
The dxdiff application uses the values in the .Xdefaults file when you
logged in and uses the appropriate resource specification to customize
the appearance or characteristics of its displayed dxdiff window. The
format for a resource specification in the .Xdefaults file is:
[*name*]resource: value Specifies the application name or the name
string that restricts the resource assignment to that application or to
a component of an application. If this argument is not specified, the
resource assignment is globally available to all X applications. Spec‐
ifies the resource. Specifies the value that is to be assigned to the
resource.
For more information, see X(1X).
Because each toolkit-based application can consist of a combination of
widgets (for example, push buttons and a scroll bar), you can form the
name string by adding widget class and name identifiers to the string.
For further information about adding class and name identifiers, see
X(1X).
For dxdiff, the available class identifiers are:
XmLabel XmPushButton XmRowColumn XmScrollbar XmText
For dxdiff, the available name identifiers are: The application class
name The application name The entire display, which includes all of the
components of the window The main menu bar, which includes the pull-
down menus The file selection dialog box for selecting a file to be
displayed in the left text display region The file selection dialog box
for selecting a file to be displayed in the right text display region
The File pull-down menu The Open button on the File menu The Exit but‐
ton on the File menu The Options pull-down menu The Linked Vertical
Scrolling On/Off button on the Options menu The Linked Horizontal
Scrolling On/Off button on the Options menu The Display Diffs As
Lines/Filled Polygons button on the Options menu The Display Line Num‐
bers button on the Options menu The Differences pull-down menu The Do
Differences button on the Differences menu The Do Differences In New
button on the Differences menu The text region display, which includes
both the left and the right text display regions, each of which include
the file name bars, the vertical scroll bars, the push button region
and the text panes The region where the lines connecting the differ‐
ences are displayed The file name bars at the top of each text region
The vertical scroll bars The region where the file contents are dis‐
played The push button region at the bottom of each text display region
The Next Diff push button The Prev Diff push button
In addition to the general resources listed in X(1X), the resources
available for dxdiff are: Enable or disable linked vertical scrolling.
The default is on. Enable or disable linked horizontal scrolling. The
default is on. Enable or disable display of line numbers in the dif‐
ference region. The default is on. Enable or disable use of lines to
connect areas of different text. The default is off. If drawing of
lines is disabled, filled polygons are used. Specify the foreground
color for line numbers in the difference box.
EXAMPLES
To change the background color of the dxdiff text regions, add the fol‐
lowing entry to your .Xdefaults file:
dxdiff*textdisplay*background: blue To change the background
color of the push button region at the bottom of the window, add
the following entry to your .Xdefaults file:
dxdiff*displaymenu*background: red
FILESRELATED INFORMATIONdiff(1), mwm(1X), X(1X)dxdiff(1X)