At 07:23 AM 04/23/02 +0200, Per Einar Ellefsen wrote:
Why does it make it easier? They are just small examples that will never be separate documentation to be viewed with perldoc. I'm curious. What problem does it solve changing to pod?
Not having to deal with endless HTML escapes (<, >, etc, they're all over the page!)
That's a good reason. Although I find that sometimes I still have to escape those in pod, too.
Not if you put these in verbatim sections. And also notice the recent thread at p5p,
Pod::POM shouldn't force us to escape <, > if it's not inside [A-Z]<...>. Which will
make it much easier to write things like $r->foo outside of verbatim blocks.
Though the drawback is that now (when Pod::POM is fixed) you can miss sequence qualifiers and leave things like <guide|guide::index> unnoticed by the POD parser.
__________________________________________________________________ Stas Bekman JAm_pH ------> Just Another mod_perl Hacker http://stason.org/ mod_perl Guide ---> http://perl.apache.org mailto:[EMAIL PROTECTED] http://use.perl.org http://apacheweek.com http://modperlbook.org http://apache.org http://ticketmaster.com
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
