From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from smtp-2.sys.kth.se (smtp-2.sys.kth.se [130.237.32.160]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id p63BcOKm002150 for ; Sun, 3 Jul 2011 07:38:25 -0400 (EDT) Received: from mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) by smtp-2.sys.kth.se (Postfix) with ESMTP id 8C47E14D7D6 for ; Sun, 3 Jul 2011 13:38:18 +0200 (CEST) X-Virus-Scanned: by amavisd-new at kth.se Received: from smtp-2.sys.kth.se ([130.237.32.160]) by mailscan-1.sys.kth.se (mailscan-1.sys.kth.se [130.237.32.91]) (amavisd-new, port 10024) with LMTP id iWbzd93Bbx-G for ; Sun, 3 Jul 2011 13:38:15 +0200 (CEST) X-KTH-Auth: kristaps [89.158.117.88] X-KTH-mail-from: kristaps@bsd.lv X-KTH-rcpt-to: discuss@mdocml.bsd.lv Received: from macky.local (89-158-117-88.rev.dartybox.com [89.158.117.88]) by smtp-2.sys.kth.se (Postfix) with ESMTP id B74E414C137 for ; Sun, 3 Jul 2011 13:38:14 +0200 (CEST) Message-ID: <4E1054A5.2040903@bsd.lv> Date: Sun, 03 Jul 2011 13:38:13 +0200 From: Kristaps Dzonsons User-Agent: Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.2.18) Gecko/20110616 Thunderbird/3.1.11 X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv MIME-Version: 1.0 To: discuss@mdocml.bsd.lv Subject: Re: Lengthy documentation in mdoc References: <20110702213626.dda0b983.blink@bojary.koba.pl> <20110702203740.GA1292@iris.usta.de> <20110703093133.GA17709@marx.bitnet> In-Reply-To: <20110703093133.GA17709@marx.bitnet> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit On 03/07/2011 11:31, Jukka Ruohonen wrote: > On Sat, Jul 02, 2011 at 10:37:40PM +0200, Ingo Schwarze wrote: >>> I looked into multiple scenarios: >>> - splitting man page like zsh >> >> ... you go that way, which i don't recommend at all. >> It causes many problems. For example, you can't search in a manual >> like that, and moving about it is a pain in general. >> In OpenBSD, we even lumped openssl(1) all into one page >> when importing it from upstream. > > I beg to disagree. In NetBSD we have actively tried to split huge pages into > smaller pieces while providing an introductory summary page (for an example > see [1]). When viewed from a terminal, anything longer than say three pages > does not serve well the whole man page format. Also: the search capabilities > generally suck. Jukka, Sounds like more of a problem with the tools than the format. Can you imagine any ways to fix this? If anything constructive comes to mind, chime in and maybe it'll be worth some effort in mandoc-tools to field alternatives to mandoc | less. Kristaps -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv