[src/trunk]: src/distrib/notes/common mention etcupdate and reorder a bit

[snj <snj%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/9fa20e6c9a7e
branches:  trunk
changeset: 333691:9fa20e6c9a7e
user:      snj <snj%NetBSD.org@localhost>
date:      Fri Nov 14 07:06:40 2014 +0000

description:
mention etcupdate and reorder a bit

diffstat:

 distrib/notes/common/upgrade |  36 +++++++++++++++++++-----------------
 1 files changed, 19 insertions(+), 17 deletions(-)

diffs (62 lines):

diff -r 851603f60639 -r 9fa20e6c9a7e distrib/notes/common/upgrade
--- a/distrib/notes/common/upgrade      Fri Nov 14 03:31:41 2014 +0000
+++ b/distrib/notes/common/upgrade      Fri Nov 14 07:06:40 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: upgrade,v 1.28 2009/04/25 01:33:12 snj Exp $
+.\"    $NetBSD: upgrade,v 1.29 2014/11/14 07:06:40 snj Exp $
 .\"
 .\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -97,15 +97,10 @@
 .Pp
 The upgrade procedure
 is similar to an installation, but without the hard disk partitioning.
-.Ic sysinst
-will attempt to merge the settings stored in your
-.Pa /etc
-directory with the new version of
-.Nx .
-Also, file systems are checked before unpacking the sets.
-Fetching the binary
-sets is done in the same manner as the installation procedure;
-refer to the installation part of the document for help.
+.Pp
+Fetching the binary sets is done in the same manner as the installation
+procedure; refer to the installation part of the document for help.
+File systems are checked before unpacking the sets.
 .Pp
 After a new kernel has been copied to your hard disk, your
 machine is a complete
@@ -113,8 +108,7 @@
 \*V
 system.
 However, that doesn't mean that you're finished with the upgrade process.
-You will probably want to update the set of device
-nodes you have in
+You will probably want to update the set of device nodes you have in
 .Pa /dev .
 If you've changed the contents of
 .Pa /dev
@@ -125,9 +119,17 @@
 .Pp
 .Dl # Ic "sh MAKEDEV all"
 .Pp
-Finally, you will want to delete old binaries that were part
-of the version of
+.Ic sysinst
+will attempt to merge the settings stored in your
+.Pa /etc
+directory with the new version of
 .Nx
-that you upgraded from and have since been removed from the
-.Nx
-distribution.
+using the
+.Xr postinstall 8
+utility.
+However,
+.Xr postinstall 8
+is only able to deal with changes that are easily automated.
+It is recommended that you use the
+.Xr etcupdate 8
+tool to merge any remaining configuration changes.