comment on

I agree that the ultimate appearance depends on the renderer. I think I just stumbled upon further proof of this. I happened to be looking at the xml_merge script on CPAN, and the OPTIONS section in my web browser looks quite different from what I see at my linux command prompt when I use:

perldoc xml_merge
[download]

which resolves to:

pod2man --lax xml_merge | nroff -man
[download]

Here is a snippet of the xml_merge POD:

=head1 OPTIONS

=over 4

=item -o <output_file>

unless this option is used the program output goes to STDOUT

=item -i

the files use XInclude instead of processing instructions (they
were created using the C<-i> option in C<xml_split>)

=item -v

verbose output

=item -V

outputs version and exit

=item -h

short help

=item -m

man (requires pod2text to be in the path)

=back
[download]

Here's how the CPAN page renders for me in Firefox:

OPTIONS

-o <output_file>

    unless this option is used the program output goes to STDOUT
-i

    the files use XInclude instead of processing instructions (they we
+re
    created using the -i option in xml_split)
-v

    verbose output
-V

    outputs version and exit
-h

    short help
-m

    man (requires pod2text to be in the path)
[download]

And here's how it looks at my linux command prompt:

OPTIONS
       -o <output_file>
           unless this option is used the program output goes to STDOU
+T

       -i  the files use XInclude instead of processing instructions (
+they
           were created using the "-i" option in "xml_split")

       -v  verbose output

       -V  outputs version and exit

       -h  short help

       -m  man (requires pod2text to be in the path)
[download]

And, yes, I am tossing the term 'POD' around rather loosely.

In reply to Re^2: Avoid inconsistent POD =over =item indentation by toolic
in thread Avoid inconsistent POD =over =item indentation by toolic

Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!

Titles consisting of a single word are discouraged, and in most cases are disallowed outright.

Read Where should I post X? if you're not absolutely sure you're posting in the right place.

Please read these before you post! —

Posts may use any of the Perl Monks Approved HTML tags:

a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr

You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)

	For:		Use:
	&		`&`
	<		`<`
	>		`>`
	[		`[`
	]		`]`

Link using PerlMonks shortcuts! What shortcuts can I use for linking?

See Writeup Formatting Tips and other pages linked from there for more info.