Re^2: POD error help

You should be escaping all your "<", ">", "/" and "|" as E<lt>, E<gt>, E<sol>, E<verbar>.

No, there's no need. Giving advice like that shows you don't understand the intend of POD. Go read the manual page. Pay attention to the first sentence of the description, and the paragraph "Intent".

For further details, read my reply to davorg's post.

Perl --((8:>*

Comment on Re^2: POD error help

Replies are listed 'Best First'.
Re^3: POD error help by xdg (Monsignor) on Nov 03, 2005 at 16:43 UTC
Leaving aside whether I "understand the intent", I said should, not must The actual text from perlpod about the escape codes is this: The above four are optional except in other formatting codes, notably "L<...>", and when preceded by a capital letter. Notice that it doesn't say "the above four are unnecessary except in...". "Optional" can cut either way. I prefer advising general rules as opposed to the special cases because its easier to remember and follow. You prefer special cases because it's less to type and less hassle. That's cool -- no need to make it a religious war and get personal about it. As to intent, I personally think even Pod is not simple enough. See Pod::WikiDoc, which simplifies some things even more (though sadly at the cost of more complexity elsewhere). -xdg Code written by xdg and posted on PerlMonks is public domain. It is provided as is with no warranties, express or implied, of any kind. Posted code may not have been tested. Use of posted code is at your own risk.	[reply]

Replies are listed 'Best First'.

Re^3: POD error help
by xdg (Monsignor) on Nov 03, 2005 at 16:43 UTC

Leaving aside whether I "understand the intent", I said should, not must The actual text from perlpod about the escape codes is this:

The above four are optional except in other formatting codes, notably "L<...>", and when preceded by a capital letter.

Notice that it doesn't say "the above four are unnecessary except in...". "Optional" can cut either way. I prefer advising general rules as opposed to the special cases because its easier to remember and follow. You prefer special cases because it's less to type and less hassle. That's cool -- no need to make it a religious war and get personal about it.

As to intent, I personally think even Pod is not simple enough. See Pod::WikiDoc, which simplifies some things even more (though sadly at the cost of more complexity elsewhere).

-xdg

Code written by xdg and posted on PerlMonks is public domain. It is provided as is with no warranties, express or implied, of any kind. Posted code may not have been tested. Use of posted code is at your own risk.

[reply]