Differences between revisions 4 and 5
Revision 4 as of 2012-10-30 08:29:39
Size: 2615
Comment: Corrected report between 2.16.0 and 2.16.90: merged glibc-ports-2.16.0 to glibc-2.16.0
Revision 5 as of 2013-05-22 13:10:50
Size: 2880
Comment: Added results for 2.17 and 2.18
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
#pragma section-numbers 2
Line 11: Line 12:
$ wget https://github.com/downloads/pkgdiff/pkgdiff/pkgdiff-1.4.tar.gz
$ tar -xzf pkgdiff-1.4.tar.gz
$ cd pkgdiff-1.4
$ wget https://github.com/pkgdiff/pkgdiff/archive/1.5.tar.gz
$ tar -xzf pkgdiff-1.5.tar.gz
$ cd pkgdiff-1.5
Line 18: Line 19:
=== Create a release package ===
Execute this command in the new subdirectory of the glibc source tree:
{{{
../configure
make dist
}}}
Line 34: Line 42:
|| [[http://sourceware.org/git/?p=glibc.git|Git]] (2012/10/29) || [[http://upstream-tracker.org/pkgdiff_reports/glibc/2.16.0_to_2.16.90/changes_report.html|2.1%]] || || [[http://sourceware.org/git/?p=glibc.git|Git]] (2013/05/21) || [[http://upstream-tracker.org/pkgdiff_reports/glibc/2.17_to_2.18/changes_report.html|3.5%]] ||
|| 2.17 || [[http://upstream-tracker.org/pkgdiff_reports/glibc/2.16.0_to_2.17/changes_report.html|11.9%]] ||

Diff tool

This document describes how to use the PkgDiff tool to create a visual diff report for the final glibc release package and review changes since the previous release. The tool classifies files in the packages, detects added, removed, moved, renamed and changed files and estimates changes in them.

1. Installation

The tool needs Perl 5, GNU Diff, GNU WDiff, GNU Awk and GNU Binutils to be installed on your host.

To install the tool run

$ wget https://github.com/pkgdiff/pkgdiff/archive/1.5.tar.gz
$ tar -xzf pkgdiff-1.5.tar.gz
$ cd pkgdiff-1.5
$ sudo perl Makefile.pl -install --prefix=/usr

2. Usage

2.1. Create a release package

Execute this command in the new subdirectory of the glibc source tree:

../configure
make dist

2.2. Compare packages

To compare the new release package (say glibc-2.17.tar.gz) with the old one (glibc-2.16.tar.gz) run

$ pkgdiff glibc-2.16.tar.gz glibc-2.17.tar.gz

2.3. View report

The visual diff report will be generated to

pkgdiff_reports/glibc/2.16_to_2.17/changes_report.html

The report should be analyzed by the glibc maintainer to approve changes made by the developers before releasing/uploading the package. Currently, glibc source code contains about 14370 files. The biggest classes of files are: C program (7464), Header file (2156) and Assembler program (1802). To navigate over these groups of files use sorting by Status or Delta by clicking on the appropriate table header.

3. Current results

This section provides information about current diff reports for the glibc packages.

Version

Changes

Git (2013/05/21)

3.5%

2.17

11.9%

2.16

12%

2.15

2.1%

2.14.1

0.1%

2.14

4.6%

2.13

4. Samples

1. Diff report between glibc 2.15 and 2.16

None: Testing/Diff_tool (last edited 2013-05-22 13:10:50 by AndreyPonomarenko)