<zzdiff>
To use this task, add this to your ANT build script:
<taskdef
classpath="path/to/zz-diff-x.y.z-jar-with-dependencies.jar"
resource="antlib.xml"
/>
Name | Description |
---|---|
absentFileMode="..."
|
Deprecated.
Use addedFileMode="..." and deletedFileMode="..." instead. |
addedFileMode="..."
|
Configures how files are reported that are missing in file1="..." .
|
contextSize="..."
|
Amount of "context", i.e. the number of lines before and after each difference; default is +- three lines (only relevant for "context diff" and "unified diff" formats). |
deletedFileMode="..."
|
Configures how files are reported that are missing in file2="..." .
|
diffMode="..."
|
Configures the style of the generated output. |
disassembleClassFiles="..."
|
Whether to disassemble .class files on-the-fly before comparing them.
|
disassembleClassFilesButHideLines="..."
|
Whether to suppress output of line numbers when disassembling .class files.
|
disassembleClassFilesButHideVars="..."
|
Whether to suppress output of local variables' names when disassembling .class files.
|
disassembleClassFilesSourceDirectory="..."
|
Where to look for source files when disassembling .class files; null disables source file loading.
|
disassembleClassFilesSymbolicLabels="..."
|
Whether to use numeric labels ('#123') or symbolic labels /'L12') in the bytecode disassembly. |
disassembleClassFilesVerbose="..."
|
Whether to include a constant pool dump, constant pool indexes, and hex dumps of all attributes in the disassembly output. |
encoding="..."
|
Encoding of the files being compared (defaults to default platform encoding). |
file1="..."
|
The first of the two files or the two directories to compare. |
file2="..."
|
The second of the two files or the two directories to compare. |
ignoreCPlusPlusStyleComments="..."
|
Whether to ignore C++-style comments ("// ... ") when comparing.
|
ignoreCStyleComments="..."
|
Whether to ignore C-style comments ("/* ... */ ") when comparing.
|
ignoreDocComments="..."
|
Whether to ignore doc comments ("/** ... */ ") when comparing.
|
ignoreWhitespace="..."
|
Whether to ignore whitespace differences. |
keepGoing="..."
|
Whether to continue with the next file when an error occurs. |
lookInto="..."
|
Look into compressed and archive contents if the format and the path match the given glob. |
out="..."
|
Write the DIFF output to the given file instead of STDOUT. |
path="..."
|
Compare only those documents who's pathes match the given path-glob. |
property="..."
|
Set the named property to "true " iff there are no differences between file1="..." and
file2="..." .
|
recurseSubdirectories="..."
|
Whether to recurse through subdirectories, rather than just compare the existence of subdirectories. |
reportUnchangedFiles="..."
|
Whether to also report unchanged files. |
sequential="..."
|
Whether to scan directories strictly sequentially; "false " means to parallelize the directory scan in
several threads.
|
tokenization="..."
|
|
Name | Description |
---|---|
<equivalentLine>
|
Lines that contain matches of a regular expression, and all capturing groups are equal, are regarded as equal. |
<equivalentPath>
|
Files with different pathes map iff their pathes match a regular expression, and all capturing groups are equal. |
<ignore>
|
Ignore differences where all lines (deleted, changed or added) match a regular expression. |
Default values are underlined.
recurseSubdirectories="true|false"
absentFileMode="REPORT_AS_ADDED_OR_DELETED|COMPARE_ADDED_AND_DELETED_WITH_EMPTY|COMPARE_ADDED_WITH_EMPTY"
addedFileMode="REPORT|COMPARE_WITH_EMPTY|IGNORE"
file1="..."
.
REPORT
:COMPARE_WITH_EMPTY
:IGNORE
:deletedFileMode="REPORT|COMPARE_WITH_EMPTY|IGNORE"
file2="..."
.
REPORT
:COMPARE_WITH_EMPTY
:IGNORE
:lookInto="format-glob:path-glob"
Supported archive formats are: [cpio, zip, dump, jar, tar, ar, arj, 7z].
Supported compression formats are: [snappy-raw, bzip2, gz, snappy-framed, pack200, xz, z, lzma].
The default is too look into any recognized archive or compressed contents.
Example:
lookInto="zip:**,tar:**,gz:**"
disassembleClassFiles="true|false"
.class
files on-the-fly before comparing them. disassembleClassFilesVerbose="true|false"
disassembleClassFilesSourceDirectory="value"
null
disables source file loading. Source
file loading is disabled by default. disassembleClassFilesButHideLines="true|false"
.class
files. disassembleClassFilesButHideVars="true|false"
.class
files. disassembleClassFilesSymbolicLabels="true|false"
encoding="charset"
diffMode="EXIST|BRIEF|NORMAL|CONTEXT|UNIFIED"
EXIST
:BRIEF
:NORMAL
:CONTEXT
:UNIFIED
:contextSize="n"
diffMode="..."
sequential="true|false"
false
" means to parallelize the directory scan in
several threads. tokenization="LINE|JAVA"
LINE
JAVA
ignoreCStyleComments="true|false"
/* ... */
") when comparing. "false
" means that
C-style comments are treated as Java™ tokens.
Notice that "doc comments" ("/** ... */
") are not regarded as C-style comments, and ignoring
of doc comments is controlled by a separate attribute (ignoreDocComments="..."
).
tokenization="..."
ignoreCPlusPlusStyleComments="true|false"
// ...
") when comparing. "false
" means that
C++-style comments are treated as Java™ tokens. Relevant iff tokenization="..."
is JAVA
.tokenization="..."
ignoreDocComments="true|false"
/** ... */
") when comparing. "false
" means that doc
comments are treated as Java™ tokens.tokenization="..."
property="property-name"
true
" iff there are no differences between file1="..."
and
file2="..."
.
(Particularly useful with diffMode
="QUIET
".
path="path-glob"
The "path" is the path of each file pair, less the path of file1 and file2, plus, iff the file is compressed and/or an archive, the path within the file.
! |
The decompressed file. |
!dir/file |
Entry "dir/file " in the archive file. |
!!dir/file |
Entry "dir/file " in the compressed archive file.
|
<equivalentPath>
<equivalentLine>
Iff the tokenization="..."
is different from LINE
, then the equivalence check described before is executed on the scanned tokens instead.
Copyright © 2022 Arno Unkrig. All rights reserved.