From le@univie.ac.at  Sun Jul 20 05:01:27 2003
Return-Path: <le@univie.ac.at>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id BE0A037B401
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 20 Jul 2003 05:01:27 -0700 (PDT)
Received: from mailbox.univie.ac.at (mailbox.univie.ac.at [131.130.1.27])
	by mx1.FreeBSD.org (Postfix) with ESMTP id AE52C43F75
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 20 Jul 2003 05:01:26 -0700 (PDT)
	(envelope-from le@univie.ac.at)
Received: from korben.in.tern (adslle.cc.univie.ac.at [131.130.102.11])
	by mailbox.univie.ac.at (8.12.2/8.12.2) with ESMTP id h6KC1AMJ225194
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 20 Jul 2003 14:01:15 +0200
Received: from korben.in.tern (korben.in.tern [127.0.0.1])
	by korben.in.tern (8.12.9/8.12.9) with ESMTP id h6KC0vq9011394
	for <FreeBSD-gnats-submit@freebsd.org>; Sun, 20 Jul 2003 14:00:58 +0200 (CEST)
	(envelope-from le@korben.in.tern)
Received: (from le@localhost)
	by korben.in.tern (8.12.9/8.12.9/Submit) id h6KC0uZC011393;
	Sun, 20 Jul 2003 14:00:56 +0200 (CEST)
	(envelope-from le)
Message-Id: <200307201200.h6KC0uZC011393@korben.in.tern>
Date: Sun, 20 Jul 2003 14:00:56 +0200 (CEST)
From: Lukas Ertl <l.ertl@univie.ac.at>
Reply-To: Lukas Ertl <l.ertl@univie.ac.at>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [PATCH] update "Modifying Accounts" chapter in handbook for FreeBSD 5.x
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         54655
>Category:       docs
>Synopsis:       [PATCH] update "Modifying Accounts" chapter in handbook for FreeBSD 5.x
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    blackend
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sun Jul 20 05:10:08 PDT 2003
>Closed-Date:    Mon Nov 03 12:19:43 PST 2003
>Last-Modified:  Mon Nov 03 12:19:43 PST 2003
>Originator:     Lukas Ertl
>Release:        FreeBSD 5.1-CURRENT i386
>Organization:
Vienna University Computer Center
>Environment:
System: FreeBSD korben 5.1-CURRENT FreeBSD 5.1-CURRENT #4: Mon Jul 14 22:28:43 CEST 2003 le@korben:/usr/obj/usr/src/sys/KORBEN i386


	
>Description:

In FreeBSD 5.x, some commands have slighty different usage than in 4.x.

>How-To-Repeat:
	
>Fix:

	

--- users.diff begins here ---
Index: en_US.ISO8859-1/books/handbook/users/chapter.sgml
===================================================================
RCS file: /usr/local/bsdcvs/doc/en_US.ISO8859-1/books/handbook/users/chapter.sgml,v
retrieving revision 1.37
diff -u -r1.37 chapter.sgml
--- en_US.ISO8859-1/books/handbook/users/chapter.sgml	10 Oct 2002 21:14:28 -0000	1.37
+++ en_US.ISO8859-1/books/handbook/users/chapter.sgml	20 Jul 2003 11:51:02 -0000
@@ -384,7 +384,12 @@
 	<filename>/usr/share/skel</filename>, and can optionally mail
 	the new user a welcome message.</para>
 
-      <para>To create the initial configuration file, use
+      <para>In &os;&nbsp;5.0, &man.adduser.8; was rewritten from a
+	Perl script to a shell script that acts as wrapper around
+	&man.pw.8;, so its usage is slightly different on &os;&nbsp;4.x
+	and &os;&nbsp;5.x.</para>
+
+      <para>To create the initial configuration file on &os;&nbsp;4.x, use
 	<command>adduser -s -config_create</command>.
 	<footnote>
 	  <para>The <option>-s</option> makes &man.adduser.8;
@@ -398,7 +403,8 @@
 	nasty.</para>
 
       <example>
-	<title>Configuring <command>adduser</command></title>
+	<title>Configuring <command>adduser</command> and adding a
+	user on &os;&nbsp;4.x</title>
 
 	<screen>&prompt.root; <userinput>adduser -v</userinput>
 Use option ``-silent'' if you don't want to see all warnings and questions.
@@ -470,6 +476,40 @@
 	  exit the program, and try the <option>-s</option>
 	  option.</para>
       </note>
+
+      <example>
+	<title>Adding a user on &os;&nbsp;5.x</title>
+
+	<screen>&prompt.root; <userinput>adduser</userinput>
+Username: <userinput>jru</userinput>
+Full name: <userinput>J. Random User</userinput>
+Uid (Leave empty for default): 
+Login group [jru]: 
+Login group is jru. Invite jru into other groups? []: <userinput>wheel</userinput>
+Login class [default]: 
+Shell (sh csh tcsh bash nologin) [sh]: <userinput>bash</userinput>
+Home directory [/home/jru]: 
+Use password-based authentication? [yes]: 
+Use an empty password? (yes/no) [no]: 
+Use a random password? (yes/no) [no]: 
+Enter password: 
+Enter password again: 
+Lock out the account after creation? [no]: 
+Username   : jru
+Password   : *****
+Full Name  : J. Random User
+Uid        : 1003
+Class      : 
+Groups     : jru wheel
+Home       : /home/jru
+Shell      : /usr/local/bin/bash
+Locked     : no
+OK? (yes/no): <userinput>yes</userinput>
+adduser: INFO: Successfully added (jru) to the user database.
+Add another user? (yes/no): <userinput>no</userinput>
+Goodbye!
+&prompt.root;</screen>
+      </example>
     </sect2>
 
     <sect2 id="users-rmuser">
@@ -570,6 +610,11 @@
 	containing user information.  When the user exists from the
 	editor, the user database is updated with the new
 	information.</para>
+
+      <note>
+	<para>In &os;&nbsp;5.x, you will be asked for your password
+	  after exiting the editor if you are not the superuser.</para>
+      </note>
 
       <example>
 	<title>Interactive <command>chpass</command> by Superuser</title>
--- users.diff ends here ---


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->blackend 
Responsible-Changed-By: blackend 
Responsible-Changed-When: Sun Jul 20 12:56:07 PDT 2003 
Responsible-Changed-Why:  
I will take this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=54655 
State-Changed-From-To: open->closed 
State-Changed-By: blackend 
State-Changed-When: Mon Nov 3 12:18:25 PST 2003 
State-Changed-Why:  
Sorry for the late :( 
I committed a slightly different version of your patch, the differences 
are mostly on details to be consistent with 4.X example.  Thanks! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=54655 
>Unformatted:
