Folder Alignment Overrides


Alignment override filters determine how files and/or folders from two sides of a folder comparison are matched, or aligned. By default DeltaWalker aligns files and folders by their names, that is for two resources to be compared their names need to be the same. For example, a file named data.txt in first/left panel can only be compared to a file named data.txt

Oftentimes however there's a need to align and compare resources with different names, for example data.txt with data.log. Entrer Alignment Overrides.


To create a new alignment override filter go to Filters Preference Page and select New->Alignment Override:

Add new filter

In the Add New Filter dialog type in the expressions to do the name matching. For example, adding *.log for the first resource name and *.txt for the second resource name tells the folder comparison engine to ignore the file extensions when matching files with extensions .log and .txt. The following before and after screenshots illustrate the result:

Before, with no alignment override filter.

Folder comparison without align filter

After, using the above described alignment override filter:

Folder comparison with align filter

Use the Apply to folders field to specify one or more folders this alignment override should be applied to. If you are working with large folder hierarchies, specifying apply to folders can greatly speed up the overall folder comparison performance.


As with the include/exclude folder comparison filters, both shell, and the more powerful and complex, regular expression filters can be used.

A shell expression can use the following special characters:

? matches any single character once. For example test??.log will match any name which starts with "test", then has 2 other characters and ends with ".log" e.g. test12.log, testAZ.log, but not testA.log

* matches any character zero or more times. For example test*.log will match any name which starts with "test", then has any characters and ends with ".log" e.g. test1.log, testMyFile.log, even test.log, but not test.logs

Alignment override filters can be made more powerful by using regular instead of shell expressions. The purpose of an alignment override filter is to match two strings, specifically the names of two file system resources, using two regular expressions. To achieve that it uses a special, proprietary pattern object referred to as a dual pattern. A dual pattern is a pattern that matches 2 strings using 2 regular expressions - primary and secondary.

The first regex is named primary, because the second refers to it. The second is named secondary because it references/refers to the first one. The type of referencing presently supported is Group referencing i.e. making a reference in the secondary pattern to a group from the primary pattern.

For example if test(\d).txt is the primary and test($1).log is the secondary expression, ($1) is a reference in secondary regex to 1-st group in the primary. This will align files test1.txt with test1.log, test2.txt with test2.log, etc.


sample.txtsample.logNoAligns "sample.txt" with "sample.log
*.txt*.logNoAligns files with extension "txt" to files with extension "log" e.g. "file1.txt" -> "file1.log", "readme.txt" -> "readme.log", etc.
start*.htmindex*.htmlNoAligns files with prefix "start" and extension "htm" to files with prefix "index" and extension "html" e.g. "start_page1.htm" -> "index_page1.html", "start_help.htm" -> "index_help.html", etc.
Log_(\d+)\.log($1)\.txtYesAligns file names beginning with "Log_" followed by at least one digit, ending with extension "htm" with file names without the "Log_" prefix followed by the same digits as in first file name and ending with extension "txt". For example: "Log_20120616.log" -> "20120616.txt", "Log_20120617.log" -> "20120617.txt", etc.

See Also