Good morning, I have created 2 man page CRs to address the issues associated with this email:
Changes to the project.4 man page can be tracked using CR 6651292. Changes to the passwd.4 man page can be tracked using CR 6651294. Thanks for bringing these issues to our attention. Pattie SunOS man page group section4 man page writer ----- Original Message ----- From: michelle olson <[email protected]> Date: Thursday, January 10, 2008 11:38 am Subject: Re: [docs-discuss] Man page section 4 updates To: Ceri Davies <ceri at submonkey.net> Cc: docs-discuss at opensolaris.org > Hi Ceri, > > Thanks for these diffs and the detailed information, much appreciated! > > -Michelle > > Ceri Davies wrote: > > Hello, > > > > I've attached a pair of diffs again the nv80 drop of the manpages. > > > > The first, project.diff, fixes a nit in the SEE ALSO section of > > project.4. > > > > The second, passwd_group.diff, may be a little more contentious, but > > updates the description of the username field in passwd.4 to point out > > exactly what will display a warning if the username is over eight bytes. > > It also updates the description of the groupname field in group.4 to > > list the same "restriction" with regard to the groupadd and grpck > > utilities. > > > > Note that the second one is possibly contentious because no such limits > > exist, with the exception that a large number of utilities break in > > various ways with user and group names over 8 characters. > > > > Ceri > > > > ------------------------------------------------------------------------ > > > > diff -ru man.orig/man4/project.4 man/man4/project.4 > > --- man.orig/man4/project.4 Wed Dec 12 11:07:47 2007 > > +++ man/man4/project.4 Wed Jan 9 12:41:42 2008 > > @@ -200,4 +200,4 @@ > > .SH SEE ALSO > > .sp > > .LP > > -\fBnewtask\fR(1), \fBprojects\fR(1), > \fBprctl\fR(1)\fBgetprojent\fR(3PROJECT), \fBsetrctl\fR(2), > \fBunistd.h\fR(3HEAD), \fBnsswitch.conf\fR(4), \fBresource_controls\fR(5) > > +\fBnewtask\fR(1), \fBprojects\fR(1), \fBprctl\fR(1), > \fBgetprojent\fR(3PROJECT), \fBsetrctl\fR(2), \fBunistd.h\fR(3HEAD), > \fBnsswitch.conf\fR(4), \fBresource_controls\fR(5) > > > > ------------------------------------------------------------------------ > > > > diff -ru man.orig/man4/group.4 man/man4/group.4 > > --- man.orig/man4/group.4 Wed Dec 12 11:07:46 2007 > > +++ man/man4/group.4 Wed Jan 9 12:58:01 2008 > > @@ -43,7 +43,7 @@ > > .ad > > .RS 13n > > .rt > > -The name of the group. > > +The name of the group. The group field accepts a string of no more > than eight characters from the set of lowercase alphabetic characters > and numeric characters. The \fBgroupadd\fR(1m) and \fBgrpck\fR(1m) > utilities display a warning message if these restrictions are not met. > > .RE > > > > .sp > > @@ -148,7 +148,7 @@ > > .SH SEE ALSO > > .sp > > .LP > > -\fBgroups\fR(1), \fBgrpck\fR(1B), \fBnewgrp\fR(1), > \fBgetgrnam\fR(3C), \fBinitgroups\fR(3C), \fBnsswitch.conf\fR(4), > \fBunistd.h\fR(3HEAD) > > +\fBgroupadd\fR(1M), \fBgroups\fR(1), \fBgrpck\fR(1B), > \fBnewgrp\fR(1), \fBgetgrnam\fR(3C), \fBinitgroups\fR(3C), > \fBnsswitch.conf\fR(4), \fBunistd.h\fR(3HEAD) > > .sp > > .LP > > \fISystem Administration Guide: Basic Administration\fR > > diff -ru man.orig/man4/passwd.4 man/man4/passwd.4 > > --- man.orig/man4/passwd.4 Wed Dec 12 11:07:47 2007 > > +++ man/man4/passwd.4 Wed Jan 9 12:54:36 2008 > > @@ -60,7 +60,7 @@ > > .rt > > is the user's login name. > > .sp > > -The login (\fBlogin\fR) and role (\fBrole\fR) fields accept a > string of no more than eight bytes consisting of characters from the > set of alphabetic characters, numeric characters, period (\fB\&.\fR), > underscore (\fB_\fR), and hyphen (\fB-\fR). The first character should > be alphabetic and the field should contain at least one lower case > alphabetic character. A warning message is displayed if these > restrictions are not met. > > +The login (\fBlogin\fR) and role (\fBrole\fR) fields accept a > string of no more than eight bytes consisting of characters from the > set of alphabetic characters, numeric characters, period (\fB\&.\fR), > underscore (\fB_\fR), and hyphen (\fB-\fR). The first character should > be alphabetic and the field should contain at least one lower case > alphabetic character. The \fBpwck\fR(1m) and \fBuseradd\fR(1m) > utilities display a warning message if these restrictions are not met. > > .sp > > The \fBlogin\fR and \fBrole\fR fields must contain at least one > character and must not contain a colon (\fB:\fR) or a newline (\fB\en\fR). > > .RE > > > > ------------------------------------------------------------------------ > > > > _______________________________________________ > > docs-discuss mailing list > > docs-discuss at opensolaris.org > > > _______________________________________________ > docs-discuss mailing list > docs-discuss at opensolaris.org
