Subject: addition to Packages.txt to describe pkgtools/*
To: None <tech-pkg@netbsd.org>
From: Greg Troxel <gdt@ir.bbn.com>
List: tech-pkg
Date: 08/11/2003 09:31:04
I complained earlier that there was no way for someone to find out
about 'lintpkgsrc -r' (which someone had just reimplemented), and it was
duly suggested to me to send a diff rather than whining :-)
The below is a bit rough, but probably better than nothing.
--- Packages.txt.~1.305.~ Mon Aug 11 09:00:58 2003
+++ Packages.txt Mon Aug 11 09:27:30 2003
@@ -2519,6 +2519,51 @@
relative to ${WRKSRC}, just as in REPLACE_PERL
+ 10.35 Utilities for package management (pkgtools)
+ =================================================
+
+The directory pkgtools contains a number of useful utilities. This section
+attempts only to make the reader aware of the utilities and when they might
+be useful, and not to duplicate the documentation that comes with each
+package.
+
+Utilities used by pkgsrc (automatically installed when needed):
+ x11-links - symlinks for use by buildlink
+
+OS tool augmentation (automatically installed when needed):
+ digest - calculates SHA1 checksums (and other kinds)
+ use on operating systems where pkg_install is not present
+ libnbcompat - compat library for pkg tools
+ mtree - installed on non-BSD systems due to lack of native mtree
+ pkg_install - up-to-date replacement for /usr/sbin/pkg_install, or for
+
+Utilities used by pkgsrc (not automatically installed):
+ pkg_tarup - create a binary package from an already-installed package.
+ used by 'make replace' to save the old package
+ xpkgwedge - put X11 packages someplace else (see above)
+
+Utilities for keeping track of installed packages, being up to date, etc:
+ pkgchk - installs pkg_chk, which reports on packages whose installed
+ versions do not match the latest pkgsrc entries
+ pkgdep - makes dependency graphs of packages, to aid in choosing a
+ strategy for updating
+ pkgdepgraph - make graph from above (uses graphviz)
+ pkglint - This provides two distinct abilities:
+ check a pkgsrc entry for correctness
+ check for and remove out-of-date distfiles and binary
+ packages ('lintpkgsrc -r')
+ pkgsurvey - report what packages you have installed
+
+Utilities for people maintaining or creating individual packages:
+ pkgdiff - automate making and maintaining patches for a package
+ rpm2pkg, url2pkg - aids in converting to pkgsrc
+ gensolpkg - convert pkgsrc to a Solaris package
+
+Utilities for people maintaining pkgsrc (or more obscure pkg utilities)
+ pkgconflict - find packages that conflict but aren't marked as such
+ pkgcomp - build packages in a chrooted area
+ libkver - spoof kernel version for chrooted cross builds
+
11 Submitting & Committing
==========================
--
Greg Troxel <gdt@ir.bbn.com>