From owner-freebsd-doc@FreeBSD.ORG Wed Nov 27 16:52:22 2013 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id ACE277B5 for ; Wed, 27 Nov 2013 16:52:22 +0000 (UTC) Received: from wonkity.com (wonkity.com [67.158.26.137]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 7550D2B24 for ; Wed, 27 Nov 2013 16:52:22 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id rARGqESv065646; Wed, 27 Nov 2013 09:52:14 -0700 (MST) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id rARGqENK065643; Wed, 27 Nov 2013 09:52:14 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Wed, 27 Nov 2013 09:52:14 -0700 (MST) From: Warren Block To: Taras Korenko Subject: Re: en/handbook/users: proposed corrections In-Reply-To: <20131126190644.GC25578@gamma.ukrhub.net> Message-ID: References: <20131126190644.GC25578@gamma.ukrhub.net> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Wed, 27 Nov 2013 09:52:14 -0700 (MST) Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.16 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 27 Nov 2013 16:52:22 -0000 On Tue, 26 Nov 2013, Taras Korenko wrote: > Good day, doc@ folks. > > I'd like to introduce some corrections to handbook/users chapter. However, > there might be moot points, so any comments will be appreciated. > Thanks. Thanks for working on this! Comments inline below, preceded with WB: for easy location. Index: en_US.ISO8859-1/books/handbook/users/chapter.xml =================================================================== --- en_US.ISO8859-1/books/handbook/users/chapter.xml (revision 43253) +++ en_US.ISO8859-1/books/handbook/users/chapter.xml (working copy) @@ -78,8 +78,8 @@ The user name is typed at the login: - prompt. User names must be unique on the system as no two - users can have the same user name. There are a number of + prompt. User names must be unique on the system. + There are a number of WB: I agree with this simplification, and would like to take it even farther. How about "Each user must have a unique user name."? rules for creating valid user names, documented in &man.passwd.5;. Typically user names consist of eight or fewer all lower case characters in order to maintain @@ -91,9 +91,8 @@ Password - Each account has an associated password. While the - password can be blank, this is highly discouraged and - every account should have a password. + Each account has an associated password. The password can be + blank, however this is highly discouraged. WB: This makes me think of "Do not look into laser with remaining eye." Let's just remove the sentence about setting a blank password. @@ -149,7 +148,7 @@ By default &os; does not force users to change their - passwords periodically. Password expiration can be + passwords. Password expiration can be enforced on a per-user basis, forcing some or all users to change their passwords after a certain amount of time has elapsed. WB: Agreed, the original sentence is not very good. How about "By default, passwords do not expire.", and then use "enabled" rather than "enforced" in the next sentence. @@ -377,7 +376,7 @@ /usr/share/skel skeleton directory - &man.adduser.8; is a simple program for adding new users + &man.adduser.8; is a simple program for adding new users. When a new user is added, this program automatically updates /etc/passwd and /etc/group. It also creates a home @@ -527,7 +526,7 @@ When passed no options, aside from an optional username, &man.chpass.1; displays an editor containing user information. - When the user exists from the editor, the user database is + When the user exits from the editor, the user database is WB: good catch! updated with the new information. @@ -773,8 +772,7 @@ this limit too small may hinder a user's productivity as it is often useful to be logged in multiple times or to execute pipelines. Some tasks, such as compiling a large - program, spawn multiple processes and other intermediate - preprocessors. + program, spawn lots of processes. WB: "start" may be more clear than "spawn". @@ -818,7 +816,7 @@ The limit on the amount of network memory, and - thus mbufssbsizelimiting userssbsize, a user may consume in order to limit network + thus mbufssbsizelimiting userssbsize, a user may consume. This can be generally used to limit network communications. @@ -960,7 +958,7 @@ In this example, the argument to is a comma-delimited list of users who are to be added to the group. Unlike the previous example, these users are appended to the - group list and do not replace the list of existing users in the + group and do not replace the list of existing users in the group.