openerp-doc team mailing list archive

[Olivier Dony <odo@xxxxxxxxxxx>]

Le 04/08/10 09:34, Olivier Dony a écrit :
> Par exemple hier j'ai remarque que ca faisait 3 semaine que la doc ne
> buildait plus et on n'etait pas prevenu parce qu'il y avait 2 appels
> exit() qui etaient apparus dans le script de build et qui empechaient
> l'envoi du mail en cas d'erreur.

Et tant que j'y pense j'ai aussi upgrade Sphinx a la version 1.0.1 et 
docutils a la version 0.7 pour fixer toute une serie de petits warnings 
dans le RST, et avoir les nouvelles features de sphinx.

Notamment ca permet d'utiliser des trucs comme:
    py:meth:`~osv.osv.osv.write`
pour creer une reference avec comme label "write()" vers une section de 
documentation generee automatiquement par le plugin autodoc a partir de 
la docstring d'une methode python.

C'est utilise dans les docstrings des methodes de l'ORM, qui sont 
ensuite incluses automatiquement dans la doc technique:


http://doc.openerp.com/developer/2_5_Objects_Fields_Methods/methods.html#osv.osv.osv