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, including the structure, which would > make patching the existing files interesting. An alternative would be > to copy my docs over the docs generated in the build process, before > doing "make install". Another way would be to edit the makefile to > prevent the docs being generated, then move my docs into their place, > then do "make install". For those people who use the PPMs they > have less options. The best they can do is copy my docs over the > originals after installing the PPM. It was suggested I set up a > dedicated website for the documentation. This would certainly overcome > any of these problems.
Well, a dedicated website for the documentation only works-around these problems. I think presently the source for the documentation is in the source code files for the modules. If that is preserved, it is more likely that the documentation will get updated when the code gets updated. Even if you do a complete rewrite of the documentation, if it is not integrated with the module source in some way, it will likely not get maintained over time. That said, I agree that the documentation could use some help; last I looked at it, there were lots of TBD areas. ------------------------------------------------------------------------------ Enter the BlackBerry Developer Challenge This is your chance to win up to $100,000 in prizes! For a limited time, vendors submitting new applications to BlackBerry App World(TM) will have the opportunity to enter the BlackBerry Developer Challenge. See full prize details at: http://p.sf.net/sfu/Challenge _______________________________________________ Perl-Win32-GUI-Users mailing list Perl-Win32-GUI-Users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/perl-win32-gui-users http://perl-win32-gui.sourceforge.net/
