From: mark...@metoffice.gov.uk [mailto:mark...@metoffice.gov.uk] Sent: Friday, February 29, 2008 5:58 PM To: feed...@java-net.dev.java.net Subject: RE: https://jna.dev.java.net/#demos

Your documentation there is damn near useless.

You don't actually make a CLibrary in its entirety. You use two different declarations and don't show why.

Your example codes don't use the Native.loadLibrary code, so you can't see why you use it. you use "extends StdCallLibrary" without saying WHY you're extending that.

Examples should be self contained so you don't have to dig out code from elsewhere to find out what you missed (so your demos are missing a lot of code and don't include the definitions that your example code is using FROM WITHIN THE JNA jars).

If you use a term, unless it's covered under some other topic, explain why you used it (so your use of StdCallLibrary is either missing WHY you use it or where these classes are from, so you can find out). Linking to the frankly piss poor declaration of the class isn't going to work because there aren't any canned examples there (and since you've linked there from a place where you're showing examples, an example IS needed).

If you want someone who knows a little about java and OO programming to read your attempts to make the page useful, feel free to ask me.