pkgsrc-wip/pkg_summary-utils/files/pkg_cmp_summary.1

71 lines
2.1 KiB
Groff

.\" $NetBSD: pkg_cmp_summary.1,v 1.10 2008/11/07 17:55:46 cheusov Exp $
.\"
.\" Copyright (c) 2008 by Aleksey Cheusov (vle@gmx.net)
.\" Absolutely no warranty.
.\"
.\" ------------------------------------------------------------------
.de VB \" Verbatim Begin
.ft CW
.nf
.ne \\$1
..
.de VE \" Verbatim End
.ft R
.fi
..
.\" ------------------------------------------------------------------
.TH PKG_CMP_SUMMARY 1 "Feb 10, 2008" "" ""
.SH NAME
pkg_cmp_summary \- compares two summary files (pkg_summary(5) format)
.SH SYNOPSIS
.BI pkg_cmp_summary " [OPTIONS] pkg_summary1 pkg_summary2"
.SH DESCRIPTION
.B pkg_cmp_summary
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.
.P
Format of the results:
.VB
<R> [PKGPATH] <PKGBASE> <VER1> <VER2>
.VE
where R is
.VB
- 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)
.VE
.P
PKGBASE is PKGNAME with version stripped,
VER1 and VER2 are package versions.
PKGPATH appears in output if -p option is specified.
.SH OPTIONS
.TP
.B "-h|--help"
display help message
.TP
.B "-p|--with-pkgpath"
use PKGPATH:PKGBASE pair for identifing a package, by default only PKGBASE
is used to identify the package.
.TP
.B "-m|--multi"
for comparing summaries for multi-variant packages
(PKGPATH=category/name:variable_assignments format of PKGPATH field)
.TP
.B "-c|--use-checksum"
use CVS_CHECKSUM field for comparing in addition to PKGNAME (and PKGPATH)
.SH SEE ALSO
.BR pkg_summary-utils(7) ,
.BR pkg_summary(5) ,
.BR pkg_src_summary(1) ,
.BR pkg_info(1)
.SH AUTHOR
Aleksey Cheusov <vle@gmx.net>