Date: Mon, 22 Sep 2014 12:50:13 +0400 From: Sergey Kandaurov <pluknet@gmail.com> To: Benjamin Kaduk <bjk@freebsd.org> Cc: Konstantin Belousov <kostikbel@gmail.com>, "freebsd-doc@FreeBSD.org" <doc@freebsd.org> Subject: Re: libthr and main thread stack size Message-ID: <CAE-mSOKN4q5VMV2jGtV6BY11NzT6FQzz20Axet60PsOYdgWcAQ@mail.gmail.com> In-Reply-To: <alpine.GSO.1.10.1409211629300.21571@multics.mit.edu> References: <53E36E84.4060806@ivan-labs.com> <FEB60EB5-546D-454D-AE62-B2483246E42C@scsiguy.com> <20140916081324.GQ2737@kib.kiev.ua> <5242716.s4iaScq0Bu@ralph.baldwin.cx> <20140920170658.GE2210@kib.kiev.ua> <alpine.GSO.1.10.1409211629300.21571@multics.mit.edu>
next in thread | previous in thread | raw e-mail | index | archive | help
On 22 September 2014 02:39, Benjamin Kaduk <bjk@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAE-mSOKN4q5VMV2jGtV6BY11NzT6FQzz20Axet60PsOYdgWcAQ>