Feb 8, 2014, 3:44 PM
Re: [PapaGeek] Win32::GUI Underlining Menu Shortcuts
Being open source, the documentation is not the best Iíve ever worked with.
Come on, you might have seen better documentation, for sure, I can agree with that, but the Perl documentation is really far from being bad (at least as far as core Perl is concerned, there are some modules that could be better explained). Having said that, there is sometimes a tendency (for some functions) to explain all the edge cases so that the overview of the main role or use of the function might be lost out of sight. I also write quite regularly software documentation and I can very well understand how this happens, sometimes you get lost into the details and forget to state the obvious (or what seems obvious to you). Having admitted that it is not always the best you would wish (for example, the pack/unpack documentation sucks), I think that the Perl documentation is usually quite good. And, concerning pack/unpack documentation, there is also a good tutorial that really alleviates the shortcomings of the official function documentation.
You could probably say the same about the printf/sprintf documentation: if, like me, you don't have to use it too often and need to check the documentation when you need it, you might get irritated... There, the problem might be that C programmers know these so well that many people might think it is obvious. Except that, in my case (for example), I don't think that I have written a C program with more than 30 lines of code in the last 12 years. The reason being that Perl is so good that I no longer need C, except in very special, unusual and seldom cases.
(This post was edited by Laurent_R on Feb 8, 2014, 4:05 PM)