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
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
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
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
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
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
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.
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
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
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
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
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
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
13 matches
Mail list logo
