improve word order in README.md
Added tag 2.4 for changeset 0fbf0ff12899
rename option "-c" to "-P"
xdiff.py
is a Python 3 script for comparing XML files. It outputs structural
and textual differences -- i.e. differences beyond different attribute orders or
different whitespace formatting.
The script is released 'as is' with no warranty under the GNU General Public License, version 2.0.
It requires the following Python 3 packages:
The lxml package internally calls the libxml2 and libxslt C libraries.
On Debian-based systems, the prerequisites can be installed as follows:
sudo apt-get install python3-blessings python3-lxml
Usage:
xdiff.py [-a] [--all-context]
[-C] [--force-color]
[-i] [--indent]
[-n] [--no-context]
[-N] [--no-meta]
[-p] [--pis]
[-P] [--comments]
[-q] [--quiet]
[-w] [--words]
<XML file 1>
<XML file 2>
xdiff.py [-v] [--version]
xdiff.py [-h] [--help]
The output of xdiff.py
mimics the unified format
of GNU diff, with three context lines
by default. The -a
option outputs all context lines, while the -n
option
outputs none. The option -N
suppresses metadata output (files header and hunk
numbers). If the option -i
is set, the diff is constructed from indented XML
trees. The option -w
option compares the content word-wise (one word per
line). Processing instructions and comments in the XML files are ignored unless
the options -p
and -P
are used. The -C
option preserves color and
formatting codes when piping output through
GNU less and similar programs.
The -q
suppresses output altogether, but still returns the exit status (1
if
there are structural or textual differences, 0
if there are none, and 2
for
errors).
Andreas Nolda (andreas@nolda.org)