Bug 35732

Summary: adduser(8) page has obsolete reference and other problems.
Product: Documentation Reporter: Gary W. Swearingen <swear>
Component: Books & ArticlesAssignee: Tom Rhodes <trhodes>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Gary W. Swearingen 2002-03-10 09:00:03 UTC
-- The adduser(8) man page has several problems. See below.

================

Fix: 

-- Remove the reference to setlogin(2)'s BUGS section (because it has
no relevant text).

-- Reconcile the Description's "May contain only lowercase characters or
digits." with adding_user(8)'s implications that login names may
contain hyphens, dots, and uppercase letters.  Maybe just needs a
clarifying comment that the program is more retrictive than most of the
base OS software and refer to adding_user(8) there.

-- Unconfuse the mention of a 16-character limit and the 8-character
limit.  At least, clean up the confusing clause "or source that assumes
the 8-character name limit and NIS". (Maybe change "and NIS" to "of
NIS".  Maybe remove the comma from "programs, or source".)

-- Add "adding_user(8)" to the "See Also" section.

-- Under "-verbose", change "warnings, questions" to "warnings and
questions".

-- Under "message file", change "Eval" to "Evaluate".

-- After "shell", change "Only valid shells from the shell database"
to "Shells from /etc/shells".  Clarify "or sliplogin and pppd". (Does
it mean the actual words "sliplogin" or "pppd" instead of a shell name,
or what?  If so, quote them and change "and" to "or".)

--  In the "-shell" explanation, "shell" should be
"shell_full_pathname". (I don't remember my evidence for making that
statement, but had it in my notes probably gathered when I was using
the program.)
How-To-Repeat: n/a
================
Comment 1 Tom Rhodes freebsd_committer freebsd_triage 2006-06-07 06:01:33 UTC
State Changed
From-To: open->patched

Many of these issues are fixed with the 5.X/6.X version of 
adduser(8), being a shell script.  As such, I have only fixed 
those and will MFC to 6-STABLE later.  Thanks. 


Comment 2 Tom Rhodes freebsd_committer freebsd_triage 2006-06-07 06:01:33 UTC
Responsible Changed
From-To: freebsd-doc->trhodes

Over to me, MFC reminder.
Comment 3 Tom Rhodes freebsd_committer freebsd_triage 2006-10-09 18:28:16 UTC
State Changed
From-To: patched->closed

This was MFCed awhile ago, close this PR.
Comment 4 dfilter service freebsd_committer freebsd_triage 2007-10-19 09:16:46 UTC
mtm         2007-10-19 08:16:30 UTC

  FreeBSD src repository

  Modified files:        (Branch: RELENG_6)
    usr.sbin/adduser     adduser.8 rmuser.8 
  Log:
  MFC:
  
    rmuser.8 rev. 1.24,1.24 : Typo fixes.
  
    adduser.8 rev. 1.57-1.59: Typo and markup fixes
              rev. 1.56:
              Add adding_user.8 to SEE ALSO, note that usernames may
              contain any character but not being with a hyphen,
              similar to adding_user.8.
  
              PR:     35732
  
  Revision  Changes    Path
  1.55.8.1  +9 -6      src/usr.sbin/adduser/adduser.8
  1.23.8.1  +2 -2      src/usr.sbin/adduser/rmuser.8
_______________________________________________
cvs-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/cvs-all
To unsubscribe, send any mail to "cvs-all-unsubscribe@freebsd.org"