[svn-upgrade] Integrating new upstream version, shadow (4.0.16)

[shadow] / man / gpasswd.1

diff --git a/man/gpasswd.1 b/man/gpasswd.1
index 561f4162341dd74a39b5f9314c4b26df9e61a7dc..45e983dd8dcbac3bcda354ad9fd9e53385dec99b 100644 (file)
--- a/man/gpasswd.1
+++ b/man/gpasswd.1
@@ -1,8 +1,11 @@
-.\" ** You probably do not want to edit this file directly **
-.\" It was generated using the DocBook XSL Stylesheets (version 1.69.0).
-.\" Instead of manually editing it, you probably should edit the DocBook XML
-.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GPASSWD" "1" "08/03/2005" "User Commands" "User Commands"
+.\"     Title: gpasswd
+.\"    Author: 
+.\" Generator: DocBook XSL Stylesheets v1.70.1 <http://docbook.sf.net/>
+.\"      Date: 06/06/2006
+.\"    Manual: User Commands
+.\"    Source: User Commands
+.\"
+.TH "GPASSWD" "1" "06/06/2006" "User Commands" "User Commands"
 .\" disable hyphenation
 .nh
 .\" disable justification (adjust text to left margin only)
@@ -24,52 +27,56 @@ gpasswd \- administer the /etc/group file
 \fBgpasswd\fR [\-A\ \fIuser,\fR...] [\-M\ \fIuser,\fR...] \fIgroup\fR
 .SH "DESCRIPTION"
 .PP
-\fBgpasswd\fR 
-is used to administer the 
-\fI/etc/group\fR 
-file (and 
-\fI/etc/gshadow\fR 
-file if compiled with SHADOWGRP defined). Every group can have administrators, members and a password. System administrator can use 
-\fB\-A\fR 
-option to define group administrator(s) and 
-\fB\-M\fR 
+
+\fBgpasswd\fR
+is used to administer the
+\fI/etc/group\fR
+file (and
+\fI/etc/gshadow\fR
+file if compiled with SHADOWGRP defined). Every group can have administrators, members and a password. System administrator can use
+\fB\-A\fR
+option to define group administrator(s) and
+\fB\-M\fR
 option to define members and has all rights of group administrators and members.
+.SS "Notes about group passwords"
+.PP
+Group passwords are an inherent security problem since more than one person is permitted to know the password. However, groups are a useful tool for permitting co\-operation between different users.
+.\" end of SS subsection "Notes about group passwords"
 .SH "OPTIONS"
 .PP
-Group administrator can add and delete users using 
-\fB\-a\fR 
-and 
-\fB\-d\fR 
-options respectively. Administrators can use 
-\fB\-r\fR 
-option to remove group password. When no password is set only group members can use 
-\fBnewgrp\fR 
-to join the group. Option 
-\fB\-R\fR 
-disables access via a password to the group through 
-\fBnewgrp\fR 
+Group administrator can add and delete users using
+\fB\-a\fR
+and
+\fB\-d\fR
+options respectively. Administrators can use
+\fB\-r\fR
+option to remove group password. When no password is set only group members can use
+\fBnewgrp\fR
+to join the group. Option
+\fB\-R\fR
+disables access via a password to the group through
+\fBnewgrp\fR
 command (however members will still be able to switch to this group).
 .PP
-\fBgpasswd\fR 
-called by a group administrator with group name only prompts for the group password. If password is set the members can still 
-\fBnewgrp\fR(1) 
+
+\fBgpasswd\fR
+called by a group administrator with group name only prompts for the group password. If password is set the members can still
+\fBnewgrp\fR(1)
 without a password, non\-members must supply the password.
 .SH "FILES"
-.TP
+.TP 3n
 \fI/etc/group\fR
-group account information
-.TP
+Group account information.
+.TP 3n
 \fI/etc/gshadow\fR
-secure group account information
+Secure group account information.
 .SH "SEE ALSO"
 .PP
-\fBnewgrp\fR(1), 
-\fBgroupadd\fR(8), 
-\fBgroupdel\fR(8), 
-\fBgroupmod\fR(8), 
-\fBgrpck\fR(8), 
-\fBgroup\fR(5), 
-\fBgshadow\fR(5)
-.SH "AUTHOR"
-.PP
-Rafal Maszkowski <rzm@pdi.net>
+
+\fBnewgrp\fR(1),
+\fBgshadow\fR(5),
+\fBgroupadd\fR(8),
+\fBgroupdel\fR(8),
+\fBgroupmod\fR(8),
+\fBgrpck\fR(8),
+\fBgroup\fR(5).