Expand information about device.hints. Add information in the

cookbook section about needing to copy GENERIC.hints to
/boot/device.hints, as well as a footnote about exceptions to this
rule.

Partially suggested by: obrien

1 files changed, 17 insertions, 1 deletions

diff --git a/UPDATING b/UPDATING
index 8f7ae5ede361..a24cbe5cb38c 100644
--- a/UPDATING
+++ b/UPDATING
@@ -7,7 +7,18 @@ ITEMS:'
 
 20000825:
 	/boot/device.hints is now required for installkernel to
-	succeed.
+	succeed.  You should copy GENERIC.hints for your architecture
+	into /boot/device.hints.  If and only if you compile hints
+	into your kernel, then this file may be empty.  Please note,
+	if you have an empty or missing /boot/device.hints file and
+	you neglected to compile hints into your kernel, no boot
+	messages will appear after the boot loader tries to start the
+	kernel.
+
+20000821:
+	If you do NOT have ``options RANDOMDEV'' in your kernel and
+	you DO want the random device then add randomdev_load="YES" to
+	/boot/loader.conf.
 
 20000812:
 	suidperl is now always built and installed on the system, but
@@ -290,6 +301,7 @@ COMMON ITEMS:
 	-------------------------------------
 	make buildworld
 	make buildkernel KERNEL=YOUR_KERNEL_HERE
+	cp src/sys/${MACHINE_ARCH}/GENERIC.hints /boot/device.hints [2]
 	make installkernel KERNEL=YOUR_KERNEL_HERE
 	make installworld
 	[1]
@@ -311,6 +323,10 @@ COMMON ITEMS:
 	should disable them at this point so they don't crash your
 	system on reboot.
 
+	[2] If you have legacy ISA devices, you may need to create
+	your own device.hints to reflect your unique hardware
+	configuration.
+
 FORMAT:
 
 This file contains a list, in reverse chronologocal order, of major