libthr and main thread stack size

Sergey Kandaurov pluknet at gmail.com
Mon Sep 22 08:50:15 UTC 2014


On 22 September 2014 02:39, Benjamin Kaduk <bjk at freebsd.org> wrote:
> On Sat, 20 Sep 2014, Konstantin Belousov wrote:
>
>> Doc people, please review the man page in the patch.
>
> BTW, mandoc -Tlint is always a useful sanity check; it found:
> ./libthr.7:31:5: WARNING: document title should be all caps
> ./libthr.7:36:2: WARNING: section header suited to sections 2, 3, and 9 only: LIBRARY
> ./libthr.7:194:2: WARNING: skipping paragraph macro
>
> I am not sure what the best solution is the section header complaint.
> The current libthr.3 is quite short; maybe the two could be merged?

+1 for that
Seeing this as IMPLEMENTATION NOTES in libthr(3) or some such would be fine.

> I made some changes in the attached diff, though I am not fully happy with
> the final result.  In particular, I am not sure that my text in the
> section THREAD STACKS is correct.
>
> I also changed from the .Dv macro for library names like libc, to the .Li
> macro, which is sort of a catch-all option; there may be something better.
>

Also sorting SEE ALSO by section.

-- 
wbr,
pluknet


More information about the freebsd-doc mailing list