7ad7a55f22
Major changes
pkg_grep_summary: in order to support summaries for multi-variant
packages it is strongly recommented to use 'fvalue' variable in
condition, not $2. Man page and README update accordingly.
pkg_cmp_summary: -m option added for comparing summaries for
multi-variant packages
(PKGPATH=category/name:variable_assignments format).
pkg_cmp_summary -m implies -p
60 lines
1.8 KiB
Groff
60 lines
1.8 KiB
Groff
.\" $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
|