From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-bw0-f49.google.com (mail-bw0-f49.google.com [209.85.214.49]) by krisdoz.my.domain (8.14.3/8.14.3) with ESMTP id p639ViQQ032721 for ; Sun, 3 Jul 2011 05:31:45 -0400 (EDT) Received: by bwf12 with SMTP id 12so4651557bwf.36 for ; Sun, 03 Jul 2011 02:31:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=sender:date:from:to:cc:subject:message-id:reply-to:mail-followup-to :references:mime-version:content-type:content-disposition :in-reply-to:user-agent; bh=SNV5FXE9MmDu0w1jvbL1VqD4LW/xD7FqazVt3YDk6wg=; b=hu6PT/WGqlc9OWCh/gK2zdAtjIxOeCQevY0g91D/xNqYs2AT4+7ev1Mv10RZtAvTsT m6Csrw9F9py/hMec3ZJ9woOe9oXaP+q5ev2C1YgiTbDgnr57AeSdDlCOmn+8hqQRrXCq hi7zkQT12hXl+HNlGHSwDQPh8hul34JmVBxvU= Received: by 10.204.16.133 with SMTP id o5mr4619558bka.158.1309685497603; Sun, 03 Jul 2011 02:31:37 -0700 (PDT) Received: from marx.bitnet (xdsl-83-150-88-127.nebulazone.fi [83.150.88.127]) by mx.google.com with ESMTPS id k16sm4547057bks.13.2011.07.03.02.31.35 (version=TLSv1/SSLv3 cipher=OTHER); Sun, 03 Jul 2011 02:31:36 -0700 (PDT) Sender: a b Received: by marx.bitnet (Postfix, from userid 1000) id 686A356C5; Sun, 3 Jul 2011 12:31:34 +0300 (EEST) Date: Sun, 3 Jul 2011 12:31:34 +0300 From: Jukka Ruohonen To: discuss@mdocml.bsd.lv Cc: Paul Onyschuk Subject: Re: Lengthy documentation in mdoc Message-ID: <20110703093133.GA17709@marx.bitnet> Reply-To: jruohonen@iki.fi Mail-Followup-To: discuss@mdocml.bsd.lv, Paul Onyschuk References: <20110702213626.dda0b983.blink@bojary.koba.pl> <20110702203740.GA1292@iris.usta.de> X-Mailinglist: mdocml-discuss Reply-To: discuss@mdocml.bsd.lv Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20110702203740.GA1292@iris.usta.de> User-Agent: Mutt/1.4.2.3i 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. [1] http://netbsd.gw.com/cgi-bin/man-cgi?mqueue++NetBSD-current -- To unsubscribe send an email to discuss+unsubscribe@mdocml.bsd.lv