From owner-freebsd-doc@FreeBSD.ORG Sat Apr 5 22:10:01 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 4E0F11065673 for ; Sat, 5 Apr 2008 22:10:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id 1D2E28FC14 for ; Sat, 5 Apr 2008 22:10:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m35MA10s027436 for ; Sat, 5 Apr 2008 22:10:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m35MA0rt027435; Sat, 5 Apr 2008 22:10:00 GMT (envelope-from gnats) Resent-Date: Sat, 5 Apr 2008 22:10:00 GMT Resent-Message-Id: <200804052210.m35MA0rt027435@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Diane Bruce Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1C52D106566C for ; Sat, 5 Apr 2008 22:08:18 +0000 (UTC) (envelope-from db@db.net) Received: from diana.db.net (diana.db.net [204.228.229.66]) by mx1.freebsd.org (Postfix) with ESMTP id E94438FC0A for ; Sat, 5 Apr 2008 22:08:17 +0000 (UTC) (envelope-from db@db.net) Received: from diana.db.net ([204.228.229.66] helo=localhost ident=mailnull) by diana.db.net with esmtp (Exim 4.66 (FreeBSD)) (envelope-from ) id 1JiFuF-000NpK-Fl for freebsd-gnats-submit@freebsd.org; Sat, 05 Apr 2008 15:26:35 -0600 Received: from diana.db.net ([127.0.0.1] helo=localhost) (envelope-from ) id 1JiFuE-000BWj-My for FreeBSD-gnats-submit@freebsd.org; Sat, 05 Apr 2008 17:26:34 -0400 Message-Id: Date: Sat, 05 Apr 2008 17:26:34 -0400 From: Diane Bruce To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/122476: Misleading doc for adding new users to a group X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Diane Bruce List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 05 Apr 2008 22:10:01 -0000 >Number: 122476 >Category: docs >Synopsis: Misleading doc for adding new users to a group >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Sat Apr 05 22:10:00 UTC 2008 >Closed-Date: >Last-Modified: >Originator: Diane Bruce >Release: FreeBSD 7.0-RELEASE i386 >Organization: Are you kidding? >Environment: System: FreeBSD night.db.net 7.0-RELEASE FreeBSD 7.0-RELEASE #13: Thu Feb 28 08:50:37 EST 2008 root@night.db.net:/usr/obj/usr/src/sys/NIGHT i386 >Description: 3.8 is mis-leading and has resulted in a new user accidentally deleting himself from groups, both -M and -m should be shown as examples clarifying the difference. >How-To-Repeat: >Fix: See sgml diff --- en_US.ISO8859-1/books/handbook/users/chapter.sgml.orig 2008-04-04 18:24:51.000000000 -0400 +++ en_US.ISO8859-1/books/handbook/users/chapter.sgml 2008-04-05 16:01:40.000000000 -0400 @@ -982,7 +982,7 @@ the teamtwo group. - Adding Somebody to a Group Using &man.pw.8; + Creating the list of members of a Group Using &man.pw.8; &prompt.root; pw groupmod teamtwo -M jru &prompt.root; pw groupshow teamtwo @@ -990,7 +990,7 @@ The argument to the option is a - comma-delimited list of users who are members of the group. From the + comma-delimited list of users who are to be in the group. From the preceding sections, we know that the password file also contains a group for each user. The latter (the user) is automatically added to the group list by the system; the user will not show up as a member @@ -1000,6 +1000,18 @@ /etc/group file; it will never attempt to read additionally data from /etc/passwd. + + Adding a new member to a Group Using &man.pw.8; + + &prompt.root; pw groupmod teamtwo -m db +&prompt.root; pw groupshow teamtwo +teamtwo:*:1100:jru,db + + The argument to the option is a + comma-delimited list of users who are to be added to the group. Unlike + the previous example, these users are added to the group and do not + replace the list of users in the group. + Using &man.id.1; to Determine Group Membership >Release-Note: >Audit-Trail: >Unformatted: