NAME:¶

Package Changes Analyzer A tool for visualizing changes in Linux software packages

DESCRIPTION:¶

Package Changes Analyzer (PkgDiff) is a tool for visualizing changes in Linux software packages (RPM, DEB, TAR.GZ, etc).

The tool can compare directories as well (with the help of the -d option).

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] pkgdiff -d DIR1/ DIR2/ [options]

EXAMPLES:¶

pkgdiff OLD.rpm NEW.rpm pkgdiff OLD.deb NEW.deb 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.8) 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: 80

-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.

-no-wdiff

Do not use GNU Wdiff for analysis of changes. This may be two times faster, but produces lower quality reports.

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.

-c|-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 (default) _blank

-list-added-removed

Show content of added and removed text files.

-skip-subarchives

Skip checking of archives inside the input packages.

-skip-pattern REGEX

Don't check files matching REGEX.

-d|-directories

Compare directories instead of packages.

-all-text

Treat all files in the archive as text files.

-check-byte-code

When comparing Java classes, also check for byte code changes.

-full-method-diffs

Perform a full diff of method bodies when -check-byte-code is specified.

-track-unchanged

Track unchanged files in extra info.

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:¶

https://github.com/lvc/pkgdiff