Bug 84094

Summary: [PATCH] Serial Communication Doc Error
Product: Documentation Reporter: Devon H. O'Dell <dodell>
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
serial.diff none

Description Devon H. O'Dell 2005-07-25 22:00:30 UTC 
	The serial communications chapter of the handbook implies that setting up boot
	messages to be output on the serial console can be quickly achieved by inserting

	set console="comconsole"

	into /boot/loader.conf

	This is incorrect and will trigger a syntax error. Instead, the same line should
	be inserted into /boot/loader.rc _or_ the ``set'' part should be removed to give
	the equivilant for loader.conf(5)

	The attached patches contain a choice of corrections; I suppose it is up to the
	doc team to decide which is more applicable. I would personally prefer the
	loader.conf(5) one (the second patch) since changing loader.rc generally seems
	to me to be a bad idea.

How-To-Repeat: 	N/A
Comment 1 John Baldwin freebsd_committer freebsd_triage 2005-07-25 22:37:46 UTC 
On Monday 25 July 2005 04:57 pm, Devon H. O'Dell wrote:
> >Description:
>
> 	The serial communications chapter of the handbook implies that setting up
> boot messages to be output on the serial console can be quickly achieved by
> inserting
>
> 	set console="comconsole"
>
> 	into /boot/loader.conf
>
> 	This is incorrect and will trigger a syntax error. Instead, the same line
> should be inserted into /boot/loader.rc _or_ the ``set'' part should be
> removed to give the equivilant for loader.conf(5)
>
> 	The attached patches contain a choice of corrections; I suppose it is up
> to the doc team to decide which is more applicable. I would personally
> prefer the loader.conf(5) one (the second patch) since changing loader.rc
> generally seems to me to be a bad idea.

Agreed.  This sort of thing belongs in loader.conf.

-- 
John Baldwin <jhb@FreeBSD.org>  <><  http://www.FreeBSD.org/~jhb/
"Power Users Use the Power to Serve"  =  http://www.FreeBSD.org
Comment 2 Marc Fonvieille freebsd_committer freebsd_triage 2005-07-26 10:29:51 UTC 
State Changed
From-To: open->closed

Fixed using loader.conf solution. 
Thanks.