On 22 September 2014 02:39, Benjamin Kaduk <b...@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 _______________________________________________ freebsd-doc@freebsd.org mailing list http://lists.freebsd.org/mailman/listinfo/freebsd-doc To unsubscribe, send any mail to "freebsd-doc-unsubscr...@freebsd.org"
