.\"	$NetBSD: pkg_cmp_summary.1,v 1.7 2008/09/07 18:17:38 cheusov Exp $
.\"
.\" Copyright (c) 2008 by Aleksey Cheusov (vle@gmx.net)
.\" Absolutely no warranty.
.\"
.Dd Feb 10, 2008
.Dt PKG_CMP_SUMMARY 1
.Sh NAME
.Nm pkg_cmp_summary
.Nd compares two summary files (pkg_summary(5) format)
.Sh SYNOPSIS
.Nm
.Op Ar OPTIONS
.Ar pkg_summary1 pkg_summary2
.Sh DESCRIPTION
.Nm
compares package versions in two pkg_summary(5) files.
These files may be generated by pkg_info -X, pkg_src_summary(1)
and other utils.
Actually only PKGNAME fields (and optionally PKGPATH) are used
for comparison.
.
Format of the results:
  <R> [PKGPATH] <PKGBASE> <VER1> <VER2>
 where R is
  -     present in the first file but absent in the second one (disappears)
  +     absent in the first file but present in the second one (appears/new)
  <NUM> more than one package with the same PKGBASE is in the first file
  =     versions are the same
  <     second file contains newer version
  >     second file contains earlier version
  ?     versions are incomparable (incorrect version, for example)
  !     versions are not equal (versions themselves are the same but
           CVS_CHECKSUMs are different)
.
 PKGBASE is PKGNAME with version stripped,
VER1 and VER2 are package versions.
PKGPATH appears in output if -p option is specified.
.Pp
The options are as follows:
.Bl -tag -width indent
.It Fl h
display help message
.It Fl p
use PKGPATH:PKGBASE pair for identifing a package, by default only PKGBASE
is used to identify the package.
.It Fl m
for comparing summaries for multi-variant packages
(PKGPATH=category/name:variable_assignments format of PKGPATH field)
.It Fl c
use CVS_CHECKSUM field for comparing in addition to PKGNAME (and PKGPATH)
.El
.Sh SEE ALSO
.Xr pkg_summary-utils 7 ,
.Xr pkg_summary 5 ,
.Xr pkg_src_summary 1 ,
.Xr pkg_info 1
.Sh AUTHOR
.An Aleksey Cheusov
.Aq vle@gmx.net