Hi Brian, Brian Callahan wrote on Wed, Dec 25, 2013 at 11:55:43PM -0700:
> A user asked me earlier today when our locale(1) appeared. > Do we want to put that in the man page? Definitely. However, i'd suggest to reserve the wording "(first) appeared in" for original inventions in the operating system and version cited. Yes i know we didn't stick to that in the past and there is much to clean up, but i don't see the point in adding yet more ambiguity by continuing to use the same wording for vastly different things. I suggest to be as specific as possible in the HISTORY and AUTHORS sections. That way, we provide more information without that much additional effort. The earlier it is done, the simpler to get it right. The ordeal Cynthia Livingston had to go through for the 4.3BSD-Reno and 4.4BSD releases, and the large number of errors that inevitably resulted, may well serve as a warning. See below for an example of how i'd like to see it done. If anybody knows where this abomination originally came from, i'd like to put something like this: .Sh HISTORY A .Nm utility first appeared in FooOS 0.9 (1995). It was rewritten from scratch for .Ox 5.4 during the 2013 Toronto hackathon. .Sh AUTHORS The original version was written by .An Joe F. Corporatecoder and .An Nelly G. Bloat . .Pp The OpenBSD version was written by ... Yours, Ingo Index: locale.1 =================================================================== RCS file: /cvs/src/usr.bin/locale/locale.1,v retrieving revision 1.2 diff -u -r1.2 locale.1 --- locale.1 3 Jun 2013 17:06:29 -0000 1.2 +++ locale.1 26 Dec 2013 12:44:28 -0000 @@ -61,5 +61,17 @@ .Nm utility implements a subset of the specification given in .St -p1003.1-2008 . +.Sh HISTORY +The +.Nm +utility was rewritten from scratch for +.Ox 5.4 +during the 2013 Toronto hackathon. +.Sh AUTHORS +.An Stefan Sperling Aq Mt s...@openbsd.org +with contributions from +.An Philip Guenther Aq Mt guent...@openbsd.org +and +.An Jeremie Courreges-Anglas Aq Mt j...@openbsd.org . .Sh BUGS The list of supported locales is perpetually incomplete. > Index: locale.1 > =================================================================== > RCS file: /cvs/src/usr.bin/locale/locale.1,v > retrieving revision 1.2 > diff -u -p -u -p -r1.2 locale.1 > --- locale.1 3 Jun 2013 17:06:29 -0000 1.2 > +++ locale.1 26 Dec 2013 06:53:18 -0000 > @@ -61,5 +61,10 @@ The > .Nm > utility implements a subset of the specification given in > .St -p1003.1-2008 . > +.Sh HISTORY > +The > +.Nm > +command first appeared in > +.Ox 5.4 . > .Sh BUGS > The list of supported locales is perpetually incomplete. >
