Re: [Module-build-general] Hello and manifypods
Status: Beta
Brought to you by:
kwilliams
|
From: Ken W. <ke...@ma...> - 2003-07-15 23:26:38
|
On Monday, July 14, 2003, at 04:15 PM, Dave Rolsky wrote: > On Mon, 14 Jul 2003, Steve Purkis wrote: > - Section 1 pods should be generated based on the files found by > $self->find_script_files, I think. > > - Section 3 pods should be generated based on $self->find_pod_files, > and > $self->find_pm_files. These are higher level than running ->rscan_dir > and > allow the module maintainer to specify which files to process. If you > just run rscan_dir yourself you'd be ignoring that. Section 3 pods should probably be generated from blib/lib and blib/arch, and section 1 pods should be generated from blib/script. This is because theoretically, the process of copying lib/* to blib/lib/* and the like can do all kinds of transformations on the POD. For instance, in Mason we can transform some special P<> tags to normal POD. -Ken |