Pod People, See the forwarded complaint below. Should we allow `=over 0`? I tend not to think of it as the same as `=over`, because that is the same as `=over +=4`, IIRC.
Best, David Begin forwarded message: > From: "K. Wittrock via RT" <[email protected]> > Subject: Re: [rt.cpan.org #79932] Invalid "POD Error" message > Date: October 10, 2012 6:06:04 AM PDT > To: undisclosed-recipients:; > Reply-To: [email protected] > > Queue: Pod-Simple > Ticket <URL: https://rt.cpan.org/Ticket/Display.html?id=79932 > > > > > Am 02.10.2012 18:02, schrieb David Wheeler via RT: >> <URL: https://rt.cpan.org/Ticket/Display.html?id=79932 > >> >> On Sep 30, 2012, at 9:06 AM, K. Wittrock via RT <[email protected]> >> wrote: >> >>> In addition to modules that are distributed with perl, this program >>> needs the following modules (available from CPAN): >>> >>> =over 0 >> >> Just use `=over` instead. > > POD is a widely used tool for writing documentation for Perl modules. So I > think that any module that processes Pod should accept _any_ POD text that > conforms to the POD syntax as documented in "perldoc POD". In addition, new > modules that are subclassed from Pod::Simple::HTML don't like to inherit this > misbehavior. But it's really hard to remedy this from the outside. > > On the other hand, you as the author can easily remove this invalid error > message. Simply delete lines 1180 to 1186 of Pod::Simple::BlackBox, which read > if($1 == 0) { > $self->whine( > $para->[1]{'start_line'}, > "Can't have a 0 in =over $content" > ); > $para->[1]{'indent'} = 4; > } > > And then the text of the error message in line 1190 > "=over should be: '=over' or '=over positive_number'" > might be adapted a bit. > > I do hope that you may get to like my arguments. > > A friend of mine wrote to me some additional arguments which I try to > translate to English (although I don't know what he is talking about): > > "It would be sufficient when the parser wouldn't complain about "=over 0" and > would set the indentation to 0. When in addition this would be used by the > HTML converter for setting a fitting class="OverNumber0" class="OverBullet0" > at <ol> and <ul>, then I could format this appropriately with CSS. This can > be easily done with sprintf: 'over-number' => '<ol class="OverNumber%d">' -> > sprintf($tagmap->{'over-number'},$token->{'indent'}). As far as I can see the > expenditure wouldn't be very heigh." > > Kind regards > > Klaus > >
