svn commit: r362809 - head/contrib/mandoc
Rodney W. Grimes
freebsd at gndrsh.dnsmgr.net
Thu Jul 2 00:01:04 UTC 2020
> On Wed, Jul 01, 2020 at 11:28:47PM +0200, Gordon Bergling wrote:
> > On Wed, Jul 01, 2020 at 11:58:05AM -0600, Warner Losh wrote:
> > > On Wed, Jul 1, 2020 at 8:51 AM Rodney W. Grimes wrote:
> > > > ...
> > > > We often have "An ls command appeared in Version 1 AT&T UNIX." Our source
> > > > code and man page is not from that, but that is the history of ls.
> > > >
> > > > This *could* be amended and *should* be amended to reflect that apropos,
> > > > and makewhatis got *updated* by a switch to the mandoc versions, but it
> > > > is misleading to say it was intergrated with the switch to mandoc as that
> > > > implies it did not exist before this action.
> > >
> > > I tend to agree with Rod here. These appeared in X the first time, but
> > > noting they were replaced in version X with Y is the best way to address
> > > the current provenance of the code...
> >
> > OK, I see your arguments. How about the following addition for HISTORY section,
> >
> > The apropos utility was integrated into FreeBSD 11.1 as part of the
> > switch to mandoc. Before the switch to mandoc apropos was available since
> > FreeBSD 1.0.
>
> It should be the other way around:
>
> "The apropos utility appeared in FreeBSD 1.0. Since FreeBSD 11.1
> it is based on mandoc implementation."
Thats good, but realize the page already contains history that
reads like:
HISTORY
Part of the functionality of whatis was already provided by the former
manwhere utility in 1BSD. The apropos and whatis utilities first ap-
peared in 2BSD. They were rewritten from scratch for OpenBSD 5.6.
The -M option and the MANPATH variable first appeared in 4.3BSD; -m in
4.3BSD-Reno; -C in 4.4BSD Lite1; and -S and -s in OpenBSD 4.5 for apropos
and in OpenBSD 5.6 for whatis. The options -acfhIKklOTWw appeared in
OpenBSD 5.7.
And further contains:
UTHORS
Bill Joy wrote manwhere in 1977 and the original BSD apropos and whatis
in February 1979. The current version was written by Kristaps Dzonsons
<kristaps at bsd.lv> and Ingo Schwarze <schwarze at openbsd.org>.
So the history is rich and complete, do we really need to say when we
incorporated this into FreeBSD from OpenBSD's mandoc in the manual page?
> ./danfe
--
Rod Grimes rgrimes at freebsd.org
More information about the svn-src-all
mailing list