[Adduser-devel] Bug#503153: adduser: manpage confusing

[Marc Haber]

On Wed, Oct 22, 2008 at 03:37:32PM -0700, Matt Taggart wrote:
> The adduser manpage text for --ingroup and --gid are a little confusing.
> 
>    --ingroup GROUP
>           Add  the new user to GROUP instead of a usergroup or the default
>           group defined by USERS_GID  in  the  configuration  file.   This
>           affects  the users primary group.  To add additional groups, see
>           the add_extra_groups option
> 
>    --gid ID
>           When  creating a group, this option forces the new groupid to be
>           the given number.  When creating a user, this  option  will  put
>           the user in that group.
> 
> These options do not "Add the new user to GROUP" or "put the user in that
> group", they just set the user's initial group. The ingroup one sort of
> explains that but in a confusing way, and the gid one is just wrong.

So you suggest changing the wording to:

    --ingroup GROUP
           Set the new user's primary group to GROUP instead of a usergroup
	   or the default group defined by USERS_GID in the configuration
	   file. To add additional groups, see the add_extra_groups option
 
    --gid ID
           When  creating a group, this option forces the new groupid to be
           the given number.  When creating a user, this  option  will
	   make the group the user's primary group.
	   
Is this correct?

Frankly, I don't see a big problem with the old wording, but I am by
no means an expert in user management.

Greetings
Marc

-- 
-----------------------------------------------------------------------------
Marc Haber         | "I don't trust Computers. They | Mailadresse im Header
Mannheim, Germany  |  lose things."    Winona Ryder | Fon: *49 621 31958061
Nordisch by Nature |  How to make an American Quilt | Fax: *49 621 31958062