From owner-freebsd-doc@FreeBSD.ORG Mon Sep 22 08:50:15 2014 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 8534A534; Mon, 22 Sep 2014 08:50:15 +0000 (UTC) Received: from mail-wg0-x229.google.com (mail-wg0-x229.google.com [IPv6:2a00:1450:400c:c00::229]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id EDDD924C; Mon, 22 Sep 2014 08:50:14 +0000 (UTC) Received: by mail-wg0-f41.google.com with SMTP id k14so2239262wgh.0 for ; Mon, 22 Sep 2014 01:50:13 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-type; bh=JQYf1+zbRug53D9VLoUWKEcJG5Ov816VRhOdBNuv9QE=; b=zF75F+t+agKj5Uw2UBa4LiqbfjBe3lrXynvvEgO9K4BNbYvb8CkXKXubsyTAGMhSvP kh+JAlTcbRWFhoRRubntF9sBB7lL9k85lvLIvvqhNxqQovXeoK8RRotm8qaPmOd7kwHg W87foN9QQqAb7E8j9yohUPC5UMiqewrn9ab7IHYcrbQWD5NH3Umh0/8+SV6vw+pvIVIf KQ8EC7MdniEuoJ24+lqWjWjr2jE94zJ+Roa6xTHlDWCAjn2kmtbuNZnGlZiNNUoDYz0V HRniepz8MMMK52/5/UoRgDkVaFcc6JvqcAhi9OSe454BTfnlr4gGKWrs3FKulA9nstF/ Q0Eg== MIME-Version: 1.0 X-Received: by 10.194.142.166 with SMTP id rx6mr19194430wjb.38.1411375813199; Mon, 22 Sep 2014 01:50:13 -0700 (PDT) Received: by 10.216.53.68 with HTTP; Mon, 22 Sep 2014 01:50:13 -0700 (PDT) In-Reply-To: References: <53E36E84.4060806@ivan-labs.com> <20140916081324.GQ2737@kib.kiev.ua> <5242716.s4iaScq0Bu@ralph.baldwin.cx> <20140920170658.GE2210@kib.kiev.ua> Date: Mon, 22 Sep 2014 12:50:13 +0400 Message-ID: Subject: Re: libthr and main thread stack size From: Sergey Kandaurov To: Benjamin Kaduk Content-Type: text/plain; charset=ISO-8859-1 Cc: Konstantin Belousov , "freebsd-doc@FreeBSD.org" X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.18-1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 22 Sep 2014 08:50:15 -0000 On 22 September 2014 02:39, Benjamin Kaduk 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