> * Orton, Yves <[EMAIL PROTECTED]> [2003-09-22 10:11]:
> > I want Pod::Find to be smarter so that it keeps track of files
> > it has already scanned and havent changed since that time. It
> > sounds like what you have will do something like this.
>
> That is not a job for Pod::Find. At most, Pod::Find should
> provide a callback mechanism; the bookkeeping mechanism is the
> responsibility of the program using Pod::Find.
Actually id like to be able to pass it a hash of known files in the following format:
{
filespec => mtime
}
or maybe:
{
filespec => [mtime,size]
}
If the file is found, and it matches the file attributes then it should be ignored. Otherwise it should be treated as it is. It should obviously respond with a hash of equivelent data.
Then it would be trivial to keep a list of POD youve found, or POD that needs updating.
If this was facilitated by a callback mechanism then fine, personally I wouldnt go that route, id just do the hash directly. OTOH, ive contemplating hacking POD::Find in this way so many times and not done it, that if someone handed me any way to do it then I would use it, whatever shape or form it took.
> > Anyway, if this is all covered somewhere else, or by your
> > module someone please let me know. I currently have an awful
> > lot of CPAN stuff installed, and it really frustrates me that
> > converting it into a comprehensvice cross linked and indexed,
> > HTML version is so hokey.
>
> There is one on CPAN in the scripts section but that has numerous
> shortcomings (IMHO). I have my own script to do this (with
> various neat features), but am currently changing it away from
> relying on Pod::Tree::HTML (which uses HTML::Stream (I think it
> was called)) which I didn't like at all to a Pod::Simple based
> HTML converter.
I use a custom hacked version of the TOMC version of POD::HTML that emits XHTML and some additional indexing.
Ive been contemplating switching to newer versions of the POD::HTML converters but never got around to it. Plus I like the XHTML output that I get. (Many more tag classes so the CSS can be pushed further.)
>
> There's oodles of crannies it already has and more I want to add.
> I don't know when I'll release it, yet - depends on how much time
> I can spare for it. I'd like this finished sooner than later,
> myself, since, as you said, creating fully interlinked HTML of
> the POD from all installed modules is such a hideous task.
Id love to have a look if you feel like sending it over.
Yves
