1   Overview
=TITLE Overview
=TITLE Overview of Dxdiff
 The dxdiff application is a visual differences program.
 Use it to browse a graphical display of the
 differences between two text files.

 You can scroll through the files or use the Next Diff
 and Prev Diff push buttons to move from one difference
 to another.

 For more information about using dxdiff, double click
 on an item from the list of additional topics below.


2   Appearance
=TITLE Appearance
=TITLE The Dxdiff Window
=KEYWORD components,appearance
=INCLUDE Overview
=INCLUDE overview file_menu
=INCLUDE overview op_menu
=INCLUDE overview diffs_menu
 Dxdiff is comprised of a window containing several  
 parts.

 The title bar contains the application name,
 followed by the window number. The windows you call
 up are numbered consecutively from 0 onwards.

 Beneath the title bar are pull-down menus titled 
 Files, Options, Differences and Help. Click MB1
 once on each title and hold to view the options in
 each menu.

 The main area of the window is divided into three
 parts: two text regions on either side of a central
 region where lines or polygons indicate differences.

 Horizontal and vertical scrolling bars for each text
 region enable you to search through each file
 independently if required. You can choose whether to
 scroll through both files simultaneously or separately.

 Beneath each text region are two push
 buttons; one marked Next Diff, the other marked 
 Prev Diff. Use these buttons to move backwards and
 forwards viewing the differences between the files.

 For more information about using dxdiff, double
 click on an item from the list of additional topics
 below.


3 exiting 
=TITLE exiting
=TITLE Exiting from Dxdiff
=KEYWORD ending,quiting,quit
=INCLUDE overview
 To close an individual dxdiff window, choose the 
 Quit item from the Files menu.

 If you are running several dxdiff windows in the same
 session, choose the Quit item in the original dxdiff
 window, number 0, to close all of the dxdiff windows.

2 file_menu
=TITLE file_menu
=TITLE The Files Menu
=INCLUDE overview op_menu
=INCLUDE overview diffs_menu
=INCLUDE overview 
 The Files Menu contains the following items:

  Open Files... 

  Quit

3 open_files
=TITLE open_files
=TITLE Opening Files  
=INCLUDE overview diffs_menu
=INCLUDE overview file_menu movethru_diffs
=INCLUDE overview
 To select two files for comparison, choose the
 Open Files... item from the Files menu. Two File 
 selection boxes are displayed, one called the
 rightfileselector:0, and the other called the
 leftfileselector:0. These are numbered to correspond
 with the dxdiff window.
 
 Each file selection box shows the files in the current 
 directory.

 To select a file from the selection box, you can
 either doubleclick on the name of the file, click once
 on the file name or type it into the text area, and 
 then click on the OK button.

 You can select files to compare from different
 directories.

 To change directory, type the pathname of the
 directory in the File Filter box and then click on
 the Apply button. The Selection box recognizes the
 tilde (~) character which represents your home directory.

 You must select one file from each File selection box. 
 As you select a file, the box disappears.

 To display the differences between the two files you
 have selected, choose the Do Differences item from
 the Differences menu.

 To display the differences in a new dxdiff window,
 choose the Do Differences In New item from the
 Differences menu.  The existing dxdiff window remains
 on the screen for reference.

 The file you select from the rightfileselector box
 is displayed on the right-hand side of the dxdiff
 window.

 The file you select from the leftfileselector box
 is displayed on the left-hand side of the dxdiff
 window.

3 exiting 
=TITLE exiting
=TITLE Quit
=KEYWORD ending,quiting,quit
=INCLUDE overview
 To close an individual dxdiff window, choose the 
 Quit item from the Files menu.

 If you are running several dxdiff windows in the same
 session, choose the Quit item in the original dxdiff
 window, number 0, to close all of the dxdiff windows.

3 movethru_diffs 
=TITLE movethru_diffs
=TITLE Moving through Differences
=KEYWORD scrolling
=INCLUDE overview file_menu open_files
=INCLUDE overview
 To browse through the differences, use either the 
 scroll bars, or the Next Diff and Prev Diff buttons
 at the bottom of each text region. 

 To move forwards through the files to the next
 difference, click on the Next Diff button. 

 To move backwards through the files to the previous
 difference, click on the Prev Diff button.

2 op_menu 
=TITLE op_menu 
=TITLE The Options Menu
=KEYWORD options
=INCLUDE overview file_menu
=INCLUDE overview diffs_menu
=INCLUDE overview appearance exiting
 The Options Menu contains the following options:

   Linked Vertical Scrolling Off/On

   Linked Horizontal Scrolling Off/On

   Render Diffs as Lines/Filled Polygons

   No/Display Diff line numbers

3 link_tog 
=TITLE link_tog
=TITLE The Linked/Unlinked Scrolling Options
=KEYWORD scrolling
=INCLUDE overview op_menu line_op
=INCLUDE overview op_menu number_op
=INCLUDE overview
 By default, both files are scrolled together. This
 is linked scrolling.

 To scroll each file independently, choose the 
 Linked Scrolling Off item. 

 To return to linked scrolling, choose the
 Linked Scrolling On item. 

3 line_op 
=TITLE line_op
=TITLE The Lines or Filled Polygons Option
=INCLUDE overview op_menu link_tog
=INCLUDE overview op_menu number_op
=INCLUDE overview
 When you start dxdiff, the differences between the files
 are connected by filled polygons across the difference 
 region. This emphasizes the relationship between the 
 differences in the two files. 

 To display lines instead of filled polygons,
 choose the Render Diffs As Lines item.

 To display filled polygons again, choose the
 Render Diffs As Filled Polygons item.

 Note that when you scroll a display which contains
 filled polygons, the filled polygons change to thin lines
 during the scrolling. When you stop scrolling, the lines
 revert back to filled polygons.

3 number_op 
=TITLE number_op
=TITLE The Line Number Option
=INCLUDE overview op_menu line_op
=INCLUDE overview op_menu link_tog
=INCLUDE overview
 By default, line numbers are displayed
 at the beginning and end of the difference lines or 
 filled polygons.

 To turn the line numbers off, choose the
 No Diff Line Numbers item. 

 To retrieve the display of line numbers, choose the
 Display Diff Line Numbers item. 

2 diffs_menu
=TITLE diffs_menu
=TITLE The Differences Menu
=INCLUDE overview file_menu
=INCLUDE overview op_menu
=INCLUDE overview appearance exiting
 The Differences Menu contains the following items:
	
	Do Differences

	Do Differences in New

3 redo_differences
=TITLE redo_differences
=TITLE Do Differences
=KEYWORD redo,differences
=INCLUDE overview file_menu open_files
=INCLUDE overview diffs_menu new_window
=INCLUDE overview 
 To view differences between two selected files
 in the current dxdiff window choose the
 Do Differences item from the Differences menu.

 Select files to compare by choosing the
 Open Files ... item of the Files menu.

 See the Opening Files topic below for 
 details of how to select files.

 If either of the two selected files have
 been edited whilst dxdiff compares them,
 choose the Do Differences item from the Differences  
 menu to view the new differences.

 See the Do Differences In New topic below for
 details of displaying differences in another
 dxdiff window.

3 new_window
=TITLE new_window
=TITLE Do Differences in New
=KEYWORD new_window
=INCLUDE overview file_menu open_files
=INCLUDE overview diffs_menu redo_differences
=INCLUDE overview
 To compare a new set of files and display the
 differences in another dxdiff window, choose the
 Do Differences in New item from the Differences 
 menu.  The existing dxdiff window remains
 on the screen for reference.

 You can call up as many dxdiff windows as you like.
 Each window is consecutively numbered. 

 Select files to compare in the new window by
 choosing the Open Files ... item of the new 
 window's Files menu.

 See the Opening Files topic below for 
 details of how to select files.

