Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

===================================================================
RCS file: /ftp/cvs/cvsroot/src/share/man/man7/release.7,v
rcsdiff: /ftp/cvs/cvsroot/src/share/man/man7/release.7,v: warning: Unknown phrases like `commitid ...;' are present.
retrieving revision 1.32
retrieving revision 1.32.2.1
diff -u -p -r1.32 -r1.32.2.1
--- src/share/man/man7/release.7	2012/01/14 22:56:31	1.32
+++ src/share/man/man7/release.7	2012/09/07 22:13:38	1.32.2.1
@@ -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,19 +122,11 @@ The root of the release hierarchy should
 files and subdirectories:
 .Pp
 .Bl -tag -width "\*[Lt]machine\*[Gt]"
-.It Sy iso/
-CDROM images in ISO 9660 format, usually created with
-.Dq ./build.sh ... iso-image ...
-after a
-.Dq ./build.sh -x ... release ...
-in
-.Pa src
-or created with
-.Dq ./build.sh ... iso-image-source ...
-after a
-.Dq ./build.sh -x ... release sourcesets ...
-in
-.Pa src .
+.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
@@ -143,10 +135,10 @@ Images in this directory, unlike images 
 .Aq Em rel
 .Sy /
 .Aq Em machine
-.Sy /installation/cdrom/
+.Sy /installation/\\*/
 .Xc
 .Sm on
-directory, contain file systems that
+directories, contain file systems that
 have an internal layout that corresponds to
 a complete release for a given machine type.
 If built with
@@ -155,10 +147,31 @@ 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"
+.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
+.Dq ./build.sh -x ... release ...
+in
+.Pa src
+or created with
+.Dq ./build.sh ... iso-image-source ...
+after a
+.Dq ./build.sh -x ... release sourcesets ...
+in
+.Pa src .
+.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/