The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Acme::PERLANCAR::Dummy::POD::LineBreak - Testing linebreaks

VERSION

This document describes version 0.005 of Acme::PERLANCAR::Dummy::POD::LineBreak (from Perl distribution Acme-PERLANCAR-Dummy-POD), released on 2021-07-09.

DESCRIPTION

Other things that don't work: E<br> is not recognized. E<13> is ignored.

WITHOUT LINEBREAK

foobar [--opt1|-O] [--regex|--wildcard] [-a] [-u] [--moreoption1=value] [--moreoption2=value] [--moreoption3=value] [--moreoption4=value] [--moreoption5=value] [--moreoption6=value] [--moreoption7=value] [--moreoption8=value] [--moreoption9=value] [--moreoption10=value] [--moreoption11=value] [--moreoption12=value] <filename> ...

WITH E<10>

foobar [--opt1|-O] [--regex|--wildcard] [-a] [-u] [--moreoption1=value] [--moreoption2=value] [--moreoption3=value] [--moreoption4=value] [--moreoption5=value] [--moreoption6=value] [--moreoption7=value] [--moreoption8=value] [--moreoption9=value] [--moreoption10=value] [--moreoption11=value] [--moreoption12=value] <filename> ...

The result: 1/10. pod2text ignores the linebreak. pod2man creates a blank line (new paragraph) instead of line break. pod2html ignores the linebreak.

WITH E<10> + E<8>

foobar [--opt1|-O] [--regex|--wildcard] [-a] [-u] [--moreoption1=value] [--moreoption2=value] [--moreoption3=value] [--moreoption4=value] [--moreoption5=value] [--moreoption6=value] [--moreoption7=value] [--moreoption8=value] [--moreoption9=value] [--moreoption10=value] [--moreoption11=value] [--moreoption12=value] <filename> ...

The result: 7/10. pod2text renders it as intended (but shifts one character to the left). pod2man renders it as intended. pod2html ignores the linebreak.

Reference: https://www.nntp.perl.org/group/perl.beginners/2006/08/msg85687.html

WITH =item

foobar [--opt1|-O] [--regex|--wildcard] [-a] [-u]
[--moreoption1=value] [--moreoption2=value]
[--moreoption3=value] [--moreoption4=value]
[--moreoption5=value] [--moreoption6=value]
[--moreoption7=value] [--moreoption8=value]
[--moreoption9=value] [--moreoption10=value]
[--moreoption11=value] [--moreoption12=value]
<filename> ...

The result: 7/10. pod2text renders it as intended. pod2man renders it as intended. pod2html shows a paragraph break and makes all lines bold.

WITH =for (providing rendered code for each output)

foobar-html [--opt1|-O] [--regex|--wildcard] [-a] [-u]
[--moreoption1=value] [--moreoption2=value]
[--moreoption3=value] [--moreoption4=value]
[--moreoption5=value] [--moreoption6=value]
[--moreoption7=value] [--moreoption8=value]
[--moreoption9=value] [--moreoption10=value]
[--moreoption11=value] [--moreoption12=value]
<filename> ...

The result: 10/10, renders as intended obviously. However, you need to provide code for each output.

HOMEPAGE

Please visit the project's homepage at https://metacpan.org/release/Acme-PERLANCAR-Dummy-POD.

SOURCE

Source repository is at https://github.com/perlancar/perl-Acme-PERLANCAR-Dummy-POD.

BUGS

Please report any bugs or feature requests on the bugtracker website https://rt.cpan.org/Public/Dist/Display.html?Name=Acme-PERLANCAR-Dummy-POD

When submitting a bug or request, please include a test-file or a patch to an existing test-file that illustrates the bug or desired feature.

SEE ALSO

https://www.perlmonks.org/?node_id=606484

AUTHOR

perlancar <perlancar@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2021 by perlancar@cpan.org.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.