numdiff man page on DragonFly
[printable version]
NUMDIFF(1) User Commands NUMDIFF(1)
NAME
numdiff - compare similar files with numeric fields
DESCRIPTION
Usage: numdiff -h|--help|-v|--version or
numdiff [-s IFS][-D DELIMS][-a THRVAL[:RANGE|:RANGE1:RANGE2]][-r
THRVAL[:RANGE|:RANGE1:RANGE2]][-2][-F NUM][-# NUM][-P][-N][-I][-c CUR‐
RNAME][-d C1C2][-t C1C2][-g N1N2][-p C1C2][-n C1C2][-e C1C2][-i
C1C2][-X 1:RANGE][-X 2:RANGE][-E][-U][-b][-V][-O[NUM]][-q][-S][-z
1:RANGE][-z 2:RANGE][-Z 1:RANGE][-Z
2:RANGE][-m][-H][-f[NUM]][-T][-B][-l PATH][-o PATH] FILE1 FILE2
Compare putatively similar files line by line and field by field,
ignoring small numeric differences or/and different numeric formats.
RANGE, RANGE1 and RANGE2 stay for a positive integer value or for a
range of integer values, like 1-, 3-5 or -7. The two arguments after
the options are the names of the files to compare. The complete paths
of the files should be given, a directory name is not accepted. The
given paths cannot refer to the same file but one of them can be "-",
which refers to stdin.
Exit status: 1 if files differ, 0 if they are equal, -1 (255) in case
of error
-s, --separators=IFS
Specify the set of characters to use as delimiters while split‐
ting the input lines into fields (The default set of delimiters
is space, tab and newline). If IFS is prefixed with 1: or 2:
then use the given delimiter set only for the lines from the
first or the second file respectively
-D, --delimiters=DELIMS
Specify the set of strings to use as delimiters while splitting
the input lines into fields (The default set of delimiters is
space, tab and newline). If DELIMS is prefixed with 1: or 2:
then use the given delimiter set only for the lines from the
first or the second file respectively
-a, --absolute-tolerance=THRVAL[:RANGE|:RANGE1:RANGE2]
Set to THRVAL the maximum absolute difference permitted before
that two numeric fields are regarded as different (The default
value is zero). If a RANGE is given, use the specified thresh‐
old only when comparing fields whose positions lie in RANGE. If
both RANGE1 and RANGE2 are given and have the same length, then
use the specified threshold when comparing a field of FILE1
lying in RANGE1 with the corresponding field of FILE2 in RANGE2
-r, --relative-tolerance=THRVAL[:RANGE|:RANGE1:RANGE2]
Set to THRVAL the maximum relative difference permitted before
that two numeric fields are regarded as different (The default
value is zero). If a RANGE is given, use the specified thresh‐
old only when comparing fields whose positions lie in RANGE. If
both RANGE1 and RANGE2 are given and have the same length, then
use the specified threshold when comparing a field of FILE1
lying in RANGE1 with the corresponding field of FILE2 in RANGE2
-2, --strict
Consider two numerical values as equal only if both absolute and
relative difference do not exceed the corresponding tolerance
threshold
-F, --formula=NUM
Use the formula indicated by NUM to compute the relative errors.
If 'NUM' is 0 use the classic formula. If 'NUM' is 1 compute
the relative errors by considering the values in FILE1 as sample
values. If 'NUM' is 2 compute the relative errors by consider‐
ing the values in FILE2 as sample values.
-#, --digits=NUM
Set to NUM the number of digits in the significands used in mul‐
tiple precision arithmetic
-P, --positive-differences
Ignore all differences due to numeric fields of the second file
that are less than the corresponding numeric fields in the first
file
-N, --negative-differences
Ignore all differences due to numeric fields of the second file
that are greater than the corresponding numeric fields in the
first file
-I, --ignore-case
Ignore changes in case while doing literal comparisons
-c, --currency=CURRNAME
Set to CURRNAME the currency name for the two files to compare.
CURRNAME must be prefixed with 1: or 2: to specify the currency
name only for the first or the second file
-d, --decimal-point=C1C2
Specify the characters representing the decimal point in the two
files to compare
-t, --thousands-separator=C1C2
Specify the characters representing the thousands separator in
the two files to compare
-g, --group-length=N1N2
Specify the number of digits forming each group of thousands in
the two files to compare
-p, --plus-prefix=C1C2
Specify the (optional) prefixes for positive values used in the
two files to compare
-n, --minus-prefix=C1C2
Specify the prefixes for negative values used in the two files
to compare
-e, --exponent-letter=C1C2
Specify the exponent letters used in the two files to compare
-i, --imaginary-unit=C1C2
Specify the characters representing the imaginary unit in the
two files to compare
-X, --exclude=1:RANGE
Select the fields of the first file that have to be ignored
-X, --exclude=2:RANGE
Select the fields of the second file that have to be ignored
-E, --essential
While printing the differences between the two compared files
show only the numerical ones
-U, --dummy
While printing the differences between the two compared files
neglect all the numerical ones (dummy mode)
-b, --brief
Suppress all messages concerning the differences discovered in
the structures of the two files
-V, --verbose
For every couple of lines which differ in at least one field
print an header to show how these lines appear in the two com‐
pared files
-O, --overview[=NUM]
Display a side by side difference listing of the two files show‐
ing which lines are present only in one file, which lines are
present in both files but with one or more differing fields, and
which lines are identical. If 'NUM' is zero or is not speci‐
fied, output at most 130 columns per line. If 'NUM' is a posi‐
tive number, output at most 'NUM' columns per line. If 'NUM' is
a negative number, do not output common lines and display at
most -'NUM' columns per line.
-q, --quiet, --silent
Suppress all the standard output
-S, --statistics
Add some statistics to the standard output
-z, --blur-if-numerical=1:RANGE
Select the fields of the first file that have to be blurred dur‐
ing the synchronization procedure only if they turn out to be
numeric
-z, --blur-if-numerical=2:RANGE
Select the fields of the second file that have to be blurred
during the synchronization procedure only if they turn out to be
numeric
-Z, --blur-unconditionally=1:RANGE
Select the fields of the first file that have to be uncondition‐
ally blurred during the synchronization procedure
-Z, --blur-unconditionally=2:RANGE
Select the fields of the second file that have to be uncondi‐
tionally blurred during the synchronization procedure
-m, --minimal
During synchronization try hard to find a smaller set of changes
-H, --speed-large-files
During synchronization assume large files and many scattered
small changes
-f, --test-filter[=NUM]
Run only the filter and then show the results of its attempt to
synchronize the two files. If 'NUM' is zero or is not speci‐
fied, output at most 130 columns per line. If 'NUM' is a posi‐
tive number, output at most 'NUM' columns per line. If 'NUM' is
a negative number, do not output common lines and display at
most -'NUM' columns per line.
-T, --expand-tabs
Expand tabs to spaces in output while displaying the results of
the synchronization procedure (meaningful only together with
option -O or -f)
-B, --binary
Treat both files as binary files (only meaningful under Doz/Win‐
doz)
-l, --warnings-to=PATH
Redirect warning and error messages from stderr to the indicated
file
-o, --output=PATH
Redirect output from stdout to the indicated file
-h, --help
Show help message and predefined settings
-v, --version
Show version number, Copyright, Distribution Terms and NO-War‐
ranty
Default numeric format (for both files to compare):
Currency name = ""
Decimal point = `.'
Thousands separator = `,'
Number of digits in each thousands group = 3
Leading positive sign = `+'
Leading negative sign = `-'
Prefix for decimal exponent = `e'
Symbol used to denote the imaginary unit = `i'
COPYRIGHT
Copyright © 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 Ivano
Primi <ivprimi@libero.it>
License GPLv3+: GNU GPL version 3 or later, see
<http://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
SEE ALSO
The full documentation for numdiff is maintained as a Texinfo manual.
If the info and numdiff programs are properly installed at your site,
the command
info numdiff
should give you access to the complete manual.
numdiff 5.8.1 July 2013 NUMDIFF(1)
[top]
List of man pages available for DragonFly
Copyright (c) for man pages and the logo by the respective OS vendor.
For those who want to learn more, the polarhome community provides shell access and support.
[legal]
[privacy]
[GNU]
[policy]
[cookies]
[netiquette]
[sponsors]
[FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
|
|
Vote for polarhome
|
