This section describes items on the Tools menu and associated dialogs and views.
The table below describes each item on the Tools menu and its corresponding command.
|
Tools Menu Item |
Description |
Command |
|---|---|---|
|
Quick Start Configuration |
Displays the Quick Start Configuration Wizard. See Quick Start Configuration Wizard. |
quick_start |
|
Regex Evaluator |
Shows the Regex Evaluator view. See The Regex Evaluator. |
activate_regex_evaluator |
|
OS Shell |
Runs operating system command shell (DOS). |
dos |
|
OS File Browser |
Runs operating system file system browser. See OS File Browser. |
explore or finder |
|
Calculator |
Displays the Calculator, which allows you to evaluate mathematical expressions. See Using the Calculator and Math Commands. |
calculator |
|
ASCII Table |
Opens ASCII table file. |
ascii_table |
|
File Merge |
Displays the 3-Way Merge Setup dialog, which provides settings for merging two sets of changes made to a file. See 3-Way Merge and Tools Dialogs and Views. |
merge |
|
File Difference |
Displays the DIFFzilla® dialog, which allows you to view and edit differences between files. See DIFFzilla® and DIFFzilla® Dialog. |
diff |
|
Tag Files |
Displays a dialog which allows you to build tag files for use by the Symbols view and other Context Tagging® features. See Creating Language-Specific Tag Files and Context Tagging - Tag Files Dialog. |
gui_make_tags |
|
Retag Workspace |
Retags the files in your workspace. See Creating Tag Files for Workspace Files. |
build_workspace_tagfiles |
This section describes the dialogs and views that are associated with the Tools menu items.
The 3-Way Merge dialog (Tools > File Merge), shown below, is used for merging file differences.

The Ellipses buttons to the right of the text boxes are used to select files. The Bbuttons to the right of the text boxes are used to select from the open buffers.
The list below describes the remaining fields and settings:
Base file - Specifies the file/buffer name of the original source file before any changes are made.
Revision 1 and2 - Specifies the file/buffer names of the modified versions of the base file.
Merge style - The following merge styles are available:
Auto merge - If selected, if a change does not cause a conflict, the change is automatically applied to the output file and no indication is made that the change was already applied.
Show changes - If selected, if a change does not cause a conflict, the change is automatically applied to the output file and the change IS indicated, so that using the Next Conflict button will show you the change.
Output style - Output style has no effect if there are no conflicts. The following output styles are available:
Interactive - Provides a friendly side-by-side dialog box which lets you pick the change you want in the output file. It also lets you edit.
Interleaved buffer - Creates an editor buffer which you must edit to resolve conflicts.
Use smart merge - If selected, the number of conflicts found is reduced.
Ignore spaces - If selected, leading and trailing spaces are ignored. The side-by-side output allows you to easily select the change that you want.
The DIFFzilla® dialog (Tools → File Difference) is used to configure a file differencing operation and begin the diff. The left side of the dialog contains a tree that shows recent diff sessions and sessions you have saved under an assigned name.
The Sessions tree records your last several diff sessions, and they are at the top of the tree. You can re-fill the dialog with the information from a previous session by clicking on it. You can save a session with a name by clicking the Save As button at the bottom of the dialog. If you have selected a named session from the bottom of the tree, you can save changes to it by clicking the Save button at the bottom of the dialog.
The dialog contains two tabs:
DIFFzilla® Files Tab - used to select the items to compare.
DIFFzilla Options Tab - used to specify options to control how the diff is performed and control the setup of the diff dialog.

Use this tab to specify the items to compare and the manner in which the comparison is performed. After filling in the needed information, click OK to start the diff.
The following Diff Types are available:
Compare Two Files - Compares two files and shows the differences between them. When this option is selected, after you click OK on this dialog to start the comparison, the interactive Diff dialog is displayed, allowing you to preview the differences one-by-one before committing.
If the option on the Options tab, Instead of an interactive dialog, output one buffer with the differences labeled, is checked, a buffer with the differences between the two files marked up will be displayed instead.
Compare Two Folders - Compares two directories or directory trees,
and shows which files do not match. Select Recurse into
subdirectories to search subdirectories recursively. Click Previous
diff to load a diff state file (.dif), restoring the
saved state of a multi-file diff session.
The dialog contains two areas used to specify the items to compare: Path 1 and Path 2. Items specified in the Path 1 section will appear on the left side of the diff output window. Items specified in the path 2 section will appear on the right side. For each you can specify the following items:
Path 1, Path 2 - When comparing files, set Path 1 and Path 2 to file names. When comparing folders, set Path 1 and Path 2 to directory names. If the file names only differ by path, you only need to specify a directory for Path 2.
By default, SlickEdit will automatically set the Diff Type based on whether the values for Path 1 and Path 2 contain directory names or file names. To configure that option, see Expert mode setup dialog.
You can use the drop-down list to select a previously used item to compare. To browse for a file or directory, click the Ellipses button. Click the B button to select an open buffer.
Compare type - the second drop-down list lets you select the type of comparison to run. Select one of the following:
Compare lines: all - this is the default comparison type, comparing all of the lines in the specified files.
Compare lines: range - this option allows you to select a subset of the lines to compare, using the dialog, below.

Compare symbols: all - this compares the symbols from the two files, ignoring differences in order. For example, if a function was declared higher up in the file in one version than the other, selecting this option would ignore that difference.
Use file on disk - Select this option to diff the file on disk and not the copy in memory.
In the center of the DIFFzilla dialog are icons that help to configure a comparison:
Toggle automatic directory mapping
- when on, Path 2 is calculated based on other Path 2
directories used with the current Path 1 directory. The icon contains a little, red 'x'
when off.
Copy
path - copies the path from Path 1 to Path 2 or vice versa. The direction of
the copy is indicated by the arrow in the icon. When the arrow is pointing down, it will
copy from Path 1 to Path 2. The direction is controlled by the location of the cursor,
which designates the origin of the copy.
Swap
paths - click on this button to swap the paths from Path 1 to Path 2.
Toggle Code
Diff - turns Source Diff on or off. When Source Diff is off, the icon contains a
small, red 'x'. Source Diff is on by default.
For multi-file diff, you can set specific file types to compare or to exclude:
Filespecs - Enter a space-delimited list of wildcard file
specifications to difference. For example, enter "*.c *.cpp *.h"
to difference all files with .c, .cpp, and
.h extensions.
Exclude filespecs - Enter a space-delimited list of wildcard
file specifications to be excluded from the differencing. For example, enter
junk* test* to exclude all files with names beginning with the
words "junk" or "test". To exclude a specific directory, provide the full path. To
exclude any subdirectory with a particular name, put a slash at the end of the name.
For example, enter ".svn/" to exclude all subdirectories named
".svn" wherever they occur.
Use this tab to set up file comparison options and options that affect the interactive Diff dialog. Click Save to save the options and close this dialog without running DIFFzilla. There are two types of options available: File Compare Options and Dialog Setup Options.

The file compare options, shown above, are described as follows:
Expand tabs into spaces before comparing - When selected, tabs are expanded to the appropriate number of spaces before lines from each file that is compared.
Ignore leading spaces before text on each line - When selected, differences in leading spaces of lines are ignored.
Ignore trailing spaces after text on each line - When selected, differences in trailing spaces at the end of lines are ignored.
Ignore all spaces in file - When selected, differences in spacing between characters in lines are ignored.
Compare files case insensitive - When selected, differences in character casing are ignored.
Do not compare newline characters - When selected, differences in end-of-line characters are ignored. This is useful when comparing UNIX-formatted files with DOS-formatted files.
Skip comments at the beginning of the file - When selected, leading comments are ignored. This is useful if you are using a version control system that automatically inserts comment file headers.
Instead of an interactive dialog, output one buffer with the differences labeled - When selected, a new buffer is created that contains color-coded difference output. You can edit the output buffer. When this option is not selected, the Diff dialog box opens displaying the two files side-by-side and the differences are color-coded.
Source Diff - Determines whether Code Diff is used. Source Diff compares the code temporarily reformatting the code from Path 2 to match the format in Path 1. This is very useful when one version has been both beautified and contains other meaningful changes. Source Diff can also be toggled by an icon on the diff dialog.
Date and Size Optimization - These options control how DIFFzilla analyzes multi-file diffs.
Always compare files - when selected, the two files are always compared. This was how SlickEdit performed multi-file diffs in SlickEdit 2008 and earlier.
Assume match if date and size match - when selected, the two files are assumed to be the same if the date and size are the same. This will significantly speed multi-file diffs.
Assume mismatch if date different and size matches - defines how to handle the case when the size is the same but the date differs.

Setup options for the DIFFzilla® dialog are described as follows:
Show gauge during diff - When selected, a gauge control will show various processing statistics while you wait for the differences output to complete.
Jump to next diff after copy block - When selected, the cursor is moved to the next difference when you apply changes from one file to the other. For example, after clicking Block on the Diff dialog box, the tab moves to the next difference. This option has no effect on interleaved output.
Automatic directory mapping - When selected, the Path 2 text box is automatically updated when you type a directory in the Path 1 text box.
During multi-file diff, automatically close after last difference - When selected, clicking Next Diffon the Diff dialog box when there are no more differences, triggers the Close button on that dialog box.
When closing multi-file diff, do not prompt to save results - suppresses the prompt to save results after a multi-file diff.
Put buttons at top of diff dialog - When selected, the buttons that control operations such as Next Diff, Prev Diff, and Block, are displayed at the top of the Diff dialog box.
Launch multi-file diffs in a separate process - When selected, source trees are diffed in a separate process so you can continue working.
Expert mode setup dialog - When this is on, Compare Two Files or Compare Two Folders will be selected automatically based on whether the paths contain folder names or file names. This was the how SlickEdit 2008 and previous versions worked.
Number of sessions automatically saved - Determines the number of sessions automatically saved under Recent Sessionsin the Sessions tree. The default value is 10.
Starting position - Determines whether to place the cursor at the top of the file or at the first difference when the Diff dialog box is displayed. This option has no effect on interleaved output.
Dialog initialization - Determines whether the DIFFzilla dialog box restores previous dialog settings (history) or just places the current buffer name into the Path 1 text box. Press F7/ F8 to restore the previous next dialog settings, respectively.
The Diff dialog is used to display the results of a file comparison. It displays the file from Path 1 on the left and the file from Path 2 on the right. Colored markers are used to indicate differences between the two files. Unlike most diff tools, the two panes are editable and support many of the same operations as the main editor windows, including syntax expansion and completions.
Imaginary Buffer Lines are inserted any time a line exists in only one file. This ensures that lines that are considered to be the same line (even if they contain changes) are displayed next to each other. This aids in viewing the differences.

A contiguous set of the same type of differences (inserted lines or modified lines) is called a block. A block can be a whole line or several lines. If a particular code change to a file consists of three modified lines followed by three inserted lines, that comprises two blocks of three lines each. Operations you perform will act upon a block, a line, or the whole file.
The following buttons are displayed below each code pane in the Diff dialog. These are used to move changes from one side to the other or save the modified contents of the pane.
Del Block - this button only appears when one side contains code that is not present on the other side. Click this button to delete the block.
Block - click this button to move the current block of differences from one side to the other.
Line - use this button to move the contents of the current line from one side to the other.
Merge All - merges all changes from the selected side to the other.
Save File - saves the file, including all changes made during the diff session.
Read only - lets you change the read-only status of the file.
The bottom of the Diff dialog contains the following buttons:
Close - close the Diff dialog. You will be prompted to save any unsaved changes.
Next Diff - moves to the next block of differences in the file.
Prev Diff - moves to the previous block of differences in the file.
Find - performs a search in the two files.
Undo - undo the last change. This includes changes made by editing and those made using the Block, Line, and Merge buttons.
Help - brings up Help on the Diff dialog.
Source Diff/Line Diff - switches from Source Diff to Line Diff. The button changes based on the kind of diff that was performed. If you did a Code Diff, the button will say Line Diff and vice versa.
To change the colors used, select Window → SlickEdit Preferences → Appearance → Colors. The items to change are listed under the Modifications node in the list of elements. Set the following colors used by the Diff dialog:
Inserted Line - sets the color for lines that exist in one file but not the other. This color is displayed in the margin of the file that contains the inserted line. The other file will contain an Imaginary Buffer Line, to make sure that identical lines are always present next to each other.
Modified Line - sets the color lines that exist in both files but are different. Again, the color is rendered in the margin of the file.
Modified Whitespace - sets the color used for whitespace adjustments created by Source Diff. The Code Diff capability adjusts the formatting of the Path 2 file to match that of the Path 1 file. Inserted or removed whitespace is shown with this color. For more information, see Source Diff.
No Save Line - sets the color used for Imaginary Buffer Lines. These are inserted into the buffer to make sure that lines that are believed to be the same line (even if one has changed) are drawn next to each other. This helps when viewing and understanding differences.
These colors are not used exclusively by the Diff dialog. They are used wherever that same information needs to be conveyed. For example, the Modified Line color is also used for margin markers when you enable the viewing of modified lines in the editor window.
For more information on setting colors see Colors.
When using DIFFzilla® to perform a directory comparison (Multi-File diff type), the results are presented in the Multi-File Diff Output dialog.

The Multi-File Diff Output dialog box contains the following elements:
Diff - Shows current files in the difference editor when the selected files differ.
Del File - Deletes the selected file(s). Hold Ctrl+Click to multi-select in either tree. The X bitmap is displayed.
View - Shows current files in the difference editor when the selected files match.
Copy File/Copy Tree - Copy File is displayed when the selected files differ or when the selected file only exists in the current source tree. The Plus bitmap is displayed. Copy Tree is displayed when the selected item is a directory that only exists in the current source tree. When you click Copy Tree, you are prompted as to whether you want to copy the directory source tree recursively.
Next - Moves the cursor to the next set of mismatched files in both source trees.
Prev - Moves the cursor to the previous set of mismatched files in both source trees.
Save - Lets you save a diff state file (.dif) that you can load later with thePrevious diff button on the DIFFzilla® dialog box. This is especially useful when you have not completed merging files and you want to continue at a later time. Also, you can generate a file list.
Refresh - Rediffs modified files or all files.
Options - Displays the DIFFzilla Options Tab. Options include ignoring spaces, skipping leading comments, and expanding tabs.
Report - Displays a report of the operations you performed in this dialog including file copies, file deletes, and diffs where changes were saved. In addition, you can save the report.
The Context Tagging® - Tag Files dialog, shown below, is used to manage all your tag files. For more information on tagging in general, see Context Tagging Features. For more information about tag files, see Building and Managing Tag Files. To access the Context Tagging® - Tag Files dialog, click Tools → Tag Files.

The left section of the dialog lists all of your tag files, separated into categories. A tag file having a File bitmap with blue arrows indicates the tag file is built with support for cross-referencing. The right section of the dialog lists all the source files indexed by the currently selected tag file.
For descriptions of the Tag File categories, listed on the left side of the dialog, see Tag File Categories.
The following buttons are available on the Context Tagging® - Tag Files dialog:
Done - Saves tag file settings and closes the dialog box.
Add Files - Displays the Add Source Files dialog box, from which you can add a set of files to the currently selected tag file. This button will be unavailable for read-only tag files and auto-updated tag files. If you add files to your workspace tag file, you will be prompted if you want to also add the files to your project.
Add Tree - Displays the Add Tree dialog box, from which you can recursively add a directory of files to the currently selected tag file. This button will be unavailable for read-only tag files and auto-updated tag files. If you add files to your workspace tag file, you will be prompted if you want to also add the files to your project.
Remove Tag File - Deletes the currently selected tag file. You will be prompted whether or not to delete the tag file from the list, and then whether or not to permanently delete the tag file from disk. Note that some language-specific tag files are automatically generated, and thus will be automatically regenerated if you delete them.
Remove Src. File - Removes the selected files from the currently selected tag file. If no files are selected, you will be prompted whether or not to remove all source files from the tag file. If you remove files from your workspace tag file, you will be prompted if you want to also remove the files from your project.
Options - Displays the Context Tagging® Options screen for you to configure Context Tagging® options. See Context Tagging® Options for more information.
Up - Moves the selected tag file higher in the search order. This primarily applies to language-specific tag files (see Creating Language-Specific Tag Files).
Down - Moves the selected tag file lower in the search order. This primarily applies to language-specific tag files (see Creating Language-Specific Tag Files).
Add Tag File - Displays the Add Tag File dialog box, which allows you to choose from a list of languages the source type for which to insert the tag file. To automatically create tag files for C++, Java, and .NET, you can instead use the Create Tag Files for Compiler Libraries dialog (see Creating Tag Files for Compiler-Specific Libraries).
Retag Src. Files - Updates the Context Tagging information for the selected files in the currently selected tag file. If no files are selected, you will be prompted whether or not to retag all source files.
Rebuild Tag File - Displays the Rebuild Tag File dialog box containing options for rebuilding the selected file. See Rebuilding Tag Files.
Auto Tag - Displays the Create Tag Files for Compiler Libraries dialog box used to automatically create run-time library tag files for C++, Java, and .NET (see Creating Tag Files for Compiler-Specific Libraries).