Typo alert.

[pw-darwin.git] / adduser / adduser.8

diff --git a/adduser/adduser.8 b/adduser/adduser.8
index 26f4895484e7e68890b9ea047cabdb0edece8775..dc4a839f0f533fc00b2bedc4f62e82e73bec4db5 100644 (file)
--- a/adduser/adduser.8
+++ b/adduser/adduser.8
@@ -22,8 +22,9 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.\" $Id: adduser.8,v 1.14 1996/12/23 00:10:16 mpp Exp $
-.Dd Jan, 9, 1995
+.\" $Id: adduser.8,v 1.21 1997/06/23 04:52:07 steve Exp $
+.\"
+.Dd January 9, 1995
 .Dt ADDUSER 8
 .Os FreeBSD 2.1
 .Sh NAME
@@ -34,31 +35,47 @@
 .Oo
 .Fl batch Ar username
 .Op Ar group Ns , Ns Op Ar group,...
+.Op Ar class
 .Op Ar fullname 
 .Op Ar password 
 .Oc
+.br
 .Op Fl check_only
+.br
+.Op Fl class Ar login_class
+.br
 .Op Fl config_create
+.br
 .Op Fl dotdir Ar dotdir
+.br
 .Op Fl group Ar login_group
+.br
 .Op Fl h | help
+.br
 .Op Fl home Ar home
+.br
 .Op Fl message Ar message_file
+.br
 .Op Fl noconfig
+.br
 .Op Fl shell Ar shell
+.br
 .Op Fl s | silent | q | quiet
+.br
 .Op Fl uid Ar uid_start
+.br
 .Op Fl v | verbose
 .Sh DESCRIPTION
 .Nm Adduser 
 is a simple program for adding new users. Adduser checks
 the passwd, group and shell databases. It creates passwd/group entries,
-HOME-directory, dotfiles and sends the new user a welcome message.
+.Ev HOME
+directory, dotfiles and sends the new user a welcome message.
 .Sh RESTRICTIONS
 .Bl -tag -width Ds -compact
 .It Sy username
 Login name. May contain only  lowercase characters or digits. Maximum length
-is 8 characters (see 
+is 16 characters (see 
 .Xr setlogin 2
 BUGS section). 
 The reasons for this limit are "Historical". 
@@ -110,28 +127,32 @@ area.
 I have been using this model for almost 10 years and found that it works
 for most situations, and has never gotten in the way.  (Rod Grimes)
 .Sh CONFIGURATION
-.Bl -tag -width Ds -compact
-.It Sy 1.
-Read intern variables.
-.It Sy 2.
-Read config file (/etc/adduser.conf)
-.It Sy 3.
-Parse command line options
+.Bl -enum
+.It
+Read internal variables.
+.It
+Read configuration file (/etc/adduser.conf).
+.It
+Parse command line options.
 .El
 .Sh OPTIONS
 .Bl -tag -width Ds
-.It Sy -batch username [group[,group]...] [fullname] [password]
+.It Sy -batch username [group[,group]...] [class] [fullname] [password]
 Batch mode.
 .It Sy -check_only
 Check /etc/passwd, /etc/group, /etc/shells and exit.
+.It Sy -class Ar login_class
+Set default login class.
 .It Sy -create_config
-Create new config and message file and exit. 
+Create new configuration and message file and exit. 
 .It Sy -dotdir Ar directory
 Copy files from 
 .Ar directory 
-into the HOME-directory of new users,
+into the
+.Ev HOME
+directory of new users,
 .Ql Pa dot.foo
-files renamed to 
+will be renamed to 
 .Ql Pa .foo .
 Don't copy files if
 .Ar directory 
@@ -151,19 +172,21 @@ to read/execute/write
 .It Sy -group Ar login_group
 Login group. 
 .Ar USER
-means use username as login group.
+means that the username is to be used as login group.
 .It Sy -help,-h,-?
-Print options and exit.
+Print a summary of options and exit.
 .It Sy -home Ar partition
 Default home partition where all users located.
 .It Sy -message Ar file
-Send new users a welcome message.
-Don't send message if
+Send new users a welcome message from
+.Ar file .
+Specifying a value of
+.Ar no
+for
 .Ar file 
-equal with
-.Ar no .
+causes no message to be sent to new users.
 .It Sy -noconfig
-Do not read config file.
+Do not read the default configuration file.
 .It Sy -shell Ar shell 
 Default shell for new users.
 .It Sy -silent,-s,-quiet,-q
@@ -178,7 +201,7 @@ Many warnings, questions. Recommended for novice users.
 .Bl -tag -width Ds -compact
 .Ql Pa #
 is a comment.  
-.It Sy config file
+.It Sy configuration file
 .Nm Adduser
 reads and writes this file. 
 See 
@@ -196,12 +219,14 @@ $ adduser
 .Pp
 Start adduser in interactive mode.
 .Pp
-$ adduser -batch baerenklau guest,staff,baer 'Teddy II' qwerty7
+$ adduser -batch baerenklau guest,staff,baer '' 'Teddy II' qwerty7
 .Pp
 Create user 'baerenklau' and  login group 'baerenklau'. Invite user 
-baerenklau into groups guest, staff and baer. Realname (fullname) 
+baerenklau into groups guest, staff and baer. Use default login class.
+Realname (fullname)
 is 'Teddy II'. Password is 'qwerty7' (don't use such passwords!). Create
-HOME directory 
+.Ev HOME
+directory 
 .Pa /home/baerenklau
 and copy all files and directories 
 from 
@@ -224,8 +249,10 @@ user database
 group database
 .It Pa /etc/shells
 shell database
+.It Pa /etc/login.conf
+login classes database
 .It Pa /etc/adduser.conf
-config file for adduser
+configuration file for adduser
 .It Pa /etc/adduser.message
 message file for adduser
 .It Pa /usr/share/skel
@@ -240,8 +267,9 @@ logfile for adduser
 .Xr setlogin 2 ,
 .Xr yp 4 ,
 .Xr aliases 5 ,
-.Xr passwd 5 ,
 .Xr group 5 ,
+.Xr login.conf 5 ,
+.Xr passwd 5 ,
 .Xr shells 5 ,
 .Xr addgroup 8 ,
 .Xr pwd_mkdb 8 ,