On 12/26/2013 7:59 AM, Ingo Schwarze wrote:
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:
The earliest mention I can find for locale(1) is in the SUSv2 docs from
1997. But it must be from earlier.
.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.
Regardless, I think this should be committed.
~Brian
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.
