I spent many years writing man pages for kernel/driver interfaces and the code examples there were often pretty long... It would be good if the section 2 and section 3 pages had more code examples on them -- I don't know if that will ever happen (maintenance and commenting can become a pretty major effort) but it would be nice if the tools didn't prevent it...
--- "Eric S. Raymond" <[EMAIL PROTECTED]> wrote: > Meg McRoberts <[EMAIL PROTECTED]>: > > I do like mm's .ne functionality -- this allows the writer to specify > > that the next <x> lines need to stay together on a page -- it might force > > a page break if there isn't enough space left on the page, but it won't > > force a page break if there is room. But .DS/DE get really problematic > > in a world where the output varies so greatly. > > I agree that the "keep on one page" feature of .DS becomes pretty meaningless > in an HTML world. Then again, man-page displays tend to be very short, so it > might not really be an issue if we tried to take that requirement seriously. > -- > <a href="http://www.catb.org/~esr/";>Eric S. Raymond</a> > _______________________________________________ Groff mailing list Groff@gnu.org http://lists.gnu.org/mailman/listinfo/groff
