Describe 'update' target.

1 files changed, 27 insertions, 2 deletions

diff --git a/Packages.txt b/Packages.txt
index 3a21bc9729d..88fc7369a3c 100644
--- a/Packages.txt
+++ b/Packages.txt
@@ -1,4 +1,4 @@
-# $NetBSD: Packages.txt,v 1.61 1999/08/28 11:36:22 dmcmahill Exp $
+# $NetBSD: Packages.txt,v 1.62 1999/08/29 22:27:11 rh Exp $
 ###########################################################################
 
 			==========================
@@ -1006,7 +1006,7 @@ perform the equivalent of:
  * deinstall:
    This target does a pkg_delete(1) in the current directory,
    effectively de-installing the package. The following variables can
-   be used either on the command line of in /etc/mk.conf to tune the
+   be used either on the command line or in /etc/mk.conf to tune the
    behaviour: 
 
     - PKG_VERBOSE:
@@ -1019,6 +1019,31 @@ perform the equivalent of:
       done in x11/kde, this is likely to remove whole KDE. Works by adding
       a "-R" to the pkg_delete command line.
 
+ * update:
+   This target causes the current package to be updated to the latest
+   version.  The package and all depending packages first get deinstalled,
+   then current versions of the corresponding packages get compiled and
+   installed.  This is similar to manually noting which packages are
+   currently installed, then performing a series of "make deinstall",
+   "make clean", and "make install" for these packages.  The following
+   variables can be used either on the command line or in /etc/mk.conf to
+   alter the behaviour of "make update":
+
+    - REINSTALL:
+      Do not recreate the list of depending packages, and do not
+      "make clean" for every package that gets updated.  This is
+      useful if you want to resume the updating process after an
+      error or pressing Control-C, e.g. through
+      "make update REINSTALL=1".
+
+    - INSTALL_TARGET:
+      Install target to use for the package to update.  Defaults
+      to "install".  E.g. "make update INSTALL_TARGET=package"
+
+    - DEPENDS_TARGET:
+      Install target to use for the depending packages.  Defaults
+      to "install".  E.g. "make update DEPENDS_TARGET=package"
+
  * readme:
    This target generates a README.html file, which can be viewed using a
    browser such as netscape (pkgsrc/www/mozilla) or lynx (pkgsrc/www/lynx).