[src/trunk]: src/distrib/notes/common More MI release notes updates, particul...

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

details:   https://anonhg.NetBSD.org/src/rev/85fa1928e936
branches:  trunk
changeset: 781085:85fa1928e936
user:      riz <riz%NetBSD.org@localhost>
date:      Fri Aug 17 19:55:14 2012 +0000

description:
More MI release notes updates, particularly around installing.

This could use more love!

diffstat:

 distrib/notes/common/postinstall |  54 +++++++++++++++------------------------
 distrib/notes/common/sysinst     |  50 ++++++++++++++++++++++++++++++------
 2 files changed, 62 insertions(+), 42 deletions(-)

diffs (166 lines):

diff -r 6895be12728c -r 85fa1928e936 distrib/notes/common/postinstall
--- a/distrib/notes/common/postinstall  Fri Aug 17 19:43:24 2012 +0000
+++ b/distrib/notes/common/postinstall  Fri Aug 17 19:55:14 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: postinstall,v 1.75 2012/05/26 05:51:13 tsutsui Exp $
+.\"    $NetBSD: postinstall,v 1.76 2012/08/17 19:55:14 riz Exp $
 .\"
 .\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -346,28 +346,25 @@
 usually in the
 .Pa \*M/\*V/All
 subdir.
-You can install them with the following commands under
-.Xr sh 1 :
+If you installed
+.Xr pkgin 1 
+in the
+.Ic sysinst
+post-installation configuration menu, you can use it to automatically install
+binary packages over the network.
+Assuming that
+.Pa /usr/pkg/etc/pkgin/repositories.conf
+is correctly configured, you can install them with the following commands:
 .Pp
 .Bd -unfilled
-.Ic # PKG_PATH=ftp://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/\*M/\*V/All
-.Ic # export PKG_PATH
-.Ic # pkg_add -v tcsh
-.Ic # pkg_add -v bash
-.Ic # pkg_add -v perl
-.Ic # pkg_add -v apache
-.Ic # pkg_add -v kde
-.Ic # pkg_add -v firefox
+.Ic # pkgin install tcsh
+.Ic # pkgin install bash
+.Ic # pkgin install perl
+.Ic # pkgin install apache
+.Ic # pkgin install kde
+.Ic # pkgin install firefox
 \&...
 .Ed
-.Pp
-If you are using
-.Xr csh 1
-then replace the first two lines with the following:
-.Pp
-.Bd -unfilled
-.Ic # setenv PKG_PATH ftp://ftp.NetBSD.org/pub/pkgsrc/packages/NetBSD/\*M/\*V/All
-.Ed
 .(Note
 Some mirror sites don't mirror the
 .Pa /pub/pkgsrc
@@ -378,21 +375,12 @@
 the Perl programming language, Apache web server, KDE desktop
 environment and the Firefox web browser 
 as well as all the packages they depend on.
-.(Note
-In some cases the
-.Xr pkg_add 1
-command will complain about a version mismatch of packages with a message
-like the following:
-.Dl Warning: package `foo' was built for a different version of the OS:
-.Dl NetBSD/i386 M.N (pkg) vs. NetBSD/i386 \*V (this host) ,
-This warning is harmless if the formal major release numbers are the same
-between the pkg and your host.
-Please refer to the NetBSD release glossary and graphs at
-.Lk http://www.NetBSD.org/releases/release-map.html
-for more information about NetBSD's release numbering scheme.
-.Note)
 .It
-The framework for compiling packages can be obtained by
+If you did not install it from the 
+.Ic sysinst
+post-installation configuration menu, the
+.Xr pkgsrc 7
+framework for compiling packages can be obtained by
 retrieving the file
 .Lk ftp://ftp.NetBSD.org/pub/pkgsrc/pkgsrc.tar.gz .
 It is typically extracted into
diff -r 6895be12728c -r 85fa1928e936 distrib/notes/common/sysinst
--- a/distrib/notes/common/sysinst      Fri Aug 17 19:43:24 2012 +0000
+++ b/distrib/notes/common/sysinst      Fri Aug 17 19:55:14 2012 +0000
@@ -1,6 +1,6 @@
-.\"    $NetBSD: sysinst,v 1.101 2011/05/27 17:50:41 tsutsui Exp $
+.\"    $NetBSD: sysinst,v 1.102 2012/08/17 19:55:14 riz Exp $
 .\"
-.\" Copyright (c) 1999-2004 The NetBSD Foundation, Inc.
+.\" Copyright (c) 1999-2012 The NetBSD Foundation, Inc.
 .\" All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -390,7 +390,11 @@
 The main menu will be displayed.
 .\} \" \n[mac68k]
 .ie \n[alpha]:\n[amd64]:\n[i386] \{\
-Insert the CD into the drive and boot the computer.
+Insert the CD into the drive 
+.if \n[amd64]:\n[i386] \{\
+or the USB memstick into an available USB port
+.\}
+and boot the computer from it.
 .if \n[alpha] \{\
 Type
 .Pp
@@ -438,6 +442,7 @@
   * c: Re-install sets or install additional sets *
   * d: Reboot the computer                        *
   * e: Utility menu                               *
+  * f: Config menu                                *
   * x: Exit Install System                        *
   .***********************************************.
 . cs \n(.f
@@ -499,7 +504,13 @@
 .\}
 .el \{\
 .Me CD-ROM
-as the medium.
+as the medium
+.if \n[amd64]:\n[i386] \{\
+if booted from CD-ROM, or
+.Me Local directory
+if booted from USB memstick
+.\}
+\&.
 The default values for the path and device should be ok.
 .\}
 .It
@@ -1603,11 +1614,32 @@
 If you have already configured networking, you will be asked if you want to
 use this configuration for normal operation.
 If so, these values will be installed in the network configuration files.
-The next menu will allow you to select the time zone that you're in,
-to make sure your clock has the right offset from UTC.
-Finally you will be asked to select a password encryption algorithm
-and can then set a password for the "root" account, to prevent
-the machine from coming up without access restrictions.
+.It
+.To 2 "Configure additional items"
+.Em Configure additional items
+.Pp
+The next menu will allow you to select a number of additional items
+to configure, including the time zone that you're in,
+to make sure your clock has the right offset from UTC,
+the root user's shell, and the initial root password.
+.Pp
+You can also enable installation of binary packages, which installs the
+.Xr pkgin 1
+tool for managing binary packages for third-party software.
+This will
+feel familiar to users of other package tools, such as
+.Ic apt-get
+or
+.Ic yum .
+Or, you can install the
+.Xr pkgsrc 7
+tree for installing third-party software from source.
+.Pp
+Finally, you can enable some daemons such as
+.Xr sshd 8 ,
+.Xr ntpd 8 ,
+or
+.Xr mdnsd 8 .
 .if \n[sparc64] \{\
 .It
 .To 2 "Ensure you have the correct kernel installed"