pygccxml-development

[pygccxml-development] [ documentation ] how to add user code to ...

[Roman Y. <rom...@gm...>]

Hi. I think, that I finished to write documentation "How to add user
code to ... ?".
You can find it here:
http://svn.sourceforge.net/viewvc/pygccxml/pyplusplus_dev/docs/documentation/inserting_code.rest?view=markup

I'd like to get your feedback:
1. Whether the document is clear or not?
2. Does the explained functionality cover all your use cases?
3. What do you like to add\remove\change?

Thank you.

-- 
Roman Yakovenko
C++ Python language binding
http://www.language-binding.net/

Re: [pygccxml-development] [ documentation ] how to add user code to ...

[Matthias B. <ba...@ir...>]

Roman Yakovenko wrote:
> I'd like to get your feedback:
> 1. Whether the document is clear or not?

Looks good (but there's a typo in the title: "Inerting" -> "Inserting"). 
I was only a bit confused about the last section ("Insert code to class 
wrapper") because it tried to solve a problem that has already been 
solved in the previous section.
I guess it would be better if the last two sections would try to solve 
different problems where the respective functions are the best solution. 
Otherwise a user who's reading this tutorial might ask why the API 
contains two functions that are supposed to do the "same" thing.

- Matthias -

Re: [pygccxml-development] [ documentation ] how to add user code to ...

[Roman Y. <rom...@gm...>]

On 7/31/06, Matthias Baas <ba...@ir...> wrote:
> Roman Yakovenko wrote:
> > I'd like to get your feedback:
> > 1. Whether the document is clear or not?
>
> Looks good (but there's a typo in the title: "Inerting" -> "Inserting").

Fixed.

> I was only a bit confused about the last section ("Insert code to class
> wrapper") because it tried to solve a problem that has already been
> solved in the previous section.
> I guess it would be better if the last two sections would try to solve
> different problems where the respective functions are the best solution.
> Otherwise a user who's reading this tutorial might ask why the API
> contains two functions that are supposed to do the "same" thing.

Fixed. Added real use case, with description and solution.

Matthias, this document contains section that I marked as "Not implemented".
Can you take a look on it and to comment?

Thank you.

-- 
Roman Yakovenko
C++ Python language binding
http://www.language-binding.net/

Re: [pygccxml-development] [ documentation ] how to add user code to ...

[Matthias B. <ba...@ir...>]

Roman Yakovenko wrote:
> Matthias, this document contains section that I marked as "Not 
> implemented".
> Can you take a look on it and to comment?

Well, that function looks useful to me. I take it, it adds that code to 
the file where the corresponding class is located, right?
Then I think I could have used that already for my "arg policies". 
Currently, I'm creating new source files.

- Matthias -

Re: [pygccxml-development] [ documentation ] how to add user code to ...

[Roman Y. <rom...@gm...>]

On 8/1/06, Matthias Baas <ba...@ir...> wrote:
> Roman Yakovenko wrote:
> > Matthias, this document contains section that I marked as "Not
> > implemented".
> > Can you take a look on it and to comment?
>
> Well, that function looks useful to me. I take it, it adds that code to
> the file where the corresponding class is located, right?

Right and I will try to implement this feature this evening

> Then I think I could have used that already for my "arg policies".
> Currently, I'm creating new source files.

What do you mean?

-- 
Roman Yakovenko
C++ Python language binding
http://www.language-binding.net/

Re: [pygccxml-development] [ documentation ] how to add user code to ...

[Matthias B. <ba...@ir...>]

Roman Yakovenko wrote:
>> Then I think I could have used that already for my "arg policies".
>> Currently, I'm creating new source files.
> 
> What do you mean?

I mean, I probably could have added the source code for the newly 
generated wrapper functions right to the original source files created 
by pyplusplus instead of creating my own source files.

- Matthias -