From owner-freebsd-doc@freebsd.org  Sun Apr  3 06:07:14 2016
Return-Path: <owner-freebsd-doc@freebsd.org>
Delivered-To: freebsd-doc@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id E161EADE294
 for <freebsd-doc@mailman.ysv.freebsd.org>;
 Sun,  3 Apr 2016 06:07:14 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "wonkity.com", Issuer "wonkity.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id B058F1E01
 for <freebsd-doc@freebsd.org>; Sun,  3 Apr 2016 06:07:13 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.15.2/8.15.2) with ESMTPS id u3367CAD077677
 (version=TLSv1.2 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO);
 Sun, 3 Apr 2016 00:07:12 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.15.2/8.15.2/Submit) with ESMTP id u3367CHo077674;
 Sun, 3 Apr 2016 00:07:12 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Sun, 3 Apr 2016 00:07:12 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: "Ronald F. Guilmette" <rfg@tristatelogic.com>
cc: freebsd-doc@freebsd.org
Subject: Re: Small suggestion/question about The Handbook (Sec 2.3.1)
In-Reply-To: <95642.1459645849@server1.tristatelogic.com>
Message-ID: <alpine.BSF.2.20.1604030004100.55574@wonkity.com>
References: <95642.1459645849@server1.tristatelogic.com>
User-Agent: Alpine 2.20 (BSF 67 2015-01-07)
MIME-Version: 1.0
Content-Type: text/plain; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Sun, 03 Apr 2016 00:07:12 -0600 (MDT)
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.21
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc/>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 03 Apr 2016 06:07:15 -0000

On Sat, 2 Apr 2016, Ronald F. Guilmette wrote:

>
> In message <alpine.BSF.2.20.1603312259520.97764@wonkity.com>,
> Warren Block <wblock@wonkity.com> wrote:
>
>> The short version:
>>
>>   Normal images are used to install FreeBSD on a BIOS computer or a
>>   computer with UEFI "CSM" enabled.
>>
>>   Installing in UEFI mode requires a uefi image.
>>
>> That's not hard to include, but will it help the user to decide which
>> image to download?
>
> Answer:  A little.
>
> As I've already admitted, most of this UEFI stuff is rather entirely
> opaque to me... undoubtedly because I haven't invested the time
> necessary to scour online documents enough to understand it.  Not
> even marginally.  (That's my fault, so mea cupla.)  However given that
> that FreeBSD Release Engineering folks are routinely going to all
> the trouble to create these full alternate sets of install images,
> it seems to me that it would be reasonable to invest at least a
> small additional amount of effort to describe for us end lusers
> the circumstances under which one of these alternate images would
> be either necessary or useful.  Right now, there's nothing.  No
> hints whatsoever.

Don't say I never got you anything. :)  Updated in r48525:
https://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/bsdinstall-pre.html#bsdinstall-installation-media

It is an even more brief mention than discussed above, but can be 
expanded.