[Catalyst] [Please Read] Mass patch attachments for all Helper namespace!

[Brandon Black]

On 2/17/06, Gavin Henry <ghenry at perl.me.uk> wrote:
> <quote who="Chisel Wright">
> > On Fri, Feb 17, 2006 at 11:18:54AM -0500, Christopher H. Laco wrote:
> >> Just out of curiosity, what is:
> >>
> >>      =begin pod_to_ignore
> >>
> >> specific to? The CPAN Indexer, or the various pod2* tools?
> >> Google doesn't turn up much.
> >
> > I thought that if you had something for =begin that nothing matched,
> > then everything would ignore it. So I gather from reading 'perldoc
> > perlpod'.
> >
> > Since there's unlikely to be anything to process pod_to_ignore it's just
> > masked universally.
>
> Yup:
>
> --------------------------
> "=begin formatname"
> "=end formatname"
> "=for formatname text..."
>
> For, begin, and end will let you have regions of text/code/data that are
> not generally interpreted as normal Pod text, but are passed directly to
> particular formatters, or are otherwise special.  A formatter that can use
> that format will use the region, otherwise it will be completely ignored.
> --------------------------
>
> So don't anyone write a formater for "pod_to_ignore" ;-)
>
> Gavin.
>
>

FYI, I found some of my helpers (C::H::M::DBIC::Schema* ones) failed
with the patch done this way.  I had to put the "pod_to_ignore" line
*after* __DATA__ rather than before.  They pass t/01use.t tests and
pod tests the other way, but they barf when you try to actually use
the helpers.

-- Brandon