From owner-freebsd-doc@FreeBSD.ORG Mon Jul 25 21:00:32 2005 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5472916A41F for ; Mon, 25 Jul 2005 21:00:32 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6BF1A43D49 for ; Mon, 25 Jul 2005 21:00:31 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j6PL0V7N058851 for ; Mon, 25 Jul 2005 21:00:31 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j6PL0Vk3058846; Mon, 25 Jul 2005 21:00:31 GMT (envelope-from gnats) Resent-Date: Mon, 25 Jul 2005 21:00:31 GMT Resent-Message-Id: <200507252100.j6PL0Vk3058846@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, "Devon H. O'Dell" Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 8D98016A420 for ; Mon, 25 Jul 2005 20:57:54 +0000 (GMT) (envelope-from dodell@raqdevil.offmyserver.com) Received: from raqdevil.offmyserver.com (ext-unused-110.ixsystems.net [206.40.55.110]) by mx1.FreeBSD.org (Postfix) with ESMTP id 118BD43D55 for ; Mon, 25 Jul 2005 20:57:53 +0000 (GMT) (envelope-from dodell@raqdevil.offmyserver.com) Received: from raqdevil.offmyserver.com (smmsp@localhost [127.0.0.1]) by raqdevil.offmyserver.com (8.13.1/8.13.1) with ESMTP id j6PKvOxn083628 for ; Mon, 25 Jul 2005 13:57:24 -0700 (PDT) (envelope-from dodell@raqdevil.offmyserver.com) Received: (from root@localhost) by raqdevil.offmyserver.com (8.13.1/8.13.1/Submit) id j6PKvO3I083627; Mon, 25 Jul 2005 13:57:24 -0700 (PDT) (envelope-from dodell) Message-Id: <200507252057.j6PKvO3I083627@raqdevil.offmyserver.com> Date: Mon, 25 Jul 2005 13:57:24 -0700 (PDT) From: "Devon H. O'Dell" To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/84094: [PATCH] Serial Communication Doc Error X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: "Devon H. O'Dell" List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 25 Jul 2005 21:00:32 -0000 >Number: 84094 >Category: docs >Synopsis: [PATCH] Serial Communication Doc Error >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Jul 25 21:00:30 GMT 2005 >Closed-Date: >Last-Modified: >Originator: Devon H. O'Dell >Release: N/A >Organization: OffMyServer, Inc. >Environment: N/A >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. >How-To-Repeat: N/A >Fix: --- serial.diff begins here --- --- en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml.old Mon Jul 25 13:47:11 2005 +++ en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml.2 Mon Jul 25 13:47:32 2005 @@ -1948,7 +1948,7 @@ To see all boot messages on the serial console, issue the following command while logged in as the superuser: - &prompt.root; echo 'set console="comconsole"' > /boot/loader.conf + &prompt.root; echo 'set console="comconsole"' > /boot/loader.rc --- en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml.old Mon Jul 25 13:47:11 2005 +++ en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml Mon Jul 25 13:47:47 2005 @@ -1948,7 +1948,7 @@ To see all boot messages on the serial console, issue the following command while logged in as the superuser: - &prompt.root; echo 'set console="comconsole"' > /boot/loader.conf + &prompt.root; echo 'console="comconsole"' > /boot/loader.conf --- serial.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: