added: pkg_summary-utils(7) that describes what pkg_summary-utils project is. All tools refer to it in its manual pages and pkg_summary-utils(7) refers to manual pages of all tools. pkg_src_summary: a list of fields listed in -f|--fields option may be separated by comma, not only space. PSS_OPTIONS environment variable specifies default options to be placed in front of any explicit options. See man page for the sample. -a and -r options added for adding and removing the specified fields to/from the list of fields generated by default. See man page for the samples. pkg_update_src_summary: a list of fields listed in -f|--fields option may be separated by comma, not only space.
59 lines
1.6 KiB
Groff
59 lines
1.6 KiB
Groff
.\" $NetBSD: pkg_update_src_summary.1,v 1.9 2008/06/14 10:27:35 cheusov Exp $
|
|
.\"
|
|
.\" Copyright (c) 2008 by Aleksey Cheusov (vle@gmx.net)
|
|
.\" Absolutely no warranty.
|
|
.\"
|
|
.Dd Jan 29, 2008
|
|
.Dt PKG_UPDATE_SRC_SUMMARY 1
|
|
.Sh NAME
|
|
.Nm pkg_update_src_summary
|
|
.Nd incrementally updates source packages summary
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Ar OPTIONS
|
|
.Ar summary_filename
|
|
.Sh DESCRIPTION
|
|
.Nm
|
|
incrementally updates source packages summary about all packages in
|
|
pkgsrc source tree.
|
|
Algorithm. 1) pkg_update_src_summary quickly obtains micro summary
|
|
information about all packages
|
|
from pkgsrc source tree, "micro" means PKGNAME and PKGPATH fields only.
|
|
2) compares package versions in summary_filename
|
|
and micro summary collected in step 1
|
|
by PKGNAME field using pkg_cmp_summary(1).
|
|
3) copies summary from summary_filename about unchanged packages.
|
|
4) collects full summary information about all changed and new packages
|
|
using pkg_src_summary(1).
|
|
5) new summary = step3 + step4
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width indent
|
|
.It Fl h
|
|
display help message
|
|
.It Fl f Ar filename
|
|
package names are obtained from a specified file, not from pkgsrc tree
|
|
.It Fl i Ar fields
|
|
list of fields (separated by space character or comma) to be
|
|
generated. By default full summary is generated, see
|
|
pkg_src_summary(1)
|
|
.El
|
|
.Sh ENVIRONMENT
|
|
.Bd -literal
|
|
.Bl -tag -width Cm
|
|
.It Cm PKGSRCDIR
|
|
pkgsrc root directory, defaults to /usr/pkgsrc
|
|
.It Cm BMAKE
|
|
path to pkgsrc friendly make utility, defaults to make
|
|
.El
|
|
.Ed
|
|
.Sh EXAMPLES
|
|
.Bd -literal
|
|
pkg_update_src_summary /usr/pkgsrc/pkg_src_summary.txt
|
|
.Ed
|
|
.Sh SEE ALSO
|
|
.Xr pkg_summary-utils 7 ,
|
|
.Xr pkg_src_summary 1
|
|
.Sh AUTHOR
|
|
.An Aleksey Cheusov
|
|
.Aq vle@gmx.net
|