Re: [Haskell-cafe] Re: ANN: bindings-SDL 1.0.2, the domain specific language for FFI description

2009-11-20 Thread Jake McArthur

Maurí­cio CA wrote:

I believe I forgot to write a section with that information, as
well as others one would like to know from start. I wrote a new
section trying to fix that in 'how to use it' topic.

http://bitbucket.org/mauricio/bindings-dsl/wiki/HowToUseIt


Very nice. I think that is clear enough.


I'm not sure I have already got to a point where documentation is
clear and complete enough but not too long and boring. If you also
thing some parts of documentation were not helpful, or if more is
missing, please let me know.


Quite the contrary, with that one exception, I found the documentation 
to be among some of the best I have used. I especially like the numerous 
examples you included.


- Jake
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


[Haskell-cafe] Re: ANN: bindings-SDL 1.0.2, the domain specific language for FFI description

2009-11-19 Thread Maurí­cio CA

 I did not notice when this was released, but I saw it on Hackage
 yesterday and, with it, wrote some of the easiest bindings to a
 fairly complex C API I've written in a while. This package is
 excellent! Thank you for sharing it.

Thanks. My hope is that it saves as much time from users as the
support from this community saved for me.

 My only complaint is that the macros get confused if you use a
 Haskell type that has a single quote in it.

Can you give me an example?

Best,
Maurício

___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


Re: [Haskell-cafe] Re: ANN: bindings-SDL 1.0.2, the domain specific language for FFI description

2009-11-19 Thread Jake McArthur

Maurí­cio CA wrote:

  My only complaint is that the macros get confused if you use a
  Haskell type that has a single quote in it.

Can you give me an example?


It turns out that I read the documentation incorrectly, but here is what 
I was trying to do.


I had two structs, one of which used the other as a field type. I was 
using the generated identifier of the first as the type for the second, 
so it had the form c'STRUCT_NAME. So the field macro looked like this:


  #field foo , c'STRUCT_NAME

It did not like this, complaining about the single quote.

I have since noticed the STRUCT_NAME notation in the documentation. 
Perhaps the actual bug is that this notation was not pointed out in prose?


- Jake
___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe


[Haskell-cafe] Re: ANN: bindings-SDL 1.0.2, the domain specific language for FFI description

2009-11-19 Thread Maurí­cio CA

 I had two structs, one of which used the other as a field type.
 I was using the generated identifier of the first as the type
 for the second, so it had the form c'STRUCT_NAME. So the field
 macro looked like this:

   #field foo , c'STRUCT_NAME

 It did not like this, complaining about the single quote.

 I have since noticed the STRUCT_NAME notation in the
 documentation. Perhaps the actual bug is that this notation was
 not pointed out in prose?

I believe I forgot to write a section with that information, as
well as others one would like to know from start. I wrote a new
section trying to fix that in 'how to use it' topic.

http://bitbucket.org/mauricio/bindings-dsl/wiki/HowToUseIt

I'm not sure I have already got to a point where documentation is
clear and complete enough but not too long and boring. If you also
thing some parts of documentation were not helpful, or if more is
missing, please let me know.

Thanks for your feedback.
Maurício

___
Haskell-Cafe mailing list
Haskell-Cafe@haskell.org
http://www.haskell.org/mailman/listinfo/haskell-cafe