Re: [perl-win32-gui-hackers] [win32-gui] General Comments

[Robert M. <rm...@po...>]

Arthur Schwarz wrote:
> I've had a bad time getting restarted with Win32::GUI. In the vernacular, I've
> had 'unresolved issues'. To wit.
> 
> 1. It appears that filenames of 'GUI.pl' and folder names of
>    'GUI' cause fits, and

I don't think so.  I think it's just using package GUI and GUI::* that's 
an issue.

> 2. All Win32::GUI event names go into global namespace. This
>    appears to mean that the main program (<main>.pl> and any
>    module containing window creations with any events can not
>    have a package specified. That is, 'package <name>' and
>    'package <module>' won't work. (I think that I've seen this
>    documented somewhere).

We could really do with an expansion to the "Events" section of 
Win32::GUI::UserGuide::Concepts to introduce the NEM.  I don't see any 
documentation about the NEM anywhere.

Volunteers?

> And so, I wonder if this could be put into a prominent place, or maybe,
> prominent places, within the available documentation with specific guidelines
> as to legal Perl or Windows constructs which are not allowed. Something like:
> 
>   "DO NOT USE A MODULE NAME OF GUI.PL", and
>   "DO NOT USE A FOLDER NAME OF GUI", and
>   "DO NOT PUT A PACKAGE SPECIFICATION IN FILES CONTAINING
>    Win32::GUI REFERENCES", and
>   "DO NOT PUT A PACKAGE SPECIFICATION IN THE MAIN
>    PROGRAM"
> 
> Any way I can really help in this?

I'd say:

(1) When using OEM, event handlers must be in package main;
(2) Don't use package GUI or package GUI::*, as these are (currently) 
reserved by Win32::GUI -  although I'd prefer to remove the offending 
code from GUI.pm - see my other post.
(3) We need to document the NEM and how to use it. (see above)

Regards,
Rob.