Re: [all] xdoc vs. apt

2012-09-18 Thread Gilles Sadowski
Hello. > Hi Phil, > thanks for your thoughts! > > 2012/9/18 Phil Steitz : > > On 9/18/12 6:47 AM, Sébastien Brisard wrote: > >> Hi Gilles, > >> > >>> As you both point out indirectly, the Javadoc system is not exactly > >>> suitable > >>> to compose a scientific document. But I remind that its m

Re: [all] xdoc vs. apt

2012-09-18 Thread Sébastien Brisard
Hi Phil, thanks for your thoughts! 2012/9/18 Phil Steitz : > On 9/18/12 6:47 AM, Sébastien Brisard wrote: >> Hi Gilles, >> >>> As you both point out indirectly, the Javadoc system is not exactly suitable >>> to compose a scientific document. But I remind that its main goal is to >>> explain the AP

Re: [all] xdoc vs. apt

2012-09-18 Thread Phil Steitz
On 9/18/12 6:47 AM, Sébastien Brisard wrote: > Hi Gilles, > >> As you both point out indirectly, the Javadoc system is not exactly suitable >> to compose a scientific document. But I remind that its main goal is to >> explain the API of a code, not to explain the science that supports the >> implem

Re: [all] xdoc vs. apt

2012-09-18 Thread Gilles Sadowski
Hi Luc. > > [...] > >> > >>So at least we have to think a little about it. > >> > >Another option would be this: since maven-site works with strict > >xhtml > >(unlike javadoc), we can embed MathML code in our pages. I'm not sure > >how we would do it in xdoc or apt, but we can certainly write our

Re: [all] xdoc vs. apt

2012-09-18 Thread Sébastien Brisard
Hi Gilles, > > As you both point out indirectly, the Javadoc system is not exactly suitable > to compose a scientific document. But I remind that its main goal is to > explain the API of a code, not to explain the science that supports the > implementation. > As a matter of fact, I was talking abo

Re: [all] xdoc vs. apt

2012-09-18 Thread Ralph Goers
I did the whole Flume web site in Sphinx - http://flume.apache.org. It works great for documentation but isn't really designed to build a web site - although you can. The Maven plugin has a few gotchas at the moment: 1 - it has a bug that causes it to use a lot of memory on multi-module bu

Re: [all] xdoc vs. apt

2012-09-18 Thread Sébastien Brisard
Hi Luc, 2012/9/18 luc : > Le 2012-09-18 07:46, Sébastien Brisard a écrit : >> >> Hi, > > > Hi Sébastien, > >> >> 2012/9/18 Sébastien Brisard : >>> >>> Hi, >>> thanks for these answers. >>> I agree that apt does not seem much better than xdoc, but it at least >>> offers table formatting and so on.

Re: [all] xdoc vs. apt

2012-09-18 Thread luc
Le 2012-09-18 07:46, Sébastien Brisard a écrit : Hi, Hi Sébastien, 2012/9/18 Sébastien Brisard : Hi, thanks for these answers. I agree that apt does not seem much better than xdoc, but it at least offers table formatting and so on. So can anyone recommend a good format? Otherwise, I'm qui

Re: [all] xdoc vs. apt

2012-09-17 Thread Sébastien Brisard
Hi, 2012/9/18 Sébastien Brisard : > Hi, > thanks for these answers. > I agree that apt does not seem much better than xdoc, but it at least > offers table formatting and so on. > So can anyone recommend a good format? Otherwise, I'm quite happy with xhtml. > > An option I'm going to look at at wor

Re: [all] xdoc vs. apt

2012-09-17 Thread Sébastien Brisard
Hi, thanks for these answers. I agree that apt does not seem much better than xdoc, but it at least offers table formatting and so on. So can anyone recommend a good format? Otherwise, I'm quite happy with xhtml. An option I'm going to look at at work is sphinx [1]. It has become widely spread in

Re: [all] xdoc vs. apt

2012-09-17 Thread sebb
On 17 September 2012 22:28, Luc Maisonobe wrote: > Le 17/09/2012 21:24, Sébastien Brisard a écrit : >> Hi, > > Hi Sébastien, > >> I'm looking into extending the user's guide of Commons-Math for >> special functions. xdoc seems to be offering only very crude >> formatting possibiliities, and apt se

Re: [all] xdoc vs. apt

2012-09-17 Thread Luc Maisonobe
Le 17/09/2012 21:24, Sébastien Brisard a écrit : > Hi, Hi Sébastien, > I'm looking into extending the user's guide of Commons-Math for > special functions. xdoc seems to be offering only very crude > formatting possibiliities, and apt seems much better. It should work > out of the box, alongside

Re: [all] xdoc vs. apt

2012-09-17 Thread Dennis Lundberg
On 2012-09-17 21:24, Sébastien Brisard wrote: > Hi, > I'm looking into extending the user's guide of Commons-Math for > special functions. xdoc seems to be offering only very crude > formatting possibiliities, and apt seems much better. It should work > out of the box, alongside with existing xdoc

[all] xdoc vs. apt

2012-09-17 Thread Sébastien Brisard
Hi, I'm looking into extending the user's guide of Commons-Math for special functions. xdoc seems to be offering only very crude formatting possibiliities, and apt seems much better. It should work out of the box, alongside with existing xdoc pages. However, I can't seem to make it work, and I was