pkgsrc-wip/pkg_summary-utils/files/pkg_update_src_summary.1
Aleksey Cheusov d653a0d02f upgraded to version 0.10.0
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.
2008-06-14 10:27:34 +00:00

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