Possible Handbook Typo

[John Baldwin]

On Tuesday 04 January 2005 02:55 pm, Nate Lawson wrote:
> John Baldwin wrote:
> > On Sunday 02 January 2005 01:33 am, Kevin Oberman wrote:
> >>>From: Bob Van Valzah <Bob at VanValzah.Com>
> >>>Date: Sat, 01 Jan 2005 18:37:05 -0600
> >>>Sender: owner-freebsd-acpi at freebsd.org
> >>>
> >>>I'm just reading the acpi-debug.html page in the handbook and I see
> >>>something that looks suspicious (to my eyes at least).
> >>>
> >>>Section 11.16.3.2 System Hangs (temporary or permanent) advises setting
> >>>hint.apic.0.disabled="1" in loader.conf.  Shouldn't hints go
> >>>in /boot/device.hints instead of loader.conf?
> >>>
> >>>I'm no expert in this area, so I thought I check it with the ACPI list
> >>>before submitting a PR.
> >>
> >>No typo.
> >>
> >>Hints may be in either the device.hints file or loader.conf, but in the
> >>case of ACPI, it's probably better to use loader.conf as it is processed
> >>earlier and ACPI starts doing things very early in the boot procedure,
> >
> > Nah, the boot only checks to see if ACPI is there, but that info isn't
> > used by the kernel if the disable hint is set.  Setting it in either file
> > is find.
>
> I recommend loader.conf since device.hints is overwritten during a full
> kernel upgrade while mergemaster handles loader.conf just fine (see
> src/UPDATING).

That's because the instructions are broken.  It does say '# as needed', but it 
really should be more like '# if you don't have one already'.

-- 
John Baldwin <jhb at FreeBSD.org>  <><  http://www.FreeBSD.org/~jhb/
"Power Users Use the Power to Serve"  =  http://www.FreeBSD.org