Re: Splitting large pages to smaller ones

[David Holland <dholland-docs%netbsd.org@localhost>]

On Wed, Jun 30, 2010 at 03:52:10PM +0300, Jukka Ruohonen wrote:
 > Any opinions about splitting large manual pages to several smaller ones?

I think it's generally a good idea, but it's important to also have an
overview somewhere that can be readily found.

 > Few points:
 > 
 >      1. The manual page format lends itself badly to anything bigger than
 >         three or four pages. This is especially evident when a page is
 >         viewed from a terminal and the content is mostly discussion
 >         around function prototypes. $PAGER has also poor search
 >         capabilities, etc.

Yes.

Although just splitting things up in itself doesn't help much (look at
for example the gmake info files) -- it's organization that matters,
and organization is expensive...

-- 
David A. Holland
dholland%netbsd.org@localhost