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

http://lvc.github.com/pkgdiff/