develooper Front page | perl.perl5.porters | Postings from April 2010

Re: RFC: Perl manual pages -- update to follow the perlstyle.podguidelines

Thread Previous | Thread Next
From:
Andy Dougherty
Date:
April 6, 2010 07:46
Subject:
Re: RFC: Perl manual pages -- update to follow the perlstyle.podguidelines
Message ID:
alpine.DEB.2.00.1004061008040.31516@fractal.phys.lafayette.edu
On Tue, 6 Apr 2010, Nicholas Clark wrote:

> On Sat, Apr 03, 2010 at 04:38:24PM -0600, Tom Christiansen wrote:
> 
> > BTW, the reason why examples like this:
> > 
> >    #  0    1    2     3     4    5     6     7     8
> >    ($sec,$min,$hour,$mday,$mon,$year,$wday,$yday,$isdst) =
> >                                                localtime(time);
> > 
> > are *not* written
> > 
> > 
> >    # 0     1     2      3      4     5      6      7      8
> >    ($sec, $min, $hour, $mday, $mon, $year, $wday, $yday, $isdst) =
> >                                                localtime(time);
> > 
> > is due to the default nroff line length.
> 
> What is the default nroff line length?

I believe it traditionally has been 65 characters.  (Well, 6.5 inches, 
with 10 characters per inch.)  However, most lines (except for headings) 
also end up indented by some amount (traditionally 5 characters), and 
items in a list (such as this list in perfunc.pod) are indented further. 
Contending against this, that line is in a verbatim block, and is rendered 
in "nofill" mode, so it can overflow the 65 character limit.  What happens 
then is not well defined.

Practically speaking, either will probably render ok on most man page 
viewers these days.

-- 
    Andy Dougherty		doughera@lafayette.edu


Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About