From owner-freebsd-doc Fri May 17 9:20:45 2002 Delivered-To: freebsd-doc@hub.freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id EE96D37B40B for ; Fri, 17 May 2002 09:20:02 -0700 (PDT) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g4HGK2N41615; Fri, 17 May 2002 09:20:02 -0700 (PDT) (envelope-from gnats) Received: from abigail.blackend.org (blackend.org [212.11.50.35]) by hub.freebsd.org (Postfix) with ESMTP id 62DB637B400 for ; Fri, 17 May 2002 09:16:13 -0700 (PDT) Received: from abigail.blackend.org (localhost [127.0.0.1]) by abigail.blackend.org (8.12.3/8.12.3/ - 15/04/02) with ESMTP id g4HGE1GW027981 for ; Fri, 17 May 2002 18:14:01 +0200 (CEST) (envelope-from marc@abigail.blackend.org) Received: (from marc@localhost) by abigail.blackend.org (8.12.3/8.12.3/Submit) id g4HGE0FM027980; Fri, 17 May 2002 18:14:00 +0200 (CEST) Message-Id: <200205171614.g4HGE0FM027980@abigail.blackend.org> Date: Fri, 17 May 2002 18:14:00 +0200 (CEST) From: Marc Fonvieille Reply-To: Marc Fonvieille To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/38188: Missing whitespaces in install chapter of the Handbook 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: 38188 >Category: docs >Synopsis: Missing whitespaces in install chapter of the Handbook >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: Fri May 17 09:20:02 PDT 2002 >Closed-Date: >Last-Modified: >Originator: Marc Fonvieille >Release: FreeBSD 4.6-PRERELEASE i386 >Organization: >Environment: System: FreeBSD abigail.blackend.org 4.6-PRERELEASE FreeBSD 4.6-PRERELEASE #5: Sun May 12 00:30:43 CEST 2002 marc@abigail.blackend.org:/usr/src/sys/compile/ABIGAIL i386 >Description: Missing whitespaces in install chapter of the Handbook. According to the fdp-primer 2 spaces should be used at the end of sentences. Read the patch below for more details. >How-To-Repeat: >Fix: Apply the patch to handbook/install/chapter.sgml --- chapter.sgml.diff begins here --- --- chapter.sgml.org Fri May 17 16:17:41 2002 +++ chapter.sgml Fri May 17 17:59:34 2002 @@ -228,7 +228,7 @@ extended partition. Each partition has a partition ID, which is - a number used to identify the type of data on the partition. FreeBSD + a number used to identify the type of data on the partition. FreeBSD partitions have the partition ID 165. In general, each operating system that you use will identify @@ -240,7 +240,7 @@ FreeBSD must be installed into a primary partition. FreeBSD can keep all its data, including any files that you create, on this one partition. However, if you have multiple disks, then you can create a - FreeBSD partition on all, or some, of them. When you install FreeBSD, + FreeBSD partition on all, or some, of them. When you install FreeBSD, you must have one partition available. This might be a blank partition that you have prepared, or it might be an existing partition that contains data that you no longer care about. @@ -325,14 +325,14 @@ Alpha You will need a dedicated disk for FreeBSD on the - Alpha. It is not possible to share a disk with another + Alpha. It is not possible to share a disk with another operating system at this time. Depending on the specific Alpha machine you have, this disk can either be a SCSI disk or an IDE disk, as long as your machine is capable of booting from it. Following the conventions of the Digital / Compaq - manuals all SRM input is shown in uppercase. SRM is case + manuals all SRM input is shown in uppercase. SRM is case insensitive. To find the names and types of disks in your machine, use @@ -350,18 +350,18 @@ pqb0.0.1.4.0 PQB0 PCI EIDE This example is from a Digital Personal Workstation - 433au and shows three disks attached to the machine. The + 433au and shows three disks attached to the machine. The first is a CDROM drive called DKA0 and the other two are disks and are called DKC0 and DKC100 respectively. Disks with names of the form DKx - are SCSI disks. For example DKA100 + are SCSI disks. For example DKA100 refers to a SCSI with SCSI target ID 1 on the first SCSI bus (A), whereas DKC300 refers to a SCSI disk - with SCSI ID 3 on the third SCSI bus (C). Devicename - PKx refers to the SCSI host bus adapter. As + with SCSI ID 3 on the third SCSI bus (C). Devicename + PKx refers to the SCSI host bus adapter. As seen in the SHOW DEVICE output SCSI CDROM drives are treated as any other SCSI hard disk drive. @@ -468,7 +468,7 @@ If you have FreeBSD on CDROM or DVD, and your computer allows you to boot from the CDROM or DVD (typically a BIOS option called Boot Order or similar) then you can skip this - section. The FreeBSD CDROM and DVD images are bootable and can be + section. The FreeBSD CDROM and DVD images are bootable and can be used to install FreeBSD without any other special preparation. @@ -908,7 +908,7 @@ - Drivers that have been marked inactive. They remain in the + Drivers that have been marked inactive. They remain in the kernel, but they will not probe for their device when the kernel starts. These are subdivided into groups in the same way as the active driver list. @@ -1073,8 +1073,8 @@ The last few hundred lines that have been displayed on screen are stored and can be reviewed. - To review the buffer, press Scroll Lock. This - turns on scrolling in the display. You can then use the arrow keys, or + To review the buffer, press Scroll Lock. This + turns on scrolling in the display. You can then use the arrow keys, or PageUp and PageDown to view the results. Press Scroll Lock again to stop scrolling. @@ -1276,7 +1276,7 @@ A different keyboard mapping may be chosen by selecting the menu item using up/down arrow keys and pressing Space. - Pressing Space again will unselect the item. When + Pressing Space again will unselect the item. When finished, choose the &gui.ok; using the arrow keys and press Enter. @@ -1327,7 +1327,7 @@ not need to be changed. The description of the selected item will appear at the - bottom of the screen highlighted in blue. Notice that one of the + bottom of the screen highlighted in blue. Notice that one of the options is Use Defaults to reset all values to startup defaults. @@ -1388,7 +1388,7 @@ . Then, if the first drive fails, or is attacked by a virus, or is scribbled upon by an operating system defect, he can easily recover by instructing the BIOS - to logically swap the drives. It is like switching the cables on the + to logically swap the drives. It is like switching the cables on the drives, but without having to open the case. SCSI @@ -1414,7 +1414,7 @@ Adventures: Bill breaks-down an older Wintel box to make another FreeBSD box - for Fred. Bill installs a single SCSI drive as SCSI unit zero and + for Fred. Bill installs a single SCSI drive as SCSI unit zero and installs FreeBSD on it. Fred begins using the system, but after several days notices that @@ -1453,7 +1453,7 @@ SCSI unit four, unit four became the new clone. When Bill re-ordered the SCSI BIOS so that he could boot from SCSI unit four, he - was only fooling himself. FreeBSD was still running on SCSI unit zero. + was only fooling himself. FreeBSD was still running on SCSI unit zero. Making this kind of BIOS change will cause some or all of the Boot and Loader code to be fetched from the selected BIOS drive, but when the FreeBSD kernel drivers take-over, the BIOS drive numbering will be @@ -1684,7 +1684,7 @@ partition they are contained in. FreeBSD also uses disk space for swap - space. Swap space provides FreeBSD with + space. Swap space provides FreeBSD with virtual memory. This allows your computer to behave as though it has much more memory than it actually does. When FreeBSD runs out of memory it moves some of the data that is not @@ -1753,13 +1753,13 @@ Slice numbers follow the device name, prefixed with an s, - starting at 1. So da0s1 - is the first slice on the first SCSI drive. There can only be + starting at 1. So da0s1 + is the first slice on the first SCSI drive. There can only be four physical slices on a disk, but you can have logical - slices inside physical slices of the appropriate type. These + slices inside physical slices of the appropriate type. These extended slices are numbered starting at 5, so ad0s5 is the first - extended slice on a disk. These devices are used by file + extended slice on a disk. These devices are used by file systems that expect to occupy a slice. Slices, dangerously dedicated physical @@ -1775,7 +1775,7 @@ Finally, each disk on the system is identified. A disk name starts with a code that indicates the type of disk, and then a number, indicating which disk it is. Unlike slices, disk numbering starts at - 0. Common codes that you will see are listed in + 0. Common codes that you will see are listed in . When referring to a partition FreeBSD requires that you also name @@ -2159,7 +2159,7 @@ Certain applications can benefit from particular partition schemes, especially if you are laying out partitions across more than - one disk. However, for this, your first FreeBSD installation, you do + one disk. However, for this, your first FreeBSD installation, you do not need to give too much thought to how you partition the disk. It is more important that you install FreeBSD and start learning how to use it. You can always re-install FreeBSD to change your partition @@ -2789,7 +2789,7 @@ Post-installation Configuration of various options follows the successful - installation. An option can be configured by re-entering the + installation. An option can be configured by re-entering the configuration options before booting the new FreeBSD system or after installation using /stand/sysinstall and selecting @@ -2898,8 +2898,8 @@ IP address of host forwarding packets to non-local - destinations. Fill this in only if the machine is a node - on the network. Leave this field blank + destinations. Fill this in only if the machine is a node + on the network. Leave this field blank if the machine is the gateway to the Internet for the network. @@ -2909,7 +2909,7 @@ Name server - IP address of your local DNS server. There is no local + IP address of your local DNS server. There is no local DNS server on this private local area network so the IP address of the provider's DNS server (208.163.10.2) was used. @@ -2941,7 +2941,7 @@ Any interface-specific options to ifconfig - you would like to add. There were none in this case. + you would like to add. There were none in this case. @@ -3018,7 +3018,7 @@ which of its Internet services will be available. The default FreeBSD inetd.conf(5) leaves all services disabled by default, so they must be specifically enabled in the configuration file before they will -function, even once inetd(8) is enabled. Note that services for +function, even once inetd(8) is enabled. Note that services for IPv6 must be seperately enabled from IPv4 services. Select [Yes] now to invoke an editor on /etc/inetd.conf, or [No] to @@ -3565,7 +3565,7 @@ Mouse Settings This option will allow you to cut and paste text in the - console and user programs with a 3-button mouse. If using a 2-button + console and user programs with a 3-button mouse. If using a 2-button mouse, refer to manual page, &man.moused.8;, after installation for details on emulating the 3-button style. This example depicts a non-USB mouse. @@ -3711,7 +3711,7 @@ There are several ways to configure the X - server. XF86Setup is fully graphical and + server. XF86Setup is fully graphical and probably the easiest. Use the arrow keys to select the XF86Setup and press Enter. @@ -3735,10 +3735,10 @@ [ OK ] Press Enter to switch to the graphics mode and - continue. It will not try to switch to the + continue. It will not try to switch to the graphics mode until Enter is pressed. The screen will go black and then shortly a screen with a large X in the - center will appear. Be patient and wait. + center will appear. Be patient and wait. After a few more moments, the XF86Setup introduction will display. Read all instructions @@ -3804,7 +3804,7 @@ additional help in configuring your video card. Select the appropriate video card from the list using the - scrollbar. Clicking on your card will show as + scrollbar. Clicking on your card will show as Card selected: above the list box. Next, the Detailed Setup was @@ -3817,19 +3817,19 @@ <guimenuitem>Monitor</guimenuitem> - There are two ways to proceed. One method requires that you + There are two ways to proceed. One method requires that you enter the horizontal and vertical sweep capabilities of your monitor in the text boxes. Choosing one of the monitor options listed that the monitor is the other method. After selecting a listed option, the horizontal and vertical sweep rates that will be used will - display. Compare those to your monitor specifications. The + display. Compare those to your monitor specifications. The monitor must be capable of using those ranges. Do not exceed the ratings of your monitor. Damage could - occur. If you have doubts select ABORT - and get the information. The remainder of the installation process + occur. If you have doubts select ABORT + and get the information. The remainder of the installation process will be unaffected and configuring the X-Server can be done later using /stand/sysinstall. @@ -3916,9 +3916,9 @@ by using xvidtune. There are warnings that improper settings can - damage your equipment. Heed them. If in doubt, do not do + damage your equipment. Heed them. If in doubt, do not do it. Instead, use the monitor controls to adjust the display for - x-windows. There may be some display differences when switching + x-windows. There may be some display differences when switching back to text mode, but it is better than damaging equipment. xvidtune can be ran later using /stand/sysinstall. @@ -4236,7 +4236,7 @@ Groups could also be added at this time if specific needs - are known. Otherwise, this may be accessed through using + are known. Otherwise, this may be accessed through using /stand/sysinstall after installation is completed. @@ -4260,7 +4260,7 @@ password. The password will need to be typed in twice - correctly. Needless to say, make sure you have a way of finding + correctly. Needless to say, make sure you have a way of finding the password if you forget. Changing local password for root. @@ -4309,8 +4309,8 @@ [ Yes ] No Select [ Yes ] and remove floppy if - booting from floppy. The CDROM drive is locked until the machine - starts to reboot. The CDROM drive is then unlocked and can + booting from floppy. The CDROM drive is locked until the machine + starts to reboot. The CDROM drive is then unlocked and can be removed from drive (quickly). The system will reboot so watch for any error messages that @@ -4519,7 +4519,7 @@ It is safe to turn off the power after the shutdown command has been issued and the message Please press any key to reboot - appears. If any key is pressed instead of turning off the power + appears. If any key is pressed instead of turning off the power switch, the system will reboot. You could also use the CTRL+ALT+DEL key @@ -4676,7 +4676,7 @@ DEFRAG utility (go into Explorer, right-click on the hard drive, and choose to defrag your - hard drive), or Norton Disk Tools. You then must run + hard drive), or Norton Disk Tools. You then must run FIPS. It will prompt you for the rest of the information it needs. Afterwards, you can reboot and install FreeBSD on the new @@ -4690,11 +4690,11 @@ There is also a very useful product from PowerQuest - called Partition Magic. This + called Partition Magic. This application has far more functionality than FIPS, and is highly recommended if you plan to often add/remove - operating systems (like me). However, it does cost + operating systems (like me). However, it does cost money, and if you plan to install FreeBSD once and then leave it there, FIPS will probably be fine for you. @@ -4829,17 +4829,17 @@ This type of installation is called a headless install, because the machine that you are trying to install FreeBSD on either does not have a monitor attached to it, or does not even - have a VGA output. How is this possible you ask? Using a - serial console. A serial console is basically using another + have a VGA output. How is this possible you ask? Using a + serial console. A serial console is basically using another machine to act as the main display and keyboard for a - system. To do this, just follow these steps: + system. To do this, just follow these steps: Fetch the Right Boot Floppy Images First you will need to get the right disk images so - that you can boot into the install program. The secret + that you can boot into the install program. The secret with using a serial console is that you tell the boot loader to send I/O through a serial port instead of displaying console output to the VGA device and trying to @@ -4918,9 +4918,9 @@ mount If you were to boot into the floppies that you just - made, FreeBSD would boot into its normal install mode. We + made, FreeBSD would boot into its normal install mode. We want FreeBSD to boot into a serial console for our - install. To do this, you have to mount the + install. To do this, you have to mount the kern.flp floppy onto your FreeBSD system using the &man.mount.8; command. @@ -4932,7 +4932,7 @@ &prompt.root; cd /mnt Here is where you must set the floppy to boot into a - serial console. You have to make a file called + serial console. You have to make a file called boot.config containing /boot/loader -h. All this does is pass a flag to the bootloader to boot into a serial console. @@ -4955,8 +4955,8 @@ null-modem cable You now need to connect a null modem cable between - the two machines. Just connect the cable to the serial - ports of the 2 machines. A normal serial cable + the two machines. Just connect the cable to the serial + ports of the 2 machines. A normal serial cable will not work here, you need a null modem cable because it has some of the wires inside crossed over. @@ -4965,7 +4965,7 @@ Booting Up for the Install - It is now time to go ahead and start the install. Put + It is now time to go ahead and start the install. Put the kern.flp floppy in the floppy drive of the machine you are doing the headless install on, and power on the machine. @@ -4987,7 +4987,7 @@ machine through your cu session now. It will ask you to put in the mfsroot.flp, and then it will come - up with a selection of what kind of terminal to use. Just + up with a selection of what kind of terminal to use. Just select the FreeBSD color console and proceed with your install! @@ -5264,11 +5264,11 @@ words, if you can connect to the ISP in Windows without using a script), then all you will need to do is type in dial at the - ppp prompt. Otherwise, + ppp prompt. Otherwise, you will need to know how to dial your ISP using the AT commands specific to your modem, as the PPP dialer provides only a very - simple terminal emulator. Please refer + simple terminal emulator. Please refer to the user-ppp handbook and FAQ entries for further information. If you have problems, logging can be directed to --- chapter.sgml.diff ends here --- >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message