commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sebb <seb...@gmail.com>
Subject Re: [all] xdoc vs. apt
Date Mon, 17 Sep 2012 22:00:33 GMT
On 17 September 2012 22:28, Luc Maisonobe <Luc.Maisonobe@free.fr> 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 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 wondering (being no maven expert) if
>> there was anything in commons-parent that prevented from using apt?
>> Should I change anything in our pom.xml?
>>
>> At the moment, I'm just toying with the idea. I want to give apt a go
>> locally, and see how it goes. I haven't found (yet) a commons project
>> that uses this format. Is there a good reason? Should I stick with
>> xdoc instead?
>
> I think Sebb told us we should rather switch to markdown as a markup
> language.

This sebb does not remember doing so; I'm not a particular fan of markdown.

> I think there are several maven plugins that can handle this
> syntax (probably with some extensions like tables), and it is now quite
> widespread.
>
> Luc
>
>>
>> Thanks for your advice!
>> Sébastien
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
>> For additional commands, e-mail: dev-help@commons.apache.org
>>
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> For additional commands, e-mail: dev-help@commons.apache.org
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org


Mime
View raw message