From owner-freebsd-doc@FreeBSD.ORG Thu Dec 12 15:32:01 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 2E44EF30 for ; Thu, 12 Dec 2013 15:32:01 +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 BA2B51B58 for ; Thu, 12 Dec 2013 15:32:00 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.7/8.14.7) with ESMTP id rBCFVxgg012365; Thu, 12 Dec 2013 08:31:59 -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 rBCFVwV9012362; Thu, 12 Dec 2013 08:31:59 -0700 (MST) (envelope-from wblock@wonkity.com) Date: Thu, 12 Dec 2013 08:31:58 -0700 (MST) From: Warren Block To: Taras Korenko Subject: Re: en/handbook/basics: proposed corrections #2 In-Reply-To: <20131212091212.GC85778@gamma.ukrhub.net> Message-ID: References: <20131212091212.GC85778@gamma.ukrhub.net> User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: TEXT/PLAIN; format=flowed; charset=US-ASCII X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3 (wonkity.com [127.0.0.1]); Thu, 12 Dec 2013 08:31:59 -0700 (MST) Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 12 Dec 2013 15:32:01 -0000 On Thu, 12 Dec 2013, Taras Korenko wrote: > Good day, doc@ folks. > > The following notes were made while working on translation of "Users > and Basic Account Management" of our handbook. I'd like to put them > into the source file (basics/chapter.xml). > > Could anyone review that? > > P.S.: my (xml-style) comments are denoted with 'XXX skipme:'. > Index: en_US.ISO8859-1/books/handbook/basics/chapter.xml =================================================================== --- en_US.ISO8859-1/books/handbook/basics/chapter.xml (revision 43325) +++ en_US.ISO8859-1/books/handbook/basics/chapter.xml (working copy) ... @@ -637,7 +639,7 @@ &os; provides a variety of different commands to manage user accounts. The most common commands are summarized in - Table 4.1, followed by some examples of their usage. Refer to + the subsequent table, followed by some examples of their usage. Refer to the manual page for each utility for more details and usage examples. WB: "See" is simpler than "refer to". An xml:id can be added to that table and linked here. That is also useful when referring to the page in HTML, because it becomes an anchor. For example, in the table declaration: Then in the text: &os; provides a variety of different commands to manage user accounts. The most common commands are summarized in , followed by some examples of their usage. See the manual page for each utility for more details and usage examples. @@ -725,8 +727,10 @@ been invited into the wheel group, which is required to provide the account with superuser - access. When finished, the utility will prompt to either + access using &man.su.1;. When finished, the utility will prompt to either WB: That sentence can be interpreted several ways. How about wheel group, allowing them to become the superuser with &man.su.1;. create another user or to exit. + WB: A mention of sudo would have to be careful not to equate it with 'su -'. The environment is different. I think the intention here was just to demonstrate adduser. The section just above, called "The Superuser Account", would be a better place for describing sudo and how it can allow unprivileged users to run programs without becoming superuser.