.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.49.2.
.TH PKGDIFF "1" "June 2022" "Package Changes Analyzer (PkgDiff) 1.7.2" "User Commands"
.SH NAME
pkgdiff \- a tool for visualizing changes in Linux software packages
.SH DESCRIPTION
.SS "NAME:"
.IP
Package Changes Analyzer
A tool for analyzing changes in Linux software packages
.SS "DESCRIPTION:"
.IP
Package Changes Analyzer (PkgDiff) is a tool for analyzing
changes in Linux software packages (RPM, DEB, TAR.GZ, etc).
.IP
The tool is intended for Linux maintainers who are interested
in ensuring compatibility of old and new versions of packages.
.IP
This tool is free software: you can redistribute it and/or
modify it under the terms of the GNU GPL.
.SS "USAGE:"
.IP
pkgdiff PKG1 PKG2 [options]
.SS "EXAMPLES:"
.IP
pkgdiff OLD.rpm NEW.rpm
pkgdiff OLD.tar.gz NEW.tar.gz
.SS "ARGUMENTS:"
.IP
PKG1
.IP
Path to the old version of a package (RPM, DEB, TAR.GZ, etc).
.IP
If you need to analyze a group of packages then you can
pass an XML\-descriptor of this group (VERSION.xml file):
.IP
<version>
.IP
/* Group version */
.IP
</version>
.IP
<group>
.IP
/* Group name */
.IP
</group>
.IP
<packages>
.IP
/path1/to/package(s)
/path2/to/package(s)
\&...
.IP
</packages>
.IP
PKG2
.IP
Path to the new version of a package (RPM, DEB, TAR.GZ, etc).
.SS "INFORMATION OPTIONS:"
.HP
\fB\-h\fR|\-help
.IP
Print this help.
.HP
\fB\-v\fR|\-version
.IP
Print version information.
.HP
\fB\-dumpversion\fR
.IP
Print the tool version (1.7.2) and don't do anything else.
.SS "GENERAL OPTIONS:"
.HP
\fB\-report\-path\fR PATH
.IP
Path to the report.
Default:
.IP
pkgdiff_reports/<pkg>/<v1>_to_<v2>/changes_report.html
.HP
\fB\-details\fR
.IP
Try to create detailed reports.
.HP
\fB\-size\-limit\fR SIZE
.IP
Don't analyze files larger than SIZE in kilobytes.
.HP
\fB\-width\fR WIDTH
.IP
Width of the Visual Diff.
Default: 75
.HP
\fB\-prelines\fR NUM
.IP
Size of the context in the Visual Diff.
Default: 10
.HP
\fB\-ignore\-space\-change\fR
.IP
Ignore changes in the amount of white space.
.HP
\fB\-ignore\-all\-space\fR
.IP
Ignore all white space.
.HP
\fB\-ignore\-blank\-lines\fR
.IP
Ignore changes whose lines are all blank.
.HP
\fB\-quick\fR
.IP
Quick mode without creating of Visual Diffs for files.
.HP
\fB\-minimal\fR
.IP
Try to find a smaller set of changes.
.SS "OTHER OPTIONS:"
.HP
\fB\-check\-usage\fR
.IP
Check if package content is used by other
packages in the repository.
.HP
\fB\-pkg\-manager\fR NAME
.IP
Specify package management tool.
Supported:
.IP
urpm \- Mandriva URPM
.HP
\fB\-template\fR
.IP
Create XML\-descriptor template ./VERSION.xml
.HP
\fB\-extra\-info\fR DIR
.IP
Dump extra info to DIR.
.HP
\fB\-tmp\-dir\fR DIR
.IP
Use custom temp directory.
.HP
\fB\-hide\-unchanged\fR
.IP
Don't show unchanged files in the report.
.HP
\fB\-debug\fR
.IP
Show debug info.
.HP
\fB\-name\fR NAME
.IP
Set name of the package to NAME.
.HP
\fB\-title\fR TITLE
.IP
Set name of the package in the title of the report to TITLE.
.HP
\fB\-vnum1\fR NUM
.IP
Set version number of the old package to NUM.
.HP
\fB\-vnum2\fR NUM
.IP
Set version number of the new package to NUM.
.HP
\fB\-links\-target\fR TARGET
.IP
Set target attribute for links in the report:
.IP
_self
_blank (default)
.HP
\fB\-list\-added\-removed\fR
.IP
Show content of added and removed text files.
.HP
\fB\-skip\-subarchives\fR
.IP
Skip checking of archives inside the input packages.
.HP
\fB\-skip\-pattern\fR REGEX
.IP
Skip checking of paths within archives matching REGEX.
.HP
\fB\-d\fR|\-directories
.IP
Compare directories instead of packages.
.SS "REPORT:"
.IP
Report will be generated to:
.IP
pkgdiff_reports/<pkg>/<v1>_to_<v2>/changes_report.html
.SS "EXIT CODES:"
.IP
0 \- Unchanged. The tool has run without any errors.
non\-zero \- Changed or the tool has run with errors.
.SS "MORE INFORMATION:"
.IP
http://lvc.github.com/pkgdiff/
.SH AUTHOR
This manual page was written by Peter Spiess-Knafl <dev@spiessknafl.at> for the
Debian GNU/Linux system (but may be used by others).
.PP
Written by Andrey Ponomarenko.
.SH COPYRIGHT
Copyright \(co 2016 Andrey Ponomarenko's ABI Laboratory
License: GNU GPL <http://www.gnu.org/licenses/>
This program is free software: you can redistribute it and/or modify it.