From owner-freebsd-doc Sun Mar 17 7: 1:40 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 4D9A237B443 for ; Sun, 17 Mar 2002 07:00:04 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g2HF04d69916; Sun, 17 Mar 2002 07:00:04 -0800 (PST) (envelope-from gnats) Received: from Kain.sumuk.de (Kain.sumuk.de [213.221.86.114]) by hub.freebsd.org (Postfix) with ESMTP id 22E5737B41D for ; Sun, 17 Mar 2002 06:53:54 -0800 (PST) Received: from Moses.earth.sol (Moses.earth.sol [192.168.1.1]) by Kain.sumuk.de (8.11.6/8.11.6) with ESMTP id g2HErqd06659 for ; Sun, 17 Mar 2002 15:53:52 +0100 (CET) (envelope-from martin@sumuk.de) Received: (from vincent@localhost) by Moses.earth.sol (8.11.6/8.11.6) id g2HErpQ55384; Sun, 17 Mar 2002 15:53:51 +0100 (CET) (envelope-from vincent) Message-Id: <200203171453.g2HErpQ55384@sumuk.de> Date: Sun, 17 Mar 2002 15:53:51 +0100 (CET) From: Martin Heinen Reply-To: Martin Heinen To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/36010: [PATCH] rename COMx: to COMx Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 36010 >Category: docs >Synopsis: [PATCH] rename COMx: to COMx >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: Sun Mar 17 07:00:03 PST 2002 >Closed-Date: >Last-Modified: >Originator: Martin Heinen >Release: FreeBSD 4.4-STABLE i386 >Organization: >Environment: System: FreeBSD Moses.earth.sol 4.4-STABLE FreeBSD 4.4-STABLE #0: Sat Dec 22 07:35:30 CET 2001 toor@Moses.earth.sol:/usr/obj/usr/src/sys/MOSES i386 >Description: Some parts of the documentation are using COM1: instead of COM1 to describe the first serial interface in MS-DOS. The device name should be COM1, ':' was used as separator by the mode command. Used 's/(COM[0-9]):/$1/g' to strip off the trailing colons. >How-To-Repeat: Read the chapters 'Installing FreeBSD', 'Serial Communications', the 'Pedantic PPP Primer', and an old DOS manual (if you still have one :) >Fix: Index: books/handbook/install/chapter.sgml =================================================================== RCS file: /u/cvs/doc/en_US.ISO8859-1/books/handbook/install/chapter.sgml,v retrieving revision 1.142 diff -u -r1.142 chapter.sgml --- books/handbook/install/chapter.sgml 2 Mar 2002 06:50:36 -0000 1.142 +++ books/handbook/install/chapter.sgml 17 Mar 2002 14:18:52 -0000 @@ -181,7 +181,7 @@ N/A - 3Com 56K faxmodem, on COM1: + 3Com 56K faxmodem, on COM1 Index: books/handbook/serialcomms/chapter.sgml =================================================================== RCS file: /u/cvs/doc/en_US.ISO8859-1/books/handbook/serialcomms/chapter.sgml,v retrieving revision 1.53 diff -u -r1.53 chapter.sgml --- books/handbook/serialcomms/chapter.sgml 28 Feb 2002 03:47:08 -0000 1.53 +++ books/handbook/serialcomms/chapter.sgml 17 Mar 2002 14:18:53 -0000 @@ -295,10 +295,10 @@ FreeBSD supports four serial ports by default. In the MS-DOS world, these are known as - COM1:, - COM2:, - COM3:, and - COM4:. FreeBSD currently supports + COM1, + COM2, + COM3, and + COM4. FreeBSD currently supports dumb multiport serial interface cards, such as the BocaBoard 1008 and 2016, as well as more intelligent multi-port cards such as those made by Digiboard @@ -404,10 +404,10 @@ A shell script called MAKEDEV in the /dev directory manages the device special files. To use MAKEDEV to make dial-up device - special files for COM1: (port 0), + special files for COM1 (port 0), cd to /dev and issue the command MAKEDEV ttyd0. Likewise, to make dial-up - device special files for COM2: (port 1), + device special files for COM2 (port 1), use MAKEDEV ttyd1. MAKEDEV not only creates the @@ -1311,7 +1311,7 @@ For example to set the termios flag crtscts on serial port #1's - (COM2:) dial-in and dial-out initialization + (COM2) dial-in and dial-out initialization devices, the following lines could be added to /etc/rc.serial: # Serial port initial configuration @@ -1968,30 +1968,30 @@ - Plug a dumb terminal into COM1: + Plug a dumb terminal into COM1 (sio0). If you do not have a dumb terminal, you can use an old PC/XT with a modem program, or the serial port on another Unix box. If - you do not have a COM1: + you do not have a COM1 (sio0), get one. At this time, there is - no way to select a port other than COM1: + no way to select a port other than COM1 for the boot blocks without recompiling the boot blocks. If you - are already using COM1: for another + are already using COM1 for another device, you will have to temporarily remove that device and install a new boot block and kernel once you get FreeBSD up and - running. (It is assumed that COM1: will + running. (It is assumed that COM1 will be available on a file/compute/terminal server anyway; if you - really need COM1: for something else + really need COM1 for something else (and you cannot switch that something else to - COM2: (sio1)), + COM2 (sio1)), then you probably should not even be bothering with all this in the first place.) Make sure the configuration file of your kernel has - appropriate flags set for COM1: + appropriate flags set for COM1 (sio0). Relevant flags are: @@ -2414,8 +2414,8 @@ BOOT_COMCONSOLE_PORT to the address of the port you want to use (0x3F8, 0x2F8, 0x3E8 or 0x2E8). Only sio0 through - sio3 (COM1: - through COM4:) can be used; multiport + sio3 (COM1 + through COM4) can be used; multiport serial cards will not work. No interrupt setting is needed. @@ -2424,7 +2424,7 @@ Create a custom kernel configuration file and add appropriate flags for the serial port you want to use. For example, if you want to make sio1 - (COM2:) the console: + (COM2) the console: device sio1 at isa? port "IO_COM2" tty flags 0x10 irq 3 Index: books/ppp-primer/book.sgml =================================================================== RCS file: /u/cvs/doc/en_US.ISO8859-1/books/ppp-primer/book.sgml,v retrieving revision 1.17 diff -u -r1.17 book.sgml --- books/ppp-primer/book.sgml 14 Feb 2002 23:21:41 -0000 1.17 +++ books/ppp-primer/book.sgml 17 Mar 2002 14:18:54 -0000 @@ -177,7 +177,7 @@ This guide assumes that the modem on the FreeBSD box is connected -to the first serial port ('/dev/cuaa0' or 'COM1:' in +to the first serial port ('/dev/cuaa0' or 'COM1' in DOS-terms). Finally, we will also assume that your Internet Service Provider (ISP) @@ -863,10 +863,10 @@ This statement informs the PPP program that it should use the first serial port. Under FreeBSD the '/dev/cuaa0' device is the same port that's -known as "COM1:" under DOS, Windows, Windows 95, etc.... +known as "COM1" under DOS, Windows, Windows 95, etc.... -If your modem is on COM2: you should specify -'/dev/cuaa1; COM3: would be '/dev/cuaa2'. +If your modem is on COM2 you should specify +'/dev/cuaa1; COM3 would be '/dev/cuaa2'. >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message