On Thu, 21 Jan 2010 11:59:01 +0000 >>>>>> "Jeremy" == "Jeremy O'Donoghue" wrote:
Jeremy> Documentation and its layout are not always as clear as they Jeremy> could be for wxHaskell. Despite the fact that it is not the Jeremy> most 'interesting' or 'fun' thing for me to work on, I plan to Jeremy> do quite a bit of work on this in the coming weeks. Hooray! Jeremy> Some will reflect itself in updated documentation in the source Jeremy> code and other aspects will probably turn into blog Jeremy> (http://wewantarock.wordpress.com) articles. The only wxhaskell tutorials are those referenced on the wiki? Jeremy> 1) The wrappings over the wxWidgets library. These are Jeremy> essentially C versions of wxWidgets C++ APIs, It means one can practically call any low-level C-API wxwidgets function? Jeremy> 3) Higher-level (i.e. more declarative) functionality in Jeremy> Graphics.UI.WX - again, sparsely but adequately Jeremy> documented. Having some more complete/advanced tutorial would probably help to become familiar with usage of higher-level API. Jeremy> To really interpret what the functions do, you need to find the Jeremy> appropriate method names. One rule you need to know is that Jeremy> <widgetname>Create is a wrapper for the C++ constructor - in Jeremy> other words, we should look at wxGrid() to find out what Jeremy> gridCreate does. Things get a bit more complicated for Jeremy> overloaded constructors and methods, but it's usually not too Jeremy> hard to work out. Heh, the above 'rule' really helps. Is there any doc which explains those wxwidgets <---> wxhaskell mappings? Jeremy> The bad (and not really satisfactory, from a Haskell Jeremy> perspective) aspect of this is that you really need to have at Jeremy> least a limited ability to read C++ to understand this. I hope that 'limited' really means 'quite limited' in order that we can avoid jumping into C++ (I did it long ago in the era of Zortech C++ compiler, but then I was 'young' and now I'm not interested in C++ whatsoever.) Jeremy> I hope that documentation will be an aspect of wxHaskell which Jeremy> improves significantly in the near future. That would be wonderful and give us inspiration to work on enhancing wxhaskell further? Have you considered moving the project to some (other) public hosting with better bug tracker etc. ? SF is really becoming obsolete. (Although I'm darcs fan myself, I'll probably use Launchpad for other aspect of project managament - their bugtracker has decent email interface as well.) Sincerely, Gour -- Gour | Hlapicina, Croatia | GPG key: F96FF5F6 ----------------------------------------------------------------
signature.asc
Description: PGP signature
------------------------------------------------------------------------------ Throughout its 18-year history, RSA Conference consistently attracts the world's best and brightest in the field, creating opportunities for Conference attendees to learn about information security's most important issues through interactions with peers, luminaries and emerging and established companies. http://p.sf.net/sfu/rsaconf-dev2dev
_______________________________________________ wxhaskell-users mailing list wxhaskell-users@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/wxhaskell-users
