← Back to team overview

fenics team mailing list archive

Re: Documentation effort

 

Mon, 22 Mar Anders Logg wrote:
> Chris Richardson pointed me to the PHP documentation which looks
> pretty good:
> 
>   http://www.php.net/manual/en/function.explode.php
> 
> Note the sections ChangeLog, Examples and Notes. Being able to add
> notes seems very useful.
> 
> It is generated using DocBook:
> 
>   http://doc.php.net/php/dochowto/docbook-whatis.php
> 
> The problem with it seems to be it's a nightmare to write the input:
> 
>   http://doc.php.net/php/dochowto/chapter-skeletons.php

There is a tool rst2docbook.py, as part of experimental docutils, for
converting reST to docbook. (This also means that you can go from
doconce to reST to docbook.)

Hans Petter



References