svn commit: r347951 - stable/12/lib/libc/stdlib

[Bruce Evans]

On Sun, 19 May 2019, Warner Losh wrote:

> On Sun, May 19, 2019 at 9:56 AM Yoshihiro Ota <ota at j.email.ne.jp> wrote:
>
>> I wonder if we can use a tool to confirm coding style like
>> clang-format or something else.
>
> I don't know... it might be hard to do that inside a man page...

Examples in man pages need special treatment since man adds a 5 column
left margin and then must mangle tabs to preserve 8-column indentation.
The examples must at least be formatted for width 74 instead of 79, but
74 is better anyway.

I had some success turning SYNOPSIS sections into C code for checking
that the headers are complete and the documented prototypes agree with
the headers.  Large examples would probably have to be extracted manually
since they are less structured than SYNOPSIS sections.

Bruce