Bug 103828

Summary:	pw/adduser manpage make no mention of "dot.file" replace syntax in /usr/share/skel
Product:	Documentation	Reporter:	Dan Mahoney <danm>
Component:	Books & Articles	Assignee:	Tom Rhodes <trhodes>
Status:	Closed FIXED
Severity:	Affects Only Me
Priority:	Normal
Version:	Latest
Hardware:	Any
OS:	Any

Description Dan Mahoney 2006-09-29 23:20:18 UTC

The "adduser" command calls the "pw" command.  Both these commands by default populate a user's directory from a "skeleton" 
directiory, by default /usr/share/skel.  However, a substitution is present whereby "dotfiles" such as .cshrc can be placed 
in /usr/share/skel as dot.cshrc.  When pw populates the directory, it strips the "dot" from the file name and makes it the 
file's true name, i.e. dot.cshrc --> .cshrc.

Fix: 

Two problems exist.

One, that this behavior is not documented.  Documentation is as easy as sticking the paragraph above into the relevant 
manpages (pw/adduser).

The second, is that the behavior is undefined if /usr/share/skel contains BOTH a .cshrc and a dot.cshrc (as I can't make 
sense of C, someone else might need to help on this end.)  The fix would be to document this as well.
How-To-Repeat: 
man pw

man adduser

ls /usr/share/skel

(scratch head about dot.cshrc syntax)

Comment 1 Tom Rhodes freebsd_committer

2006-10-09 18:57:55 UTC

State Changed
From-To: open->patched

The adduser(8) manual page does mention the files, but I 
added a better description regarding the naming convention 
of these files to pw.8.  Switch this to me, MFC reminder.

Comment 2 Tom Rhodes freebsd_committer

2006-10-09 18:57:55 UTC

Responsible Changed
From-To: freebsd-doc->trhodes

The adduser(8) manual page does mention the files, but I 
added a better description regarding the naming convention 
of these files to pw.8.  Switch this to me, MFC reminder.

Comment 3 dfilter service freebsd_committer

2006-10-09 18:58:40 UTC

trhodes     2006-10-09 17:57:40 UTC

  FreeBSD src repository

  Modified files:
    usr.sbin/pw          pw.8 
  Log:
  Note the naming convention of files in share/skel and explain the "dot"
  prefix is removed.
  
  PR:     103828
  
  Revision  Changes    Path
  1.38      +8 -0      src/usr.sbin/pw/pw.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"

Comment 4 dfilter service freebsd_committer

2006-11-03 08:43:50 UTC

trhodes     2006-11-03 08:43:37 UTC

  FreeBSD src repository

  Modified files:        (Branch: RELENG_6)
    usr.sbin/pw          pw.8 
  Log:
  MFC:
    Note the naming convention of files in share/skel and explain the "dot"
    prefix is removed.
  
    PR:     103828
  
  Approved by:    re (hrs)
  
  Revision  Changes    Path
  1.37.2.1  +9 -1      src/usr.sbin/pw/pw.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"

Comment 5 Tom Rhodes freebsd_committer

2006-11-03 08:44:16 UTC

State Changed
From-To: patched->closed

Changes have been merged, thanks!