jacques has asked for the wisdom of the Perl Monks concerning the following question:

I want to create a simple line break in POD. I don't want a paragraph break (no space between lines), nor do I want any bolding or anything else other than a line break!

Replies are listed 'Best First'.
Re: POD line-break
by jZed (Prior) on Jan 12, 2005 at 04:43 UTC
    If you want control over wrapping, use verbatim text (i.e. start the text with a space, then create a line break by pressing enter wherever you want and start the next line with a space also, that will give you a line break in the HTML display). If you want some different behaviour, then subclass Pod::Simple::HTML.
[reply]
Re: POD line-break
by Aristotle (Chancellor) on Jan 12, 2005 at 12:49 UTC

    By and large this is not possible. Inserting a literal linefeed using E<10> followed by whitespace seems to work for the plaintext and manpage formatters, but other formatters may or may not respect it.

    Makeshifts last the longest.

[reply]
[d/l]
      Looks like it (no longer?) works. pod2text ignores it and pod2man renders it as new paragraph. pod2html ignores it.
[reply]
Re: POD line-break
by Anonymous Monk on Jan 12, 2005 at 09:54 UTC
    You can't do that in POD - that is, POD doesn't know the concept of a linebreak. You could however put in a line break for each output format you care about, using the 
      =for

    [download]
    directive.
[reply]
[d/l]
A reply falls below the community's threshold of quality. You may see it by logging in.

Back to Seekers of Perl Wisdom