docs/103828: pw/adduser manpage make no mention of "dot.file" replace syntax in /usr/share/skel

[Dan Mahoney]

>Number:         103828
>Category:       docs
>Synopsis:       pw/adduser manpage make no mention of "dot.file" replace syntax in /usr/share/skel
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Sep 29 22:20:18 GMT 2006
>Closed-Date:
>Last-Modified:
>Originator:     Dan Mahoney (danm at prime.gushi.org)
>Release:        FreeBSD 6.1-RELEASE-p3 i386
>Organization:
Gushi Systems
>Environment:
System: FreeBSD prime.gushi.org 6.1-RELEASE-p3 FreeBSD 6.1-RELEASE-p3 #0: Sat Aug 12 16:12:54 EDT 2006 danm at newprime.gushi.org:/usr/obj/usr/src/sys/GENERIC i386

Standard FreeBSD 6.1 release system, any hardware.


>Description:

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.

>How-To-Repeat:

man pw

man adduser

ls /usr/share/skel

(scratch head about dot.cshrc syntax)

>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.


>Release-Note:
>Audit-Trail:
>Unformatted: