> For me, it is about the examples. I would suggest adding some better 
> doco around passing items by reference and arrays. I admit I am weak at 
> C, so making the jump between a char*** and an array of strings was not 
> intuitive. The JNA website [1]  gives in doco examples to explain the 
> 
> [1] https://jna.dev.java.net/#pointers

Agreed on the need for more examples.  It would be great if you could summarize your recent augeas char** and char*** discussions into an example and update the wiki.

I find the following combination potent for quickly getting up to speed:
* a good core concepts description
* plenty of relevant examples
* struggle-to-learn-it-on-your-own-for-awhile
* a responsive mailing list 

...and I believe a little work on the first two will really pay off.

FWIW, I'm in the process of starting a Windows API specific page at http://wiki.github.com/ffi/ffi/windows-examples and have finally become happier with the side-by-side colorized layout. Let's see if it works across browsers and the Ruby pink isn't too much on the eyes.

It will be interesting to see if this side-by-side formatting combined with the 3 categories of difficulty level will be helpful once there are a few more examples.

BTW, please feel free to jump in and help out with http://wiki.github.com/ffi/ffi/core-concepts if the spirit moves you :)

Jon