summaryrefslogtreecommitdiff
path: root/development/diffoscope/diffoscope.1
diff options
context:
space:
mode:
Diffstat (limited to 'development/diffoscope/diffoscope.1')
-rw-r--r--development/diffoscope/diffoscope.1108
1 files changed, 108 insertions, 0 deletions
diff --git a/development/diffoscope/diffoscope.1 b/development/diffoscope/diffoscope.1
new file mode 100644
index 0000000000..a816cd5171
--- /dev/null
+++ b/development/diffoscope/diffoscope.1
@@ -0,0 +1,108 @@
+.\" Man page generated from reStructuredText.
+.
+.TH DIFFOSCOPE 1 "" "" "Debian"
+.SH NAME
+diffoscope \- in-depth comparison of files, archives, and directories
+.
+.nr rst2man-indent-level 0
+.
+.de1 rstReportMargin
+\\$1 \\n[an-margin]
+level \\n[rst2man-indent-level]
+level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
+-
+\\n[rst2man-indent0]
+\\n[rst2man-indent1]
+\\n[rst2man-indent2]
+..
+.de1 INDENT
+.\" .rstReportMargin pre:
+. RS \\$1
+. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
+. nr rst2man-indent-level +1
+.\" .rstReportMargin post:
+..
+.de UNINDENT
+. RE
+.\" indent \\n[an-margin]
+.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.nr rst2man-indent-level -1
+.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
+.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
+..
+.SH SYNOPSIS
+.INDENT 0.0
+.INDENT 3.5
+diffoscope [\-h] [\-\-version] [\-\-debug] [\-\-html output] [\-\-text output] [\-\-max\-report\-size bytes] [\-\-css url] file1 file2
+.UNINDENT
+.UNINDENT
+.SH DESCRIPTION
+.sp
+diffoscope will try to get to the bottom of what makes files or
+directories different. It will recursively unpack archives of many kinds
+and transform various binary formats into more human readable form to
+compare them. It can compare two tarballs, ISO images, or PDF just as
+easily.
+.sp
+It can be scripted through error codes, and a report can be produced
+with the detected differences. The report can be text or HTML.
+When no type of report has been selected, diffoscope defaults
+to write a text report on the standard output.
+.sp
+diffoscope is developed as part of the “reproducible builds” Debian
+project and was formerly known as “debbindiff”.
+.SH OPTIONS
+.INDENT 0.0
+.TP
+.B \-h\fP,\fB \-\-help
+show this help message and exit
+.TP
+.B \-\-version
+show program\(aqs version number and exit
+.TP
+.B \-\-debug
+display debug messages
+.TP
+.BI \-\-html \ output
+write HTML report to given file
+(use \- for standard output)
+.TP
+.BI \-\-text \ output
+write plain text report to given file
+(use \- for standard output)
+.TP
+.BI \-\-max\-report\-size \ BYTES
+maximum bytes written in report (default: 2048000)
+.TP
+.BI \-\-max\-diff\-block\-lines \ MAX_DIFF_BLOCK_LINES
+maximum number of lines per diff block (default: 50)
+.TP
+.BI \-\-max\-diff\-input\-lines \ MAX_DIFF_INPUT_LINES
+maximum number of lines fed to diff (default: 100000)
+.TP
+.BI \-\-fuzzy\-threshold \ FUZZY_THRESHOLD
+threshold for fuzzy\-matching (0 to disable, 60 is
+default, 400 is high fuzziness)
+.TP
+.B \-\-new\-file
+treat absent files as empty
+.TP
+.BI \-\-css \ url
+link to an extra CSS for the HTML report
+.UNINDENT
+.SH EXIT STATUS
+.sp
+Exit status is 0 if inputs are the same, 1 if different, 2 if trouble.
+.SH SEE ALSO
+.INDENT 0.0
+.IP \(bu 2
+\fI<https://diffoscope.org/>\fP
+.IP \(bu 2
+\fI<https://wiki.debian.org/ReproducibleBuilds>\fP
+.UNINDENT
+.SH AUTHOR
+Debian "Reproducible Builds" Team
+.SH COPYRIGHT
+GPL-3+
+.\" Generated by docutils manpage writer.
+.