From owner-freebsd-doc Mon Dec 3 8:50:13 2001 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 1A87337B417 for ; Mon, 3 Dec 2001 08:50:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id fB3Go1i01859; Mon, 3 Dec 2001 08:50:01 -0800 (PST) (envelope-from gnats) Received: from relay3-gui.server.ntli.net (relay3-gui.server.ntli.net [194.168.4.200]) by hub.freebsd.org (Postfix) with ESMTP id 0A20B37B416 for ; Mon, 3 Dec 2001 08:43:39 -0800 (PST) Received: from pc3-card4-0-cust122.cdf.cable.ntl.com ([62.254.251.122] helo=rhadamanth.private.submonkey.net ident=exim) by relay3-gui.server.ntli.net with esmtp (Exim 3.03 #2) id 16AwBn-00001G-00 for FreeBSD-gnats-submit@freebsd.org; Mon, 03 Dec 2001 16:43:31 +0000 Received: from setantae by rhadamanth.private.submonkey.net with local (Exim 3.33 #1) id 16AwBh-00022I-00 for FreeBSD-gnats-submit@freebsd.org; Mon, 03 Dec 2001 16:43:25 +0000 Message-Id: Date: Mon, 03 Dec 2001 16:43:25 +0000 From: Ceri Reply-To: Ceri To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.113 Subject: docs/32474: Minor nitpicks in the config 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: 32474 >Category: docs >Synopsis: Minor nitpicks in the config chapter of the handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: sw-bug >Submitter-Id: current-users >Arrival-Date: Mon Dec 03 08:50:00 PST 2001 >Closed-Date: >Last-Modified: >Originator: Ceri >Release: FreeBSD 4.4-STABLE i386 >Organization: >Environment: System: FreeBSD rhadamanth.private.submonkey.net 4.4-STABLE FreeBSD 4.4-STABLE #0: Mon Nov 26 13:11:22 GMT 2001 setantae@rhadamanth.private.submonkey.net:/usr/obj/usr/src/sys/RHADAMANTH i386 Today's doc tree >Description: There are a couple of minor grammatical issues with the config section of the handbook. >How-To-Repeat: Read it while feeling very fussy. >Fix: Herewith a patch. Ceri --- doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml.old Mon Dec 3 16:08:40 2001 +++ doc/en_US.ISO8859-1/books/handbook/config/chapter.sgml Mon Dec 3 16:38:17 2001 @@ -50,14 +50,14 @@ Why and how to efficiently size, layout, and place - filesystems and swap partition on your hard drive. + filesystems and swap partitions on your hard drive. The basics of the rc.conf configuration and /usr/local/etc/rc.d startup systems. - How to configure virtual hosts on your network device. + How to configure virtual hosts on your network devices. How to use the various configuration files in @@ -123,7 +123,7 @@ The size of your /var partition reflects the intended use of your machine. /var is primarily used to hold: - mailboxes, print spool and log files. Mail boxes and log + mailboxes, print spool and log files. Mailboxes and log files, in particular, can grow to unexpected sizes based upon how many users are on your system and how long your log files are kept. If you intend to run a mail server, a @@ -315,7 +315,7 @@ configuration files for the application, they will be created by copying the .default files. - For example, here is + For example, consider the contents of the directory /usr/local/etc/apache: -rw-r--r-- 1 root wheel 2184 May 20 1998 access.conf @@ -704,7 +704,7 @@ logfile is moved to logfile.0, logfile.0 is moved to logfile.1, and so on. - Additionally, the log files may be archived in &man.gzip.1; format + Alternatively, the log files may be archived in &man.gzip.1; format causing them to be named: logfile.0.gz, logfile.1.gz, and so on. @@ -775,8 +775,8 @@ administrator. Over five hundred system variables can be read and set using &man.sysctl.8;. - At its core, &man.sysctl.8; serves to do two functions: read and - modify system settings. + At its core, &man.sysctl.8; serves two functions: to read and + to modify system settings. To view all readable variables: @@ -889,8 +889,9 @@ are two downsides to Soft Updates that you should be aware of: First, Soft Updates guarantees filesystem consistency in the case of a crash but could very easily be several - seconds (even a minute!) behind updating the physical disk. If you - crash you may lose more work than otherwise. Secondly, Soft Updates + seconds (even a minute!) behind updating the physical disk. If your + system + crashes you may lose more work than otherwise. Secondly, Soft Updates delays the freeing of filesystem blocks. If you have a filesystem (such as the root filesystem) which is close to full, doing a major update of it, e.g. make installworld, can run it @@ -943,7 +944,7 @@ Network Limits The NMBCLUSTERS kernel configuration - option dictate the amount of network mbufs available to the + option dictates the amount of network mbufs available to the system. A heavily-trafficked server with a low number of MBUFs will hinder FreeBSD's ability. Each cluster represents approximately 2K of memory, so a value of 1024 represents 2 >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message