fenics team mailing list archive

[Johannes Ring <johannr@xxxxxxxxx>]

On Thu, Mar 18, 2010 at 5:34 PM, Johan Hake <johan.hake@xxxxxxxxx> wrote:
> On Thursday 18 March 2010 07:22:24 Andy Ray Terrel wrote:
>> I've never heard of doconce.  Is there a link somewhere?
>
> Couldn't find it either. We probably need a well adapted documentation tool.

doconce is written by Hans Petter Langtangen. It is currently only
available for Simula internals (in the scriptingsuite subversion
repository). We have used it for the documentation of SciTools
(scitools.googlecode.com).

Johannes

>> Just to
>> throw this out there you might check out the way Numpy and Scipy does
>> theirs (I believe with sphinx [0] which has that nice feature of
>> publishing to pdf or html).
>
> Looks nice, but maybe a bit Python centric? I see that there are efforts [1]
> for using it to parse Doxygen generated xml, but then what's the point of not
> using Doxygen? Is the generated documentation nicer using Sphinx? They
> certainly look nice!
>
> Johan
>
> [1] http://github.com/michaeljones/breathe/tree/master
>
>> If there was some style guide set up and
>> the key areas pointed out, it might be good to have a documentation
>> marathon for FEniCS'10.
>>
>> [0] http://sphinx.pocoo.org/
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~fenics
>> Post to     : fenics@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~fenics
>> More help   : https://help.launchpad.net/ListHelp
>>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~fenics
> Post to     : fenics@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~fenics
> More help   : https://help.launchpad.net/ListHelp
>