Re: [perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Jack Coates
I haven't read the new docs either, and can only speak as a user of Win32::GUI, but I do use it a lot, and find the current doc situation challenging. The Right Thing To Do is probably fixing the POD, but right often gets in the way of done. If correct docs can be posted somewhere, that's better t

Re: [perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Glenn Linderman
On approximately 7/12/2009 7:49 PM, came the following characters from the keyboard of Kevin Marshall: > Glenn, > > Yes, you're right, the documentation for the module is contained > within the source code and is extracted during the build process. For > a module this large, it probably made s

Re: [perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Kevin Marshall
Glenn, Yes, you're right, the documentation for the module is contained within the source code and is extracted during the build process. For a module this large, it probably made sense in the beginning to use this method to create the docs, but as the module has grown, I imagine it has bec

Re: [perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Glenn Linderman
On approximately 7/12/2009 5:41 PM, came the following characters from the keyboard of Kevin Marshall: > Reini, > > I understand where you are coming from, a diff would make replacement > of the original files easier. I was, however, considering a complete > rewrite of the documentation, inclu

Re: [perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Kevin Marshall
Reini, I understand where you are coming from, a diff would make replacement of the original files easier. I was, however, considering a complete rewrite of the documentation, including the structure, which would make patching the existing files interesting. An alternative would be to copy

Re: [perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Reini Urban
Kevin Marshall schrieb: > Reini, > > Here is my updated version of the Win32::GUI Documentation. If you have > any questions or comments, please post them on the mailing list. That's the problem and that's what I've thought. You were fixing the *generated* pod files, but not the source of the

Re: [perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Reini Urban
Kevin Marshall schrieb: > Hey everyone, > > After digging through the Win32::GUI source and Win32 API Documentation, > I have created some updated Win32::GUI documentation. Let's face it, the > docs are lacking in some areas, so I decided to add to some of the > information that is provided. >

Re: [perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Kevin Marshall
Guys, I got a suggestion from Peter to set up a dedicated website for the Win32::GUI Documentation, which would include things such as more examples and tutorials, illustrations, etc. I wouldn't mind some feedback on what people think about this idea. Kevin. From: kejoh...@hotma

[perl-win32-gui-users] Win32::GUI Documentation

2009-07-12 Thread Kevin Marshall
Hey everyone, After digging through the Win32::GUI source and Win32 API Documentation, I have created some updated Win32::GUI documentation. Let's face it, the docs are lacking in some areas, so I decided to add to some of the information that is provided. If anyone would like a copy of