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>