Front page | perl.perl5.porters |
Postings from December 2004
From: Russ Allbery
December 24, 2004 10:41
Message ID: email@example.com
Ronald J Kimball <firstname.lastname@example.org> writes:
> On Fri, Dec 24, 2004 at 11:12:05AM +0100, Juerd wrote:
>> =head2 Lists
>> An example is much clearer than an explanation here.
>> =head2 Methods
>> =over 12
> I think that should be =over 4, since the example shows an indent of 4 from
> the heading:
>> "new" Returns a new My::Module object.
>> "as_string" Returns a stringified representation of the
>> object. This is mainly for debugging purposes.
No, the indent specified by =over is the indent of the paragraphs from the
list tags. 12 is right; the intention is to get the method name entirely
in the left-hand margin rather than putting it on a separate line.
The indentation of a list from a heading is determined by the formatter.
Russ Allbery (email@example.com) <http://www.eyrie.org/~eagle/>