From nobody@FreeBSD.org  Thu Jul 27 03:08:26 2006
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id BF4BA16A4DA
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 27 Jul 2006 03:08:26 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [216.136.204.117])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 86BB343D49
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 27 Jul 2006 03:08:26 +0000 (GMT)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.13.1/8.13.1) with ESMTP id k6R38QqG066105
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 27 Jul 2006 03:08:26 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.13.1/8.13.1/Submit) id k6R38QCt066104;
	Thu, 27 Jul 2006 03:08:26 GMT
	(envelope-from nobody)
Message-Id: <200607270308.k6R38QCt066104@www.freebsd.org>
Date: Thu, 27 Jul 2006 03:08:26 GMT
From: Martin Jackson <mhjacks@swbell.net>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook:  new options available for serial console
X-Send-Pr-Version: www-2.3

>Number:         100903
>Category:       docs
>Synopsis:       Handbook:  new options available for serial console
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    remko
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Jul 27 03:10:17 GMT 2006
>Closed-Date:    Wed Aug 23 23:41:03 GMT 2006
>Last-Modified:  Wed Aug 23 23:41:03 GMT 2006
>Originator:     Martin Jackson
>Release:        6.1-RELEASE-p3
>Organization:
>Environment:
FreeBSD anduril.minas.tirith 6.1-RELEASE-p3 FreeBSD 6.1-RELEASE-p3 #7: Sun Jul  9 16:45:37 CDT 2006     root@anduril.minas.tirith:/usr/obj/usr/src/sys/SERVER  i386

>Description:
As of 6.1-RELEASE, boot allows a -S command-line option to set the console terminal speed.  This eliminates the need to recompile boot blocks (as described in http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/serialconsole-setup.html).

It was educational to go through the recompile boot blocks process, but the Handbook should mention the new -S mechanism (it is documented in boot(8), e.g. http://www.freebsd.org/cgi/man.cgi?query=boot&apropos=0&sektion=0&manpath=FreeBSD+6.1-RELEASE&format=html)
>How-To-Repeat:
Always. :)
>Fix:
I suggest text such as the following:

NOTE:

As of 6.1-RELEASE, boot(8) accepts a -S command line parameter to set the serial console speed in lieu of recompiling and reinstalling the boot blocks as described here.  The -S command line option can be added to /boot.config like the other options documented on this page.
>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->remko 
Responsible-Changed-By: simon 
Responsible-Changed-When: Thu Jul 27 09:21:02 UTC 2006 
Responsible-Changed-Why:  
remko says he has been slacking too much lately and would like to have 
this PR assigned to him... well, perhaps it wasn't exatly like that he 
put it, but... :-) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=100903 

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Martin Jackson <mhjacks@swbell.net>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/100903: Handbook:  new options available for serial console
Date: Mon, 14 Aug 2006 18:02:02 +0300

 On 2006-07-27 03:08, Martin Jackson <mhjacks@swbell.net> wrote:
 > As of 6.1-RELEASE, boot allows a -S command-line option to set the
 > console terminal speed.  This eliminates the need to recompile boot
 > blocks (as described in
 > http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/serialconsole-setup.html).
 >
 > It was educational to go through the recompile boot blocks process,
 > but the Handbook should mention the new -S mechanism (it is documented
 > in boot(8))
 >
 > As of 6.1-RELEASE, boot(8) accepts a -S command line parameter to set
 > the serial console speed in lieu of recompiling and reinstalling the
 > boot blocks as described here.  The -S command line option can be
 > added to /boot.config like the other options documented on this page.
 
 Does the following patch look ok to you?  It changes the text of the
 relevant subsection to:
 
 #   22.6.5 Tips for the Serial Console
 #
 #   22.6.5.1 Setting a Faster Serial Port Speed
 #
 #   By default, the serial port settings are: 9600 baud, 8 bits, no
 #   parity, and 1 stop bit. If you wish to change the default console
 #   speed, you have two options:
 #
 #   * Recompile the boot blocks with BOOT_COMCONSOLE_SPEED set to the
 #     new console speed. See Section 22.6.5.2 for detailed instructions
 #     about building and installing new boot blocks.
 #
 #     If the serial console is configured in some other way than by
 #     booting with -h, or if the serial console used by the kernel is
 #     different from the one used by the boot blocks, then you must also
 #     add the following option to the kernel configuration file and
 #     compile a new kernel:
 #
 #          options CONSPEED=19200
 #
 #   * Use the -S boot option of the kernel. The -S command line option
 #     can be added to /boot.config. See the boot(8) manual page for a
 #     description of how to add options to /boot.config and a list of
 #     the supported options.
 #
 #   Note: FreeBSD versions before 6.1-RELEASE do not support the -S, so
 #   you will have to recompile the boot blocks if you are using a
 #   version older than 6.1-RELEASE.
 
 Patch and suggested commit log follows ...
 
 %%%
 # HG changeset patch
 # User Giorgos Keramidas <keramida@ceid.upatras.gr>
 # Date 1155567413 -10800
 # Node ID 61853d8fd21c61c152e434fabab6c130639e77c6
 # Parent  ad09c2f895e7e220abbed4774de296d6a69060c4
 Add a description of the -S kernel boot option and a note that
 this is available only for 6.1-RELEASE or newer FreeBSD versions.
 Also add a reference to boot(8) where -S and all the rest of the
 kernel boot options are described.
 
 PR:		docs/100903
 Submitted by:	Martin Jackson <mhjacks@swbell.net>
 
 diff -r ad09c2f895e7 -r 61853d8fd21c en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml
 --- a/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Mon Aug 14 02:26:09 2006 +0000
 +++ b/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Mon Aug 14 17:56:53 2006 +0300
 @@ -2625,23 +2625,41 @@ boot:</screen>
  	<title>Setting a Faster Serial Port Speed</title>
  
  	<para>By default, the serial port settings are: 9600 baud, 8
 -	  bits, no parity, and 1 stop bit.  If you wish to change the speed, you
 -	  need to recompile at least the boot blocks.  Add the following line
 -	  to <filename>/etc/make.conf</filename> and compile new boot
 -	  blocks:</para>
 -
 -	<programlisting>BOOT_COMCONSOLE_SPEED=19200</programlisting>
 -
 -	<para>See <xref linkend="serialconsole-com2"> for detailed
 -	  instructions about building and installing new boot blocks.</para>
 -
 -	<para>If the serial console is configured in some other way than by
 -	  booting with <option>-h</option>, or if the serial console used by
 -	  the kernel is different from the one used by the boot blocks, then
 -	  you must also add the following option to the kernel configuration
 -	  file and compile a new kernel:</para>
 -
 -	<programlisting>options CONSPEED=19200</programlisting>
 +	  bits, no parity, and 1 stop bit.  If you wish to change the default
 +	  console speed, you have two options:</para>
 +
 +	<itemizedlist>
 +	  <listitem>
 +	    <para>Recompile the boot blocks
 +	      with <makevar>BOOT_COMCONSOLE_SPEED</makevar> set to the new
 +	      console speed.  See <xref linkend="serialconsole-com2"> for
 +	      detailed instructions about building and installing new boot
 +	      blocks.</para>
 +
 +	    <para>If the serial console is configured in some other way than
 +	      by booting with <option>-h</option>, or if the serial console
 +	      used by the kernel is different from the one used by the boot
 +	      blocks, then you must also add the following option to the
 +	      kernel configuration file and compile a new kernel:</para>
 +
 +	    <programlisting>options CONSPEED=19200</programlisting>
 +	  </listitem>
 +
 +	  <listitem>
 +	    <para>Use the <option>-S</option> boot option of the kernel.
 +	      The <option>-S</option> command line option can be added
 +	      to <filename>/boot.config</filename>.  See the &man.boot.8;
 +	      manual page for a description of how to add options
 +	      to <filename>/boot.config</filename> and a list of the supported
 +	      options.</para>
 +	  </listitem>
 +	</itemizedlist>
 +
 +	<note>
 +	  <para>&os; versions before 6.1-RELEASE do not support
 +	    the <option>-S</option>, so you will have to recompile the boot
 +	    blocks if you are using a version older than 6.1-RELEASE.</para>
 +	</note>
        </sect3>
  
        <sect3 id="serialconsole-com2">
 %%%

From: Martin Jackson <mhjacks@swbell.net>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/100903: Handbook:  new options available for serial console
Date: Mon, 14 Aug 2006 19:11:47 -0500

 Giorgos Keramidas wrote:
 > On 2006-07-27 03:08, Martin Jackson <mhjacks@swbell.net> wrote:
 >> As of 6.1-RELEASE, boot allows a -S command-line option to set the
 >> console terminal speed.  This eliminates the need to recompile boot
 >> blocks (as described in
 >> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/serialconsole-setup.html).
 >>
 >> It was educational to go through the recompile boot blocks process,
 >> but the Handbook should mention the new -S mechanism (it is documented
 >> in boot(8))
 >>
 >> As of 6.1-RELEASE, boot(8) accepts a -S command line parameter to set
 >> the serial console speed in lieu of recompiling and reinstalling the
 >> boot blocks as described here.  The -S command line option can be
 >> added to /boot.config like the other options documented on this page.
 > 
 > Does the following patch look ok to you?  It changes the text of the
 > relevant subsection to:
 
 Hi Giorgos,
 
 Thanks for looking into this.  The verbiage you suggested sounds good.
 
 Since filing this PR, I have found yet a third way to accomplish the 
 same result (dual console, primary console on serial, at 115k baud), 
 which is to set the following variables in loader.conf:
 
 comconsole_speed="115200"
 console="comconsole,vidconsole"
 
 boot_multicons="YES"
 boot_serial="YES"
 
 Perhaps it would be good to mention these too, for completeness?
 
 I suspect that comconsole_speed only works in 6.1 or better as well.  It 
 was added in loader.conf 1.95.2.5, which was committed Jan. 27 of this 
 year.  The loader.conf mechanism is the one I'm currently using, 
 although I validated both of the other mechanisms as well.
 
 Should I file a separate PR for this?  I apologize for not updating the 
 PR under discussion here.
 
 Thanks,
 Marty

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Martin Jackson <mhjacks@swbell.net>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/100903: Handbook:  new options available for serial console
Date: Tue, 15 Aug 2006 04:30:58 +0300

 On 2006-08-14 19:11, Martin Jackson <mhjacks@swbell.net> wrote:
 >Giorgos Keramidas wrote:
 >>On 2006-07-27 03:08, Martin Jackson <mhjacks@swbell.net> wrote:
 >>> As of 6.1-RELEASE, boot allows a -S command-line option to set the
 >>> console terminal speed.  This eliminates the need to recompile boot
 >>> blocks (as described in
 >>> http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/serialconsole-setup.html).
 >>>
 >>> It was educational to go through the recompile boot blocks process,
 >>> but the Handbook should mention the new -S mechanism (it is
 >>> documented in boot(8))
 >>>
 >>> As of 6.1-RELEASE, boot(8) accepts a -S command line parameter to
 >>> set the serial console speed in lieu of recompiling and reinstalling
 >>> the boot blocks as described here.  The -S command line option can
 >>> be added to /boot.config like the other options documented on this
 >>> page.
 >>
 >> Does the following patch look ok to you?  It changes the text of the
 >> relevant subsection to:
 >
 > Hi Giorgos,
 > Thanks for looking into this.  The verbiage you suggested sounds good.
 
 Thanks.  With my laptop dead I can't test things so easily, so any
 review and comments you have that improve the text are quite helpful :)
 
 > Since filing this PR, I have found yet a third way to accomplish the
 > same result (dual console, primary console on serial, at 115k baud),
 > which is to set the following variables in loader.conf:
 >
 > comconsole_speed="115200"
 > console="comconsole,vidconsole"
 >
 > boot_multicons="YES"
 > boot_serial="YES"
 >
 > Perhaps it would be good to mention these too, for completeness?
 
 Definitely.
 
 > I suspect that comconsole_speed only works in 6.1 or better as well.
 > It was added in loader.conf 1.95.2.5, which was committed Jan. 27 of
 > this year.  The loader.conf mechanism is the one I'm currently using,
 > although I validated both of the other mechanisms as well.
 
 I'll go through the commit logs and see if this did indeed make it in
 6.1-RELEASE.  It is surely something we have to document too, but care
 must be taken not to confuse the reader into believing that a feature
 is there, while in reality it isn't.  August 15 is a national holiday
 here, so I'll have abundant time to check the sources and see when
 the comconsole_xxx="" options started being supported in RELENG_6.
 
 > Should I file a separate PR for this?  I apologize for not updating
 > the PR under discussion here.
 
 No, that's ok.  By replying to the initial followup I sent and keeping
 the Cc: to bug-followup@ which I added, you effectivelly notified Gnats
 (the bug database) to include your message as a followup in the audit
 trail of the PR.
 
 Thank you for the helpful comments,
 Giorgos
 

From: Martin Jackson <mhjacks@swbell.net>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/100903: Handbook:  new options available for serial console
Date: Mon, 14 Aug 2006 20:42:40 -0500

 > Thanks.  With my laptop dead I can't test things so easily, so any
 > review and comments you have that improve the text are quite helpful :)
 
 I'm happy to help. :)  FreeBSD's documentation is one of its (many) 
 selling points.
 
 > I'll go through the commit logs and see if this did indeed make it in
 > 6.1-RELEASE.  It is surely something we have to document too, but care
 > must be taken not to confuse the reader into believing that a feature
 > is there, while in reality it isn't.  August 15 is a national holiday
 > here, so I'll have abundant time to check the sources and see when
 > the comconsole_xxx="" options started being supported in RELENG_6.
 
 It definitely made it into 6.1-RELEASE - all of my systems are 
 6.1-RELEASE, and the comconsole_xxx loader tunables work for me on all 
 of them (though I did rebuild the boot blocks on at least two of them 
 before I figured this out...).  I agree though, that proper care for 
 users is important - quality and clarity of documentation are at least 
 as important as quantity. :)
 
 >> Should I file a separate PR for this?  I apologize for not updating
 >> the PR under discussion here.
 > 
 > No, that's ok.  By replying to the initial followup I sent and keeping
 > the Cc: to bug-followup@ which I added, you effectivelly notified Gnats
 > (the bug database) to include your message as a followup in the audit
 > trail of the PR.
 
 OK, thanks.  Some bug-tracking systems would prefer a separate entry. 
 My experience with FreeBSD has not been that way, but I thought it was 
 only fair to give you the choice. :)
 
 > Thank you for the helpful comments,
 
 No, thank *you*. :)
 
 Marty

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Martin Jackson <mhjacks@swbell.net>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/100903: Handbook:  new options available for serial console
Date: Thu, 24 Aug 2006 01:01:46 +0300

 On 2006-08-14 19:11, Martin Jackson <mhjacks@swbell.net> wrote:
 > Giorgos Keramidas wrote:
 > >Does the following patch look ok to you?  It changes the text of the
 > >relevant subsection to:
 > 
 > Hi Giorgos,
 > 
 > Thanks for looking into this.  The verbiage you suggested sounds good.
 > 
 > Since filing this PR, I have found yet a third way to accomplish the 
 > same result (dual console, primary console on serial, at 115k baud), 
 > which is to set the following variables in loader.conf:
 > 
 > comconsole_speed="115200"
 > console="comconsole,vidconsole"
 > 
 > boot_multicons="YES"
 > boot_serial="YES"
 > 
 > Perhaps it would be good to mention these too, for completeness?
 
 Hi!  I finally had some time to work on this patch :)
 
 An updated version of the patch, which includes the comconsole_speed=""
 option too is attached.  Can you please review it and tell me if you
 see anything that is not correct or could be written in a better way?
 
 %%%
 diff -r 7a3f4e4660ec en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml
 --- a/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Wed Aug 23 15:38:21 2006 +0000
 +++ b/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Thu Aug 24 00:59:56 2006 +0300
 @@ -2625,23 +2625,61 @@ boot:</screen>
  	<title>Setting a Faster Serial Port Speed</title>
  
  	<para>By default, the serial port settings are: 9600 baud, 8
 -	  bits, no parity, and 1 stop bit.  If you wish to change the speed, you
 -	  need to recompile at least the boot blocks.  Add the following line
 -	  to <filename>/etc/make.conf</filename> and compile new boot
 -	  blocks:</para>
 -
 -	<programlisting>BOOT_COMCONSOLE_SPEED=19200</programlisting>
 -
 -	<para>See <xref linkend="serialconsole-com2"> for detailed
 -	  instructions about building and installing new boot blocks.</para>
 -
 -	<para>If the serial console is configured in some other way than by
 -	  booting with <option>-h</option>, or if the serial console used by
 -	  the kernel is different from the one used by the boot blocks, then
 -	  you must also add the following option to the kernel configuration
 -	  file and compile a new kernel:</para>
 -
 -	<programlisting>options CONSPEED=19200</programlisting>
 +	  bits, no parity, and 1 stop bit.  If you wish to change the default
 +	  console speed, you have the following options:</para>
 +
 +	<itemizedlist>
 +	  <listitem>
 +	    <para>Recompile the boot blocks
 +	      with <makevar>BOOT_COMCONSOLE_SPEED</makevar> set to the new
 +	      console speed.  See <xref linkend="serialconsole-com2"> for
 +	      detailed instructions about building and installing new boot
 +	      blocks.</para>
 +
 +	    <para>If the serial console is configured in some other way than
 +	      by booting with <option>-h</option>, or if the serial console
 +	      used by the kernel is different from the one used by the boot
 +	      blocks, then you must also add the following option to the
 +	      kernel configuration file and compile a new kernel:</para>
 +
 +	    <programlisting>options CONSPEED=19200</programlisting>
 +	  </listitem>
 +
 +	  <listitem>
 +	    <para>Use the <option>-S</option> boot option of the kernel.
 +	      The <option>-S</option> command line option can be added
 +	      to <filename>/boot.config</filename>.  See the &man.boot.8;
 +	      manual page for a description of how to add options
 +	      to <filename>/boot.config</filename> and a list of the supported
 +	      options.</para>
 +	  </listitem>
 +
 +	  <listitem>
 +	    <para>Enable the options <varname>comconsole_speed</varname>
 +	      option in your <filename>/boot/loader.conf</filename>
 +	      file.</para>
 +
 +	    <para>This option depends on <varname>console</varname>,
 +	      <varname>boot_serial</varname>, and
 +	      <varname>boot_multicons</varname> being set in
 +	      <filename>/boot/loader.conf</filename> too.  An example of using
 +	      <varname>comconsole_speed</varname> to change the serial console
 +	      speed is:</para>
 +
 +	    <programlisting>boot_multicons="YES"
 +boot_serial="YES"</programlisting>
 +comconsole_speed="115200"
 +console="comconsole,vidconsole"</listitem>
 +	  </listitem>
 +	</itemizedlist>
 +
 +	<note>
 +	  <para>&os; versions before 6.1-RELEASE do not support the
 +	    <option>-S</option> or the <varname>comconsole_speed</varname>
 +	    option in <filename>/boot/loader.conf</filename>, so you will have
 +	    to recompile the boot blocks if you are using such a version of
 +	    &os;.</para>
 +	</note>
        </sect3>
  
        <sect3 id="serialconsole-com2">
 %%%

From: Giorgos Keramidas <keramida@FreeBSD.org>
To: Martin Jackson <mhjacks@swbell.net>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/100903: Handbook:  new options available for serial console
Date: Thu, 24 Aug 2006 01:05:35 +0300

 On 2006-08-24 01:01, Giorgos Keramidas <keramida@FreeBSD.org> wrote:
 > An updated version of the patch, which includes the comconsole_speed=""
 > option too is attached.  Can you please review it and tell me if you
 > see anything that is not correct or could be written in a better way?
 > 
 > %%%
 > [...]
 
 Oops!  Sorry, I included the wrong version of the patch.  This one has
 also gone through a build test and doesn't break the Handbook:
 
 %%%
 diff -r 7a3f4e4660ec en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml
 --- a/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Wed Aug 23 15:38:21 2006 +0000
 +++ b/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml	Thu Aug 24 01:02:27 2006 +0300
 @@ -2625,23 +2625,61 @@ boot:</screen>
  	<title>Setting a Faster Serial Port Speed</title>
  
  	<para>By default, the serial port settings are: 9600 baud, 8
 -	  bits, no parity, and 1 stop bit.  If you wish to change the speed, you
 -	  need to recompile at least the boot blocks.  Add the following line
 -	  to <filename>/etc/make.conf</filename> and compile new boot
 -	  blocks:</para>
 -
 -	<programlisting>BOOT_COMCONSOLE_SPEED=19200</programlisting>
 -
 -	<para>See <xref linkend="serialconsole-com2"> for detailed
 -	  instructions about building and installing new boot blocks.</para>
 -
 -	<para>If the serial console is configured in some other way than by
 -	  booting with <option>-h</option>, or if the serial console used by
 -	  the kernel is different from the one used by the boot blocks, then
 -	  you must also add the following option to the kernel configuration
 -	  file and compile a new kernel:</para>
 -
 -	<programlisting>options CONSPEED=19200</programlisting>
 +	  bits, no parity, and 1 stop bit.  If you wish to change the default
 +	  console speed, you have the following options:</para>
 +
 +	<itemizedlist>
 +	  <listitem>
 +	    <para>Recompile the boot blocks
 +	      with <makevar>BOOT_COMCONSOLE_SPEED</makevar> set to the new
 +	      console speed.  See <xref linkend="serialconsole-com2"> for
 +	      detailed instructions about building and installing new boot
 +	      blocks.</para>
 +
 +	    <para>If the serial console is configured in some other way than
 +	      by booting with <option>-h</option>, or if the serial console
 +	      used by the kernel is different from the one used by the boot
 +	      blocks, then you must also add the following option to the
 +	      kernel configuration file and compile a new kernel:</para>
 +
 +	    <programlisting>options CONSPEED=19200</programlisting>
 +	  </listitem>
 +
 +	  <listitem>
 +	    <para>Use the <option>-S</option> boot option of the kernel.
 +	      The <option>-S</option> command line option can be added
 +	      to <filename>/boot.config</filename>.  See the &man.boot.8;
 +	      manual page for a description of how to add options
 +	      to <filename>/boot.config</filename> and a list of the supported
 +	      options.</para>
 +	  </listitem>
 +
 +	  <listitem>
 +	    <para>Enable the options <varname>comconsole_speed</varname>
 +	      option in your <filename>/boot/loader.conf</filename>
 +	      file.</para>
 +
 +	    <para>This option depends on <varname>console</varname>,
 +	      <varname>boot_serial</varname>, and
 +	      <varname>boot_multicons</varname> being set in
 +	      <filename>/boot/loader.conf</filename> too.  An example of using
 +	      <varname>comconsole_speed</varname> to change the serial console
 +	      speed is:</para>
 +
 +	    <programlisting>boot_multicons="YES"
 +boot_serial="YES"
 +comconsole_speed="115200"
 +console="comconsole,vidconsole"</programlisting>
 +	  </listitem>
 +	</itemizedlist>
 +
 +	<note>
 +	  <para>&os; versions before 6.1-RELEASE do not support the
 +	    <option>-S</option> or the <varname>comconsole_speed</varname>
 +	    option in <filename>/boot/loader.conf</filename>, so you will have
 +	    to recompile the boot blocks if you are using such a version of
 +	    &os;.</para>
 +	</note>
        </sect3>
  
        <sect3 id="serialconsole-com2">
 %%%

From: Martin Jackson <mhjacks@swbell.net>
To: Giorgos Keramidas <keramida@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/100903: Handbook:  new options available for serial console
Date: Wed, 23 Aug 2006 18:04:05 -0500

 Giorgos Keramidas wrote:
 > On 2006-08-24 01:01, Giorgos Keramidas <keramida@FreeBSD.org> wrote:
 >> An updated version of the patch, which includes the comconsole_speed=""
 >> option too is attached.  Can you please review it and tell me if you
 >> see anything that is not correct or could be written in a better way?
 >>
 >> %%%
 >> [...]
 > 
 > Oops!  Sorry, I included the wrong version of the patch.  This one has
 > also gone through a build test and doesn't break the Handbook:
 
 That looks great!  I wouldn't change a thing. :)
 
 Thanks,
 Marty
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Wed Aug 23 23:38:18 UTC 2006 
State-Changed-Why:  
Fixed in revision 1.117 of 
doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml,v 

Thanks go to Martin, for submitting the original idea & reviewing 
my patches to the chapter, and to Remko for reviewing the text :) 

http://www.freebsd.org/cgi/query-pr.cgi?pr=100903 
>Unformatted:
