> If you would like to write a section for the HOW-TO for menus, that would be
It seems to me that it is more sensible to put documentation where it belongs - in
the documentation - rather than dispersing the fundamental knowledge around
various tutorials. The existing HTML documentation, which purport to be created
from what used to be POD documentation, is full of "TBA" references to objects,
methods, etc. Yet it is clear that the objects and methods are now fairly well
defined, so... why??
( ... and don't get me started on the issue of moving POD documentation out of the
code itself - which is just begging for trouble in my opinion ;-) )
I was unable to find your 'how-to' in any of the documentation I have (what is the
filename?). Is it part of the CVS repository? I'd like to have a look at it...
I guess my "complaint" (and it seems to be coming across as much more unpleasant
than I actually intended it to) is that there is documentation up the ying-yang!
Enough to sink a battleship! But the *main* documentation, which IMO should be in
POD form (and better yet, in the code itself) is still not up to date relative to
all of the other available support materials. So in order to learn how to use
some of the modules you have to search through pages and pages of tutorials and
other tangental documents, sometimes even source code, to achieve the inherently
simple goal of making a widget appear on the screen.
Again, I want to stress that this is **NOT** a criticism of anyone! Like many of
you, I am a professional Perl coder, and I know how busy I get and how hard it is
to find time to work on my favorite projects... but that is, supposedly, why
Win32::GUI is on SourceForge - because the authors realized how valuable the code
was going to be, and very kindly decided to release it to the O.S. community so
that it would never become deprecated, even if they got too busy to support it
themselves. But what has happened is that we now have an enormous amount of
"support" in the community, without the original project files themselves ever
being completed (at least w.r.t. documentation).
Feel free to flame me if I am getting on anyones nerves. I don't mean to - I am
only offering a pair of hands and some free time to help, having just experienced
over the past couple of months what it is like to be a newcomer to the Win32::GUI
community... I hope my comments are taken in the right light!