On approximately 11/14/2003 12:53 AM, came the following characters from
the keyboard of Jeremy White:
I would be more than willing to bring the files together and serve
them up on jeb.ca
Erick, are you able to generate flat html files which could be included
automatically in new builds?
Speaking of flat HTML files, I know that there are a bunch of HTML files
that are included with the source distribution that are not included
with the binary distribution.
Laurent's instructions for making the binary distribution, which worked
great overall (Thanks Laurent), include making a few pod2html files and
including them in the distribution.
I noticed that running pod2html on gui.pm produces an error (no title
for GUI.pm) and that the corresponding GUI.html file is rather limited.
I've mostly ignored POD in my Perl coding, so I don't have a clue what
should be done to fix that... but maybe it isn't necessary since under
docs/html there is a GUI.html which is the top logical layer of all the
other HTML files in the distribution... so if those other HTML files
could be included in the binary distribution in such a way that they
appear as part of the ActivePerl documentation tree, that would be a
much better solution, perhaps, than fixing the POD in GUI.pm
From the way Laurent packaged the other two HTML files in his
distribution, it would seem that it is just a matter of copying them to
the appropriate subtree under blib\html\lib\Win32 ????
It appears that is set up to allow for one HTML file for each package?
Yet GUI.pm hyperlinks to other HTML files... some of which are for
subpackages, and some of which are not. How does one handle the ones
that are not?
If we get more documentation into the distribution, then perhaps Erick
could organize his site a little differently, to automatically include
the distributed documentation (which it appears a lot of the
documentation there is from the source distribution, but then there is
more... at least the FAQ and code samples, I haven't compared all he
other stuff against what is in the source distribution.)
Maybe including documantation for several different releases?
Maybe including a list of differences between different releases?
I've lost track of the list of differences between 0.0.558 and 0.0.665,
for example. I know the (incomplete) NEM was introduced, but what else?
3) I'd be willing to incorporate patches into my version, if someone
identifies them, and sends me the patches, they aren't too
cumbersome to apply, and make the merged binary distribution available.
There were a couple of fixes for the splitter control that were
mentioned a while back, I'll see if I can dig them out. I've also got a
small extension to the datetime control that could go in to.
I'd be willing to incorporate these if you can find them and email them
to me.
--
Glenn -- http://nevcal.com/
===========================
Like almost everyone, I receive a lot of spam every day, much of it
offering to help me get out of debt or get rich quick. It's ridiculous.
-- Bill Gates
And here is why it is ridiculous:
The division that includes Windows posted an operating profit of $2.26
billion on revenue of $2.81 billion.
--from Reuters via
http://biz.yahoo.com/rc/031113/tech_microsoft_msn_1.html
So that's profit of over 400% of investment... with a bit more
investment in Windows technology, particularly in the area of
reliability, the profit percentage might go down, but so might the bugs
and security problems? Seems like it would be a reasonable tradeoff.
WalMart earnings are 3.4% of investment.
