From owner-freebsd-doc@FreeBSD.ORG Thu Nov 28 21:41:54 2013 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id D2174397 for ; Thu, 28 Nov 2013 21:41:54 +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 7AA0D16A3 for ; Thu, 28 Nov 2013 21:41:54 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id rASLfrHQ050684; Thu, 28 Nov 2013 14:41:53 -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 rASLfrYD050681; Thu, 28 Nov 2013 14:41:53 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Thu, 28 Nov 2013 14:41:53 -0700 (MST) From: Warren Block To: Taras Korenko Subject: Re: en/handbook/users: proposed corrections In-Reply-To: <20131128151032.GE52681@gamma.ukrhub.net> Message-ID: References: <20131126190644.GC25578@gamma.ukrhub.net> <20131128151032.GE52681@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]); Thu, 28 Nov 2013 14:41:53 -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: Thu, 28 Nov 2013 21:41:55 -0000 As before, notes marked with WB: below. On Thu, 28 Nov 2013, Taras Korenko wrote: > ... and the last (previously unnoticed) chunk follows: Index: en_US.ISO8859-1/books/handbook/users/chapter.xml =================================================================== --- en_US.ISO8859-1/books/handbook/users/chapter.xml (revision 43259) +++ en_US.ISO8859-1/books/handbook/users/chapter.xml (working copy) @@ -984,7 +984,7 @@ There are several ways to do things as the superuser. The worst way is to log in as root directly. - Usually very little activity requires root + Usually very little activity requires superuser privileges, WB: s/Usually very/Very/ so logging off and logging in as root, performing tasks, then logging off and on again as a normal user is a waste of time. @@ -991,8 +991,8 @@ A better way is to use &man.su.1; without providing a login but using - to inherit the root environment. - Not providing a login will imply super user. For this to work - the login that must be in the wheel group. + Not providing a login will imply superuser. For this to work WB: "login" is what the other section referred to as a "user name". Although su(1) calls it a login, "user name" is less ambiguous. + the current user must belong to the wheel group. An example of a typical software installation would involve the administrator unpacking the software as a normal user and then elevating their privileges for the build and installation of @@ -1016,10 +1016,10 @@ Using &man.su.1; works well for single systems or small WB: s/Using// networks with just one system administrator. For more complex - environments (or even for these simple environments) - sudo should be used. It is provided as a port, - security/sudo. It allows for - things like activity logging, granting users the ability to only + environments WB: s/environments/environments,/ + sudo might be used. It is available as a WB: "might" will cause the user to ask "Why?" How about "For more complex environments, sudo is useful." + security/sudo package or port. + sudo provides activity logging, granting users the ability to only run certain commands as the superuser, and several other options.