pkgdiff man page
Package — manual page for Package Changes Analyzer (PkgDiff) 1.7.2
Description
Name
Package Changes Analyzer
A tool for analyzing changes in Linux software packages
Description
Package Changes Analyzer (PkgDiff) is a tool for analyzing
changes in Linux software packages (RPM, DEB, TAR.GZ, etc).
The tool is intended for Linux maintainers who are interested
in ensuring compatibility of old and new versions of packages.
This tool is free software: you can redistribute it and/or
modify it under the terms of the GNU GPL.
Usage
pkgdiff PKG1 PKG2 [options]
Examples
pkgdiff OLD.rpm NEW.rpm
pkgdiff OLD.tar.gz NEW.tar.gz
Arguments
PKG1
Path to the old version of a package (RPM, DEB, TAR.GZ, etc).
If you need to analyze a group of packages then you can
pass an XML-descriptor of this group (VERSION.xml file):
<version>
/* Group version */
</version>
<group>
/* Group name */
</group>
<packages>
/path1/to/package(s)
/path2/to/package(s)
...
</packages>
PKG2
Path to the new version of a package (RPM, DEB, TAR.GZ, etc).
Information Options
-h|-help
Print this help.
-v|-version
Print version information.
-dumpversion
Print the tool version (1.7.2) and don't do anything else.
General Options
-report-path PATH
Path to the report.
Default:
pkgdiff_reports/<pkg>/<v1>_to_<v2>/changes_report.html
- -details
Try to create detailed reports.
- -size-limit SIZE
Don't analyze files larger than SIZE in kilobytes.
- -width WIDTH
-
Width of the Visual Diff.
Default: 75
- -prelines NUM
-
Size of the context in the Visual Diff.
Default: 10
- -ignore-space-change
Ignore changes in the amount of white space.
- -ignore-all-space
Ignore all white space.
- -ignore-blank-lines
Ignore changes whose lines are all blank.
- -quick
Quick mode without creating of Visual Diffs for files.
- -minimal
Try to find a smaller set of changes.
Other Options
-check-usage
Check if package content is used by other
packages in the repository.
-pkg-manager Name
Specify package management tool.
Supported:
urpm - Mandriva URPM
- -template
Create XML-descriptor template ./VERSION.xml
- -extra-info DIR
Dump extra info to DIR.
- -tmp-dir DIR
Use custom temp directory.
- -hide-unchanged
Don't show unchanged files in the report.
- -debug
Show debug info.
- -name NAME
Set name of the package to Name.
- -title TITLE
Set name of the package in the title of the report to TITLE.
- -vnum1 NUM
Set version number of the old package to NUM.
- -vnum2 NUM
Set version number of the new package to NUM.
- -links-target TARGET
-
Set target attribute for links in the report:
_self
_blank (default)
- -list-added-removed
Show content of added and removed text files.
- -skip-subarchives
Skip checking of archives inside the input packages.
- -skip-pattern REGEX
Skip checking of paths within archives matching REGEX.
- -d|-directories
Compare directories instead of packages.
Report
Report will be generated to:
pkgdiff_reports/<pkg>/<v1>_to_<v2>/changes_report.html
Exit Codes
0 - Unchanged. The tool has run without any errors.
non-zero - Changed or the tool has run with errors.
More Information
Author
Written by Andrey Ponomarenko.
Copyright
Copyright © 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.