REPODIFFER(1)

NAME
repodiffer - report differences between repository histories

SYNOPSIS

repodiffer [--ignore parts] [--quiet] [--verbose level] [--show-equal] [--changes-only] [--full-hash] [--tree-diff] [--legacy-map mapfile] [--single id1=id2] repo-or-stream1 repo-or-stream2

DESCRIPTION

This tool reports differences between two repository histories. The histories may be presented as git repository directories or as fast-import streams, or as one of each.

Revisions are first paired into correspondence by committer and commit date. Any revision in the left-hand (L) history that cannot be paired with a revision in the right-hand (R) history is interpreted as having been deleted; any revision in the R history that cannot be paired with a revision in the L history is interpreted as having been inserted.

For each changed, inserted, or deleted revision, a summary line is emitted identifying it by commit ID (for a repo) or mark (for a stream file) in the first history. In change reports, the corresponding revision in the second history is similarly identified and the report indicates the nature of the changes.

A trailing statistics line summarizes the operation counts.

Tags and heads are compared as well. Two tags match if their contents do and they point at paired commits.

OPTIONS

The --changes-only or -c option shows changes only, suppressing listing of insertions and deletions.

The --show-equal or -e option enables listing of equal commits.

The --legacy-map or -m option takes a legacy map file in the format produced by reposurgeon, associating legacy commit IDs with committer/time pairs. If the tool can find a matching committer/time pair for a commit in this file, reports on this commit (and any matched pair it is part of) will be decorated with the legacy ID of the commit. (This will work, in particular, for displaying Subversion revisions of commits lifted from a Subversion file.)

The --single or -s option compares single commits in detail. The argument must be a pair of commit IDs (marks or hashes) separated by an equals sign.

The --ignore or -i option causes differences between specified parts to be ignored. Part tags are as follows:

author
    Ignore differences in the (name part of the) author field.

authordate
    Ignore differences in the author date part.

committer
    Ignore differences in the (name part of the) committer field.

committerdate
    Ignore differences in the commit date part

parents
    Ignore differences in parent links.

timezone
    Apply a modulo 360 operation to timestamps before comparison, so as to ignore time-zone skew.

tree
    Ignore tree-content differences. (It is not expected that this option will be useful; it is provided for completeness's sake.)

gitignore
    Ignore .gitignore and .cvsignore files when comparing tree content. Useful if you are comparing translations done by pairs of lifting tools only one of which lifts these; a notable case of this is reposurgeon vs. git-svn.

email
    Ignore email addresses when comparing names. This can be useful when comparing two repositories translated from Subversion; typically they'll have the Subversion Unix user ID as the name part of the address, but whether and how a host part is generated for the address varies.

One of these or a comma-separated list of several can be specified.

The --fullhash or -f option forces reporting of full 40-digit hash IDs, rather than the normal short hash.

Normally only the names of differing files are listed. With the --tree-diff option, context diffs of the files are listed.

The --quiet or -q option suppresses the progress meter.

The --verbose or -v option enables debugging messages that are probably only of interest to developers; consult the source code for details.

RETURN VALUES

For scripting use, this program returns 0 unless content (tree) differences were found in matching commits, in which case it returns 1. Right-side-only or left-side-only commits do not cause a return of 1, nor do differences in change comments only.

AUTHOR

Eric S. Raymond <esr@thyrsus.com>. This tool is distributed with reposurgeon; see the project page at http://www.catb.org/~esr/reposurgeon.