"Nathan Bubna" <[EMAIL PROTECTED]> writes:
>My only concern is that when Geir and Gabriel started VelocityTools,
>they decided to develop most of the documentation with Geir's new DVSL
>tool. :) It's worked great, but abandoning DVSL means reformatting
>the docs for some other tool. it might honestly be less effort to
>spruce up DVSL a bit in the short term. but then there's that whole
>long term thing....
>any great ideas for a new doc tool? anyone know much about APT?
Or Doxia? Considering the fact that Doxia comes out of the same corner
as the xdoc/Anakia idea, it is probably as future safe. ==:-)
Personally, if I do have to do new docs for code, I try to stick with
well established standards. Which seem to be Docbook these days (which
was not invented at the ASF...).
If it is DVSL, it should be renderable with Maven in no time. The
whole Velocity doc is driven in the same way and builds fine using
Maven. And if you are into pain, it should be possible to use XSLT to
convert the docs into web pages. :-)
Ah, I forgot, they deprecated xdoc in m2 in favor of doxia.
Best regards
Henning
P.S.: Sorry Geir if I stepped on your toes here, I know that you were
heavily involved with DVSL/Anakia and xdoc, but the whole thing has
proven to be such a PITA and is IMHO is the reason that most Maven
driven project sites are either empty or simply provide a link to an
external site for documentation.
>On 3/5/06, Henning P. Schmiedehausen <[EMAIL PROTECTED]> wrote:
>> "Henri Yandell" <[EMAIL PROTECTED]> writes:
>>
>> [Gee, I wandered of for some time, then went on holidays and what do I
>> find when I return here? Yet _another_ "my templating engine is better
>> than your templating engine" thread featuring the incomparable talents
>> of Mr. Jonathan Revusky and Mr. Daniel Dekany (sp?) Can we all please
>> grow up at some point? Didn't we rehash the "my error reporting is
>> better than your error reporting" and "my macros are better than your
>> macros" to death? How about "my user base is bigger than your user
>> base?"]
>>
>> >None of the above means we should treat a release any less though;
>> >interested in hearing from the velocity guys when a DVSL 0.46 jar will
>> >be released to iBiblio properly.
>>
>> Actually, when I was browsing this thread, I was thinking about
>> calling a vote "who is still interested in maintaining DVSL?" and if
>> noone shows up, mothballing it on archives. Even maven uses a
>> different processor these days as far as I can see. Any opinions about
>> that?
>>
>> Best regards
>> Henning
>>
>> --
>> Dipl.-Inf. (Univ.) Henning P. Schmiedehausen INTERMETA GmbH
>> [EMAIL PROTECTED] +49 9131 50 654 0 http://www.intermeta.de/
>>
>> RedHat Certified Engineer -- Jakarta Turbine Development -- hero for hire
>> Linux, Java, perl, Solaris -- Consulting, Training, Development
>>
>> Social behaviour: Bavarians can be extremely egalitarian and folksy.
>> -- http://en.wikipedia.org/wiki/Bavaria
>> Most Franconians do not like to be called Bavarians.
>> -- http://en.wikipedia.org/wiki/Franconia
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: [EMAIL PROTECTED]
>> For additional commands, e-mail: [EMAIL PROTECTED]
>>
>>
>---------------------------------------------------------------------
>To unsubscribe, e-mail: [EMAIL PROTECTED]
>For additional commands, e-mail: [EMAIL PROTECTED]
--
Dipl.-Inf. (Univ.) Henning P. Schmiedehausen INTERMETA GmbH
[EMAIL PROTECTED] +49 9131 50 654 0 http://www.intermeta.de/
RedHat Certified Engineer -- Jakarta Turbine Development -- hero for hire
Linux, Java, perl, Solaris -- Consulting, Training, Development
Social behaviour: Bavarians can be extremely egalitarian and folksy.
-- http://en.wikipedia.org/wiki/Bavaria
Most Franconians do not like to be called Bavarians.
-- http://en.wikipedia.org/wiki/Franconia
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
