in reply to POD troubles
> I had some spaces on the line before the =head1 in question.
please be aware that POD cares about indentation to distinguish paragraphs, in other words only completely empty lines separate them.
Thats especially helpful when having code-blocks with empty lines
print 1; print 3;
since the second line is not empty this code belongs to one code paragraph!
BTW: The default setting of cperl-mode is very helpful, it shows trailing spaces as "_" in emacs. (I've set it up to be a whitespace again, but with grey background color, to avoid confusion with underscore)
Cheers Rolf
UPDATE:
Some older Pod translators require paragraphs (including command paragraphs like "=head2 Functions") to be separated by completely empty lines. If you have an apparently empty line with some spaces on it, this might not count as a separator for those translators, and that could cause odd formatting.
Simply searching perlpod for the word "empty" will show you more detailed information and should answer your questions.
|
---|
Replies are listed 'Best First'. | |
---|---|
Re^2: POD troubles
by John M. Dlugosz (Monsignor) on May 14, 2011 at 09:56 UTC | |
by LanX (Saint) on May 14, 2011 at 10:26 UTC | |
by John M. Dlugosz (Monsignor) on May 14, 2011 at 10:57 UTC | |
Re^2: POD troubles
by John M. Dlugosz (Monsignor) on May 14, 2011 at 10:26 UTC | |
by LanX (Saint) on May 14, 2011 at 10:37 UTC | |
by John M. Dlugosz (Monsignor) on May 14, 2011 at 11:18 UTC | |
by LanX (Saint) on May 14, 2011 at 11:21 UTC | |
by John M. Dlugosz (Monsignor) on May 14, 2011 at 11:34 UTC | |
|