Re: [PATCH] man-pages.7: Document CAVEATS section

Alejandro Colomar
2022-07-26T14:30:28Z

[-- Attachment #1.1: Type: text/plain, Size: 1837 bytes --]

Hi Ingo,

On 7/26/22 15:54, Ingo Schwarze wrote:
> Hi Alejandro,
>
> Alejandro Colomar wrote on Tue, Jul 26, 2022 at 02:08:18PM +0200:
>
>> CAVEATS is an interesting section from OpenBSD.
>
> It is no doubt nice when credit is given to OpenBSD,
> but in this case, it happens to be undeserved. ;-)
>
> I see the following early uses of ".SH CAVEATS":
>
> * 4.2BSD execve(2), released September 1983, author unknown
> * 4.3BSD-Tahoe patch(1), released June 1988, author: Larry Wall
> * 4.3BSD-Reno amd(8), released June 1990, author: Jan-Simon Pendry
> * 4.4BSD strftime(3), released June 1993, author: Arnold Robbins
> * 4.4BSD gzip(1), released June 1993, author (unsure) Jean-loup Gailly ?
> * 4.4BSD mount_kernfs(8), released June 1993, author: Jan-Simon Pendry
>
> The first instance of ".Sh CAVEATS" i found is:
>
> * 4.4BSD-Lite1 realpath(3), released April 1994, author Keith Bostic
>
> It doesn't look as if the UC CSRG used CAVEATS in additional files.
>
> Standardization was decided in NetBSD during a discussion
> on <tech-userlevel@netbsd.org> leading to this commit:
>
> /src/share/misc/mdoc.template revision 1.6
> date: 2002-07-10 09:45:18 +0000; author: yamt; state: Exp; lines: +2 -1;
> add CAVEATS section. discussed on tech-userlevel.
>
> The login name "yamt" belongs to YAMAMOTO Takashi.
>
> It was then quickly picked up in OpenBSD by Jason McIntyre.
>
> So the section has a tradition of almost 40 years and has been
> standardized in *BSD for about two decades, even though it was
> not originally a BSD invention.

Wasn't it a BSD invention? The sources you mentioned seem to say it is.

Would it be correct to say "... section from the BSDs"?

Cheers,

Alex

--
Alejandro Colomar
<http://www.alejandro-colomar.es/>

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 833 bytes --]