misc/50787: Describe the format of usermgmt.conf

[Tr%visPaul.me@localhost]

>Number:         50787
>Category:       misc
>Synopsis:       Describe the format of usermgmt.conf
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Tue Feb 09 04:50:00 +0000 2016
>Originator:     Travis Paul
>Release:        current
>Organization:
>Environment:
NetBSD kagato.netverb.com 7.99.26 NetBSD 7.99.26 (kagato) #0: Sun Feb  7 11:33:50 EST 2016  tpaul%kagato.netverb.com@localhost:/build/obj/sys/arch/amd64/compile/kagato amd64

>Description:
While trying to figure out the format for usermgmt.conf I came across a 2012 Google Code-In task which had added a syntax example to the usermgmt.conf manpage:
https://www.google-melange.com/gci/task/view/google/gci2012/7958203

Patch below is taken from the diff submitted by Matthew Bauer, tested with man from current.
>How-To-Repeat:
The manpage for usermgmt.conf doesn't describe the configuration file format.
>Fix:
Index: usermgmt.conf.5
===================================================================
RCS file: /cvsroot/src/usr.sbin/user/usermgmt.conf.5,v
retrieving revision 1.7
diff -u -r1.7 usermgmt.conf.5
--- usermgmt.conf.5     31 Dec 2009 20:14:19 -0000      1.7
+++ usermgmt.conf.5     9 Feb 2016 04:36:04 -0000
@@ -135,6 +135,22 @@
 sets the default skeleton directory in which to find files
 with which to populate the new user's home directory.
 .El
+.Sh SYNTAX 
+The
+.Nm usermgmt.conf
+file uses a simple syntax format.
+Each line must contain one option.
+That option must be in the front of the line (no spaces).
+Any number of white spaces such as ' ' and '\\t' may follow.
+The line ends with a list of options from each.
+.Sh EXAMPLE
+.Bd -unfilled -offset indent -compact
+group     wheel
+base_dir  /home/
+skel_dir  /etc/skel
+shell     /bin/sh
+inactive  0
+.Ed
 .Sh FILES
 .Bl -tag -width /etc/usermgmt.conf -compact
 .It Pa /etc/usermgmt.conf