Re: Pod::Simple "simplification"

[email protected] (Russ Allbery)
Newsgroups perl.pod-people
Organization The Eyrie
Message-ID <[email protected]>
Ricardo Signes <[email protected]> writes:

> Is there any strong feeling that Pod::Simple needs to have so many
> things done either apparently or clearly in the interest of speed?  I
> found a number of methods that I could barely track down because they're
> generated strangely, explicitly in the name of speed.  There's a good
> bit of code to allow debugging output to be optimized away, which leads
> to stupid method of using "DEBUG" which leads to stupid bugs.  And so
> on.

Ironically, Pod::Simple is still rather slow, and I didn't notice that
much of a performance improvement over the previous Pod::Parser when I
switched the podlators modules to it.

> I would like to refactor the code as I work so that methods are easier
> to find, use, and replace as needed.  Maybe I can fill in some of the
> "to do" documentation, once I understand what the hell is going on.

I think that would be awesome.  I end up having to read source code
whenever I have to interact with it since the documentation for people
writing POD translators leaves a lot to be desired.

-- 
Russ Allbery ([email protected])             <http://www.eyrie.org/~eagle/>
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.