From owner-svn-doc-all@FreeBSD.ORG Thu Feb 21 21:42:53 2013 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id 76961C19; Thu, 21 Feb 2013 21:42:53 +0000 (UTC) (envelope-from kaduk@mit.edu) Received: from dmz-mailsec-scanner-2.mit.edu (DMZ-MAILSEC-SCANNER-2.MIT.EDU [18.9.25.13]) by mx1.freebsd.org (Postfix) with ESMTP id D73C2E19; Thu, 21 Feb 2013 21:42:52 +0000 (UTC) X-AuditID: 1209190d-b7fa66d0000008f6-24-512694d6debb Received: from mailhub-auth-2.mit.edu ( [18.7.62.36]) by dmz-mailsec-scanner-2.mit.edu (Symantec Messaging Gateway) with SMTP id 7A.D9.02294.6D496215; Thu, 21 Feb 2013 16:42:46 -0500 (EST) Received: from outgoing.mit.edu (OUTGOING-AUTH-1.MIT.EDU [18.9.28.11]) by mailhub-auth-2.mit.edu (8.13.8/8.9.2) with ESMTP id r1LLgkDV021052; Thu, 21 Feb 2013 16:42:46 -0500 Received: from multics.mit.edu (SYSTEM-LOW-SIPB.MIT.EDU [18.187.2.37]) (authenticated bits=56) (User authenticated as kaduk@ATHENA.MIT.EDU) by outgoing.mit.edu (8.13.8/8.12.4) with ESMTP id r1LLgh1J012121 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 21 Feb 2013 16:42:45 -0500 Received: (from kaduk@localhost) by multics.mit.edu (8.12.9.20060308) id r1LLghNu013198; Thu, 21 Feb 2013 16:42:43 -0500 (EST) Date: Thu, 21 Feb 2013 16:42:43 -0500 (EST) From: Benjamin Kaduk To: Dru Lavigne Subject: Re: svn commit: r41024 - head/en_US.ISO8859-1/books/handbook/users In-Reply-To: <201302211406.r1LE66bl041470@svn.freebsd.org> Message-ID: References: <201302211406.r1LE66bl041470@svn.freebsd.org> User-Agent: Alpine 1.10 (GSO 962 2008-03-14) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Brightmail-Tracker: H4sIAAAAAAAAA+NgFvrFIsWRmVeSWpSXmKPExsUixG6nonttilqgwcP1khY/Ph5isuhqUrW4 sWg/k8Xu/l5mBxaPGZ/mswQwRnHZpKTmZJalFunbJXBlrP16haXgqlrFt37ZBsa/sl2MHBwS AiYSF98wdjFyApliEhfurWfrYuTiEBLYxyjxbkIrG0hCSGAjo8SBH2EQiUNMEhvOvmOBcBoY Jc6f+8kCUsUioC3xcs0isFFsAioSM99sBOsWEVCUePp1L1icWSBKYs/SRlYQW1jAW2Lr4Xdg NZwCVhLbN7Uzgdi8Ag4SEz9NZgK5TkjAUqLrkAJIWFRAR2L1/iksECWCEidnPmGBGGkp8W/t L9YJjIKzkKRmIUktYGRaxSibklulm5uYmVOcmqxbnJyYl5dapGukl5tZopeaUrqJERSsnJK8 OxjfHVQ6xCjAwajEw9vgohYoxJpYVlyZe4hRkoNJSZT30QSgEF9SfkplRmJxRnxRaU5q8SFG CQ5mJRFe/VCgHG9KYmVValE+TEqag0VJnPdKyk1/IYH0xJLU7NTUgtQimKwMB4eSBK8HMCqF BItS01Mr0jJzShDSTBycIMN5gIabg9TwFhck5hZnpkPkTzHqciy49ugFoxBLXn5eqpQ4rwtI kQBIUUZpHtwcWJJ5xSgO9JYwbyhIFQ8wQcFNegW0hAloydrlyiBLShIRUlINjEdXad97pXr6 k01CWb2b+UH77dMaV79xuybDm98pY13iNEtAxVj3sb+T/oXDqfUW5ycl5J/sedNdbHGBvbTg dQyvQAf3VseSu4c+avDxqpcd/7RKYv8cz6Xxt3efEp4X3b5Hd+nOvuW3716wZJsWv3pxvKBN dQmjeevMGw+LZGbPe+WQs2T9aSWW4oxEQy3mouJEAGqRToQNAwAA Cc: svn-doc-head@freebsd.org, svn-doc-all@freebsd.org, doc-committers@freebsd.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 21 Feb 2013 21:42:53 -0000 On Thu, 21 Feb 2013, Dru Lavigne wrote: > Modified: head/en_US.ISO8859-1/books/handbook/users/chapter.xml > ============================================================================== > --- head/en_US.ISO8859-1/books/handbook/users/chapter.xml Wed Feb 20 19:00:52 2013 (r41023) > +++ head/en_US.ISO8859-1/books/handbook/users/chapter.xml Thu Feb 21 14:06:06 2013 (r41024) > @@ -161,10 +155,10 @@ > Password change time > > > - By default FreeBSD does not force users to change > - their passwords periodically. You can enforce this on a > - per-user basis, forcing some or all of your users to > - change their passwords after a certain amount of time has > + By default &os; does not force users to change their > + passwords periodically. This can be enforced on a "This" is rather vague, and if taken literally probably refers to *not* forcing users to change their password periodically. It should probably be replaced with "Password expiration" in this instance. > + per-user basis, forcing some or all users to change their > + passwords after a certain amount of time has > elapsed. > > > @@ -700,11 +683,9 @@ passwd: done > quotas > > disk quotas > - Disk quotas limit disk usage to users, and > - they > - provide a way to quickly check that usage without > - calculating it every time. Quotas are discussed in - linkend="quotas"/>. > + Disk quotas limit disk usage to users and provide a way to > + quickly check that usage without calculating it every time. This sentence is still not quite there. Maybe "Disk quotas limit the disk usage available to users" or "limit the disk usage of users"? > + Quotas are discussed in . > > The other resource limits include ways to limit the amount > of CPU, memory, and other resources a user may consume. These > @@ -714,47 +695,45 @@ passwd: done > login capability is a > name=value > pair, where name is a well-known > identifier and value is an arbitrary > - string processed accordingly depending on the name. Setting up > - login classes and capabilities is rather straight-forward and is > - also described in &man.login.conf.5;. > + string which is processed accordingly depending on the > + name. Setting up login classes and > + capabilities is rather straight-forward and is also described in > + &man.login.conf.5;. I believe straightforward does not normally take a hyphen. > @@ -850,12 +822,11 @@ passwd: done > limiting users > memorylocked > > - This is the maximum amount a memory a process may have > - requested to be locked into main memory (e.g., see > - &man.mlock.2;). Some system-critical programs, such as > - &man.amd.8;, lock into main memory such that in the event > - of being swapped out, they do not contribute to > - a system's thrashing in time of trouble. > + The maximum amount of memory a process may request > + to be locked into main memory using &man.mlock.2;. Some > + system-critical programs, such as &man.amd.8;, lock into > + main memory so that in the event of being swapped out, > + they do not contribute to disk thrashing. "in the event of being swapped out" is confusing at best, here. I would probably just put "so that if the system begins to swap, they do not". > > > > @@ -882,10 +852,10 @@ passwd: done > limiting users > openfiles > > - This is the maximum amount of files a process may have > - open. In FreeBSD, files are also used to represent > - sockets and IPC channels; thus, be careful not to set this > - too low. The system-wide limit for this is defined by the > + The maximum amount of files a process may have open. Files are discrete objects and should probably be quantified as a number, not an amount. -Ben > + In &os;, files are used to represent sockets and IPC > + channels, so be careful not to set this too low. The > + system-wide limit for this is defined by the > kern.maxfiles &man.sysctl.8;. > > > > *** DIFF OUTPUT TRUNCATED AT 1000 LINES *** >