[src/netbsd-6]: src Pull up following revision(s) (requested by riz in ticket...

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

details:   https://anonhg.NetBSD.org/src/rev/30b608edb0d3
branches:  netbsd-6
changeset: 774587:30b608edb0d3
user:      bouyer <bouyer%NetBSD.org@localhost>
date:      Fri Sep 07 22:13:38 2012 +0000

description:
Pull up following revision(s) (requested by riz in ticket #548):
        doc/README.files: revision 1.5
        share/man/man7/release.7: revision 1.33
        share/man/man7/release.7: revision 1.34
Update release(7) for the recent iso -> images change.
Fix typo.
The "iso" directory never made it into this file, but now
that "iso" is "images", document it here for the edification of
folks browsing the download directories.

diffstat:

 doc/README.files         |   4 ++-
 share/man/man7/release.7 |  67 ++++++++++++++++++++++++++++-------------------
 2 files changed, 43 insertions(+), 28 deletions(-)

diffs (113 lines):

diff -r f29b86768210 -r 30b608edb0d3 doc/README.files
--- a/doc/README.files  Fri Sep 07 15:43:22 2012 +0000
+++ b/doc/README.files  Fri Sep 07 22:13:38 2012 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: README.files,v 1.4 2007/12/14 21:15:52 pavel Exp $
+#      $NetBSD: README.files,v 1.4.20.1 2012/09/07 22:13:38 bouyer Exp $
 
 What's in this directory:
 
@@ -10,6 +10,8 @@
 
 README.files   This file.
 
+images/                Bootable images, including ISOs and USB disk images.
+
 patches/       Post-release binary code patches.
 
 shared/                Binary sets shared between multiple ports.
diff -r f29b86768210 -r 30b608edb0d3 share/man/man7/release.7
--- a/share/man/man7/release.7  Fri Sep 07 15:43:22 2012 +0000
+++ b/share/man/man7/release.7  Fri Sep 07 22:13:38 2012 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: release.7,v 1.32 2012/01/14 22:56:31 jmcneill Exp $
+.\"    $NetBSD: release.7,v 1.32.2.1 2012/09/07 22:13:38 bouyer Exp $
 .\"
 .\" Copyright (c) 1997, 2000, 2005 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 14, 2012
+.Dd September 6, 2012
 .Dt RELEASE 7
 .Os
 .Sh NAME
@@ -122,7 +122,35 @@
 files and subdirectories:
 .Pp
 .Bl -tag -width "\*[Lt]machine\*[Gt]"
-.It Sy iso/
+.It Sy images/
+Image files intended for use in installing
+.Nx .
+There are different types of images for different platforms, and sometimes
+multiple different image types for a single platform.
+.Pp
+Images in this directory, unlike images in the
+.Sm off
+.Xo
+.Sy .../NetBSD-
+.Aq Em rel
+.Sy /
+.Aq Em machine
+.Sy /installation/\\*/
+.Xc
+.Sm on
+directories, contain file systems that
+have an internal layout that corresponds to
+a complete release for a given machine type.
+If built with
+.Dq iso-image-source ,
+then it will also contain a
+.Dq source
+directory.
+These images are usually bootable.
+.Bl -tag -width "NetBSD-\*[Lt]rel\*[Gt]-\*[Lt]machine\*[Gt].iso"
+.It Sy MD5
+.It Sy SHA512
+.It Sy NetBSD- Ns Ao Em rel Ac Ns Sy - Ns Ao Em machine Ac Ns Sy .iso
 CDROM images in ISO 9660 format, usually created with
 .Dq ./build.sh ... iso-image ...
 after a
@@ -135,30 +163,15 @@
 .Dq ./build.sh -x ... release sourcesets ...
 in
 .Pa src .
-.Pp
-Images in this directory, unlike images in the
-.Sm off
-.Xo
-.Sy .../NetBSD-
-.Aq Em rel
-.Sy /
-.Aq Em machine
-.Sy /installation/cdrom/
-.Xc
-.Sm on
-directory, contain file systems that
-have an internal layout that corresponds to
-a complete release for a given machine type.
-If built with
-.Dq iso-image-source ,
-then it will also contain a
-.Dq source
-directory.
-These images are usually bootable.
-.Bl -tag -width "NetBSD-\*[Lt]rel\*[Gt]-\*[Lt]machine_arch\*[Gt].iso"
-.It Sy MD5
-.It Sy SHA512
-.It Sy NetBSD- Ns Ao Em rel Ac Ns Sy - Ns Ao Em machine Ac Ns Sy .iso
+.It Sy NetBSD- Ns Ao Em rel Ac Ns Sy - Ns Ao Em machine Ac Ns Sy -install.img.gz
+Bootable installation images intended to be written to any drive which
+appears as an
+.Xr sd 4
+type, such as USB flash disks.
+These images are created with
+.Dq ./build.sh ... install-image
+in
+.Pa src .
 .El
 .
 .It Sy shared/