[Cython] autodoc function/method signatures

[Robert Bradshaw]

On Sep 8, 2008, at 7:41 AM, Lisandro Dalcin wrote:

> I have some working code following Dag advices (BTW, that transform
> stuff its a real win!).

Yes, it certainly is! One thing that worries me is that adding a  
bunch of tree traversals starts to slow things down--at the very  
least we should have a transform that doesn't descend into function  
bodies for speed reasons for stuff like this.

> Now I would like to know your opinions about
> how the signatures should be rendered. Robert, if you see this, please
> enter the discussion.

I'd render them the natural way, e.g. [return-type] name([type] arg,  
[type] arg, ...)

- Robert

>
>
> On Fri, Sep 5, 2008 at 5:27 AM, Stefan Behnel <stefan_ml at behnel.de>  
> wrote:
>> Lisandro Dalcin wrote:
>>> Would it be possible to tell Cython/Pyrex to add a line in docstings
>>> with function/method signatures? Or should this wait until
>>> Cython/Pyrex supports PEP 3107 (Function Annotations)?
>>
>> Just for the archives, this is actually already a trac ticket.
>>
>> http://trac.cython.org/cython_trac/ticket/2
>>
>> Stefan
>>
>> _______________________________________________
>> Cython-dev mailing list
>> Cython-dev at codespeak.net
>> http://codespeak.net/mailman/listinfo/cython-dev
>>
>
>
>
> -- 
> Lisandro Dalcín
> ---------------
> Centro Internacional de Métodos Computacionales en Ingeniería (CIMEC)
> Instituto de Desarrollo Tecnológico para la Industria Química (INTEC)
> Consejo Nacional de Investigaciones Científicas y Técnicas (CONICET)
> PTLC - Güemes 3450, (3000) Santa Fe, Argentina
> Tel/Fax: +54-(0)342-451.1594
> _______________________________________________
> Cython-dev mailing list
> Cython-dev at codespeak.net
> http://codespeak.net/mailman/listinfo/cython-dev