← Back to team overview

dolfin team mailing list archive

Re: Documentation strings in code

 

On 6 July 2011 12:42, Marie E. Rognes <meg@xxxxxxxxx> wrote:
>
> We have a wonderful student (Anders E Johansen) hired for the summer at
> Simula, who at the moment is going through the DOLFIN code base and
> improving the docstrings and doc-comments.
>
> In that connection, I thought that I'd check that we are still committed to
> the current formatting and automatic extraction of docstrings from C++ and
> Python as described in
>
>
>  http://www.fenicsproject.org/new/dev/documenting_dolfin_api.html#the-long-story
>
> Yes/No?

Yes, I think this is the only way that we can get the docstrings in
the generated cpp.py module correct.
Perhaps the text on the above page needs to be updated to fit the new
procedure for actually generating the docs (split of C++ and Python)?
I did not check this.

Kristian

> --
> Marie
>
> _______________________________________________
> Mailing list: https://launchpad.net/~dolfin
> Post to     : dolfin@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~dolfin
> More help   : https://help.launchpad.net/ListHelp
>


Follow ups

References