$Idaemons: /home/cvs/pkgtools/README,v 1.30 2001/06/15 09:21:55 knu Exp $

You need to install the following ports to use these pkgtools.

	lang/ruby		- Ruby interpreter
	devel/ruby-fnmatch	- Ruby module that provides File::fnmatch
	devel/ruby-optparse	- Ruby option parser library

	devel/ruby-unit		- (Only if you do tests)

============
portupgrade
============

Portupgrade is a tool to upgrade installed packages via the port or
the package.

It upgrades ports without reinstalling depending or dependent packages
by directly modifying the package registry database located under
/var/db/pkg.

============
portversion
============

Portversion is a tool to compare the versions of install packages with
the ones in the ports tree.  It is mostly compatible with
pkg_version(1) in usage, except it is cooperative with portupgrade and
its command output is optimized for portupgrade.  Also, it is faster
than pkg_version(1) since portversion runs several make(1) instances
simultaneously. (four by default)

============
portsdb
============

Portsdb creates, updates or looks up ports database, which is made
from the ports index file.  It consists of INDEX.db (table part) and
INDEX.rbo (index part).  It is used by pkgdepfix's origin guesser, and
other tools in the future.  The file is automatically updated when it
is accessed through the portsdb library, if it is older than INDEX.

============
pkgdepfix
============

Pkgdepfix is an interactive tool for fixing the package registry
database.  It helps you resolve stale dependencies and complete stale
or missing origins.  It is recommended to run this periodically so
portupgrade and other pkg_* tools can work effectively.

-- 
                     /
                    /__  __            Akinori.org / MUSHA.org
                   / )  )  ) )  /     FreeBSD.org / Ruby-lang.org
Akinori MUSHA aka / (_ /  ( (__(  @ iDaemons.org / and.or.jp
