[pkgsrc/trunk]: pkgsrc/pkgtools/pkg_install/files Stick the correct value of ...

[jmmv <jmmv%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/559616d9d634
branches:  trunk
changeset: 569965:559616d9d634
user:      jmmv <jmmv%pkgsrc.org@localhost>
date:      Thu Jan 21 21:58:05 2010 +0000

description:
Stick the correct value of PKG_DBDIR into the manpages instead of
pointing the user to /var/db/pkg, which may not be the right value if
it was customized.  Bump version to 20100121.

diffstat:

 pkgtools/pkg_install/files/add/pkg_add.1          |  536 ----------------------
 pkgtools/pkg_install/files/add/pkg_add.1.in       |  536 ++++++++++++++++++++++
 pkgtools/pkg_install/files/add/pkg_add.cat1       |  319 -------------
 pkgtools/pkg_install/files/admin/pkg_admin.1      |  356 --------------
 pkgtools/pkg_install/files/admin/pkg_admin.1.in   |  356 ++++++++++++++
 pkgtools/pkg_install/files/admin/pkg_admin.cat1   |  246 ----------
 pkgtools/pkg_install/files/configure.ac           |   12 +-
 pkgtools/pkg_install/files/create/pkg_create.1    |  515 ---------------------
 pkgtools/pkg_install/files/create/pkg_create.1.in |  515 +++++++++++++++++++++
 pkgtools/pkg_install/files/create/pkg_create.cat1 |  287 -----------
 pkgtools/pkg_install/files/delete/pkg_delete.1    |  316 ------------
 pkgtools/pkg_install/files/delete/pkg_delete.1.in |  316 ++++++++++++
 pkgtools/pkg_install/files/delete/pkg_delete.cat1 |  175 -------
 pkgtools/pkg_install/files/info/pkg_info.1        |  327 -------------
 pkgtools/pkg_install/files/info/pkg_info.1.in     |  327 +++++++++++++
 pkgtools/pkg_install/files/info/pkg_info.cat1     |  190 -------
 pkgtools/pkg_install/files/lib/version.h          |    4 +-
 pkgtools/pkg_install/files/view/pkg_view.1        |  278 -----------
 pkgtools/pkg_install/files/view/pkg_view.1.in     |  278 +++++++++++
 pkgtools/pkg_install/files/view/pkg_view.cat1     |  144 -----
 20 files changed, 2339 insertions(+), 3694 deletions(-)

diffs (truncated from 6126 to 300 lines):

diff -r 3362fccfa140 -r 559616d9d634 pkgtools/pkg_install/files/add/pkg_add.1
--- a/pkgtools/pkg_install/files/add/pkg_add.1  Thu Jan 21 20:45:07 2010 +0000
+++ /dev/null   Thu Jan 01 00:00:00 1970 +0000
@@ -1,536 +0,0 @@
-.\" $NetBSD: pkg_add.1,v 1.39 2010/01/20 22:34:47 jmmv Exp $
-.\"
-.\" FreeBSD install - a package for the installation and maintenance
-.\" of non-core utilities.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in the
-.\"    documentation and/or other materials provided with the distribution.
-.\"
-.\" Jordan K. Hubbard
-.\"
-.\"
-.\"     @(#)pkg_add.1
-.\"
-.Dd January 20, 2010
-.Dt PKG_ADD 1
-.Os
-.Sh NAME
-.Nm pkg_add
-.Nd a utility for installing and upgrading software package distributions
-.Sh SYNOPSIS
-.Nm
-.Op Fl AfILnRuVv
-.Op Fl K Ar pkg_dbdir
-.Op Fl m Ar machine
-.Op Fl P Ar destdir
-.Op Fl p Ar prefix
-.Op Fl W Ar viewbase
-.Op Fl w Ar view
-.Ar Oo Oo Li ftp|http Oc Ns Li :// Ns Oo Ar user Oc Ns \
-Oo Li \&: Ns Ar password Oc \
-Ns Li @ Oc Ns Ar host Ns Oo Li \&: Ns Ar port Oc Ns \
-Oo Li / Ns Ar path/ Oc Ns Ar pkg-name ...
-.Sh DESCRIPTION
-The
-.Nm
-command is used to extract and upgrade packages that have been
-previously created with the
-.Xr pkg_create 1
-command.
-Packages are prepared collections of pre-built binaries, documentation,
-configurations, installation instructions and/or other files.
-.Nm
-can recursively install other packages that the current package
-depends on or requires from both local disk and via FTP or HTTP.
-.Sh WARNING
-.Bf -emphasis
-Since the
-.Nm
-command may execute scripts or programs contained within a package file,
-your system may be susceptible to
-.Dq Trojan horses
-or other subtle
-attacks from miscreants who create dangerous package files.
-.Pp
-You are advised to verify the competence and identity of those who
-provide installable package files.
-For extra protection, use the digital signatures provided where possible
-(see the
-.Xr pkg_install.conf 5 ) ,
-or, failing that, use
-.Xr tar 1
-to extract the package file, and inspect its contents and scripts
-to ensure it poses no danger to your system's integrity.
-Pay particular attention to any
-.Pa +INSTALL
-or
-.Pa +DEINSTALL
-files, and inspect the
-.Pa +CONTENTS
-file for
-.Cm @cwd ,
-.Cm @mode
-(check for setuid),
-.Cm @dirrm ,
-.Cm @exec ,
-and
-.Cm @unexec
-directives, and/or use the
-.Xr pkg_info 1
-command to examine the package file.
-.Ef
-.Sh OPTIONS
-The following command line arguments are supported:
-.Bl -tag -width indent
-.It Ar pkg-name [ ... ]
-The named packages are installed.
-.Nm
-will first try to use
-.Ar pkg-name
-as full URL or path name without any wildcard processing.
-If that fails,
-.Nm
-will try to match packages using wildcard processing.
-If that fails as well and
-.Ar pkg-name
-does not contain any /, the entries of the
-.Dv PKG_PATH
-variable are searched using the wildcard processing rules.
-.It Fl A
-Mark package as installed automatically, as dependency of another
-package.
-You can use
-.Dl Ic pkg_admin set automatic=YES
-to mark packages this way after installation, and
-.Dl Ic pkg_admin unset automatic
-to remove the mark.
-If you
-.Nm
-a package without specifying
-.Fl A
-after it had already been automatically installed, the mark is
-removed.
-.It Fl f
-Force installation to proceed even if prerequisite packages are not
-installed or the install script fails.
-Although
-.Nm
-will still try to find and auto-install missing prerequisite packages,
-a failure to find one will not be fatal.
-This flag also overrides the fatal error when the operating system or
-architecture the package was built on differ from that of the host.
-.It Fl I
-If an installation script exists for a given package, do not execute it.
-.It Fl K Ar pkg_dbdir
-Set
-.Ar pkg_dbdir
-as the package database directory.
-See the
-.Sx ENVIRONMENT
-section below for details on how the default value is calculated.
-.It Fl L
-Don't add the package to any views after installation.
-.It Fl m
-Override the machine architecture returned by uname with
-.Ar machine .
-.It Fl n
-Don't actually install a package, just report the steps that
-would be taken if it was.
-.It Fl P Ar destdir
-Prefix all file and directory names with
-.Ar destdir .
-For packages without install scripts this has the same behavior as
-using chroot.
-.It Fl p Ar prefix
-Set
-.Ar prefix
-as the directory in which to extract files from a package.
-If a package has set its default directory, it will be overridden
-by this flag.
-Note that only the first
-.Cm @cwd
-directive will be replaced, since
-.Nm
-has no way of knowing which directory settings are relative and
-which are absolute.
-Only one directory transition is supported and the second one is expected to go
-into
-.Ar pkgdb .
-.It Fl R
-Do not record the installation of a package.
-This implies
-.Fl I .
-This means that you cannot deinstall it later, so only use this option if
-you know what you are doing!
-.It Fl u
-If the package that's being installed is already installed,
-an update is performed.
-It is currently not possible to update to an identical version.
-If this is specified twice, then any dependent packages that are
-too old will also be updated to fulfill the dependency.
-See below for a more detailed description of the process.
-.It Fl V
-Print version number and exit.
-.It Fl v
-Turn on verbose output.
-.It Fl W Ar viewbase
-Set
-.Ar viewbase
-as the base directory for the managed views.
-The default
-.Ar viewbase
-directory is set by
-.Xr pkg_view 1 .
-This value also may be set from the
-.Ev LOCALBASE
-environment variable.
-.It Fl w Ar view
-Set the
-.Ar view
-to which packages should be added after installation.
-The default
-.Ar view
-is set by
-.Xr pkg_view 1 .
-This value also may be set from the
-.Ev PKG_VIEW
-environment variable.
-.El
-.Pp
-One or more
-.Ar pkg-name
-arguments may be specified, each being either a file containing the
-package (these usually ending with the
-.Dq .tgz
-suffix) or a
-URL pointing at a file available on an ftp or web site.
-Thus you may extract files directly from their anonymous ftp or WWW
-locations (e.g.,
-.Nm
-ftp://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/i386/3.1_2007Q2/shells/bash-3.2.9.tgz
-or
-.Nm
-http://www.example.org/packages/screen-4.0.tbz).
-Note:  For ftp transfers, if you wish to use
-.Bf -emphasis
-passive mode
-.Ef
-ftp in such transfers, set the variable
-.Bf -emphasis
-FTP_PASSIVE_MODE
-.Ef
-to some value in your environment.
-Otherwise, the more standard ACTIVE mode may be used.
-If
-.Nm
-consistently fails to fetch a package from a site known to work,
-it may be because you have a firewall that demands the usage of
-.Bf -emphasis
-passive mode
-.Ef
-ftp.
-.Sh TECHNICAL DETAILS
-.Nm
-extracts each package's meta data (including the
-.Dq packing list )
-to memory and then runs through the following sequence to fully extract
-the contents of the package:
-.Bl -enum -offset indent
-.It
-A check is made to determine if the package or another version of it
-is already recorded as installed.
-If it is,
-installation is terminated if the
-.Fl u
-option is not given.
-.Pp
-If the
-.Fl u
-option is given, it's assumed the package should be replaced by the
-new version instead.
-Before doing so, all packages that depend on the
-pkg being upgraded are checked if they also work with the new version.
-If that test is successful, replacing is prepared by moving an existing
-.Pa +REQUIRED_BY
-file aside (if it exists), and running
-.Xr pkg_delete 1
-on the installed package.
-Installation then proceeds as if the package
-was not installed, and restores the
-.Pa +REQUIRED_BY
-file afterwards.
-.It
-The package build information is extracted from the
-.Pa +BUILD_INFO
-file and compared against the result of
-.Xr uname 3 .
-If the operating system or architecture of the package differ from
-that of the host, installation is aborted.
-This behavior is overridable with the
-.Fl f
-flag.
-.It
-The package build information from
-.Pa +BUILD_INFO
-is then checked for
-.Ev USE_ABI_DEPENDS=NO
-(or
-.Ev IGNORE_RECOMMENDED ) .
-If the package was built with ABI dependency recommendations ignored,
-a warning will be issued.
-.It
-A check is made to determine if the package conflicts (from
-.Cm @pkgcfl
-directives, see
-.Xr pkg_create 1 )
-with an already recorded as installed package or if an installed package
-conflicts with the package.
-If it is, installation is terminated.
-.It
-The file list of the package is compared to the file lists of the